- DSH
- 0.1.0-rc.5
- 系统
- Windows / macOS / Linux
- 风险
- medium
直接修复
DeepSeek Harness Web UI 默认使用 127.0.0.1:3080。3080 被其他进程占用时,换一个空闲端口启动:
npx @deepseek-ai/dsh web --port 8080
然后访问 http://127.0.0.1:8080。如果使用已安装的 CLI,也可以运行 dsh web --port 8080。端口值来自本次命令行参数,优先于默认配置。
确认是不是端口问题
先查看启动终端。若 DSH 在绑定 3080 时报告地址已被使用,才属于本页问题。若命令根本不存在、Node 版本不支持或进程在配置解析阶段退出,应回到安装与 Web UI 指南或Web UI 启动失败总排查。
你也可以先停止已经运行的旧 DSH 进程,再重试默认端口。不要在不清楚进程用途时强制结束任意占用者;使用新端口通常更安全、也更容易回滚。
为什么 --host 0.0.0.0 不可用
官方 CLI 参考明确说明,当前生产 Web 运行器有意不支持:
dsh web --host 0.0.0.0
该参数会以用法错误退出。这不是端口占用,也不应通过反复换端口解决。DSH 默认只提供本机回环地址,不能把其他 Node Web 项目的公网监听教程直接套用进来。
--trusted-host 用于增加 /api 浏览器信任围栏接受的具名 authority,但它不是“监听所有网卡”的替代参数。需要远程或局域网访问时,应等待或遵循官方部署方案,并额外处理 TLS、认证、反向代理和访问控制,不能只扩大监听范围。
验证修复
- 终端保持运行,没有新的绑定错误。
- 新地址能加载 Web UI。
- 原来的 3080 服务不受影响。
- Settings 和 workspace 入口可用。
- 关闭本次 DSH 后,新端口不再被它占用。
回滚
停止使用 --port 启动的进程,下次不带该参数运行,就会恢复默认 3080。若你同时修改了 Profile patch,请不要假设命令停止后配置也自动恢复;用 dsh --profile web --dump-config 检查实际配置层。
页面打开但输入框不可用通常不是端口错误,请看DSH 工作区未选择。
来源与维护信息
本文根据以下原始资料整理。版本变化后,请以官方资料和页面标注的验证日期为准。