- 语言
- JavaScript
- License
- MIT
- 分支
- main
安装
$ dsh plugin --profile web add dsh-lan-access在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 Leon0555/dsh-lan-access:先查看仓库 https://github.com/Leon0555/dsh-lan-access 确认安全性,然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。
让 DeepSeek Harness Web GUI 可在局域网内被其他设备访问的 DSH 插件(可信内网专用)。
- npm: https://www.npmjs.com/package/dsh-lan-access
- GitHub: https://github.com/Leon0555/dsh-lan-access
功能
- 局域网绑定:把 webserver 的
host改为0.0.0.0,手机/其他电脑可通过http://<运行DSH设备的IP>:3080访问(查 IP:ipconfig getifaddr en0)。 - crypto.randomUUID polyfill:浏览器只在安全上下文(HTTPS/localhost)暴露
crypto.randomUUID,局域网明文 HTTP 下不存在,会导致 DSH 的 RPC 全部失败 (项目/会话列表加载不出、无法添加工作区)。本插件向每次返回的 index.html 注入兜底实现,任何设备的浏览器访问都正常。
安装(从 npm)
dsh plugin --profile web add dsh-lan-access
需要 pnpm(
npm i -g pnpm)。本地开发安装可用dsh plugin --profile web add file:/path/to/dsh-lan-access。
安装后重启服务生效:
launchctl kickstart -k gui/$(id -u)/com.dsh.web # 如果用 launchd 常驻
卸载
dsh plugin --profile web remove dsh-lan-access
卸载后 webserver 恢复默认仅 127.0.0.1,polyfill 不再注入。
安全提醒
- 绑定
0.0.0.0后,同一网络内任何设备都能连接 DSH(无认证), 等于整网都能触达本机的命令执行能力。仅限家庭/公司可信内网使用, 公共 WiFi 请勿开启。 - 建议:路由器/防火墙限制来源 IP;出外网访问请叠加 Tailscale 等隧道。
远程访问限制(安全设计,本插件有意不绕过)
DSH 把"配置平面"——**设置页、模型/Provider 管理、凭据、Agent Preset、
目录选择、llm.discoverModels(模型探测)**等接口——硬性限制为仅本机回环
(127.0.0.1)可访问。即使本插件将 Web 服务绑定到 0.0.0.0,这些接口从
局域网 IP 访问仍会返回 HTTP 403(如"加载提供方目录失败: ... HTTP 403")。
这是 DSH 官方刻意的安全边界(dsh-client-connection 的 PRIVILEGED_METHODS):
trustedHosts 白名单只是 DNS 反绑定栅栏,不是认证;在真正的认证层出现
之前,设置/凭据域必须保持仅本机可访问。
本插件不绕过这个栅栏,也不提供代理/端口转发去改写请求头——那会把设置与 凭据侦察能力暴露给局域网内任何设备,违背 DSH 的安全设计。
远程(局域网)可用 vs 不可用
| ✅ 远程正常 | ❌ HTTP 403(仅本机回环) |
|---|---|
| 对话、实时进度 | 设置页(模型、Provider 配置) |
会话内模型选择(llm.providers / llm.models) | 凭据管理(credentials.*) |
| 会话历史、工作区浏览 | Agent Preset 管理 |
| 其余正常 API | 目录选择(host.pickDirectory)、llm.discoverModels |
远程需要改设置怎么办
- 日常路径:在 Mac 本机(
http://127.0.0.1:3080)完成模型/凭据配置, 远程设备只用于对话、看进度、选模型。 - 唯一合规的完整方案:SSH 本地端口转发
ssh -L 3080:127.0.0.1:3080 用户@MacIP,然后访问http://127.0.0.1:3080——从服务端视角这仍是回环访问(不绕过栅栏),且自带 SSH 认证。 ⚠️ 需开启 Mac 的"远程登录";SSH 会把命令行访问权限交给能登录的人, 请自行评估风险。 - 期待官方后续加入真正的认证层后,配置平面可以安全地开放给局域网。
技术说明
- 绑定:以 bundle patch 覆盖
webserver行(host: 0.0.0.0,port 保持ctx.webStartup.port ?? 3080表达式)。 - polyfill:代码行注入
webServer,用官方预留的tapIndex钩子向 index.html<head>注入内联脚本;带幂等守卫,非安全上下文才生效, 本机 localhost 访问不受影响。
许可证
MIT © Leon0555
收录徽章
[](https://deepseek-plugin.org/plugins/Leon0555/dsh-lan-access)把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。