前言¶
DeepSeek Harness (DSH) 的 Web GUI 默认限制访问范围。当用户处于虚拟局域网(如 EasyTier、Tailscale 等)中,或仅需在受信任的本地网络(家庭/办公)访问 Harness 时,默认限制会阻碍直接访问。dsh-lan-access 插件用于解除这些限制,允许 Web 服务绑定到所有接口,并配置仅信任特定局域网权威。
核心功能¶
该插件主要提供以下能力:
- 绑定到所有接口:启用时,Web 服务器绑定到
0.0.0.0,而不仅仅是本地环回地址。 - 受控信任栅栏:
/api浏览器信任栅栏仅接受配置的权威机构。当未配置任何权威机构时,它会回退到 DSH 的自动 LAN 信任机制。 - 启动信息:系统在启动时打印带有令牌的 LAN URL。
- 配置界面:提供一个设置标签页,用于选择用于访问的 LAN IP。
安装与启用¶
使用官方命令安装插件:
dsh plugin --profile web add github:longisland-icetea/dsh-lan-access
安装完成后,需要重启 dsh web 进程使插件生效。
典型用法¶
- 打开设置并导航到“LAN Access”标签页。
- 启用插件。
- 输入 LAN IP 地址(或从检测到的列表中选择)。
- 保存并重启
dsh web。 - 使用
dsh plugin --profile web update dsh-lan-access进行升级。
适用场景与注意¶
- 适用场景:用户已拥有虚拟 LAN 环境,或仅希望在受控的本地网络(如家庭或办公室)内访问 Harness。
- 安全警告:启用 LAN 访问意味着任何能访问该地址的人都可以操作 Harness(远程代码执行)。仅在您控制网络的网络上启用它。不要在公共 Wi-Fi、校园或共享实验室网络上启用。不要转发启动时打印的带有令牌的 URL。
- 维护说明:该插件由 AI 编码代理生成;作者未逐行审查。修改前检查
cordis.patch.yml和lib/client.js。更改设置需要重启。 - 机制细节:在
noAuth模式下,sessionDays无意义。Cookie 基于访问地址,且在dsh web重启后仍然有效。
短结尾¶
该插件通过配置接口绑定和信任栅栏,实现了在受控局域网内的安全访问。建议仅在自有网络中使用,并定期检查源码更新。
GitHub: https://github.com/longisland-icetea/dsh-lan-access