dsh-remote-control

配对与使用

1. 在电脑打开 设置 → 远程控制，开启远程入口。
2. 等待 Quick Tunnel 建立并出现二维码。首次启动可能接近一分钟，取决于网络；临时隧道没有稳定域名。
3. 手机相机扫码，在浏览器打开配对页。
4. 填写或确认设备名称，再点击「配对并进入」。 页面不会自动提交；无效名称不会消耗配对码。
5. 手机进入现有 DSH 会话。不同浏览器共享同一 Host 及记录，但可以各自选择不同会话。
6. 在电脑的远程控制设置中重命名或撤销设备。安装 dsh-mobile 后，已配对手机也可在 设备 中修改自己的名称。

电脑需要保持唤醒、联网并持续运行 DSH。每增加一台设备请生成新二维码。配对链接默认两分钟有效，只能领取一次；生成新码会使未领取的旧码失效。

已配对设备再次进入

首次配对成功后，请保存远程首页（https://.trycloudflare.com/），不要把一次性扫码地址当作日常入口。v0.2.2 起，重新打开已清除一次性码的旧配对页时，会尝试使用此浏览器已有的刷新凭证，确认连接后自动进入首页。

凭证只保存在完成配对的浏览器 Cookie 中；换浏览器、使用另一个隐私会话或清除站点数据后，需要新的二维码。恢复失败时页面会区分凭证不可用与临时网络错误，提供重试和首页入口，不会无限跳转。

配置

在 DSH 插件设置中编辑配置，字段及范围如下：

字段	默认值	含义及范围
cloudflaredPath	cloudflared	DSH 电脑上的可执行文件名或绝对路径。
tunnelProtocol	http2	http2 / quic / auto；HTTP/2 不依赖出站 UDP。
startupTimeoutSeconds	60	隧道启动超时，10–180 秒。
pairingTtlSeconds	120	一次性配对码有效期，30–600 秒。
deviceTtlHours	8	访问凭证有效期，1–168 小时。
refreshTtlDays	10	滚动刷新有效期，1–90 天；必须长于访问凭证寿命。
refreshAheadSeconds	300	提前续期时间，30–3600 秒；必须短于访问凭证寿命。
refreshRetrySeconds	30	临时续期失败后的重试间隔，5–60 秒。
maxDevices	4	配对设备上限，1–16。
heartbeatSeconds	15	本机管理页状态流的保活间隔，5–60 秒。

插件使用独立的空 cloudflared 配置和 loopback 桥接，不修改已有 Cloudflare 配置，也不需要改变 DSH 默认监听或信任列表。如果自定义监听触发 LOOPBACK_REQUIRED，请用 dsh web --host 127.0.0.1（或 --host ::1）重启 DSH。