dsh-phone-pair-kit

dsh-phone-pair-kit

⚠️ 先装手机端 App，否则这个插件没法用

本套件只是电脑那一半。手机那一半是一个单独的 Android App，请先下载安装： Releases → DSH-Phone-Pair-1.0.3.apk （包名 com.dsh.phone.pair）。只装电脑端、没有手机端，是没有任何东西可以配对的。

🧪 请把它当成「公开自测版」

这套东西横跨手机 App、Cloudflare 隧道、固定域名中继、系统代理、各种 Android 版本和浏览器内核， 其中相当一部分 bug 作者在自己的机器上复刻不出来，也就无从定位、无从修复。所以：

• 遇到问题先按下面「排错」表自查一遍，那几条覆盖了目前已知的绝大多数坑；
• 自查无果就是真 bug 了，请在 Issues 里报，并附上： 系统版本、DSH 版本、App 版本、GET /api/pair/status 返回的 tunnel.state 与 relay.state、 以及完整报错文字（截图也行）；
• 你提供的复现信息往往就是修它的唯一线索 —— 只写「用不了」的话，这边大概率还是修不了。

让这台电脑变成可被手机配对的 DSH 主机 —— 也就是 DSH 手机版 · 配对版 App 的服务端那一半。

灵感来源与致谢：本套件只做「插入一段配置、把开关打开」这一件事；配对思路与配对服务端来自上游开源插件 @linxin666/dsh-remote-web-ui （作者 linxin666，源码仓库 https://github.com/zhu1090093659/dsh-web，许可 Apache-2.0）。感谢原作者； 本项目与该作者没有隶属关系，若有任何不妥会立即调整。完整的第三方清单见仓库根目录的 NOTICE.md。

装上它之后，电脑会自己开一条 Cloudflare 隧道，并把这条隧道登记成一个固定域名 https://<id>.dsh-market.com；手机只要配对一次，之后无论在家里还是在外面都能连回来，不用重新扫码。

它到底装了什么

本套件自己的 lib/index.js 不提供任何端点，只写一行日志，所以它不会和别的插件抢资源。

安装

DSH 的插件以「profile bundle」的形式挂载。任选一种：

A. 从目录装（本地开发）

# 把本目录放进某个 profile 的 node_modules，并登记到 bundles
$profile = "$env:USERPROFILE\.dsh\profiles\desktop"
Copy-Item . "$profile\node_modules\dsh-phone-pair-kit" -Recurse -Force
# 然后编辑 $profile\package.json，把 "dsh-phone-pair-kit" 加进 dsh.profile.bundles 数组

B. 从市场装（推荐）

本套件已于 2026-10-15 收录进 DSH 插件市场（awesome-dsh-plugin 目录）， 市场页面：awesome-dsh-plugin.com/p/Zoragyx/dsh-phone-pair--plugin-dsh-phone-pair-kit。 打开 设置 → 插件，搜 dsh-phone-pair 点安装即可，也可以直接复制市场页面给出的安装命令。 投稿材料保留在仓库的 market/ 目录里，供溯源用。别忘了先装上面那个手机端 App， 否则电脑端装好了也没得配。

C. 从 GitHub 装

# 需要本机装了 git —— pnpm 会用 git ls-remote 去问默认分支；
# 没装 git 会报 "'git' 不是内部或外部命令"，那就用 A 方式：
# 在仓库页面点 Code → Download ZIP，解压后把路径指向 plugin\dsh-phone-pair-kit
pnpm add github:Zoragyx/dsh-phone-pair#path:plugin/dsh-phone-pair-kit

装完打开远程访问面板（入口：设置按钮旁边的手机图标，或「设置 → Web 插件 → 远程访问」；单独装插件时在设置的插件行）：面板会显示固定域名和二维码/配对链接。 如果面板提示「当前服务仅绑定在 127.0.0.1 且未配置公网地址」，说明隧道还没起来，看下面「排错」。

手机侧怎么用

1. 手机装 DSH 手机版 · 配对版（Releases 里的 DSH-Phone-Pair-1.0.3.apk，包名 com.dsh.phone.pair）。
2. 电脑上打开「远程访问」→ 复制配对链接（形如 https://<id>.dsh-market.com/pair-accept?pair=xxxx）。
3. 把链接发到手机，点开或在 App 的配对页粘贴，然后设置一个进入密码。
4. 之后每次打开 App：先输密码 → 界面直接用本机缓存渲染，不用重新下载。

前置条件

• DSH >= 0.2.0-rc.2
• Node ^22.19.0 || >= 24.0.0
• 电脑能出网。如果电脑走系统代理（Clash / v2ray 等）：cloudflared 是 Go 程序，只认 HTTPS_PROXY 环境变量，不读 Windows 的 IE/WinINET 代理设置。隧道起不来时先设：

  [Environment]::SetEnvironmentVariable('HTTPS_PROXY','http://127.0.0.1:7897','User')
  [Environment]::SetEnvironmentVariable('NO_PROXY','localhost,127.0.0.1,::1','User')
  

  然后重启 DSH。不设代理也能用，就把这两个变量清空。

安全边界（务必读一遍）

• 配对成功的手机 = 完全控制凭据：它能收发会话、改设置、看产出物。手机丢了就在「远程访问」 面板里撤销那台设备，或者复位手机 App（设置 → 复位本机）。
• 配对/自更新/插件安装这三个控制面仍然只在回环上开放，公网拿不到。
• 服务只绑 127.0.0.1（lanAvailable: false），暴露面只有出站隧道，不需要开 --host 0.0.0.0。
• 一次性配对令牌默认 10 分钟失效；配对成功后手机拿到的是一年期的 HttpOnly Cookie。
• 想彻底关掉：删掉 profile cordis.patch.yml 里指向 remote-web-ui 的条目（或卸掉本套件）， 固定域名立刻失效。

排错

卸载

1. 从 profile package.json 的 dsh.profile.bundles 里移除 dsh-phone-pair-kit。
2. 删掉 node_modules\dsh-phone-pair-kit（可选：一并删掉 @linxin666/dsh-remote-web-ui）。
3. 删掉 profile cordis.patch.yml 里对应的 remote-web-ui 条目，避免残留配置。