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

# SWG bar CLI-Anleitung

Verwenden Sie das swgbar-Befehlszeilentool auf macOS, um den Status der HTTPS-Inspektion zu prüfen, Domains und Zertifikate einzusehen und SWG-Bypass im Terminal zu verwalten.

SWG bar · Aktualisiert 31\. Oktober 2026

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](<https://swgbar.com/de/install/>) 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](<https://swgbar.com/de/mcp/>). Wie SWG bar Zertifikate auswertet, erfahren Sie unter [Funktionsweise](<https://swgbar.com/de/how-it-works/>).

## Weiterlesen

*   [SWG auf dem Mac umgehen](<https://swgbar.com/de/guides/how-to-bypass-swg/>)
*   [HTTPS-Inspektion auf dem Mac erkennen](<https://swgbar.com/de/guides/detect-https-inspection/>)
*   [SWG umgehen oder TLS-Inspektion ausschließen?](<https://swgbar.com/de/guides/swg-bypass-vs-tls-exception/>)
*   [So prüft SWG bar HTTPS-Inspektion](<https://swgbar.com/de/how-it-works/>)
*   [SWG bar auf dem Mac installieren](<https://swgbar.com/de/install/>)
*   [Die SWG-bar-Erweiterung mit Chrome verbinden](<https://swgbar.com/de/chrome-extension/>)
*   [SWG bar MCP-Anleitung](<https://swgbar.com/de/mcp/>)
*   [Release-Informationen zu SWG bar](<https://swgbar.com/de/releases/>)
*   [Über SWG bar](<https://swgbar.com/de/about/>)