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

# Guida a SWG bar CLI

Usa lo strumento da riga di comando swgbar su macOS per verificare l'ispezione HTTPS, visualizzare domini e certificati e gestire il bypass SWG da Terminale.

SWG bar · Aggiornato 31 ottobre 2026

SWG bar include uno strumento nativo da riga di comando (`swgbar`) integrato all’interno di `/Applications/SWGBar.app`. Offre le stesse funzionalità di monitoraggio e ispezione in tempo reale dell’app per la barra dei menu di macOS, consentendoti di esaminare i certificati TLS, rilevare l’intercettazione HTTPS e gestire il bypass SWG direttamente da Terminale o tramite script.

## Configurazione della CLI

Dopo aver [installato SWG bar](<https://swgbar.com/it/install/>), il file binario si trova all’interno del pacchetto dell’applicazione. Puoi eseguirlo direttamente, aggiungere un alias alla configurazione della tua shell (`~/.zshrc` o `~/.bashrc`), oppure creare un collegamento simbolico nel tuo `PATH`:

```
# Opzione 1: Esegui direttamente dal pacchetto dell'applicazione
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Opzione 2: Aggiungi un alias al profilo della shell (~/.zshrc o ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Opzione 3: Crea un collegamento simbolico in /usr/local/bin (consigliato per l'accesso globale)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Verifica l'installazione e la versione
swgbar version
```

Aggiungi `--json` a qualsiasi comando per ottenere un output strutturato in formato JSON, ideale per l’elaborazione con `jq` o in flussi di automazione.

## Metriche generali, domini e certificati

Visualizza i dati in tempo reale e le evidenze dei certificati identici a quelli mostrati nella barra dei menu:

```
# Mostra la percentuale globale di ispezione HTTPS, la suddivisione per stato e i certificati principali
swgbar overview

# Elenca i domini osservati con filtri opzionali e paginazione
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Visualizza i dettagli di connessione TLS e certificati per uno specifico dominio
swgbar domains detail <domain>

# Elenca i cluster di certificati e visualizza i dettagli per un certificato specifico
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"
```

## Verifica dei domini e gestione del bypass SWG

Esegui verifiche TLS in tempo reale su qualsiasi hostname o gestisci le regole di bypass SWG a livello di dominio:

```
# Verifica un dominio su richiesta per valutare l'attendibilità del certificato e l'ispezione TLS
swgbar probe <domain>

# Controlla lo stato corrente del bypass SWG e le regole attive
swgbar bypass status

# Attiva, alterna, disattiva o azzera il bypass SWG per un dominio
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear
```

## Estensione browser e preferenze dell’app

Verifica la connettività dell’estensione del browser, sospendi o riprendi il monitoraggio in background e configura le impostazioni dell’app:

```
# Verifica lo stato di connessione dell'estensione Chrome
swgbar plugins status
swgbar plugins check

# Controlla, sospendi o riprendi il monitoraggio in background
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Controlla lo stato della licenza, verifica aggiornamenti e modifica lingua o aspetto
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>
```

## Comandi principali

| Comando | Descrizione |
| --- | --- |
| `swgbar overview` | Mostra la percentuale di ispezione HTTPS, le statistiche per stato e i certificati di intercettazione |
| `swgbar domains list` | Elenca i domini osservati con filtri per `--search`, `--status`, `--bypass`, `--page` e `--page-size` |
| `swgbar domains detail <domain>` | Mostra metadati di connessione, evidenze della catena di certificati e stato di bypass |
| `swgbar certificates list` | Elenca i cluster di certificati con opzioni di filtro `--search` e `--status` |
| `swgbar certificates detail "<certificate-name>"` | Mostra emittente, periodo di validità, impronta digitale SHA-256 e domini associati |
| `swgbar bypass <status|enable|disable|toggle|clear>` | Visualizza o gestisce le regole di bypass SWG per dominio |
| `swgbar probe <domain>` | Esegue una verifica TLS su richiesta e la valutazione del certificato per un dominio |
| `swgbar plugins <status|check>` | Verifica la connettività con l’estensione associata del browser |
| `swgbar monitoring <status|pause|resume>` | Controlla, sospende o riprende il monitoraggio di rete in background |
| `swgbar license <status|activate|deactivate>` | Visualizza o gestisce lo stato di attivazione della licenza |
| `swgbar updates check` | Controlla la disponibilità di aggiornamenti software |
| `swgbar language <get|set>` | Visualizza o imposta la lingua dell’interfaccia (`en`, `zh-Hans`, `zh-Hant`, `ja`, `ko`) |
| `swgbar appearance <get|set>` | Visualizza o imposta il tema visivo (`system`, `light`, `dark`) |

Per integrare SWG bar con assistenti IA, consulta la [guida a MCP](<https://swgbar.com/it/mcp/>). Per comprendere come vengono valutate le evidenze dei certificati, leggi [come funziona SWG bar](<https://swgbar.com/it/how-it-works/>).

## Continua a leggere

*   [Come aggirare una SWG su Mac](<https://swgbar.com/it/guides/how-to-bypass-swg/>)
*   [Come rilevare l’ispezione HTTPS su Mac](<https://swgbar.com/it/guides/detect-https-inspection/>)
*   [Bypass SWG ed eccezione all’ispezione TLS](<https://swgbar.com/it/guides/swg-bypass-vs-tls-exception/>)
*   [Come SWG bar verifica l’ispezione HTTPS](<https://swgbar.com/it/how-it-works/>)
*   [Installa SWG bar sul Mac](<https://swgbar.com/it/install/>)
*   [Collega l’estensione Chrome di SWG bar](<https://swgbar.com/it/chrome-extension/>)
*   [Guida a SWG bar MCP](<https://swgbar.com/it/mcp/>)
*   [Informazioni sulle versioni di SWG bar](<https://swgbar.com/it/releases/>)
*   [Informazioni su SWG bar](<https://swgbar.com/it/about/>)