Netplan в Ubuntu: статический IP, шлюз и DNS с готовым конфигом | AdminWiki

Netplan в Ubuntu: статический IP, шлюз и DNS с готовым конфигом

10 ноября 2026 10 мин. чтения

Что такое Netplan и когда он нужен

Чтобы задать статический адрес, шлюз и DNS в Ubuntu, отредактируйте YAML-файл в /etc/netplan, опишите в нём секции addresses, routes и nameservers, примените настройки командой netplan try или netplan apply и проверьте результат через ip addr, ip route и resolvectl status. Всё остальное, включая ручной вызов ifconfig, route add и правку /etc/resolv.conf, в этой схеме не нужно.

Netplan это декларативный слой конфигурации сети в Ubuntu. Он не держит демон в памяти и не управляет линком напрямую: утилита читает YAML из /etc/netplan/*.yaml и генерирует файлы для одного из бэкендов, systemd-networkd или NetworkManager. Дальше сетью занимается выбранный бэкенд. Отсюда два практических следствия: конфиг всегда один и тот же по структуре, а поведение зависит от значения renderer.

network:
  version: 2
  renderer: networkd

Примеры в статье рассчитаны на Ubuntu Server 20.04, 22.04 и 24.04, где Netplan идёт по умолчанию. На десктопных сборках чаще активен NetworkManager, и тогда renderer: NetworkManager ближе к тому, как система уже работает.

Имя файла конфигурации в /etc/netplan зависит от образа и способа установки. На облачных образах Ubuntu типичен /etc/netplan/50-cloud-init.yaml: его создаёт cloud-init из метаданных активного datasource, и при следующей загрузке cloud-init может создать или обновить этот файл, из-за чего ручные правки сети откатываются. Если правите 50-cloud-init.yaml без отключения сетевой части cloud-init, изменения рискуют исчезнуть после reboot. Конкретный набор файлов в вашей системе проверьте командой ls /etc/netplan.

КомпонентЧто делаетГде смотреть состояние
NetplanЧитает YAML и генерирует конфиги бэкендаnetplan generate, netplan get
systemd-networkdНастраивает линки при renderer: networkdsystemctl status systemd-networkd
NetworkManagerНастраивает линки при renderer: NetworkManagersystemctl status NetworkManager, nmcli
systemd-resolvedОтдаёт DNS-настройки приложениюresolvectl status

Базовый сценарий замены DHCP на статику одинаков для всех трёх LTS-версий. Различия касаются деталей синтаксиса и версии самого Netplan, о них ниже. Общий разбор постоянной конфигурации адреса в разных менеджерах есть в материале про настройку статического IP-адреса в Linux.

Готовый конфиг Netplan для статического IP, шлюза и DNS

Полный рабочий файл /etc/netplan/01-static.yaml. Замените имя интерфейса, адрес, шлюз и DNS на свои:

network:
  version: 2
  renderer: networkd
  ethernets:
    enp0s3:
      dhcp4: false
      dhcp6: false
      addresses:
        - 192.168.1.50/24
      routes:
        - to: default
          via: 192.168.1.1
      nameservers:
        addresses: [1.1.1.1, 8.8.8.8]
        search: [example.local]

Что означает каждое поле:

  • version: 2 - версия схемы Netplan, обязательна в каждом файле.
  • renderer: networkd - бэкенд, который применит настройки. На сервере без графики это типичный выбор.
  • ethernets.enp0s3 - имя физического интерфейса. Узнать его: ip link или ip -br addr.
  • dhcp4: false, dhcp6: false - отключают автоматическое получение адреса, иначе DHCP-адрес может конкурировать со статическим.
  • addresses - список адресов в CIDR. Маска /24 соответствует 255.255.255.0.
  • routes с to: default и via - маршрут по умолчанию, он же шлюз.
  • nameservers.addresses - IP-адреса резолверов, search - домены поиска.

Права на файл: если Netplan в выводе предупреждений указывает на слишком открытые права YAML, ограничьте доступ командой chmod 600 /etc/netplan/01-static.yaml. Шлюз должен лежать в той же подсети, что и адрес интерфейса, иначе маршрут по умолчанию не установится. Для 192.168.1.50/24 рабочий шлюз это 192.168.1.1, а 10.0.0.1 в этом конфиге приведёт к ошибке при применении.

Почему gateway4 устарел и как теперь задавать шлюз

Старые примеры выглядят так:

network:
  version: 2
  ethernets:
    enp0s3:
      dhcp4: false
      addresses: [192.168.1.50/24]
      gateway4: 192.168.1.1
      nameservers:
        addresses: [1.1.1.1, 8.8.8.8]

Ключ gateway4 (как и gateway6) помечен разработчиками как устаревший. При запуске netplan generate выводится предупреждение вида «gateway4 has been deprecated, use default routes instead» с рекомендацией перейти на блок routes с to: default. Точный статус ключа в вашей версии Netplan проверьте командой man netplan. Предупреждение о deprecated-ключе и рекомендацию использовать default routes подтверждают обсуждения на Ask Ubuntu и Unix Stack Exchange.

Рабочая замена это блок routes с to: default и via. Он равнозначен старому шлюзу, но допускает несколько маршрутов, отдельные таблицы и метрики:

      routes:
        - to: default
          via: 192.168.1.1
          metric: 100
        - to: 10.20.0.0/16
          via: 192.168.1.2

Маршруты к отдельным подсетям и несколько таблиц разобраны в статье про маршрутизацию в Ubuntu через Netplan. Для типового сервера с одним провайдером достаточно одной строки to: default.

Как прописать DNS и search-домены

DNS задаётся вложенным словарём nameservers. Список addresses принимает IPv4 и IPv6, поиск коротких имён работает через search:

      nameservers:
        addresses: [1.1.1.1, 8.8.8.8, 2606:4700:4700::1111]
        search: [example.local, prod.example.com]

DNS-настройки из Netplan попадают в systemd-resolved, который слушает локальный stub на адресах 127.0.0.53 и 127.0.0.54 на loopback-интерфейсе (порт 53, UDP и TCP). Приложения обращаются к 127.0.0.53 и получают ответ через этот stub. Проверка: resolvectl status. Ручная правка /etc/resolv.conf бессмысленна: на современных Ubuntu это симлинк на файл systemd-resolved (например, /run/systemd/resolve/stub-resolv.conf), и менеджер сети перезапишет содержимое при следующем применении конфига. Поведение stub и симлинка /etc/resolv.conf описано в man-странице systemd-resolved.

Отдельный случай, когда DNS нужен только одному интерфейсу в многопользовательской схеме: тогда резолверы привязываются к конкретному линку и проверяются через resolvectl status с именем интерфейса.

Как применить изменения: netplan try и netplan apply

Порядок безопаснее начинать с проверки синтаксиса, а не с применения:

  1. netplan generate - рендерит конфиги бэкенда и показывает ошибки YAML без изменения работающей сети.
  2. netplan try - применяет настройки и запускает таймер отката, по умолчанию 120 секунд. Если доступ по SSH жив, подтвердите конфигурацию интерактивно либо сигналом SIGUSR1; отклонить изменения можно сигналом SIGINT. Если связь потеряна, по истечении таймера система вернёт прежние настройки.
  3. netplan apply - применяет конфиг сразу и без возможности автоматического отката. Эту команду используют, когда изменения проверены, или когда работа идёт через консоль.

Разница простая: try рассчитан на работу по SSH и даёт страховку, apply сразу фиксирует результат. На удалённом сервере без out-of-band доступа (IPMI, KVM, консоль гипервизора) сначала try. Таймаут по умолчанию 120 секунд и способы подтверждения через SIGUSR1/SIGINT описаны в документации netplan try.

При ошибке в YAML команда возвращает сообщение с номером строки и описанием проблемы, например про недопустимый отступ или ожидаемый тип значения. Это самый быстрый способ найти опечатку. Если netplan молчит, а сеть не работает, смотрите journalctl -u systemd-networkd (или -u NetworkManager) и статус линка через ip link.

На некоторых конфигурациях с NetworkManager изменения бэкенда требуют перезапуска службы, а не только netplan apply. Проверяйте фактическое состояние командой ip addr, а не только кодом возврата.

Проверка сетевых настроек Ubuntu после применения

Набор команд с ожидаемым выводом, который закрывает весь путь от адреса до внешнего резолвинга:

КомандаЧто подтверждаетОжидаемый результат
ip -br addr show enp0s3Адрес и маскаenp0s3 UP 192.168.1.50/24
ip routeМаршрут по умолчаниюdefault via 192.168.1.1 dev enp0s3 proto static
ip route get 1.1.1.1Каким путём пойдёт трафик к внешнему адресу1.1.1.1 via 192.168.1.1 dev enp0s3
ping -c 3 192.168.1.1Доступность шлюза на L2/L33 packets transmitted, 3 received
ping -c 3 1.1.1.1Выход в интернет без участия DNSбез потерь пакетов
resolvectl statusDNS-серверы и search-доменыDNS Servers: 1.1.1.1, 8.8.8.8
getent hosts example.comРезолвинг через NSS, как у приложенийстрока с IP-адресом
curl -I https://example.comПолный цикл: DNS, маршрут, TCP, TLSHTTP/2 200 или 301
systemctl status systemd-networkdСостояние бэкенда при renderer: networkdactive (running)

Признак проблемы номер один: default в выводе ip route отсутствует или указывает на старый шлюз. Тогда пакеты уходят только внутри подсети, а внешние адреса недоступны. Если ping по IP идёт, а getent hosts и curl по домену падают, дело в DNS. Диагностика маршрутов через ip route get и traceroute подробно разобрана в материале про статическую маршрутизацию в Linux.

Открытые порты и слушающие сокеты проверяются через ss -tulpn, если после смены адреса сервис перестал отвечать на новом IP: часть демонов слушает конкретный адрес, а не 0.0.0.0.

Типичные ошибки и как их исправить

Отступы и табы в YAML

YAML чувствителен к отступам. Допустимы только пробелы, табы запрещены, вложенность задаётся двумя пробелами на уровень. Частая поломка: блок addresses выровнен по ключу ethernets вместо имени интерфейса, и Netplan трактует его как неизвестное поле.

network:
  version: 2
  ethernets:
    enp0s3:          # 4 пробела
      addresses:     # 6 пробелов
        - 192.168.1.50/24
      routes:        # 6 пробелов, тот же уровень, что addresses
        - to: default
          via: 192.168.1.1   # 10 пробелов, глубже элемента списка

Проверка: netplan generate. Сообщение указывает строку и ожидаемый токен. Для визуального контроля отступов помогает sed -n l /etc/netplan/01-static.yaml: табы отображаются как \t.

Конфликт Netplan с NetworkManager

renderer определяет, кто управляет интерфейсом. Если в конфиге указан networkd, а интерфейс уже занят профилем NetworkManager, результат непредсказуем: адрес может появиться и исчезнуть, а маршрут по умолчанию пропасть после перезагрузки. Смешивать два менеджера на одном линке нельзя.

Порядок действий:

  • Проверьте, кто реально управляет линком: systemctl status systemd-networkd и systemctl status NetworkManager, затем nmcli device status.
  • Выберите один renderer для интерфейса и приведите конфиг к нему.
  • Лишний менеджер отключите для этого линка (например, через nmcli device set enp0s3 managed no) или остановите службу, если она не нужна на сервере.
  • Перезапустите нужную службу и повторите netplan apply.

На серверных образах Ubuntu без графики типичная схема это networkd, на десктопах и в образах с cloud-init встречается NetworkManager. Главное правило: один линк, один менеджер.

Неверное имя интерфейса

Конфиг с eth0 на системе, где интерфейс называется enp0s3 или ens3, не применится к реальному линку. Современные Ubuntu используют predictable network interface names, поэтому имена зависят от слота PCI или SMBIOS, а не от порядка обнаружения.

Определите имя до правки конфига:

ip -br addr
ip link show

В выводе будет что-то вида enp0s3 UP 192.168.1.50/24 или ens192 DOWN. Ошибка в одну букву даёт молчаливое отсутствие настроек: netplan отработает без ошибок, а интерфейс останется на DHCP или без адреса. Пошаговая проверка линка и драйвера описана в гайде про настройку сетевой карты в Linux.

Две оставшиеся причины сбоев: права на файл (если Netplan в предупреждениях указывает на слишком открытые права YAML, помогает chmod 600 для каждого такого файла) и перезапись конфига cloud-init, когда правки в 50-cloud-init.yaml исчезают после reboot.

Чек-лист перед перезагрузкой сервера

Перезагрузка проверяет, что конфиг читается на старте, а не только применён в текущей сессии. Пройдите пункты по порядку:

  1. Конфиг сохранён в /etc/netplan/*.yaml, права 600, лишние старые файлы с тем же интерфейсом удалены или переименованы.
  2. netplan generate проходит без ошибок и предупреждений.
  3. netplan try применился, конфигурация подтверждена, сеть осталась доступной.
  4. ip -br addr показывает нужный адрес и маску на нужном интерфейсе.
  5. ip route содержит default via с правильным шлюзом.
  6. ping шлюза и внешнего адреса проходит без потерь.
  7. resolvectl status отдаёт ожидаемые DNS-серверы, getent hosts example.com возвращает IP.
  8. Вход по SSH выполнен на новый адрес в отдельной сессии, старая сессия не закрыта.
  9. Сделан бэкап прежнего конфига: cp /etc/netplan/01-static.yaml /root/netplan-backup.yaml, и есть доступ через консоль гипервизора или IPMI.
  10. После reboot проверки из пунктов 4-7 повторены.

Не перезагружайте сервер, пока не подтверждён вход по SSH именно на новый адрес. Открытая сессия на старом IP не считается проверкой: она держится на уже установленном соединении и ничего не говорит о том, поднимется ли сеть после старта.

Особенности версий Ubuntu и cloud-init

В Ubuntu 20.04, 22.04 и 24.04 Netplan остаётся стандартным способом настройки сети, но версия утилиты и набор поддерживаемых ключей отличаются. Синтаксис routes с to: default работает во всех трёх ветках, gateway4 сохранён для совместимости и помечен как устаревший. Если сомневаетесь в поддержке конкретного поля, проверьте man netplan и примеры в /usr/share/doc/netplan или в документации Ubuntu для вашей версии.

На облачных образах Ubuntu файл 50-cloud-init.yaml создаёт cloud-init по данным инстанса. Правки напрямую затираются при следующей загрузке или пересоздании ВМ. Два рабочих подхода: менять сеть через конфигурацию cloud-init (user-data, network-config) или отключить его сетевую часть. Для отключения cloud-init проверяет параметр network-config=disabled, который автоматически отключает любую сетевую конфигурацию cloud-init; это описано в документации cloud-init по network-config. На практике отключение оформляется drop-in файлом в /etc/cloud/cloud.cfg.d/ с директивой network: config: disabled. После отключения проверьте, что cloud-init не пересоздаёт файл: перезагрузите тестовый инстанс до включения в продакшн.

За пределами Ubuntu-стека схема другая: в RHEL-семействе сети настраивает NetworkManager, в Alpine и части контейнерных образов используется ifupdown-ng или статические файлы. Пример переноса той же задачи на другой дистрибутив есть в руководстве по настройке сети в Alt Linux.

Следующий шаг после рабочей статики: сохраните итоговый YAML в репозиторий конфигурации, добавьте проверку netplan generate в пайплайн провижининга и пропишите в runbook команды из раздела проверки. Тогда смена адресации на новом сервере займёт одну правку файла и один подтверждённый netplan try.

Поделиться: