# 设备发现失败

当附近同步无法发现另一台设备时，按本页排查。

不确定该看哪页？先用 [排障概览](/advanced/troubleshooting/overview) 的最小测试定位是哪一层。

## 快速检查

1. 两台设备都打开章鱼速贴。
2. 两台设备连接同一个可信网络或支持的本地路径。
3. 测试时临时关闭访客 Wi-Fi、AP 隔离、VPN、代理或防火墙限制。
4. 系统弹出本地网络权限时确认已允许。
5. 确认两端都在使用附近同步，而不是一端附近同步、一端只开云同步。
6. 先用短文本测试。

## 网络原因

附近发现依赖本地发现能力。企业网络、酒店 Wi-Fi、访客 Wi-Fi、VPN 或路由器隔离可能拦截设备间的本地网络流量。

> [!INFO] 当前版本无需安装 Bonjour
> 自 v1.9.5（2026-02-11）起，Windows 和 macOS 通过内置原生服务发现附近设备。安装 Bonjour/mDNS 只对较早版本或特定依赖它的环境才有意义——在当前版本上它不是必需步骤。

## 平台原因

- Windows：防火墙、网络配置文件、商店沙盒行为（Bonjour/mDNS 仅旧版本需要）。
- macOS：本地网络权限、防火墙、专注模式或睡眠行为。
- Android：本地网络/Wi-Fi 权限、厂商后台限制。
- iOS/iPadOS：本地网络权限以及前后台限制。

## 替代方案

如果本地发现被网络策略拦截且无法修改网络，可以在已激活付费功能的设备上使用 WebDAV / S3 云同步。

## 仍未解决

请反馈以下信息：

- 两台设备平台与系统版本
- 应用版本
- 网络环境（同一 Wi-Fi / 访客网络 / VPN / 代理 / 公司或酒店网络）
- 是否已允许本地网络权限
- 两端是否都在使用附近同步
- 复现步骤（最短路径）

## 下一步

:::cards{cols=2}
:::card{title="附近设备同步" icon="lucide.radio-tower" href="/features/nearby-sync"}
回顾附近同步的前提与适用场景。

:::
:::card{title="同步失败" icon="lucide.refresh-cw" href="/advanced/troubleshooting/sync-failed"}
设备能互相发现、但内容仍不同步时转到这里。

:::
:::card{title="同步方式概览" icon="lucide.git-compare" href="/features/sync-overview"}
本地发现被网络拦截时，考虑改用云同步。

:::
:::card{title="权限问题" icon="lucide.shield-alert" href="/advanced/troubleshooting/permission-issues"}
怀疑本地网络权限被拒时逐项排查。
:::
:::