Сервер WireGuard на UniFi для Apple TV

Когда подходит этот вариант

Используйте этот вариант, когда Apple TV находится вдали от дома, например в арендованном на время отпуска жилье, и должен подключаться к домашней сети через ваш шлюз UniFi, чтобы открывать сервисы, например медиасервер, по их адресу.

Это руководство не описывает, как дома направлять трафик Apple TV через VPN-клиент на шлюзе. Для такой настройки WaveSocket не нужен.

Вам понадобятся:

Apple TV с приложением WaveSocket, которое подключается с помощью конфигураций WireGuard и не включает в себя сервис VPN
UniFi Gateway или UniFi Cloud Gateway с приложением UniFi Network
публичный IP-адрес на шлюзе или порт, перенаправленный на шлюз другим маршрутизатором, который стоит между шлюзом и Интернетом
телефон или компьютер в той же сети, что и Apple TV, для передачи конфигурации

UniFi Teleport — это другая функция. Она использует приглашения в приложении WiFiman от Ubiquiti, а не файл конфигурации WireGuard.

Настройте сервер WireGuard

Эти шаги соответствуют статье Ubiquiti о сервере WireGuard VPN.

В UniFi Network откройте Settings → VPN и создайте сервер WireGuard VPN. Порт по умолчанию — UDP 51820.
Если между шлюзом и Интернетом есть еще один маршрутизатор, настройте на нем переадресацию порта UDP 51820 на адрес WAN шлюза. Ubiquiti рекомендует шлюз с прямым доступом к публичному IP-адресу.
Если ваш публичный адрес меняется, сначала получите имя хоста у поддерживаемого UniFi провайдера Dynamic DNS, например Cloudflare или No-IP. Затем создайте запись Dynamic DNS в Settings → Internet, чтобы клиенты могли использовать это имя хоста. Для Dynamic DNS от Ubiquiti нужен публичный 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, или ваш публичный IP-адрес, когда вы используете Dynamic DNS, перед отправкой файла замените его своим публичным адресом или именем хоста DDNS, сохранив порт. После импорта можно также изменить Сервер на экране Изменить профиль, пока VPN отключен. Сведения об 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, который снимает ограничение по времени.

Если подключиться не удается

Нет публичного адреса. Адрес WAN из диапазона 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 или 100.64.0.0/10 не является публичным. Ubiquiti советует попросить интернет-провайдера предоставить публичный IP-адрес или включить режим моста на маршрутизаторе провайдера, чтобы устранить двойной NAT.
Проверка из дома. Проверяйте подключение из-за пределов домашней сети; см. статью Ubiquiti о переадресации портов.
Одинаковый диапазон адресов. Избегайте использования одного и того же частного диапазона адресов дома и в сети, к которой подключен Apple TV.

Эти шаги основаны на опубликованной документации Ubiquiti, проверенной 16 октября 2026 г., а не на собственном тестировании WaveSocket с UniFi. Они опираются на статью Ubiquiti о сервере WireGuard VPN, а в части названий элементов клиента — на статью Ubiquiti о WireGuard между площадками (site-to-site) для UniFi Mobile Router. Названия элементов в UniFi Network могут меняться; в этом случае следуйте актуальным справочным статьям Ubiquiti. UniFi — зарегистрированный товарный знак Ubiquiti Inc. WaveSocket — независимое приложение, не связанное с Ubiquiti Inc. и не одобренное Ubiquiti Inc.