Что такое 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: networkd | systemctl status systemd-networkd |
| NetworkManager | Настраивает линки при renderer: NetworkManager | systemctl 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
Порядок безопаснее начинать с проверки синтаксиса, а не с применения:
- netplan generate - рендерит конфиги бэкенда и показывает ошибки YAML без изменения работающей сети.
- netplan try - применяет настройки и запускает таймер отката, по умолчанию 120 секунд. Если доступ по SSH жив, подтвердите конфигурацию интерактивно либо сигналом SIGUSR1; отклонить изменения можно сигналом SIGINT. Если связь потеряна, по истечении таймера система вернёт прежние настройки.
- 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/L3 | 3 packets transmitted, 3 received |
| ping -c 3 1.1.1.1 | Выход в интернет без участия DNS | без потерь пакетов |
| resolvectl status | DNS-серверы и search-домены | DNS Servers: 1.1.1.1, 8.8.8.8 |
| getent hosts example.com | Резолвинг через NSS, как у приложений | строка с IP-адресом |
| curl -I https://example.com | Полный цикл: DNS, маршрут, TCP, TLS | HTTP/2 200 или 301 |
| systemctl status systemd-networkd | Состояние бэкенда при renderer: networkd | active (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.
Чек-лист перед перезагрузкой сервера
Перезагрузка проверяет, что конфиг читается на старте, а не только применён в текущей сессии. Пройдите пункты по порядку:
- Конфиг сохранён в /etc/netplan/*.yaml, права 600, лишние старые файлы с тем же интерфейсом удалены или переименованы.
- netplan generate проходит без ошибок и предупреждений.
- netplan try применился, конфигурация подтверждена, сеть осталась доступной.
- ip -br addr показывает нужный адрес и маску на нужном интерфейсе.
- ip route содержит default via с правильным шлюзом.
- ping шлюза и внешнего адреса проходит без потерь.
- resolvectl status отдаёт ожидаемые DNS-серверы, getent hosts example.com возвращает IP.
- Вход по SSH выполнен на новый адрес в отдельной сессии, старая сессия не закрыта.
- Сделан бэкап прежнего конфига: cp /etc/netplan/01-static.yaml /root/netplan-backup.yaml, и есть доступ через консоль гипервизора или IPMI.
- После 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.