DeepSeek Harness (DSH) 的 dsh web 默认将 Web 服务器绑定到本地回环地址,这限制了访问范围。当需要在同一台机器或其他网络节点上访问 Web 界面时,就需要修改绑定地址。dsh-remote 插件通过将绑定地址从 127.0.0.1 改为 0.0.0.0,实现了这一功能。
是什么¶
dsh-remote 是一个由 anthony1x6000 维护的插件,它通过修改配置层,将 DeepSeek Harness 的 Web 服务器的监听地址从本地回环 (127.0.0.1) 切换为所有网络接口 (0.0.0.0),从而允许远程网络访问。
核心功能¶
- 启用
dsh web的远程网络访问。 - 将 Web 服务器绑定到
0.0.0.0。 - 自动发现局域网内的非内部 IPv4 地址。
- 生成包含认证令牌的局域网访问 URL。
- 提供验证测试(selfcheck)。
安装与启用¶
安装前需确认当前使用的 profile 包含 webserver 行(例如默认的 web profile)。
- 执行安装命令:
dsh plugin --profile web add "github:anthony1x6000/dsh-remote#main"
- 验证配置是否生效(无需重启):
dsh --profile web --dump-config | grep -B 1 -A 4 webserver
- 重启
dsh web。打包安装需要重启才能生效,仓库插件无需重启。
典型用法¶
安装并重启后,直接启动 dsh web 即可:
dsh web
启动成功后,终端会输出当前访问地址及局域网访问地址,包含认证 Token:
dsh web: http://127.0.0.1:3080?token=... (LAN: http://192.168.x.x:3080?token=...)
若不想修改持久化配置文件,可使用临时补丁参数启动:
dsh web --patch <path-to>/cordis.patch.yml
适用场景与注意¶
- Profile 限制:插件必须安装到
webprofile,且该 profile 必须包含webserver行。在仅包含基础 bundle 的 profile 上安装会报错。 - 环境依赖:安装过程需要
pnpm。 - 重启要求:打包安装需要重启进程才能加载新的配置层。
- 许可证:MIT License。
总结¶
dsh-remote 通过极小的配置变更,解决了 DSH Web 界面无法被局域网访问的问题。适合需要在本地开发机或同一局域网内其他设备上调试 DeepSeek Harness 的场景。