dsh-webroad

Webroad

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:iTrimut/dsh-Webroad#eb3a8ef6f20923d7bdcfccd17df47c8ed46ee1ad

Description

DeepSeek Harness Web GUI one-stop mobile access: header-rewriting proxy (no trustedHosts needed) + 8-digit PIN auth with rate limiting + WebSocket heartbeat + gzip/brotli compression + LAN/public QR codes + cloudflared quick tunnel with auto-restore + optional named-tunnel (fixed domain) mode + phone patches (browse directory picker, AbortSignal/randomUUID polyfill, session bootstrap) + settings-page mobile access tab + bundled SKILL.md (incl. Tailscale Funnel manual path). MIT.

Compatibility and provenance

Webroad is published as dsh-webroad and currently resolves to version 2.0.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: github
Registry updated: 8/27/2026

Versions

1.0.0stable

8/27/2026

2.0.0stable

8/27/2026

1.1.0stable

8/27/2026

Show 1 more versionCollapse versions

1.0.1stable

8/21/2026

Description

README

📱 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

README

📱 dsh-webroad

DSH Web 手机访问一体化插件：设置页内嵌「📱 手机访问」，扫码即用（局域网 + 公网 + 固定域名）

安装（装完重启 dsh web）：

dsh plugin --profile web add <本插件目录绝对路径>

详见 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-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

Webroad

Description

Compatibility and provenance

Versions

Related plugins

Webroad

Description

README

📱 dsh-webroad

DSH Web 手机访问一体化插件：设置页内嵌「📱 手机访问」，扫码即用（局域网 + 公网 + 固定域名）

特性

测试与验证（全部实测通过）

与同类方案的差异

License

Compatibility and provenance

Versions

Related plugins

Related plugins

Related plugins

README

📱 dsh-webroad

DSH Web 手机访问一体化插件：设置页内嵌「📱 手机访问」，扫码即用（局域网 + 公网 + 固定域名）

特性

测试与验证（全部实测通过）

与同类方案的差异

License