Руководство по SWG bar CLI

SWG bar включает встроенную утилиту командной строки (swgbar) внутри пакета /Applications/SWGBar.app. Она предоставляет те же возможности мониторинга и анализа в реальном времени, что и приложение в строке меню macOS, позволяя проверять TLS-сертификаты, выявлять перехват HTTPS и управлять обходом SWG напрямую из Терминала или скриптов автоматизации.

Настройка CLI

После установки SWG bar исполняемый файл находится внутри пакета приложения. Вы можете запускать его напрямую, добавить псевдоним (alias) в профиль оболочки (~/.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 или скрипты.

Просмотр общих показателей, доменов и сертификатов

Просматривайте те же актуальные данные и доказательства сертификатов, что и в приложении панели меню:

# Общий процент инспекции HTTPS, статистика по статусам и основные перехватывающие сертификаты
swgbar overview

# Список зафиксированных доменов с фильтрацией и пагинацией
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Подробные сведения о TLS-соединении и сертификатах для конкретного домена
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)

Для интеграции SWG bar с ИИ-клиентами ознакомьтесь с руководством по MCP. Подробности оценки доказательств сертификатов описаны в разделе как устроен SWG bar.