Как установить и настроить Netmaker на VPS
Ситуация знакомая многим администраторам. База данных живёт на сервере одного провайдера, приложение на сервере другого, в офисе стоит NAS, половина команды работает из дома. Все эти машины нужно связать в одну защищённую сеть. Первый порыв понятный: поднять WireGuard и прописать пиров вручную. Схема работает до того момента, пока машин не станет больше пяти. Дальше каждое добавление сервера превращается в правку конфигов на остальных узлах.
Разберём, как решить задачу с помощью Netmaker: подготовка сервера и DNS, установка одной командой, создание сети, выпуск ключей и подключение узлов на Linux, Windows, macOS и в Docker. Отдельно рассмотрим ограничения бесплатной редакции, практические сценарии и таблицу типовых ошибок.
Сразу обозначим границу. Когда задача сводится к одному VPN-серверу и нескольким клиентам, достаточно обычного WireGuard, и в базе знаний Serverspace есть инструкции по такой установке. Здесь речь о другом уровне: управляемая сеть из десятков машин, которые видят друг друга напрямую.
Что такое Netmaker и какую задачу он решает
Netmaker это платформа автоматизации WireGuard с открытым исходным кодом. Её роль проще описать через то, чего WireGuard не делает сам. Протокол даёт быстрые шифрованные туннели между парами устройств, но не раздаёт адреса, не рассылает список пиров и не следит за сменой IP у машин. Всю эту работу традиционно выполняет администратор руками. Netmaker закрывает ровно этот слой и добавляет поверх:
- веб-панель, в которой сеть создаётся кнопкой, а машины добавляются ключом;
- автоматическую рассылку конфигураций: изменение на одном узле разлетается по остальным;
- списки доступа (ACL), определяющие, какие узлы вправе общаться друг с другом;
- внутренний DNS с понятными именами вместо приватных адресов;
- шлюзы для доступа к целым подсетям и для подключения пользователей извне.
Репозиторий gravitl/netmaker собрал около 11,6 тысячи звёзд и более 640 форков, последний релиз ветки 1.5 датирован концом марта 2026 года. Распространяется платформа в четырёх редакциях: бесплатная Community для самостоятельного развёртывания и три коммерческие (Teams, Business, Enterprise).
Mesh-сеть простыми словами
Представьте домашнюю сеть за роутером. Ноутбук, телефон и принтер получают приватные адреса и общаются напрямую. Это full mesh: каждое устройство доступно каждому. Противоположная схема называется «звезда»: весь трафик идёт через центральный сервер, и чтобы ноутбук достучался до принтера, пакеты сначала едут на сервер и только потом обратно.
Чаще встречается промежуточный вариант: серверы связаны напрямую, а удалённые сотрудники подключаются через выделенный шлюз. Netmaker поддерживает обе модели. Выигрыш от прямых соединений двойной: задержка ниже, и в сети нет единственной точки, отказ которой отключает всех.
Из чего состоит Netmaker: сервер, брокер и агент
Сервер Netmaker это бинарный файл на Go, который в типовой установке запускается контейнером Docker. Он обслуживает API панели и хранит конфигурацию: сети, узлы, пользователей и ключи.
Брокер сообщений Mosquitto доставляет изменения. Агенты подписываются на обновления, сервер публикует изменения, агенты перестраивают локальный WireGuard. Требование к брокеру одно: он обязан быть доступен по публичному адресу. Запомните пункт, он объясняет одну из самых частых проблем.
Netclient это агент на каждой машине. Он генерирует ключи, определяет собственный адрес и порт, отправляет данные серверу, забирает список пиров и настраивает интерфейс WireGuard.
Дополняют картину база данных (по умолчанию SQLite, опционально PostgreSQL или rqlite), обратный прокси Caddy с автоматическим выпуском TLS-сертификатов и панель управления на React.
Полезная для диагностики деталь: для каждой сети сервер поднимает собственный служебный netclient, который помогает пробивать NAT методом UDP hole punching. Живёт этот узел внутри Docker и не выходит на сетевой стек хоста.
Что подготовить до установки
Установка занимает несколько минут, подготовка примерно полчаса. Пропуск любого пункта ниже почти гарантированно ломает запуск скрипта.
Сервер. Документация называет целевой системой Ubuntu 24.04. Минимум скромный: 1 ГБ оперативной памяти, 1 vCPU и 2 ГБ диска. Для продуктивной эксплуатации рекомендуется 2 ГБ памяти, 2 vCPU и 10 ГБ диска. Обязательны публичный статический IP-адрес и возможность управлять правилами фаервола. Например, аренда VPS-сервера с готовым шаблоном Ubuntu закрывает подготовительный этап за несколько минут, выделенный адрес выдаётся сразу при создании машины.
Домен и записи DNS. Простейший вариант это одна wildcard-запись вида *.netmaker.example.com, указывающая на IP сервера. Если политика не позволяет wildcard, создайте отдельные A-записи для шести имён: api, dashboard, broker, prometheus, grafana и netmaker-exporter.
Про автоматический домен. Установщик умеет собирать имя вида nm.<ваш-ip>.nip.io без настройки DNS. Разработчики предупреждают: оно упёрлось в лимит выпуска сертификатов, и установка на нём может завершиться ошибкой. Для получасового стенда вариант допустим, для остального нужен свой домен.
Про Cloudflare. Если DNS обслуживается через Cloudflare, отключите проксирование (оранжевое облако) на записях Netmaker. Оно ломает работу MQTT: панель откроется, а узлы перестанут получать обновления.
Какие порты открыть и почему
Порты открываются в двух местах: в фаерволе машины и в правилах безопасности провайдера, если такой уровень предусмотрен. Забытый второй уровень даёт неприятную картину, когда ufw status показывает разрешение, а трафик не проходит.
| Порт | Протокол | Компонент | Назначение | Что сломается при закрытии |
|---|---|---|---|---|
| 80 | TCP | Caddy | Проверка домена и выпуск TLS-сертификатов | Установка завершится ошибкой на выпуске сертификата |
| 443 | TCP | Панель, API, брокер | Основной канал управления платформой | Панель недоступна, узлы без конфигураций |
| 51821 | UDP | Netclient | Порт агента WireGuard по умолчанию | Узлы видны в панели, но недоступны по сети |
| 443 | UDP | WireGuard | Запасной канал, когда основной порт закрыт | Узлы за жёсткими фаерволами не подключатся |
| 443 исходящий | TCP и UDP | Netclient | Связь агента с сервером | Машина не присоединится к сети |
Команды для ufw выглядят так:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 51821/udp
sudo ufw allow 443/udpОтдельно проверьте, что машина не блокирует транзит пакетов. Некоторые провайдеры выставляют политику по умолчанию в DROP, и тогда шлюзы работать не будут:
iptables --policy FORWARD ACCEPTУстановка Netmaker на VPS
Когда сервер создан, домен указывает на его адрес, а порты открыты, установка сводится к запуску одного скрипта.
Шаг 1. Подключение и обновление системы.
sudo apt update && sudo apt upgrade -yШаг 2. Установка Docker. Компоненты платформы поднимаются в контейнерах, на чистом шаблоне Ubuntu движка обычно нет:
sudo apt install -y docker.io docker-compose-plugin
sudo systemctl enable --now dockerШаг 3. Проверка DNS. Убедитесь, что записи разошлись и отвечают нужным адресом:
dig +short dashboard.netmaker.example.comПустой ответ или чужой адрес означают, что запускать установку рано.
Шаг 4. Запуск установщика. Для бесплатной редакции:
sudo wget -qO /root/nm-quick.sh https://raw.githubusercontent.com/gravitl/netmaker/master/scripts/nm-quick.sh && sudo chmod +x /root/nm-quick.sh && sudo /root/nm-quick.shДля коммерческой редакции с пробным периодом добавляется флаг -p.
Шаг 5. Ответы на вопросы установщика. Скрипт спросит домен и адрес электронной почты для сертификатов, дальше сделает всё сам: скачает образы, поднимет контейнеры сервера, панели, брокера и прокси, выпустит сертификаты и создаст учётные данные администратора. Финальный вывод содержит адрес панели и первичный пароль. Сохраните его сразу, повторно он не показывается.
Первый вход в панель и создание администратора
Открываем адрес панели: https://dashboard.netmaker.example.com для собственного домена либо имя вида https://dashboard.nm.<ip-сервера>.nip.io при автоматической генерации.
- Авторизуйтесь по учётным данным из вывода установщика.
- Перейдите в раздел управления пользователями в левом меню.
- Создайте постоянного администратора: имя, пароль, уровень доступа Admin.
- Выйдите из сессии и войдите заново под новой записью.
- Проверьте, что административные разделы доступны.
Последний шаг ловит ситуацию, когда роль назначена неверно и часть панели оказывается закрытой. Двухфакторная аутентификация настраивается в параметрах платформы и работает в бесплатной редакции тоже.
Создание сети и выбор диапазона адресов
Netmaker разворачивает одну сеть по умолчанию, её можно использовать сразу. Для собственной адресации или нескольких изолированных сегментов создайте свою сеть через кнопку в панели.
Главное решение здесь это диапазон приватных адресов. Он не должен пересекаться ни с одной сетью, откуда подключаются машины. Классическая ошибка: администратор берёт привычный 192.168.1.0/24, а у половины сотрудников ровно такая же адресация на домашних роутерах. Маршруты конфликтуют, соединение вроде бы есть, но ничего не работает. Документация предлагает безопасные варианты для сетей до 254 машин: 10.11.12.0/24, 10.20.30.0/24, 10.99.98.0/24.
Поля формы, назначение которых стоит пояснить:
- IPv4 выдаёт узлам приватные адреса четвёртой версии, основной режим;
- IPv6 добавляет адресацию шестой версии поверх IPv4, режим только с IPv6 не поддерживается;
- Default Access Control определяет, разрешено ли новому узлу сразу общаться с остальными.
После создания сети сервер добавляет в неё себя служебным узлом. Он виден в разделе узлов, и это признак корректного развёртывания.
Ключи подключения: enrollment key и registration token
Чтобы машина вошла в сеть, ей нужны учётные данные. В Netmaker их два вида, и разница регулярно вызывает путаницу.
Enrollment key это секретная строка, разрешающая узлу зарегистрироваться на сервере. Ключ бывает безлимитным по числу использований, с ограничением по количеству подключений или по времени. Привязывается он к одной сети, к нескольким сразу или не привязывается вовсе.
Registration token это строка в кодировке base64, внутри которой уже упакованы адрес сервера, порт и сам ключ. Раздавать удобнее именно токен: администратору на машине не придётся отдельно указывать, куда подключаться. Заводите отдельный ключ под каждый сценарий: для постоянных серверов безлимитный, для разового подключения подрядчика на одно использование. Исчерпанный ключ помечается в панели как недействительный.
Подключение узлов: установка netclient
Агент ставится на каждую машину сети. Предусловия для Linux одинаковы: установленный WireGuard и systemd.
Debian и Ubuntu. Подключаем репозиторий проекта и ставим пакет:
curl -sL 'https://apt.netmaker.org/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/netmaker-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/netmaker-keyring.gpg] https://apt.netmaker.org stable main" | sudo tee /etc/apt/sources.list.d/netclient.list
sudo apt update
sudo apt install netclientRHEL, Rocky, AlmaLinux и Fedora. Здесь используется rpm-репозиторий:
curl -sL 'https://rpm.netmaker.org/gpg.key' | sudo tee /tmp/gpg.key
curl -sL 'https://rpm.netmaker.org/netclient-repo' | sudo tee /etc/yum.repos.d/netclient.repo
sudo rpm --import /tmp/gpg.key
sudo dnf install netclientArch и производные ставят пакет из AUR командой yay -S netclient. Windows: установщик netclientbundle.exe умеет отрабатывать в тихом режиме через параметр quiet. macOS: Homebrew через brew tap gravitl/netclient либо загрузка pkg-файла отдельно для процессоров Apple и Intel.
Docker. Когда ставить агент в систему нежелательно, он запускается контейнером. Обратите внимание на host networking и привилегированный режим, без них агент не управляет сетевым интерфейсом:
docker run -d --network host --privileged --restart=always \
-e TOKEN=<ваш-токен> \
-v /etc/netclient:/etc/netclient \
--name netclient gravitl/netclient:latestДля контейнерного агента в роли шлюза на хосте дополнительно нужны правила:
iptables -I DOCKER-USER -i netmaker -j ACCEPT
iptables -I DOCKER-USER -o netmaker -j ACCEPTПодключение к сети. После установки агента машина ещё не входит ни в одну сеть. Добавляем её токеном:
sudo netclient join -t <ваш-токен>Проверка результата. Узел должен появиться в панели в списке участников сети. Состояние туннелей показывает команда sudo wg show, связность проверяется пингом приватного адреса соседа. Новая конфигурация расходится по сети примерно за тридцать секунд.
Когда узлами выступают виртуальные машины, порядок ровно тот же, что и для физических. Развернуть несколько VPS в разных локациях и связать их одной сетью получается за вечер.
Что доступно в бесплатной версии, а что нет
Community, бесплатная редакция: панель управления, оверлейные сети, агент netclient, списки доступа, ключи регистрации, базовые egress и шлюзы, внутренний DNS, двухфакторная аутентификация и управление пользователями. Набора достаточно для полноценной рабочей сети.
Начиная с Teams появляются группы и роли, вход через внешнего провайдера аутентификации (OAuth), десктопное и мобильное приложения. Business добавляет журналы аудита, отказоустойчивый egress и аналитику. Только в Enterprise доступны white label, журналы сетевого доступа и проверки состояния устройств.
Отдельно про телефоны. Меширование мобильных устройств в бесплатной редакции не поддерживается. Обходной путь описан в документации: один из узлов назначается шлюзом удалённого доступа, для телефона генерируется обычный конфиг WireGuard и импортируется по QR-коду.
Пять сценариев, где Netmaker окупается
- Серверы у разных провайдеров. База данных в одном дата-центре, приложение в другом, резервное копирование в третьем. Машины получают приватные адреса внутри одной сети, снаружи открыт только веб-порт приложения. Сценарий удобен, когда часть инфраструктуры размещена на облачных серверах, а часть работает на своём железе.
- Доступ команды к тестовым контурам. Панели администрирования и staging-окружения не нужно выставлять в интернет. Один узел назначается шлюзом удалённого доступа, а списки доступа определяют, кто и до чего вправе дотянуться. Увольнение сотрудника закрывается отзывом доступа в панели.
- Связь офиса с облаком. Шлюз egress разворачивается внутри офисной сети и открывает доступ ко всей локальной подсети целиком, без агента на каждом принтере и рабочей станции.
- Кластеры Kubernetes в разных облаках. Узлы с несовместимой адресацией получают плоскую сеть и видят друг друга напрямую.
- Оборудование на периферии. Агент ставится на роутеры с OpenWRT и промышленные шлюзы, а для устройств, куда его поставить нельзя, генерируется стандартный конфиг WireGuard.
Частые ошибки при настройке и способы их устранить
Большинство проблем повторяются от установки к установке. Таблица ниже связывает наблюдаемый симптом с причиной и конкретным действием.
| Симптом | Причина | Решение |
|---|---|---|
| Установка падает на выпуске сертификата | Автоматический домен упёрся в лимит центра сертификации | Завести собственный поддомен и запустить установку заново |
| Панель открывается, но узлы не получают обновления | Включено проксирование Cloudflare, оно ломает работу MQTT | Отключить оранжевое облако на всех записях платформы |
| Сертификат не выпускается, браузер ругается на соединение | Закрыт порт 80 на машине или в правилах провайдера | Открыть 80/TCP на обоих уровнях фаервола |
| Рукопожатие с соседним узлом есть, пинг не проходит | Завышенное значение MTU на интерфейсе | Снизить MTU в настройках узла, рекомендуемый минимум 1280 |
| Узлы связаны, но подсеть за шлюзом недоступна | Политика транзита пакетов установлена в DROP | Выполнить iptables --policy FORWARD ACCEPT |
| После перезагрузки агент не поднимается на RHEL-системах | SELinux мешает systemd перезапустить бинарный файл | Задать контекст через semanage и chcon для netclient |
| С самого сервера не пингуются приватные адреса узлов | Служебный узел работает внутри Docker | Поставить отдельный агент на хост с портом вне 51821-51831 |
| Сеть не удаляется из панели | В сети остались зарегистрированные узлы | Удалить все узлы, затем повторить удаление сети |
Две ошибки в таблицу не укладываются. Первая это установка на устаревшую систему: документация ориентируется на Ubuntu 24.04, на 20.04 и 22.04 возможны расхождения в зависимостях. Вторая это выбор площадки без учёта рекомендаций: документация Netmaker прямо не советует Oracle Cloud из-за сложностей с сетевой конфигурацией.
Ограничения, о которых стоит знать заранее
Нужен публичный адрес. Брокер сообщений обязан быть доступен извне. Развернуть сервер за домашним роутером без белого IP не получится.
Много поддоменов. Платформа занимает три служебных имени плюс основное. Администраторы, сравнивающие Netmaker с NetBird, нередко указывают это как аргумент против.
Особенности протокола. Стандартное рукопожатие WireGuard имеет узнаваемую сигнатуру и распознаётся системами фильтрации трафика. Netmaker уместно рассматривать как инструмент объединения собственной инфраструктуры и организации служебного доступа. Задача обхода сетевых ограничений для платформы целевой не является.
Обновления. Сервер обновляется сменой тега образа с перезапуском, агенты начиная с версии 0.20.5 обновляются сами.
Итоги и следующие шаги
Разворачивание Netmaker укладывается в понятную последовательность: подготовить сервер с белым адресом и свежей Ubuntu, завести поддомены, открыть четыре порта и разрешить транзит пакетов, запустить установочный скрипт, создать администратора, задать сеть с непересекающимся диапазоном и раздать узлам ключи. Основная часть подводных камней сосредоточена в подготовительном этапе.
Дальше сеть развивается постепенно: списки доступа, шлюз egress в офисную подсеть, внутренний DNS, а при росте команды редакции с внешней аутентификацией. Начинать разумно с тестового контура из двух-трёх машин: такой стенд собирается за час и показывает поведение платформы на живом трафике.