Source: https://swgbar.com/ja/cli/
Language: ja

# SWG bar CLI ガイド

macOS ターミナルで swgbar コマンドラインツールを使用して、HTTPS 検査状況を確認し、ドメインや証明書の一覧を表示し、SWG バイパスを管理します。

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

SWG bar は、`/Applications/SWGBar.app` 内にネイティブコマンドラインツール `swgbar` を同梱しています。Mac のメニューバーアプリと同等の機能を提供し、ターミナルや自動化スクリプトから直接 TLS 証明書の監査、HTTPS 検査結果の確認、およびドメイン単位の SWG バイパス管理が行えます。

## CLI のセットアップ

[SWG bar をインストール](<https://swgbar.com/ja/install/>)した後、実行バイナリはアプリケーションバンドル内に配置されます。直接実行するほか、シェル設定ファイル（`~/.zshrc` や `~/.bashrc`）にエイリアスを追加するか、`PATH` にシンボリックリンクを作成して利用できます：

```
# 方法 1：アプリケーションバンドル内のバイナリを直接実行
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# 方法 2：シェル設定ファイル（~/.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/ja/mcp/>)を、証明書と判定基準の仕組みについては[動作の仕組み](<https://swgbar.com/ja/how-it-works/>)をご覧ください。

## 関連ガイド

*   [Mac で SWG を回避する方法](<https://swgbar.com/ja/guides/how-to-bypass-swg/>)
*   [Mac で HTTPS 検査を検出する方法](<https://swgbar.com/ja/guides/detect-https-inspection/>)
*   [SWG 回避と TLS 検査の除外設定の違い](<https://swgbar.com/ja/guides/swg-bypass-vs-tls-exception/>)
*   [SWG bar による HTTPS 検査の仕組み](<https://swgbar.com/ja/how-it-works/>)
*   [Mac に SWG bar をインストールする](<https://swgbar.com/ja/install/>)
*   [SWG bar の Chrome 拡張機能を接続する](<https://swgbar.com/ja/chrome-extension/>)
*   [SWG bar MCP ガイド](<https://swgbar.com/ja/mcp/>)
*   [SWG bar のリリース情報](<https://swgbar.com/ja/releases/>)
*   [SWG bar について](<https://swgbar.com/ja/about/>)