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

HarnessRouterをセルフホストする方法と初期設定

Codex、Claude Code、Hermesを1つのセルフホストAPIで運用します。Dockerでのデプロイ、loopback bind、変更必須の初回ログイン、TLSアクセスまで説明します。

HarnessRouter でなくなるもの

自身が管理するサーバー上で複数のエージェントハーネスを運用するために、HarnessRouter Community Edition をセルフホストし、複数のハーネスの前段に 1 つの API を置きます。エージェントハーネスとは、モデルをループで動かすコマンドラインプログラムです。セッションを保持し、ファイルを編集し、コマンドを実行し、進行状況を依頼元へストリーミングします。Codex、Claude Code、Hermes はいずれもこの役割を担いますが、それぞれ独自のインストール方法、認証情報の形式、セッションの扱い方を持っています。HarnessRouter はこれらをすべて 1 つのコンテナ内で実行し、その前段に単一の HTTP エンドポイント、単一のログイン、単一の Secret ストアを置きます。

考え方はこれだけですが、その代償は明確にしておく必要があります。複数の構成要素を 1 つにまとめるために、サーバーへコンテナ、ログイン、ボリューム、アップグレード手順を追加します。現在、ハーネスを 1 つだけ実行しているなら、この構成はハーネスを直接インストールするよりも不利です。このトレードオフについては最後のセクションで説明するため、デプロイする前に確認してください。

以下の内容は、19 August 2026 に取得した image tag 0.5.5 を基準に確認しています。このプロジェクトはほとんどの日に新しいタグを公開するため、1 か月後にこのページをそのまま信頼せず、実際に実行するタグを確認してください。8 November 2026 に、このページをプロジェクトの最新のドキュメントとソースに基づいて再確認しました。その時点で latest は 0.38.5 を指しており、現在のリリースで動作が異なる箇所にはその旨を記載しています。コマンドは、プロジェクトリポジトリの github.com/HarnessRouter/harnessrouter から取得しています。これらは 0.5.5 の README に記載されていました。現在、セットアップの詳細は同じリポジトリの docs/self-hosting-guide.md にあります。

Unified Harness Protocol の実態

HarnessRouter は、unifiedharnessprotocol.org で公開されている Unified Harness Protocol (UHP) を実装しています。UHP は、製品が harness 上でタスクを開始し、実行中のタスクを追跡し、セッションとファイルを管理し、失敗を報告する方法を定義します。仕様は日付でバージョン管理されます。2026年8月19日時点で有効だったバージョンの日付は 2026-08-11 でした。2026年11月8日時点では、サイトに現行バージョンとして 2026-10-19 が掲載されており、引き続き「安全に変更できるようバージョン管理された、構築の基盤として十分に安定したドラフト標準」と説明されています。

ここでいう「オープン標準」という表現は、注意して読む必要があります。同じ企業が仕様、リファレンス実装、適合性を判定するコンフォーマンススイートを作成しており、プロジェクトのガバナンス規則では、この3つを同時に変更しない限り変更を取り込めないと定めています。2026年11月9日時点で、プロトコルのホームページはこのスイートを実行可能なチェック 110 件と説明しています。一方、コンフォーマンスページには 101 件と記載され、2026年9月4日付けのセルフホスティングガイドに記録されたリファレンス実行では 64 件が成功しています。このため、公開されている件数は一致していません。プロジェクトの変更履歴によると、分岐に関する追加チェック 6 件は 2026年11月4日付けで追加されました。これは、このように登場して間もないプロトコルでは通常のことです。また、Apache-2.0 ライセンスにより、構成要素のどの部分でも fork できます。ただし、UHP はまだ複数ベンダーによる標準ではありません。発展途上のプロトコルとして扱ってください。便利で変化が続いている一方、独自コードを書き換えずに使用を停止できるようにしておくべきものです。

開始前に必要なもの

Docker と、約 4 GB の空きディスク容量が必要です。すでに契約しているモデルプロバイダーの API key も必要です。イメージの pull には約 700 MB を使用し、残りのディスク容量は agent CLI と、それらが書き込む workspace に使用します。イメージにはモデルも trial key も含まれていないため、プロバイダーを接続するまでタスクは失敗します。HarnessRouter 自体のライセンスは Apache-2.0 です。agent CLI にはそれぞれ独自のライセンスと利用規約が適用され、リポジトリのライセンスによって置き換えられることはありません。agent CLI はイメージに同梱されず、初回起動時に取得されます。

Docker run 1 回で HarnessRouter をセルフホストする

docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter \
  -p 127.0.0.1:3000:3000 \
  -v harnessrouter:/data \
  harnessrouter/harnessrouter

次に、コンテナが起動するまで監視します。初回の起動は遅く、理由はログに出力されます。

docker logs -f harnessrouter

正常に動作している間、次のような行が表示されます。

installing Claude Code (Anthropic's terms apply)…
installing Codex (Apache-2.0)…
installing Hermes (check its upstream license before use)…

ready on :3000 を待ちます。現在のガイドでは、docker run がプロンプトを返してからおよそ 30 秒かかります。この時間はその行が表示されてからではありません。ready 行の直後に http://localhost:3000 が応答しない場合は、数秒待ってから再試行してください。インストール済みの CLI はボリュームにキャッシュされるため、以降の起動は通常、はるかに速くなります。ただし、後から追加したバックエンドや、以前のインストールに失敗したバックエンドでは、インストール処理が再度実行されることがあります。

このダウンロードから、VPS では重要な点が 2 つ分かります。1 つ目は、初回起動に外向きのネットワークアクセスが必要なことです。イメージは自己完結していないため、外向き通信をフィルタリングしている環境や、外部への経路がないホストでは agent CLI を取得できません。0.5.5 と現在のリリースはいずれも、インストール失敗を致命的エラーとして扱わず、ログに記録します。そのため、backends available: 行に含まれていないバックエンドを確認してください。2 つ目は、第三者の利用条件に従うソフトウェアをインストールすることです。Claude Code は Anthropic の利用条件に従い、Hermes は上流プロジェクトの利用条件に従います。商用利用の前に、両方を確認してください。

-v harnessrouter:/data は名前付きの Docker ボリュームを作成します。永続データはすべて /data に保存されます。SQLite データベース、保存ファイル、secret store、agent workspace が含まれます。このボリュームを削除すると、provider key とすべての transcript を含め、インスタンス全体が削除されます。バックアップはコンテナを停止してから実行してください。書き込み中の SQLite データベースをコピーすると、そのファイルを開けなくなる可能性があります。同じ停止後コピーの手順は、ホスト上のすべてのステートフルコンテナに適用します。ただし、詳細はサービスごとに異なります。PhotoPrism と Immich には、それぞれ専用のバックアップコマンドが必要です。

docker stop harnessrouter
docker run --rm -v harnessrouter:/data -v "$PWD":/backup alpine \
  tar czf /backup/harnessrouter-data.tgz -C / data
docker start harnessrouter

Compose 版と変更が必要な行

リポジトリには compose ファイルが含まれています。現在は "127.0.0.1:3000:3000" を公開し、ホスト側のポートを loopback にバインドします。0.5.5 ファイルでは "3000:3000" を公開していました。古いファイルをパブリックサーバーで使用する場合は、その行を変更してください。

services:
  harnessrouter:
    image: harnessrouter/harnessrouter:0.5.5
    ports:
      - "127.0.0.1:3000:3000"
    env_file:
      - .env
    volumes:
      - harnessrouter-data:/data
    restart: unless-stopped

volumes:
  harnessrouter-data:

現在の upstream とは、latest ではなく固定したバージョンタグを使用している点が異なります。リリースは短期間で変わるため、バージョンを固定することが重要です。2026 年 11 月 8 日に確認した時点では、Docker Hub には 0.38.4 と 0.38.5 の両方が過去 1 日以内に push されたものとして表示されていました。動作中にエージェントの実行環境が変わると、デバッグが困難になります。このページから 0.5.5 をコピーするのではなく、現在のリリースを固定してください。2026 年 11 月 9 日時点では、それは 0.40.0 でした。その後、環境ファイルをコピーし、権限を固定して起動します。

cp .env.example .env
chmod 600 .env
docker compose up -d
docker compose logs -f

.env にはプロバイダーの key が平文で保存されるため、mode 600 が最低限必要です。docker compose subcommand に不慣れな場合は、Docker Compose コマンド早見表で日常的に使用する verb を確認できます。

ポートを 0.0.0.0 ではなく 127.0.0.1 で公開する理由

-p 3000:3000 は、デフォルトでホストのすべてのインターフェースにポートを公開します。-p 127.0.0.1:3000:3000 は、ホストポートを loopback に公開します。28.0.0 より前の Docker では、同じ L2 セグメント上のホストから localhost に公開したポートへ接続できる場合があります。また、明示的に有効化した直接ルーティングによって、ホスト側のマッピングが loopback であってもコンテナポートが外部に公開されることがあります。コンテナはデフォルトで内部の 3000 番ポートを待ち受けます。このポートは PORT で変更できます。そのため、ホスト側ポートの競合を避けるには、左側のポート番号を変更します。実際の状態を確認します。

docker port harnessrouter
sudo ss -ltnp | grep 3000

ss に 127.0.0.1:3000 が表示されるのは正しい状態です。0.0.0.0:3000 は、コンソールがすべての IPv4 インターフェースで待ち受けていることを示します。インターネットからアクセスできるかどうかは、ルーティングとフィルタリングにも左右されます。ここでは、一般的なセルフホストアプリケーションよりも危険です。コンソールは harness を作成し、すべての transcript を読み取り、agent を実行します。さらに、agent に workspace 内の shell と実ファイルシステムへのアクセスを与えます。接続に使用した provider key も保持しています。保護されていないコンソールに到達できる者は、作業内容を読み取り、コマンドを実行し、key を使って費用を発生させられます。

ufw の deny ルールだけでは、この問題を防げません。Docker は、ufw が管理する chain に到達する前に、公開されたコンテナトラフィックを独自のルールへ迂回させます。そのため、sudo ufw status でポートが denied と表示されても、公開ポートがブロックされているとは判断できません。VPS からではなく、別のマシンからテストしてください。VPS から実行すると、正しい検証になりません。これは port 3080 で dsh をヘッドレス実行する場合と同じ教訓です。サービスを loopback に bind し、その後でアクセス方法を意図的に決めます。

最初に、デフォルトのログイン情報を変更する

http://localhost:3000 にユーザー名 harnessrouter と、インスタンスが生成した初期パスワードでサインインします。次のコマンドで確認できます。

docker exec harnessrouter cat /data/selfhost-initial-password

共有パスワード harnessrouter は 0.5.5 で機能しましたが、現在のインストールでは公開されていたデフォルト値を受け付けません。

Profile ページで変更するか、スクリプトによるデプロイの開始時に設定します。HR_AUTH_USER と HR_AUTH_PASSWORD で初期認証情報を指定できます。Profile で保存した認証情報が優先されます。

docker run -d --name harnessrouter \
  -p 127.0.0.1:3000:3000 \
  -v harnessrouter:/data \
  -e HR_AUTH_USER='you' \
  -e HR_AUTH_PASSWORD='the-password-you-chose' \
  harnessrouter/harnessrouter

ローカルの Console ログインには、パスワードリセット用のメール機能がありません。パスワードを失った場合は、ボリューム内の auth ファイルを削除して再起動します。その後、設定した HR_AUTH_USER と HR_AUTH_PASSWORD でサインインします。独自の値を指定していない場合は、生成された初期パスワードを使用します。

docker stop harnessrouter
docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json
docker start harnessrouter

HR_AUTH_DISABLED=1 を設定すると、サインインによる保護が完全に無効になります。セルフホスティングガイドでは、これは「他の誰も到達できないマシンでのみ合理的」と説明されています。パブリック IP アドレスを持つ VPS はそのようなマシンではありません。そのため、ラップトップで実行する場合を除き、保護を有効にしてください。

バージョンを確認する。古いバージョンには認証ゲートがない

ここは軽視しないでください。0.1.x と 0.2.0 には認証ゲートがまったくありません。ポート 3000 に接続できる人は、すでにコンソールへ入れる状態でした。0.3.0 がログイン機能を備えた最初のリリースです。このページでは、これらの古いタグが公開済みで pull 可能だったことを 2026 年 10 月 12 日に最後に記録しました。2026 年 11 月 8 日時点で利用可能かどうかは確認していません。

2026 年 8 月 19 日時点で、公開済みの最新タグは 0.5.5 でした。日付は 2026 年 8 月 18 日です。2026 年 11 月 8 日時点で、latest は 0.38.5 を指していました。現在のバージョンを確認し、Docker Hub のタグ一覧と比較してください。

docker image ls harnessrouter/harnessrouter

0.3.0 より前のバージョンは、延期せずに直ちに置き換えてください。共有されたデフォルトパスワードを使用する古いリリースでは、パスワードも変更する必要があります。現在のインストールでは初期パスワードが生成され、自分でパスワードを選択するよう求められます。このページに記載されたバージョン番号を現行のものとして扱わないでください。これらは記載された日付時点では正しいものでしたが、このプロジェクトは短い間隔でリリースされます。

プロバイダーを接続する

モデルプロバイダーを接続するまで、何も実行されません。アカウントメニューの Bring your own key から追加するか、環境変数の docker run に渡します。値は JSON なので、シェルでは引用符で囲みます。

-e HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC='{"name":"anthropic","provider":"anthropic","api_key":"sk-ant-…"}'

.env.example は、プロバイダーのファミリーごとに接続変数を指定します。HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC は claude-code バックエンド用、HR_SECRET_GLOBAL_HARNESS_CONN_OPENAI は codex バックエンド用、HR_SECRET_GLOBAL_HARNESS_CONN_GOOGLE は gemini バックエンド用、HR_SECRET_GLOBAL_HARNESS_CONN_CUSTOM は OpenAI 互換エンドポイント用です。最後の接続先には、アグリゲーターや独自の推論サーバーを指定します。対応する HR_SECRET_GLOBAL_HARNESS_POLICY_CLAUDE、HR_SECRET_GLOBAL_HARNESS_POLICY_CODEX、HR_SECRET_GLOBAL_HARNESS_POLICY_HERMES 変数では、各バックエンドがデフォルトで使用する接続を指定します。また、バックエンドごとにポリシー変数が 1 つあります。HR_SECRET_KEY は別の項目です。現在のリリースでは、保存された認証情報をこの変数の下で暗号化します。値を指定しない場合は、/data/secret-key にキーを生成します。再起動やアップグレード後も同じキーを使用してください。既存のインスタンスのデータとキーを分離するには、HR_SECRET_KEY にそのファイル内の値を設定してから、ファイルを削除します。

HR_BACKENDS では、HR_BACKENDS=claude,codex,hermes のようにインストールして読み込むバックエンドを選択します。未設定の場合、現在のリリースでは、claude、codex、hermes から opencode、gemini、goose などまで、30 個のバックエンドからなる長いデフォルトリストをインストールします。そのため、リストを絞るとディスク使用量と初回起動時間を削減できます。現在のセルフホスティングガイドでは、「使用しないものは HR_BACKENDS から除外する」よう説明しており、そのガイドにある軽量な例は HR_BACKENDS=opencode です。この例では Hermes を完全に除外しています。あるバックエンドのインストールに失敗しても、致命的なエラーにはなりません。他のバックエンドは引き続き動作し、インストールされなかったバックエンドでタスクを実行すると「not installed」として拒否されます。また、コンテナのログには失敗したインストールが記録されます。0.5.5 README には、hermes を除外するとコンテナがステータス 1 でエラーメッセージなしに直ちに終了する既知の問題が記載されていました。しかし、そのタグの entrypoint ではすでにこの問題が修正されています。README のコメントは以前の実装について説明したものです。使用したい harness が Hermes だけなら、Hermes agent を独自の VPS で実行するほうが小規模な構成です。

コンソールを使わずに API を呼び出す

コンソールは任意です。同じ API が両方に対応し、Responses 形式の契約を使用します。まずサインインしてセッション Cookie を取得します。

curl -c hr.cookies http://localhost:3000/api/selfhost/login \
  -H 'content-type: application/json' \
  -d '{"username":"harnessrouter","password":"your-password"}'

次にタスクを送信します。metadata.harness_id で harness を指定し、接続しているプロバイダーが実際に提供しているモデルを指定します。

curl -s -b hr.cookies http://localhost:3000/api/harness/v1/responses \
  -H 'content-type: application/json' \
  -d '{"input":"Reply with exactly this and nothing else: it works.",
       "metadata":{"harness_id":"codex"},
       "model":"gpt-5.4-mini",
       "stream":false}'

出力ブロックとトークン数を含む JSON オブジェクトが返れば、harness は実行されています。harness_id を codex から claude-code に変更すると、同じリクエストが別の harness に送信されます。この切り替えが、このソフトウェアの存在理由そのものです。id は claude-code である点に注意してください。バックエンド名は HR_BACKENDS、ポリシー変数は claude です。上記のカスタム接続を使うと、すでにホストしている OpenAI 互換エンドポイントを harness に指定できます。これは、VPS 上の自己ホスト型 DeepSeek harness を接続する方法でもあります。

セッション Cookie を使うフローは、ローカルデバッグ用に引き続きサポートされています。製品バックエンドでは、現在のドキュメントは API Keys で HarnessRouter API key を作成し、Console セッションを維持する代わりに Bearer token として送信する方法を推奨しています。

ノート PC からポートを公開せずにアクセスする

方法は 2 つあり、どちらも 0.0.0.0 上でポートを直接公開しません。

SSH トンネルが最も手軽で、サーバーに追加のソフトウェアをインストールする必要がありません。手元のマシンのローカルポートを VPS のループバックインターフェースへ転送します。

ssh -N -L 3000:127.0.0.1:3000 you@your-vps

この状態を維持したまま、ブラウザーで http://localhost:3000 を開きます。SSH が bind: Address already in use と出力する場合、ノート PC 上ですでに別のプロセスがポート 3000 を使用しています。その場合は -L 3100:127.0.0.1:3000 で別のローカルポートを指定し、ポート 3100 にアクセスします。

TLS 終端を担うリバースプロキシは、他のユーザーもアクセスする必要がある場合に適しています。プロキシが TLS (transport layer security) 証明書を保持し、ループバックインターフェースへ転送します。セルフホスティングガイドでは、Caddy の設定例として次を示しています。

console.example.com {
    encode zstd gzip
    reverse_proxy 127.0.0.1:3000 {
        flush_interval -1      # agent turns stream for minutes; never buffer them
    }
}

flush_interval -1 は Caddy のレスポンスバッファリングを明示的に無効化します。Caddy はこれがなくても text/event-stream のレスポンスを即座にフラッシュします。Agent は数分にわたってストリームのトークンを返します。プロキシがレスポンスをバッファリングすると、ターンが終了するまでトークンが保持されるため、コンソールはフリーズしたように見え、その後すべてを一度に出力します。Nginx での同等の設定は、location ブロック内の proxy_buffering off; です。どちらを選ぶ場合も、DNS 名はプロキシを指し、コンテナはループバックインターフェースで待ち受ける構成にします。リバースプロキシとしての Nginx、Caddy、Traefik の比較では、環境に適した製品を比較しています。

専用ユーザーで実行し、root では実行しない

Docker daemon は root として実行されます。docker グループのメンバーになることは root 権限を持つことと同じです。メンバーはホストのファイルシステムをマウントしたコンテナを起動できるためです。そのため、「チームを docker グループに追加する」と、provider key を保持するホスト上の root 権限を配布することになります。

簡単な方法は、compose file と .env を所有する service account を作成し、それらのファイルを共有ホームディレクトリの外に置くことです。

sudo adduser --disabled-password --gecos "" harness
sudo install -d -o harness -g harness -m 750 /srv/harnessrouter

--user を docker run に追加したり、user: を compose file に追加したりして、この状態を実現しようとしてはいけません。現在の guide では、コンテナは root として起動する必要があります。0.8.2 以降は、それ以外の方法で起動しようとすると起動を拒否し、ログにその旨を示す 1 行を出力します。

より強固な方法は rootless Docker です。この方式では daemon 自体が、その非特権ユーザーとして実行されます。newuidmap と newgidmap 用の uidmap package が必要です。また、そのユーザーには /etc/subuid と /etc/subgid に少なくとも 65536 個の subordinate UID が必要です。uidmap は Ubuntu archive にありますが、docker-ce-rootless-extras はありません。docker-ce-rootless-extras は Docker engine のインストール時に追加される、download.docker.com の Docker 独自の apt repository から提供されます。その repository から engine をインストールしていない場合、grep -rl download.docker.com /etc/apt/sources.list.d/ は何も出力せず、以下のインストールで package が見つかりません。

sudo apt install -y uidmap docker-ce-rootless-extras
sudo loginctl enable-linger harness
sudo -iu harness
dockerd-rootless-setuptool.sh install
export DOCKER_HOST=unix:///run/user/$(id -u)/docker.sock
systemctl --user enable --now docker

loginctl enable-linger は、ログアウト後もユーザーの systemd instance を実行し続け、boot 時に起動します。docker info で結果を確認してください。Security Options の下に rootless が表示されます。rootless mode では、追加設定なしに 1024 未満のポートを bind できません。ただし、ここでは port 3000 がその範囲を超えているため問題ありません。アカウント自体の設定については、VPS で最小権限のユーザーを作成するで説明しています。

何が壊れ、何が表示されるか

コンテナが起動の 1 秒後に終了し、ログが空です。 docker ps -a は Exited (1) を示します。HR_BACKENDS から hermes が省略されていたため、以前の entrypoint は失敗しましたが、0.5.5 にはすでに修正が含まれています。ただし、README にはまだこの問題が記載されています。終了ステータスだけでこの失敗を判断しないでください。最近の tag では docker logs の末尾の行を確認します。0.8.2 から --user で起動したコンテナは、root として起動する必要があるという 1 行を出力して終了します。

最初の起動が完了しません。 ログは installing の行の後で止まり、ready on :3000 は表示されません。agent CLI はイメージに含まれていないため、box からネットワークに接続して取得できるか確認します。0.5.5 と現行リリースは、完了したものの失敗したインストールを許容します。失敗したインストールをログに記録し、backends available: の行から除外します。外向きのルートまたは proxy 設定を修正してから、再起動します。

コンソールは読み込まれますが、すべてのタスクが失敗します。 provider が接続されていません。イメージにはモデルが同梱されておらず、無料 tier も含まれていないため、新しい instance でサインインできても何も実行できません。

proxy の背後でコンソールが回答の途中で停止します。 turn が終了すると、出力が 1 つのブロックとして表示されます。これは response buffering です。Caddy では flush_interval -1 を、Nginx では proxy_buffering off; を設定します。

トンネルは起動していますが、laptop から接続できません。 サーバー上で docker port harnessrouter を実行します。何も出力されない場合、コンテナは何も公開していません。ポートマッピングと network mode を確認します。

実行する価値はありますか?

複数の harness を実際に使っていて、それぞれ 3 つずつ用意する代わりに、1 つのエンドポイントと 1 つの認証情報ストアにまとめたい場合は、実行する価値があります。また、その上に製品を構築し、harness をコードの書き換えではなく設定値として扱いたい場合も適しています。これが UHP で得られる利点です。ただし、前述のとおり、このプロトコルはまだ新しい点に注意してください。

harness を 1 つしか使わない場合は、実行する価値はありません。サーバーにその CLI をインストールするほうが構成要素が少なく、ログインを介さずに利用できます。また、1 つのタスクで複数の agent を連携させたい場合にも適した構成ではありません。その場合は別のツールが必要です。このパターンについては、Omnigent などのマルチエージェント harnessを参照してください。いずれの場合も、デプロイの原則は変わりません。loopback に bind し、パスワードを変更し、現在のリリースを固定し、専用の user を用意します。

FAQ

HarnessRouter を port 3000 で公開しても安全ですか?

いいえ。コンソールでは harness の作成、すべての transcript の読み取り、shell および filesystem へのアクセス権を持つ agent の実行、接続した provider key の保持が可能です。そのため、保護されていないコンソールを公開すると、これらすべてが外部に露出します。-p 127.0.0.1:3000:3000 で loopback 上に公開し、SSH tunnel または TLS 終端を担う reverse proxy 経由でアクセスしてください。ufw の deny ルールだけでは不十分です。Docker は公開された container の traffic を、ufw が管理する chain より前に振り替えるためです。sudo ss -ltnp | grep 3000 で確認し、127.0.0.1:3000 と表示されることを確認してから、別のマシンからアクセスをテストしてください。古い same-L2 localhost exposure を避けるため、Docker 28.0.0 以降を使用し、direct routing が有効になっていないことも確認してください。

ログインゲートが追加された HarnessRouter のバージョンはどれですか?

0.3.0 です。0.1.x と 0.2.0 には認証機能がまったくないため、これらを実行する場合は、誰も port を見つけないことに頼ることになります。このページでは、これらの tag が公開済みで pull 可能だったことを 2026 年 10 月 12 日に最後に記録しています。2026 年 11 月 8 日時点で利用可能かどうかは確認していません。2026 年 8 月 19 日時点の最新 tag は 0.5.5 で、日付は 2026 年 8 月 18 日でした。2026 年 11 月 8 日には、latest は 0.38.5 を指していました。docker image ls harnessrouter/harnessrouter を実行して現在の状態を確認し、このページではなく Docker Hub の tag 一覧と比較して、自分で password を選択してください。現在の installation では、以前の共有 default を受け入れず、初期 password を生成します。

HR_BACKENDS を設定した直後に container が終了するのはなぜですか?

現在の release では、そのような動作はしないはずです。self-hosting guide では、使用しない backend は省略するよう説明しています。また、backend の install に失敗しても致命的なエラーにはなりません。以前の実装では、hermes を省略すると、エラーメッセージを表示せず status 1 で終了していました。しかし、0.5.5 の source ではすでにこの問題が修正されています。README にはまだこの問題の記載が残っています。最近の tag では docker logs を確認してください。0.8.2 以降では、--user で起動した container は、「root として起動する必要がある」という 1 行を表示して終了します。

HarnessRouter は初回起動時に internet access が必要ですか?

はい。agent CLI は image に含まれず、初回起動時に取得されます。また、それぞれの CLI は個別の license と利用規約の対象です。0.5.5 と現在の release は、どちらも install の失敗を log に記録し、ほかの backend の起動を継続します。install 済みの CLI は volume に cache されるため、2 回目以降の起動は通常速くなります。ただし、backend tool と実行する task では引き続き network access が必要になる場合があります。また、新しい backend や以前に失敗した backend では、再度 install が実行されることがあります。

コンソールの password を失いました。どうすれば再びログインできますか?

local Console login には reset email がありません。container を停止し、volume から /data/selfhost-auth.json を削除してから、再度起動してください。その後、設定済みの HR_AUTH_USER と HR_AUTH_PASSWORD、または自分で指定していない場合は生成された初期 password でログインし、Profile ページから新しい password を設定します。container と volume の名前がどちらも harnessrouter の場合は、docker stop harnessrouter、docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json、docker start harnessrouter の順に実行します。生成された password は docker exec harnessrouter cat /data/selfhost-initial-password で確認できます。

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