Source: https://swgbar.com/pt-BR/cli/
Language: pt-BR

# Guia do SWG bar CLI

Use a ferramenta de linha de comando swgbar no macOS para verificar o status de inspeção HTTPS, consultar domínios e certificados e gerenciar o bypass de SWG.

SWG bar · Atualizado 31 de outubro de 2026

O SWG bar inclui uma ferramenta nativa de linha de comando (`swgbar`) dentro de `/Applications/SWGBar.app`. Ela oferece os mesmos recursos de monitoramento e inspeção em tempo real do aplicativo da barra de menus do macOS, permitindo auditar certificados TLS, avaliar a interceptação HTTPS e gerenciar regras de bypass de SWG diretamente do Terminal ou por scripts.

## Configuração da CLI

Após [instalar o SWG bar](<https://swgbar.com/pt-BR/install/>), o executável fica localizado no pacote do aplicativo. Você pode executá-lo diretamente, definir um alias no seu perfil de shell (`~/.zshrc` ou `~/.bashrc`) ou criar um link simbólico no seu `PATH`:

```
# Opção 1: Executar diretamente do pacote do aplicativo
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Opção 2: Adicionar um alias ao perfil da shell (~/.zshrc ou ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Opção 3: Criar um link simbólico em /usr/local/bin (recomendado para acesso global)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Verificar a instalação e a versão
swgbar version
```

Adicione `--json` a qualquer comando para receber saídas estruturadas em formato JSON, ideal para processamento com `jq` ou automação.

## Métricas gerais, domínios e certificados

Consulte os mesmos dados em tempo real e evidências de certificados exibidos no aplicativo da barra de menus:

```
# Exibir o percentual geral de inspeção HTTPS, contagem por status e principais certificados
swgbar overview

# Listar domínios observados com filtros opcionais e paginação
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Exibir evidências detalhadas de conexão TLS e certificado de um domínio específico
swgbar domains detail <domain>

# Listar agrupamentos de certificados e exibir detalhes de um certificado específico
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"
```

## Sondagem de domínios e gerenciamento do bypass de SWG

Execute verificações TLS em tempo real para qualquer hostname ou gerencie regras de bypass de SWG por domínio:

```
# Sondar um domínio sob demanda para avaliar a confiança do certificado e a inspeção TLS
swgbar probe <domain>

# Consultar o status atual do bypass de SWG e as regras ativas
swgbar bypass status

# Ativar, alternar, desativar ou limpar as regras de bypass de um domínio
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear
```

## Extensão do navegador e preferências do aplicativo

Verifique a conectividade da extensão do navegador, pause ou retome o monitoramento em segundo plano e configure as preferências do aplicativo:

```
# Verificar o status de conexão da extensão complementar para Chrome
swgbar plugins status
swgbar plugins check

# Verificar, pausar ou retomar o monitoramento em segundo plano
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Gerenciar o status da licença, verificar atualizações e alterar idioma ou aparência
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>
```

## Comandos frequentes

| Comando | Descrição |
| --- | --- |
| `swgbar overview` | Exibe a taxa geral de inspeção HTTPS, estatísticas de status e principais certificados interceptores |
| `swgbar domains list` | Lista os domínios observados com suporte a `--search`, `--status`, `--bypass`, `--page` e `--page-size` |
| `swgbar domains detail <domain>` | Exibe metadados de conexão, evidências da cadeia de certificados e status de bypass |
| `swgbar certificates list` | Lista os agrupamentos de certificados com filtros de `--search` e `--status` |
| `swgbar certificates detail "<certificate-name>"` | Exibe emissor, período de validade, impressão digital SHA-256 e domínios associados |
| `swgbar bypass <status|enable|disable|toggle|clear>` | Consulta ou gerencia as regras de bypass de SWG por domínio |
| `swgbar probe <domain>` | Realiza uma sondagem TLS sob demanda e avaliação de certificados para um domínio |
| `swgbar plugins <status|check>` | Verifica a conectividade com a extensão complementar do navegador |
| `swgbar monitoring <status|pause|resume>` | Consulta, pausa ou retoma o monitoramento de rede em segundo plano |
| `swgbar license <status|activate|deactivate>` | Consulta ou gerencia o status de ativação da licença |
| `swgbar updates check` | Verifica atualizações de software disponíveis |
| `swgbar language <get|set>` | Consulta ou define o idioma de exibição (`en`, `zh-Hans`, `zh-Hant`, `ja`, `ko`) |
| `swgbar appearance <get|set>` | Consulta ou define o tema de aparência (`system`, `light`, `dark`) |

Para integrar o SWG bar com clientes de IA, consulte o [guia do MCP](<https://swgbar.com/pt-BR/mcp/>). Para entender como as evidências de certificados são avaliadas, leia [como o SWG bar funciona](<https://swgbar.com/pt-BR/how-it-works/>).

## Continue lendo

*   [Como contornar uma SWG no Mac](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>)
*   [Como detectar inspeção HTTPS no Mac](<https://swgbar.com/pt-BR/guides/detect-https-inspection/>)
*   [Bypass de SWG ou exceção de inspeção TLS?](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>)
*   [Como o SWG bar verifica a inspeção HTTPS](<https://swgbar.com/pt-BR/how-it-works/>)
*   [Instale o SWG bar no Mac](<https://swgbar.com/pt-BR/install/>)
*   [Conecte a extensão do SWG bar para Chrome](<https://swgbar.com/pt-BR/chrome-extension/>)
*   [Guia do SWG bar MCP](<https://swgbar.com/pt-BR/mcp/>)
*   [Informações de versões do SWG bar](<https://swgbar.com/pt-BR/releases/>)
*   [Sobre o SWG bar](<https://swgbar.com/pt-BR/about/>)