SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

MagicDNS в Tailscale: имена машин вместо IP

Как обращаться к машинам Tailscale по имени: короткая и полная форма, включение MagicDNS, и почему имя не резолвится на VPS, в Docker и при перехвате порта 53.

Что такое MagicDNS и как выглядит имя машины

MagicDNS выдаёт каждой машине в тейлнете имя, по которому к ней обращаются вместо адреса 100.x. Имя одинаково работает с любого узла сети, не зависит от того, какой IP выдал провайдер, и не меняется, когда ноутбук переехал из дома в кафе. Без MagicDNS к машинам тоже можно обращаться по именам, если настроить для их адресов записи в отдельном приватном или публичном DNS.

У имени две формы. Короткая соответствует имени машины в Tailscale: vps1; оно может отличаться от hostname системы после нормализации, обработки совпадений или ручного переименования. Полная добавляет имя тейлнета и общий для всех суффикс: vps1.tail1a2b3.ts.net. Обе указывают на одну машину. Разница в том, что короткая форма резолвится только там, где резолвер получил search-домен вашего тейлнета. В файлах конфигурации, в cron и внутри контейнеров пишите полную форму, потому что search-домен туда чаще всего не доходит.

Имя ничего не добавляет к правам доступа. Оно превращается в тот же адрес из диапазона 100.64.0.0/10, который клиент получил при входе в тейлнет, а кто с кем может соединяться, по-прежнему решают правила доступа тейлнета, ACL или grants. Если вы только знакомитесь с моделью сети, начните с разбора того, что такое Tailscale и из чего состоит тейлнет, а установку клиента и типовые проблемы с пакетом смотрите в руководстве по ошибкам установки Tailscale на Ubuntu.

Откуда берётся имя тейлнета

Имя тейлнета видно в админке на странице DNS, в блоке Tailnet name. По умолчанию оно выглядит как tail1a2b3.ts.net, где вместо 1a2b3 стоит случайный набор символов. Придумать его нельзя: значение выдано вашему аккаунту. Во всех примерах ниже tail1a2b3.ts.net надо заменить на своё.

Имя тейлнета можно сменить там же в админке, выбрав один из случайно предложенных вариантов. Делайте это один раз и до того, как имена разойдутся по конфигам. Смена имени тейлнета меняет полное имя каждой машины сразу, и ссылки на старые имена в ~/.ssh/config, docker compose и мониторинге нужно проверить и обновить.

Короткая часть имени по умолчанию берётся из hostname машины: буквы приводятся к нижнему регистру, разделители вроде пробела и подчёркивания заменяются на дефис, а другие недопустимые символы удаляются. Машина с hostname My_Laptop получает имя my-laptop. Если в тейлнете уже есть машина с таким именем, Tailscale добавляет к новой числовой суффикс, поэтому три сервера, развёрнутые из одного образа с hostname ubuntu, получат три похожих, но разных имени. Это первая причина задать серверу осмысленный hostname до входа в тейлнет.

Что происходит со старым именем при переименовании машины

Переименовать машину можно с самого узла или из админки. На узле это две команды: sudo hostnamectl set-hostname web-01 меняет hostname системы, а sudo tailscale set --hostname=web-01 заставляет клиент сообщить новое имя координационному серверу. В админке нужный пункт лежит в разделе Machines, в меню конкретной машины. Имя, заданное вручную в админке при снятом флажке Auto-generate from OS hostname, не перезаписывается тем hostname, который сообщает операционная система.

Старое имя после переименования просто перестаёт существовать. Редиректа нет, алиаса нет, запрос по старому имени возвращает отрицательный ответ. Резолверы помнят отрицательный ответ какое-то время, поэтому сразу после переименования сбросьте кэш: на Linux с systemd-resolved это sudo resolvectl flush-caches. Затем посмотрите, что выводит tailscale status на любой другой машине тейлнета: в строке этого узла будет то имя, которое сейчас действует.

Адрес 100.x, который работает, когда DNS не работает

tailscale ip -4
tailscale status

tailscale ip -4 печатает адрес текущей машины. tailscale status выводит по строке на каждый узел тейлнета, с его именем и адресом. Посмотрите, что показывают обе команды у вас: это и есть те адреса, в которые в итоге превращается любое имя MagicDNS.

Адрес закреплён за машиной на всё время, пока она числится в тейлнете, если администратор не изменит его вручную. Он не зависит от DNS вообще, потому что маршрутизация внутри Tailscale построена на этих адресах, а имя подставляется на шаг раньше, при разрешении. Отсюда главная диагностическая проверка всей статьи: сравните подключение к одному и тому же порту удалённой машины по адресу 100.x и по имени. Успешный ping подтверждает доступность по ICMP, но не доступ к SSH: grant с разрешением одного TCP-порта допускает ping, даже если порт 22 закрыт правилами. Если подключение по адресу работает, а имя не резолвится, дальше нужно понять, на каком шаге теряется имя.

Два выключателя MagicDNS: тейлнет и отдельный узел

Имя чаще всего не резолвится потому, что один из двух выключателей стоит в положении «выключено». Первый общий для всей сети: в админке на странице DNS должен быть включён MagicDNS. Второй свой у каждого узла: клиент должен принимать DNS-настройки от тейлнета либо системный резолвер должен быть настроен на MagicDNS вручную.

sudo tailscale set --accept-dns=true
tailscale dns status

Первая команда включает приём настроек на этом узле. Вторая в свежих версиях клиента печатает, какой резолвер и какие домены сейчас применены. Посмотрите, что она показывает на вашей машине, и есть ли там адрес 100.100.100.100 вместе с доменом вашего тейлнета. Если команда не поддерживается вашей версией, то же состояние видно в выводе tailscale debug prefs в поле CorpDNS.

На серверах второй выключатель часто выключен намеренно. Тот, кто ставил клиент, добавил --accept-dns=false, чтобы Tailscale не трогал DNS на машине с собственным резолвером. Тогда Tailscale не настраивает системный DNS, но его резолвер на 100.100.100.100 продолжает отвечать на запросы об именах тейлнета, если MagicDNS включён в админке. Включать флаг обратно не обязательно: можно оставить свой резолвер и направить в нём зону ts.net на 100.100.100.100.

Почему имя не резолвится на VPS, хотя на ноутбуке работает

Адрес 100.100.100.100 обслуживает не удалённый сервер, а демон tailscaled на вашей же машине. Он отвечает на запросы об именах тейлнета из карты сети, которую уже держит в памяти. Чтобы система спрашивала именно его, tailscaled должен встроиться в цепочку разрешения имён. На Linux клиент поддерживает systemd-resolved по D-Bus, NetworkManager, Debian resolvconf и openresolv, а также прямую правку /etc/resolv.conf; при работе через systemd-resolved он привязывает к интерфейсу tailscale0 резолвер 100.100.100.100 и домен тейлнета.

В образах VPS эта цепочка рвётся по трём типовым причинам:

  • DNS-менеджер не используется, tailscaled пишет в /etc/resolv.conf напрямую, а DHCP-клиент или другой инструмент настройки сети переписывает файл обратно при следующей перенастройке сети. В результате настройки Tailscale теряются.
  • /etc/resolv.conf не направляет запросы в systemd-resolved, хотя Tailscale передал настройки именно ему. Проверьте ссылку на /run/systemd/resolve/stub-resolv.conf и содержимое файла: само по себе отсутствие ссылки ещё не означает поломку DNS.
  • в минимальном образе нет D-Bus, и клиент не может сообщить resolved о новом интерфейсе.
resolvectl status tailscale0
ls -l /etc/resolv.conf
resolvectl query vps1.tail1a2b3.ts.net

Посмотрите, что показывает resolvectl status tailscale0: в этом блоке перечислены DNS-сервер и домены, привязанные к интерфейсу. ls -l /etc/resolv.conf скажет, файл это или ссылка. resolvectl query проверит разрешение имени через systemd-resolved и напечатает, чем оно закончилось.

Теперь разделяющая проверка. Спросите резолвер Tailscale напрямую, в обход системного пути.

sudo apt install -y bind9-dnsutils
dig @100.100.100.100 vps1.tail1a2b3.ts.net +short

Сравните два результата. Если прямой запрос к 100.100.100.100 возвращает адрес, а resolvectl query с тем же именем не возвращает, то MagicDNS исправен и сломано разрешение через systemd-resolved: занимайтесь его настройками и /etc/resolv.conf. Если пустой ответ даёт и прямой запрос, проверьте, включён ли MagicDNS в админке и есть ли машина с таким именем в сети; --accept-dns=false сам по себе не отключает ответы на прямые запросы к 100.100.100.100.

Привести систему в рабочее состояние на Ubuntu можно так:

sudo systemctl enable --now systemd-resolved
sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf
sudo tailscale set --accept-dns=true
sudo systemctl restart tailscaled

Вторую строку выполняйте только если DNS на этой машине действительно должен управляться systemd-resolved. На VPS со своим unbound или dnsmasq сначала проверьте, как они связаны с systemd-resolved: замена ссылки меняет путь DNS-запросов и без нужной настройки нарушит разрешение имён.

Почему имя не резолвится внутри Docker контейнера

Причина в том, как Docker готовит DNS для контейнера. В стандартной bridge-сети Docker использует настройки из файла резолверов хоста и удаляет адреса на localhost, потому что внутри контейнера 127.0.0.53 указывает на сам контейнер, а не на хост; в пользовательских сетях работает встроенный резолвер Docker 127.0.0.11. Если единственный nameserver в /etc/resolv.conf хоста равен 127.0.0.53, Docker распознаёт systemd-resolved и читает /run/systemd/resolve/resolv.conf с вышестоящими резолверами. Это не означает автоматическую подстановку публичного DNS, но настройки маршрутизации DNS по доменам из systemd-resolved таким способом не передаются. Если выбранные резолверы не знают имён тейлнета, имя внутри контейнера не резолвится, хотя на хосте то же самое имя резолвится нормально.

Лечится это тем, что резолвер и search-домен задаются контейнеру явно.

docker run --rm --dns 100.100.100.100 --dns-search tail1a2b3.ts.net alpine:3.21 ping -c 3 vps1

То же самое в compose:

services:
  app:
    image: alpine:3.21
    dns:
      - 100.100.100.100
    dns_search:
      - tail1a2b3.ts.net

Условие одно: пакеты из контейнера должны доходить до 100.100.100.100. На обычной bridge-сети они уходят через хост, где запросы к этому адресу обслуживает локальный tailscaled; проверьте, что правила сети пропускают их. На сети, объявленной как internal: true, нет маршрута по умолчанию и закрыт обмен с другими сетями, поэтому прямой запрос к 100.100.100.100 этим путём не пройдёт; доступ к адресу шлюза и настроенным на нём сервисам хоста сохраняется. Как устроены такие сети, подробно разобрано в описании сетей docker compose. Второй рабочий вариант: поднять клиент Tailscale отдельным контейнером и пускать сервисы через его сетевой стек, что описано в запуске Tailscale в docker compose.

Что делает перехват порта 53 роутером или провайдером

Если ваш роутер или провайдер заворачивает весь трафик на 53 порт на свой резолвер, на имена .ts.net это не влияет. Запрос к 100.100.100.100 обслуживает локальный демон, ответ собирается из карты сети, и пакет с этим запросом не покидает машину. Перехватывать там нечего.

Перехват затрагивает внешние DNS-запросы, отправленные по порту 53. По умолчанию для них используются локальные DNS-настройки, а домены Split DNS направляются к соответствующим restricted nameservers. Опция Override DNS servers направляет остальные запросы к Global nameservers; поддерживаемые публичные резолверы Tailscale использует через DNS поверх HTTPS. На Linux с systemd-resolved домены, полученные от DHCP на другом интерфейсе, сохраняют свой маршрут даже при включённой опции. Симптом узнаваемый: ssh vps1.tail1a2b3.ts.net работает, а обычные сайты резолвятся неправильно, медленно или не резолвятся совсем.

Есть два способа развести эти случаи. Первый: указать в Global nameservers поддерживаемый публичный резолвер, например Cloudflare или Google, и включить Override DNS servers. Для таких резолверов клиент Tailscale использует DNS поверх HTTPS, то есть 443 порт, и перехват 53 не затрагивает эти запросы. Второй: оставить Override DNS servers выключенным, если вам нужны только имена тейлнета. Тогда имена тейлнета обслуживает MagicDNS, а остальные запросы используют локальные DNS-настройки, кроме доменов с отдельно настроенным Split DNS.

Отдельно в админке живёт Split DNS: конкретный домен можно отправить на конкретный резолвер внутри тейлнета, например внутреннюю зону компании на сервер, доступный только по Tailscale. Ради этого люди и поднимают приватный DNS для внутренних имён, только здесь не нужен свой сервер на каждой площадке. Помните ещё, что при включённом выходном узле на VPS внешние DNS-запросы по умолчанию обслуживает этот узел, если для отдельных nameservers не включено использование с exit node, поэтому результаты могут отличаться от того, что даёт та же машина без него.

Если вы пришли сюда от чистого WireGuard, сравните подходы в разборе DNS поверх WireGuard: механика та же, но строку DNS = там вы пишете руками и сами отвечаете за утечки. А если зависеть от чужого координационного сервера не хочется, поддержку MagicDNS и настройку собственного DNS-суффикса даёт Headscale, развёрнутый на своём VPS.

Запись в ~/.ssh/config вместо скопированного IP

Ради этого всё и затевалось. Вместо ssh deploy@100.101.102.103 в конфиг попадает имя, а вы работаете с коротким алиасом.

Host vps1
    HostName vps1.tail1a2b3.ts.net
    User deploy
    IdentityFile ~/.ssh/id_ed25519
    ServerAliveInterval 30

Host задаёт алиас, который вы набираете в терминале. HostName задаёт имя, которое ssh передаёт резолверу. Дальше достаточно ssh vps1, и адрес машины больше нигде у вас не записан, поэтому его смена ничего не ломает. При первом подключении по новому имени ssh спросит подтверждение отпечатка ключа, если ключ ещё не известен клиенту и настройки проверки это предусматривают, а затем сохранит запись в ~/.ssh/known_hosts. Сверьте его с тем, что выводит ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub на самом сервере.

Рядом держите запасной блок с адресом:

Host vps1-ip
    HostName 100.101.102.103
    User deploy
    IdentityFile ~/.ssh/id_ed25519

Если имя перестанет резолвиться после обновления клиента, перезагрузки VPS или правки сетевых настроек, вы войдёте по адресу и почините DNS изнутри. Адрес 100.x для этого и годится: он не зависит от DNS. Именно такая схема позволяет закрыть 22 порт снаружи и вообще перестать пробрасывать порты на роутере. Если на сервере включить sudo tailscale set --ssh, доступом по Tailscale начнут управлять сетевые и SSH-правила тейлнета вместо authorized_keys, но запись в ~/.ssh/config от этого не становится лишней: имя вы всё равно набираете.

Порядок проверки, когда имя не резолвится

  1. tailscale status на обеих машинах: нужный узел вообще есть в списке и не помечен как offline.
  2. Пинг по адресу удалённой машины из tailscale status или из tailscale ip -4, выполненной на ней: он проверяет ICMP, а доступ к нужному порту проверьте отдельным подключением по тому же адресу. Без аргумента tailscale ip -4 показывает адрес текущей машины.
  3. tailscale dns status на проблемной машине: видно, применены ли настройки MagicDNS.
  4. dig @100.100.100.100 vps1.tail1a2b3.ts.net +short: отделяет проблему тейлнета от проблемы системного резолвера.
  5. Полное имя вместо короткого: если полное работает, а короткое нет, проверьте search-домен и порядок обработки search-доменов системным резолвером.
  6. Адрес 100.x во временный блок ~/.ssh/config, чтобы попасть на машину и продолжить разбор с неё.

FAQ

Почему имя MagicDNS резолвится на ноутбуке, но не на VPS?

На ноутбуке клиент Tailscale обычно настраивает DNS сам и целиком, а на сервере в эту же цепочку встроены systemd-resolved, cloud-init и netplan. Типовых причин три: на узле стоит --accept-dns=false и нет ручной настройки, система не направляет запросы в настроенный Tailscale резолвер, или сторонний менеджер сети переписал файл после tailscaled. На машине с systemd-resolved сравните dig @100.100.100.100 <имя> и resolvectl query <имя>: если прямой запрос отвечает, а запрос через resolved нет, чинить надо настройки systemd-resolved.

Как узнать полное имя машины и имя своего тейлнета?

Имя тейлнета показано в админке на странице DNS, в блоке Tailnet name, и по умолчанию выглядит как tail1a2b3.ts.net со случайной частью; после переименования там будет выбранный вариант. Полное имя машины складывается из её имени в Tailscale и этого суффикса. Проверить, под каким именем машина сейчас числится, можно командой tailscale status с любого другого узла тейлнета: там перечислены имена и адреса всех машин.

Что будет со старым именем, если переименовать машину?

Старое имя перестаёт резолвиться, и ничего не перенаправляет запросы на новое. Всё, что ссылалось на старое имя машины, перестаёт работать: записи в ~/.ssh/config и адреса в системе мониторинга; dns_search в compose меняется при смене суффикса тейлнета. Отрицательный ответ ещё какое-то время живёт в кэшах, поэтому после переименования сбросьте кэш командой sudo resolvectl flush-caches на клиентах с systemd-resolved.

Почему имя машины не резолвится внутри Docker контейнера?

Docker использует DNS-настройки хоста, а в пользовательских сетях передаёт запросы через встроенный резолвер 127.0.0.11. Если единственный nameserver хоста равен 127.0.0.53, Docker распознаёт systemd-resolved и использует /run/systemd/resolve/resolv.conf с вышестоящими резолверами, а не автоматически подставляет публичные. Эти резолверы могут не знать имён тейлнета, потому что маршрутизация запросов по доменам из systemd-resolved не переносится в контейнер. Запустите контейнер с --dns 100.100.100.100 и --dns-search <ваш тейлнет>.ts.net, либо задайте те же ключи dns и dns_search в compose.

Была ли эта статья полезной?