SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Як запустити Tailscale subnet router на VPS

Налаштуйте subnet router Tailscale на VPS: схвалення маршрутів, IP forwarding після перезавантаження та приймання маршрутів Linux-клієнтами.

Що робить subnet router Tailscale

Subnet router Tailscale — це машина, яка оголошує tailnet цілий діапазон приватних IP-адрес. Завдяки цьому кожен пристрій у tailnet може звертатися до адрес у цьому діапазоні, навіть якщо на цих пристроях не запущено Tailscale. Ваш tailnet — це приватна мережа Tailscale: набір пристроїв, авторизованих в одному обліковому записі або організації. Exit node — це функція, з якою його часто плутають, але вона виконує протилежне завдання. Exit node передає весь трафік пристрою через VPS, тому VPS стає маршрутом цього пристрою до публічного інтернету.

Одним реченням: subnet router робить одну приватну мережу доступною з tailnet. Exit node змінює місце виходу вашого публічного трафіку в інтернет. Якщо вам потрібен другий варіант, прочитайте як запустити Tailscale exit node на VPS. Це окремі прапорці, і один VPS може одночасно виконувати обидві функції, але вони вирішують різні завдання та виходять з ладу з різних причин.

Коли VPS потрібен як маршрутизатор підмережі

Поширений сценарій — приватна мережа, яку вже надав ваш провайдер. Ваш VPS має публічну адресу та другий інтерфейс у приватному сегменті, а інші сервери в цьому сегменті взагалі не мають публічних адрес: база даних за адресою 10.0.0.20, цільова система резервного копіювання за адресою 10.0.0.30. Встановіть Tailscale на один VPS, оголосіть 10.0.0.0/24, і ваш ноутбук отримає прямий доступ до цих приватних адрес. На самому сегменті нічого змінювати не потрібно, а база даних і надалі не матиме публічної адреси. Якщо з цього сегмента вам потрібен лише один вебзастосунок на одному порту, оголошувати весь діапазон недоцільно, і Tailscale Serve натомість налаштовує HTTPS для цього окремого порту. Такий самий підхід підходить для демона, який навмисно слухає лише localhost, наприклад dsh, що працює без інтерфейсу під керуванням systemd, де адреса tailnet на цьому VPS замінює SSH-тунель, який інакше довелося б постійно тримати відкритим для доступу до його інтерфейсу.

Інший сценарій — мережа за VPS. Це може бути домашня або офісна LAN (локальна мережа) за власним маршрутизатором чи стійка пристроїв, на яких неможливо запустити Tailscale, наприклад керований комутатор або старий NAS із заблокованою прошивкою. Один Linux-комп’ютер у цій мережі стає маршрутизатором підмережі для всіх інших пристроїв у ній. Домашньому маршрутизатору перед ним не потрібне перенаправлення портів: як Tailscale проходить через NAT без відкриття порту на маршрутизаторі пояснює, чому це працює та коли підключення перемикається на relay. У домашніх умовах цим комп’ютером часто є невелика VM на гіпервізорі, який ви вже використовуєте, а порівняння вартості домашнього хоста Proxmox з орендованим VPS допоможе визначити, перш ніж ухвалювати рішення, на якому кінці тунелю мають працювати ваші сервіси.

Обидва сценарії мають спільну вимогу. Маршрутизатор підмережі вже має досягати діапазону, який він оголошує, використовуючи власну таблицю маршрутизації та власний firewall. Tailscale не створює це підключення. Він передає трафік маршрутизатору, а той передає його ядру для маршрутизації далі.

Встановіть Tailscale і спочатку перевірте локальний маршрут

curl -fsSL https://tailscale.com/install.sh | sh

Скрипт визначає дистрибутив, додає репозиторій пакетів Tailscale, встановлює команду tailscale і демон tailscaled, а потім вмикає сервіс. Перевірте це за допомогою systemctl is-active tailscaled. Команда має вивести active.

Передусім переконайтеся, що VPS може досягти мережі, яку ви плануєте рекламувати.

ip route show
ping -c3 10.0.0.20

Команда ip route show має показати приватний діапазон на реальному інтерфейсі, наприклад 10.0.0.0/24 dev enp7s0 proto kernel scope link src 10.0.0.5. Якщо ping не працює вже на цьому етапі, безпосередньо до маршрутизатора, жоден параметр Tailscale не допоможе. Проблема полягає в конфігурації мережі VPS або у firewall на цільовому хості. Спочатку усуньте її, оскільки всі наступні перевірки залежать від цього.

Увімкніть IP forwarding і збережіть параметр після перезавантаження

Linux-комп’ютер відкидає будь-який пакет, адресований не йому, якщо forwarding вимкнено. Пересилання пакетів інших машин — основне завдання subnet router, тому цей крок є обов’язковим.

echo 'net.ipv4.ip_forward = 1' | sudo tee -a /etc/sysctl.d/99-tailscale.conf
echo 'net.ipv6.conf.all.forwarding = 1' | sudo tee -a /etc/sysctl.d/99-tailscale.conf
sudo sysctl -p /etc/sysctl.d/99-tailscale.conf

Перевірте параметр за допомогою sysctl net.ipv4.ip_forward. Команда має вивести net.ipv4.ip_forward = 1.

Цей крок часто виконують лише частково. sudo sysctl -w net.ipv4.ip_forward=1 починає працювати одразу, але його значення зникає під час наступного завантаження. У результаті subnet router працює тижнями, а потім перестає працювати вранці після перезавантаження через оновлення ядра. Проблему важко помітити, оскільки зовні все виглядає справним. tailscale status і далі показує вузол як доступний, адміністративна консоль і далі показує схвалений маршрут, а клієнти й далі мають встановлений маршрут. Пакети надходять до VPS, але ядро відкидає їх без запису в журнал. Запис значень у /etc/sysctl.d/99-tailscale.conf дає змогу відновити їх після перезавантаження.

Якщо ви оголошуєте маршрути, коли forwarding ще вимкнено, tailscale up одразу попереджає про це. У Linux повідомлення має вигляд, близький до Warning: IP forwarding is disabled, subnet routing/exit nodes will not work.. Прочитайте виведення цієї команди, а не пропускайте його під час перегляду.

Рекламуйте маршрути

sudo tailscale up --advertise-routes=10.0.0.0/24

На VPS, який уже підключено до вашого tailnet, натомість змініть налаштування безпосередньо:

sudo tailscale set --advertise-routes=10.0.0.0/24

Для всіх наступних змін використовуйте tailscale set. Повторний запуск tailscale up з одним прапорцем скидає прапорці, які ви не вказали повторно, а CLI зупиняє виконання з помилкою: для зміни налаштувань таким способом потрібно вказати всі прапорці, що відрізняються від значень за замовчуванням. tailscale set змінює одне налаштування, не змінюючи решту.

Кілька діапазонів потрібно вказувати в одному списку, розділяючи їх комами без пробілів: --advertise-routes=10.0.0.0/24,192.168.50.0/24. Кожен елемент має бути мережевою адресою в нотації CIDR (classless inter-domain routing, у форматі 10.0.0.0/24). Якщо помилково вказати власну адресу хоста, 10.0.0.5/24, команду буде відхилено, оскільки біти після префікса не дорівнюють нулю; у повідомленні про помилку буде зазначено префікс, який, імовірно, потрібно було вказати. Щоб припинити рекламу маршрутів, задайте порожній список за допомогою sudo tailscale set --advertise-routes=.

Схвалення маршруту в адміністративній консолі

Анонс маршруту — це запит, а не зміна конфігурації. Поки адміністратор не схвалить маршрут, жоден клієнт його не отримує, і жодна адреса в цьому діапазоні недоступна. Це зроблено навмисно: машина, яка може додавати себе до таблиць маршрутизації всіх клієнтів, могла б перехоплювати трафік для будь-якого потрібного їй діапазону.

Схваліть маршрут на сторінці Machines в адміністративній консолі. VPS буде позначено бейджем підмережі. Відкрийте його рядок, знайдіть розділ підмереж, відредагуйте параметри маршруту, увімкніть потрібний маршрут і збережіть зміни.

Схвалення надається окремо для кожного префікса. Якщо сьогодні анонсувати 10.0.0.0/24, а наступного місяця — 192.168.50.0/24, новий префікс залишиться несхваленим, а старий продовжить працювати. На VPS схвалений і проігнорований маршрут виглядають однаково, тому перед будь-яким іншим налагодженням перевірте адміністративну консоль.

Ручний крок можна пропустити, додавши блок autoApprovers до файлу політики tailnet:

{
  "autoApprovers": {
    "routes": {
      "10.0.0.0/24": ["tag:subnet-router"]
    }
  }
}

Після цього запустіть вузол із цим тегом, sudo tailscale up --advertise-routes=10.0.0.0/24 --advertise-tags=tag:subnet-router, і маршрут буде схвалено одразу після анонсу. Тег спочатку має існувати в секції tagOwners цього самого файлу політики. Це варто налаштувати, якщо ви відновлюєте VPS зі скрипту, оскільки відновлений вузол є новим вузлом, і його маршрути знову починають роботу в несхваленому стані.

Чому Linux-клієнти ігнорують маршрут без --accept-routes

Маршрут уже оголошено й схвалено. Телефон і Mac можуть підключитися до 10.0.0.20. Ноутбук із Linux — ні, і в консолі адміністрування немає ознак проблеми.

Прийняття маршруту до підмережі означає додавання записів до таблиці маршрутизації клієнта. На Android, iOS, macOS, tvOS і Windows клієнт Tailscale робить це автоматично. У Linux цього не відбувається, оскільки Linux-машина часто є сервером або маршрутизатором, а її таблицю маршрутизації хтось налаштував навмисно. Автоматичне додавання /24, отриманого з мережі, може порушити обробку трафіку, за яку ця машина вже відповідає. Тому в Linux потрібно явно дозволити це на кожному клієнті:

sudo tailscale set --accept-routes

Потім перевірте, куди було додано маршрут:

ip route show table 52
ip route get 10.0.0.20

Якщо доступна policy routing, Tailscale у Linux додає прийняті маршрути до таблиці маршрутизації 52, а не до основної таблиці маршрутизації. Він встановлює policy rules, які можна переглянути за допомогою ip rule show. Зазвичай вони мають пріоритети в діапазоні від 5210 до 5270. У системах OpenWRT, де виявлено запущений mwan3, Tailscale натомість використовує пріоритети від 1300 до 1400. У такій конфігурації звичайна команда ip route show не показує прийнятий маршрут 10.0.0.0/24, тому перевірте ip route show table 52, щоб побачити оголошений діапазон на tailscale0. Без підтримки policy routing Tailscale додає прийняті маршрути до основної таблиці, де їх показує звичайна команда ip route show.

Варто знати про один виняток. Якщо цей вузол Linux сам є другим subnet router для власної локальної мережі, --accept-routes змушує його передавати трафік до власної безпосередньо підключеної підмережі через інший маршрутизатор, а не через власний інтерфейс. На резервному маршрутизаторі в парі з високою доступністю залиште --accept-routes вимкненим і лише оголошуйте маршрут.

Режим збою: два маршрутизатори оголошують діапазони, що перекриваються

Два subnet routers можуть оголошувати однакові діапазони. Саме так працює пара високої доступності: кожен маршрутизатор оголошує абсолютно однакові префікси, а клієнти можуть переключатися з одного на інший у разі збою. Діапазони, що перекриваються та мають різну довжину префікса, також дозволені. Tailscale вибирає найспецифічніший маршрут. Якщо маршрутизатор A оголошує 10.0.0.0/24, а маршрутизатор B — 10.0.0.0/16, трафік до 10.0.0.20 надходить до A.

Проблема виникає, коли A виходить з мережі. Tailscale не переходить до менш специфічного маршруту, оскільки недоступний маршрутизатор не може відкликати своє оголошення, а клієнти й надалі надають перевагу специфічнішому префіксу. Трафік до 10.0.0.20 зупиняється, а трафік до 10.0.1.20, який охоплює лише /16 маршрутизатора B, продовжує працювати через B. Симптом схожий на відмову частини приватної мережі. Причина — один недоступний вузол утримує специфічніший префікс. Якщо потрібне переключення при відмові, налаштуйте ширший маршрутизатор так, щоб він також оголошував вужчі префікси. Тоді обидва маршрутизатори охоплюватимуть однакові адреси.

Інший тип перекриття виникає ближче до клієнта. Якщо ви перебуваєте в готельній мережі з адресою 192.168.1.0/24, а ваш subnet router оголошує 192.168.1.0/24, обидва маршрути конкурують за ті самі призначення. Переможець залежить від платформи. У Linux додайте правило перед власними правилами Tailscale, щоб локальні адреси використовували main table:

sudo ip rule add to 192.168.1.0/24 priority 2500 lookup main

Пріоритет 2500 передує типовим правилам Tailscale. Однак в OpenWRT із mwan3 перевірте ip rule show і виберіть вільний пріоритет нижче 1300. Це правило не є постійним і зникне після наступного завантаження. Правильне рішення — вибрати приватний діапазон, з яким ви не зіткнетеся в інших мережах. 192.168.0.0/24 і 192.168.1.0/24 є типовими діапазонами для більшості домашніх маршрутизаторів. Тому виберіть щось усередині 10.0.0.0/8 свідомо. Така сама колізія порушує роботу звичайного WireGuard VPN, який ви налаштували вручну, з тієї самої причини: специфічніший локальний маршрут має перевагу, тому трафік не потрапляє в тунель.

Режим відмови: DNS перетворює ім’я на адресу, яку не охоплює жоден маршрут

Цю проблему важко діагностувати, оскільки жодна команда не повідомляє про помилку. Ім’я успішно перетворюється на адресу. З’єднання завершується тайм-аутом.

Припустімо, що db.internal.example.com перетворюється на 10.0.5.20 через ваш приватний nameserver, а ви оголосили 10.0.0.0/24. Пошук успішний, оскільки розпізнавання DNS (domain name system) і IP-маршрутизація є окремими етапами, і жоден із них не перевіряє інший. Потім для пакета до 10.0.5.20 у tailnet не знаходиться відповідний маршрут. Тому пакет виходить через шлюз за замовчуванням клієнта та зникає.

Дві команди дають змогу перевірити ці два етапи окремо:

nslookup db.internal.example.com
ip route get 10.0.5.20

Якщо пошук повертає адресу, але ip route get не відповідає значенням dev tailscale0, ім’я налаштоване правильно, а на цьому клієнті відсутній маршрут. На клієнті Linux спочатку перевірте, чи ввімкнено --accept-routes. Без цього маршрут до підмережі не встановлюється, навіть якщо адресу вже охоплює схвалений префікс. Якщо параметр увімкнено, але адресу не охоплює жоден схвалений префікс, оголосіть діапазон, який її охоплює: 10.0.0.0/16 або другий явний префікс. Потім схваліть новий префікс у консолі.

На самому nameserver є аналогічна проблема. Якщо в адміністративній консолі ви вказали глобальний nameserver із приватною адресою, наприклад 10.0.0.53, ця адреса має належати до схваленого маршруту. Інакше пристрої, які не перебувають у цій приватній мережі, не зможуть отримати доступ до resolver. Якщо ввімкнути параметр, що замінює локальні DNS-сервери, і вказати resolver, до якого ніхто не має доступу, усі пристрої в tailnet одразу втратять розпізнавання імен, зокрема ті, що ще секунду тому працювали. Спочатку оголосіть і схваліть маршрут до resolver, а потім змініть налаштування DNS. Якщо найбільше проблем виникає з DNS усередині тунелю, у матеріалі як DNS перестає працювати через тунель WireGuard описано той самий механізм без додаткового coordination layer.

Source NAT і site-to-site з’єднання

За замовчуванням subnet router замінює адресу джерела кожного переспрямованого пакета на власну приватну адресу. Це SNAT (source network address translation). Він потрібен, щоб відповіді працювали без змін у приватній мережі: база даних за адресою 10.0.0.20 відповідає VPS, маршрут до якого їй уже відомий. Недолік полягає в тому, що база даних бачить кожне підключення з tailnet як підключення з VPS. Тому правила firewall за адресою джерела та журнали доступу не дають корисної інформації.

Вимкніть SNAT у Linux, якщо потрібно зберегти фактичну адресу клієнта в tailnet:

sudo tailscale set --snat-subnet-routes=false

Якщо той самий вузол також працює як exit node, вимкнення subnet SNAT може спричинити відкидання пакетів upstream. Tailscale рекомендує використовувати окремі вузли для цих ролей, якщо subnet SNAT потрібно вимкнути.

Тоді хостам у приватній мережі потрібен зворотний маршрут до 100.64.0.0/10 — діапазону, який Tailscale призначає пристроям. Цей маршрут має вказувати на subnet router. Без нього відповіді надходитимуть на default gateway і не досягатимуть клієнта, тому після першого пакета з’єднання зависатиме. Додайте статичний маршрут на gateway приватної мережі або залиште SNAT увімкненим.

Site-to-site з’єднання — це одночасна робота двох subnet router. Кожен із них оголошує власну мережу та приймає маршрути до мережі іншого:

sudo tailscale up --advertise-routes=10.0.0.0/24 --snat-subnet-routes=false --accept-routes

Виконайте відповідну команду на іншому router, указавши його власний діапазон. Два діапазони мають відрізнятися. Якщо великі передавання даних зависають, хоча ssh і ping працюють нормально, причина полягає в MSS (maximum segment size) — найбільшому обсязі даних, який може містити TCP-пакет. Накладні витрати тунелю роблять переспрямовані пакети завеликими для певної ділянки мережі. Clamping виправляє це:

sudo iptables -t mangle -A FORWARD -o tailscale0 -p tcp -m tcp --tcp-flags SYN,RST SYN -j TCPMSS --clamp-mss-to-pmtu

Збережіть це правило за допомогою iptables-persistent, інакше воно зникне після наступного завантаження системи.

Обслуговування для стабільної роботи

Те, чи завершиться строк дії ключа цього комп’ютера, залежить від способу входу. Для вузла, налаштованого під tag, як у наведеному вище прикладі autoApprovers, завершення строку дії ключа за замовчуванням вимкнено від моменту першого додавання tag і автентифікації. Тому додаткових дій не потрібно. Вузол, у якому виконано вхід як ваш користувач, використовує період завершення строку дії ключів tailnet. Для нового tailnet за замовчуванням це 180 days; станом на October 2026 можна вибрати період від 1 до 180 days. Коли строк дії ключа такого subnet router завершується, з’єднання до нього та від нього припиняються, а весь оголошений діапазон стає недоступним. При цьому жодних змін конфігурації, які пояснювали б проблему, може не бути. Для router, у якому виконано вхід як користувач, вимкніть завершення строку дії ключа через меню в кінці його рядка на сторінці Machines адміністративної консолі. Після цього зафіксуйте, що цю дію виконано.

Tailscale намагається встановити пряме з’єднання між вузлами, а якщо це неможливо, використовує relay-сервери. Relay працюють, але додають затримку. VPS із публічною адресою — найпростіший варіант: дозвольте вхідний UDP 41641, і більшість вузлів зможе підключатися напряму. Tailscale працює навіть без відкритого вхідного порту, тому це правило покращує швидкість, а не доступність. У статті які порти фактично використовує Tailscale і що має дозволяти firewall VPS пояснюється, чому використовується порт 41641, а не типовий для WireGuard 51820. Якщо трафік до приватного діапазону повільніший, ніж має бути через з’єднання з VPS, спочатку перевірте чи підключається ваш клієнт до subnet router напряму, чи через relay. Якщо firewall керується через ufw, синтаксис описано у статті які правила ufw фактично потрібні VPS.

Правила доступу — інша важлива частина конфігурації. У стандартному tailnet кожен ваш пристрій може підключатися до будь-якого іншого, тому схвалений маршрут працює одразу. Після створення ACL policy сторона призначення правила має охоплювати приватний діапазон: його можна вказати безпосередньо або використати wildcard *. Він включає схвалені subnet routes, оскільки 10.0.0.20 не є адресою tailnet і не охоплюється правилами, створеними для IP-адрес tailnet або tag.

Насамкінець вирішіть, чи готові ви використовувати coordination server, яким не керуєте самостійно. Control plane Tailscale — це hosted service. Ваші ключі залишаються на ваших машинах, але обліковий запис і policy file зберігаються там. Перед передаванням цьому сервісу маршруту до приватної мережі варто визначити, що саме можна буде зробити у разі компрометації control plane або викрадення облікових даних для входу. Межі цієї моделі описано у статті модель довіри Tailscale. Вартість рідко стає причиною відмови від цього рішення, оскільки free plan охоплює до шести користувачів із необмеженою кількістю їхніх пристроїв. Водночас subnet router, запущений під tag, обліковується інакше, ніж router, у якому виконано вхід як користувач. Billing також враховує ресурси з tag: 50 ресурсів включено, а кожен додатковий ресурс із tag коштує $1 на місяць. Тому перед додаванням користувачів або router із tag варто розрахувати скільки фактично платить домогосподарство або команда з п’яти осіб після завершення дії free plan. Запуск Headscale, self-hosted control server для Tailscale дає змогу розмістити його на власному VPS, але потребує самостійного обслуговування. Інший варіант для вирішення тієї самої проблеми — відмовитися також від клієнтів Tailscale. Self-hosting VPN server NetBird розміщує coordination layer і власні mesh clients на одній машині, якою ви керуєте. Обидва рішення використовують WireGuard на нижньому рівні. Тому після переходу зміняться ті частини цієї схеми, які розглянуто в порівнянні NetBird і Tailscale: хто керує control plane, як записується access rule для приватного діапазону та як передається трафік через relay, коли вузли не можуть підключитися напряму. Якщо ви ще обираєте між цією моделлю та конфігурацією, створеною вручну, порівняння WireGuard і Tailscale пояснює, що дає coordination layer і якою є його вартість.

FAQ

У чому різниця між subnet router і exit node?

Subnet router анонсує діапазон приватних адрес, тому пристрої tailnet можуть підключатися до машин, на яких не запущено Tailscale. Exit node анонсує себе як маршрут до всього інтернету, тому пристрій надсилає весь мережевий трафік через публічну адресу цього вузла. Один VPS може виконувати обидві ролі. Це окремі прапорці, --advertise-routes і --advertise-exit-node, і для кожного потрібне окреме схвалення в консолі адміністрування.

Чому мій Linux-клієнт ігнорує анонсований маршрут підмережі?

Linux-клієнти не приймають маршрути підмереж, доки ви явно не дозволите це. Виконайте на клієнті sudo tailscale set --accept-routes. Потім перевірте результат за допомогою ip route show table 52, якщо доступна policy routing. У такій конфігурації Tailscale використовує таблицю 52 і policy rules, тому звичайна команда ip route show не показує прийнятий маршрут. Без підтримки policy routing прийняті маршрути додаються до основної таблиці та відображаються у звичайному виводі ip route show.

Моя підмережа перестала працювати після перезавантаження. Що сталося?

Найімовірніше, вимкнулася IP forwarding. Значення, встановлене за допомогою sysctl -w, не зберігається після перезавантаження, тому запишіть його до /etc/sysctl.d/99-tailscale.conf і перевірте за допомогою sysctl net.ipv4.ip_forward. Якщо forwarding увімкнено, але діапазон і далі недоступний, перевірте вузол у консолі адміністрування. Router, авторизований як користувач, за замовчуванням має ключ із терміном дії 180 days. Після завершення терміну дії subnet router виглядає як мережева проблема, а не як проблема облікового запису. Для router, запущеного з tag, завершення терміну дії ключа за замовчуванням вимкнено, тому шукайте причину в іншому місці.

Чи можуть два subnet router анонсувати один і той самий діапазон?

Так. Однакові діапазони використовуються для роботи пари з високою доступністю: обидва router анонсують абсолютно однакові префікси. Діапазони, що перекриваються та мають різну довжину префікса, також допустимі; у такому разі використовується найспецифічніший маршрут. Тут потрібна обережність із failover: коли router із найспецифічнішим префіксом переходить в офлайн-стан, Tailscale не перемикається на ширший маршрут, тому цей трафік припиняється. Для справжньої standby-пари налаштуйте на обох router анонсування однакових специфічних префіксів.

Ім’я хоста визначається, але підключення завершується тайм-аутом. Чому?

Розв’язання DNS-імені та маршрутизація — це окремі етапи. Ім’я може розв’язуватися в адресу, для якої немає жодного схваленого маршруту, і тоді пакет виходить через шлюз за замовчуванням клієнта. Виконайте на клієнті ip route get <address>. Якщо відповідь не містить dev tailscale0 на Linux-клієнті, спочатку перевірте, чи увімкнено --accept-routes. Якщо воно увімкнене, анонсуйте діапазон, який охоплює цю адресу, і схваліть новий префікс у консолі адміністрування.

Чи була ця стаття корисною?