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

# Guide de SWG bar CLI

Utilisez l'outil en ligne de commande swgbar sur macOS pour vérifier l'état d'inspection HTTPS, consulter les domaines et certificats, et gérer le contournement SWG.

SWG bar · Mis à jour 31 octobre 2026

SWG bar intègre un outil natif en ligne de commande (`swgbar`) directement au sein de `/Applications/SWGBar.app`. Il propose les mêmes fonctionnalités de surveillance et d’inspection en temps réel que l’application pour la barre des menus de macOS, vous permettant d’auditer les certificats TLS, d’évaluer l’interception HTTPS et de gérer le contournement SWG directement depuis Terminal ou via des scripts.

## Configurer la CLI

Après avoir [installé SWG bar](<https://swgbar.com/fr/install/>), l’exécutable se situe à l’intérieur du paquet de l’application. Vous pouvez le lancer directement, définir un alias dans votre configuration de shell (`~/.zshrc` ou `~/.bashrc`), ou créer un lien symbolique dans votre `PATH` :

```
# Option 1 : Exécuter directement depuis le paquet de l'application
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Option 2 : Ajouter un alias dans votre profil de shell (~/.zshrc ou ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Option 3 : Créer un lien symbolique dans /usr/local/bin (recommandé pour un accès global)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Vérifier l'installation et la version
swgbar version
```

Ajoutez `--json` à n’importe quelle commande pour obtenir une sortie structurée en JSON, idéale pour le traitement avec `jq` ou l’automatisation.

## Métriques générales, domaines et certificats

Consultez les données en temps réel et les preuves de certificats identiques à celles de l’application de la barre des menus :

```
# Afficher le taux global d'inspection HTTPS, la répartition par statut et les principaux certificats
swgbar overview

# Lister les domaines observés avec filtrage et pagination facultatifs
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Afficher les preuves détaillées de connexion TLS et de certificat pour un domaine spécifique
swgbar domains detail <domain>

# Lister les groupes de certificats et consulter les détails d'un certificat donné
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"
```

## Analyser des domaines et gérer le contournement SWG

Effectuez des analyses TLS en temps réel pour n’importe quel nom d’hôte ou gérez les règles de contournement SWG par domaine :

```
# Analyser un domaine à la demande pour vérifier la confiance du certificat et l'inspection TLS
swgbar probe <domain>

# Consulter l'état actuel du contournement SWG et les règles actives
swgbar bypass status

# Activer, basculer, désactiver ou effacer le contournement SWG pour un domaine
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear
```

## Extension de navigateur et préférences de l’application

Vérifiez la connectivité de l’extension de navigateur, suspendez ou reprenez la surveillance en arrière-plan, et configurez les préférences de l’application :

```
# Vérifier l'état de connexion de l'extension Chrome associée
swgbar plugins status
swgbar plugins check

# Vérifier, suspendre ou reprendre la surveillance en arrière-plan
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Consulter la licence, rechercher des mises à jour et modifier la langue ou l'apparence
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>
```

## Commandes courantes

| Commande | Description |
| --- | --- |
| `swgbar overview` | Affiche le pourcentage global d’inspection HTTPS, les statistiques de statut et les principaux certificats intercepteurs |
| `swgbar domains list` | Liste les domaines observés avec filtres `--search`, `--status`, `--bypass`, `--page` et `--page-size` |
| `swgbar domains detail <domain>` | Affiche les métadonnées de connexion, les preuves de la chaîne de certificats et l’état de contournement |
| `swgbar certificates list` | Liste les groupes de certificats avec filtres `--search` et `--status` |
| `swgbar certificates detail "<certificate-name>"` | Affiche l’émetteur, la période de validité, l’empreinte SHA-256 et les domaines associés |
| `swgbar bypass <status|enable|disable|toggle|clear>` | Interroge ou gère les règles de contournement SWG par domaine |
| `swgbar probe <domain>` | Effectue une analyse TLS à la demande et l’évaluation du certificat pour un domaine |
| `swgbar plugins <status|check>` | Vérifie la connectivité avec l’extension de navigateur associée |
| `swgbar monitoring <status|pause|resume>` | Vérifie, suspend ou reprend la surveillance réseau en arrière-plan |
| `swgbar license <status|activate|deactivate>` | Consulte ou gère l’état d’activation de la licence |
| `swgbar updates check` | Recherche les mises à jour logicielles disponibles |
| `swgbar language <get|set>` | Affiche ou définit la langue de l’interface (`en`, `zh-Hans`, `zh-Hant`, `ja`, `ko`) |
| `swgbar appearance <get|set>` | Affiche ou définit le thème d’apparence (`system`, `light`, `dark`) |

Pour intégrer SWG bar avec des clients d’IA, consultez le [guide MCP](<https://swgbar.com/fr/mcp/>). Pour comprendre comment les preuves de certificats sont évaluées, lisez [fonctionnement de SWG bar](<https://swgbar.com/fr/how-it-works/>).

## Pour aller plus loin

*   [Comment contourner une SWG sur Mac](<https://swgbar.com/fr/guides/how-to-bypass-swg/>)
*   [Détecter l’inspection HTTPS sur un Mac](<https://swgbar.com/fr/guides/detect-https-inspection/>)
*   [Contournement de SWG ou exception d’inspection TLS ?](<https://swgbar.com/fr/guides/swg-bypass-vs-tls-exception/>)
*   [Comment SWG bar vérifie l’inspection HTTPS](<https://swgbar.com/fr/how-it-works/>)
*   [Installer SWG bar sur votre Mac](<https://swgbar.com/fr/install/>)
*   [Connecter l’extension Chrome de SWG bar](<https://swgbar.com/fr/chrome-extension/>)
*   [Guide de SWG bar MCP](<https://swgbar.com/fr/mcp/>)
*   [Informations de version de SWG bar](<https://swgbar.com/fr/releases/>)
*   [À propos de SWG bar](<https://swgbar.com/fr/about/>)