@goodandready/dsh-lanmode

中文文档
0.8.60发布于 2026/11/13MITES Module零依赖近 30 天下载 5079

用于DeepSeek Harness Web UI的局域网和倒置代理访问:返回非本地主机的页面上的设置服务,在Web API中填写浏览器在平原HTTP上所扣留的浏览器,并且可以打开自己的收听器,因此不需要其他内容. 要求 D

中文使用文档
文档目录5 节
  1. 局域网访问 (LAN)、mDNS (dsh.local)、PWA、Root CA、快速二维码、后台推送与自动 TLS …
  2. ⚡ 功能概览
  3. 📦 安装方法
  4. ⚙️ 配置说明 ( cordis.patch.yml )
  5. 📄 开源许可证

📦 @goodandready/dsh-lanmode

局域网访问 (LAN)、mDNS (dsh.local)、PWA、Root CA、快速二维码、后台推送与自动 TLS 支持 (DeepSeek Harness)

npm version license

🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明


⚡ 功能概览

dsh-lanmode 为 DeepSeek Harness 提供完整的局域网与外网安全访问支持:

  1. 📱 Quick QR 快速二维码:侧边栏底部 (Quick QR 位于 sidebar.footer / sidebar.rail) 提供纯 SVG 二维码弹窗,支持移动端扫码即连。终端支持 /mobileqr 工具与 ASCII 二维码输出。
  2. 📲 PWA 与独立应用模式:提供 manifest.json,iOS/Android 全屏独立模式与刘海屏安全边距 (viewport-fit=cover)。
  3. 🌐 自动 mDNS (dsh.local):内置 UDP 5353 responder,自动在局域网广播 dsh.local。
  4. 🔐 本地 Root CA 与 HTTPS:生成 10 年有效期的本地根证书及带 SAN 的服务器证书。访问 /dsh-lanmode/ca.crt 即可一键下载信任。
  5. 🔔 后台通知 (Web Notifications API):在后台标签页接收回合结束与审批请求系统推送。
  6. 🛡️ 安全与认证体系:
    • 登录密码支持纯文本与 scrypt 密钥派生,使用 timingSafeEqual 进行恒定时间比较防时序攻击。
    • LAN PIN 验证:支持纯文本与 PBKDF2 强哈希(pbkdf2$sha512$100000$salt$hash)。5 次失败自动锁定 15 分钟。
    • 设备与会话 Token 均采用 SHA-256 哈希加盐存储。
    • 子网角色分离(adminAllow 与 guestAllow),访客子网禁止改写系统设置。
  7. ☁️ Cloudflare 隧道与 Tailscale Funnel:
    • 支持临时 Quick Tunnel (trycloudflare.com) 与固定 Named Tunnel 模式(Token 通过 TUNNEL_TOKEN 环境变量传递,不暴露在进程列表)。
    • 配置项 tunnelPin 强制外网访问通过 LAN PIN 鉴权。
    • 支持一键开启 Tailscale Funnel,自带权威 Let's Encrypt 证书。
  8. 📱 设备与会话管理:自动识别连接设备型号与操作系统,支持一键撤销单个或全部其它会话。

📦 安装方法

dsh plugin --profile web add @goodandready/dsh-lanmode

⚙️ 配置说明 (cordis.patch.yml)

- id: dsh-lanmode
  config:
    mode: direct
    directPort: 3080
    tunnel: off              # off, quick 或 named
    tunnelPin: true
    tailscaleFunnel: false
    passwordAuth: false

📄 开源许可证

MIT © GooDAnDReaDY

版本与发布记录

@goodandready/dsh-lanmode 共发布 104 个版本,首次发布于 2026/08/21;过去 12 个月发布了 104 个版本。

版本发布日期距今
0.8.60latest2026/11/133 天前
0.8.592026/11/133 天前
0.8.582026/11/133 天前
0.8.572026/11/097 天前
0.8.562026/11/0610 天前
0.8.552026/11/0610 天前

关于 @goodandready/dsh-lanmode 的常见问题

@goodandready/dsh-lanmode 是什么?

用于DeepSeek Harness Web UI的局域网和倒置代理访问:返回非本地主机的页面上的设置服务,在Web API中填写浏览器在平原HTTP上所扣留的浏览器,并且可以打开自己的收听器,因此不需要其他内容. 要求 D

如何安装 @goodandready/dsh-lanmode?

在项目目录运行 npm install @goodandready/dsh-lanmode,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(^4.0.1)、@deepseek-ai/dsh-host-webserver(^0.1.7-rc.2 || ^0.2.0-rc.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@goodandready/dsh-lanmode 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/goodandready__dsh-lanmode 是否存在。

@goodandready/dsh-lanmode 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@goodandready/dsh-lanmode 可以商用吗?

@goodandready/dsh-lanmode 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@goodandready/dsh-lanmode 的下载量有多少?

根据 npm 官方下载统计,@goodandready/dsh-lanmode 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,079 次,日均约 169 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@goodandready/dsh-lanmode 还在维护吗?

最新版本 0.8.60 发布于 2026/11/13(3 天前);至今共发布 104 个版本,其中过去 12 个月发布了 104 个;首次发布于 2026/08/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。