Сервер 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-адреси.
Якщо ваша загальнодоступна адреса змінюється, спершу отримайте ім’я хоста в постачальника Dynamic DNS, якого підтримує UniFi, наприклад 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, а щодо назв елементів клієнта — її статті про WireGuard site-to-site для UniFi Mobile Router. Назви елементів у UniFi Network можуть змінюватися; у такому разі дотримуйтеся актуальних статей довідки Ubiquiti. UniFi — зареєстрований товарний знак Ubiquiti Inc. WaveSocket — незалежна програма, не пов’язана з Ubiquiti Inc. і не схвалена нею.