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

# Guía de SWG bar CLI

Utilice la herramienta de línea de comandos swgbar en macOS para comprobar el estado de inspección HTTPS, consultar dominios y certificados, y gestionar el bypass de SWG.

SWG bar · Actualizado 31 de octubre de 2026

SWG bar incluye una herramienta nativa de línea de comandos (`swgbar`) dentro de `/Applications/SWGBar.app`. Proporciona las mismas funciones que la aplicación de la barra de menús de macOS, lo que le permite auditar certificados TLS, evaluar la interceptación HTTPS y gestionar el bypass de SWG directamente desde Terminal o mediante scripts.

## Configuración de la CLI

Tras [instalar SWG bar](<https://swgbar.com/es/install/>), el ejecutable se encuentra dentro del paquete de la aplicación. Puede ejecutarlo directamente, definir un alias en su archivo de configuración de shell (`~/.zshrc` o `~/.bashrc`), o crear un enlace simbólico en su `PATH`:

```
# Opción 1: Ejecutar directamente desde el paquete de la aplicación
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Opción 2: Añadir un alias al perfil de la shell (~/.zshrc o ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Opción 3: Crear un enlace simbólico en /usr/local/bin (recomendado para acceso global)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Verificar la instalación y la versión
swgbar version
```

Añada `--json` a cualquier comando para obtener salidas estructuradas en formato JSON, idóneo para su procesamiento con `jq` o en flujos de automatización.

## Métricas generales, dominios y certificados

Consulte los mismos datos en tiempo real y evidencias de certificados que se muestran en la barra de menús:

```
# Ver el porcentaje global de inspección HTTPS, desglose por estado y principales certificados
swgbar overview

# Listar dominios observados con filtrado opcional y paginación
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Ver evidencias detalladas de conexión TLS y certificados para un dominio
swgbar domains detail <domain>

# Listar agrupaciones de certificados y consultar detalles de un certificado específico
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"
```

## Sondeo de dominios y gestión del bypass de SWG

Realice evaluaciones TLS en tiempo real para cualquier nombre de host o gestione las reglas de bypass de SWG por dominio:

```
# Sondear un dominio bajo demanda para evaluar la confianza del certificado y la inspección TLS
swgbar probe <domain>

# Consultar el estado actual del bypass de SWG y las reglas activas
swgbar bypass status

# Activar, alternar, desactivar o borrar las reglas de bypass de un dominio
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear
```

## Extensión del navegador y preferencias de la aplicación

Compruebe la conectividad de la extensión del navegador, pause o reanude la monitorización en segundo plano y configure las preferencias:

```
# Comprobar el estado de conexión de la extensión complementaria de Chrome
swgbar plugins status
swgbar plugins check

# Comprobar, pausar o reanudar la monitorización en segundo plano
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Gestionar el estado de la licencia, buscar actualizaciones y cambiar idioma o apariencia
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 frecuentes

| Comando | Descripción |
| --- | --- |
| `swgbar overview` | Muestra el porcentaje de inspección HTTPS, estadísticas de estado y principales certificados interceptores |
| `swgbar domains list` | Lista los dominios observados con filtros para `--search`, `--status`, `--bypass`, `--page` y `--page-size` |
| `swgbar domains detail <domain>` | Muestra metadatos de conexión, evidencias de la cadena de certificados y estado de bypass |
| `swgbar certificates list` | Lista agrupaciones de certificados con filtros de `--search` y `--status` |
| `swgbar certificates detail "<certificate-name>"` | Muestra información del emisor, período de validez, huella digital SHA-256 y dominios asociados |
| `swgbar bypass <status|enable|disable|toggle|clear>` | Consulta o gestiona las reglas de bypass de SWG por dominio |
| `swgbar probe <domain>` | Realiza un sondeo TLS bajo demanda y evaluación de certificados para un dominio |
| `swgbar plugins <status|check>` | Comprueba la conectividad con la extensión complementaria del navegador |
| `swgbar monitoring <status|pause|resume>` | Consulta, pausa o reanuda la monitorización de red en segundo plano |
| `swgbar license <status|activate|deactivate>` | Consulta o gestiona el estado de activación de la licencia |
| `swgbar updates check` | Busca actualizaciones de la aplicación |
| `swgbar language <get|set>` | Consulta o cambia el idioma de la interfaz (`en`, `zh-Hans`, `zh-Hant`, `ja`, `ko`) |
| `swgbar appearance <get|set>` | Consulta o cambia el tema visual (`system`, `light`, `dark`) |

Para integrar SWG bar con clientes de IA, consulte la [guía de MCP](<https://swgbar.com/es/mcp/>). Para comprender cómo se evalúan las evidencias de certificados, lea [cómo funciona SWG bar](<https://swgbar.com/es/how-it-works/>).

## Sigue leyendo

*   [Cómo evitar una SWG en Mac](<https://swgbar.com/es/guides/how-to-bypass-swg/>)
*   [Cómo detectar la inspección HTTPS en un Mac](<https://swgbar.com/es/guides/detect-https-inspection/>)
*   [Bypass de SWG frente a una excepción de inspección TLS](<https://swgbar.com/es/guides/swg-bypass-vs-tls-exception/>)
*   [Cómo comprueba SWG bar la inspección HTTPS](<https://swgbar.com/es/how-it-works/>)
*   [Instala SWG bar en tu Mac](<https://swgbar.com/es/install/>)
*   [Conecta la extensión de Chrome de SWG bar](<https://swgbar.com/es/chrome-extension/>)
*   [Guía de SWG bar MCP](<https://swgbar.com/es/mcp/>)
*   [Información de versiones de SWG bar](<https://swgbar.com/es/releases/>)
*   [Acerca de SWG bar](<https://swgbar.com/es/about/>)