Source: https://swgbar.com/zh-CN/cli/
Language: zh-CN

# SWG bar CLI 使用指南

在 macOS 终端中使用 swgbar 命令行工具查看 HTTPS 解密占比、查询域名与证书详情，并管理 SWG 绕过。

SWG bar · 更新日期 2026年10月31日

SWG bar 在 `/Applications/SWGBar.app` 中内置了原生命令行工具 `swgbar`。它提供与 Mac 菜单栏应用一致的功能，方便你在终端中直接查看 HTTPS 解密状态、筛选域名与证书详情，以及管理单域名 SWG 绕过。

## 配置 CLI

完成 [SWG bar 安装](<https://swgbar.com/zh-CN/install/>)后，可执行文件位于应用程序包内。你可以直接运行、在终端配置文件（如 `~/.zshrc` 或 `~/.bashrc`）中添加别名，或在 `PATH` 中创建软链接：

```
# 方式 1：直接运行应用程序包内的二进制文件
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# 方式 2：在 Shell 配置文件中添加别名（~/.zshrc 或 ~/.bashrc）
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# 方式 3：在 /usr/local/bin 中创建软链接（推荐全局使用）
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# 验证 CLI 安装与当前版本
swgbar version
```

在任意命令后添加 `--json` 即可输出结构化 JSON 结果，便于配合 `jq` 进行自动化脚本处理。

## 查看概览指标、域名与证书

使用 `overview`、`domains` 和 `certificates` 命令可查看与菜单栏应用一致的实时数据：

```
# 查看整体 HTTPS 解密占比、各状态数量及主要拦截证书
swgbar overview

# 列出已观测域名，支持筛选与翻页（confirmed、suspected、public、intranet）
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# 查看列表中指定域名的连接与证书证据详情
swgbar domains detail <domain>

# 列出证书聚类并查看指定证书名称的详细信息
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"
```

## 检测域名与管理 SWG 绕过

在终端中对任意域名发起实时 TLS 检测，或管理单域名 SWG 绕过规则：

```
# 对指定域名发起实时 TLS 检测与证书评估
swgbar probe <domain>

# 查看当前 SWG 域名绕过状态与生效规则
swgbar bypass status

# 开启、切换、关闭或清空指定域名的绕过规则
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear
```

## 浏览器扩展与应用偏好设置

通过命令行查看浏览器扩展连接状态、暂停或恢复后台监测，以及调整应用偏好设置：

```
# 查看并检查 Chrome 扩展连接状态
swgbar plugins status
swgbar plugins check

# 查看、暂停或恢复后台监测
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# 查看许可证状态、检查软件更新、查看或切换显示语言与外观
swgbar license status
swgbar updates check
swgbar language get
swgbar language set <en|zh-Hans|zh-Hant|ja|ko>
swgbar appearance get
swgbar appearance set <system|light|dark>
```

## 常用命令一览

| 命令 | 说明 |
| --- | --- |
| `swgbar overview` | 查看整体 HTTPS 解密占比、各状态统计及主要拦截证书 |
| `swgbar domains list` | 列出域名，支持 `--search`、`--status`、`--bypass`、`--page`、`--page-size` 筛选与翻页 |
| `swgbar domains detail <domain>` | 查看指定域名的连接元数据、证书链证据及绕过状态 |
| `swgbar certificates list` | 列出证书聚类，支持 `--search` 与 `--status` 筛选 |
| `swgbar certificates detail "<certificate-name>"` | 查看指定证书的签发信息、有效期限、SHA-256 指纹及关联域名 |
| `swgbar bypass <status|enable|disable|toggle|clear>` | 查询或管理单域名 SWG 绕过规则 |
| `swgbar probe <domain>` | 对指定域名发起实时 TLS 检测与证书评估 |
| `swgbar plugins <status|check>` | 查看并检查浏览器扩展配套组件的连接状态 |
| `swgbar monitoring <status|pause|resume>` | 查看、暂停或恢复后台网络监测 |
| `swgbar license <status|activate|deactivate>` | 查看或管理许可证激活状态 |
| `swgbar updates check` | 检查应用软件更新 |
| `swgbar language <get|set>` | 查看或切换显示语言（`en`、`zh-Hans`、`zh-Hant`、`ja`、`ko`） |
| `swgbar appearance <get|set>` | 查看或切换外观模式（`system`、`light`、`dark`） |

如需在 AI 桌面客户端中使用 SWG bar，请参见 [MCP 使用指南](<https://swgbar.com/zh-CN/mcp/>)；关于证书证据与判定的详细机制，请阅读[工作原理](<https://swgbar.com/zh-CN/how-it-works/>)。

## 继续阅读

*   [如何在 Mac 上绕过 SWG](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)
*   [如何检测 Mac 上的 HTTPS 检查](<https://swgbar.com/zh-CN/guides/detect-https-inspection/>)
*   [SWG 绕过与 TLS 解密例外有什么区别](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)
*   [SWG bar 如何检查 HTTPS 解密](<https://swgbar.com/zh-CN/how-it-works/>)
*   [在 Mac 上安装 SWG bar](<https://swgbar.com/zh-CN/install/>)
*   [连接 SWG bar Chrome 扩展](<https://swgbar.com/zh-CN/chrome-extension/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-CN/mcp/>)
*   [SWG bar 版本信息](<https://swgbar.com/zh-CN/releases/>)
*   [关于 SWG bar](<https://swgbar.com/zh-CN/about/>)