dshのhttp://127.0.0.1:3080に接続する方法
dshがhttp://127.0.0.1:3080と表示する理由はWeb UIがlocalhost限定で待ち受けるためです。SSHトンネルで安全に接続する方法と、3080の公開が危険な理由を解説します。
「dsh web: http://127.0.0.1:3080」の意味
VPS で DeepSeek Harness の Web プロファイルを起動すると、次のような行を出力して待機します。
dsh web: http://127.0.0.1:3080/?token=...127.0.0.1 はループバックアドレスです。これは、マシンが自分自身と通信するために使用するアドレスです。127.0.0.1 にバインドされたソケットは、同じマシン上のプロセスからの接続だけを受け付けます。それ以外からの接続は受け付けません。つまり、この行は、Web UI が待ち受けている場所と、接続できる対象を同時に示しています。接続できるのは、dsh を実行しているマシンだけです。末尾の ?token= は、プロセスが起動するたびに生成する新しいランダムな認証情報です。詳しくは後述します。
そのため、この URL を laptop のブラウザーに貼り付けても何も起こりません。laptop の 127.0.0.1 は laptop 自身を指します。Harness は VPS の 127.0.0.1 で待ち受けています。これは別のマシンにある、別のループバックスタックです。故障ではありません。接続を転送する必要があります。
公式 README には、デフォルト設定が明記されています。「このコマンドはデフォルトで http://127.0.0.1:3080 で Web UI を起動し、ローカルで起動した場合はデフォルトブラウザーで開きます。」SSH 経由では開くブラウザーがないため、URL は手動で使用できるように表示されます。バインドアドレスは Web サーバーのホストプラグインである @deepseek-ai/dsh-host-webserver から指定されます。このガイドが固定する 0.2.0-rc.2 リリースでは、その host キーは「待ち受けるホスト。対応する値は loopback と all-interfaces の 2 つ」と記載されています。変更しない限り、loopback が使用されます。ポートに不慣れな場合は、Linux でのポートの仕組みで、この仕組みの基礎となるアドレスとポートの組み合わせを説明しています。
Web UI が localhost のみにバインドする理由
dsh はエージェントハーネスです。これはモデルを包むプログラムであり、ループ、ツール呼び出し、それらの呼び出しに適用される権限を管理します。ブラウザーのタブは、shell コマンドを実行し、選択した workspace directory 内のファイルを読み書きし、モデル API key を消費するプロセスの操作画面です。そのページを読み込める人は、dsh を実行しているユーザーとして、それらすべてを実行できます。この範囲に入る経路はネットワークだけではありません。インストールした plugin は同じプロセス内で同じ権限により実行されます。そのため、dsh plugin をインストールする前に検証することは、サーバーが何を listen するかを決める場合と同じ注意が必要です。
したがって、port 3080 は読み取り専用の dashboard ではありません。そのページを読み込むと、サーバー上でコマンドを実行できます。
表示された URL を開くと、すぐに session list が表示されます。login screen はなく、user account もありません。ページへのアクセスを制御するのは URL 末尾の token です。root page はその token を signed session cookie に交換し、余分な情報のないアドレスへ redirect します。その後、UI が有効な cookie なしで行うすべての RPC call と WebSocket stream は 401 Unauthorized になります。ただし、この port 上のすべてが保護されるわけではありません。Connection plugin のドキュメントによると、static asset は公開されたままです。また、webserver 自体にはサーバー全体の authentication や origin policy がないため、各 route を所有する plugin がそれぞれのルールを適用します。保護された route では、Host header が loopback でも明示的に信頼した host でもない場合、Connection plugin は 403 も返します。loopback では、実際の access control の背後にある第 2 の層として妥当です。これは、OS が local process だけを通過させる仕組みです。port を公開する理由にはなりません。token は terminal の scrollback と、startup output を記録したログに残ります。プロジェクト独自の reverse proxy guide には、Host check も advertised URL も、listen している port 自体を保護しないと記載されています。webserver のドキュメントも、non-loopback address にバインドすると「保護されていない route と static asset がその network に引き続き公開される」と警告しています。また、0.2.0-rc.2 では webserver plugin 自体に TLS がありません。自動 scanner は一般的でない port も継続的に走査するため、公開した 3080 は発見済みとして扱ってください。
firewall で port 3080 を開放しないでください。また、public VPS で webserver のhostを0.0.0.0や public IP に設定しないでください。この組み合わせでは、接続できる人が URL を 1 つ入手するだけで、サーバー上でコマンドを実行できる状態になります。
現在の release は、すでにこの方針を促しています。web application 自体の --host flag は、すべての interface へのバインドを拒否します。ただし 0.2.0-rc.2 では、webserver plugin の host config key が依然として 0.0.0.0 を受け付けるため、config を編集すると公開できます。プロジェクトの default branch にある webserver のドキュメントと、npm の latest tag が現在指している 0.2.1-rc.5 release では、さらに進んでいます。load 時に未指定の address を拒否し、任意の tls setting を追加しています。ただし、local interface の具体的な address は 1 つなら受け付けるため、host を VPS の public IP に指定すると、UI は同じように公開されます。
同じ考え方は、サーバー上で実行するすべての agent runtime に当てはまります。そのため、VPS 上で coding agent を安全に実行することも同じ原則から始まります。agent の control port は private のままにし、信頼できる仕組みを経由して接続します。
ノートパソコンから dsh Web UI を開くにはどうすればよいですか?
正攻法は 3 つあります。いずれの場合も、ハーネスは loopback にバインドしたままにします。
- SSH トンネルを使用する方法です。public interface で新たに待ち受けるものはなく、すでに認証情報もあります。使用すべき方法はこれです。
- private overlay network を使用する方法です。自分のデバイスからのみ UI に到達でき、他のユーザーからは見えません。
- TLS (transport layer security) を終端する reverse proxy を使用する方法です。reverse proxy は、転送する前にパスワードを要求します。
違いは、ブラウザーから loopback までの通信を何が運ぶかです。いずれの方法でも、ハーネスを loopback から移動させてはいけません。
SSH トンネルで接続する
VPS ではなく、ノートパソコンで次を実行します。
ssh -N -L 3080:127.0.0.1:3080 you@your-vpsこのコマンドを実行したままにし、出力された完全な URL dsh を開きます。トークンも含めた http://127.0.0.1:3080/?token=... をローカルブラウザーに入力してください。Web UI はトークンをセッション Cookie と交換し、アドレスバーからトークンを削除します。ブラウザーは 127.0.0.1:3080 を Host として送信します。これは loopback なので、追加設定なしでトンネルの Host チェックを通過します。
-L 引数には、コロンで区切られた3つのフィールドがあります。1つ目はノートパソコンで開くポートです。2つ目と3つ目は、各接続の転送先となるアドレスとポートです。重要なのは、中央のフィールドにある 127.0.0.1 が、トラフィックがVPSに到達した後、VPS上の SSH サーバーによって解決される点です。これはノートパソコン側ではなく、VPS側の loopback を指します。まさに出力された dsh のアドレスなので、直接ブラウザーで接続できない場合でもトンネルが機能します。
-N は SSH にリモートコマンドを実行させません。そのため、シェルではなく転送だけが起動します。バックグラウンドで動かし、失敗時に静かに終了させない場合は、次を実行します。
ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps-f は認証後にプロセスをバックグラウンドへ移します。ExitOnForwardFailure=yes は見た目以上に重要です。これがないと、転送を設定できなくても SSH 接続自体は成功します。その結果、セッションは動作しているのにトンネルは停止している状態になり、警告も表示されません。ServerAliveInterval=30 は30秒ごとに keepalive を送信します。これにより、カフェやホテルのルーターで発生する NAT (network address translation) のタイムアウト後も、アイドル状態のトンネルを維持できます。
確認できる内容
VPS上で、実際に待ち受けているソケットを確認します。
ss -ltnp | grep 3080正常な結果では、loopback アドレスが表示されます。
LISTEN 0 511 127.0.0.1:3080 0.0.0.0:* users:(("node",pid=1042,fd=21))ローカルアドレスの列が 0.0.0.0:3080 になっている場合、Web UI はパブリックインターフェースを含むすべてのインターフェースで待ち受けています。その列にVPSのパブリック IP が表示される場合も、同じ状態です。ほかの作業をする前に停止し、bind 設定を修正してください。ss がソケットを表示するものの、users: フィールドが空の場合は、sudo を付けて実行します。別ユーザーが所有するソケットでは、それ以外の場合プロセス名が非表示になるためです。
トンネルの起動に失敗する場合
SSH は次のメッセージを表示して終了します。
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080これはサーバーではなく、ノートパソコン側の問題です。ローカルでポート 3080 をすでに使用しているものがあります。忘れていた以前のトンネルであることがよくあります。空いているローカルポートを指定してください。
ssh -N -L 3081:127.0.0.1:3080 you@your-vps変更したのは最初のフィールドだけです。そのため、同じトークンを使って http://127.0.0.1:3081/?token=... を開きます。harness は引き続き 3080 で待ち受けます。2つの番号を一致させる必要はありません。セッション Cookie はアドレスバーのホストとポートに紐付いているため、新しいローカルポートではトークン URL をもう一度開く必要があります。
トンネルは起動したものの、ブラウザーが接続拒否または空の応答を表示する場合、トラフィックはVPSまで到達していますが、転送先で待ち受けているものがありません。dsh が終了したか、別のポートに bind した可能性があります。サーバー上で ss -ltnp | grep 3080 を実行して確認してください。ページが 401 Unauthorized を返す場合、トンネルは正常です。そのアドレスに対応する有効な Cookie がブラウザーにないだけなので、トークンを含む出力済み URL をもう一度開きます。再起動後は、新しい出力から URL を取得してください。プロセスごとに新しいトークンが発行されるためです。
ここでは、もう1つ注意点があります。フォアグラウンドの npx @deepseek-ai/dsh web はシェルを閉じると終了するため、ログアウトした時点で harness も停止します。VPS上でコーディングエージェントを実行し続ける場合と同じ問題なので、tmux 内で起動するか、systemd user service として起動してください。systemd では、トークンを含む dsh web: 行全体がサービスログに記録されます。そこから読み取ってください。SSH 側の作業中に、VPSの SSH を強化することも先に実施する価値があります。トンネルを使うと、SSH ログインがエージェントへの唯一の接続経路になるためです。
プライベートオーバーレイネットワーク経由でアクセスする
オーバーレイネットワークを使うと、VPS とラップトップに、参加できるデバイスを自分の端末だけに限定したプライベートネットワーク上のアドレスを割り当てられます。一般的な選択肢は Tailscale で、この用途には serve コマンドが適しています。tailscaled は VPS 上で実行し、localhost:3080 自体に接続するため、harness は loopback 上に留まります。
tailscale serve --bg localhost:3080
tailscale serve statusこれで UI には、tailnet 内での自分のマシン名を使って HTTPS 経由でアクセスできます。パブリックインターフェイスでポートを開く必要はありません。tailnet 用の HTTPS 証明書を有効にしておく必要があります。有効にしないと、serve は提示する証明書を持てません。ブラウザーは tailnet 名を Host として送信するため、その名前を信頼するように harness を起動してください。そうしないと、API 呼び出しが 403 になります。ポートのないエントリは、すべてのポートに一致します。
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.net次に https://your-vps.your-tailnet.ts.net/?token=... を開き、表示された行からトークンを引き継ぎます。停止するには、off を付けて同じコマンドをもう一度実行します。
tailscale serve --https=443 offserve を使用し、funnel は使用しないでください。Funnel は同じ転送先をパブリックインターネットに公開します。その結果、URL トークンだけを前面に置いた agent runtime が、公開ポートで待ち受けることになります。2 つのコマンドはほぼ同じに見えますが、動作は正反対です。どちらかを入力する前に、Tailscale Serve と Funnel の違いを確認してください。設定自体については、プライベートネットワークとしての Tailscaleを参照してください。
パスワードを確認するリバースプロキシ経由でアクセスする
これは実際にポートをインターネットへ公開する方法です。そのため、認証だけが第三者によるサーバー上でのコマンド実行を防ぎます。複数人が UI を使う必要があり、それぞれにトンネルを用意するのが現実的でない場合に選択します。
ハーネスは 127.0.0.1:3080 上で動作します。nginx は同じホストで動作するため loopback に接続でき、証明書とパスワードファイルを使用して 443 で待ち受けます。
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 Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
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 となるはずです。壊れたファイルで reload すると失敗しますが、稼働中の設定はそのまま残ります。そのため、無条件に restart するのではなく、エラーを確認してください。
このプロキシ設定のうち 3 行は飾りではありません。Upgrade と Connection のヘッダーにより WebSocket のハンドシェイクが通過します。これらがないとページは読み込まれますが、更新されません。proxy_read_timeout 3600s は nginx の非アクティブタイムアウトを 60 秒から 1 時間に延長します。エージェントの実行時間全体を制限する設定ではありません。固定された 0.2.0-rc.2 はデフォルトで 2 秒ごとに WebSocket ping を送信するため、長時間のエージェント処理中も接続を維持できます。proxy_buffering off はプロキシする HTTP レスポンスのバッファリングを無効にします。WebSocket フレームは制御しません。nginx リバースプロキシ設定を行単位で確認するでは残りの設定を説明し、nginx、Caddy、Traefik から選択するでは自動証明書を使って同じ構成にする方法を説明します。
ハーネスにもプロキシを認識させる必要があります。proxy_set_header Host $host はブラウザーから見える名前を変更せずに渡します。これはプロジェクトのプロキシガイドで求められている動作です。そのため、dsh をその名前を信頼する設定で起動してください。そうしないと 403 と応答します。
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.com各ユーザーは dsh web: 行にあるトークンを使って、https://dsh.example.com/?token=... を一度開きます。その後、ブラウザーはセッション Cookie を保持します。バックエンドは Secure フラグなしでこの Cookie を設定します。プロキシガイドでは、HTTPS 上でプロキシがこのフラグを追加するよう求めています。nginx 1.19.3 以降では、location ブロック内の proxy_cookie_flags ~ secure; によりこれを実行できます。
どのプロキシを選んでも、ファイアウォールでは 3080 を閉じたままにしてください。外部からの経路を認証済みのプロキシ経由だけにするためです。ufw ファイアウォールの基本ではルールを説明します。TLS 上の Basic 認証は最低限の対策であり、十分なセキュリティモデルではありません。そのパスワードとトークン URL を持つ者は、サーバー上の shell を利用できます。可能であればトンネルを優先してください。
dsh web が待ち受けるポートを変更するには
--port は launcher ではなく、Web アプリケーションに属します。CLI のドキュメントには、次の例が直接示されています。
dsh --profile web --port 8080dsh web は --profile web の別名です。そのため、dsh web --port 8080 も同じコマンドです。launcher は自身のフラグだけを解析し、それ以降のすべてを起動した profile に渡します。したがって、launcher のフラグを先に指定し、launcher が認識できない最初のトークンからアプリケーションの引数が始まります。--port は profile の後に指定し、profile より前には置かないでください。
コマンドが出力する URL をそのまま読み取ってください。推測で決めてはいけません。その行には、サーバーが実際に bind したアドレスと、必要な token が表示されます。次に、tunnel の最後のフィールドをその値に合わせます。
ssh -N -L 3080:127.0.0.1:8080 you@your-vps永続的に変更する場合、ポートはコマンドラインではなく profile の設定に記述します。web と headless の profile は、初回使用時に ~/.dsh 配下の同梱テンプレートから自動的に初期化されます。同じディレクトリに API key と model endpoint の設定も保存されます。そのため、これらのファイルを編集する場合は、dsh の key、model、endpoint を設定する も併せて参照してください。すべてのレイヤーを合成した後に、実際に有効な設定を確認するには、次を実行します。
dsh --dump-config待ち受けアドレスは、webserver plugin の host と port という 2 つの key から決まります。0.2.0-rc.2 では、その他の key はレスポンス圧縮だけを調整します。0.2.1-rc.2 と default branch では、任意の tls key が追加されています。port を 0 に設定すると、空いているポートを OS に割り当てるよう要求します。ドキュメントには「zero requests an OS-assigned port」と記載されています。これによりポートの競合は確実に避けられますが、再起動のたびに番号が変わるため、tunnel には適していません。
dsh が「address already in use」で失敗するのはなぜですか?
別のプロセスがそのアドレスとポートをすでに使用しているため、カーネルが 2 つ目の bind を拒否します。Node では次のように表示されます。
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080変更を加える前に、使用中のプロセスを確認します。
sudo ss -ltnp | grep 3080users:(("node",pid=1042,fd=21)) フィールドにプロセスとその PID が表示されます。通常は、停止したと思っていた以前の dsh が原因です。切断された tmux ウィンドウ内で、まだ動作していることもよくあります。kill 1042 でそのプロセスを停止するか、新しいインスタンスを別のポートで起動します。127.0.0.1:3080 と 0.0.0.0:3080 も互いに競合する点に注意してください。すべてのインターフェースに bind すると、loopback もすでに対象になるためです。
開発者プレビューのため、バージョンを固定する
README には明記されています。DeepSeek Harness は開発者プレビューで、急速に開発が進んでおり、互換性を損なう変更が予定されています。そのペースを理由に導入を迷っている場合は、dsh と Claude Code、Omnigent の比較で、同じ開発段階の異なる時点にある 2 つのハーネスと比較できます。
バージョンを固定していない npx @deepseek-ai/dsh web にはバージョンが指定されていないため、どのビルドで起動するかを制御できません。npm のドキュメントによると、指定子なしのパッケージ名は「ローカルプロジェクトに存在するバージョンと一致」し、プロジェクトにないパッケージは npm キャッシュ内のフォルダーにインストールされます。どのビルドで起動するかは、そのマシンに何が存在するかによって決まります。そのため、再起動すると、テストしたものとは異なる CLI が起動し、使用できるフラグも変わる可能性があります。再起動によってアップグレードされないよう、バージョンを固定します。
npx @deepseek-ai/dsh@0.2.0-rc.2 web2026 年 11 月時点(2026-11-01 に確認)では、npm の latest タグは 0.2.1-rc.5 を指しています。これは 2026-10-30 に GitHub でリリースされました。GitHub の記録では、0.2.1-rc.4 は 2026-10-28 02:49 UTC にリリースされています。これは、2026-10-23 15:26 UTC の 0.2.1-rc.3 から約 4 日と 11 時間後です。そのため、ローカルコピーがないマシンでは、単独の npx @deepseek-ai/dsh は現在、このガイドで固定しているビルドではなく、0.2.1 リリース候補を取得します。固定している 0.2.0-rc.2 は、2026-09-29 に GitHub でリリースされました。このガイドが 8 月に固定した 0.1.0-rc.7 ビルドは、現在では多数のプレビューリリース分だけ遅れており、0.1 系列の残りを経て 0.2 系列にまで及んでいます。受け入れる前に、単独の npx が何を取得するか確認してください。
npm view @deepseek-ai/dsh versionnpm view @deepseek-ai/dsh dist-tags はすべてのタグを一度に一覧表示します。固定する前に、リリース候補と alpha を見分ける方法です。
固定したバージョンのインストールに失敗する場合、または新しいバージョンを固定した後も npx が古いビルドを起動し続ける場合は、発生したインストールおよびバージョンのエラーで、npx キャッシュの削除方法と、Node に組み込まれた npm の確認方法を説明しています。
プレビューリリースでは、ランチャーと Web アプリケーションの間でフラグが移動します。--port がこのガイドの説明どおりに動作しなくなった場合は、推測で対応せず、アプリケーション自体に独自のフラグ一覧を要求してください。
dsh --profile web --helpインストール、ワークスペースの設定、モデルキーについては、VPS への DeepSeek Harness のインストールを参照してください。アクセス手順だけを短く確認する場合は、VPS 上の dsh Web UI への接続で、推論部分を省いたトンネルの手順を説明しています。
FAQ
ノート PC のブラウザーで http://127.0.0.1:3080 を開けないのはなぜですか?
127.0.0.1 は、入力操作を行っているマシンを指すためです。DeepSeek Harness Web UI は VPS の loopback address に bind されているため、接続できるのは VPS 上のプロセスだけです。ノート PC には独立した loopback があり、そこでは port 3080 を listen しているプロセスはありません。ssh -N -L 3080:127.0.0.1:3080 you@your-vps で SSH 経由の port forwarding を設定し、ローカルで完全な出力 URL http://127.0.0.1:3080/?token=... を読み込んでください。-L 引数の中央のフィールドは server 側で解決されるため、harness を指します。token を付けないと、ブラウザーが session cookie を保持するまで 401 Unauthorized になります。
公開 VPS で dsh Web UI を 0.0.0.0 に bind しても安全ですか?
いいえ。Web UI は、dsh を実行ユーザーとして shell command の実行と file の編集を行う agent の control surface です。user account も login screen もありません。唯一の credential は出力 URL に含まれる token です。static asset は token なしで配信され、プロジェクトのドキュメントにも、listen している port 自体は保護されていないと記載されています。public IP で全 interface に bind すると、port 3080 に到達できる誰もが、漏洩した URL 1 つで server 上の command execution にアクセスできる状態になります。public IP に直接 bind しても同じ risk があります。bind 先は 127.0.0.1 のままにし、firewall で 3080 を閉じ、SSH tunnel、private overlay network、または password を要求する reverse proxy を使用してください。
SSH session を閉じた後も dsh Web UI を実行し続けるにはどうすればよいですか?
foreground の npx @deepseek-ai/dsh web は login shell の child であるため、その shell が終了すると kill されます。tmux session 内で起動し、Ctrl-b d で detach してください。または、lingering を有効にした systemd user service として実行します。tunnel と harness は独立しています。harness 自体に login より長く存続する parent がある限り、実行中の harness に触れずに SSH tunnel を何度でも切断して再構築できます。
nginx の背後で長時間の agent run を実行すると、dsh Web UI が途中で freeze するのはなぜですか?
WebSocket connection と nginx の error log を確認してください。nginx の default proxy_read_timeout は read 間隔 60 秒ですが、固定された 0.2.0-rc.2 は default で 2 秒ごとに WebSocket ping を送信するため、agent step が長いだけではその timeout は発生しません。proxy_read_timeout 3600s; により inactivity の許容時間が 1 時間に延長されます。proxy_buffering off; は HTTP response の buffering を無効にしますが、WebSocket frame には適用されません。WebSocket handshake を成功させるには、proxy_http_version 1.1; で Upgrade header と Connection header を渡してください。これらの header がないと page は読み込まれますが、update を受信できません。