SWG bar CLI 使用指南

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

配置 CLI

完成 SWG bar 安装后，可执行文件位于应用程序包内。你可以直接运行、在终端配置文件（如 ~/.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 使用指南；关于证书证据与判定的详细机制，请阅读工作原理。