FDM Android 远程控制配对失败排查

核心架构回顾

FDM 远程控制的通信链路是：

Android FDM  ←─ TCP 连接 ─→  PC / Mac FDM（远程控制服务）
                IP:Port

两端直接通过 TCP socket 通信（FDM 内置的远程控制服务监听一个端口），不经过任何中间服务器（FDM 官方不做中继）。这意味着：

• 两端必须能直接到达彼此（网络互通）
• 需要端口映射 / 公网 IP（跨网络时）
• 两端都必须运行 FDM

场景一：同 Wi-Fi 下配对不上

这是最常见的场景——手机和电脑在同一个家里的 Wi-Fi 下，但扫码或输入配对码后一直转圈。

第 1 步：两端都在运行吗

• 电脑端：FDM 主界面开着，远程控制面板里显示「已启用」
• 手机端：Android FDM 主界面开着，远程控制功能正常

如果电脑端 FDM 没开 → 先打开 FDM、再启用远程控制。

第 2 步：两端真的在同一个 Wi-Fi 吗

手机可能同时连着 Wi-Fi 和蜂窝网络、电脑可能连的是有线网络但路由器相同——这些都 OK。但要确认：

• 手机的 IP 地址（设置 → Wi-Fi → 当前连接的详情）和电脑的 IP 地址（Windows 命令行 ipconfig、macOS 命令行 ifconfig）在同一个子网下（都是 192.168.1.x 或都是 10.0.0.x）
• 如果手机在访客网络（Guest Wi-Fi）、电脑在主 Wi-Fi——路由器可能做了隔离，两端互相不可见。把手机切到主 Wi-Fi。

第 3 步：电脑防火墙 / 安全软件拦截

90% 的同网络配对失败是这个原因——Windows 防火墙或第三方安全软件拦截了 FDM 远程控制服务的入站连接。

排查：

1. 临时关闭 Windows 防火墙或第三方安全软件的实时防护
2. 手机重新尝试配对
3. 如果成功 → 把 FDM 远程控制端口加进防火墙 / 安全软件白名单
4. Windows 防火墙操作：安全中心 → 防火墙 → 允许应用通过防火墙 → 允许 FDM 专用端口

第 4 步：路由器 AP 隔离

某些路由器的默认配置里有「AP 隔离」或「客户端隔离」（Client Isolation）功能——开启后同 Wi-Fi 下的设备互相不可见。

排查：

• 登录路由器后台（浏览器输入 192.168.1.1 或 192.168.0.1）
• Wi-Fi 设置页面找到 AP 隔离 / 客户端隔离选项 → 关闭
• 保存 → 手机和电脑重新连 Wi-Fi

第 5 步：配对码过期

FDM 桌面端每次重启后配对码会变（安全机制）。如果：

• 你打开了 FDM 桌面端 → 记下配对码 → 关闭 FDM → 第二天手机才尝试配对
• 配对码已经变了，手机输入的是旧码 → 配对失败

解决：打开 FDM 桌面端远程控制面板 → 看最新的配对码 → 手机端重新配对。

场景二：手机在外（5G）、电脑在家配对不上

手机用蜂窝网络、电脑在家里的 Wi-Fi 下——两端不在同一网络，需要额外处理。

方法 A：电脑有公网 IP + 路由器端口映射

1. 电脑查公网 IP：浏览器打开 ip138.com → 记录下你家当前的公网 IP
2. 路由器做端口映射：路由器后台 → 端口转发 → 规则：

• 外部端口：FDM 远程控制端口（偏好设置里看，默认随机，建议固定一个比如 44444）
• 内部 IP：电脑内网 IP（192.168.1.x）
• 内部端口：同上
• 协议：TCP

1. 手机配对时：IP 地址填公网 IP（不是内网 IP！）、端口填 44444、配对码 + 远程控制密码
2. 注意：运营商 CGNAT（多用户共享公网 IP）环境下无法做端口映射——用方法 B

方法 B：Tailscale / Zerotier 组网（推荐）

Tailscale 是免费的软件定义组网工具，给每台设备分配一个 100.x.x.x 的虚拟内网 IP，两端自动走加密隧道。

步骤：

1. 电脑和手机都装 Tailscale → 登录同一个 Tailscale 账号
2. Tailscale 自动给两端分配 100.x.x.x 的地址
3. 手机 FDM 配对时：IP 填电脑的 Tailscale 虚拟 IP → 不需要公网 IP、不需要路由器映射
4. 两端自动走加密隧道，安全且稳定

Tailscale 比方法 A 好在哪里：

• 不需要公网 IP——即使运营商 CGNAT 也能用
• 不需要路由器配置——Tailscale 自动打洞
• 自动加密——流量全程走加密隧道
• 稳定——不管手机在哪个网络（5G / 公司 Wi-Fi / 酒店 Wi-Fi），只要能访问互联网就能连

方法 C：家里现有 VPN

如果家里已经有 WireGuard / OpenVPN / OpenWrt + VPN：

• 手机在外时先连家里的 VPN
• 连上 VPN 后手机获得内网 IP（比如 10.0.0.x）
• 手机 FDM 配对时用电脑的内网 IP

场景三：配对成功但远程面板显示离线

手机曾经配对成功过、但现在远程面板里显示电脑是灰色离线状态。

排查：

1. 电脑端 FDM 还在运行吗？有没有被手动关掉？
2. 电脑是不是睡眠 / 休眠了？Windows 合盖、macOS 睡眠后 FDM 进程被挂起 → 远程控制不工作
3. 两端网络有没有切换？手机从家里 Wi-Fi 切到公司 Wi-Fi → 之前用的内网 IP 失效了 → 需要用 Tailscale 虚拟 IP 或公网 IP
4. 电脑的 IP 地址变了吗？DHCP 重新分配后内网 IP 变化 → 手机端存的是旧 IP → 需要重新配对（或用固定 IP）

解决：

• 电脑保持 FDM 运行 + 合盖不休眠（用 Amphetamine / 系统设置）
• 跨网络场景用 Tailscale（IP 固定不变）

场景四：Android ROM 杀后台导致远程控制失联

症状：手机在外时远程面板显示离线，回到家发现 Android FDM 被 MIUI / EMUI / ColorOS 杀后台了。

解决（按顺序做完）：

1. 最近任务页锁定 FDM（点锁图标）
2. 电池优化里设为不受限制
3. 自启动管理里允许自启
4. 开发者选项 → 后台进程限制 → 不限制
5. 关闭 ROM 的"省电模式" / "超级省电模式"

做完后重启手机验证。详细操作见 Android 安装 里的 ROM 杀后台处理。

场景五：远程控制时配对码弹窗消失太快

FDM 桌面端的远程控制面板可能会因为主界面最小化而被遮挡，或者配对码 60 秒后自动刷新变新值。

操作建议：

1. 打开 FDM 远程控制面板后，把窗口固定（FDM 偏好设置里有没有"置顶"选项），或把面板内容截图发给自己
2. 快速操作：打开远程控制 → 手机扫码 / 输入配对码 → 1 分钟内完成 → 不要拖太久

或者在 FDM 偏好设置里手动固定一个配对码（不自动刷新）——安全上弱一些但方便。

实战：从"配对不上"到"稳定遥控"的完整改造

初始状态：
手机和电脑在家里 Wi-Fi 下配对成功过一次，后来把电脑搬到公司，在外用 5G 再也连不上。

改造步骤：
1. 电脑和手机都装 Tailscale → 登录同一账号
2. 两端自动获得 100.x.x.x 的虚拟内网 IP
3. 手机 FDM 远程控制 → 删除旧的电脑连接 → 重新添加
4. IP 填电脑的 Tailscale 虚拟 IP（不是家里的内网 IP）
5. 配对码从电脑 FDM 远程控制面板上看 → 手机输入
6. 配对成功 → 远程面板显示电脑在线
7. 测试：手机发一个 URL → 电脑 FDM 自动开始下载 → 手机能看到进度

从此以后：
- 不管手机在哪（5G、公司 Wi-Fi、酒店 Wi-Fi），只要 Tailscale 连着就能遥控
- 电脑 IP 变了、换了网络环境也不用重新配对
- 全程加密、不需要公网 IP、不需要路由器映射

常见问题五个场景全部讲完。12 个分组共 47 页 md 全部完成。立即跑 build_site.py 渲染 + verify_site.py 验收。