Dienst und Speicherung
konsolity serve bearbeitet die Anfragen des Claude-Connectors des Kontos wie die Desktop-App, aber ohne Oberfläche: Claude kann auf Ihren Servern arbeiten, selbst wenn Ihr Computer ausgeschaltet ist, innerhalb des Bereichs und der Regeln der Maschine. Erforderlich sind die Domäne mcp und die Claude-Integration des Tarifs Studio, und der Claude-Connector muss in Claude bereits hinzugefügt sein.
Im Vordergrund ausprobieren
konsolity serve
Der Befehl bleibt im Vordergrund und zeigt jede bearbeitete oder abgelehnte Anfrage an. Ctrl+C beendet ihn. Für einen echten Server installieren Sie ihn als Dienst.
Linux: systemd
sudo konsolity service install
Der Befehl:
- erstellt den Systembenutzer
konsolity, ohne Shell und ohne Passwort; - installiert die Unit
konsolity.servicemit automatischem Neustart (Restart=always) und der systemd-Sandbox (ProtectSystem=strict,NoNewPrivileges=yes); - legt die Konfiguration in
/etc/konsolity/und den Zustand in/var/lib/konsolity/ab; - verschlüsselt die Geheimnisse mit
systemd-creds(siehe unten); - kopiert das Programm nach
/usr/local/bin/konsolity(die Sandbox verbirgt/homevor dem Dienst); - installiert den Timer
konsolity-update.timer, der zweimal täglich die signierte Version prüft, das Programm aktualisiert und den Dienst neu startet; - aktiviert und startet den Dienst.
Der Dienst startet mit dem System und startet nach einem Fehler oder einem Netzausfall von selbst neu. Seine Protokolle:
journalctl -u konsolity
journalctl -u konsolity -f
Mehrere Server: Hauptrelais und Reserve
Aktivieren Sie Konsolity CLI auf zwei oder mehr Servern, jeweils mit service install. Ein Relais bearbeitet jede Claude-Anfrage: das mit der höchsten Priorität (Einstellungen › Claude › Claude-Relais). Die anderen stehen bereit, ohne laufende App oder Mac.
Hält das Hauptrelais sauber an, übernimmt das nächste innerhalb einer Sekunde. Fällt es ohne Vorwarnung aus, übernimmt das nächste eine unbeantwortete Anfrage nach 6 Sekunden, das dritte nach 12 Sekunden. Eine Anfrage wird nie doppelt ausgeführt. Das Journal zeigt die Rolle jeder Maschine: „Aktives Relais“ oder „Bereitschaft“.
Damit ein Reserverelais auch Befehle übernimmt, müssen seine Regeln Befehle erlauben (Einstellungen › CLI-Maschinen › die Maschine › Regeln). Sonst übernimmt es nur Lesezugriffe (Hosts, Snippets, Sitzungen).
macOS: launchd
sudo konsolity service install
Installiert den launchd-Dienst com.konsolity.cli, der automatisch neu gestartet wird (KeepAlive). Die Geheimnisse werden im Schlüsselbund gespeichert. Die Protokolle finden Sie in der App Konsole.
Windows: geplante Aufgabe
In einer PowerShell mit Administratorrechten:
konsolity service install
Erstellt eine geplante Aufgabe, die konsolity serve beim Start von Windows startet und nach einem Fehler neu startet.
Prüfen
konsolity status
status zeigt an, ob die Maschine erreichbar ist, das Alter des Tokens, den Bereich und die Anzahl der erreichbaren Hosts. Die Maschine erscheint in der Liste der CLI-Maschinen als online, solange sie in der letzten Minute ein Lebenszeichen gegeben hat.
Ordner
| Pfad | Inhalt |
|---|---|
~/.config/konsolity/ |
Linux und macOS, Verwendung ohne Dienst: config.json und Geheimnisse |
%APPDATA%\Konsolity\cli\ |
Windows: config.json und credentials.bin |
/etc/konsolity/ |
Linux-Dienst: Konfiguration |
/var/lib/konsolity/ |
Linux-Dienst: verschlüsselte Geheimnisse und Zustand |
config.json (Serveradresse, Kennung und Name der Maschine, angezeigter Bereich) hat die Rechte 0600. Die Datei enthält kein Geheimnis.
Speicherung der Geheimnisse
Die Geheimnisse der Maschine sind ihr Token und ihr Maschinenschlüssel. Sie werden je nach System gespeichert:
| System | Speicherung |
|---|---|
| macOS | Schlüsselbund (Eintrag com.konsolity.cli) |
| Linux, als Dienst | systemd-creds encrypt, mit dem TPM, wenn die Maschine eines hat, sonst mit dem Host-Schlüssel |
Linux, ohne systemd-creds |
Datei credentials.bin, 0600 |
| Windows | DPAPI (aktueller Benutzer) in credentials.bin, Zugriff auf das eigene Konto beschränkt |
In allen Fällen wird der Inhalt zuerst mit einem aus der Maschinenkennung abgeleiteten Schlüssel verschlüsselt: Auf einen anderen Computer kopiert, ist er unlesbar. Geheimnisse erscheinen nie in einem Protokoll, einem Kommandozeilenargument oder einer Umgebungsvariable, außer KONSOLITY_TOKEN, das Sie für ein langlebiges Token selbst übergeben.
Automatische Token-Rotation
Das Token einer Maschine wird automatisch alle 24 Stunden erneuert, ohne Unterbrechung: Das alte Token bleibt bis zum ersten Aufruf mit dem neuen gültig, höchstens 10 Minuten lang. Um eine Rotation zu erzwingen (nach dem Wiederherstellen einer Sicherung, nachdem ein Dritter an der Maschine gearbeitet hat):
konsolity rotate
Langlebige Tokens (setup-token) haben keine automatische Rotation; sie laufen spätestens nach einem Jahr ab.
Den Dienst entfernen
sudo konsolity service uninstall
Der Dienst wird gestoppt und entfernt. Die Maschine bleibt in Ihrem Konto aktiviert: Um auch sie abzuschalten, führen Sie konsolity logout aus oder widerrufen sie in der Liste der CLI-Maschinen.