SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

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 粘贴到笔记本电脑的浏览器中不会有任何反应。笔记本电脑的 127.0.0.1 指的是笔记本电脑自身。Harness 监听的是 VPS 的 127.0.0.1,而 VPS 是另一台机器,使用不同的回环网络栈。系统没有故障。您需要通过连接转发来访问它。

官方 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。”除非手动修改,否则默认使用 loopback。如果您不熟悉端口,Linux 上的端口工作方式介绍了这里所依赖的地址加端口模型。

Web UI 仅绑定到 localhost 的原因

dsh 是一个代理运行框架,也就是包裹模型运行的程序:它负责控制循环、工具调用,以及这些调用所使用的权限。浏览器标签页只是一个控制界面,而实际运行的进程可以执行 shell 命令、读写您选定的工作区目录中的文件,并使用您的模型 API 密钥。任何能够加载该页面的人,都可以以运行 dsh 的用户身份执行这些操作。进入这些权限范围的途径也不只有网络:您安装的插件会在同一进程中运行,并拥有相同权限。因此,安装 dsh 插件前先进行审核,其重要性不亚于决定服务器监听哪个地址和端口。

因此,端口 3080 并不是只读仪表板。加载该页面即可在服务器上执行命令。

打开输出的 URL 后,您会直接进入会话列表。页面没有登录界面,也没有用户账户。页面访问控制依赖 URL 末尾的令牌:根页面将其换成签名会话 Cookie,然后重定向到不带令牌的干净地址。此后,UI 发出的每个 RPC 调用和 WebSocket 流,如果没有有效 Cookie,都会收到 401 Unauthorized。不过,该端口上的内容并非全部受保护。Connection 插件的文档说明,静态资源仍然公开;Web 服务器本身也没有全局身份验证或来源策略,因此每个负责某个路由的插件都必须自行执行访问控制。在这些受保护的路由上,当 Host 标头既不是回环地址,也不是您明确信任的主机时,Connection 插件还会返回 403。在回环地址上,这可作为真实访问控制之后的第二层防护,因为操作系统只允许本地进程访问。但这不是公开端口的理由。令牌会出现在终端回滚内容中,也可能出现在记录了启动输出的日志里。项目自己的反向代理指南说明,Host 检查和显示的 URL 都不能保护监听端口本身。Web 服务器文档警告,将地址绑定到非回环地址“仍会向该网络暴露未受保护的路由和静态资源”。此外,在 0.2.0-rc.2 中,Web 服务器插件自身没有 TLS。自动化扫描器会持续扫描不常见的端口,因此应将已公开的 3080 视为已经被发现。

不要在防火墙中开放端口 3080,也不要在公有 VPS 上将 Web 服务器的 host 设置为 0.0.0.0 或您的公网 IP。这样的配置会让连接到该端口的任何人只需获得一个泄露的 URL,就能在您的服务器上执行命令。

当前版本已经在引导您采用这种配置:Web 应用自身的 --host 标志拒绝绑定到所有接口。不过,在 0.2.0-rc.2 中,Web 服务器插件的 host 配置键仍接受 0.0.0.0,因此修改配置后仍可能将其暴露。项目默认分支中的 Web 服务器文档,以及 npm 的 latest 标签当前所指向的 0.2.1-rc.5 版本,进一步收紧了限制:加载配置时会拒绝未指定地址,并新增可选的 tls 设置。它仍接受本地接口上的任意一个具体地址,因此将 host 指向 VPS 的公网 IP,仍会以相同方式暴露 UI。

同样的原则适用于您部署在服务器上的所有代理运行时。因此,在 VPS 上安全运行编码代理也应从同一条规则开始:代理的控制端口必须保持私有,并由您信任的组件负责提供访问入口。

如何从笔记本电脑打开 dsh Web UI?

有3种可行方式,而且每种方式都会让 harness 继续绑定到 loopback。

  • SSH 隧道。不需要在公网接口上新增监听端口,并且您已经具备凭据。应使用这种方式。
  • 私有覆盖网络。这样只有您自己的设备可以访问 UI,其他人无法看到。
  • 终止 TLS(传输层安全)的反向代理。代理转发任何请求前都要求输入密码。

它们的区别在于,浏览器通过什么方式访问 loopback。无论使用哪种方式,都不应让 harness 脱离 loopback。

通过 SSH 隧道访问

在本地笔记本上运行此命令,不要在 VPS 上运行:

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

保持该命令运行,然后在本地浏览器中打开完整 URL dsh,http://127.0.0.1:3080/?token=... 中包含 token。Web UI 加载后,会将 token 换成会话 cookie,并从地址栏中移除 token。浏览器会将 127.0.0.1:3080 作为 Host 发送,该值是回环地址,因此隧道无需额外配置即可通过 Host 检查。

-L 参数包含3个字段,字段之间用冒号分隔。第一个字段是要在本地笔记本上打开的端口。第二和第三个字段是转发每个连接时使用的地址和端口。关键在于:中间字段中的 127.0.0.1 由 VPS 上的 SSH 服务器解析,此时流量已经到达 VPS。它表示 VPS 的回环地址,而不是本地笔记本的回环地址。这正是 dsh 打印的地址,因此直接使用浏览器连接失败时,隧道仍然可以正常工作。

-N 告诉 SSH 不要运行远程命令,因此只建立转发,不打开 shell。要让后台隧道在失败时明确报错,而不是静默失败:

ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps

-f 会在完成身份验证后将 SSH 放到后台运行。ExitOnForwardFailure=yes 的作用比看起来更重要:没有它时,即使转发无法建立,SSH 仍会成功连接。这样会得到一个可用的会话和一个失效的隧道,且没有任何警告。ServerAliveInterval=30 每30秒发送一次 keepalive,使空闲隧道能够避免咖啡馆和酒店路由器上的 NAT(网络地址转换)超时。

你应该看到的内容

在 VPS 上确认实际处于监听状态的地址:

ss -ltnp | grep 3080

正常结果应显示回环地址:

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,也表示存在相同的暴露风险。先停止服务并修正绑定地址,再进行其他操作。如果 ss 打印出 socket,但 users: 字段为空,请使用 sudo 运行它。否则,属于其他用户的 socket 会隐藏进程名称。

隧道无法启动时

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

只有第一个字段发生了变化,因此现在应使用包含相同 token 的 http://127.0.0.1:3081/?token=... 访问,而 harness 仍在监听3080端口。两个端口号不需要一致。会话 cookie 会绑定地址栏中的主机和端口,因此更换本地端口后,需要再次使用 token URL。

如果隧道已建立,但浏览器报告连接被拒绝或收到空响应,说明流量已经转发到 VPS,但远端没有服务监听。可能是 dsh 已退出,也可能是它绑定了其他端口。在服务器上使用 ss -ltnp | grep 3080 检查。如果页面改为返回 401 Unauthorized,说明隧道正常,只是浏览器没有保存该地址对应的有效 cookie:请再次打开打印出的 URL,并包含 token。重启后,请使用新输出中的 URL,因为每个进程都会生成新的 token。

还有一个常见问题。前台运行的 npx @deepseek-ai/dsh web 会在 shell 关闭时退出,因此你注销后 harness 会立即停止。请在 tmux 中启动它,或使用 systemd 用户服务运行它。这与 让 coding agent 在 VPS 上持续运行 中解决的是同一个问题。在 systemd 下,包含 token 的 dsh web: 行会写入服务日志,因此应从日志中读取。处理 SSH 配置时,建议先加固 VPS 上的 SSH,因为该隧道使 SSH 登录成为访问 agent 的唯一入口。

通过私有覆盖网络访问

覆盖网络会为 VPS 和笔记本电脑分配私有网络地址,只有加入该网络的设备才能访问。Tailscale 是常用选择,其 serve 命令正适合此场景:tailscaled 在 VPS 上运行,并连接到 localhost:3080 本身,因此 harness 仍只监听 loopback。

tailscale serve --bg localhost:3080
tailscale serve status

随后,可通过 tailnet 内的计算机名称使用 HTTPS 访问 UI,公网接口无需开放端口。必须先为 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 off

使用 serve,不要使用 funnel。Funnel 会将同一目标发布到公网,使 agent runtime 运行在开放端口上,前面只有 URL 令牌提供保护。这两个命令几乎完全相同,但作用相反,因此在输入任一命令前,请先阅读Tailscale Serve 与 Funnel 的区别。将 Tailscale 用作私有网络介绍具体设置方法。

通过验证密码的反向代理访问

这是确实会将端口发布到互联网的方案,因此身份验证是陌生人与服务器上的命令执行之间唯一的防线。当多人需要使用 UI,且不便为每个人建立隧道时,可以选择此方案。

harness 继续运行在 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;
    }
}

创建密码文件并重新加载配置:

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginx

nginx -t 应输出 syntax is ok,后跟 test is successful。如果文件损坏,重新加载会失败,并保留当前正在运行的配置。因此,应先读取错误信息,不要盲目重启。

其中 3 行代理配置并非装饰。Upgrade 和 Connection 请求头允许 WebSocket 握手通过;缺少它们时,页面可以加载,但不会更新。proxy_read_timeout 3600s 将 nginx 的不活动超时从 60 秒提高到 1 小时;它不限制 agent 运行的总时长。固定使用的 0.2.0-rc.2 默认每 2 秒发送一次 WebSocket ping,因此长时间执行 agent 步骤时连接仍会保持活动。proxy_buffering off 会禁用代理 HTTP 响应的缓冲;它不控制 WebSocket 帧。逐行说明 nginx 反向代理配置解释其余配置,选择 nginx、Caddy 还是 Traefik介绍如何使用自动证书实现相同功能。

harness 也需要了解代理配置。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。后端设置该 cookie 时未使用 Secure 标志,而代理指南要求代理在 HTTPS 上为其添加该标志。在 nginx 1.19.3 或更高版本中,可在 location 块中使用 proxy_cookie_flags ~ secure; 完成此操作。

无论选择哪种代理,都应在防火墙上关闭 3080,使进入服务的唯一途径是经过身份验证的代理。ufw 防火墙基础介绍相关规则。通过 TLS 使用基本身份验证只是最低限度的防护,并不是完整的安全模型:持有该密码和令牌 URL 的任何人都可以在服务器上获得 shell。条件允许时,优先使用隧道。

如何更改 dsh Web 服务监听的端口?

--port属于 Web 应用,而不是启动器。CLI 文档直接给出了示例:

dsh --profile web --port 8080

dsh web是 --profile web 的别名,因此 dsh web --port 8080 是相同的命令。启动器只解析自己的选项,并将其后的所有内容传递给已启动的配置文件。启动器选项必须放在前面;启动器无法识别的第一个标记会开始作为应用程序参数。将 --port 放在配置文件之后,不能放在它之前。

请读取命令打印出的 URL,不要自行假设,因为该行会报告服务器实际绑定的地址,以及你需要使用的令牌。然后相应更新隧道配置的最后一个字段:

ssh -N -L 3080:127.0.0.1:8080 you@your-vps

如需永久更改,应在配置文件中设置端口,而不是在命令行中设置。web 和 headless 配置文件首次使用时会根据随附模板自动初始化,位置在 ~/.dsh。API 密钥和模型端点设置也位于同一目录中,因此如果你已经要编辑这些文件,请一并阅读配置 dsh 的密钥、模型和端点。要查看所有配置层合并后的实际生效内容:

dsh --dump-config

监听地址由 Web 服务器插件中的两个键控制:host 和 port。在 0.2.0-rc.2 中,其余键仅用于调整响应压缩;0.2.1-rc.2 和默认分支新增了可选的 tls 键。将 port 设置为 0 会请求操作系统分配一个空闲端口,文档将其说明为“zero requests an OS-assigned port”。这样可以避免端口冲突,但不适合隧道,因为端口号会在每次重启时改变。

dsh 为什么会因地址已被占用而失败?

因为另一个进程已经占用了该地址和端口,内核会拒绝第二次绑定。Node 会报告如下错误:

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080

在进行任何更改前,先找出占用者:

sudo ss -ltnp | grep 3080

users:(("node",pid=1042,fd=21)) 字段会显示进程及其 PID。通常,占用者是之前启动、但您以为已经停止的 dsh,它可能仍在分离的 tmux 窗口中运行。使用 kill 1042 停止该进程,或让新实例使用其他端口。请注意,127.0.0.1:3080 和 0.0.0.0:3080 也会相互冲突,因为绑定所有接口已经包含 loopback。

固定版本,因为这是开发者预览版

README 对此说明得很直接:DeepSeek Harness 目前处于开发者预览阶段,迭代速度很快,后续会出现破坏兼容性的变更。如果你正因为更新速度而犹豫,dsh 与 Claude Code 和 Omnigent 的对比会将它与处于同一发展曲线、但阶段不同的两个 harness 进行比较。

未固定版本的 npx @deepseek-ai/dsh web 不指定版本,因此你无法控制它启动的构建版本。npm 文档说明,不带版本限定符的软件包名称“将匹配本地项目中存在的任意版本”;而项目中缺少的软件包会安装到 npm 缓存中的目录。实际启动哪个构建版本取决于该机器当前具备的内容,因此重启后可能启动与你测试过的 CLI 不同的版本,并使用不同的标志。固定版本,确保重启不会触发升级:

npx @deepseek-ai/dsh@0.2.0-rc.2 web

截至 2026 年 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 发布,比 0.2.1-rc.3(2026-10-23 15:26 UTC)晚约四天零十一小时。因此,在没有本地副本的机器上,直接使用 npx @deepseek-ai/dsh 现在会拉取 0.2.1 release candidate,而不是本指南固定的构建版本。本指南固定的 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 version

npm view @deepseek-ai/dsh dist-tags 会一次列出所有标签。固定版本前,可以据此区分 release candidate 和 alpha。

如果固定版本后安装失败,或者固定新版本后 npx 仍然启动旧构建版本,请参阅由此引发的安装和版本错误,其中介绍如何清理 npx 缓存,以及如何检查 Node 自带的 npm。

在不同的预览版本中,标志可能会在启动器和 Web 应用之间移动。如果 --port 不再按本指南所述运行,请向应用本身请求标志列表,不要自行猜测:

dsh --profile web --help

有关安装过程、工作区设置和模型密钥,请参阅在 VPS 上安装 DeepSeek Harness。如果只需要简短了解访问步骤,请参阅在 VPS 上访问 dsh Web UI,其中介绍不包含推理步骤的隧道配置。

FAQ

为什么我无法在笔记本电脑的浏览器中打开 http://127.0.0.1:3080?

因为 127.0.0.1 指的是您输入命令的那台机器。DeepSeek Harness Web UI 绑定在 VPS 的回环地址上,因此只有 VPS 上的进程可以连接它。您的笔记本电脑有独立的回环地址,其 3080 端口上没有进程监听。使用 ssh -N -L 3080:127.0.0.1:3080 you@your-vps 通过 SSH 转发端口,然后在本地加载完整的输出 URL:http://127.0.0.1:3080/?token=...。-L 参数的中间字段在服务器端解析,因此它会指向 harness。省略令牌后,您会先得到 401 Unauthorized,直到浏览器保存会话 Cookie。

将 dsh Web UI 绑定到公有 VPS 上的 0.0.0.0 是否安全?

不安全。Web UI 是代理的控制界面。该代理会以运行 dsh 的用户身份执行 shell 命令和编辑文件。它没有用户账户,也没有登录页面。唯一的凭据是输出 URL 中的令牌。静态资源无需令牌即可提供,项目自身的文档也说明监听端口没有保护。在公有 IP 上绑定到所有接口后,任何能够访问 3080 端口的人,只要获得一个泄露的 URL,就可能在您的服务器上执行命令。直接绑定到公有 IP 也有相同风险。保持绑定在 127.0.0.1,在防火墙上关闭 3080,并使用 SSH 隧道、私有覆盖网络,或要求密码的反向代理。

关闭 SSH 会话后,如何让 dsh Web UI 继续运行?

前台运行的 npx @deepseek-ai/dsh web 是登录 shell 的子进程,因此 shell 退出时该进程也会被终止。在 tmux 会话中启动它,然后使用 Ctrl-b d 分离;或者将其作为 systemd 用户服务运行,并启用 lingering。隧道和 harness 相互独立。只要 harness 本身的父进程不会随登录退出,您可以随时断开并重新建立 SSH 隧道,而不影响正在运行的 harness。

通过 nginx 运行长时间的代理任务时,为什么 dsh Web UI 会在中途冻结?

检查 WebSocket 连接和 nginx 的错误日志。nginx 的默认 proxy_read_timeout 是两次读取之间等待 60 秒。不过,固定使用的 0.2.0-rc.2 默认每两秒发送一次 WebSocket ping,因此单个长时间运行的代理步骤不会触发该超时。proxy_read_timeout 3600s; 会将非活动允许时间延长到 1 小时。proxy_buffering off; 会禁用 HTTP 响应缓冲,但不会禁用 WebSocket 帧缓冲。使用 proxy_http_version 1.1; 传递 Upgrade 和 Connection 标头,使 WebSocket 握手成功。缺少这些标头时,页面可以加载,但始终收不到更新。

这篇文章对您有帮助吗?