适用于 Apple TV 的 UniFi WireGuard 服务器

适用场景

当 Apple TV 不在家中（例如在度假民宿里），需要通过您的 UniFi 网关连回家，以便通过地址访问媒体服务器等服务时，请使用此设置。

本指南不涉及在家中让 Apple TV 流量经由网关上的 VPN 客户端传输。那种设置不需要 WaveSocket。

您需要：

一台装有 WaveSocket 应用的 Apple TV；WaveSocket 使用 WireGuard 配置进行连接，不包含 VPN 服务
一台运行 UniFi Network 应用的 UniFi Gateway 或 UniFi Cloud Gateway
网关上有公网 IP 地址，或者由网关与互联网之间的另一台路由器将端口转发到网关
一部与 Apple TV 位于同一网络、用于传输的手机或电脑

UniFi Teleport 是另一项功能。它使用 Ubiquiti 的 WiFiman 应用中的邀请，而不是 WireGuard 配置文件。

设置 WireGuard 服务器

以下步骤参照 Ubiquiti 的 WireGuard VPN 服务器文章。

在 UniFi Network 中，打开 Settings → VPN 并创建一个 WireGuard VPN 服务器。默认端口为 UDP 51820。
如果网关与互联网之间还有另一台路由器，请在该路由器上将 UDP 端口 51820 转发到网关的 WAN 地址。Ubiquiti 建议使用可直接获得公网 IP 的网关。
如果您的公网地址会变化，请先从 UniFi 支持的动态 DNS 提供商（例如 Cloudflare 或 No-IP）获取一个主机名。然后在 Settings → Internet 中创建动态 DNS 条目，以便客户端使用该主机名。Ubiquiti 的动态 DNS 要求网关拥有公网 IP。如果网关位于另一台路由器之后，请使用该路由器的 DDNS，或将该路由器设为桥接模式，让网关获得公网 IP。

创建 Apple TV 客户端

在该 WireGuard 服务器中，打开 Clients → Add Client，并输入一个名称，例如 Apple TV。
选择 Download Configuration File，并对该文件保密。
选择 Add，然后选择 Apply Changes。

请为每台设备单独创建一个客户端。Ubiquiti 的文档没有说明 Endpoint、AllowedIPs 和 DNS 的固定默认值，因此请直接在文件中检查这些值。如果 Endpoint 显示的是私有地址（例如位于 10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 或 100.64.0.0/10 中的地址），或者在您使用动态 DNS 时显示的是您的公网 IP 地址，请在发送文件之前将其替换为您的公网地址或 DDNS 主机名，并保留端口。导入后，您也可以在断开连接时，在 编辑配置 中更改 服务器。关于 AllowedIPs，请参阅路由和您的家庭网络。

在 Apple TV 上导入

在 Apple TV 上打开 WaveSocket，选择 配置 → 添加VPN配置 → 通过浏览器上传，然后选择 开始上传会话。如果已连接 VPN，请先断开连接。
在与 Apple TV 位于同一网络的手机或电脑上，扫描电视上的 QR 码或打开显示的地址。在 4位代码 字段中输入电视上显示的代码。
点击 选择文件，选取 .conf 文件，然后点击 发送到Apple TV。
Apple TV 上的检查页面会显示 服务器 和 允许的IP，请核对这两项。选择 重命名，为该配置文件取一个清楚的名称，例如“家庭 VPN”，然后选择 保存配置。

请使用受信任的网络进行传输。如果 Apple TV 要在共享网络（例如度假民宿的 Wi-Fi）上使用，请先在家中导入配置文件，再把 Apple TV 带过去。导入指南说明了为什么网络必须受信任。

连接并检查

请在 Apple TV 接入家庭以外的网络时进行连接。Ubiquiti 指出，当网关位于另一台路由器之后时，从家庭网络内部访问公网地址可能会失败。

WaveSocket 会选中已保存的配置文件并打开连接屏幕。选择连接。首次连接时，请允许 Apple TV 添加 VPN 配置。确认显示 服务器已验证，并且 最早一次对等端握手的经过时间 旁边显示的是最近的时间，然后通过地址打开一个已知的家庭网络服务。

如果端点使用 DDNS 主机名，WaveSocket 会在连接前解析该主机名，并在连接期间再次检查；请参阅 DNS 和服务器地址。

WaveSocket 的所有功能每次连接均可免费使用三分钟，因此您可以先试用这套设置，再选择可消除时间限制的 WaveSocket 永久使用权。

如果无法连接

没有公网地址：位于 10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 或 100.64.0.0/10 中的 WAN 地址不是公网地址。Ubiquiti 建议向您的互联网服务提供商申请公网 IP，或在提供商的路由器上使用桥接模式来消除双重 NAT。
在家中测试：请从家庭网络以外进行测试；请参阅 Ubiquiti 的端口转发文章。
地址范围相同：请避免在家中和 Apple TV 所在的网络上使用相同的私有地址范围。

以上步骤依据 2026 年 10 月 16 日核对的 Ubiquiti 已发布文档，而非 WaveSocket 自己对 UniFi 的测试。这些步骤参照了 Ubiquiti 的 WireGuard VPN 服务器文章，客户端相关标签则参照了其适用于 UniFi Mobile Router 的站点到站点 WireGuard 文章。UniFi Network 中的界面标签可能会更改；如有更改，请按照 Ubiquiti 当前的帮助文章操作。UniFi 是 Ubiquiti Inc. 的注册商标。WaveSocket 是一款独立应用，与 Ubiquiti Inc. 没有关联，也未获得 Ubiquiti Inc. 的认可。