@goodandready/dsh-lanmode

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

📦 @goodandready/dsh-lanmode

<div align="center">

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

<p align="center">

<a href="https://www.npmjs.com/package/@goodandready/dsh-lanmode"><img src="https://img.shields.io/npm/v/@goodandready/dsh-lanmode.svg?style=flat&color=6366f1" alt="npm version"></a>

<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-10b981.svg?style=flat" alt="license"></a>

</p>

<p align="center">

<a href="README.md"><b>🇬🇧 English</b></a> •

<a href="README.ru.md"><b>🇷🇺 Русский</b></a> •

<a href="README.zh.md"><b>🇨🇳 中文说明</b></a>

</p>

</div>

---

⚡ 功能概览

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