Serviciu și stocare

Actualizat pe 10 noiembrie 2026

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.service cu 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 /home de 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.