deepseekplugins

DeepSeek Harness plugin

dsh-web-lan

LAN access layer for DeepSeek Harness (dsh) web — one-command install, default password 123: crypto.randomUUID polyfill for plain-HTTP LAN, a password login gate, a client isLoopback patch so the

Security & Permissions
Jump to install

Source facts

Repository
yes8080/dsh-web-lan
Latest update
Aug 18, 2026
Category
Security & Permissions
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/yes8080/dsh-web-lan
Plugin: dsh-web-lan
Author: yes8080

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-web-lan

让 DeepSeek Harness (dsh) 通过局域网被访问：一条命令安装，默认密码 123， 无需修改任何配置文件。

LAN access layer for DeepSeek Harness (dsh): one-command install, default password 123, no config editing required.

功能 / Features

1. crypto.randomUUID 补丁 — 修复明文 HTTP 局域网（非安全上下文）下 crypto.randomUUID is not a function 导致的整个 /api 层失败； Patches the missing crypto.randomUUID on plain-HTTP LAN origins. 2. 密码登录门 — 未登录只能看到登录页（API/WebSocket 直接 401/断开）； 登录后以回环身份进入 dsh，设置/凭据/Agent 预设等"仅限本机"功能全部可用； Password gate — unauthenticated callers only see the login page; logged-in LAN users get full access (settings, credentials, agent presets). 3. 客户端 isLoopback 补丁 — 修复局域网页面"设置 → 插件配置"空白； Fixes the blank 插件配置 tab on LAN pages. 4. 设置页管理密码 — 设置 → 插件 → 插件配置 的 局域网访问 卡片可 直接改密码，立即生效并持久化；中英文跟随通用设置语言自动切换； Manage the password from the settings page (zh/en follows the General settings language).

快速开始 / Quick Start

dsh plugin --profile web add 'git+https://github.com/yes8080/dsh-web-lan.git'
npm exec @deepseek-ai/dsh web   # 重启 / restart

完成。启动后终端打印 LAN: http://<ip>:3080，局域网用户访问该地址， 用密码 123 登录（首次登录后请尽快在设置页修改）。

That's it. After restart, LAN users open http://<ip>:3080 and sign in with password 123 (change it as soon as possible from the settings page).

> 需要 pnpm：corepack enable pnpm（若未启用）。

密码 / Password

  • 默认 123；安装/启动前可用环境变量覆盖：export DSH_LAN_PASSWORD='强密码'；
  • 登录后：设置 → 插件 → 插件配置 → 局域网访问 卡片修改（立即生效、

写入 ~/.dsh/settings.yaml 持久化）；

  • 高级用户可在 ~/.dsh/profiles/web/cordis.patch.yml 显式覆盖（用户层晚于

插件 bundle 层生效）。

工作原理 / How it works

  • 包装 webServer 的 node:http 处理：未登录 → 登录页 / 401；已登录 →

把 Host/Origin 改写为回环地址，使 dsh 的信任栅栏把局域网用户当作 本机客户端（单共享密码，无多用户）；

  • 会话 Cookie（dsh_lan_session，HttpOnly + SameSite=Strict）持久化到

~/.dsh/dsh-lan-sessions.json，重启不踢人；每 IP 连续 5 次失败锁定 30 秒； 修改密码会立即踢掉其他所有已登录会话（执行改密的会话保留， 泄露的密码一换，其他旧会话全部失效）；

  • 拦截浏览器实际加载的 dsh-client-connection bundle，把 isLoopback

强制为 true（fail-safe：精确匹配标记串才替换，升级不破坏）；

  • 向 settings 服务注册 lan-access 命名空间（密码字段 role('secret')，

任何响应都不携带明文），监听变更并同步到登录门。

安全 / Security

  • 默认密码 123 是公开的 —— 安装后请立即修改或设置环境变量；
  • 密码在局域网内明文传输（HTTP），敏感环境请用 SSH 隧道或 HTTPS；
  • 只在可信的主机名/IP 上登录（DNS rebinding）；
  • 登录后拥有完整权限（含可执行命令的 agent 工具）。

卸载 / Uninstall

dsh plugin --profile web remove dsh-web-lan
# 重启 dsh 生效
npm exec @deepseek-ai/dsh web

卸载后自动恢复：webserver 监听回到默认 127.0.0.1（局域网访问关闭）、 lan-access 行/登录门/浏览器卡片全部移除，不影响其他插件（插件只包装 webserver 请求处理并注册自己的设置命名空间，卸载即还原）。可选清理残留数据：

# 删除设置文档中的 lan-access 段（如曾在页面改过密码）
# 编辑 ~/.dsh/settings.yaml，删除 lan-access: 段
# 删除登录会话文件（让旧会话令牌全部失效）
rm ~/.dsh/dsh-lan-sessions.json

开发 / Development

dsh plugin --profile web add /path/to/dsh-web-lan   # 本地软链安装
npm install                                          # 安装依赖（dsh-settings、schemastery）
node test/integration.test.mjs                       # 纯 Node 集成测试

许可 / License

MIT

Back to searchOpen GitHub repository

More related plugins

View category