前言¶
DeepSeek Harness（DSH）默认的 Web 访问方式需要启动时打印的 Token 链接，且仅监听本机地址。在本地开发或多设备协作场景下，这种方式不够便捷。dsh-lan-web-access 插件通过在 DSH 的登录检查前增加一层逻辑，为本机提供了免 Token 通道，并独立开启了一个局域网端口，允许在局域网或异地组网环境下，多台设备通过浏览器同时访问同一台 DSH 主机。
插件定位¶
这是一个由 Colin900726 维护的联网工具类插件，开源协议为 MIT。它不替换或拆除 DSH 的任何部件，不兼容时会自动退回官方认证机制。
核心功能¶
- 本机免 Token：在安装插件的电脑上，浏览器直接打开即可使用，无需 Token。
- SSH 隧道免密：通过 SSH 隧道访问时，视同本机访问，免 Token、免密码。
- 局域网访问（默认关闭）：独立监听端口，通过允许列表和管理密码进行访问控制。
- 设备管理：支持添加允许列表、设置管理密码、查看设备状态表、踢出设备。
- 登录页状态：提供五种登录页状态（正常、密码错误、锁定、设备不在列表、未就绪）。
- 访问记录：记录登录、拒绝、退出等事件，最多保留 200 条。
- 运行检查与安全退出：启动时进行五项检查，不兼容时自动停用并交还官方认证。
- 一键更新：支持在插件设置中检查并更新到最新版本。
- 双端双系统：同时支持 Desktop 和 Web 两种模式，以及 macOS 和 Windows 系统。
安装与启用¶
确保电脑上已安装 DSH。通过命令行安装：
# Desktop 模式
dsh plugin --profile desktop add dsh-lan-web-access@latest
# Web 模式
dsh plugin --profile web add dsh-lan-web-access@latest
或者在 DSH 界面中：设置 → 插件 → 添加插件，输入包名 dsh-lan-web-access。
安装后，进入「插件」页确认插件开关已打开，并在「设置 → 局域网 web 访问」中进行配置。
典型用法¶
DSH 默认端口为主端口（Desktop 19387, Web 3080），局域网默认端口为主端口 + 1。
- 主机本机访问
打开http://127.0.0.1:<主端口>，无需 Token。 - 局域网访问
打开http://<主机IP>:<局域网端口>。若设备不在允许列表，需先在主机设置中添加该设备 IP 到允许列表，并输入管理密码。 - SSH 隧道访问
在访问端建立 SSH 隧道：
ssh -N -L <主端口>:127.0.0.1:<主端口> <主机用户名>@<主机IP>
然后访问 `http://127.0.0.1:<主端口>`，无需密码。
注意事项与安全¶
- 网络安全性：局域网模式使用 HTTP，凭据明文传输，同网段设备可能抓包。建议仅在可信内网或使用异地组网（如 Tailscale）时使用。
- 配置安全：密码仅存储 scrypt 散列，配置文件权限为 0600，不会出现在日志或对话中。
- 只读限制：局域网设备只能查看「连接」和「关于」两段设置，无法修改配置或密码。
- 密码重置：忘记管理密码需删除配置文件（
~/.dsh/remote-access.json，Windows 路径略有不同）并重启 DSH。 - 冲突提示：同一台电脑上不要同时运行 Desktop 和 Web，否则设置可能互相覆盖。
结语¶
该插件解决了 DSH 在本地和多设备场景下的访问痛点，提供了从本机免登录到局域网安全管理的完整方案。代码与文档详见 GitHub。
