VPSのDSH Web UIをラップトップで開く方法
DSH Web UIは127.0.0.1:3080で待ち受けるため、VPSが表示したURLはラップトップで開けません。SSHポート転送など安全な3つの接続方法と、避けるべき方法を説明します。
DSH Web UI がラップトップから開けない理由
DSH Web UI は loopback インターフェースに bind するため、ターミナルに表示された URL は、その URL を表示したマシン上でしか機能しません。npx @deepseek-ai/dsh web は http://127.0.0.1:3080/?token=... 形式の起動 URL を表示します。127.0.0.1 は、そのアドレスを読み取るコンピューターにとって「そのコンピューター自身」を意味します。ラップトップでその URL を開くと、ラップトップ自身の loopback インターフェースが参照され、そこで待ち受けているものは見つかりません。アドレス自体が分かりにくい場合は、dsh がそもそも http://127.0.0.1:3080 を表示する理由で詳しく説明しています。DSH の bind 先は変更しないでください。ラップトップから VPS の loopback アドレスへ、認証済みの経路を構築します。
loopback をデフォルトにする設定は正しく、このページのすべての方法で維持します。port 3080 の背後にあるのは、サーバー上で shell コマンドを実行する agent です。Web UI には login page がありません。DSH は現在、launch token で browser を認証します。プロセスを起動するたびに新しい token が発行され、表示された URL にその token が含まれます。最初のアクセス時に token が session cookie と交換されます。この token は URL に含まれる単一の bearer credential です。そのため、最も重要な防御層は依然として loopback です。socket への直接接続は、SSH または proxy によって転送された接続を含め、VPS から開始する必要があります。
DSH が待ち受けるアドレスと、自分の環境での確認方法
2026 年 11 月 4 日時点の DeepSeek Harness README には、npx @deepseek-ai/dsh web「デフォルトでは Web UI を http://127.0.0.1:3080 で起動する」と記載されています。同じリポジトリの CLI リファレンスでは、デフォルトのポートは 3080 のままであり、--host は「ワイルドカードではなく、具体的なローカルアドレスを 1 つ指定する必要がある」と説明されています。また、--host 0.0.0.0 は usage error で終了します。DSH は developer preview であり、README では互換性を壊す変更が行われると大文字で警告しています。どのページであっても内容をそのまま信頼せず、自分の環境で両方の値を確認してください。
dsh --profile web --dump-config
ss -ltnp | grep 3080--dump-config は agent を起動せずに合成済みの設定ツリーを出力します。ただし、式は評価されず、アプリの引数も解決されません。そのため、実行時に最終的に使用されるホストとポートのダンプではありません。ss では、現在実際に待ち受けているものを確認できます。正常な行は次のようになります。
LISTEN 0 511 127.0.0.1:3080 0.0.0.0:* users:(("node",pid=8123,fd=24))確認するのは、接続先アドレスではなくローカルの待ち受けアドレスです。127.0.0.1:3080 は loopback 専用であり、これが望ましい状態です。127/8、::1、およびそれらの loopback へのマッピング形式に表示される他のアドレスも、DSH をローカルに限定します。非 loopback アドレスでは、そのアドレスが属するネットワークにサービスを提供します。公開アドレスの場合もあります。ss が 1 行も出力しない場合、ポート 3080 で待ち受けているものはありません。トンネルを設定する前に、DSH が停止したのか、別のポートを使用しているのかを確認してください。ここまでの手順は、VPS への DeepSeek Harness のインストールと実行で説明しています。
フラグの設定は 1 回の実行にだけ適用されます。値を維持するには、代わりに profile の patch layer を編集してください。dsh --profile <name> は $DSH_HOME/profiles/<name> で profile を起動します。layer は、bundle patch、profile 自身の cordis.patch.yml、home-level の $DSH_HOME/cordis.patch.yml、最後に任意の --patch overlay の順で積み重なります。待ち受け設定は @deepseek-ai/dsh-host-webserver plugin の host と port にあります。編集する前に --dump-config で自分の合成済みツリーを確認してください。初回起動時に web profile は同梱テンプレートから自動生成され、preview の更新に伴ってテンプレートの構造も変わり続けているためです。
起動時の行には、credential の取得に必要な情報も含まれます。DSH は process token を token query に含めた root URL を出力します。ブラウザーから送信できるのは GET /?token=... としてだけであり、Authorization header に含めることはできません。API caller 向けには別の GET /connect?token=... exchange がありますが、ブラウザーでは使用しません。root request は署名付きで host-only の HttpOnly、SameSite=Strict cookie を設定し、クリーンな URL へリダイレクトします。プロセスを起動するたびに新しい token が発行されます。cookie の有効期限はデフォルトで 30 日で、cookieMaxAgeDays により設定されます。document または API へのリクエストに有効な credential がない場合は 401 が返されますが、静的アセットは公開されたままです。出力された URL は token を含めて全体をコピーしてください。以下のすべての方法では、最後にその URL を開くためです。
第 2 の関門: /api の信頼境界
ポート 3080 までパケットを到達させることは、問題の半分にすぎません。DSH にはもう 1 つのチェックがあり、ページは読み込まれ、レイアウトも表示されるのに、その後何も動作しないという分かりにくい障害が発生します。
@deepseek-ai/dsh-client-connection plugin は trustedHosts 設定を保持しています。README によると、Host header は loopback、listener 自身がいずれかのポートで bind しているアドレス、または trustedHosts entry に一致する値でなければなりません。また、ブラウザーが Origin header を送信する場合は、同じ authority を指定する必要があります。この境界チェックはすべてのリクエストで認証前に実行され、条件を満たさない /api request を拒否します。ブラウザーには次のように表示されます。
transport failure for /api/host.describe: HTTP 403したがって、DSH の前段に置くプロキシでは、ブラウザーに入力される名前を指定する必要があります。CLI では --trusted-host <authority> を指定します。このオプションは複数回指定できます。
dsh web --trusted-host dsh.example.comこの境界チェックは authority、つまり host と port の組み合わせに対して照合を行い、listener の scheme におけるデフォルトポートを正規化します。dsh.example.com のようにポートを省略した entry は、その名前を任意のポートで照合するため、dsh.example.com:8443 も対象になります。dsh.example.com:8443 のようにポートを含む entry は、その host と port の組み合わせだけに一致します。loopback には entry が不要なため、localhost:3080 と 127.0.0.1:3080 はどちらも通過します。原因を説明できない 403 は、ほぼ常に URL バーの名前と trusted list の名前が異なることが原因です。401 は別の問題です。境界チェックは通過していますが、その authority に対する有効な session cookie がブラウザーにありません。
この境界チェックは origin check です。認証ではありません。ブラウザー自体が Host header の設定を禁止しているため、別のサイトにあるページが agent を操作することは防げます。ただし、ブラウザー以外の client はその header を自由に書き込めます。trustedHosts はプロキシとの互換性設定およびブラウザーからのリクエスト防御として扱い、認証やポートへの到達元を制限する機能とは考えないでください。
選択肢 1: SSH のローカルフォワード
これは最初に試してください。サーバー側に何も追加しないためです。
ssh -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vps-L はラップトップ上でリスナーを開き、各接続を VPS 上で解決された 127.0.0.1:3080 へ転送します。-N は「リモートコマンドを実行しない」という意味です。そのため、セッションにはフォワードだけが含まれます。ローカル側を単なる 3080 ではなく 127.0.0.1:3080 と記述するのには意図があります。ラップトップ側のリスナーを loopback に固定するため、SSH クライアント設定の GatewayPorts によって、エージェントが接続中のネットワークへ意図せず再公開されることを防げます。
DSH が表示した起動 URL を、token を含めてラップトップのブラウザーで開きます。フォワードは 127.0.0.1:3080 で待ち受けるため、表示された http://127.0.0.1:3080/?token=... はそのまま使用できます。新しいブラウザーセッションでは、単なる http://localhost:3080 だけでは不十分です。cookie がない場合、DSH は 401 を返します。初回アクセス後は cookie によって認証状態が維持されますが、その cookie は host-only です。最初に開いた名前を使い続けてください。127.0.0.1 用に設定された cookie は localhost には送信されないためです。Host ヘッダーは loopback の authority なので、/api の制限は設定なしで通過します。現在の DSH UUID 実装では crypto.getRandomValues() を使用するため、secure context でのみ利用できる crypto.randomUUID() に依存せず起動できます。
-f を追加すると、認証完了後に ssh がバックグラウンドへ移行します。
ssh -f -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vpsこの方法の実際のトレードオフを説明します。公開アドレスで新たに待ち受けるものはなく、ファイアウォールルールも変更しないため、公開範囲の増加を最小限に抑えられます。アクセス制御はすべて SSH 設定に依存します。そのため、パスワードログインを無効にした鍵認証のみの SSH は、あると便利な追加設定ではなく前提条件です。代わりに、トンネルは 1 つのクライアントセッションに属します。ラップトップがスリープすると切断され、手動で再起動する必要があります。また、スマートフォンからは利用できません。
VPS で Tailscale serve を使用する
Tailscale は、自分のデバイス間にプライベートネットワークを構築します。VPS にインストールすると、そのマシンに Tailscale 経由で到達できる 100.x.y.z アドレスが割り当てられ、どのデバイスからの接続を許可するかはアクセス制御ポリシーで決まります。マシンを共有すると、そのアクセスを外部ユーザーのデバイスにも拡張できます。
そのネットワークに参加するだけでは不十分です。ここでつまずく人が多くいます。DSH は loopback で待ち受けているため、100.x.y.z アドレスでは待ち受けていません。ブラウザーで http://100.x.y.z:3080 にアクセスすると、そのアドレスにソケットがバインドされていないため、接続拒否になります。--host はその具体的なアドレスでも待ち受けますが、TLS を設定しない場合、loopback 以外へのバインドでは平文 HTTP が提供されます。DSH は起動時に loopback 以外への HTTP バインドについて警告しますが、ここで使用する loopback リスナーではその警告は出ません。現在の UUID 実装はセキュアコンテキストなしで動作しますが、平文 HTTP を使用すると、その HTTP 経路上で起動トークンと Cookie が露出します。
tailscale serve がこの 2 つを接続します。VPS 上で動作し、プライベートネットワークからのトラフィックを受け付けて、ローカルアドレスへプロキシします。
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
sudo tailscale serve --bg --https=443 localhost:3080
tailscale serve statustailscale serve status は、https://<machine>.<tailnet>.ts.net/ の形式で URL を出力します。その名前を信頼する設定で DSH を起動してください。そうしない場合、上記の説明どおり /api は 403 を返します。
dsh web --public-url https://your-vps.your-tailnet.ts.net/ --trusted-host your-vps.your-tailnet.ts.net--public-url は、出力および開かれる起動 URL である DSH_WEB_URL と、エージェントのランタイムコンテキスト内の Web GUI URL を設定します。そのため、起動 URL は tailnet 名で生成され、スマートフォン上でもそのまま開けます。これだけではアクセスを許可しないため、--trusted-host は引き続き必要です。出力される URL には有効な認証情報が含まれるため、自分のデバイスにだけ貼り付けてください。
Tailscale は、その名前用に発行された証明書で実際の HTTPS を終端し、ブラウザーと VPS の間で起動トークンとセッション Cookie を保護します。サービスはパブリックインターネットには公開されません。serve は、マシン共有によって許可されたアクセスを含め、Tailscale のトラフィックを受け付けます。
ここで tailscale funnel に置き換えないでください。これは同じコマンドファミリーに属しますが、パブリックインターネット向けのコマンドです。誰でも名前解決できるホスト名上に、shell access を持つエージェントを公開することになります。どちらかを入力する前に、serve が tailnet 内にトラフィックをとどめ、funnel が公開する仕組みを読んでください。この構成全体をスマートフォン向けにした方法については、スマートフォンから自己ホストのエージェントに接続する方法を参照してください。
この方法には依存関係があります。UI を必要とするすべてのデバイスで、tailnet またはマシン共有を通じて VPS にアクセスできる Tailscale を使用する必要があります。また、自分で運用していない coordination server がネットワークのメンバーシップを管理します。これが受け入れられない場合は、自己ホストの Headscale control server を使用できます。これは、自分が所有するハードウェア上で同じプロトコルを処理します。
認証付き TLS リバースプロキシ
ブラウザーからプライベートネットワークに参加できない場合に使用します。たとえば、自分で管理していないマシンが該当します。ここではホスト名をインターネットに公開するため、認証は実際に機能するものでなければならず、プロキシが認証を行う必要があります。DSH の launch token は URL に含まれる bearer credential であり、保持している全員が共有するため、この認証層にはなりません。
TLS は transport layer security の略で、https:// の基盤となる暗号化です。nginx を loopback ポートに向け、その前段にパスワードを設定します。map ブロックは http コンテキストに置くため、/etc/nginx/conf.d/ 配下に専用ファイルを作成します。
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}次に、サイト本体を設定します。
server {
listen 443 ssl;
server_name dsh.example.com;
ssl_certificate /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;
auth_basic "dsh";
auth_basic_user_file /etc/nginx/dsh.htpasswd;
location / {
proxy_pass http://127.0.0.1:3080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cookie_flags ~ secure;
proxy_read_timeout 3600s;
proxy_buffering off;
}
}パスワードファイルを作成し、設定をテストしてから reload します。
sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginxnginx -t は syntax is ok と test is successful を出力します。代わりにエラーが出力された場合、nginx は古い設定を提供し続けるため、まだ動作は壊れていません。次に、公開名を信頼する設定で DSH を起動します。proxy_set_header Host $host は dsh.example.com を転送し、そうしないと fence が拒否するためです。--public-url により、表示される launch URL にその名前が使われるため、URL を直接開けます。
dsh web --public-url https://dsh.example.com/ --trusted-host dsh.example.comこの設定で特に重要なのは 3 つの directive です。Upgrade ヘッダーと Connection ヘッダーにより、UI は WebSocket 接続を確立できます。これらがないと upgrade に失敗します。proxy_read_timeout 3600s は upstream の読み取り間隔の許容値を、デフォルトの 60 秒から 1 時間に延長します。これは agent の実行全体に対する制限ではありません。proxy_cookie_flags ~ secure は DSH のセッション cookie Secure に HTTPS 経由で送信する属性を付けます。DSH の公開 deployment guide ではプロキシにこの設定を行うよう求めています。HTTP のみの backend では、この属性なしで cookie が発行されるためです。DSH 自体も --tls-cert と --tls-key により HTTPS を提供できますが、証明書の取得や更新は行わず、パスワードも追加しません。そのため、ここでプロキシの代わりにはなりません。その他の設定理由については、nginx のリバースプロキシ設定を directive ごとに解説した記事を参照してください。プロキシ自体の選択については、nginx、Caddy、Traefik の比較を参照してください。
Basic 認証で得られる効果を正しく理解してください。無差別なスキャンを防ぎ、ポートを無防備に公開するよりははるかに安全です。一方で、これは shell の前段に共有パスワードを置くだけです。2 要素認証はなく、全員が同じ login を使うため、特定の利用者だけを無効化することもできません。パスワードを知り、launch URL またはセッション cookie を持つ人は、DSH が実行されるユーザーとしてコマンドを実行できます。複数人がアクセスする必要がある場合は、代わりに実際の identity proxy を前段に配置してください。そのうえで公開範囲をさらに広げる前に、VPS で coding agent を実行する際の安全ルールを確認してください。
0.0.0.0 にバインドしてポートを開くとどうなるか
最も単純な方法は、再バインドしてファイアウォールを開くことです。DSH はワイルドカード指定をブロックします。--host は 0.0.0.0 を拒否し、@deepseek-ai/dsh-host-webserver プラグインは設定の読み込み時に、表記方法にかかわらず未指定アドレスを拒否します。0.0.0.0、::、IPv4-mapped 形式も対象です。host が受け付けるのは、具体的な IPv4 または IPv6 アドレスリテラルです。そのため、公開 IP を指定すれば、DSH はその設定を受け入れます。ワイルドカード指定の拒否を回避するため、Web サーバーの行を置き換えるコミュニティプラグインもあります。これらには警告が表示されますが、その警告は正確です。同じプラグイン層は、逆方向に使うほうがはるかに有用です。つまり、支出上限とツールの権限ルールによってエージェントの操作範囲を絞り、待ち受け範囲を広げない使い方です。
TLS なしで公開アドレスにバインドすると、実際には次の状態になります。ポート 3080 は、公開 IP アドレス上で平文 HTTP による接続を受け付けます。DSH は、ループバック以外のアドレスで平文 HTTP を提供すると起動時に警告を表示します。しかし、警告は警告にすぎず、リスナーはそのまま開きます。ログインページはありません。唯一の防御手段は起動トークンです。このトークンは URL 内で平文のままインターネットを通過し、その後のセッション Cookie も同様です。/api の防壁は Host ヘッダーを検査しますが、このヘッダーはブラウザー以外のクライアントが自由に設定できます。また、どのポートでもバインドアドレスを許可するため、trustedHosts に自分のアドレスを記載しても、curl を持つ攻撃者に対して何も変わりません。DSH 自身のデプロイガイドにも、広告する URL も防壁も、待ち受けポート自体を保護しないと記載されています。そのポートの先には、ユーザーの権限でシェルコマンドを実行するエージェントがあります。$DSH_HOME には DSH のプロファイルと API キーが保存されています。トークンまたは Cookie を 1 つ盗聴されるだけで、プロバイダー料金を伴うサーバー上のリモートコード実行につながります。スキャナーはアドレス空間全体を継続的に走査するため、IP を一覧に載せないことは防御になりません。エージェントが読み取れるすべての秘密情報が、シェルとともに外部へ送られます。
上記のすべての方法は、この状態を避けるためにあります。1 人が 1 台のノート PC から使う場合は、SSH 転送が適切なデフォルトです。スマートフォンを使う場合や正式な証明書が必要な場合は tailscale serve に移行してください。管理していないブラウザーから UI にアクセスする必要がある場合は、公開リバースプロキシを使い、その前段に正式な認証を配置してください。
FAQ
http://127.0.0.1:3080はなぜノートパソコンから開けないのですか?
127.0.0.1は「このアドレスを読み取っているマシン」を指すためです。DSHはVPS上でこのアドレスを表示するため、VPS上では正しく機能します。ノートパソコンは同じ文字列を読み取り、自身のループバックインターフェイスに接続しようとしますが、そこでは何も待ち受けていません。VPS上でss -ltnp | grep 3080を実行し、サーバー側を確認してください。127.0.0.1:3080と表示される行は、DSHが意図どおりループバックにバインドされて実行中であることを示します。必要なのは別のバインドアドレスではなく、トンネルまたはプロキシです。そのうえで、トークンを含む完全な起動 URL を使用します。
dsh webを--host 0.0.0.0で実行できますか?
いいえ。2026年11月4日に確認したリポジトリの CLI リファレンスでは、--hostにはワイルドカードではなく、具体的なローカルアドレスを1つ指定する必要があり、--host 0.0.0.0は使用方法のエラーで終了すると記載されています。Webserver pluginは、設定の読み込み時に同じアドレスを拒否します。パブリック IP などの具体的なアドレスは受け付けられます。ただし TLS を使用しない場合は平文の HTTP が提供され、DSHは起動時に警告します。そのため、シェルを保護する起動トークンがネットワーク上を平文で通過します。Community pluginsを使用するとワイルドカードのチェックを回避できます。使用する場合は、ファイアウォールと通信のセキュリティを自分で管理する必要があります。
リバースプロキシの背後で、すべての/api呼び出しがHTTP 403を返すのはなぜですか?
/apiの信頼境界は、Hostヘッダーがループバックアドレス、リスナーのバインドアドレス、またはtrustedHostsに登録されたアドレスのいずれでもないリクエストを拒否します。プロキシの背後では、このヘッダーにパブリック名が入るため、信頼境界がリクエストを拒否し、ブラウザーにはtransport failure for /api/host.describe: HTTP 403が記録されます。--trusted-host <your name>を指定してDSHを起動し、URLバーに表示される名前と一致させてください。ポートを含まないエントリは任意のポートでその名前に一致します。ポートを含むエントリは、ホストとポートに完全一致する必要があります。呼び出しが401を返す場合は、信頼境界を通過していますが、ブラウザーにそのオーソリティー用の有効なセッションがありません。トークンを含む、表示された起動 URL を開いてください。
DSH UIは読み込まれるのに、平文HTTPでの起動が完了しないのはなぜですか?
現在の DSH UUID 実装はcrypto.getRandomValues()を使用しており、セキュアコンテキスト外でも動作します。そのため、以前のcrypto.randomUUID()による起動失敗ではこの症状を説明できません。ブラウザーで失敗したリクエストを確認してください。403はHost/Originの信頼境界を示し、401は認証情報の欠落または無効を示します。トークンを含む完全な起動 URL を開き、--trusted-hostがブラウザーに表示されるオーソリティーと一致するか確認してください。リモートアクセスでは HTTPS または SSH forward を使用してください。平文HTTPでは、その経路上で起動トークンとセッションCookieが引き続き露出するためです。
1人の開発者にはどの方法が適していますか?
SSH local forwardです。サーバーに何も追加せず、ファイアウォールルールも変更せず、すでに信頼している SSH key をそのまま使用できます。ssh -f -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vpsを実行し、DSHが表示した起動 URL であるhttp://127.0.0.1:3080/?token=...を、トークンを保持したまま開いてください。スマートフォンで UI を使用したい場合や、ノートパソコンがスリープしてもアクセスを維持したい場合は、tailscale serveに移行します。