godchen520/dsh-web-remote
DSH 手机/外网远程访问插件:Cloudflare Quick Tunnel 公网隧道 + token 鉴权 + gzip 压缩 + 局域网 HTTPS 直连 + 手机图标面板 + QQ 机器人取链接
已收录
4
Remote
Bundle 已验证
预览
功能介绍
手机/外网远程访问 DSH:Cloudflare Quick Tunnel 公网链接 + 局域网 HTTP/HTTPS 直连(自动生成自签名证书)、token 鉴权、gzip 压缩、常驻手机图标面板(一键复制/二维码),并内置 NapCat QQ 机器人取链接通道。
适合
- 需要通过 Cloudflare Quick Tunnel 或局域网在手机上访问 DSH 的用户。
- 需要 token 保护的远程链接、二维码分享和紧凑应用内控制面板的团队。
- 希望通过集成消息机器人通道获取远程链接的用户。
不适合
- 要求固定公网域名的部署;Quick Tunnel 地址会在重启后变化。
- 无法运行或获取 cloudflared 的环境;首次自动下载需要联网。
- 要求局域网 HTTPS 证书被浏览器直接信任且无警告的用户;自动生成的是自签名证书。
README
dsh-web-remote
| English
手机 / 外网远程访问 DeepSeek Harness(DSH)的插件。随时随地通过微信或浏览器控制你的 DSH。
✨ 功能亮点
| 功能 | 说明 |
|---|---|
| 🌐 公网访问 | Cloudflare Quick Tunnel,无需公网 IP、无需注册,cloudflared 缺失时自动下载 |
| 📡 局域网直连 | HTTP + HTTPS 直连(HTTPS 自动生成自签名证书,零配置) |
| 🔒 安全认证 | 每次启动生成随机令牌;HttpOnly Cookie;局域网可免 token |
| ⚡ 性能加速 | 反向代理自动 gzip 压缩,大历史会话加载更快 |
| 📱 侧边栏图标 | 手机快捷按钮常驻左下角,刷新不消失 |
| 🤖 微信机器人 | iLink 协议直连微信,支持 AI 对话、会话控制、模型切换 |
| 💬 QQ 机器人 | NapCat OneBot 11 反向 WebSocket(施工中) |
🚀 快速开始
三步上手:
# 1. 安装插件(在 DSH profile 目录执行)
cd $DSH_HOME/profiles/web
pnpm add github:godchen520/dsh-web-remote
# 2. 注册 bundle(编辑 package.json)
# 在 "dsh.profile.bundles" 数组中添加 "dsh-web-remote"
# 3. 重启 DSH
dsh web
启动后页面左下角出现 📱 图标 → 点击打开远程面板。
📸 截图
快捷按钮(页面左下角):

远程面板(公网 / 局域网切换、一键复制链接、二维码、启动 / 停止):

📋 安装方式
方式一:GitHub 直接安装(推荐)
cd $DSH_HOME/profiles/web
pnpm add github:godchen520/dsh-web-remote
在 package.json 的 dsh.profile.bundles 数组中添加 "dsh-web-remote",重启 DSH。
--config.minimumReleaseAge=0可绕过 pnpm 11 新包发布年龄校验(如需要)。
方式二:手动 patch
把本包放入 profile 的 node_modules,然后在 cordis.patch.yml 追加:
- insert:
- id: web-remote
name: 'dsh-web-remote'
bundle 方式需重启;cordis.patch.yml 方式会被 HMR 热加载。
⚙️ 配置
全部可选,不配置即开箱即用。在 cordis.patch.yml 里覆盖:
| 参数 | 默认值 | 说明 |
|---|---|---|
targetPort |
3080 |
DSH 自身端口 |
httpPortStart |
3081 |
局域网 HTTP 起始端口(自动跳过占用) |
httpsPortStart |
3082 |
局域网 HTTPS 起始端口 |
qqPortStart |
3001 |
QQ OneBot 桥起始端口 |
cloudflaredPath |
'' |
指定 cloudflared 路径;留空自动探测 / 自动下载 |
pfxPath |
'' |
指定 PFX 证书;留空自动生成自签名 |
pfxPass |
'' |
PFX 密码 |
toolsDir |
'' |
工具与证书缓存目录;留空使用 $DSH_HOME/tools
|
autoStart |
true |
插件加载即自动启动 |
lanOpen |
true |
局域网免 token(私网来源放行) |
📱 使用方法
- 启动后页面左下角出现 📱 图标
- 点击图标 → 面板显示运行状态和链接
- 手机浏览器打开链接即可访问 DSH
公网:https://xxx.trycloudflare.com/?token=...
局域网:https://192.168.x.x:3082(同 Wi-Fi;默认免 token)
🤖 微信机器人
通过微信直接控制 DSH,支持:
远程控制命令:
-
/链接— 获取公网链接(未启动自动开启) -
/停止远程— 关闭远程服务
会话管理:
-
/会话列表— 列出所有会话 -
/选择 N— 选中第 N 个会话 -
/当前会话— 查看选中会话名称 -
/历史内容— 查看会话最近输出
模型切换:
-
/当前模型— 查看当前使用的模型 -
/切换模型— 列出所有模型并切换 -
/选强度 N— 设置思考强度
对话:
- 直接发送内容 → 自动发到选中的会话并回传结果
- 未选择会话时提示先选择
❓ 常见问题
Q: 公网链接打开提示”不安全”? A: 这是 HTTPS 自签名证书的预期行为。手机浏览器选择「继续访问」即可。Edge 需关闭”增强安全性”。
Q: 重启 DSH 后链接变了? A: 公网隧道每次重启会生成新地址,这是正常行为。微信绑定的 token 会自动持久化恢复。
Q: cloudflared 下载失败?
A: 首次启动需要联网下载 cloudflared(约 10MB),之后复用缓存。可手动下载放到 toolsDir 目录。
Q: 微信扫码后断开?
A: 重启 DSH 后微信会自动重连(token 已持久化)。如仍断开,重新发送 /链接 扫码绑定。
📝 更新日志
查看 CHANGELOG.md 了解版本更新历史。
🤝 贡献
欢迎贡献!请查看 CONTRIBUTING.md 了解开发和提交流程。
📄 License
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:godchen520/dsh-web-remote。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。