# 附近设备同步

附近同步让处于同一局域网内的设备直接传输剪贴内容，不经过任何外部云端服务器，传输速度快、响应实时且具备更高的数据私密性。

## 适用场景

- 电脑复制，手机马上粘贴。
- 同一办公室或家庭网络中，频繁传递临时文本或卡片。
- 希望彻底避免数据在云端流转，仅进行局域网物理传输。

## 开启与使用

:::steps
:::step{title="开启附近同步开关"}

在需要同步的两台设备上，进入章鱼速贴「设置」 -> 「同步设置」 -> 开启「附近同步」功能。

:::
:::step{title="完成发现与配对"}

在两台设备上均处于“寻找设备”状态时，在「设置」 -> 「同步设置」 -> 「附近设备」列表中定位到目标设备名，发起配对并确认连接。

:::
:::step{title="发送测试剪贴"}

**成功标志：** 在设备 A 复制一段简短文本后，确认设备 B 的剪贴历史列表中立刻同步并展示该纯文本卡片。
:::
:::

## 使用条件与硬性限制

- **同一本地网络：** 两台设备必须连接在同一个局域网（通常是同一个 Wi-Fi 热点）。
- **本地网络访问权限：** 移动端（尤其是 iOS / Android）必须允许应用读取本地网络设备。
- **防火墙规则：** 系统防火墙必须放行章鱼速贴以允许局域网内的端口监听及通信。
- **设备连接数量限制：**
  - **免费版：** 同一时间最多仅支持连接 **1** 台设备；
  - **付费版（Standard/Plus）：** 解锁多设备同时连接限制（附近连接数量不受许可证激活设备数限制，但建议不超过网络带载上限）。

> [!INFO] 桌面版不再需要 Bonjour 依赖
> 自 v1.9.5（2026-02-11）起，Windows 和 macOS 客户端已改为通过内置原生服务实现局域网发现。除非使用的是更早期的客户端或特定的网络组网，否则无需在 Windows 上额外安装 Bonjour 依赖。

> [!WARNING] 企业局域网 AP 隔离拦截
> 许多公司 Wi-Fi、公共热点（如酒店、机场 Wi-Fi）会出于安全考虑开启 **“AP 隔离” (Access Point Isolation)** 机制，这会阻止同一局域网下的无线设备互相通信。若遇到互相找不到设备，请切换至手机热点重试；如需跨网络同步，建议使用 [云端同步](/features/cloud-sync)。

## 常见排查

:::accordion{multiple}
:::item{label="为什么我的附近设备列表里是一片空白？"}

1. 确认两端设备的附近同步开关均已开启。
2. 确认没有被系统代理或全局 VPN 路由重定向拦截。
3. 检查应用是否已获得系统的“本地网络”（iOS）或“定位服务/附近设备”（Android）权限。

:::
:::item{label="配对成功但无法传输剪贴内容"}

检查系统防火墙（尤其是 Windows Defender 或是 macOS 专用防火墙）是否阻止了应用的入站连接。你可以尝试将防火墙暂时关闭以定位故障。
:::
:::

## 相关文档

:::cards{cols=2}
:::card{title="云端同步" icon="lucide.cloud" href="/features/cloud-sync"}
适合跨网络、长期的多设备数据同步场景。

:::
:::card{title="设备发现失败排查" icon="lucide.wrench" href="/advanced/troubleshooting/device-discovery-failed"}
两台设备互相发现不了时的详细网络排障步骤。
:::
:::

## 仍未解决

如果确认网络正常但附近同步依然无法连通，到社区反馈时请附上以下信息：

- **两端设备的系统与版本：**
- **应用版本：**
- **两端是否连接同一 Wi-Fi：**
- **是否启用了 VPN/代理：**
- **网络类型：** （家庭 Wi-Fi / 企业 Wi-Fi / 手机热点）
