FAQ · 常见问题

答案直接给结论；没覆盖到的问题可以在 GitHub 仓库提 issue。

连接问题

打开链接一片黑 / 一直进不去？

这是还没通过验证的正常状态。输入验证器 App 上的 6 位动态码即可；动态码 30 秒一换，过期就等下一个再输。

动态码总是不对？

• 确认手机时间是自动同步的——验证器依赖时间，偏差大会全部报错。
• 连续输错 5 次会锁定 15 分钟，等锁定结束再试。
• 换手机后验证器没了：在电脑面板「2FA」页签「重置」，重新扫码绑定。

App 显示「尚未连接」？

• 确认电脑端插件在运行、面板顶部显示「隧道就绪」。没有就先在电脑端「停止控制」再重新开启。
• 看 browserctl_frpc.log：token 不一致、服务器端口不在 allowPorts 范围是最常见的两个原因。

网页版在手机浏览器里点返回没反应？

手机浏览器没有系统返回键时，用页面悬浮工具条的返回按钮；工具条长按可以隐藏，再长按唤出。

配对与登录

扫码后为什么只有 1 小时？

「连接」页签的二维码是临时配对，设计上只给一次性使用。要长期免扫码，用「App 配对」页签的码扫码，设备会进入 App 的「我的电脑」，30 天有效。

30 天到期后会发生什么？

设备需要重新扫码验证一次，电脑端不用任何操作。历史设备记录会保留，不会因为到期被清掉。

换手机了怎么迁移？

新手机上扫「App 配对」码重新配对一次即可；旧手机在 App 里删除该电脑，或到面板把旧设备踢下线。

配对码被别人看到怎么办？

临时码 60 秒过期、用一次作废，风险很小。稳妥起见：面板「连接」页签「换一个码」，再到「设备」页签把不认识的会话踢下线；必要时开启 2FA 并重置密钥。

踢下线后对方还能进吗？

不能。被踢设备需要重新通过验证才能建立会话；2FA 开启时必须再输一次动态码。

数据与安全

对话内容会经过你们的服务器吗？

不会。AI 对话全部在电脑本机处理，中转服务器只搬运加密流量，看不到内容。详细说明见安全说明。

我的电脑会因此暴露在公网上吗？

不会。电脑通过隧道主动连出，不开任何入站端口；外部只能看到网关，扫描不到你的机器。

怎么知道有没有别人连过？

面板「设备」页签：在线设备实时可见，历史设备留档显示「多久之前在线、连过几次」；「日志」页签有最近 60 条事件。

部署与更新

一定要用官方网关吗？

不。自建只需要一台服务器：自建教程里的方式 A 只填一个 frps 地址，5 分钟可用；方式 B 走 SSH 一键部署，体验和官方一致。

插件「检查更新」提示清单不是有效 JSON？

官网的 version.json 没部署好或被网关拦了。确认 https://remote.ymzcc.com/dsh-remote/version.json 能直接打开并返回 JSON。

有新版本但 App / 插件说已是最新？

三处版本号（package.json、插件 VERSION 常量、version.json）没同步。逐处核对，详见仓库内的发版说明。

哪里下载最新版？

见更新日志页面的下载入口，地址统一由官网 version.json 提供。

其他

支持 iPhone / iOS 吗？

暂无 iOS App。iPhone 用浏览器打开链接即可使用完整面板，也可以添加到主屏幕当 PWA 用，体验接近原生。

一台电脑能给几个人用？

可以。在「设备」页签能看到所有会话；给别人用建议发临时配对链接（1 小时自动失效），并保留踢下线的习惯。

DSH 重启后要重新配置吗？

不用。DSH 端口每次启动会变，插件自动探测，手机端下次连接就是新端口，配对关系保留。