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

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

Используйте инструмент командной строки swgbar в macOS для проверки статуса инспекции HTTPS, просмотра доменов и сертификатов, а также управления обходом SWG.

SWG bar · Обновлено 31 октября 2026 г.

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

## Настройка CLI

После [установки SWG bar](<https://swgbar.com/ru/install/>) исполняемый файл находится внутри пакета приложения. Вы можете запускать его напрямую, добавить псевдоним (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](<https://swgbar.com/ru/mcp/>). Подробности оценки доказательств сертификатов описаны в разделе [как устроен SWG bar](<https://swgbar.com/ru/how-it-works/>).

## Читайте также

*   [Как обойти SWG на Mac](<https://swgbar.com/ru/guides/how-to-bypass-swg/>)
*   [Как обнаружить проверку HTTPS на Mac](<https://swgbar.com/ru/guides/detect-https-inspection/>)
*   [Обход SWG и исключение TLS-проверки: в чём разница](<https://swgbar.com/ru/guides/swg-bypass-vs-tls-exception/>)
*   [Как SWG bar проверяет HTTPS-соединения](<https://swgbar.com/ru/how-it-works/>)
*   [Установка SWG bar на Mac](<https://swgbar.com/ru/install/>)
*   [Подключение расширения SWG bar для Chrome](<https://swgbar.com/ru/chrome-extension/>)
*   [Руководство по SWG bar MCP](<https://swgbar.com/ru/mcp/>)
*   [Информация о выпусках SWG bar](<https://swgbar.com/ru/releases/>)
*   [О SWG bar](<https://swgbar.com/ru/about/>)