Tjeneste og lagring
konsolity serve behandler forespørslene fra kontoens Claude-kobling slik skrivebordsappen ville gjort, men uten grensesnitt: Claude kan arbeide på serverne dine selv når datamaskinen din er slått av, innenfor maskinens omfang og regler. Den krever domenet mcp og Claude-integrasjonen i Studio-planen, og Claude-koblingen må allerede være lagt til i Claude.
Prøv i forgrunnen
konsolity serve
Kommandoen kjører i forgrunnen og viser hver forespørsel som behandles eller avvises. Ctrl+C stopper den. På en ordentlig server installerer du den som tjeneste.
Linux: systemd
sudo konsolity service install
Kommandoen:
- oppretter systembrukeren
konsolity, uten skall og uten passord; - installerer enheten
konsolity.servicemed automatisk omstart (Restart=always) og systemd-sandkassen (ProtectSystem=strict,NoNewPrivileges=yes); - lagrer konfigurasjonen i
/etc/konsolity/og tilstanden i/var/lib/konsolity/; - krypterer hemmelighetene med
systemd-creds(se nedenfor); - kopierer programmet til
/usr/local/bin/konsolity(sandkassen skjuler/homefor tjenesten); - installerer tidtakeren
konsolity-update.timer, som sjekker den signerte versjonen to ganger om dagen, oppdaterer programmet og starter tjenesten på nytt; - aktiverer og starter tjenesten.
Tjenesten starter sammen med systemet og starter seg selv på nytt etter en feil eller et nettverksbrudd. Loggene:
journalctl -u konsolity
journalctl -u konsolity -f
Flere servere: hovedrelé og reserve
Aktiver Konsolity CLI på to eller flere servere, hver med service install. Ett relé behandler hver Claude-forespørsel: det med høyest prioritet (Innstillinger › Claude › Claude-reléer). De andre står i reserve, uten app eller Mac påslått.
Stopper hovedreléet på vanlig måte, tar det neste over innen ett sekund. Faller det ut uten varsel, tar det neste over en ubesvart forespørsel etter 6 sekunder, det tredje etter 12 sekunder. En forespørsel kjøres aldri to ganger. Loggen viser rollen til hver maskin: «Aktivt relé» eller «Reserve».
For at et reserverelé også skal ta over kommandoer, må reglene tillate kommandoer (Innstillinger › CLI-maskiner › maskinen › Regler). Ellers tar det bare over lesing (verter, snippets, økter).
macOS: launchd
sudo konsolity service install
Installerer launchd-tjenesten com.konsolity.cli, som startes på nytt automatisk (KeepAlive). Hemmelighetene lagres i nøkkelringen. Loggene finner du i Konsoll-appen.
Windows: planlagt oppgave
I et PowerShell-vindu som administrator:
konsolity service install
Oppretter en planlagt oppgave som starter konsolity serve når Windows starter, og starter den på nytt etter en feil.
Kontroller
konsolity status
status viser om maskinen kan nås, tokenets alder, omfanget og antall verter som kan nås. Maskinen vises som tilkoblet i listen CLI-maskiner så lenge den har gitt livstegn i løpet av det siste minuttet.
Mapper
| Sti | Innhold |
|---|---|
~/.config/konsolity/ |
Linux og macOS, bruk uten tjeneste: config.json og hemmeligheter |
%APPDATA%\Konsolity\cli\ |
Windows: config.json og credentials.bin |
/etc/konsolity/ |
Linux-tjeneste: konfigurasjon |
/var/lib/konsolity/ |
Linux-tjeneste: krypterte hemmeligheter og tilstand |
config.json (serveradresse, maskinens identifikator og navn, omfanget som vises) har 0600. Den inneholder ingen hemmeligheter.
Lagring av hemmeligheter
Maskinens hemmeligheter er tokenet og maskinnøkkelen. De lagres avhengig av systemet:
| System | Lagring |
|---|---|
| macOS | Nøkkelring (elementet com.konsolity.cli) |
| Linux, som tjeneste | systemd-creds encrypt, med TPM når maskinen har en, ellers med vertsnøkkelen |
Linux, uten systemd-creds |
Filen credentials.bin, 0600 |
| Windows | DPAPI (gjeldende bruker) i credentials.bin, tilgang begrenset til kontoen alene |
I alle tilfeller krypteres innholdet først med en nøkkel avledet fra maskinidentifikatoren: kopiert til en annen datamaskin er det uleselig. Hemmeligheter vises aldri i en logg, et kommandolinjeargument eller en miljøvariabel, bortsett fra KONSOLITY_TOKEN, som du selv velger å oppgi for et langvarig token.
Automatisk tokenrotasjon
Tokenet til en maskin fornyes automatisk hver 24. time, uten avbrudd: det gamle tokenet godtas fram til det første kallet med det nye, maks 10 minutter. Slik tvinger du en rotasjon (etter gjenoppretting av en sikkerhetskopi, etter at en tredjepart har arbeidet på maskinen):
konsolity rotate
Langvarige tokener (setup-token) har ingen automatisk rotasjon; de utløper senest etter ett år.
Fjern tjenesten
sudo konsolity service uninstall
Tjenesten stoppes og fjernes. Maskinen forblir aktivert på kontoen din: for å koble den fra også kjører du konsolity logout eller tilbakekaller den fra listen CLI-maskiner.