Krótka odpowiedź
Aby uruchomić Hermes Agent na serwerze domowym bez utraty danych, nie polegaj na wewnętrznym systemie plików kontenera jako jedynym miejscu przechowywania konfiguracji, umiejętności, logów, wygenerowanych plików ani ustawień bramy. Najpierw przygotuj trwały folder na hoście lub wolumen Dockera, podłącz go do ścieżki kontenera faktycznie używanej przez aplikację, sprawdź właściciela plików i upewnij się, że dane nadal istnieją po ponownym uruchomieniu lub zmianie konfiguracji. Ten artykuł dotyczy częstego problemu, w którym kontener nie może znaleźć folderu z powodu problemów z podłączeniem wolumenu, uprawnieniami lub mapowaniem ścieżki.
Najbezpieczniejszy sposób postępowania dla początkujących:
- Ustal, które dane Hermes Agent muszą zostać zachowane.
- Wybierz dedykowany folder na hoście lub wolumen zarządzany przez Dockera.
- Podłącz ten magazyn do właściwej ścieżki w kontenerze.
- Potwierdź, że użytkownik aplikacji może w tym miejscu zapisywać dane.
- Zrób kopię zapasową ważnej konfiguracji przed aktualizacją lub przebudową.
- Uruchom ponownie i sprawdź, czy konfiguracja, logi, wygenerowane pliki oraz ustawienia bramy są nadal dostępne.
Uruchomiony kontener nie oznacza automatycznie, że Twoje dane są bezpieczne. Dane są bezpieczne tylko wtedy, gdy są przechowywane w trwałej lokalizacji, można w nich zapisywać jako właściwy użytkownik, są archiwizowane w razie potrzeby, a po ponownym uruchomieniu ich obecność została potwierdzona.
Dlaczego dane Hermes Agent mogą zniknąć w konfiguracji kontenerowej
Aplikacje w kontenerach często łatwo uruchomić i zastąpić. Przydaje się to podczas aktualizacji, testów i odzyskiwania danych, ale oznacza też, że wszystko, co jest przechowywane wyłącznie w usuwalnej warstwie kontenera, może zostać utracone po jego usunięciu, ponownym utworzeniu lub przebudowaniu.
W przypadku hostowanego samodzielnie agenta AI może to dotyczyć nie tylko podstawowych ustawień. W zależności od sposobu korzystania z agenta możesz potrzebować konfiguracji modelu, umiejętności, wygenerowanych plików, logów, ustawień bramy komunikacyjnej i innych danych aplikacji.
Ponowne uruchamianie kontenerów a trwałe dane aplikacji
Zwykłe ponowne uruchomienie kontenera nie zawsze usuwa dane. Jeśli są przechowywane w trwałym wolumenie lub prawidłowo podłączonym folderze hosta, powinny pozostać dostępne po ponownym uruchomieniu.
Ryzyko pojawia się, gdy ważne pliki znajdują się wyłącznie w zapisywalnej warstwie kontenera. Nie jest ona tym samym co zaplanowana lokalizacja trwałego przechowywania danych. Jeśli ponownie utworzysz kontener bez zachowania lub ponownego podłączenia właściwej ścieżki, aplikacja może uruchomić się z pustym stanem albo nie odnaleźć wcześniejszych plików.
Dlaczego usunięcie lub ponowne utworzenie kontenera może spowodować utratę niezapisanych danych
Usunięcie lub ponowne utworzenie kontenera to nie to samo co jego ponowne uruchomienie. Ponownie utworzony kontener może korzystać z nowego wewnętrznego systemu plików, nowych zmiennych środowiskowych lub innego mapowania podłączeń.
Jeśli ustawienia Hermes Agent, umiejętności, logi lub wygenerowane pliki nigdy nie były zapisywane w trwałym folderze na hoście ani wolumenie, mogą nie zostać przeniesione do nowego kontenera. Dlatego zarówno „aplikacja działała wczoraj”, jak i „aplikacja zresetowała się po aktualizacji” mogą być prawdą.
Bezpieczna praktyka to traktowanie wymiany kontenera jako zdarzenia wiążącego się z ryzykiem utraty danych, chyba że masz pewność, gdzie przechowywane są dane aplikacji.
Dlaczego ścieżki hosta i kontenera trzeba zaplanować z wyprzedzeniem
Ścieżka hosta wskazuje, gdzie dane znajdują się na serwerze domowym. Ścieżka kontenera wskazuje, gdzie aplikacja widzi te dane z wnętrza kontenera. Montowanie woluminu lub katalogu łączy te dwa światy.
Jeśli ścieżka na hoście jest prawidłowa, ale została zamontowana pod niewłaściwą ścieżką w kontenerze, aplikacja może zachowywać się tak, jakby folder nie istniał. Jeśli ścieżka w kontenerze jest prawidłowa, ale ścieżka na hoście jest tymczasowa, aplikacja może zapisywać dane w niezamierzonym miejscu.
Zaplanuj mapowanie przed uruchomieniem aplikacji, a nie dopiero po utracie danych.
Jakie dane należy zabezpieczyć przed uruchomieniem Hermes Agent?
Zanim zmienisz kontener, zaktualizujesz obraz lub ponownie skonfigurujesz bramę, sporządź listę danych, których odtworzenie byłoby trudne. Nie każdy plik wymaga takiej samej ochrony, ale warto wiedzieć, które pliki mają kluczowe znaczenie.
Przydatna zasada: zabezpieczaj wszystko, co przechowuje tożsamość, dostęp, konfigurację, wyuczony przepływ pracy lub dane wyjściowe, których nie da się łatwo odtworzyć.
Konfiguracja agenta i ustawienia dostawcy modelu
Ustawienia modelu zwykle obejmują wybór dostawcy, wartości punktów końcowych, nazwy modeli, opcje związane z kontekstem oraz dostęp do API. Jeśli te ustawienia zostaną utracone, agent może się uruchomić, ale nie odpowiadać poprawnie.
Przechowuj konfigurację modelu w trwałej ścieżce danych aplikacji, a nie w tymczasowej sesji powłoki. Jeśli konfiguracja jest przekazywana przez zmienne środowiskowe, zachowaj bezpieczną kopię pliku compose, pliku env lub notatek wdrożeniowych.
Zabezpiecz również wszelkie ustawienia określające, jak agent korzysta z narzędzi terminalowych lub bram komunikacyjnych.
Pamięć aplikacji, sesje, umiejętności i stan środowiska uruchomieniowego
Dane Hermes Agent mogą obejmować więcej niż jeden plik konfiguracyjny. Struktura danych umiejętności Hermes wyjaśnia, że umiejętności znajdują się w ~/.hermes/skills/, który jest głównym źródłem prawdy dla umiejętności dołączonych do pakietu, zainstalowanych z hubu i utworzonych przez agenta. Opisuje też powiązany stan, taki jak manifesty pakietów, pakiety umiejętności, konfiguracja hub tap, oczekujące zapisy umiejętności i ustawienia konfiguracji.
Ma to znaczenie, ponieważ umiejętności utworzone przez agenta mogą stać się wielokrotnego użytku pamięcią proceduralną. Jeśli zamontujesz niewłaściwą ścieżkę, możesz utracić nie tylko ustawienia, ale także przepływy pracy poznane przez agenta lub zainstalowane umiejętności.
Traktuj umiejętności, pakiety, oczekujące zapisy i stan związany z profilem jako trwałe dane agenta.
Pobrane pliki, wygenerowane pliki, logi i dane wyjściowe narzędzi
Łatwo przeoczyć wygenerowane pliki. Podczas normalnego użytkowania agent może tworzyć plany, skrypty, raporty, zrzuty ekranu, logi lub pobrane pliki.
Pliki mogą być zapisane w aktywnym obszarze roboczym, katalogu roboczym backendu, katalogu domowym aplikacji lub zamontowanej ścieżce wyjściowej. Jeśli ta lokalizacja znajduje się wyłącznie wewnątrz kontenera, pliki mogą zniknąć po jego usunięciu.
W praktyce zdecyduj, gdzie wygenerowane pliki mają się pojawiać na serwerze hosta, i sprawdź, czy kontener zapisuje je w tej lokalizacji.
Klucze API, tokeny botów i zmienne środowiskowe
Sekrety nie są zwykłymi danymi aplikacji. Klucze API, tokeny botów, hasła do panelu i zmienne środowiskowe wymagają zarówno trwałego przechowywania, jak i ochrony.
Nie zapisuj sekretów w przypadkowych folderach z wygenerowanymi plikami ani w ogólnodostępnych katalogach współdzielonych. Przechowuj je w kontrolowanej lokalizacji konfiguracji z ograniczonym dostępem.
Dobrze skonfigurowana obsługa sekretów powinna zapewniać odpowiedzi na pytania:
- gdzie przechowywany jest sekret;
- który użytkownik może go odczytać;
- czy jest uwzględniona w kopiach zapasowych;
- czy kopia zapasowa jest zaszyfrowana lub chroniona kontrolą dostępu;
- jak można zmienić sekret, jeśli zostanie ujawniony.
Ścieżka hosta a ścieżka kontenera a montowanie woluminów
To kluczowe pojęcie stojące za większością problemów typu „kontener nie może znaleźć folderu” i „dane zniknęły po ponownym uruchomieniu”. Kontener widzi tylko to, co znajduje się w jego własnym systemie plików lub zostało do niego podmontowane.
Użyj Mapy przetrwania danych agenta, aby uporządkować konfigurację przed rozwiązywaniem problemów.
| Moduł struktury | Kluczowe pytanie | Co pomaga ustalić | Konfiguracja / rozwiązywanie problemów |
|---|---|---|---|
| Spis danych | Jakie dane muszą przetrwać ponowne uruchomienie lub utworzenie kontenera? | Które konfiguracje, umiejętności, logi, pobrane pliki, tokeny i wygenerowane pliki wymagają ochrony | Zapobiega traktowaniu ważnych danych agenta jako stanu tymczasowego |
| Ścieżka trwałego przechowywania | Gdzie na hoście powinny znajdować się dane trwałe? | Czy użyć dedykowanego folderu na hoście, woluminu Dockera czy bind mounta | Zapobiega resetowaniu danych po ponownym utworzeniu kontenera |
| Mapowanie montowania | Czy ścieżka hosta jest prawidłowo mapowana na ścieżkę kontenera? | Czy aplikacja rzeczywiście widzi wskazany folder | Pomaga diagnozować błędy związane z brakiem folderu i nieprawidłową ścieżką docelową |
| Zakres uprawnień | Który użytkownik jest właścicielem podmontowanych danych i który użytkownik je zapisuje? | Czy właścicielem plików jest użytkownik hosta, kontenera, aplikacji czy root | Pomaga rozwiązać problem odmowy dostępu bez przypisywania własności wszystkich plików użytkownikowi root |
| Zakres kopii zapasowej | Co należy uwzględnić w kopii zapasowej przed aktualizacją lub zmianą konfiguracji? | Które dane są krytyczne, a które tymczasowe | Zapobiega utracie konfiguracji, umiejętności, sesji, tokenów i ustawień bramy |
| Weryfikacja po ponownym uruchomieniu | Czy dane nadal istnieją po ponownym uruchomieniu lub aktualizacji? | Czy konfiguracja jest rzeczywiście trwała | Pozwala zmienić „działa” w powtarzalny test bezpieczeństwa |
Co przechowuje serwer hosta
Serwer hosta przechowuje rzeczywiste foldery, dyski i lokalizacje pamięci masowej zarządzanej przez Dockera. Jeśli używasz bind mounta, wybierasz konkretny folder na hoście. Jeśli używasz nazwanego woluminu Dockera, Docker wybiera lokalizację przechowywania i nią zarządza.
To rozróżnienie ma znaczenie, ponieważ widoczność danych na hoście wpływa na tworzenie kopii zapasowych i migrację. Początkującemu może być łatwiej znaleźć i skopiować folder podmontowany przez bind mount. Nazwany wolumin może być wygodniejszy w przypadku danych aplikacji zarządzanych przez Dockera, ale nadal trzeba wiedzieć, jak go sprawdzić lub wykonać jego kopię zapasową.
Wybierz sposób przechowywania danych w zależności od tego, czy potrzebujesz czytelnych folderów na hoście, trwałego przechowywania danych aplikacji zarządzanego przez Dockera, czy kontrolowanej ścieżki tworzenia kopii zapasowych.
Co widzi kontener
Kontener widzi własny wewnętrzny system plików i wszystkie zamontowane ścieżki. Nie widzi automatycznie każdego folderu na Twoim serwerze domowym.
Instrukcja montowania bind mount w Dockerze pokazuje, jak katalog hosta może być widoczny w kontenerze pod określoną ścieżką docelową oraz jak zmiany w plikach mogą być odzwierciedlane między hostem a kontenerem, jeśli montowanie jest prawidłowe.
Na tym polega istota: aplikacja nie ma dostępu do pliku na hoście, dopóki nie zostanie on zamontowany w używanej przez nią ścieżce.
Jak montowanie woluminów zapewnia trwałość danych aplikacji
Trwały punkt montowania zapewnia aplikacji stabilne miejsce do zapisywania danych, które przetrwa dłużej niż pojedynczy kontener. W przypadku danych aplikacji często decyduje to o tym, czy przetrwają ponowne uruchomienie, czy tylko działanie kontenera.
Punkt montowania musi odpowiadać oczekiwanej przez aplikację ścieżce danych. Jeśli aplikacja zapisuje dane w jednym folderze wewnętrznym, a Ty montujesz inny, dane mogą nadal trafiać do tymczasowego obszaru pamięci.
Dobra konfiguracja trwałego przechowywania danych powinna określać:
- folder na hoście lub nazwany wolumin;
- docelową ścieżkę w kontenerze;
- czy montowanie ma być z prawem do odczytu i zapisu, czy tylko do odczytu;
- które dane aplikacji powinny się tam znaleźć;
- jak będzie tworzona kopia zapasowa ścieżki.
Dlaczego nieprawidłowe mapowanie ścieżek powoduje błędy brakującego folderu
Nieprawidłowe mapowanie ścieżek często wygląda jak problem z brakującym folderem. Folder może istnieć na hoście, ale kontener go nie widzi. Albo kontener może mieć folder w oczekiwanej lokalizacji, ale nie jest on połączony z folderem na hoście, który chcesz udostępnić.
Typowe objawy to:
- aplikacja informuje, że folder nie istnieje;
- wygenerowane pliki pojawiają się w kontenerze, ale nie na hoście;
- logi znikają po ponownym utworzeniu kontenera;
- konfiguracja resetuje się po aktualizacji;
- edytujesz folder na hoście, ale aplikacja nadal używa starych ustawień;
- skrypty kopii zapasowych działają, ale nie obejmują rzeczywistych danych aplikacji.
Gdy tak się stanie, sprawdź jednocześnie ścieżkę na hoście i ścieżkę w kontenerze. Nie sprawdzaj tylko jednej z nich.
Jak uruchomić Hermes Agent bez utraty danych
Celem nie jest samo uruchomienie Hermes Agent. Chodzi o to, by dane, na których Ci zależy, przetrwały ponowne uruchomienie, aktualizację, ponowne utworzenie kontenera i zmianę konfiguracji.
Krok 1: Wybierz dedykowany folder danych na hoście
Wybierz folder danych na hoście przed uruchomieniem lub ponownym utworzeniem kontenera. Powinien być łatwy do rozpoznania i uwzględnienia w kopii zapasowej, a także oddzielony od niezwiązanych z nim plików osobistych.
Dedykowany folder zmniejsza ryzyko, ponieważ możesz sprawdzić, co należy do aplikacji. Pozwala też uniknąć montowania całego katalogu domowego lub innych wrażliwych folderów w kontenerze.
Praktyczny folder danych na hoście powinien być:
- przeznaczony dla konkretnej aplikacji;
- poza tymczasowymi ścieżkami pobierania;
- uwzględniony w planie tworzenia kopii zapasowych;
- nieudostępniany szeroko niepowiązanym usługom;
- zapisywalny wyłącznie przez użytkowników lub usługi, które potrzebują dostępu.
Krok 2: Podmontuj folder danych w kontenerze
Podmontuj folder danych z hosta pod ścieżką w kontenerze oczekiwaną przez aplikację. To właśnie na tym etapie można zapobiec wielu przypadkom utraty danych.
W przypadku podmontowania wiązanego ścieżkę na hoście wybierasz samodzielnie, a ścieżka docelowa wskazuje miejsce, w którym folder jest widoczny wewnątrz kontenera. W przypadku nazwanego woluminu lokalizacją po stronie hosta zarządza Docker.
Nie zakładaj, że aplikacja automatycznie użyje podmontowanego folderu. Upewnij się, że docelowa ścieżka podmontowania odpowiada rzeczywistej ścieżce danych aplikacji.
Krok 3: Potwierdź, że kontener używa oczekiwanej ścieżki danych aplikacji
Po podmontowaniu sprawdź ścieżkę z wnętrza kontenera. Folder może istnieć na hoście, a mimo to być niewidoczny dla aplikacji, jeśli nie został poprawnie podmontowany.
Najprostszy test polega na utworzeniu lub znalezieniu nieszkodliwego pliku testowego po jednej stronie i sprawdzeniu, czy pojawia się po drugiej. Następnie sprawdź, czy aplikacja zapisuje prawdziwe pliki konfiguracyjne, dzienniki lub wygenerowane pliki w tej samej trwałej lokalizacji.
Ten krok jest szczególnie ważny przed aktualizacją lub migracją.
Krok 4: Sprawdź właściciela plików i uprawnienia do zapisu
Nawet poprawne podmontowanie może nie działać, jeśli aplikacja nie może zapisywać w tym miejscu. Błędy uprawnień często występują, gdy pliki są tworzone przez użytkownika root, a aplikacja później działa jako inny użytkownik.
Sprawdź właściciela przed szeroką zmianą uprawnień. Zwykle należy umożliwić zamierzonemu użytkownikowi aplikacji odczyt i zapis w konkretnym folderze danych aplikacji, zamiast dawać każdemu procesowi pełną kontrolę nad rozległymi katalogami hosta.
Jeśli pojawi się komunikat o odmowie dostępu, ustal:
- podmontowaną ścieżkę na hoście;
- docelową ścieżkę w kontenerze;
- użytkownika uruchamiającego aplikację;
- właściciela pliku;
- czy podmontowanie jest tylko do odczytu;
- czy ścieżka kopii zapasowej lub eksportu również umożliwia zapis.
Krok 5: Przechowuj sekrety i pliki konfiguracyjne poza nietrwałymi ścieżkami
Sekrety i pliki konfiguracyjne nie powinny znajdować się wyłącznie w folderach tymczasowych, katalogach z wygenerowanymi plikami ani przypadkowej historii powłoki. Jeśli używasz zmiennych środowiskowych, przechowuj plik wdrożeniowy lub plik env w kontrolowanej, trwałej lokalizacji.
Unikaj mieszania sekretów z dziennikami lub wygenerowanymi artefaktami. Dzienniki mogą być udostępniane w celu rozwiązywania problemów, natomiast sekretów nie należy beztrosko udostępniać.
Jeśli tworzysz kopie zapasowe sekretów, zabezpiecz je. Kopia zapasowa ujawniająca klucze API lub tokeny botów stwarza inny rodzaj ryzyka.
Krok 6: Uruchom ponownie kontener i sprawdź, czy dane nadal istnieją
Po konfiguracji uruchom ponownie kontener i sprawdź, czy ważne dane nadal są dostępne. To najbardziej praktyczny test trwałości danych.
Nie poprzestawaj na tym, że „kontener się uruchamia”. Sprawdź, czy:
- ustawienia modelu nadal istnieją;
- umiejętności lub stan aplikacji nadal są widoczne;
- dzienniki nadal są zapisywane w oczekiwanym miejscu;
- wygenerowane pliki pojawiają się na hoście;
- ustawienia bramy lub bota nadal działają;
- można znaleźć pliki kopii zapasowej.
Konfiguracja, która przechodzi test po ponownym uruchomieniu, jest znacznie bezpieczniejsza niż taka, która przeszła tylko pierwszą instalację.
Uprawnienia, kopie zapasowe i granice bezpieczeństwa
Bezpieczeństwo danych zależy od trzech granic: tego, kto może zapisywać dane, co obejmuje kopia zapasowa oraz do czego agent ma dostęp. Granice te są szczególnie ważne w przypadku agentów hostowanych samodzielnie, ponieważ mogą one tworzyć pliki, modyfikować przepływy pracy lub korzystać z narzędzi.
Dlaczego uprawnienia użytkownika kontenera są ważne
Uprawnienia użytkownika kontenera decydują o tym, czy aplikacja może odczytywać i zapisywać swoje dane. Jeśli aplikacja działa jako jeden użytkownik, a zamontowany folder należy do innego, operacje zapisu mogą się nie powieść.
Dlatego polecenie konfiguracyjne uruchomione jako root może spowodować późniejsze problemy. Root może utworzyć pliki, ale zwykły użytkownik aplikacji może nie mieć możliwości ich modyfikacji.
Napraw uprawnienia na poziomie folderu danych aplikacji. Unikaj szerokich zmian uprawnień, które udostępniają niezwiązane z aplikacją pliki hosta.
Dlaczego nie należy uruchamiać wszystkiego jako root
Konto root może omijać wiele ograniczeń, ale nie oznacza to, że jest bezpiecznym ustawieniem domyślnym. Uruchamianie wszystkiego jako root może tworzyć pliki należące do roota, ukrywać problemy z uprawnieniami i dawać aplikacji większy dostęp, niż potrzebuje.
W większości procesów z użyciem aplikacji hostowanych samodzielnie konto root powinno służyć wyłącznie do konkretnych czynności administracyjnych. W miarę możliwości zwykłą konfigurację aplikacji należy wykonywać jako użytkownik aplikacji lub kontenera.
Bezpieczniejszym rozwiązaniem jest zasada minimalnych uprawnień: przyznaj aplikacji dostęp do zapisu tylko w folderach, których potrzebuje.
Kiedy używać montowań tylko do odczytu lub folderów z ograniczonym dostępem
Używaj montowań tylko do odczytu, gdy agent ma przeglądać pliki, ale nie powinien ich modyfikować. Używaj folderów z ograniczonym dostępem do zapisu, gdy agent ma tworzyć pliki, ale nie powinien mieć dostępu do rozległych katalogów osobistych ani systemowych.
Jest to szczególnie przydatne, gdy chcesz, aby agent generował raporty, plany lub skrypty, nie dając mu dostępu do zapisu we wszystkich plikach serwera.
Projekt z ograniczonym dostępem do folderów zmniejsza skutki pomyłek. Ułatwia też tworzenie kopii zapasowych, bo wiesz, który folder zawiera stan aplikacji, a który wygenerowane pliki.
Jak wykonać kopię zapasową danych agenta przed aktualizacją lub ponowną konfiguracją
Przed zmianą obrazów kontenerów, ścieżek montowania, ustawień bramy lub profili wykonaj kopię zapasową ważnych danych aplikacji. Kopia zapasowa jest przydatna tylko wtedy, gdy wiesz, co obejmuje i jak przywrócić z niej dane.
Dyskusja społeczności Dockera o odmowie dostępu podczas tworzenia kopii zapasowej woluminu pokazuje częsty problem zgłaszany przez użytkowników: ścieżka może istnieć, ale operacje tworzenia kopii zapasowej lub zapisu nadal mogą się nie powieść z powodu ograniczeń związanych z uprawnieniami, właścicielem, etykietami lub montowaniem.
Potraktuj to jako przypomnienie, by testować kopie zapasowe, a nie tylko je tworzyć. Plan tworzenia kopii zapasowych powinien obejmować zarówno ich tworzenie, jak i weryfikację możliwości przywrócenia danych.
Typowe problemy i sposoby ich rozwiązania
Gdy brakuje danych Hermes Agent, nie reinstaluj od razu aplikacji. Najpierw ustal, która warstwa zawiodła: spis danych, ścieżka trwałego przechowywania, mapowanie montowania, granica uprawnień, zakres kopii zapasowej czy walidacja po ponownym uruchomieniu.
Kontener nie może znaleźć zamontowanego folderu
Zwykle oznacza to, że ścieżka istnieje w jednej warstwie, ale nie w drugiej. Folder hosta może nie być zamontowany, docelowa ścieżka kontenera może być nieprawidłowa albo aplikacja może szukać w innym miejscu.
Sprawdź w następującej kolejności:
- Sprawdź, czy folder istnieje na hoście.
- Sprawdź, czy kontener ma zamontowany wolumin.
- Sprawdź ścieżkę docelową wewnątrz kontenera.
- Sprawdź, czy aplikacja jest skonfigurowana do używania tej ścieżki docelowej.
- Sprawdź, czy użytkownik aplikacji może odczytywać folder.
- Sprawdź, czy montowanie zostało odtworzone po zmianie ustawień Compose lub uruchamiania.
Nie naprawiaj tego, tworząc przypadkowe foldery w kontenerze. Błąd może wtedy chwilowo zniknąć, ale dane pozostaną w nietrwałej pamięci.
Dane aplikacji resetują się po ponownym uruchomieniu
Jeśli dane resetują się po ponownym uruchomieniu, aplikacja może zapisywać je w wewnętrznym systemie plików kontenera zamiast w trwałej lokalizacji. Może też używać innego profilu, zmiennej środowiskowej lub katalogu danych niż oczekiwano.
Sprawdź, czy ścieżka danych przed ponownym uruchomieniem i po nim jest taka sama. Następnie sprawdź, czy folder znajduje się na zamontowanym woluminie, czy tylko w warstwie kontenera.
Jeśli kontener aplikacji został utworzony ponownie, sprawdź, czy do nowego kontenera podłączono ten sam wolumin lub montowanie wiążące.
Błędy odmowy dostępu w katalogu danych
Błąd odmowy dostępu oznacza, że aplikacja widzi ścieżkę, ale nie może wykonać wymaganej operacji. Przyczyną mogą być uprawnienia właściciela, ustawienia montowania tylko do odczytu, etykiety systemu plików albo niezgodność między użytkownikiem hosta i kontenera.
Zacznij od najprostszej kontroli: czy użytkownik aplikacji może utworzyć nieszkodliwy plik testowy w katalogu danych? Jeśli nie, sprawdź właściciela i tryb uprawnień tej konkretnej ścieżki.
Nie rozwiązuj tego problemu, przyznając szerokie uprawnienia do zapisu w całym katalogu hosta. Popraw ścieżkę danych aplikacji i ustaw właściwego użytkownika aplikacji.
Wygenerowane pliki są zapisywane tylko w kontenerze
Jeśli generowane pliki znikają po przebudowie, prawdopodobnie zostały zapisane w kontenerze zamiast w zamontowanej ścieżce hosta. Często dzieje się tak, gdy katalog roboczy lub katalog wyjściowy aplikacji nie jest mapowany.
Zdecyduj, gdzie mają trafiać generowane pliki. Następnie zamontuj ten folder wyjściowy lub skonfiguruj aplikację tak, aby zapisywała pliki w istniejącej trwałej lokalizacji.
Po zmianie ścieżki utwórz nieszkodliwy plik testowy i sprawdź, czy pojawi się na hoście.
Ustawienia bota lub bramy znikają po zmianie konfiguracji
Ustawienia bramy mogą zniknąć, jeśli konfiguracja jest przechowywana w nietrwałej ścieżce lub jeśli po ponownym uruchomieniu aplikacja działa w innym profilu. To samo może się zdarzyć, gdy zmienna środowiskowa zostanie zmieniona w jednym miejscu, ale działający kontener używa innej wartości.
Sprawdź, czy konfiguracja bramy, odwołanie do tokenu bota, lista dozwolonych adresów i ustawienia pulpitu nawigacyjnego są zapisane w oczekiwanej trwałej lokalizacji. Następnie uruchom ponownie bramę i sprawdź, czy ustawienia nadal są aktywne.
Jeśli bot działa przed ponownym uruchomieniem, ale po nim już nie, najpierw sprawdź trwałość danych i konfigurację środowiska, zanim zmienisz token.
Jak sprawdzić, czy dane Hermes Agent są bezpieczne
Bezpieczna konfiguracja powinna przejść testy ponownego uruchomienia, zapisu, kopii zapasowej i dostępu. Testy te nie muszą być skomplikowane, ale należy je powtarzać po wprowadzeniu większych zmian.
Konfiguracja zachowuje się po ponownym uruchomieniu
Zmień nieszkodliwe ustawienie, uruchom ponownie kontener i sprawdź, czy ustawienie się zachowało. Potwierdzi to, że aplikacja zapisuje dane w pamięci trwałej.
Jeśli ustawienie znika, nie dodawaj kolejnych elementów konfiguracji. Najpierw napraw ścieżkę danych.
Logi i wygenerowane pliki pojawiają się w oczekiwanym folderze na hoście
Logi i wygenerowane pliki powinny pojawiać się na hoście w oczekiwanym miejscu. Jeśli znajdują się tylko w kontenerze, mogą zostać utracone podczas jego ponownego tworzenia.
Sprawdź obie strony punktu montowania. Pliki istotne dla hosta i kontenera powinny być zgodne.
Agent może zapisywać dane aplikacji bez błędów uprawnień
Agent powinien móc zapisywać dane w folderze danych aplikacji jako wyznaczony użytkownik. Pomyślny test zapisu jest bardziej miarodajny niż samo potwierdzenie, że folder istnieje.
Po ponownym uruchomieniu zwracaj uwagę na błędy uprawnień w logach. Niektóre problemy z uprawnieniami pojawiają się dopiero wtedy, gdy agent próbuje zaktualizować konfigurację, zapisać umiejętność, zapisać wygenerowany plik lub zaktualizować stan bramki.
Pliki kopii zapasowej można znaleźć i przywrócić
Kopia zapasowa nie jest kompletna, dopóki nie można jej znaleźć i przywrócić w lokalizacji testowej. Co najmniej sprawdź, czy zawiera dane, które miała chronić.
W przypadku ważnych konfiguracji przywróć kopię zapasową do osobnego folderu lub instancji testowej, zanim zaczniesz na niej polegać. Dzięki temu problemy z przywracaniem nie wyjdą na jaw dopiero po utracie danych.
Dostęp do panelu lub wiadomości nadal działa po ponownym uruchomieniu
Po ponownym uruchomieniu sprawdź, czy dostęp do panelu lub wiadomości nadal działa. Potwierdzi to, że dane trwałe, dane uwierzytelniające, ustawienia bramki i dostęp do sieci nadal są prawidłowo skonfigurowane.
Jeśli panel działa, ale wiadomości nie są wysyłane, sprawdź ustawienia bramki i dostęp do tokenu. Jeśli wiadomości są wysyłane, ale wygenerowane pliki znikają, sprawdź ścieżkę zapisu i punkty montowania.
Jak to działa w rzeczywistym środowisku serwera domowego
W przypadku rzeczywistej konfiguracji serwera domowego obowiązują te same zasady ochrony danych, nawet jeśli system oferuje przyjazny panel. Nadal trzeba wiedzieć, jakie dane muszą zostać zachowane, gdzie są przechowywane, jak kontener uzyskuje do nich dostęp, który użytkownik może je zapisywać oraz jak zweryfikować je po ponownym uruchomieniu.
Na przykład proces konfiguracji Hermes Agent w ZimaOS pokazuje ścieżkę dostosowaną do urządzenia, która obejmuje konfigurację dostawcy modelu, konfigurację bramki Telegram, wejście do kontenera Hermes, aktywację środowiska aplikacji, sprawdzenie panelu WWW oraz rozwiązywanie problemów z uprawnieniami lub odpowiedziami bota.
Dla użytkowników korzystających z aplikacji Dockera, procesów agentów i usług lokalnych na kompaktowym, stale włączonym urządzeniu serwer domowy ZimaBoard 2 to przykład lekkiego środowiska serwera domowego, w którym należy wspólnie zaplanować trwałe foldery, ścieżki kontenerów, uprawnienia i rozbudowę pamięci masowej. To nie jedyna możliwa konfiguracja, ale odpowiada sposobowi korzystania z samodzielnie hostowanych aplikacji opisanemu w tym poradniku.
Ogólna zasada jest uniwersalna: zanim powierzysz kontenerowemu agentowi ważne zadania, upewnij się, że jego istotne dane przetrwają dłużej niż kontener uruchomiony w danej chwili.
Najczęściej zadawane pytania
Dlaczego dane Hermes Agent zniknęły po ponownym uruchomieniu kontenera?
Zwykłe ponowne uruchomienie nie powinno usuwać trwałych danych, ale może się wydawać, że aplikacja została zresetowana, jeśli zapisywała dane w nietrwałej ścieżce kontenera. Danych może też brakować, jeśli kontener został utworzony ponownie bez tego samego woluminu lub montowania wiązanego. Zanim zmienisz kolejne ustawienia, sprawdź ścieżkę hosta, ścieżkę kontenera i rzeczywistą ścieżkę danych aplikacji.
Czym różni się wolumin Dockera od montowania wiązanego?
Woluminem zarządza Docker, a montowanie wiązane mapuje wybrany folder hosta do kontenera. Wolumin często sprawdza się w przypadku danych zarządzanych przez aplikację, a montowanie wiązane ułatwia bezpośrednie znalezienie folderu na hoście. Najlepszy wybór zależy od tego, czy wolisz pamięć masową zarządzaną przez Dockera, czy widoczny folder hosta, który można uwzględnić w kopii zapasowej i przeglądać.
Gdzie przechowywać dane aplikacji Hermes Agent na domowym serwerze?
Użyj dedykowanego, trwałego folderu lub woluminu Dockera zamiast tymczasowej ścieżki kontenera. Lokalizacja powinna być łatwa do uwzględnienia w kopii zapasowej, ograniczona do potrzeb aplikacji i niezawierająca niezwiązanych z nią wrażliwych plików. Najważniejsze, by oczekiwana przez aplikację ścieżka kontenera faktycznie wskazywała na tę trwałą pamięć masową.
Dlaczego kontener informuje, że folder nie istnieje?
Folder może istnieć na hoście, ale nie wewnątrz kontenera. Zwykle oznacza to, że nie utworzono montowania, ścieżka źródłowa lub docelowa jest nieprawidłowa albo aplikacja szuka folderu w innej ścieżce kontenera. Sprawdź zarówno stronę hosta, jak i kontenera, zamiast bez zastanowienia tworzyć nowy folder.
Czy uruchamiać Hermes Agent jako root, aby uniknąć błędów uprawnień?
Uruchomienie z uprawnieniami roota może ukryć bezpośrednią przyczynę błędu, ale może też utworzyć pliki należące do roota i zwiększyć ryzyko. Bezpieczniej jest zapewnić użytkownikowi aplikacji wymagany dostęp do odczytu i zapisu wyłącznie w niezbędnej ścieżce danych aplikacji. Używaj roota tylko do konkretnych działań administracyjnych lub naprawczych, gdy rozumiesz wprowadzane zmiany.
Jak często należy tworzyć kopie zapasowe danych Hermes Agent?
Twórz kopie zapasowe przed aktualizacjami, ponownym tworzeniem kontenerów, zmianami ścieżek, rekonfiguracją bramy lub migracją na inny serwer. Przy aktywnym użytkowaniu zaplanuj regularne kopie zapasowe, dostosowując ich częstotliwość do tego, jak często zmieniają się umiejętności, ustawienia, wygenerowane pliki lub sesje. Kopia zapasowa nie jest wiarygodna, dopóki nie sprawdzisz, czy można znaleźć i przywrócić pliki.
Wsparcie i porady
Więcej do przeczytania

Co sprawdzić przed załadowaniem modelu społecznościowego w Transformers
Użyj aktualizacji piaskownicy Jinja dla Transformers, aby sprawdzić pochodzenie modelu, szablony czatu, zdalny kod, serializowane wagi i pierwsze uruchomienia w izolowanym środowisku.

Uruchom Mirage lokalnie: OCR i wykrywanie obiektów na podstawie jednego obrazu
Przetestuj niewielki lokalny model wizyjny Cactus Compute, zweryfikuj OCR i ekstrakcję obiektów na rzeczywistych danych wejściowych oraz poznaj ograniczenia związane z pamięcią, językiem i...

Jak zaplanować agenta programistycznego w Open WebUI na serwerze domowym
Skonfiguruj w Open WebUI automatyzację agenta programistycznego działającego wyłącznie w trybie raportowania, wybierz jego terminal i obszar roboczy, a następnie sprawdź uprawnienia, logi i...



