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

# 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-TW/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-TW/mcp/>)；關於憑證證據與判定的詳細機制，請閱讀[運作原理](<https://swgbar.com/zh-TW/how-it-works/>)。

## 延伸閱讀

*   [如何在 Mac 上繞過 SWG](<https://swgbar.com/zh-TW/guides/how-to-bypass-swg/>)
*   [如何偵測 Mac 上的 HTTPS 檢查](<https://swgbar.com/zh-TW/guides/detect-https-inspection/>)
*   [SWG 繞過與 TLS 解密例外有什麼區別](<https://swgbar.com/zh-TW/guides/swg-bypass-vs-tls-exception/>)
*   [SWG bar 如何檢查 HTTPS 解密](<https://swgbar.com/zh-TW/how-it-works/>)
*   [在 Mac 上安裝 SWG bar](<https://swgbar.com/zh-TW/install/>)
*   [連線 SWG bar Chrome 擴充功能](<https://swgbar.com/zh-TW/chrome-extension/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-TW/mcp/>)
*   [SWG bar 版本資訊](<https://swgbar.com/zh-TW/releases/>)
*   [關於 SWG bar](<https://swgbar.com/zh-TW/about/>)