Hoe je Hermes Agent op een homeserver uitvoert zonder gegevens te verliezen

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Kort antwoord

Als je Hermes Agent op een homeserver wilt uitvoeren zonder gegevens te verliezen, vertrouw dan niet op het interne bestandssysteem van de container als enige opslaglocatie voor configuratie, vaardigheden, logboeken, gegenereerde bestanden of gateway-instellingen. Richt eerst een permanente hostmap of een Docker-volume in, koppel dit aan het containerpad dat de app daadwerkelijk gebruikt, controleer het eigenaarschap van de bestanden en verifieer dat de gegevens na het opnieuw starten of opnieuw configureren nog bestaan. Dit artikel richt zich op het veelvoorkomende probleem waarbij een container een map niet kan vinden door problemen met volumekoppelingen, machtigingen of padkoppelingen.

De veiligste werkwijze voor beginners is:

  1. Bepaal welke Hermes Agent-gegevens behouden moeten blijven.
  2. Kies een aparte hostmap of een door Docker beheerd volume.
  3. Koppel die opslag aan het juiste containerpad.
  4. Controleer of de gebruiker van de app ernaar kan schrijven.
  5. Maak een back-up van belangrijke configuratie voordat je updates uitvoert of de container opnieuw opbouwt.
  6. Start opnieuw op en controleer of de configuratie, logboeken, gegenereerde bestanden en gateway-instellingen nog aanwezig zijn.

Een actieve container betekent niet automatisch dat je gegevens veilig zijn. Gegevens zijn alleen veilig als ze op een permanente locatie zijn opgeslagen, beschrijfbaar zijn voor de juiste gebruiker, indien nodig zijn geback-upt en na het opnieuw starten zijn gecontroleerd.

Waarom Hermes Agent-gegevens in een containerconfiguratie kunnen verdwijnen

Apps in containers zijn vaak eenvoudig te starten en te vervangen. Dat is handig voor updates, tests en herstel, maar betekent ook dat alles wat alleen in de wegwerpbare containerlaag is opgeslagen, verloren kan gaan wanneer de container wordt verwijderd, opnieuw aangemaakt of opnieuw opgebouwd.

Bij een zelfgehoste AI-agent kan dit gevolgen hebben voor meer dan alleen basisinstellingen. Afhankelijk van hoe je de agent gebruikt, zijn mogelijk de modelconfiguratie, vaardigheden, gegenereerde bestanden, logboeken, instellingen van de berichten-gateway en andere appgegevens belangrijk voor je.

Containers opnieuw starten versus permanente appgegevens

Een container opnieuw starten verwijdert niet altijd gegevens. Als de gegevens zijn opgeslagen op een permanent volume of in een correct gekoppelde hostmap, zouden ze na het opnieuw starten beschikbaar moeten blijven.

Het risico ontstaat wanneer belangrijke bestanden alleen in de beschrijfbare laag van de container staan. Die laag is niet hetzelfde als een daarvoor bedoelde permanente opslaglocatie. Als je de container opnieuw aanmaakt zonder het juiste pad te behouden of opnieuw te koppelen, kan de app met een schone lei starten of de vorige bestanden niet vinden.

Waarom het verwijderen of opnieuw aanmaken van een container niet-opgeslagen gegevens kan verwijderen

Een container verwijderen of opnieuw aanmaken is iets anders dan deze opnieuw starten. Een opnieuw aangemaakte container kan een nieuw intern bestandssysteem, nieuwe omgevingsvariabelen of een andere koppeling van volumes hebben.

Als de instellingen, vaardigheden, logboeken of gegenereerde uitvoer van Hermes Agent nooit naar een permanente hostmap of een volume zijn geschreven, gaan ze mogelijk niet mee naar de nieuwe container. Daarom kunnen zowel ‘de app werkte gisteren’ als ‘de app is gereset na de update’ waar zijn.

Veiligheidshalve kun je containervervanging het beste als een risico voor je gegevens beschouwen, tenzij je hebt bevestigd waar de appgegevens worden opgeslagen.

Waarom hostpaden en containerpaden vooraf moeten worden gepland

Een hostpad is de locatie waar gegevens op de homeserver staan. Een containerpad is de locatie waarop de app die gegevens binnen de container ziet. Een volumekoppeling of bind mount verbindt die twee werelden.

Als het hostpad klopt maar aan het verkeerde containerpad is gekoppeld, kan het lijken alsof de map niet bestaat. Als het containerpad klopt maar het hostpad vluchtig is, kan de app gegevens opslaan op een plek die je niet bedoelde.

Plan de koppeling voordat je de app uitvoert, niet nadat je gegevens bent kwijtgeraakt.

Welke gegevens moet je beschermen voordat je Hermes Agent uitvoert?

Voordat je een container wijzigt, een image bijwerkt of een gateway opnieuw configureert, moet je een lijst maken van de gegevens die lastig opnieuw te maken zouden zijn. Niet elk bestand heeft dezelfde bescherming nodig, maar je moet weten welke bestanden essentieel zijn.

Een handige vuistregel: bescherm alles waarin identiteit, toegang, configuratie, aangeleerde workflows of uitvoer is opgeslagen die je niet gemakkelijk opnieuw kunt genereren.

Agentconfiguratie en instellingen voor modelproviders

Modelinstellingen omvatten meestal de keuze van de provider, eindpuntwaarden, modelnamen, opties voor de context en API-toegang. Als deze instellingen verloren gaan, kan de agent wel starten, maar mogelijk niet goed antwoorden.

Bewaar de modelconfiguratie op een permanent datapad van de app, niet in een vluchtige shellsessie. Als de configuratie via omgevingsvariabelen wordt aangeleverd, bewaar dan een veilige kopie van het compose-bestand, het env-bestand of de implementatienotities.

Bescherm ook alle instelkeuzes die bepalen hoe de agent terminaltools of berichtengateways gebruikt.

Appgeheugen, sessies, vaardigheden en runtime-status

Gegevens van Hermes Agent kunnen uit meer dan één configuratiebestand bestaan. De gegevensstructuur van Hermes-vaardigheden legt uit dat vaardigheden zich bevinden in ~/.hermes/skills/, de belangrijkste bron voor gebundelde, vanuit de hub geïnstalleerde en door de agent gemaakte vaardigheden. Ook beschrijft deze gerelateerde status, zoals gebundelde manifesten, vaardigheidsbundels, de configuratie voor hub-taps, wachtende schrijfbewerkingen voor vaardigheden en configuratie-instellingen.

Dit is belangrijk omdat door de agent gemaakte vaardigheden herbruikbaar procedureel geheugen kunnen worden. Als het verkeerde pad wordt gekoppeld, kun je niet alleen instellingen kwijtraken, maar ook workflows die de agent heeft geleerd of vaardigheden die je hebt geïnstalleerd.

Beschouw vaardigheden, bundels, wachtende schrijfbewerkingen en profielgerelateerde status als permanente agentgegevens.

Downloads, gegenereerde bestanden, logbestanden en uitvoer van tools

Gegenereerde bestanden zijn gemakkelijk over het hoofd te zien. Een agent kan tijdens normaal gebruik plannen, scripts, rapporten, schermafbeeldingen, logbestanden of gedownloade bestanden maken.

Deze bestanden kunnen worden opgeslagen in de actieve werkruimte, de werkmap van de backend, de thuismap van de app of een gekoppeld uitvoerpad. Als die locatie alleen binnen de container bestaat, kunnen de bestanden verdwijnen wanneer de container wordt verwijderd.

Bepaal voor praktisch gebruik waar gegenereerde bestanden op de hostserver moeten verschijnen en controleer of de container daar schrijft.

API-sleutels, bottokens en omgevingsvariabelen

Geheimen zijn geen gewone appgegevens. API-sleutels, bottokens, dashboardwachtwoorden en omgevingsvariabelen moeten zowel behouden als beschermd blijven.

Sla geheimen niet op in willekeurige mappen met gegenereerde uitvoer of in breed gedeelde mappen. Bewaar ze op een gecontroleerd configuratiepad met beperkte toegang.

Een goede aanpak voor geheimen moet antwoord geven op het volgende:

  • waar het geheim is opgeslagen;
  • welke gebruiker het kan lezen;
  • of het in back-ups is opgenomen;
  • of de back-up versleuteld is of de toegang beperkt is;
  • hoe het geheim kan worden vervangen als het openbaar wordt gemaakt.

Hostpad versus containerpad versus volumekoppelingen

Dit is het kernconcept achter de meeste problemen met ‘container kan map niet vinden’ en ‘data verdwenen na herstart’. Een container kan alleen zien wat zich in zijn eigen bestandssysteem bevindt of wat eraan is gekoppeld.

Gebruik De overlevingskaart voor agentgegevens om de configuratie te ordenen voordat je problemen gaat oplossen.

Frameworkmodule Kernvraag Waarover het je helpt beslissen Focus van configuratie / probleemoplossing
Gegevensinventaris Welke data moet behouden blijven na een herstart of nieuwe aanmaak van de container? Welke configuraties, vaardigheden, logs, downloads, tokens en gegenereerde bestanden beschermd moeten worden Voorkomt dat belangrijke agentgegevens worden behandeld als tijdelijke data
Pad voor permanente opslag Waar moet permanente data op de host staan? Of je een specifieke hostmap, Docker-volume of bind-mount moet gebruiken Voorkomt dat data wordt gereset wanneer de container opnieuw wordt aangemaakt
Koppelingsmapping Is het hostpad correct gekoppeld aan het containerpad? Of de app de bedoelde map daadwerkelijk kan zien Helpt bij het opsporen van fouten door ontbrekende mappen en onjuiste bestemmingspaden
Machtigingsgrens Welke gebruiker eigenaar is van de gekoppelde data en welke gebruiker ernaar schrijft? Of de bestanden eigendom zijn van de hostgebruiker, containergebruiker, appgebruiker of root Helpt bij het oplossen van fouten met geweigerde toegang zonder alles eigendom van root te maken
Back-upgrens Waarvan moet je een back-up maken voordat je updates uitvoert of de configuratie wijzigt? Welke data kritiek is en welke tijdelijk Voorkomt verlies van configuratie, vaardigheden, sessies, tokens en gatewayinstellingen
Herstartvalidatie Bestaat de data nog na een herstart of update? Of de configuratie daadwerkelijk duurzaam is Maakt van ‘het werkt’ een herhaalbare veiligheidscontrole

Wat de hostserver opslaat

De hostserver slaat de echte mappen, schijven en opslaglocaties op die door Docker worden beheerd. Bij een bind-mount kies je een specifieke hostmap. Bij een benoemd Docker-volume kiest en beheert Docker de opslaglocatie.

Dit onderscheid is belangrijk, omdat de zichtbaarheid op de host van invloed is op back-ups en migraties. Een via bind-mount gekoppelde map is voor beginners misschien makkelijker te vinden en te kopiëren. Een benoemd volume is mogelijk overzichtelijker voor door Docker beheerde appgegevens, maar je moet nog steeds weten hoe je het inspecteert of er een back-up van maakt.

Kies de opslagmethode op basis van de vraag of u leesbare hostmappen, door Docker beheerde persistente opslag voor apps of een gecontroleerd back-uppad nodig hebt.

Wat de container kan zien

De container ziet zijn eigen interne bestandssysteem en alle gekoppelde paden. Hij ziet niet automatisch elke map op uw thuisserver.

In de stapsgewijze uitleg over bindkoppelingen van Docker ziet u hoe een hostmap in een container op een doelpad beschikbaar kan zijn en hoe bestandswijzigingen tussen de host en de container kunnen worden doorgevoerd als de koppeling correct is.

Dat is het basisidee: het maakt de app niet uit waar een bestand op de host staat, tenzij het bestand is gekoppeld aan het pad dat de app gebruikt.

Hoe volumekoppelingen app-gegevens persistent houden

Met een persistente koppeling heeft de app een stabiele plek om gegevens op te slaan die langer meegaat dan één container. Voor app-gegevens is dit vaak het verschil tussen ‘behouden na een herstart’ en ‘alleen behouden zolang de container bestaat’.

De koppeling moet overeenkomen met het verwachte gegevenspad van de app. Als de app naar een interne map schrijft, maar u een andere map koppelt, kunnen de gegevens alsnog in tijdelijke opslag terechtkomen.

Een goede persistente configuratie moet het volgende bepalen:

  • de hostmap of het benoemde volume;
  • het doelpad in de container;
  • of de koppeling lees- en schrijfbaar of alleen-lezen is;
  • welke app-gegevens daar thuishoren;
  • hoe er een back-up van het pad wordt gemaakt.

Waarom een onjuiste koppeling van paden fouten over ontbrekende mappen veroorzaakt

Een onjuiste koppeling van paden lijkt vaak op een probleem met een ontbrekende map. De map bestaat mogelijk op de host, maar de container kan deze niet zien. Of de container heeft mogelijk een map op het verwachte pad, maar die is niet gekoppeld aan de hostmap die u bedoelde.

Veelvoorkomende symptomen zijn:

  • de app geeft aan dat een map niet bestaat;
  • gegenereerde bestanden verschijnen in de container, maar niet op de host;
  • logboeken verdwijnen nadat de container opnieuw is opgebouwd;
  • de configuratie wordt na een update teruggezet;
  • u past een map op de host aan, maar de app blijft oude instellingen gebruiken;
  • back-upscripts worden uitgevoerd, maar nemen de daadwerkelijke app-gegevens niet mee.

Controleer in dat geval zowel het hostpad als het containerpad. Controleer niet slechts één kant.

Hermes Agent uitvoeren zonder gegevens te verliezen

Het doel is niet alleen om Hermes Agent te starten. Het doel is ervoor te zorgen dat de gegevens die u belangrijk vindt behouden blijven na een herstart, update, nieuwe build en herconfiguratie.

Stap 1: Kies een aparte gegevensmap op de host

Kies een gegevensmap op de host voordat u de container start of opnieuw opbouwt. De map moet gemakkelijk te herkennen en te back-uppen zijn, en niet vermengd zijn met niet-gerelateerde persoonlijke bestanden.

Een aparte map verkleint het risico, omdat u kunt zien wat bij de app hoort. Zo voorkomt u ook dat u uw volledige thuismap of andere gevoelige mappen in de container koppelt.

Een praktische gegevensmap op de host moet:

  • specifiek voor de app;
  • buiten tijdelijke downloadmappen;
  • opgenomen in uw back-upplan;
  • niet breed gedeeld met niet-gerelateerde services;
  • alleen schrijfbaar door de gebruikers of services die toegang nodig hebben.

Stap 2: Koppel de gegevensmap aan de container

Koppel de gegevensmap op de host aan het containerpad dat de app verwacht. Op dit moment worden veel problemen met gegevensverlies veroorzaakt of voorkomen.

Bij een bind mount kies je het hostpad; het doelpad geeft aan waar de map in de container verschijnt. Bij een benoemd volume beheert Docker de locatie aan de hostkant.

Ga er niet van uit dat de app automatisch een gekoppelde map gebruikt. Controleer of het gekoppelde doelpad overeenkomt met het werkelijke pad voor app-gegevens.

Stap 3: Controleer of de container het verwachte pad voor app-gegevens gebruikt

Controleer na het koppelen het pad vanuit de container. Een map kan op de host bestaan en toch onzichtbaar zijn voor de app als deze niet correct is gekoppeld.

De eenvoudigste controle is om aan de ene kant een onschuldig testbestand aan te maken of te zoeken en te bevestigen dat het aan de andere kant verschijnt. Controleer vervolgens of de app echte configuratiebestanden, logboeken of gegenereerde bestanden naar hetzelfde persistente pad schrijft.

Deze stap is vooral belangrijk vóór updates of een migratie.

Stap 4: Controleer het eigenaarschap van bestanden en de schrijfmachtigingen

Zelfs een correcte koppeling kan mislukken als de app er niet naar kan schrijven. Machtigingsfouten ontstaan vaak wanneer bestanden door root worden aangemaakt, maar de app later als een andere gebruiker wordt uitgevoerd.

Controleer het eigenaarschap voordat je de machtigingen op grote schaal wijzigt. Meestal is de juiste oplossing om de beoogde app-gebruiker lees- en schrijfrechten te geven voor de specifieke app-gegevensmap, niet om elk proces volledige toegang te geven tot brede hostmappen.

Als je 'toegang geweigerd' ziet, bepaal dan het volgende:

  1. het gekoppelde hostpad;
  2. het doelpad in de container;
  3. de gebruiker die de app uitvoert;
  4. de eigenaar van het bestand;
  5. of de koppeling alleen-lezen is;
  6. of een back-up- of exportpad ook schrijfbaar is.

Stap 5: Bewaar geheimen en configuratiebestanden buiten tijdelijke locaties

Geheimen en configuratiebestanden mogen niet alleen in tijdelijke mappen, mappen met gegenereerde uitvoer of willekeurige shellgeschiedenis staan. Als je omgevingsvariabelen gebruikt, bewaar het implementatiebestand of env-bestand dan op een beheerde, persistente locatie.

Voorkom dat geheimen worden vermengd met logboeken of gegenereerde bestanden. Logboeken kunnen worden gedeeld voor probleemoplossing, maar geheimen mag je nooit zomaar delen.

Als je geheimen back-upt, beveilig die back-up dan goed. Een back-up waarin API-sleutels of bottokens uitlekken, brengt een ander soort risico met zich mee.

Stap 6: Start de container opnieuw op en controleer of de gegevens nog bestaan

Start de container na de installatie opnieuw op en controleer of de belangrijke gegevens behouden zijn. Dit is de meest praktische test om te controleren of gegevens persistent zijn.

Stop niet bij 'de container start'. Controleer of:

  • modelinstellingen nog aanwezig zijn;
  • vaardigheden of appstatus zichtbaar blijven;
  • logboeken op de verwachte locatie blijven staan;
  • gegenereerde bestanden op de host verschijnen;
  • gateway- of botinstellingen nog werken;
  • back-upbestanden kunnen worden gevonden.

Een installatie die na een herstartcontrole nog goed werkt, is veel veiliger dan een installatie die alleen direct na de eerste installatie goed werkte.

Rechten, back-ups en veiligheidsgrenzen

Gegevensveiligheid hangt af van drie grenzen: wie er mag schrijven, waarvan een back-up wordt gemaakt en waartoe de agent toegang heeft. Deze grenzen zijn vooral belangrijk bij zelfgehoste agents, omdat die bestanden kunnen maken, workflows kunnen wijzigen of met tools kunnen werken.

Waarom toestemmingen van containergebruikers belangrijk zijn

De toestemmingen van de containergebruiker bepalen of de app de gegevens kan lezen en schrijven. Als de app als de ene gebruiker draait, maar de gekoppelde map eigendom is van een andere gebruiker, kunnen schrijfbewerkingen mislukken.

Daarom kan het uitvoeren van een installatieopdracht als root later problemen veroorzaken. Root kan bestanden maken, maar de gewone app-gebruiker kan ze mogelijk niet wijzigen.

Herstel toestemmingen op het niveau van de map met app-gegevens. Vermijd brede wijzigingen van toestemmingen die geen verband houdende bestanden op de host toegankelijk maken.

Waarom je niet alles als root moet uitvoeren

Root kan veel beperkingen omzeilen, maar dat maakt het geen veilige standaardinstelling. Alles als root uitvoeren kan ertoe leiden dat bestanden eigendom worden van root, toestemmingsproblemen verbergen en de app meer toegang geven dan nodig is.

Bij de meeste workflows met zelfgehoste apps gebruik je root alleen voor specifieke beheertaken. Voer gewone app-configuratie indien mogelijk uit als de bedoelde app- of containergebruiker.

De veiligere aanpak is minimale toegangsrechten: geef de app alleen schrijfrechten voor de mappen die nodig zijn.

Wanneer je alleen-lezenkoppelingen of beperkte mappen gebruikt

Gebruik alleen-lezenkoppelingen wanneer de agent bestanden moet bekijken maar ze niet mag wijzigen. Gebruik mappen met beperkte schrijfrechten wanneer de agent uitvoer moet maken, maar geen toegang mag hebben tot brede persoonlijke of systeemmappen.

Dit is vooral handig als je wilt dat de agent rapporten, plannen of scripts genereert zonder schrijfrechten te geven voor alle bestanden op de server.

Een ontwerp met beperkte mappen verkleint de gevolgen van fouten. Het maakt back-ups ook eenvoudiger, omdat je weet welke map de app-status bevat en welke map de gegenereerde uitvoer bevat.

Een back-up maken van agentgegevens vóór updates of herconfiguratie

Maak een back-up van belangrijke app-gegevens voordat je containerimages, koppelingspaden, gateway-instellingen of profielen wijzigt. Een back-up is alleen nuttig als je weet wat erin zit en hoe je die kunt terugzetten.

De discussie over toestemmingen bij back-ups van volumes in de Docker-community laat een veelvoorkomend probleem zien: een pad kan bestaan, maar back-up- of schrijfbewerkingen kunnen toch mislukken door beperkingen rond toestemmingen, eigenaarschap, labels of koppelingen van volumes.

Gebruik dit als herinnering om back-ups te testen, niet alleen te maken. Een back-upplan moet zowel het maken van back-ups als het controleren van het herstel omvatten.

Veelvoorkomende problemen en oplossingen

Als Hermes Agent-gegevens ontbreken, installeer de app dan niet meteen opnieuw. Stel eerst vast welke laag is uitgevallen: de gegevensinventaris, het opslagpad, de koppeling van volumes, de toestemmingsgrens, de back-upgrens of de validatie na het opnieuw opstarten.

De container kan een gekoppelde map niet vinden

Dit betekent meestal dat het pad in de ene laag wel bestaat, maar in de andere niet. De hostmap is mogelijk niet gekoppeld, het doelpad in de container kan onjuist zijn of de app zoekt mogelijk op een andere locatie.

Controleer dit in de volgende volgorde:

  1. Controleer of de map op de host bestaat.
  2. Controleer of de container de mount heeft.
  3. Controleer het doelpad in de container.
  4. Controleer of de app is ingesteld om dat doelpad te gebruiken.
  5. Controleer of de app-gebruiker de map kan lezen.
  6. Controleer of de mount opnieuw is aangemaakt nadat je de instellingen voor compose of run hebt gewijzigd.

Los dit niet op door willekeurige mappen in de container aan te maken. Daardoor kan de fout tijdelijk verdwijnen, terwijl de gegevens in vluchtige opslag blijven staan.

Appgegevens worden na het opnieuw opstarten teruggezet

Als gegevens na het opnieuw opstarten worden teruggezet, schrijft de app mogelijk naar het interne bestandssysteem van de container in plaats van naar het persistente pad. Mogelijk gebruikt de app ook een ander profiel, een andere omgevingsvariabele of een andere datamap dan verwacht.

Controleer of het datapad vóór en na het opnieuw opstarten hetzelfde is. Controleer vervolgens of de map wordt ondersteund door een mount of alleen door de containerlaag.

Als de app opnieuw is aangemaakt, controleer dan of hetzelfde volume of dezelfde bind mount aan de nieuwe container is gekoppeld.

Fouten met geweigerde toegang in de datamap

‘Permission denied’ betekent dat de app het pad kan zien, maar de vereiste handeling niet kan uitvoeren. Het probleem kan liggen bij het eigenaarschap, alleen-lezen-koppelingsinstellingen, bestandssysteemlabels of een verschil tussen de hostgebruiker en de containergebruiker.

Begin met de eenvoudigste controle: kan de app-gebruiker een onschadelijk testbestand in de datamap aanmaken? Zo niet, controleer dan de eigenaar en toegangsrechten van dat specifieke pad.

Los dit niet op door brede schrijftoegang tot de volledige hostmap te geven. Corrigeer het datapad van de app en de bedoelde app-gebruiker.

Gegenereerde bestanden worden alleen in de container opgeslagen

Als gegenereerde bestanden na een herbouw verdwijnen, zijn ze waarschijnlijk in de container opgeslagen in plaats van op een gekoppeld hostpad. Dit gebeurt vaak wanneer de werkmap of uitvoermap van de app niet is gekoppeld.

Bepaal waar gegenereerde bestanden moeten worden opgeslagen. Koppel vervolgens die uitvoermap of configureer de app om naar een bestaande persistente locatie te schrijven.

Maak na het wijzigen van het pad een onschadelijk testbestand aan en controleer of het op de host verschijnt.

Bot- of gatewayinstellingen verdwijnen na herconfiguratie

Gatewayinstellingen kunnen verdwijnen als de configuratie op een niet-persistente locatie is opgeslagen of als de app na het opnieuw opstarten onder een ander profiel draait. Hetzelfde kan gebeuren als een omgevingsvariabele op de ene plek wordt gewijzigd, maar de actieve container een andere waarde gebruikt.

Controleer of de gatewayconfiguratie, de verwijzing naar het bot-token, de allowlist en de dashboardinstellingen op de verwachte persistente locatie zijn opgeslagen. Start de gateway vervolgens opnieuw op en controleer of de instellingen actief blijven.

Als de bot vóór het opnieuw opstarten werkt, maar daarna niet meer, richt je dan eerst op permanente opslag en de omgevingsconfiguratie voordat je het token wijzigt.

Zo controleer je of de gegevens van je Hermes Agent veilig zijn

Een veilige configuratie moet de controles voor opnieuw opstarten, schrijven, back-ups en toegang doorstaan. Deze controles hoeven niet ingewikkeld te zijn, maar moeten na grote wijzigingen worden herhaald.

Configuratie blijft behouden na opnieuw opstarten

Wijzig een onschuldige instelling, start de container opnieuw op en controleer of de instelling behouden blijft. Zo bevestig je dat de app naar permanente opslag schrijft.

Als de instelling verdwijnt, voeg dan niet meer configuratie toe. Herstel eerst het gegevenspad.

Logs en gegenereerde bestanden verschijnen in de verwachte map op de host

Logs en gegenereerde bestanden moeten op de verwachte plek op de host verschijnen. Als ze alleen in de container verschijnen, kunnen ze bij het opnieuw opbouwen verloren gaan.

Controleer beide kanten van de koppeling. De host en de container moeten dezelfde bestanden zien.

De agent kan zonder fouten met machtigingen naar app-gegevens schrijven

De agent moet als de bedoelde gebruiker naar de gegevensmap van de app kunnen schrijven. Een geslaagde schrijftest is nuttiger dan alleen controleren of de map bestaat.

Let na het opnieuw opstarten in de logs op fouten met machtigingen. Sommige problemen met machtigingen treden pas op wanneer de agent de configuratie probeert bij te werken, een vaardigheid probeert op te slaan, een gegenereerd bestand opslaat of de gatewaystatus bijwerkt.

Back-upbestanden kunnen worden gevonden en teruggezet

Een back-up is pas compleet als je hem kunt vinden en naar een testlocatie kunt terugzetten. Controleer op zijn minst of de back-up de gegevens bevat die je wilde beschermen.

Zet de back-up bij belangrijke configuraties terug naar een aparte map of testomgeving voordat je erop vertrouwt. Zo ontdek je problemen met terugzetten niet pas nadat gegevens verloren zijn gegaan.

Dashboard of berichtentoegang werkt nog na opnieuw opstarten

Controleer na het opnieuw opstarten of het dashboard of de berichtentoegang nog werkt. Zo bevestig je dat de permanente gegevens, inloggegevens, gatewayinstellingen en netwerktoegang nog steeds op elkaar zijn afgestemd.

Werkt het dashboard, maar mislukt het berichtenverkeer, controleer dan de gatewayinstellingen en de toegang tot het token. Werkt het berichtenverkeer, maar verdwijnen gegenereerde bestanden, controleer dan het uitvoerpad en de koppelingen.

Zo werkt dit in een echte thuisserveromgeving

In een echte thuisserverconfiguratie geldt dezelfde logica voor gegevensveiligheid, ook als het systeem een gebruiksvriendelijk dashboard biedt. Je moet nog steeds weten welke gegevens behouden moeten blijven, waar ze zijn opgeslagen, hoe de container ze ziet, welke gebruiker ernaar kan schrijven en hoe je ze na een herstart kunt controleren.

Zo toont de installatieworkflow van ZimaOS Hermes Agent bijvoorbeeld een apparaatspecifiek stappenplan met de configuratie van de modelprovider, het instellen van de Telegram-gateway, toegang tot de Hermes-container, het activeren van de app-omgeving, het controleren van het webdashboard en het oplossen van problemen met machtigingen of botreacties.

Voor gebruikers die Docker-apps, agentworkflows en lokale diensten uitvoeren op een compacte machine die altijd aanstaat, is de ZimaBoard 2-homeserver een relevant voorbeeld van het soort lichte homeserveromgeving waarin permanente mappen, containerpaden, machtigingen en opslaguitbreiding samen moeten worden gepland. Het is niet de enige mogelijke configuratie, maar sluit aan bij het soort zelfgehoste appworkflow dat in deze gids wordt besproken.

De algemene les is breed toepasbaar: voordat je een containeragent vertrouwt met nuttig werk, moet je ervoor zorgen dat de belangrijke gegevens behouden blijven wanneer de container die vandaag actief is, verdwijnt.

Veelgestelde vragen

Waarom zijn mijn Hermes Agent-gegevens verdwenen nadat ik de container opnieuw heb gestart?

Een gewone herstart zou geen permanente gegevens moeten verwijderen, maar het kan lijken alsof de app is teruggezet als deze naar een niet-permanent containerpad schreef. De gegevens kunnen ook ontbreken als de container opnieuw is aangemaakt zonder hetzelfde volume of dezelfde bind mount. Controleer het hostpad, het containerpad en het daadwerkelijke pad met app-gegevens voordat je meer instellingen wijzigt.

Wat is het verschil tussen een Docker-volume en een bind mount?

Een Docker-volume wordt beheerd door Docker, terwijl een bind mount een door jou gekozen map op de host aan de container koppelt. Een volume is vaak handig voor gegevens die door de app worden beheerd, terwijl een bind mount op de host gemakkelijker rechtstreeks te vinden is. De beste keuze hangt ervan af of je opslag door Docker wilt laten beheren of liever een zichtbare hostmap hebt voor back-ups en inspectie.

Waar moet ik de app-gegevens van Hermes Agent op een homeserver opslaan?

Gebruik een aparte permanente map of een Docker-volume in plaats van een tijdelijk containerpad. De locatie moet eenvoudig te back-uppen zijn, beperkt blijven tot wat de app nodig heeft en geen gevoelige, niet-gerelateerde bestanden bevatten. Het belangrijkste is dat het verwachte containerpad van de app daadwerkelijk is gekoppeld aan die permanente opslag.

Waarom zegt de container dat een map niet bestaat?

De map bestaat mogelijk wel op de host, maar niet in de container. Meestal betekent dit dat de koppeling niet is aangemaakt, het bronpad niet klopt, het doelpad niet klopt of de app naar een ander pad in de container zoekt. Controleer zowel de host als de container, in plaats van zomaar een nieuwe map aan te maken.

Moet ik Hermes Agent als root uitvoeren om machtigingsfouten te voorkomen?

Uitvoeren als root kan de directe fout verbergen, maar kan bestanden opleveren waarvan root eigenaar is en het risico vergroten. Veiliger is om de beoogde app-gebruiker alleen lees- en schrijfrechten te geven voor het benodigde pad met app-gegevens. Gebruik root alleen voor specifieke beheer- of herstelacties waarvan je de gevolgen begrijpt.

Hoe vaak moet ik een back-up maken van Hermes Agent-gegevens?

Maak een back-up voordat je updates uitvoert, containers opnieuw opbouwt, paden wijzigt, de gateway opnieuw configureert of naar een andere server migreert. Plan bij actief gebruik regelmatig back-ups in, afgestemd op hoe vaak vaardigheden, instellingen, gegenereerde bestanden of sessies veranderen. Een back-up is pas betrouwbaar als je hebt bevestigd dat je de bestanden kunt terugvinden en herstellen.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.