bluecobaltum/dsh-lan-proxy
Project Overview项目介绍
dsh-lan-proxy is a LAN access plugin for the DSH Web UI. It provides a reverse proxy on 0.0.0.0, an in-app directory picker replacing native dialogs, and a UUID polyfill for non-secure contexts. Use it when accessing DSH from LAN devices. Caveat: DSH has no authentication, so exposing the proxy grants remote code execution to anyone on the network; use only on trusted LANs.
dsh-lan-proxy 是 DSH Web UI 的局域网访问插件,提供反向代理、应用内目录选择器和 UUID polyfill 三项能力。适用于需从局域网设备访问 DSH 控制面时。注意:DSH 无认证,暴露代理端口即等同开放远程代码执行,仅建议在可信网络使用。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-lan-proxy(bluecobaltum/dsh-lan-proxy)
仓库:https://github.com/bluecobaltum/dsh-lan-proxy
本站详情页:https://www.yhbd.top/plugins/bluecobaltum-dsh-lan-proxy/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 2 · 最近提交 2026-08-14 · 主语言 TypeScript · 未检测到 DSH 插件清单
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
- Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
- No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项
Compatibility兼容性
- DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
- External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
- Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册
Security安全性
- Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
- Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
- curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
- Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
- Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
- Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式
Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add github:bluecobaltum/dsh-lan-proxy
把 bluecobaltum/dsh-lan-proxy 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-lan-proxy
DeepSeek Harness(DSH)Web UI 的局域网访问插件 —— 一个插件解决三件事:
- 局域网反向代理:在
0.0.0.0:<port>提供完整 Web UI,转发到回环后端并重写 Host/Origin, 使 /api 信任围栏(含特权方法)放行局域网客户端;WebSocket(events.mux / events.host)同样支持。 - 应用内目录选择器:把默认的 native 系统对话框(弹在宿主机桌面、局域网设备看不到)换成 网页内目录浏览器,任何设备都能选工作区。
- UUID polyfill:向页面注入基于
crypto.getRandomValues的crypto.randomUUID兜底, 修复局域网明文 HTTP(非安全上下文)下页面崩溃(如「新建文件夹」报crypto.randomUUID is not a function)。
⚠️ 安全警告:DSH Web 控制面没有任何认证,且 Agent 可执行代码。本插件有意把这一点暴露给网络—— 任何能连到代理端口的人都等于拿到该机器的远程代码执行能力。只建议在可信局域网使用, 并建议配合鉴权层(如 deepseek-harness-auth) 或防火墙白名单。后端本身仍只监听
127.0.0.1,未触碰上游的 loopback 安全边界设计。
安装
把插件目录放入 DSH 可解析的位置(例如仓库 checkout 下的 plugins/dsh-lan-proxy),
在 ~/.dsh/profiles/web/cordis.patch.yml 中挂载:
- id: dsh-lan-proxy
name: 'C:/absolute/path/to/dsh-lan-proxy/src/index.ts'
(发布到 npm 后可用 dsh plugin add dsh-lan-proxy 安装,行名改为包名。)
使用
- 局域网设备访问 http://<本机局域网IP>:8080(默认端口)。
- 点「选择工作区」→ 网页内目录浏览器。
- 无需任何
--host 0.0.0.0、--trusted-host参数;后端保持 loopback。
配置
- id: dsh-lan-proxy
name: '.../src/index.ts'
config:
lanHost: 0.0.0.0 # 代理监听地址
lanPort: 8080 # 代理端口
polyfill: true # UUID polyfill
browsePicker: true # 应用内目录选择器
proxy: true # 局域网反向代理
实现说明
- 代理:
node:http+node:net,纯标准库;请求头重写 Host/Origin 为127.0.0.1:<port>。 - 选择器:
ctx.loader.remove('directory-picker')(触发 auto 清理其创建的 native 行)+loader.create挂 browse 后端与浏览器端 surface。 - polyfill:
ctx.webServer.tapIndex注册页面变换,注入同步脚本(幂等,重复挂载不重复注入)。
许可证
MIT
xmanrui/dsh-im
tencent-connect/dsh-qqbot
flymysql/dsh-remote
whiteguo233/dsh-openbiliclaw
omdsh-dev/dsh-lark
hanshanyike/dsh-yolo
THEWOLFWALKER/dsh-notifier