手机远程访问 jisvrin/dsh-phone-access

dsh-phone-access

DSH 的手机访问入口。DSH 启动时检查手机端服务，缺失就重建隧道与 web 实例，并把新链接发到邮箱。

作用

DSH 每次启动时加载本插件一次，无论启动方式（双击图标、右键打开、任务栏、命令行）。插件等待 20 秒，随后检查两件事：

- 3081 端口是否有 DSH web 实例在监听
- cloudflared 进程是否存活

两者都在则不执行任何操作；缺任意一个则重启隧道、重启 web 实例、写入新链接，并发送邮件。

插件没有常驻进程，启动后不保留定时器或监听器。20 秒延迟用于避开 DSH 启动过程中结束自身 web 实例的动作。

使用场景

适用：

- 家庭宽带为 CGNAT，没有公网 IP，无法做端口映射或 DDNS
- 电脑长期开机，手机作为输入与查看终端
- 不希望手机安装客户端或开启 VPN
- 可接受链接随重建变化，通过邮件获取新地址

不适用：

- 需要固定域名访问
- 需要手机端离线运行智能体
- 不允许电脑对公网暴露端口
- 非 Windows 系统

手机端与桌面端共用同一份会话库，可查看并继续桌面端的会话。同一会话不建议两端同时输入。

依赖

必需：

- DSH，含 web 配置档（手机访问的即该实例）
- cloudflared（可用 DSH 内置下载的版本）
- PowerShell 7

建议安装：

- dsh-web-mobile，提供手机竖屏排版。未安装时手机打开为桌面布局，控件尺寸与输入区域不适配。

可选：

- SMTP 邮箱，用于自动发送新链接。未配置时链接写在 ~/.dsh/web-service/mobile-urls.txt。

手机端要能正常对话，还需在 DSH 侧配置模型服务商，此部分与本插件无关。

安装

$src = "$env:USERPROFILE\.dsh\profiles\desktop\plugins-src\dsh-phone-access"
git clone https://github.com/jisvrin/dsh-phone-access.git $src

cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-phone-access" "$src"

在 profiles/desktop/package.json 中登记：

"bundles": [ "...", "dsh-phone-access" ],
"dependencies": { "dsh-phone-access": "file:C:/Users/<user>/.dsh/profiles/desktop/plugins-src/dsh-phone-access" }

将 scripts/ 下的三个 ps1 复制到 ~/.dsh/web-service/，重启 DSH 生效。

验证：

Get-Content "$env:USERPROFILE\.dsh\web-service\plugin-trigger.log"
Get-Content "$env:USERPROFILE\.dsh\web-service\mobile-urls.txt"

plugin-trigger.log 出现 apply() called 表示插件已加载。

发信配置

~/.dsh/web-service/mail-config.json：

{
"host": "smtp.qq.com",
"port": 587,
"from": "user@qq.com",
"to": "user@qq.com",
"password": "SMTP 授权码" }

QQ 邮箱的授权码在「设置 → 账户 → 开启 IMAP/SMTP 服务」中生成，不是登录密码。该文件为明文凭据，创建后限制访问权限：

icacls "$env:USERPROFILE\.dsh\web-service\mail-config.json" /inheritance:r /grant:r "$env:USERNAME:(R,W)"

可配置项

| 变量 | 默认值 | 说明 |
| DSH_HOME | %USERPROFILE%\.dsh | DSH 家目录 |
| DSH_MOBILE_PORT | 3081 | 手机端端口 |
| DSH_MOBILE_PROFILE | web | 手机端使用的配置档 |
| DSH_CLI | dsh | dsh 启动器，需在 PATH 中 |
| DSH_MOBILE_CLOUDFLARED | 自动探测 | cloudflared.exe 路径 |
| DSH_MOBILE_DELAY_SECONDS | 20 | 启动后延迟检查的秒数 |

实现要点

--trusted-host 只接受裸主机名。带 https:// 前缀会导致 dsh 拒绝启动，报 trustedHosts entry ... is not a bare host[:port] authority。

不要在 dsh 前部署改写 Host 的反向代理。dsh 签发的 cookie 绑定 authority，Host 被改写后与真实域名不一致，浏览器会陷入 303 重定向循环。

抓取 token 需按当前域名匹配。web.console.log 为追加写入，包含历次启动的 token，直接取最后一条可能取到上一个域名的值。

验证链接需保留 cookie：curl -L -c jar -b jar "<url>?token=..."。缺少 cookie jar 时 303 与 401 会被误判为 token 失效。

重建会同时更换隧道域名和 web token，旧链接随即失效。

卸载

从 package.json 的 bundles 与 dependencies 中移除条目，然后：

Remove-Item "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-phone-access" -Force
Remove-Item "$env:USERPROFILE\.dsh\web-service" -Recurse -Force

许可

MIT