Servizio e archiviazione
konsolity serve gestisce le richieste del connettore Claude dell'account come farebbe l'app desktop, ma senza interfaccia: Claude può agire sui tuoi server anche quando il tuo computer è spento, entro l'ambito e le regole della macchina. Richiede il dominio mcp e l'integrazione Claude del piano Studio, e il connettore Claude deve essere già aggiunto in Claude.
Provarlo in primo piano
konsolity serve
Il comando resta in primo piano e mostra ogni richiesta gestita o rifiutata. Ctrl+C lo arresta. Per un vero server, installalo come servizio.
Linux: systemd
sudo konsolity service install
Il comando:
- crea l'utente di sistema
konsolity, senza shell né password; - installa l'unità
konsolity.servicecon riavvio automatico (Restart=always) e l'isolamento di systemd (ProtectSystem=strict,NoNewPrivileges=yes); - conserva la configurazione in
/etc/konsolity/e lo stato in/var/lib/konsolity/; - cifra i segreti con
systemd-creds(vedi sotto); - copia il binario in
/usr/local/bin/konsolity(la sandbox nasconde/homeal servizio); - installa il timer
konsolity-update.timer, che due volte al giorno controlla la versione firmata, aggiorna il binario e riavvia il servizio; - abilita e avvia il servizio.
Il servizio parte con il sistema e si riavvia da solo dopo un errore o un'interruzione di rete. I suoi log:
journalctl -u konsolity
journalctl -u konsolity -f
Più server: relay principale e di riserva
Attiva Konsolity CLI su due o più server, ciascuno con service install. Un solo relay gestisce ogni richiesta di Claude: quello con la priorità più alta (Impostazioni › Claude › Relay di Claude). Gli altri restano di riserva, senza app né Mac accesi.
Se il relay principale si ferma correttamente, il successivo subentra entro un secondo. Se cade senza preavviso, il successivo prende una richiesta rimasta senza risposta dopo 6 secondi, il terzo dopo 12 secondi. Una richiesta non viene mai eseguita due volte. Il registro indica il ruolo di ogni macchina: «Relay attivo» o «Di riserva».
Perché un relay di riserva prenda anche i comandi, le sue regole devono consentire comandi (Impostazioni › Macchine CLI › la macchina › Regole). Altrimenti prende solo le letture (host, snippet, sessioni).
macOS: launchd
sudo konsolity service install
Installa il servizio launchd com.konsolity.cli, riavviato automaticamente (KeepAlive). I segreti sono conservati nel portachiavi. I log si trovano nell'app Console.
Windows: attività pianificata
In un PowerShell da amministratore:
konsolity service install
Crea un'attività pianificata che avvia konsolity serve all'avvio di Windows e lo riavvia dopo un errore.
Verificare
konsolity status
status indica se la macchina è raggiungibile, l'età del token, l'ambito e il numero di host raggiungibili. La macchina compare online nell'elenco delle Macchine CLI finché ha dato un segno di vita nell'ultimo minuto.
Cartelle
| Percorso | Contenuto |
|---|---|
~/.config/konsolity/ |
Linux e macOS, uso senza servizio: config.json e segreti |
%APPDATA%\Konsolity\cli\ |
Windows: config.json e credentials.bin |
/etc/konsolity/ |
Servizio Linux: configurazione |
/var/lib/konsolity/ |
Servizio Linux: segreti cifrati e stato |
config.json (indirizzo del server, identificativo e nome della macchina, ambito visualizzato) ha permessi 0600. Non contiene alcun segreto.
Archiviazione dei segreti
I segreti della macchina sono il suo token e la sua chiave della macchina. Vengono conservati in base al sistema:
| Sistema | Archiviazione |
|---|---|
| macOS | Portachiavi (elemento com.konsolity.cli) |
| Linux, come servizio | systemd-creds encrypt, con il TPM se la macchina ne ha uno, altrimenti con la chiave dell'host |
Linux, senza systemd-creds |
file credentials.bin, 0600 |
| Windows | DPAPI (utente corrente) in credentials.bin, accesso riservato al solo account |
In ogni caso, il contenuto viene prima cifrato con una chiave derivata dall'identificativo della macchina: copiato su un altro computer, è illeggibile. I segreti non compaiono mai in un log, in un argomento della riga di comando o in una variabile d'ambiente, tranne KONSOLITY_TOKEN che scegli tu di fornire per un token di lunga durata.
Rotazione automatica del token
Il token di una macchina viene rinnovato automaticamente ogni 24 ore, senza interruzioni: il vecchio token resta accettato fino alla prima chiamata effettuata con quello nuovo, per 10 minuti al massimo. Per forzare una rotazione (dopo il ripristino di un backup, dopo che un terzo è intervenuto sulla macchina):
konsolity rotate
I token di lunga durata (setup-token) non hanno rotazione automatica; scadono al più tardi dopo un anno.
Rimuovere il servizio
sudo konsolity service uninstall
Il servizio viene arrestato e rimosso. La macchina resta attivata sul tuo account: per disattivarla del tutto, esegui konsolity logout o revocala dall'elenco delle Macchine CLI.