☰
24.08.2026

Как установить и настроить Netmaker на VPS

Ситуация знакомая многим администраторам. База данных живёт на сервере одного провайдера, приложение на сервере другого, в офисе стоит NAS, половина команды работает из дома. Все эти машины нужно связать в одну защищённую сеть. Первый порыв понятный: поднять WireGuard и прописать пиров вручную. Схема работает до того момента, пока машин не станет больше пяти. Дальше каждое добавление сервера превращается в правку конфигов на остальных узлах.

Разберём, как решить задачу с помощью Netmaker: подготовка сервера и DNS, установка одной командой, создание сети, выпуск ключей и подключение узлов на Linux, Windows, macOS и в Docker. Отдельно рассмотрим ограничения бесплатной редакции, практические сценарии и таблицу типовых ошибок.

Сразу обозначим границу. Когда задача сводится к одному VPN-серверу и нескольким клиентам, достаточно обычного WireGuard, и в базе знаний Serverspace есть инструкции по такой установке. Здесь речь о другом уровне: управляемая сеть из десятков машин, которые видят друг друга напрямую.

Что такое Netmaker и какую задачу он решает

Netmaker это платформа автоматизации WireGuard с открытым исходным кодом. Её роль проще описать через то, чего WireGuard не делает сам. Протокол даёт быстрые шифрованные туннели между парами устройств, но не раздаёт адреса, не рассылает список пиров и не следит за сменой IP у машин. Всю эту работу традиционно выполняет администратор руками. Netmaker закрывает ровно этот слой и добавляет поверх:

Репозиторий 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 при автоматической генерации.

  1. Авторизуйтесь по учётным данным из вывода установщика.
  2. Перейдите в раздел управления пользователями в левом меню.
  3. Создайте постоянного администратора: имя, пароль, уровень доступа Admin.
  4. Выйдите из сессии и войдите заново под новой записью.
  5. Проверьте, что административные разделы доступны.

Последний шаг ловит ситуацию, когда роль назначена неверно и часть панели оказывается закрытой. Двухфакторная аутентификация настраивается в параметрах платформы и работает в бесплатной редакции тоже.

Создание сети и выбор диапазона адресов

Netmaker разворачивает одну сеть по умолчанию, её можно использовать сразу. Для собственной адресации или нескольких изолированных сегментов создайте свою сеть через кнопку в панели.

Главное решение здесь это диапазон приватных адресов. Он не должен пересекаться ни с одной сетью, откуда подключаются машины. Классическая ошибка: администратор берёт привычный 192.168.1.0/24, а у половины сотрудников ровно такая же адресация на домашних роутерах. Маршруты конфликтуют, соединение вроде бы есть, но ничего не работает. Документация предлагает безопасные варианты для сетей до 254 машин: 10.11.12.0/24, 10.20.30.0/24, 10.99.98.0/24.

Поля формы, назначение которых стоит пояснить:

После создания сети сервер добавляет в неё себя служебным узлом. Он виден в разделе узлов, и это признак корректного развёртывания.

Ключи подключения: 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 netclient

RHEL, 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 netclient

Arch и производные ставят пакет из 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 окупается

  1. Серверы у разных провайдеров. База данных в одном дата-центре, приложение в другом, резервное копирование в третьем. Машины получают приватные адреса внутри одной сети, снаружи открыт только веб-порт приложения. Сценарий удобен, когда часть инфраструктуры размещена на облачных серверах, а часть работает на своём железе.
  2. Доступ команды к тестовым контурам. Панели администрирования и staging-окружения не нужно выставлять в интернет. Один узел назначается шлюзом удалённого доступа, а списки доступа определяют, кто и до чего вправе дотянуться. Увольнение сотрудника закрывается отзывом доступа в панели.
  3. Связь офиса с облаком. Шлюз egress разворачивается внутри офисной сети и открывает доступ ко всей локальной подсети целиком, без агента на каждом принтере и рабочей станции.
  4. Кластеры Kubernetes в разных облаках. Узлы с несовместимой адресацией получают плоскую сеть и видят друг друга напрямую.
  5. Оборудование на периферии. Агент ставится на роутеры с 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, а при росте команды редакции с внешней аутентификацией. Начинать разумно с тестового контура из двух-трёх машин: такой стенд собирается за час и показывает поведение платформы на живом трафике.