dsh-pocket-ios
Verifieddsh-pocket-ios · v0.2.5 · GPL-2.0 · Web UI
在 DSH 设置页加入 iOS 客户端下载二维码与连接引导(配合 dsh-pocket + DSH Pocket iOS)
Install
dsh plugin add dsh-pocket-ios Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-pocket-ios(DSH 插件)
给 DSH 桌面端加一个原生设置页 设置 → 手机访问(iOS):一个一次性配对二维码,iPhone 上的 DSH Pocket 扫码即连,全程不需要输入密码。
- 自带稳定本地入口代理(默认
127.0.0.1:3091→ DSH web),改写了Host/Origin,经 Tailscale / 代理访问不会再被 DSH 的 browser-auth 判为不可信; - 二维码是一次性配对码:60 秒有效、用后作废、每约 50 秒自动轮换,不包含长期密码;
- 长期密码只保存在本机(
~/.dsh/dsh-pocket-ios/pin,权限 600),用于手动登录; - 设置卡片跟随 DSH 界面语言自动中英文切换;
- 不依赖
dsh-pocket,可与它同时安装(3091 / 3081 互不冲突)。
安装
dsh plugin add dsh-pocket-ios
安装后重启 DSH 并刷新页面(client 模块在启动时加载)。
App:https://apps.apple.com/app/id6832288744(DSH Pocket iOS)。
设置页位置:账号与余额 → 通用设置 → 手机访问 → 手机访问(iOS) → 模型。
连接流程
方式一:Tailscale(推荐,地址固定)
Mac 与 iPhone 安装 Tailscale,登录同一账号;
Mac 执行一次:
tailscale serve --bg 3091(Tailscale 后台 DNS 页需开启 HTTPS Certificates)
打开 DSH → 设置 →「手机访问(iOS)」,用 DSH Pocket 扫卡片上的二维码;
自动登录,无需密码。
读不到 Tailscale 状态时,可手写配置:
mkdir -p ~/.dsh/dsh-pocket-ios echo '{"url":"https://你的机器名.你的tailnet.ts.net"}' > ~/.dsh/dsh-pocket-ios/tailscale.json
方式二:dsh-pocket(局域网/公网,不装 Tailscale)
- 安装
dsh-pocket插件(它负责局域网/公网通道); - DSH → 设置 →「手机访问」用它的局域网/公网二维码连接;
- 在 DSH Pocket 里输入它显示的访问密码。
方式二不需要本插件也能连;本插件提供的是扫码免密与统一设置页。
端口
- 稳定入口默认 3091(避开 dsh-pocket 的 3081);
- Tailscale Serve 指向 3091:
tailscale serve --bg 3091; - 改端口:
DSH_POCKET_IOS_PROXY_PORT=<port> dsh start,并同步tailscale serve; - 代理只监听 loopback(
127.0.0.1)。
安全
- 密码/token 不写入日志、不进入构建产物、不进入 Git;
- 二维码只含一次性配对 token,不含长期密码;
- 配对登录通过 DSH 自带
connection.authenticatedUrl换dsh-authcookie,不另造会话体系; - 配对 token 只存内存,60 秒过期、单次使用。
开发
npm install
node --check lib/index.js && node --check client/client.js
npm pack --dry-run
License
GPL-2.0,见 LICENSE。