SWG bar CLI-Anleitung

SWG bar enthält ein natives Befehlszeilenwerkzeug (swgbar) direkt in /Applications/SWGBar.app. Es bietet die gleichen Echtzeit-Überwachungs- und Prüffunktionen wie die macOS-Menüleisten-App, sodass Sie TLS-Zertifikate prüfen, HTTPS-Inspektionsergebnisse einsehen und domänenbasierten SWG-Bypass direkt im Terminal oder über Automatisierungsskripte verwalten können.

CLI einrichten

Nach der Installation von SWG bar befindet sich die ausführbare Datei im Anwendungspaket. Sie können sie direkt aufrufen, einen Alias in Ihrer Shell-Konfiguration (~/.zshrc oder ~/.bashrc) hinterlegen oder einen symbolischen Link in Ihrem PATH anlegen:

# Methode 1: Direkt aus dem Anwendungspaket ausführen
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Methode 2: Alias in der Shell-Konfiguration anlegen (~/.zshrc oder ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Methode 3: Symbolischen Link in /usr/local/bin anlegen (empfohlen für systemweiten Zugriff)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# CLI-Installation und Version überprüfen
swgbar version

Fügen Sie jedem Befehl --json an, wenn Sie strukturierte JSON-Ausgaben benötigen – ideal für die Weiterverarbeitung mit jq oder in benutzerdefinierten Skripten.

Übersichtskennzahlen, Domains und Zertifikate einsehen

Rufen Sie die gleichen Live-Daten und Zertifikatsnachweise wie in der Menüleisten-App ab:

# Gesamte HTTPS-Inspektionsrate, Statusaufschlüsselung und wichtigste Abfang-Zertifikate anzeigen
swgbar overview

# Beobachtete Domains auflisten mit optionaler Filterung und Paginierung
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Detaillierte TLS-Verbindungs- und Zertifikatsnachweise für eine bestimmte Domain anzeigen
swgbar domains detail <domain>

# Beobachtete Zertifikatscluster auflisten und Details zu einem bestimmten Zertifikatsnamen einsehen
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

Domains prüfen und SWG-Bypass verwalten

Führen Sie auf Abruf Echtzeit-TLS-Prüfungen für beliebige Hostnamen durch oder steuern Sie domänenspezifische SWG-Bypass-Regeln:

# Domain bei Bedarf prüfen, um Zertifikatsvertrauen und TLS-Inspektion zu bewerten
swgbar probe <domain>

# Aktuellen SWG-Bypass-Status und aktive Regeln anzeigen
swgbar bypass status

# SWG-Bypass für eine Domain aktivieren, umschalten, deaktivieren oder komplett leeren
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

Browser-Erweiterung und App-Einstellungen

Prüfen Sie die Verbindung zur Browser-Erweiterung, pausieren oder setzen Sie die Hintergrundüberwachung fort und passen Sie App-Einstellungen an:

# Verbindungsstatus der Chrome-Begleiterweiterung prüfen
swgbar plugins status
swgbar plugins check

# Hintergrundüberwachung prüfen, pausieren oder fortsetzen
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Lizenzstatus prüfen, nach Updates suchen und Sprache oder Erscheinungsbild anpassen
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>

Häufige Befehle im Überblick

Befehl	Beschreibung
swgbar overview	Gesamte HTTPS-Inspektionsrate, Statusstatistik und wichtigste Abfang-Zertifikate anzeigen
swgbar domains list	Beobachtete Domains auflisten mit Filtern für --search, --status, --bypass, --page und --page-size
swgbar domains detail <domain>	Verbindungsmetadaten, Zertifikatskettennachweise und Bypass-Status für eine Domain anzeigen
swgbar certificates list	Zertifikatscluster auflisten mit Filteroptionen für --search und --status
swgbar certificates detail "<certificate-name>"	Ausstellerinformationen, Gültigkeitszeitraum, SHA-256-Fingerprint und verknüpfte Domains anzeigen
swgbar bypass <status|enable|disable|toggle|clear>	Domänenspezifische SWG-Bypass-Regeln abfragen oder verwalten
swgbar probe <domain>	Bedarfsgesteuerte TLS-Echtzeitprüfung und Zertifikatsbewertung für eine Domain durchführen
swgbar plugins <status|check>	Verbindungsstatus zur Browser-Begleiterweiterung überprüfen
swgbar monitoring <status|pause|resume>	Hintergrund-Netzwerküberwachung überprüfen, pausieren oder fortsetzen
swgbar license <status|activate|deactivate>	Lizenzaktivierungsstatus einsehen oder verwalten
swgbar updates check	Nach Softwareaktualisierungen suchen
swgbar language <get|set>	Anzeigesprache einsehen oder umschalten (en, zh-Hans, zh-Hant, ja, ko)
swgbar appearance <get|set>	Erscheinungsbild-Design einsehen oder umschalten (system, light, dark)

Informationen zur Integration von SWG bar in KI-Desktop-Clients finden Sie in der MCP-Anleitung. Wie SWG bar Zertifikate auswertet, erfahren Sie unter Funktionsweise.