Dienst und Speicherung

Aktualisiert am 10. November 2026

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.service mit 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 /home vor 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.