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 使用指南；關於憑證證據與判定的詳細機制，請閱讀運作原理。