データを失わずにホームサーバーでHermes Agentを実行する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

簡単な回答

データを失わずにホームサーバーでHermes Agentを動かすには、設定、スキル、ログ、生成ファイル、ゲートウェイの設定の保存先として、コンテナの内部ファイルシステムだけに頼らないでください。まず永続化するホストフォルダーまたはDockerボリュームを用意し、アプリが実際に使用するコンテナパスにマウントして、ファイルの所有者を確認します。その後、再起動や設定変更の後もデータが残っていることを確かめてください。この記事では、ボリュームのマウント、権限、パスの割り当てに問題があり、コンテナがフォルダーを見つけられないという、よくある障害パターンを取り上げます。

初心者にとって最も安全な手順は次のとおりです。

  1. 保持する必要があるHermes Agentのデータを特定します。
  2. 専用のホストフォルダーまたはDocker管理のボリュームを選びます。
  3. そのストレージを正しいコンテナパスに割り当てます。
  4. アプリのユーザーがその保存先に書き込めることを確認します。
  5. 更新や再ビルドの前に、重要な設定をバックアップします。
  6. 再起動後も設定、ログ、生成ファイル、ゲートウェイの設定が残っていることを確認します。

コンテナが稼働しているからといって、データが自動的に安全になるわけではありません。データを安全に保つには、永続化される場所に保存し、適切なユーザーが書き込めるようにし、必要に応じてバックアップを取り、再起動後に検証する必要があります。

コンテナ環境でHermes Agentのデータが消える理由

コンテナ化されたアプリは、起動も置き換えも簡単なことがよくあります。これは更新、テスト、復旧に便利ですが、使い捨てのコンテナレイヤー内だけに保存されたデータは、コンテナの削除、再作成、再ビルド時に失われる可能性があるということでもあります。

セルフホスト型AIエージェントでは、基本設定以外にも影響が及ぶ場合があります。エージェントの使い方によっては、モデルの設定、スキル、生成ファイル、ログ、メッセージングゲートウェイの設定、その他のアプリの状態も重要です。

コンテナの再起動とアプリデータの永続化

通常のコンテナ再起動で、必ずデータが消えるわけではありません。永続ボリュームまたは正しく割り当てられたホストフォルダーにデータが保存されていれば、再起動後も利用できるはずです。

重要なファイルがコンテナの書き込み可能レイヤーにしかない場合、データ消失のリスクが生じます。このレイヤーは、あらかじめ用意した永続データの保存先とは異なります。適切なパスを保持または再マウントせずにコンテナを再作成すると、アプリが初期状態で起動したり、以前のファイルを見つけられなくなったりすることがあります。

コンテナを削除または再作成すると、保存されていない状態が失われることがある理由

コンテナの削除や再作成は、再起動とは異なります。再作成したコンテナでは、内部ファイルシステム、環境変数、マウントの割り当てが新しくなる場合があります。

Hermes Agentの設定、スキル、ログ、生成された出力が、永続化されるホストフォルダーやボリュームに一度も書き込まれていない場合、新しいコンテナには引き継がれないことがあります。だからこそ、「昨日までアプリが動いていた」と「更新後にアプリがリセットされた」は、どちらも起こり得ます。

安全のため、アプリのデータの保存場所を確認できていない場合は、コンテナの置き換えにはデータ消失のリスクがあるものと考えましょう。

ホストパスとコンテナパスを最初に計画すべき理由

ホストパスとは、ホームサーバー上でデータが保存されている場所です。コンテナパスとは、コンテナ内部からアプリがそのデータを認識する場所です。ボリュームマウントまたはバインドマウントによって、この2つがつながります。

ホストパスが正しくても、間違ったコンテナパスにマウントされていると、アプリはそのフォルダーが存在しないかのように動作する場合があります。コンテナパスが正しくても、ホストパスが一時的なものであれば、意図しない場所にデータが書き込まれる可能性があります。

データを失ってからではなく、アプリを起動する前にマッピングを計画してください。

Hermes Agentを実行する前に保護すべきデータとは?

コンテナの変更、イメージの更新、ゲートウェイの再設定を行う前に、再作成が困難なデータをリストアップしてください。すべてのファイルを同じように保護する必要はありませんが、どのファイルが重要なのか把握しておく必要があります。

役立つ目安として、ID、アクセス権、設定、学習したワークフロー、または簡単には再生成できない出力を保存しているものは、すべて保護してください。

エージェントの設定とモデルプロバイダーの設定

モデル設定には通常、プロバイダーの選択、エンドポイントの値、モデル名、コンテキスト関連のオプション、APIアクセスが含まれます。これらの設定が失われると、エージェントは起動しても正しく応答できなくなることがあります。

モデルの設定は、一時的なシェルセッションではなく、永続的なアプリデータのパスに保存してください。環境変数で設定を指定する場合は、composeファイル、envファイル、またはデプロイ手順の控えを安全に保管してください。

エージェントによるターミナルツールやメッセージングゲートウェイの使用方法を決める設定も保護してください。

アプリのメモリ、セッション、スキル、ランタイムの状態

Hermes Agentのデータには、複数の設定ファイルが含まれる場合があります。Hermesのスキルデータ構造では、スキルは~/.hermes/skills/に保存され、バンドル済み、Hubからインストールしたもの、エージェントが作成したものを含むスキルの主要な信頼できる情報源であると説明されています。また、バンドルのマニフェスト、スキルバンドル、Hub Tapの設定、保留中のスキル書き込み、設定など、関連する状態についても説明されています。

これは、エージェントが作成したスキルが再利用可能な手順記憶になることがあるため重要です。間違ったパスをマウントすると、設定だけでなく、エージェントが習得したワークフローやインストールしたスキルまで失う可能性があります。

スキル、バンドル、保留中の書き込み、プロフィール関連の状態は、永続的なエージェントデータとして扱ってください。

ダウンロード、生成ファイル、ログ、ツールの出力

生成されたファイルは見落としがちです。通常の使用中に、エージェントが計画書、スクリプト、レポート、スクリーンショット、ログ、ダウンロードしたファイルなどを作成することがあります。

これらのファイルは、アクティブなワークスペース、バックエンドの作業ディレクトリ、アプリのホームディレクトリ、またはマウントされた出力先に保存される場合があります。その場所がコンテナ内にしかない場合、コンテナを削除するとファイルが消えてしまう可能性があります。

実際に使う際は、生成ファイルをホストサーバー上のどこに保存するかを決め、コンテナがそこに書き込むことを確認してください。

APIキー、ボットトークン、環境変数

秘密情報は通常のアプリデータとは異なります。APIキー、ボットトークン、ダッシュボードのパスワード、環境変数には、永続性と保護の両方が必要です。

秘密情報を、無作為に生成された出力フォルダーや広く共有されたディレクトリに保存しないでください。アクセスを制限した管理下の設定パスに保管してください。

適切な秘密情報の取り扱いでは、次の点を確認できるようにします。

  • 秘密情報がどこに保存されているか。
  • どのユーザーが読み取れるか。
  • バックアップ対象に含まれているか。
  • バックアップが暗号化されているか、アクセス制御されているか。
  • 秘密情報が漏えいした場合のローテーション方法。

ホストパス、コンテナパス、ボリュームマウント

これは、「コンテナからフォルダーが見つからない」「再起動後にデータが消えた」といった問題の多くに関わる重要な概念です。コンテナから見えるのは、コンテナ自体のファイルシステム内にあるものか、コンテナにマウントされたものだけです。

トラブルシューティングの前に、セットアップを整理するためにエージェントデータの存続マップを使いましょう。

フレームワークのモジュール 重要な質問 判断に役立つこと セットアップ/トラブルシューティングの観点
データの棚卸し コンテナの再起動や再作成後も残すべきデータは何ですか? 保護が必要な設定、スキル、ログ、ダウンロード、トークン、生成ファイル 重要なエージェントデータを使い捨ての状態データとして扱うのを防ぐ
永続化パス 永続データはホストのどこに保存すべきですか? 専用のホストフォルダー、Dockerボリューム、バインドマウントのどれを使うか コンテナの再作成後にデータがリセットされるのを防ぐ
マウントのマッピング ホストパスはコンテナパスに正しくマッピングされていますか? アプリから目的のフォルダーが実際に見えるか フォルダーが見つからない、保存先のパスが違うといったエラーの診断に役立つ
権限の範囲 マウントしたデータの所有者と、そこに書き込むユーザーは誰ですか? ファイルの所有者がホストユーザー、コンテナユーザー、アプリユーザー、rootのいずれか すべてのファイルの所有者をrootにすることなく、権限拒否を解決する
バックアップの範囲 更新や再設定の前に何をバックアップすべきですか? どのデータが重要で、どのデータが一時的か 設定、スキル、セッション、トークン、ゲートウェイ設定の消失を防ぐ
再起動後の確認 再起動や更新の後もデータは残っていますか? セットアップが本当に永続化されているか 「動いている」を再現可能な安全確認に変える

ホストサーバーに保存されるもの

ホストサーバーには、実際のフォルダーやディスク、Dockerが管理するストレージの保存場所があります。バインドマウントを使う場合は、ホスト上の特定のフォルダーを自分で選びます。名前付きDockerボリュームを使う場合は、Dockerが保存場所を選択して管理します。

この違いは、ホストからの見え方がバックアップや移行に影響するため重要です。バインドマウントしたフォルダーは、初心者でも場所を見つけてコピーしやすい場合があります。名前付きボリュームは、Dockerで管理するアプリデータを整理して保存できますが、調査やバックアップの方法を把握しておく必要があります。

人が直接確認できるホストフォルダー、Dockerが管理するアプリの永続化領域、または管理されたバックアップ先のうち、必要に応じてストレージ方式を選んでください。

コンテナから見えるもの

コンテナから見えるのは、コンテナ独自の内部ファイルシステムとマウントされたパスです。ホームサーバー上のすべてのフォルダーが自動的に見えるわけではありません。

Dockerのバインドマウントの手順では、ホストディレクトリをコンテナ内の指定パスに表示する方法と、マウントが正しく設定されている場合にホストとコンテナ間でファイルの変更を反映する方法が説明されています。

基本はこうです。ホスト上のファイルがどこに存在していても、アプリが使うパスにマウントされていなければ、アプリからは認識されません。

ボリュームマウントでアプリデータを永続化する方法

永続マウントを使うと、単一コンテナのライフサイクルを超えて、アプリが安定した場所にデータを書き込めます。アプリデータの場合、これが「再起動後も保持」と「コンテナの存続期間中のみ」の違いになることがよくあります。

マウント先は、アプリが想定するデータパスと一致している必要があります。アプリが内部のあるフォルダーに書き込む一方で、別のフォルダーをマウントしていると、データが一時的なストレージに保存されることがあります。

適切な永続化設定では、次の項目を定義する必要があります。

  • ホストフォルダーまたは名前付きボリューム。
  • コンテナ内のマウント先パス。
  • マウントを読み書き可能にするか、読み取り専用にするか。
  • どのアプリデータを保存するか。
  • パスをバックアップする方法。

パスのマッピングミスでフォルダーが見つからないエラーが発生する理由

パスのマッピングが間違っていると、フォルダーが見つからない問題のように見えることがよくあります。ホスト上にはフォルダーが存在していても、コンテナからは見えない場合があります。あるいは、コンテナ内に想定したパスのフォルダーがあっても、意図したホストフォルダーに接続されていない場合があります。

よくある症状は次のとおりです。

  • アプリでフォルダーが存在しないと表示される。
  • 生成されたファイルがコンテナ内には表示されるが、ホスト側には表示されない。
  • コンテナを再構築するとログが消える。
  • アップデート後に設定がリセットされる。
  • ホストフォルダーを編集しても、アプリが古い設定を使い続ける。
  • バックアップスクリプトは実行されるものの、実際のアプリデータが含まれていない。

このような場合は、ホスト側のパスとコンテナ側のパスを合わせて確認してください。片方だけを調べないでください。

データを失わずにHermes Agentを実行する方法

目的はHermes Agentを起動することだけではありません。再起動、アップデート、再構築、再設定を行っても、必要なデータが保持されるようにすることです。

ステップ 1: 専用のホストデータフォルダーを選ぶ

コンテナを実行または再構築する前に、ホストデータフォルダーを選んでください。見分けやすく、バックアップしやすい場所にし、無関係な個人ファイルと混在させないようにしましょう。

専用フォルダーを使えば、どのデータがアプリに属するかを確認できるため、リスクを軽減できます。また、ホームディレクトリ全体やその他の機密フォルダーをコンテナにマウントせずに済みます。

実用的なホストデータフォルダーには、次の条件が必要です。

  • アプリ専用であること。
  • 一時的なダウンロード先の外にあること。
  • バックアップ計画に含まれていること。
  • 無関係なサービスと広く共有されていないこと。
  • 必要なユーザーやサービスのみが書き込めること。

ステップ2:データフォルダーをコンテナにマウントする

ホストのデータフォルダーを、アプリが想定するコンテナ内のパスにマウントしてください。多くのデータ消失問題は、この段階で発生するか防止されます。

バインドマウントでは、ホスト側のパスを自分で指定し、コンテナ内での表示先となるパスを指定します。名前付きボリュームの場合、ホスト側の場所はDockerが管理します。

アプリがマウントしたフォルダーを自動的に使うと思い込まないでください。マウント先が実際のアプリデータのパスと一致することを確認してください。

ステップ3:コンテナが想定されるアプリデータのパスを使用していることを確認する

マウント後、コンテナ内からパスを確認してください。ホスト上にフォルダーが存在していても、正しくマウントされていなければ、アプリからは見えないことがあります。

最も簡単な検証方法は、片方から問題のないテストファイルを作成するか見つけて、もう片方にも表示されることを確認することです。次に、アプリが設定、ログ、生成ファイルなどの実データを、同じ永続パスに書き込むことを確認します。

このステップは、アップデートや移行の前に特に重要です。

ステップ4:ファイルの所有者と書き込み権限を確認する

マウントが正しくても、アプリが書き込めなければ機能しません。ファイルがrootによって作成された後、アプリが別のユーザーとして実行される場合などに、権限エラーがよく発生します。

広範囲に権限を変更する前に、所有者を確認してください。通常は、すべてのプロセスにホスト上の広範なディレクトリへの完全な制御権を与えるのではなく、アプリの実行ユーザーが対象のアプリデータフォルダーを読み書きできるようにするのが適切です。

「アクセスが拒否されました」と表示された場合は、次の点を確認してください。

  1. マウント元のホストパス。
  2. コンテナ内のマウント先パス。
  3. アプリを実行しているユーザー。
  4. ファイルの所有者。
  5. マウントが読み取り専用かどうか。
  6. バックアップまたはエクスポート先のパスも書き込み可能かどうか。

ステップ5:シークレットと設定ファイルを削除される可能性のあるパスの外に保管する

シークレットや設定ファイルを、一時フォルダー、生成物の出力ディレクトリ、その場しのぎのシェル履歴だけに保存しないでください。環境変数を使う場合は、デプロイ用ファイルや環境変数ファイルを、管理された永続的な場所に保管してください。

シークレットをログや生成されたファイルと混在させないでください。ログはトラブルシューティングのために共有する場合がありますが、シークレットを不用意に共有してはいけません。

シークレットをバックアップする場合は、バックアップを保護してください。APIキーやボットトークンが漏れるバックアップは、別の種類のリスクを生みます。

ステップ6:コンテナを再起動し、データが残っていることを確認する

セットアップ後にコンテナを再起動し、重要なデータが残っているか確認してください。これが、データの永続性を確かめる最も実用的なテストです。

「コンテナが起動する」だけで終わらせないでください。次の点を確認してください。

  • モデルの設定が引き続き存在する。
  • スキルやアプリの状態が引き続き表示される。
  • ログが引き続き所定の場所に出力される。
  • 生成されたファイルがホスト上に表示される。
  • ゲートウェイやボットの設定が引き続き機能する。
  • バックアップファイルの場所を特定できる。

再起動後の検証に合格する構成は、初回インストールにしか合格していない構成より、はるかに安全です。

権限、バックアップ、安全の境界

データの安全性は、書き込み権限を持つユーザー、バックアップの対象、エージェントに操作を許可する対象という3つの境界に左右されます。ファイルを作成したり、ワークフローを変更したり、ツールを操作したりする可能性があるセルフホスト型エージェントでは、これらの境界が特に重要です。

コンテナユーザーの権限が重要な理由

コンテナユーザーの権限によって、アプリがデータを読み書きできるかどうかが決まります。アプリをあるユーザーとして実行し、マウントされたフォルダーが別のユーザーの所有になっている場合、書き込みに失敗することがあります。

このため、セットアップコマンドをrootとして実行すると、後で問題が起きることがあります。rootならファイルを正常に作成できても、通常のアプリユーザーはそれを変更できない場合があります。

権限はアプリデータフォルダーの範囲で修正してください。関係のないホストファイルまで公開するような、広範な権限変更は避けてください。

すべてをrootとして実行すべきでない理由

rootは多くの制限を回避できますが、それだからといって安全な初期設定というわけではありません。すべてをrootとして実行すると、root所有のファイルが作成され、権限の問題が見えにくくなり、アプリに必要以上のアクセス権を与えるおそれがあります。

セルフホストアプリの一般的な運用では、rootの使用は特定の管理作業に限るべきです。可能な限り、通常のアプリ設定は本来のアプリユーザーまたはコンテナユーザーとして実行してください。

より安全な方法は最小権限の原則に従うことです。アプリには、必要なフォルダーだけへの書き込み権限を与えてください。

読み取り専用マウントやフォルダーの制限を利用するタイミング

エージェントにファイルの確認だけを許可し、変更はさせたくない場合は、読み取り専用のマウントを使用してください。エージェントに出力を作成させつつ、個人用またはシステム用の広範なディレクトリには触れさせたくない場合は、書き込み可能なフォルダーを限定してください。

これは、サーバー上のすべてのファイルへの書き込み権限を与えずに、エージェントにレポート、計画、スクリプトを生成させたい場合に特に便利です。

フォルダーを限定する設計にすれば、ミスによる影響を抑えられます。また、アプリの状態を保存するフォルダーと生成した出力を保存するフォルダーを把握できるため、バックアップも簡単になります。

更新や再設定の前にエージェントデータをバックアップする方法

コンテナイメージ、マウントパス、ゲートウェイ設定、またはプロファイルを変更する前に、重要なアプリデータをバックアップしてください。バックアップが役立つのは、何が含まれていて、どう復元するのかを把握している場合に限られます。

Dockerコミュニティのボリュームのバックアップ権限に関する議論では、ユーザーによくある問題のパターンが示されています。パスが存在していても、権限、所有者、ラベル、またはマウントに関する制限により、バックアップや書き込みに失敗することがあります。

これを、バックアップを作成するだけでなく、テストすることの重要性を思い出すきっかけにしてください。バックアップ計画には、バックアップの作成と復元の検証の両方を含める必要があります。

よくある問題と解決方法

Hermes Agentのデータが見つからなくても、すぐにアプリを再インストールしないでください。まず、どの層で問題が発生したのかを特定しましょう。データの所在、永続化パス、マウントのマッピング、権限の境界、バックアップの対象範囲、再起動後の検証のいずれかを確認してください。

コンテナがマウントされたフォルダーを見つけられない

これは通常、一方のレイヤーにはパスが存在するものの、もう一方には存在しないことを意味します。ホストのフォルダーがマウントされていない、コンテナ内のターゲットパスが間違っている、またはアプリが別の場所を参照している可能性があります。

次の順に確認してください。

  1. ホスト上にフォルダーが存在することを確認してください。
  2. コンテナにマウントがあることを確認してください。
  3. コンテナ内のターゲットパスを確認してください。
  4. そのターゲットパスを使用するようアプリが設定されていることを確認してください。
  5. アプリユーザーがフォルダーを読み取れることを確認してください。
  6. Composeまたは実行設定を変更した後、マウントが再作成されたことを確認してください。

コンテナ内に適当なフォルダーを作成して解決しようとしないでください。一時的にエラーが消えても、データが破棄可能なストレージに残るおそれがあります。

再起動後にアプリのデータがリセットされる

再起動後にデータがリセットされる場合、アプリは永続化パスではなくコンテナの内部ファイルシステムに書き込んでいる可能性があります。また、想定とは異なるプロファイル、環境変数、データディレクトリが使われている可能性もあります。

再起動の前後でデータパスが同じか確認してください。次に、そのフォルダーがマウントによって保持されているのか、コンテナレイヤー内だけにあるのかを確認してください。

アプリを再作成した場合は、新しいコンテナに同じボリュームまたはバインドマウントが割り当てられていることを確認してください。

データディレクトリでの権限拒否エラー

権限が拒否されたというエラーは、アプリがそのパスを認識していても、必要な操作を実行できないことを意味します。原因として、所有権、読み取り専用のマウント設定、ファイルシステムのラベル、ホストユーザーとコンテナユーザーの不一致などが考えられます。

まずは最小限の確認から始めます。アプリユーザーはデータディレクトリに無害なテストファイルを作成できますか?できない場合は、そのパスの所有者と権限を確認してください。

ホストのディレクトリ全体に広範な書き込み権限を与えて解決しようとしないでください。アプリのデータパスと、使用するアプリユーザーを適切に設定してください。

生成ファイルがコンテナ内にのみ保存される

再構築後に生成ファイルが消える場合、マウントされたホストパスではなく、コンテナ内に保存されていた可能性があります。これは多くの場合、アプリの作業ディレクトリや出力ディレクトリがマッピングされていないために起こります。

生成ファイルの保存先を決めます。次に、その出力フォルダーをマウントするか、アプリが既存の永続化先に書き込むよう設定します。

パスを変更した後、無害なテストファイルを作成し、ホスト上に表示されることを確認してください。

再設定後にボットまたはゲートウェイの設定が消える

設定が永続化されないパスに保存されている場合や、再起動後にアプリが別のプロファイルで実行される場合、ゲートウェイの設定が消えることがあります。ある場所で環境変数を変更しても、実行中のコンテナで別の値が使われている場合も同様です。

ゲートウェイ設定、ボットトークンの参照先、許可リスト、ダッシュボード設定が、想定される永続化先に保存されているか確認してください。次にゲートウェイを再起動し、設定が維持されていることを確認してください。

再起動前はボットが動作するのに、再起動後は動作しない場合は、トークンを変更する前に、永続化と環境設定を確認してください。

Hermes Agentのデータが安全かどうかを確認する方法

安全なセットアップでは、再起動、書き込み、バックアップ、アクセスの各チェックに合格する必要があります。これらのチェックは複雑にする必要はありませんが、大きな変更の後には繰り返し実施してください。

再起動後も設定が保持される

影響のない設定を変更してコンテナを再起動し、その設定が保持されることを確認してください。これにより、アプリが永続ストレージに書き込んでいることを確認できます。

設定が消えてしまう場合は、さらに設定を追加するのをやめてください。まずデータパスを修正してください。

ログと生成ファイルがホスト上の想定したフォルダーに表示される

ログと生成ファイルが、ホスト上の想定した場所に表示される必要があります。コンテナ内にしか表示されない場合は、再構築時に失われる可能性があります。

マウントの両側を確認してください。ホストとコンテナの両方で、重要なファイルが見える状態になっている必要があります。

エージェントが権限エラーなしでアプリデータに書き込める

エージェントは、想定するユーザーとしてアプリのデータフォルダーに書き込める必要があります。フォルダーの存在を確認するだけよりも、書き込みテストに成功することのほうが重要です。

再起動後、ログに権限エラーがないか確認してください。エージェントが設定を更新する、スキルを書き込む、生成ファイルを保存する、またはゲートウェイの状態を更新するときにのみ発生する権限の問題もあります。

バックアップファイルの保存場所を特定し、復元できる

バックアップは、保存場所を特定し、テスト用の場所に復元できるまでは不完全です。最低限、保護するつもりだったデータがバックアップに含まれていることを確認してください。

重要なセットアップでは、バックアップに頼る前に、別のフォルダーまたはテスト用インスタンスに復元してください。これにより、データを失ってから初めて復元の問題に気付く事態を防げます。

再起動後もダッシュボードまたはメッセージングにアクセスできる

再起動後、ダッシュボードまたはメッセージングへのアクセスが引き続き機能することを確認してください。これにより、永続データ、認証情報、ゲートウェイの設定、ネットワークアクセスの整合性が保たれていることを確認できます。

ダッシュボードは動作するのにメッセージを送受信できない場合は、ゲートウェイの設定とトークンへのアクセスを確認してください。メッセージは送受信できるのに生成ファイルが消える場合は、出力パスとマウントを確認してください。

実際のホームサーバー環境での動作

実際のホームサーバーのセットアップでは、システムに使いやすいダッシュボードが用意されていても、同じデータ保護の考え方が当てはまります。保持すべきデータは何か、どこに保存されているか、コンテナからどのように見えるか、誰が書き込めるか、再起動後にどう確認するかを把握しておく必要があります。

たとえば、ZimaOS Hermes Agentセットアップワークフローでは、モデルプロバイダーの設定、Telegramゲートウェイのセットアップ、Hermesコンテナへの接続、アプリ環境の有効化、Webダッシュボードの確認、権限やボットの応答に関する問題のトラブルシューティングまで、デバイス固有の手順を紹介しています。

Dockerアプリ、エージェントのワークフロー、ローカルサービスをコンパクトで常時稼働するマシン上で実行するユーザーにとって、ZimaBoard 2ホームサーバーは、永続フォルダー、コンテナ内パス、権限、ストレージの拡張をまとめて計画する必要がある、軽量なホームサーバー環境の一例です。考えられる構成はこれだけではありませんが、このガイドで取り上げているセルフホストのアプリワークフローに適しています。

一般的な教訓はほかの環境にも当てはまります。コンテナ化されたエージェントに重要な作業を任せる前に、現在稼働しているコンテナがなくなっても、重要なデータが保持されることを確認してください。

よくある質問

コンテナを再起動した後、Hermes Agentのデータが消えたのはなぜですか?

通常の再起動で永続データが削除されることはありませんが、永続化されないコンテナ内パスに書き込んでいた場合、アプリがリセットされたように見えることがあります。また、同じボリュームやバインドマウントを使わずにコンテナを再作成した場合も、データが見つからなくなることがあります。さらに設定を変更する前に、ホストパス、コンテナ内パス、実際のアプリデータのパスを確認してください。

Dockerボリュームとバインドマウントの違いは何ですか?

DockerボリュームはDockerが管理する一方、バインドマウントは選択したホストフォルダーをコンテナ内に割り当てます。アプリが管理するデータにはボリュームがすっきり使えることが多く、ホスト上で直接場所を確認できる点ではバインドマウントが便利です。Docker管理のストレージを使うか、バックアップや確認がしやすいホストフォルダーを使うかによって、最適な選択は異なります。

ホームサーバー上でHermes Agentのアプリデータはどこに保存すべきですか?

一時的なコンテナ内パスではなく、専用の永続フォルダーまたはDockerボリュームを使用してください。場所はバックアップしやすく、アプリに必要な範囲に限定し、関係のない機密ファイルと混在させないようにします。最も重要なのは、アプリが想定するコンテナ内パスが、その永続ストレージに実際にマッピングされていることです。

コンテナ内でフォルダーが存在しないと表示されるのはなぜですか?

ホスト上にはフォルダーが存在しても、コンテナ内には存在しない場合があります。通常は、マウントが作成されていない、ソースパスが間違っている、ターゲットパスが間違っている、またはアプリが別のコンテナ内パスを参照していることが原因です。よく確認せずに新しいフォルダーを作るのではなく、ホスト側とコンテナ側の両方を確認してください。

権限エラーを避けるために、Hermes Agentをrootで実行すべきですか?

rootで実行すると、目の前のエラーは解消するかもしれませんが、root所有のファイルが作成されたり、リスクが高まったりする可能性があります。より安全な方法は、必要なアプリデータのパスだけを、想定するアプリユーザーが読み書きできるようにすることです。変更内容を理解したうえで、特定の管理作業や修復作業を行う場合に限り、rootを使用してください。

Hermes Agentのデータはどのくらいの頻度でバックアップすべきですか?

更新、コンテナの再構築、パスの変更、ゲートウェイの再設定、または別のサーバーへの移行の前にバックアップを取ってください。日常的に使用する場合は、スキル、設定、生成ファイル、セッションの変更頻度に応じて定期的なバックアップをスケジュールしてください。ファイルの場所を特定して復元できることを確認するまでは、バックアップの信頼性は保証されません。

サポートとヒント

続きを読む

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.