Ako udržať Hermes Agent spustený na serveri nepretržite

Po nainštalovaní Hermes Agent na notebooku sa vynára otázka: kto bude odpovedať na Telegrame a pripravovať ranné súhrny, keď je notebook vypnutý? Pri stole agent funguje iba dovtedy, kým je počítač zapnutý. Ak chcete, aby bol bot stále online a naplánované úlohy sa spúšťali samy, musíte agenta presunúť na server.

Nižšie sa dozviete, ako nainštalovať Hermes na bežný server Linux, nastaviť gateway ako nepretržite bežiacu službu, ktorá sa automaticky spustí po reštarte, a obmedziť prístup, aby sa cudzí ľudia nedostali do terminálu. Tento sprievodca vychádza z oficiálnej dokumentácie.

Ak ste Hermes ešte vôbec nenainštalovali, začnite samostatným prehľadom o tom, čo je tento agent a ako ho nainštalovať. Tento sprievodca predpokladá, že už vám beží na vlastnom počítači, a venuje sa iba jeho presunu na server.

Informácie o práci s Ailoot sú k dispozícii v dokumentácii.

Prečo presunúť Hermes Agent z notebooku na server?#

Na notebooku Hermes funguje iba vtedy, keď je veko otvorené a ste nablízku. Zatvorte ho a bot stíchne; ranný súhrn nepríde. To nie je vhodné pri úlohe typu „odpovedať ľuďom v messengeri a starať sa o veci podľa plánu“.

Práve v tom sa server líši: nikdy nespí a nezávisí od ničoho iného. Nainštalujete naň to isté Hermes a bude fungovať bez vás: odpovedať na Telegrame o tretej ráno, každé ráno zbierať správy o témach, ktoré vás zaujímajú, a uchovávať relácie medzi spusteniami.

Presun má zmysel, keď má agent nepretržitú úlohu: bota pre vás alebo váš tím, ranné súhrny, automatické odpovede alebo pravidelnú prácu s dokumentmi. Ak Hermes iba skúšate pri konkrétnom projekte a ste pri počítači, server zatiaľ nepotrebujete; bol by to ďalší krok navyše.

Čo si pripraviť pred inštaláciou Hermes na VPS?#

Pred inštaláciou si pripravte tri veci.

Server. Postačí bežný Linux VPS. Dokumentácia uvádza, že podpora prvej úrovne je pre Linux a WSL2 a testuje sa na najnovšom Ubuntu. Ak má systém glibc, systemd a obvyklé rozloženie adresárov, Hermes sa správne nainštaluje. Na serveri je to dôležité, pretože všetky nasledujúce kroky automatického spúšťania závisia od systemd, ktorý je súčasťou Ubuntu a Debianu.

Prístup SSH. K serveru sa pripájate cez terminál pomocou SSH; myš tam používať nebudete. Všetky nižšie uvedené príkazy spustíte v tejto relácii SSH. Ak tvoríte kód pomocou vibe codingu a terminál vám zatiaľ nie je pohodlný, nemusíte sa obávať: príkazov je iba niekoľko a každý môžete skopírovať celý.

Vybraný model. Agent nemyslí sám za seba; volá model. Pri serveri, ktorý funguje bez vás, je dôležité, aby prístup k modelu nevypršal. Najjednoduchšou možnosťou je predplatné Nous Portal cez hermes setup --portal: prihlásenie používa OAuth a token sa obnovuje automaticky. Fungujú aj vaše vlastné API kľúče, ale vtedy sa uistite, že je na účte dostatok prostriedkov—headless agent s nulovým zostatkom jednoducho prestane odpovedať. Model musí mať kontextové okno s veľkosťou aspoň 64 000 tokenov, inak Hermes odmietne s ním spustiť. Túto požiadavku spĺňajú všetky cloudové modely v zozname.

Ako nainštalovať Hermes Agent na server jedným príkazom?#

Inštalácia na server je takmer rovnaká ako na notebooku, s jedným rozdielom: agent tam zvyčajne nepotrebuje prehliadač. Automatizácia prehliadača navyše prináša náročný Chromium. Preto použijete príznak --skip-browser.

1. Pripojte sa k serveru cez SSH

   ssh root@your-server-address
   

   Všetky nasledujúce príkazy spustite v tejto relácii priamo na serveri.

2. Spustite inštalačný program bez prehliadača

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
   

   Skript stiahne potrebné prostredie a nainštaluje príkaz hermes. Príznak --skip-browser preskočí inštaláciu automatizácie prehliadača; na serveri bez grafického rozhrania by iba zaberala miesto. Ak budete neskôr potrebovať prehliadač, môžete ho nainštalovať samostatne.

3. Reštartujte shell a vyberte model

   source ~/.bashrc
   hermes setup --portal
   

   Prvý riadok načíta nové PATH, aby sa dal nájsť príkaz hermes. Druhý otvorí prihlásenie do Nous Portal: potvrďte prihlásenie a agent získa model a služby bez samostatných kľúčov pre každú z nich.

4. Skontrolujte inštaláciu

   hermes doctor
   

   Príkaz zobrazí, čo je nainštalované, čo chýba a ako to opraviť. Zelené označenia znamenajú, že je všetko pripravené.

Pred pridaním bota a plánu najprv rozbehnite jednu bezproblémovú konverzáciu priamo na serveri: spustite hermes a zadajte mu jednoduchú úlohu s overiteľnou odpoveďou. Dokumentácia výslovne odporúča nepridávať funkcie, kým nefunguje bežná konverzácia—je to rozumné odporúčanie.

Ako udržať Hermes v prevádzke nepretržite?#

Gateway je jediný proces Hermes na pozadí, ktorý udržiava pripojenia ku všetkým messengerom, spravuje relácie a spúšťa naplánované úlohy. Od neho závisí celá nepretržitá prevádzka. Cieľom je, aby sa tento proces spúšťal sám a zostal v chode.

Najprv nakonfigurujte gateway a pripojte messenger:

hermes gateway setup

Sprievodca nastavením vás prevedie platformami a pomôže vám zadať token bota a zoznam prístupov. Postup pripojenia Telegramu (vytvorenie bota pomocou BotFather, zistenie vášho ID a zadanie tokenu) je opísaný v hlavnom sprievodcovi inštaláciou; nebudem ho tu opakovať.

Nasleduje pasca, na ktorú ľudia najčastejšie zabúdajú. Ak jednoducho spustíte hermes gateway, proces bude fungovať iba dovtedy, kým zostane otvorená relácia SSH. Zatvorte terminál a gateway sa zastaví. Ak má fungovať nepretržite, musíte ju zveriť pod kontrolu systému. Na to slúži jeden príkaz:

hermes gateway install

Nainštaluje gateway ako službu: v Linuxe ako používateľskú službu systemd, v macOS cez launchd. Systém proces sleduje a po jeho páde ho znova spustí.

Na serveri budete častejšie potrebovať druhú možnosť: systémovú službu, ktorá sa spustí pri štarte počítača ešte pred prihlásením ktoréhokoľvek používateľa:

sudo hermes gateway install --system

Presne to potrebujete pre VPS: server sa reštartuje, služba sa spustí sama a bot je opäť online. Spravujte ju týmito jednoduchými príkazmi:

hermes gateway start     # start
hermes gateway stop      # stop
hermes gateway status    # check status

Pri systémovej službe pridajte k týmto príkazom sudo a príznak --system. Bez nich budú príkazy smerovať na používateľskú službu namiesto tej, ktorá sa spúšťa pri štarte:

sudo hermes gateway start --system
sudo hermes gateway stop --system
sudo hermes gateway status --system

Prečo je potrebný linger a čo bez neho prestane fungovať?#

Toto je najčastejší problém: nainštalovali ste službu, ale bot v noci aj tak stíchne. Dôvodom je spôsob fungovania používateľských služieb Linuxu.

Používateľská služba systemd je predvolene naviazaná na vašu reláciu. Pripojíte sa cez SSH a spustí sa váš správca používateľa; služba beží. Odhlásite sa a systém považuje používateľa za neaktívneho, takže spolu s vašou gateway vypne aj služby tohto používateľa. Na serveri, ku ktorému sa prihlasujete a odhlasujete, je to problém: bot je online iba počas vašej relácie SSH.

Môžete to opraviť režimom linger, ktorý umožňuje systému ponechať správcu používateľa spusteného, aj keď tento používateľ nie je prihlásený:

sudo loginctl enable-linger username

Po tomto príkaze používateľská služba funguje samostatne a spustí sa pri štarte servera bez toho, aby čakala na vaše prihlásenie. Bez linger sa obnoví pôvodné správanie: gateway sa po odpojení od SSH vypne a pri štarte sa nespustí. Dokumentácia to výslovne uvádza.

Ako spustiť Hermes na serveri v Dockeri s automatickými reštartmi?#

Docker je ďalší funkčný spôsob, ako udržiavať agenta na serveri, najmä ak ste už zvyknutí na kontajnery alebo chcete agenta izolovať od hlavného systému. Raz ho nakonfigurujte pomocou docker run ... setup a potom spustite kontajner na pozadí:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Riadky zodpovedné za nepretržitú prevádzku robia toto:

• -d — kontajner beží na pozadí a nedrží otvorený váš terminál.
• --restart unless-stopped — Docker obnoví kontajner po reštarte servera alebo po páde. Reštartuje ho iba vtedy, ak ste ho sami manuálne zastavili.
• -v ~/.hermes:/opt/data — nastavenia, kľúče, relácie a pamäť zostávajú na serveri mimo kontajnera a zachovajú sa aj po jeho opätovnom vytvorení.

Obraz pridáva ďalšiu ochranu: proces gateway beží pod dohľadom správcu s6. Ak gateway spadne, v priebehu niekoľkých sekúnd sa znova spustí bez straty samotného kontajnera. Je to dvojitá ochrana: Docker zvonka udržiava kontajner v chode a s6 sleduje proces vnútri.

Pamätajte na jeden rozdiel pri použití Dockeru: tieto inštalácie sa neaktualizujú príkazom hermes update. Ak chcete aktualizovať Docker, nahraďte obraz novým—stiahnite najnovší a znovu vytvorte kontajner.

Ako skontrolovať, že všetko funguje a prežije reštart?#

Pri používateľskej službe skontrolujte jej stav a záznamy takto:

hermes gateway status
journalctl --user -u hermes-gateway -f

Pre systémovú službu odporúčanú na VPS namiesto toho použite systémový rozsah:

sudo hermes gateway status --system
sudo journalctl -u hermes-gateway -f

Prvý príkaz kontroluje vybranú službu; druhý sleduje záznamy daného rozsahu. Tieto názvy jednotiek platia pre predvolenú inštaláciu ~/.hermes. Iné domovské priečinky Hermes môžu mať názov jednotky s príponou: prezrite stavový výstup a použite presnú jednotku. Pri testovaní systémovej inštalácie nesledujte používateľskú jednotku. Záznamy Hermes sú v ~/.hermes/logs/ a tajné údaje sa z nich automaticky redigujú, takže ich môžete bezpečne poslať podpore.

Teraz reštartujte server a uistite sa, že sa agent sám vráti. Toto je hlavná skúška servera a ľudia na ňu zvyčajne zabúdajú:

sudo reboot

Keď je server opäť dostupný, pripojte sa cez SSH. Pri systémovej inštalácii overte sudo hermes gateway status --system a systémový žurnál; pri používateľskej inštalácii s linger overte hermes gateway status a používateľský žurnál. Potom napíšte botovi na Telegrame. Ak odpovie bez vášho zásahu, automatické spúšťanie je nastavené správne. Presne o to tu išlo.

Nemusíte sa obávať straty konverzácie. Hermes zapisuje relácie na disk a tie prežijú reštart gateway. Navyše, ak gateway spadne práve vo chvíli, keď odosiela odpoveď, po obnovení ju doručí namiesto opätovného spustenia úlohy. Pri nepretržite bežiacom botovi je to dôležité: neočakávaný reštart nepreruší konverzáciu.

Ako zabezpečiť agenta s prístupom k terminálu na serveri?#

Agent na serveri je program s prístupom k terminálu, ktorý beží bez vášho dohľadu. Najprv skontrolujte tieto tri nastavenia.

Uzavretý prístup k botovi. Gateway predvolene odpovedá iba ľuďom zo zoznamu prístupov alebo tým, ktorí dokončili prepojenie pomocou kódu v priamej správe. To je správne správanie bota s prístupom k terminálu: náhodný človek, ktorý botovi napíše, nemôže nič urobiť. Zoznam sa nastavuje pomocou číselných ID, napríklad pre Telegram:

TELEGRAM_ALLOWED_USERS=123456789,987654321

Potvrdzovanie nebezpečných príkazov. Pred vykonaním čohokoľvek deštruktívneho si agent vyžiada vaše povolenie. Existuje režim YOLO, ktorý vypína potvrdzovanie; najlepšie je nezapínať ho na serveri bežiacom bez vás. Potvrdzovanie slúži práve na to, aby sa bez vášho vedomia nestalo nič nezvratné.

Sandbox na úplnú izoláciu. Ak chcete, aby agent fyzicky nemohol vidieť hlavný systém servera, spúšťajte jeho príkazy v kontajneri Docker:

hermes config set terminal.backend docker

Všetko, čo agent robí v termináli, sa potom odohráva v izolovanom sandboxe a nedosiahne na živý server. Je to rozumné ochranné opatrenie, keď agentovi dovolíte konať samostatne.

Čo robiť, ak bot mlčí alebo gateway spadne?#

Keď bot prestane odpovedať, postupujte v tomto poradí. Najprv overte nainštalovaný rozsah: sudo hermes gateway status --system a systémový žurnál pri systémovej službe alebo hermes gateway status a používateľský žurnál pri používateľskej službe. Ak gateway beží, ale správy neprechádzajú, takmer vždy ide o problém s konfiguráciou platformy: token bota je nesprávny alebo daná osoba nie je v zozname prístupov. Znova spustite hermes gateway setup v rovnakom domovskom priečinku Hermes a potom posúďte vybranú službu cez hermes gateway status --system pri systémovej alebo hermes gateway status pri používateľskej. Úspešné nastavenie nedokazuje, že beží správna gateway.

Ak model vracia prázdne alebo zvláštne odpovede, skontrolujte ho príkazom hermes model a overte poskytovateľa a prihlásenie. Všeobecný postup obnovy, ktorý vás vráti z „všetko je pokazené“ do funkčného stavu, je: hermes doctor, hermes model, hermes setup a potom hermes gateway status --system pri systémovej inštalácii alebo hermes gateway status pri používateľskej.

Ešte jedna vec pre zriedkavý, ale nepríjemný prípad, keď celý proces zamrzne bez toho, aby skutočne spadol. Služba systemd má časovač watchdog: pridajte tento riadok do ~/.hermes/config.yaml a službu nainštalujte znova.

gateway:
  systemd_watchdog_seconds: 120

# Pre systémovú službu VPS (rovnaký domovský priečinok Hermes ako pri pôvodnej inštalácii):
sudo hermes gateway install --system --force
sudo hermes gateway status --system

Pri používateľskej službe namiesto toho obnovte iba tento rozsah cez hermes gateway install --force a overte hermes gateway status. Vyberte jeden rozsah; pri oprave jednej gateway neinštalujte oba.

Potom gateway pravidelne signalizuje systému: „Som nažive.“ Ak signály prestanú, systemd proces automaticky reštartuje. Funguje to iba na Linuxe so systemd a iba pri zamrznutí procesu. Časovač watchdog nemá vplyv na bežné prerušenie siete medzi serverom a messengerom.

Na čo sa ľudia ešte pýtajú o Hermes Agent na serveri?#

Spoznajte Ailoot.