在阿里云 ECS 上给 DSH 搭一条只读的手机入口
dsh-in-hand 把 DSH 的会话、后台任务、子代理、目标、工作流、待审批项收成一屏,侧栏和手机网页共用,装成 PWA 就是 App。当前 latest 1.9.1(2026-11-18 发布),Apache-2.0,dependencies 为空,engines 是 Node >=20、dsh >=0.2.1-rc.2 <0.3.0。站内快照:星标 105、周下载 1,241、综合分 57.0,信任档位「已验证 · L5 运行时冒烟」,实装验证跑的是 v1.8.28。安全扫描尚无风险分级,不等于没有风险。
为什么必须有一台有公网入口的机器
跑 DSH 的机器通常在家里的 NAT 后面:没有固定公网 IP,路由器也不开端口映射。插件「不做鉴权、只监听回环」,DSH 默认 danger-full-access——把 3080 暴露到公网,等于把能执行命令的机器挂上互联网。
分工:ECS 上装什么,本机装什么
ECS 侧要的不多:最小规格实例、Alibaba Cloud Linux 3 或 Ubuntu、nginx、一个能跑 ssh 的普通账号。安全组只放 443/tcp,22/tcp 限定源 IP,3080 / 3099 不进安全组;域名和备案会卡住第一天。
本机需 Node >= 20,且 DSH 的 Web 端口为 3080(见坑二);只有把中继放到 ECS 当「远端中继」时,ECS 才需要 Node。
装插件,然后重启
dsh plugin --profile web add dsh-in-hand
装完必须重启 DSH:插件行来自 profile 的 bundle 图,client 侧模块元数据按 specifier 缓存,增删插件一律要重启——桌面端关掉再开,命令行 dsh web。
只读中继:自己写的时候不能省的四条
插件不做鉴权,转发层得自己负责。配套中继是几十行零依赖 Node 脚本,只转发白名单路径,其余 404。
- 白名单硬编码。不要让上游路径可配置,否则它就是一个任意代理。
- 只允许 GET / HEAD,不接受请求体,不转发
/api。 - 自带共享令牌,用
timingSafeEqual做定长比较,并且不要把令牌转发给上游。 - 转发时必须带上查询串。
nginx:只做 TLS 终止
nginx 只监听 443,证书用阿里云签发或 Let's Encrypt 都行,proxy_pass 到 ECS 一侧的隧道端口:
server {
listen 443 ssl;
server_name watch.example.com;
ssl_certificate /etc/nginx/cert/fullchain.pem;
ssl_certificate_key /etc/nginx/cert/privkey.pem;
location / {
proxy_pass http://127.0.0.1:3099;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}
SSH 反向隧道:方向比参数重要
ssh -N -R 3099:127.0.0.1:3099 you@<ecs-ip>
方向是全部要点:连接由本机发起,本机不需要公网 IP,路由器不需要端口映射,服务器也不需要为 3080 开入站规则。GatewayPorts no 会把 -R 监听绑在 ECS 回环上。
手机配对:v3 票据是主路,6 位码是兜底
v1.9.0 起,桌面侧栏多了「手机配对」,屏幕上出一张二维码。码里装的是 v3 一次性换路票据:60 秒有效、绑受众 remote、用后即焚;手机扫到后由中继兑换,种 30 天 cookie,302 回 /taskwatch。
密钥两边共用 ~/.dsh/taskwatch-ticket.key(v1.7.2 起就有),中继不用改。v1.9.1 补的是把密钥送到服务器的手段——install-relay.sh --ticket-secret-file 或 TASKWATCH_TICKET_SECRET,校验 ≥32 字符,写进 /etc/taskwatch-relay/env(幂等),服务在跑就重启。
6 位码退成兜底:面板向本机中继取码,2 分钟有效、5 次、一次性。v1.9.0 加了三条宿主路由——GET /taskwatch/pair/info(只读)、POST /taskwatch/pair/link、POST /taskwatch/pair/code(中继不在本机回 409、拒绝回 502)。
验收点
按顺序过一遍:ECS 上 curl -I http://127.0.0.1:3099/ 有响应;浏览器打开 https://<域名>/ 能看到面板;手机扫码落在 /taskwatch;点撤销后请求回 401。
坑一 · 安全组顺手把 3080 也放了出去
现象:手机能打开页面,但能从外网直接命中 DSH 接口。原因:插件不做鉴权、只监听回环,DSH 默认 danger-full-access;把 3080 或 3099 加进安全组,整条链路就被绕过。解决:安全组只留 443 和管理 22。
坑二 · 桌面版端口不是 3080
现象:手机页能打开,但 /taskwatch/data 回 502,显示「对话功能不可用」。原因:中继上游写死 http://127.0.0.1:3080,桌面版却把 --port 0 写死在 app.asar 里,每次启动随机端口,也没有端口环境变量。解决:用补丁层覆盖 web-app 的 webserver 行(~/.dsh/profiles/desktop/cordis.patch.yml),这是升级不丢的入口。
坑三 · 补丁层是整段替换,不是深合并
现象:改完端口 DSH 起来了,但某些正常配置项消失了。原因:补丁层对 config 是整段替换,少写一个字段等于删掉它;改端口还要同改 port、services-watchdog.ps1 的 RELAY_UPSTREAM、文档。解决:改前整段抄下原配置;中继的 UPSTREAM 启动时读取,必须重启。
坑四 · 远端中继的版本或密钥对不上
现象:二维码扫完落到配对页,只能用 6 位码。原因:中继低于 v1.1.0,或两边票据密钥不同(TASKWATCH_TICKET_SECRET,≥32 字符)。解决:确认中继 ≥ v1.1.0、/etc/taskwatch-relay/env 与 ~/.dsh/taskwatch-ticket.key 一致,改完重启,v2 过渡期到 2027-01-01。
总结
这套结构的成本不在代码,而在「方向」:隧道由内向外、安全组只留 443、中继只认白名单,三件事做对,剩下都是配置。想先看同类插件怎么归档的,可以从 精选插件 Top 榜 翻。
适合与不适合
适合:一个人用一台开发机、经常离开工位但需要批准高危动作的人;家里没有公网 IP、不想把 DSH 暴露出去的人;已有 ECS 和域名的人;需要在手机上处理一次性审批的人。
不适合:团队多人共用一台机器——它是「一个人 + 几台设备」的模型,设备撤销只有单机列表;只想在手机上看日志的人,为配对和隧道付出的成本过高;安全合规要求远程入口统一过网关的组织,它不提供企业级鉴权。
标签:dsh-in-hand、DeepSeek Harness、手机入口、阿里云 ECS
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。