在使用 DeepSeek Harness (DSH) 进行开发或调试时,通过反向代理访问 Web GUI 常会遇到一些限制。例如,设置面板无法打开、WebSocket 连接中断,或者移动端访问时因缺少认证凭证而报错。为了解决这些问题,社区开发者 xchannel1987 提供了 dsh-reverse-proxy-xc 插件。
下面介绍该插件的功能、安装与使用方法。
是什么¶
这是一个为 DSH 0.1.7 及以上版本设计的局域网反向代理插件。它运行一个独立服务,监听 0.0.0.0:3090 端口,将来自局域网设备的请求转发到 DSH 主服务,并自动处理必要的 Header 改写和认证注入,使手机或平板等设备能获得与本地 127.0.0.1:3080 完全一致的体验。
核心功能¶
- 完整功能访问:侧边栏、会话列表、设置面板、凭据管理均正常可用;WebSocket 支持实时事件推送。
- 兼容性修复:自动注入环境标志以通过前端环境检测;自动注入
randomUUIDpolyfill;自动处理移动端访问时的认证凭证。 - 请求处理:独立服务监听 0.0.0.0:3090;请求转发到 DSH 主服务;Header 改写为回环地址;HTML 注入必要的脚本。
- 安全与控制:局域网限定;配置可控,支持端口、认证等参数调整。
安装与启用¶
安装插件需要使用 DSH CLI。安装完成后,请重启 DSH 服务。
dsh plugin --profile web add dsh-reverse-proxy-xc
安装成功后,在 DSH 设置页面的「局域网反向代理」分区中打开「启用代理」开关即可启动服务。
典型用法¶
- 确保目标设备(如手机或平板)与 DSH 主机在同一局域网内,或已通过 VPN 连接。
- 在目标设备的浏览器中访问代理地址:
http://<主机内网IP>:3090
- 示例:
http://10.100.50.125:3090
适用场景与注意¶
- 环境要求:DSH 版本需 >= 0.1.7。仅适用于内网或 VPN 环境。
- 网络安全:不要将服务暴露到公网。涉及敏感操作,请确保网络安全。