SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

スマホからHermes agentに接続する3つの方法

Hermes agentをVPSで動かし、スマホから使う方法を解説します。Tailscaleのprivate mesh、TLS付きpublic HTTPS、SSHを比較し、端末紛失時のアクセス revoke も説明します。

スマートフォンからHermesエージェントに接続する3つの方法

スマートフォンからHermesエージェントに接続するには、Webダッシュボードを使用します。実際の選択点は、そのダッシュボードの前段に何を置くかです。方法1はプライベートメッシュネットワークです。ダッシュボードはTailscaleアドレスでのみ待ち受け、インターネットに公開するポートはありません。方法2は、TLS(transport layer security)とログインを設定したリバースプロキシの背後にパブリックエンドポイントを置く方法です。この場合、そのログインだけでサーバー上のターミナルへのアクセスを保護します。方法3は、ターミナルアプリからSSH(secure shell)で接続する方法です。設定が最も少なく、最も広いアクセス権を渡します。

このガイドでは、自分のVPSでHermesエージェントを実行する手順の続きから始めます。エージェントはインストール済みで、コマンドラインに応答します。ここからは、それをスマートフォンで使えるようにします。

以下のコマンドは、2026年8月3日に公開され、リリースノートでv0.20.0と表示されているtag v2026.8.3を対象にしています。Hermesは頻繁にリリースされるため、mainを追従するのではなく、マシンをtagに固定してください。インストーラーにはcommitを指定できます。

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --version

この固定には、そのtagのインストーラーを使用してください。現在のインストーラーは、新しいPM依存関係システムを前提としています。hermes --versionを実行すると、実際にインストールされている内容が表示されます。このページのflagを信頼する前に、tagと比較してください。

リポジトリに含まれるものと、含まれないもの

Hermes リポジトリには iOS アプリも Android アプリもありません。ネイティブクライアントは hermes desktop(別名 hermes gui)です。macOS、Windows、Linux で動作する Electron アプリケーションです。ローカルエージェントの代わりにリモートエージェントへ接続できます。Settings の Gateway でリモート URL に http://<server-address>:9119 を設定するか、起動前に HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119 を export します。これで 2 台目のラップトップから利用できます。ただし、スマートフォンには対応しません。

スマートフォンから利用するのは hermes dashboard、つまりブラウザーインターフェイスです。設定、セッション、cron ジョブ、スキル、ログ、メッセージングプラットフォームを管理できます。ターミナルも組み込まれています。サーバーは PTY(pseudo-terminal)の背後で hermes --tui を起動し、その出力をページへストリーミングします。画面幅が狭い場合、セッション切り替えはスライドオーバーパネルに折りたたまれるため、スマートフォンでもレイアウトを維持できます。

新しいリリースでは、hermes webapp を使用してブラウザーから Desktop ワークスペースも利用できます。これは独自のポートと公開 URL 設定を持つ、別の gateway インターフェイスです。以下ではダッシュボードについて説明します。

デフォルトでは、ダッシュボードは 127.0.0.1:9119 で待ち受け、サーバー自体でブラウザータブを開きます。これはヘッドレス VPS(virtual private server)では役に立ちません。ブラウザーを開かずに起動し、ソケットを確認します。

hermes dashboard --no-open
ss -lntp | grep 9119

127.0.0.1:9119 で待ち受けるサービスには、サーバーからのみ接続できます。0.0.0.0:9119 で待ち受けるサービスには、そのマシンが接続しているすべてのネットワークから接続できます。公開ネットワークも含まれます。この 1 行で公開範囲が決まるため、思い込みで判断せず、実際に確認してください。

Tailscale を使ったプライベートメッシュ

特別な理由がない限り、これを選んでください。Tailscale は WireGuard を基盤とするメッシュ VPN(仮想プライベートネットワーク)です。登録したすべてのデバイスに固定アドレスが割り当てられ、他のデバイスへ直接、または暗号化されたリレー経由で接続します。スマートフォンも同じメッシュに参加するため、ダッシュボードで公開ポートを開く必要はありません。

サーバー上で実行します。

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4

スマートフォンに Tailscale アプリをインストールし、同じアカウントでサインインします。サーバー上で tailscale status を実行すると、スマートフォンが名前付きで表示されます。次に、tailscale ip -4 が出力したアドレスにダッシュボードをバインドします。

hermes dashboard --host 100.101.102.103 --port 9119 --no-open

0.0.0.0 ではなくメッシュのアドレスにバインドすると、そのソケットはそのメッシュ IP 宛ての接続だけを受け付けます。公開 IP アドレスを対象にポートスキャンしても、9119 番ポートでは何も見つかりません。そのアドレスでは何も待ち受けていないためです。ただし、これだけではソケットを Tailscale インターフェースに限定できません。Linux kernel のドキュメントにも明記されているとおり、IP アドレスは特定のインターフェースではなく、ホスト全体に属します。プロバイダーの同じネットワーク上にあるマシンから、公開インターフェースに到着した 100.101.102.103 宛てのパケットが、ダッシュボードに到達する可能性があります。インターフェースも限定するには、ufw の受信トラフィックに対するデフォルト拒否を維持し、sudo ufw allow in on tailscale0 to any port 9119 proto tcp でメッシュ上だけにポートを許可します。もう一度 ss -lntp | grep 9119 でリスナーを確認します。

バインドアドレスは認証方法も決定します。ここを見落とす人が多くいます。v2026.8.3 では、127.0.0.1 にバインドしたダッシュボードには、public_url を設定していてもログインがありません。その他のアドレスでは認証ゲートが必須で、プロバイダーを設定していない場合、サーバーは起動を拒否します。プロジェクトでは、この動作をフェイルクローズと呼んでいます。初回は対話形式で実行してください。そこでユーザー名とパスワードの設定を求められ、~/.hermes/config.yaml 内の dashboard.basic_auth として保存されます。代わりに ~/.hermes/.env で同じプロバイダーを設定することもできます。プロジェクト独自の動作例もこの方法を使っています。

HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-string

openssl rand -base64 32 でシークレットを生成します。これはプロジェクトのダッシュボードドキュメントで使用されているコマンドです(設定コメントでは、32 バイト以上のランダムデータを base64 または hex で指定するよう求めています)。生成後は変更しないでください。これはパスワードプロバイダーのセッショントークンへの署名に使われるため、変更するとそのプロバイダーを使用しているすべてのデバイスからサインアウトさせることになります。同じファイルにはモデル API キーも保存されるため、chmod 600 ~/.hermes/.env で非公開にします。

信頼する前に、メッシュ上の別のマシンから認証ゲートを確認します。

curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'

true に続けて ["basic"] を実行すると、認証ゲートが有効で、パスワードプロバイダーが応答していることが分かります。プロジェクトのドキュメントは、このプロバイダーについて明確に説明しています。信頼できるネットワークまたは VPN を対象としており、公開インターネットに接続するダッシュボードには適していません。メッシュ上では、まさにこの条件に該当します。

tailnet 内で HTTPS を使用する場合、以下の Tailscale Serve 構成には、Host と WebSocket Origin のチェックで public_url をサポートする新しいリリースが必要です。v2026.8.3 の pin では動作しません。ループバックへのバインドは、public_url に関係なくループバックの Host 名だけを受け付けるためです。その pin では、上記の直接的なメッシュ IP を使ってください。アップグレードしてこれらのチェックを確認した後、Serve はここでループバックアドレスへプロキシします。この構成では、ダッシュボードをメッシュアドレスではなく 127.0.0.1 で起動し、次を実行します。

sudo tailscale serve --bg localhost:9119
sudo tailscale serve status

現在の Hermes ダッシュボードドキュメントでは、tailscale serve status が出力する HTTPS origin を公開 URL として使用するよう説明しています。

dashboard:
  public_url: "https://vps.tail1234.ts.net"

この行がないと、ダッシュボードは Host ヘッダー内の MagicDNS 名を拒否します。この名前はループバックホストではないため、バックエンドがループバックで待ち受けていても認証ゲートは有効なままです。Tailscale はマシンの MagicDNS 名に対して発行された証明書で TLS を終端するため、ブラウザーの警告が表示されなくなり、セッション Cookie に Secure フラグが付きます。まず Tailscale の管理コンソールの DNS ページで MagicDNS と HTTPS Certificates を有効にしてください。その際、確認事項も読んでください。マシン名と tailnet の DNS 名は公開の Certificate Transparency 台帳に登録され、誰でも閲覧できます。

ここでの正直なコストは、調整サーバーです。スマートフォンと VPS の間のトラフィックは、Tailscale DERP リレーを経由する場合も含めてエンドツーエンドで暗号化されます。ただし、どのデバイスをメッシュに所属させるかを決めるアカウントは、ユーザーのハードウェア上にはありません。これが問題になる場合は、自分でホストする Tailscale のコントロールサーバーである Headscale を実行し、tailscale up --login-server https://headscale.example.com でクライアントの接続先を指定します。メッシュを使わず、ピアを手動で設定したい場合は、通常の WireGuard と Tailscale の比較で、その代わりに失うものを説明しています。

オプション 2: 公開 HTTPS エンドポイントと、その内部にある落とし穴

メッシュを利用できない場合があります。業務用のスマートフォンでは、VPN クライアントをインストールできないことがあります。その場合、ダッシュボードをリバースプロキシの背後に置きます。このループバック HTTPS 構成にも、前述の新しい公開ホスト名サポートが必要です。public_url では v2026.8.3 上で動作しません。ダッシュボードはループバックに保持し、証明書は Caddy に管理させます。

hermes.example.com {
  reverse_proxy 127.0.0.1:9119
}

Caddy は証明書を自動的に取得して更新します。また、reverse_proxy により WebSocket のアップグレードを追加のディレクティブなしで通過させます。これはダッシュボードの組み込みターミナルに必要です。nginx では Upgrade と Connection のヘッダーを自分で追加する必要があります。nginx で Certbot を使用して Let's Encrypt 証明書を発行するでは、その TLS 設定について説明しています。ログインコールバックが正しいホストを指すように、Hermes に公開名を設定します。

dashboard:
  public_url: "https://hermes.example.com"

ここに落とし穴があります。認証ゲートは、リクエストの送信元アドレスではなく、bind address に基づいて動作します。現在のリリースでは、バックエンドがループバック上にあっても、dashboard.public_url(または HERMES_DASHBOARD_PUBLIC_URL)で非ループバックホストを指定するとゲートも有効になります。そのため、上記の設定ではゲートが有効になり、プロバイダーを設定するまでダッシュボードは起動しません。public_url を未設定のままにするとゲートは無効ですが、プロキシだけではアクセスを許可する相手を決められません。ダッシュボードは Host ヘッダーも確認します。このループバック構成では、現在のリリースはループバック名と public_url が指定するホストを受け付け、それ以外には 400 を返します。固定された v2026.8.3 はここではループバック名だけを受け付け、public_url は確認しません。Caddy はブラウザーの Host を変更せずに転送するため、public_url のない上記のブロックは拒否され、配信されません。危険なのは、プロキシが Host をバックエンドのアドレスに書き換える場合です。nginx はデフォルトでそのように動作し、proxy_set_header Host を自分で設定しない限り proxy_pass の宛先を送信します。このようなリクエストはチェックを通過し、ログインのないダッシュボードに到達します。ターミナルの WebSocket には Origin のチェックもあります。固定版では、HTTP または HTTPS の Origin ヘッダーが存在する場合、bind されたホストを指している必要があります。これにより、公開ホスト名上のブラウザーは阻止されます。しかし、Origin 自体を送信しないスクリプトはこのチェックを通過します。設定内容にかかわらず、実際に公開した内容を確認してください。

curl -s https://hermes.example.com/api/status | jq '.auth_required'

これが false と表示される場合、インターネットからサーバー上のターミナルまで、あと 1 つの URL しかありません。悪用は必要なく、ログにも何も記録されません。代わりにリクエストが 400 で失敗する場合は、Host のチェックで拒否されています。公開ホスト名をサポートするリリースでは、ヘッダーを書き換えてチェックを回避するのではなく、public_url とログインプロバイダーを設定して修正します。v2026.8.3 では、直接メッシュ IP への経路を使用するか、先にアップグレードしてください。公開されたダッシュボードには 2 つの対策があり、少なくとも 1 つを適用する必要があります。プロキシ側に認証を置き、自己ホスト型のシングルサインオンプロバイダーとしての Authentikを forward auth 経由で前段に配置するか、ダッシュボード独自の OIDC(OpenID Connect)プロバイダーを設定します。

HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"

正しく設定しても、この構成には下げられない最低限のリスクがあります。公開ログインページは誰でも到達して攻撃できるページであり、その背後には VPS 上の shell があります。そのためのユーザー名とパスワードだけでは防御が弱く、公開 bind には OAuth または OIDC が推奨されています。ログインをレート制限し、ufw ではプロキシのポートと SSH 以外をすべて閉じた状態にし、アクセスログを定期的に確認してください。

モバイル端末から SSH と mosh を使用する方法

最も手間が少ない方法は、スマートフォンにターミナルアプリをインストールし、SSH key を読み込ませて、エージェント本来のテキストインターフェースを使用することです。

ssh you@vps.example.com
tmux new -A -s phone
hermes --tui

tmux new -A -s phone は phone という名前のセッションに接続します。セッションがなければ作成します。そのため、接続が切れてもエージェントは実行を継続し、次回は同じ場所に戻れます。この方法は、スマートフォンから Claude Code を操作する方法と同じパターンです。

モバイルネットワーク経由の通常の SSH は、スマートフォンのアドレスが変わったり、スリープしたりするたびに接続が切れるため、使いにくいことがあります。mosh ならこの問題を解決できます。mosh は UDP(user datagram protocol)を使用し、バイトストリームではなくターミナルの状態を同期します。そのため、wifi から cellular へ移動してもセッションが維持されます。

sudo apt install -y mosh
sudo ufw allow 60000:61000/udp

スマートフォンから mosh you@vps.example.com を実行します。mosh は既存の SSH ログインを使用して mosh-server を開始し、その後セッションを 60000 から 61000 の範囲にある UDP ポートへ移します。これが、この範囲を開放する理由です。各セッションに必要なポートは 1 つだけです。そのため、同時実行するセッションが少ないサーバーでは、たとえば 60000 から 60010 のように、より狭い範囲だけを開放できます。

セキュリティ上の代償は明確です。SSH セッションは shell であり、shell からはそのアカウントが実行できるすべての操作が可能です。そのため、エージェントの承認プロンプトが、ロック解除されたスマートフォンを盗まれた場合に、攻撃者がファイルへアクセスするのを防ぐ最後の防壁になります。この用途には専用の non-root アカウントを使用し、認証は key のみにしてください。また、持ち歩く端末に key を保存する前に、VPS の SSH を強化する方法を実施してください。

モバイルネットワークで発生する問題

問題は 4 つあります。どれも設定だけでは解消できません。

見ていない間にダッシュボードからログアウトされます。 どの程度の時間で発生するかは、ログインプロバイダーによって異なります。ユーザー名とパスワードのプロバイダーは、デフォルトで 12 時間有効なアクセストークンを発行します。この期間は dashboard.basic_auth の session_ttl_seconds で設定します。ただし、この値が制御するのはダッシュボードのバックグラウンド更新間隔であり、サインイン状態の保持期間ではありません。更新のたびに新しい 30 日間有効なリフレッシュトークンが発行されるため、パスワードログインは更新しない状態が 30 日間続くまで維持されます。HERMES_DASHBOARD_BASIC_AUTH_SECRET または dashboard.basic_auth.secret で安定した署名 Secret を設定していない場合は、バックエンドの再起動でもログイン状態が終了します。Hermes は起動するたびに新しい署名キーを生成するためです。Nous Portal OAuth プロバイダーのアクセストークンは TTL (time to live) が 15 分で、使用するたびにローテーションするリフレッシュトークンによってバックグラウンドで更新されます。そのため、アクセストークンの期限切れだけで /login に戻されることはありません。原因になるのは、リフレッシュセッションの喪失です。v0.21.3 より前のリリース(タグ v2026.9.14、公開日 14 September 2026)では、バックグラウンドから復帰したスマートフォンが複数のリクエストを同時に送信することがありました。直前にローテーションされたリフレッシュトークンが再利用されると、プロバイダーの再利用検出が作動してセッション全体が失効し、入力中の内容が失われた状態でログイン画面に戻されていました。v0.21.3 では、これらのリクエストが 1 回のリフレッシュを共有します。また、Nous Portal 側では、リフレッシュセッションがローテーションのたびに 30 日間の期限を延長するようになりました。ただし、30 日間操作がなければ終了します。このページの先頭から v2026.8.3 を固定して使用している場合は、ときどき強制的にログインを求められることを想定してください。故障ではありません。もう一度サインインしてください。

デフォルトでは、埋め込みターミナルはバックグラウンドタブに移動すると維持されません。 ダッシュボードでドキュメント化されているターミナル接続は、PTY の背後で TUI (text user interface) を起動し、タブを閉じると正常に終了させます。タブを開き直すと、新しい TUI が起動します。モバイルブラウザーはメモリを解放するためにバックグラウンドタブを破棄することがあり、別のアプリに切り替えたままにすると、そのターミナルも終了します。セッションはサーバーに保存されるため、チャット履歴は安全です。hermes sessions list でも引き続き確認できます。固定しているサーバーは、アタッチメントトークンを使用するオプトインのキープアライブ接続にも対応しています。この接続では、切り離された PTY が 30 分間保持されます。切断後も維持されるセッションが必要な場合は、SSH 経由で tmux を使用してください。

アイドル状態の接続は、通知なしに切断されます。 モバイル通信事業者は、NAT (network address translation) テーブルのエントリを解放するために、アイドル状態の TCP 接続を切断します。また、画面をオフにすると、スマートフォンはネットワーク処理をほぼ停止します。しばらく通信していない WebSocket は、ロック解除した時点ですでに切断されていることが多く、ページは操作するまで再接続しません。スマートフォンでは SSH より mosh の方が使いやすいのはこのためです。mosh は失う接続自体を必要としません。

通知は送信されません。 ダッシュボードも SSH セッションも、スマートフォンを起動することはできません。デバイス上に Hermes アプリがないため、プラットフォームのプッシュサービスへ到達する経路もありません。長時間のエージェント実行が終了しても、次に画面を確認するまで分かりません。

メッセージングゲートウェイ経由で通知を受け取る

最後の問題を解決するのがゲートウェイです。これは、エージェントへ接続する別の方法です。hermes gatewayを使うと、Telegram、Discord、Slack、WhatsApp、Signal、email などのメッセージングプラットフォームにエージェントを接続できます。スマートフォンですでにプッシュ通知用のチャネルを持ち、バックグラウンド配信に対応し、ネットワークが切断された場合も処理できるアプリ内で、エージェントとやり取りできます。

hermes gateway setup
hermes gateway install
hermes gateway status

hermes gateway installはゲートウェイを systemd サービスとして登録するため、再起動後も復旧します。インストーラーのゲートウェイ処理でこの手順を実行できます。ただし、インストーラーは hermes dashboard 用の unit を作成しません。そのため、再起動後にダッシュボードが自動で復旧することはありません。依存する各コンポーネントに unit を作成してください。ファイル自体の作成方法は、VPS での systemd サービスとタイマーの作成で説明しています。

スケジュールされたジョブも、会話を使わずに同じ方法で結果を送信できます。

hermes send -t telegram -s "Backup report" -f /home/you/report.txt

ここでの認証はデフォルト拒否です。allowlist または承認済みのペアリングがなく、GATEWAY_ALLOW_ALL_USERSも未設定の場合、すべてのユーザーが拒否されます。これは適切な初期状態です。許可するアカウントを ~/.hermes/.env に指定します。

TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789

数値 ID を貼り付ける代わりに、コードベースのペアリングを使うこともできます。これはチャット形式の DM プラットフォームではデフォルトで有効です。~/.hermes/config.yaml内で unauthorized_dm_behavior: pairを明示的に設定することもできます。未知のアカウントがエージェントにメッセージを送ると、8 文字のコードが届きます。承認するまで、それ以外の処理は行われません。

hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789

コードの有効期限は 1 時間です。ユーザーがコードを要求できるのは 10 分に 1 回です。認証に 5 回失敗すると、そのアカウントはロックアウトされます。

盗難・紛失したスマートフォンの影響範囲を制限する

エージェントに接続できるスマートフォンは、サーバー上でコマンドを実行できます。スマートフォンは紛失する可能性があります。その端末を持つ人が実行できる操作を、今のうちに決めてください。

承認は有効にしておきます。approvals.mode のデフォルトは smart です。この設定では補助モデルがリスクを判定し、低リスクのコマンドだけを自動承認します。off に設定すると、すべてを --yolo で実行するのと同じ状態になります。HERMES_YOLO_MODE=1 を使えば、環境変数で同じ設定にできます。この状態でエージェントに接続するスマートフォンを持ち歩かないでください。approvals.cron_mode: deny を設定し、睡眠中にスケジュールされたジョブが自分自身を承認できないようにします。

approvals:
  mode: smart
  cron_mode: deny

エージェントが変更できる範囲を小さくします。terminal.backend: docker は、短い許可リスト以外の Linux capability をすべて削除したコンテナ内でコマンドを実行し、no-new-privileges を設定してプロセス数にも上限を設けます。これにより、プロンプトではなくコンテナが境界になります。terminal.cwd は作業ディレクトリを固定します。HERMES_WRITE_SAFE_ROOT は write_file と patch を指定したディレクトリに制限します。指定外への書き込みは、承認で上書きすることもできず、ブロックされます。

export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermes

Hermes はすでに ~/.ssh、~/.aws、~/.kube、/etc/sudoers と、~/.hermes/.env など自身の Secret 保存領域への書き込みをブロックします。ディスク上の別の場所にあるプロジェクトの .env ファイルは、読み取りがブロックされますが、書き込みは可能です。また、承認設定にかかわらず、破壊的なコマンドの厳格なリストを拒否します。これは最低限の防御と考え、これだけを対策にしないでください。エージェントは通常ユーザーとして実行し、root では実行しないでください。同じ考え方は、 unattended で実行し続ける coding agent にも当てはまります。VPS で Claude Code を安全に実行する方法では、この点をさらに詳しく説明しています。

次に、必要になる前に無効化の手順を書き出しておきます。Tailscale の管理コンソールで端末を削除すると、メッシュへのアクセスが直ちに切断されます。HERMES_DASHBOARD_BASIC_AUTH_SECRET を変更して再起動すると、すべての端末にある password provider のダッシュボードセッションが無効になります。この値が provider のセッショントークンに署名しているためです。~/.ssh/authorized_keys からスマートフォンの公開鍵を削除すると、その鍵による新しい SSH ログインをブロックできます。既存の SSH セッションと mosh セッションは別途終了してください。hermes pairing revoke telegram <user-id> は messaging account を削除します。provider の鍵を読み取れる情報が端末に保存されていた場合は、hermes auth logout <provider> でそれらを破棄し、上流の provider で新しい鍵を発行してください。

結果を推測で済ませず、確認してください。以下は自分のサーバーで実行するコマンドです。出力は環境によって異なります。

tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deep

ログは ~/.hermes/logs/ 以下に保存されます。インシデントの後に読み、インシデントが発生していないときも定期的に確認してください。

FAQ

iOS または Android 向けの公式 Hermes モバイルアプリはありますか?

いいえ。Hermes リポジトリには、command line interface、Web ダッシュボード、macOS、Windows、Linux 向けの Electron デスクトップクライアントが含まれています。ファーストパーティの iOS または Android ビルドはありません。スマートフォンからは、ブラウザーで Web ダッシュボードを使用するか、SSH クライアント、または hermes gateway 経由で接続したメッセージングプラットフォームを使用します。サードパーティ製のモバイルクライアントもあります。ただし、これらはエージェントの認証情報を保持するサードパーティコードです。インストールする前にソースを確認してください。

Hermes ダッシュボードからスマートフォンでログアウトされるのはなぜですか?

ログインプロバイダーによって異なります。Nous Portal OAuth プロバイダーは TTL が 15 分の access token を発行し、ローテーションされる refresh token をバックグラウンドで使用して更新します。そのため、access token の期限切れだけで /login に戻されることはありません。v0.21.3 より前のリリース(tag v2026.9.14)では、バックグラウンドから復帰したスマートフォンが複数のリクエストを同時に送信し、直前にローテーションされた refresh token を再送して、セッション全体を失効させることがありました。この場合はログインが必要になります。v0.21.3 でこの問題は修正されていますが、30 日間アイドル状態の refresh session は引き続き失効します。username と password を使用するプロバイダーの access token は、デフォルトで 12 時間です。これは session_ttl_seconds で設定され、ダッシュボードがバックグラウンドで更新を行う頻度だけを制御します。このプロバイダーは、更新のたびに再発行される 30 日間の refresh token を使用して更新するため、password によるログインは 12 時間後には終了しません。このプロバイダーを使用する場合は、HERMES_DASHBOARD_BASIC_AUTH_SECRET に安定したランダム値を設定してください。この変数または dashboard.basic_auth.secret に安定した secret がない場合、Hermes は起動するたびに新しい signing key を生成します。その結果、再起動のたびにログアウトされます。

Hermes ダッシュボードを安全にパブリックインターネットへ公開できますか?

自分で認証を検証した場合に限り可能です。認証ゲートは bind address に基づいて有効になり、現在のリリースでは dashboard.public_url が loopback 以外の host を指定している場合にも有効になります。そのため、公開 URL を設定せずに reverse proxy の背後で 127.0.0.1 に bind したダッシュボードは、ログインを要求しません。v2026.8.3 pin では、public_url を設定しても loopback auth gate は有効にならず、Host と WebSocket Origin のチェックを通じて public hostname を許可することもありません。HTTPS proxy の設定に進む前に、direct mesh IP route を使用するか、public hostname に対応したリリースへアップグレードしてください。Host check は、public hostname を転送する proxy を拒否します。ただし、nginx のデフォルト動作のように Host を backend address に書き換える proxy は拒否しません。curl -s https://your-host/api/status | jq '.auth_required' を実行し、返された内容を確認してください。username と password ではなく OAuth または OIDC を使用してください。プロジェクトのドキュメントでは、password provider は信頼できるネットワークと VPN 向けと説明されているためです。private mesh を使用すればこの問題自体を回避できるため、それがより適切なデフォルトです。

Tailscale アカウントは必要ですか。それとも control plane を self-host できますか?

self-host できます。Headscale は Tailscale coordination server のオープンな実装であり、公式 Tailscale client は tailscale up --login-server https://headscale.example.com を使用して接続できます。これにより、mesh への参加を許可するデバイスの一覧を自分で管理できます。その代わり、この server の運用と backup が必要になります。また、server が停止している間は、デバイスの登録や再認証を行えません。

エージェントがジョブを完了したときに、スマートフォンへ通知するにはどうすればよいですか?

messaging gateway を使用してください。デバイス上で push を受信する Hermes アプリがないため、dashboard と SSH にはスマートフォンを起動する機能がありません。hermes gateway setup を使用してエージェントを Telegram、Signal、Discord、またはその他の対応プラットフォームへ接続し、そのプラットフォームのアプリから通知を配信させてください。cron job から hermes send -t telegram -s "Job done" -f /path/to/report.txt を使用して単一のメッセージを送信することもできます。この方法では model を呼び出さずに配信できます。

この記事は役に立ちましたか?