手机如何安全连接电脑的DSH?DSH Mobile局域网访问完整指南:从扫码配对到自动重连

原创2026-11-02 11:55:462,191 阅读

手机如何安全连接电脑的DSH?DSH Mobile局域网访问完整指南:从扫码配对到自动重连

想让手机随时随地操作电脑上的 DeepSeek Harness?DSH Mobile 插件 + Android App 就是答案:通过局域网访问一次扫码配对,即可用 HTTPS 加密通道连接电脑,切换 Wi-Fi、热点或 IP 后还能自动重连,无需重复配置。

DSH Mobile 项目主视觉:手机安全访问电脑中的 DeepSeek Harness

DSH Mobile 是一个 DeepSeek Harness 社区插件,让手机浏览器或 Android App 通过局域网(或可选的远程通道)连接电脑,继续使用同一份会话、工作区、消息和工具,且完全不修改 DeepSeek Harness 源码。整体流程分为三步:电脑装插件 → 手机装 App → 扫码配对,本文带你完整走一遍。

准备工作:安装插件与 App

在开始局域网配对前,先完成两端安装:

  1. 电脑端安装插件:官方 DSH Desktop 用户在 插件 页面安装并启用 dsh-mobile;DSH Web 用户在终端执行 dsh plugin --profile web add dsh-mobile@latest,再运行 dsh plugin --profile web exec dsh-mobile setup 完成局域网初始化(详见 README.md 的快速开始章节)。
  2. 手机端安装 App:从项目 Release 下载正式签名的 Android APK(需 Android 10+)。App 只是轻量 WebView 壳,打开的就是电脑端提供的同一份已认证移动页面,详见 apps/mobile/README.zh-CN.md。
  3. 确保同一网络:手机和电脑连同一个 Wi-Fi、以太网或手机热点,这是局域网访问生效的前提。

💡 setup 会自动选择并记住当前局域网,切换 Wi-Fi 或 IP 变化后通常自动恢复,一般不需要手动指定地址。

扫码配对四步走:开启局域网访问

局域网是默认且最简单的连接方式,也是延迟最低的选择。配对流程如下:

DSH Mobile 局域网访问面板:配对二维码与浏览器访问地址

第 1 步|开启局域网访问:在 DeepSeek Harness 左下角打开 移动访问 → 局域网,若未开启则点击 开启局域网访问。此时插件会生成私有证书并配置独立的移动 HTTPS 入口(默认端口 3443)。

第 2 步|生成配对密钥:点击 生成并复制密钥,面板会立即显示配对二维码,同时给出手机浏览器可直接打开的 HTTPS 地址。

DSH Mobile 配对二维码:扫码建立设备信任

第 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。

离开家网怎么办?远程访问一键切换

局域网只在你与电脑同网时可用。人在外面时,可开启 移动访问 → 远程,按需求选择通道:

DSH Mobile 远程访问通道选择:cpolar、cloudflared 与 Tailscale Funnel

  • 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 路径未放行:

DSH Mobile 连接诊断:检查第三方 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 <需求> 直接定制手机端的界面与功能,把随身终端变成真正的生产力入口。

延伸阅读

登录后查看全文
dsh-mobile