📱 dsh-webroad
DSH Web 手机访问一体化插件：设置页内嵌「📱 手机访问」，扫码即用（局域网 + 公网 + 固定域名）
把 dsh-pocket 式的一键自动化（改头代理免配 trustedHosts、8 位 PIN + 登录限速、WebSocket 心跳保活、gzip/brotli 压缩、局域网/公网二维码、cloudflared 隧道自动恢复）与自包含文档 + 手机端补丁（browse 目录选择器、polyfill、直达会话引导）结合在一起的 DSH 插件。v2.0 起本仓库合并了原 dsh-remote-pro 的自动化能力（设置页内嵌「📱 手机访问」入口）与原 dsh-Webroad 的 Tailscale Funnel 手动教程（files/ 模板 + SKILL 备选方案节），吸收 dsh-remote-access（Cloudflare 固定域名）为固定域名模式。dsh-remote-pro 名称不再存在，能力并入 dsh-webroad。
安装（装完重启 dsh web）：
dsh plugin --profile web add <本插件目录绝对路径>
使用（推荐）：DSH 界面 → 设置 → 📱 手机访问 → 局域网/公网二维码 + 密码 + 开关全在这里。手机连同一 WiFi 扫局域网码输 PIN 即用；点「开启公网访问」出公网二维码，人在外面（4G/任何网络）也能访问。也可用独立面板 http://127.0.0.1:3081/pocket 或 CLI。
详见 skills/dsh-webroad/SKILL.md（完整自包含文档：关键点总结、架构、安装、使用、排障、验证清单、取代关系）。
特性
- 🏠 设置页内嵌入口（v2.0）：DSH 设置 →「📱 手机访问」— 二维码/密码/开关/免责声明全在设置页内，loopback RPC 驱动
- 📶 局域网扫码：代理自动起在
0.0.0.0:3081，出二维码，手机连同一 WiFi 扫码 + 8 位 PIN 即用（PIN 可关）
- 🌐 公网扫码：cloudflared 快速隧道（免账号免域名），每次开启自动换新 PIN，旧链接作废；服务端强制安全免责声明
- 🔒 安全认证：公网/局域网独立 8 位 PIN；登录限速（单 IP 5 次/60s 锁 60s + 全局锁）；HttpOnly cookie 会话保持（绑定 dsh web 进程）
- ⚡ 实时可靠：WebSocket 全透传 + 协议层心跳保活（防 NAT/省电静默断链，断线自动重连）
- 🗜️ 省流量：大 JSON 自动 gzip/brotli 压缩（17MB 长会话 → ~1MB）
- 🧩 零配置围栏：改头代理让信任围栏永远看到 loopback，不改 DSH 任何配置
- 📱 手机端补丁：browse 目录选择器 +
crypto.randomUUID/AbortSignal.any polyfill + 首次打开直达会话
- 🔁 隧道自动恢复：DSH 重启后自动重新拉起公网隧道（已实测）
- 🏷️ 固定域名（可选）：
$DSH_HOME/dsh-webroad/named/ 放 config.yml + credentials.json 即复用你自己的 Cloudflare 命名隧道
- 🔧 CLI：
dsh-webroad status | qr | public on|off | pin set|rotate
测试与验证（全部实测通过）
npm install
npm test # 9 项单元测试：改头/压缩/认证限速/WS 心跳/面板 API/隧道 URL/LAN IP
node scripts/verify-live-panel.mjs # 真实 dsh web 端到端：登录→面板→二维码→WS 101
node scripts/e2e-panel.mjs # 独立进程完整浏览器流程（登录页→302→面板脚本编译→QR）
已实测：真实 dsh web 冒烟 10/10、公网快速隧道开启并经 Cloudflare 边缘访问、隧道自动恢复、设置页 client 注入（boot manifest 条目 + /plugins/dsh-webroad/client.js）。
与同类方案的差异
| dsh-webroad v2.0 | dsh-pocket | dsh-remote-access（已归档删除） |
|---|
| 设置页入口 | ✅ 内嵌「📱 手机访问」 | ✅ 设置页签 | ❌ |
| 安装后即用 | ✅ 扫码即用 | ✅ | ❌ 手动搭 |
| 信任围栏 | 改头代理（零配置） | 改头代理（零配置） | 手动 trustedHosts |
| 固定域名 | ✅ 可选（命名隧道） | ❌ 随机 URL | ✅（已并入本插件） |
| Funnel 手动教程 | ✅ 保留（files/ + SKILL 备选节） | ❌ | ❌ |
| 许可 | MIT | GPL-2.0 | MIT |
| 文档 | SKILL.md 自包含 + 验证清单 | README | SKILL.md |
License
MIT —— 自由使用 / 修改 / 再分发。实现为原创代码（借鉴公开的"host rewrite 反向代理"通用思路与 DSH client 插件机制，未复制 dsh-pocket 的 GPL 代码）。
Made by @iTrimut
