Serviciu și stocare
konsolity serve tratează cererile conectorului Claude al contului așa cum ar face-o aplicația desktop, dar fără interfață: Claude poate acționa asupra serverelor dumneavoastră chiar și când computerul este oprit, în limitele domeniului și ale regulilor mașinii. Necesită domeniul mcp și integrarea Claude din planul Studio, iar conectorul Claude trebuie să fie deja adăugat în Claude.
Încercarea în prim-plan
konsolity serve
Comanda rămâne în prim-plan și afișează fiecare cerere tratată sau refuzată. Ctrl+C o oprește. Pentru un server real, instalați-o ca serviciu.
Linux: systemd
sudo konsolity service install
Comanda:
- creează utilizatorul de sistem
konsolity, fără shell și fără parolă; - instalează unitatea
konsolity.servicecu repornire automată (Restart=always) și izolarea systemd (ProtectSystem=strict,NoNewPrivileges=yes); - stochează configurația în
/etc/konsolity/și starea în/var/lib/konsolity/; - criptează secretele cu
systemd-creds(vezi mai jos); - copiază binarul în
/usr/local/bin/konsolity(sandboxul ascunde/homede serviciu); - instalează temporizatorul
konsolity-update.timer, care verifică versiunea semnată de două ori pe zi, actualizează binarul și repornește serviciul; - activează și pornește serviciul.
Serviciul pornește odată cu sistemul și repornește singur după o eroare sau o întrerupere a rețelei. Jurnalele sale:
journalctl -u konsolity
journalctl -u konsolity -f
Mai multe servere: releu principal și de rezervă
Activați Konsolity CLI pe două sau mai multe servere, fiecare cu service install. Un singur releu tratează fiecare cerere Claude: cel cu prioritatea cea mai mare (Setări › Claude › Relee Claude). Celelalte rămân în rezervă, fără aplicație sau Mac pornit.
Dacă releul principal se oprește corect, următorul preia într-o secundă. Dacă cade fără avertisment, următorul preia o cerere rămasă fără răspuns după 6 secunde, al treilea după 12 secunde. O cerere nu este niciodată executată de două ori. Jurnalul arată rolul fiecărei mașini: „Releu activ” sau „În rezervă”.
Pentru ca un releu de rezervă să preia și comenzile, regulile lui trebuie să permită comenzi (Setări › Mașini CLI › mașina › Reguli). Altfel preia doar citirile (gazde, snippeturi, sesiuni).
macOS: launchd
sudo konsolity service install
Instalează serviciul launchd com.konsolity.cli, repornit automat (KeepAlive). Secretele sunt stocate în portofelul de chei. Jurnalele se află în aplicația Consolă.
Windows: activitate programată
Într-un PowerShell de administrator:
konsolity service install
Creează o activitate programată care pornește konsolity serve la pornirea Windows și o repornește după o eroare.
Verificare
konsolity status
status indică dacă mașina este accesibilă, vechimea tokenului, domeniul și numărul de gazde accesibile. Mașina apare ca online în lista Mașini CLI atât timp cât a dat un semn de viață în ultimul minut.
Dosare
| Cale | Conținut |
|---|---|
~/.config/konsolity/ |
Linux și macOS, utilizare fără serviciu: config.json și secrete |
%APPDATA%\Konsolity\cli\ |
Windows: config.json și credentials.bin |
/etc/konsolity/ |
Serviciu Linux: configurație |
/var/lib/konsolity/ |
Serviciu Linux: secrete criptate și stare |
config.json (adresa serverului, identificatorul și numele mașinii, domeniul afișat) are permisiunile 0600. Nu conține niciun secret.
Stocarea secretelor
Secretele mașinii sunt tokenul și cheia sa de mașină. Sunt stocate în funcție de sistem:
| Sistem | Stocare |
|---|---|
| macOS | Portofelul de chei (elementul com.konsolity.cli) |
| Linux, ca serviciu | systemd-creds encrypt, cu TPM dacă mașina are unul, altfel cu cheia gazdei |
Linux, fără systemd-creds |
Fișierul credentials.bin, 0600 |
| Windows | DPAPI (utilizatorul curent) în credentials.bin, acces restricționat doar la cont |
În toate cazurile, conținutul este mai întâi criptat cu o cheie derivată din identificatorul mașinii: copiat pe alt computer, este ilizibil. Secretele nu apar niciodată într-un jurnal, într-un argument de linie de comandă sau într-o variabilă de mediu, cu excepția KONSOLITY_TOKEN, pe care alegeți să o furnizați pentru un token de lungă durată.
Rotația automată a tokenului
Tokenul unei mașini este reînnoit automat la fiecare 24 de ore, fără întrerupere: vechiul token rămâne acceptat până la primul apel făcut cu cel nou, cel mult 10 minute. Pentru a forța o rotație (după restaurarea unei copii de rezervă, după ce o terță parte a intervenit pe mașină):
konsolity rotate
Tokenurile de lungă durată (setup-token) nu au rotație automată; expiră cel târziu după un an.
Eliminarea serviciului
sudo konsolity service uninstall
Serviciul este oprit și eliminat. Mașina rămâne activată pe contul dumneavoastră: pentru a o deconecta și pe ea, rulați konsolity logout sau revocați-o din lista Mașini CLI.