godchen520/dsh-web-remote
DSH手机/外网远程访问插件:Cloudflare Quick Tunnel公网隧道 + token鉴权 + gzip压缩 + 局域网HTTPS直连 + 手机图标面板 + QQ机器人取链接
Project Overview项目介绍
dsh-web-remote is a DSH plugin that enables remote access to DeepSeek Harness. It provides public network access via Cloudflare Quick Tunnel without requiring a public IP or registration, supports LAN HTTP/HTTPS direct connections with auto-generated self-signed certificates, and integrates WeChat (iLink) and Feishu (WebSocket) bots for remote control, model switching, session management, and completion notifications. Use it to access DSH from mobile or external networks when no public IP is available. Note: self-signed HTTPS certificates trigger browser security warnings requiring manual bypass, and the public tunnel URL changes on each restart.
dsh-web-remote 是 DSH 远程访问插件,通过 Cloudflare Quick Tunnel 提供免公网 IP 的公网访问,同时支持局域网 HTTP/HTTPS 直连,并集成微信 iLink 和飞书 WebSocket 机器人,可在手机或外网控制 DSH、切换模型、管理会话、监听思考完成通知。适用于无公网 IP 又想随时远程使用 DSH 的场景。注意:自签名 HTTPS 证书会触发浏览器"不安全"提示,需手动放行;公网隧道地址每次重启会变化。
请帮我了解并安装插件:【dsh-web-remote】【https://github.com/godchen520/dsh-web-remote】
Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add github:godchen520/dsh-web-remote
把 godchen520/dsh-web-remote 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-web-remote
中文 | English
手机 / 外网远程访问 DeepSeek Harness(DSH)的插件。随时随地通过微信或浏览器控制你的 DSH。
✨ 功能亮点
| 功能 | 说明 |
|---|---|
| 🌐 公网访问 | Cloudflare Quick Tunnel,无需公网 IP、无需注册,cloudflared 缺失时自动下载 |
| 📡 局域网直连 | HTTP + HTTPS 直连(HTTPS 自动生成自签名证书,零配置) |
| 🔒 安全认证 | 每次启动生成随机令牌;HttpOnly Cookie;局域网可免 token |
| ⚡ 性能加速 | 反向代理自动 gzip 压缩,大历史会话加载更快 |
| 📱 侧边栏图标 | 手机快捷按钮常驻左下角,刷新不消失 |
| 🔗 自定义公网链接 | 支持填写自定义公网 URL(如 ngrok),面板编辑/清除,重启后生效 |
| 🔌 自定义端口 | 局域网模式下可修改 HTTPS 端口号,带端口占用检测 |
| 🤖 微信机器人 | iLink 协议直连微信,支持 AI 对话、会话控制、模型切换 |
| 💬 飞书机器人 | WebSocket 长连接,支持命令控制、会话监听通知 |
| 👁️ 会话监听 | /监听 命令,Agent 思考完毕自动微信/飞书通知 |
⚡ 一句话安装
复制下面这句话给你的 DSH,它自己会装好一切:
请帮我安装 dsh-web-remote 远程访问插件(https://github.com/godchen520/dsh-web-remote),装完告诉我如何重启 DSH Web。
不想麻烦 Agent?命令行一条:
dsh plugin --profile web add github:godchen520/dsh-web-remote && 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)
面板新功能(v1.3.0):
- 公网标签页:可填写自定义公网 URL(如自己的 ngrok 地址)
- 局域网标签页:可点击端口号直接修改 HTTPS 端口
🤖 微信机器人
通过微信直接控制 DSH,支持:
远程控制命令:
/链接— 获取公网链接(未启动自动开启)/停止远程— 关闭远程服务/监听— 开启/关闭会话监听模式(思考完毕自动通知)
会话管理:
/会话列表— 列出所有会话/选择 N— 选中第 N 个会话/当前会话— 查看选中会话名称/历史内容— 查看会话最近输出
模型切换:
/当前模型— 查看当前使用的模型/切换模型— 列出所有模型并切换/选强度 N— 设置思考强度
对话:
- 直接发送内容 → 自动发到选中的会话并回传结果
- 未选择会话时提示先选择
💬 飞书机器人
通过飞书直接控制 DSH,支持:
远程控制命令:
/链接— 获取公网链接/停止远程— 关闭远程服务/监听— 开启/关闭会话监听模式/帮助— 显示命令列表
绑定方式: 在 DSH Web 面板 → 机器人标签页 → 飞书,填写 App ID 和 App Secret,点击绑定。
❓ 常见问题
Q: 公网链接打开提示"不安全"? A: 这是 HTTPS 自签名证书的预期行为。手机浏览器选择「继续访问」即可。Edge 需关闭"增强安全性"。
Q: 重启 DSH 后链接变了? A: 公网隧道每次重启会生成新地址,这是正常行为。微信绑定的 token 会自动持久化恢复。
Q: cloudflared 下载失败?
A: 首次启动需要联网下载 cloudflared(约 10MB),之后复用缓存。可手动下载放到 toolsDir 目录。
Q: 微信扫码后断开?
A: 重启 DSH 后微信会自动重连(token 已持久化)。如仍断开,重新发送 /链接 扫码绑定。
📝 更新日志
查看 CHANGELOG.md 了解版本更新历史。
🤝 贡献
欢迎贡献!请查看 CONTRIBUTING.md 了解开发和提交流程。
ccch1mneyyy/dsh-TUI
shaobeichen/dsh-pocket
ningbainb/deepseek-harness-desktop
chokwinlee/deepseek-harness-desktop
dclichang2022/dsh-green-meter
SCSpotato/dsh-remote
omdsh-dev/dsh-notification
mrRisega/dsh-remote