手机如何安全连接电脑的DSH?DSH Mobile局域网访问完整指南:从扫码配对到自动重连
手机如何安全连接电脑的DSH?DSH Mobile局域网访问完整指南:从扫码配对到自动重连
想让手机随时随地操作电脑上的 DeepSeek Harness?DSH Mobile 插件 + Android App 就是答案:通过局域网访问一次扫码配对,即可用 HTTPS 加密通道连接电脑,切换 Wi-Fi、热点或 IP 后还能自动重连,无需重复配置。
DSH Mobile 是一个 DeepSeek Harness 社区插件,让手机浏览器或 Android App 通过局域网(或可选的远程通道)连接电脑,继续使用同一份会话、工作区、消息和工具,且完全不修改 DeepSeek Harness 源码。整体流程分为三步:电脑装插件 → 手机装 App → 扫码配对,本文带你完整走一遍。
准备工作:安装插件与 App
在开始局域网配对前,先完成两端安装:
- 电脑端安装插件:官方 DSH Desktop 用户在 插件 页面安装并启用
dsh-mobile;DSH Web 用户在终端执行dsh plugin --profile web add dsh-mobile@latest,再运行dsh plugin --profile web exec dsh-mobile setup完成局域网初始化(详见 README.md 的快速开始章节)。 - 手机端安装 App:从项目 Release 下载正式签名的 Android APK(需 Android 10+)。App 只是轻量 WebView 壳,打开的就是电脑端提供的同一份已认证移动页面,详见 apps/mobile/README.zh-CN.md。
- 确保同一网络:手机和电脑连同一个 Wi-Fi、以太网或手机热点,这是局域网访问生效的前提。
💡
setup会自动选择并记住当前局域网,切换 Wi-Fi 或 IP 变化后通常自动恢复,一般不需要手动指定地址。
扫码配对四步走:开启局域网访问
局域网是默认且最简单的连接方式,也是延迟最低的选择。配对流程如下:
第 1 步|开启局域网访问:在 DeepSeek Harness 左下角打开 移动访问 → 局域网,若未开启则点击 开启局域网访问。此时插件会生成私有证书并配置独立的移动 HTTPS 入口(默认端口 3443)。
第 2 步|生成配对密钥:点击 生成并复制密钥,面板会立即显示配对二维码,同时给出手机浏览器可直接打开的 HTTPS 地址。
第 3 步|手机扫码:打开 DSH Mobile App,进入 局域网访问 页面,App 会自动扫描发现局域网内的电脑;点击设备后扫描二维码(或手动粘贴配对密钥、输入 IP:端口 地址)即可完成配对。
第 4 步|建立持久信任:配对成功后,手机会建立持久设备信任。以后打开 App 会自动发现并连接这台电脑;切换 Wi-Fi、热点或 DHCP 地址变化,通常都不需要重新配对。
不装 App 也可以:点击 复制配对链接 在手机浏览器中打开。局域网使用私有证书,浏览器首次访问可能提示"不受信任",确认是自己的 DSH 网关后再按提示继续即可;dsh1. / dsh2. 开头的密钥只给 App 使用,不要填入浏览器配对框。
自动重连与设备管理:一次配对,长期使用
配对完成后,DSH Mobile 会在后台持续维护连接:
- 自动发现与续期:App 同时使用 DNS-SD/mDNS、UDP 公告与端口 3443 主动查询来发现局域网内的电脑,只向已保存的精确 Origin 续期短期会话,地址变化后也能在原有证书校验下续期。
- 启动行为可选:默认"直接进入 DSH",单设备直连、多设备优先最近使用的一台;也可以在设备列表 → 设置中改为每次启动显示设备列表,方便在多台电脑间切换。
- 状态一目了然:每条配对记录显示名称、连接方式、可达状态(绿点表示可达)和最近连接时间;长按设备行可重命名、立即检测、重新配对或删除本地记录。
- 多通道独立管理:局域网与远程是两套相互独立的连接,同一台电脑可能分别有两条记录,授权彼此独立,互不影响。
相关能力由 App 原生的连接策略实现,例如 ConnectionRestorePolicy.kt、LanDiscovery.kt 与 PairingTrust.kt。
离开家网怎么办?远程访问一键切换
局域网只在你与电脑同网时可用。人在外面时,可开启 移动访问 → 远程,按需求选择通道:
- cpolar:适合国内网络环境,安装官方组件、粘贴 Authtoken 即可连接;
- cloudflared:快速隧道免注册,命名隧道可绑定固定域名,是长期使用最稳定的选择;
- Tailscale Funnel / 自建 FRP / 自有反向代理:面向更可控的高级场景。
远程访问默认关闭,手机不需要安装任何隧道客户端。状态变为"远程访问已就绪"后,点击 生成远程配对二维码,在 App 中选择 远程访问 扫码即可完成配对;以后 App 使用保存的地址与凭据自动重连,临时地址变化时重新扫码验证新地址即可,无需清除 App 数据。各通道配置详见 docs/CLOUDFLARE_TUNNEL.md、docs/SELF_HOSTED_FRP.md 与 docs/SELF_HOSTED_ORIGIN.md。
安全机制:DSH Mobile 为什么可以放心用
"手机操作电脑"听起来敏感,DSH Mobile 的安全设计恰恰是它的核心卖点:
- 纵深加密:局域网走插件生成的私有 CA 证书,公开远程入口使用系统信任的 HTTPS 证书,App 还会固定校验证书指纹(网络策略见 network_security_config.xml);
- 凭据安全存储:Token 与 CA 由 Android Keystore 加密保存,设备令牌只发往精确 Origin,第三方 WebSocket 默认拦截;
- 最小暴露面:未配对请求无法进入 DSH,移动网关只在开启时才监听局域网,关闭后 DeepSeek Harness 照常在本机运行。
⚠️ 请注意:配对设备拥有操作电脑端 DSH 的能力,应视为完全受信任设备;手机丢失时,第一时间在电脑端 移动访问 中撤销该设备。完整安全说明见 SECURITY.md。
连接故障排查:用诊断面板快速定位
连不上或一直"重连中"时,先别急着重置,打开 移动访问 → 诊断 一键检查版本、网关、网卡、防火墙和远程通道,报告会自动脱敏。第三方插件(如侧边栏终端、实时黑板)连不上时,通常是其 WebSocket 路径未放行:
在 连接诊断 → 第三方 WebSocket 路径 中,只对确认过的精确路径点击允许即可,放行只代表该路径可通过已认证网关,不会开放任意端口。页面能打开却反复重连时,可参考 docs/SLOW_CONNECTIONS.md 区分 WebSocket 升级失败、慢速同步与心跳超时;局域网历史验证记录见 docs/DSH_0.1.5_LAN.md。
总结:一次配对,长期安心
| 步骤 | 操作 | 效果 |
|---|---|---|
| 1️⃣ 电脑装插件 | 安装并启用 dsh-mobile,运行 setup |
生成局域网 HTTPS 入口 |
| 2️⃣ 手机装 App | 安装正式签名 APK(Android 10+) | 获得原生设备列表与通知 |
| 3️⃣ 扫码配对 | 局域网/远程二维码各扫一次 | 建立持久设备信任 |
| 4️⃣ 自动重连 | 切换 Wi-Fi、热点或 IP | 通常无需重新配对 |
从扫码配对到自动重连,DSH Mobile 让"手机安全连接电脑的 DSH"变成一次性的配置动作。装好之后,你还可以在 DSH 对话里用 /mobile <需求> 直接定制手机端的界面与功能,把随身终端变成真正的生产力入口。
延伸阅读
- 官方完整说明:README.md
- Android App 使用手册:apps/mobile/README.zh-CN.md
- 安全模型详解:SECURITY.md
- 第三方插件 WebSocket 放行与皮肤适配:docs/SKIN_COMPATIBILITY.md




