ncmanager

Управление WireGuard-пирами на роутерах Keenetic через веб-интерфейс и RCI API.

Текущая версия: v1.11.11

Changelog

См. CHANGELOG.md.

Возможности

Создание/удаление пиров WireGuard
Автоматическая настройка WireGuard интерфейса на роутере Keenetic через RCI (импорт .conf файла)
Установка компонентов роутера (wireguard, dns-tls) — пакетная установка с одной перезагрузкой
Настройка DoT-серверов (Quad9, Cloudflare, Яндекс с доменной фильтрацией)
DNS-маршрутизация: доменные и CIDR-правила, применяемые к каждому пиру отдельно
Библиотека пресетов DNS-маршрутов (75+ категорий)
Резервное копирование и восстановление (вкладка «Бэкап») — полный ZIP со всеми данными, atomic restore
Аутентификация по паролю с токенами
Светлая/тёмная тема (как awg-manager), сохранение выбора в localStorage
Статус WireGuard (handshake, трафик, endpoint), индикатор оплаты пиров
Автозапуск AmneziaWG интерфейсов после импорта и восстановления
Транслитерация кириллицы в именах пиров для VPN-интерфейсов на роутере
Корректное применение новой подсети сервера (перезапись wg0.conf + принудительный перезапуск интерфейса)
Заголовок «Пиры» показывает: интерфейс, IP, общее количество пиров и неоплаченных

Требования

Linux amd64 (Debian/Ubuntu)
Права root (устанавливаются через deb)
Роутер Keenetic с RCI (KeeneticOS 5.x+, поддержка DNS-over-TLS и WireGuard)

Установка

APT-репозиторий (рекомендуется)

# Импорт ключа
curl -fsSL http://deb.augin.ru/signing-key.gpg | sudo gpg --dearmor \
  -o /usr/share/keyrings/augin.gpg

# Добавление репозитория
echo "deb [signed-by=/usr/share/keyrings/augin.gpg] http://deb.augin.ru/ stable main" \
  | sudo tee /etc/apt/sources.list.d/augin.list

# Установка
sudo apt update
sudo apt install ncmanager

После установки автоматически обновляется при выходе новой версии:

sudo apt update && sudo apt upgrade ncmanager

Deb-пакет вручную

Скачайте последний .deb из Releases:

sudo dpkg -i ncmanager_<version>.deb
sudo apt-get install -f

IP forwarding включится автоматически, сервис ncmanager запустится сам.

Запуск

Сервис уже запущен после установки .deb.
Для ручного управления:

sudo systemctl restart ncmanager

По умолчанию:

Веб-интерфейс: 8080
WireGuard порт: 51820
Интерфейс: wg0
Рабочая директория: /var/lib/ncmanager
Глобальные настройки: /var/lib/ncmanager/data/config.json
Пиры: /var/lib/ncmanager/data/peers.json
DNS-маршруты: /var/lib/ncmanager/data/dns-routes.json
Конфигурация WG: /etc/wireguard/wg0.conf
Логи: /var/log/ncmanager/ (ncmanager.log, peer-vpn-*.log, components-apply.log, dns-apply.log, amnezia-install.log)

Первый запуск

Откройте http://<ваш-сервер>:8080 в браузере.
Введите пароль (по умолчанию: admin).
Добавьте первого пира через «Добавить пира».
Укажите домен роутера, логин и пароль от веб-интерфейса Keenetic.
Нажмите «Настроить компоненты» — установятся wireguard и dns-tls (одна перезагрузка).
Нажмите «Настроить VPN» — импорт конфигурации через RCI.
Нажмите «Настроить DNS» — пропишутся DoT-серверы.

Настройка роутера Keenetic

Для настройки через RCI укажите для пира:

Домен роутера (Router Domain)
Логин и пароль от веб-интерфейса роутера
Имя интерфейса (по умолчанию Wireguard0)

Кнопки управления

Кнопка	Действие
Настроить компоненты	Устанавливает компоненты `wireguard` и `dns-tls` через RCI. Пакетная установка — роутер перезагружается один раз.
Настроить VPN	Импортирует .conf на роутер, настраивает peer (endpoint, allowed-ips, keepalive), активирует интерфейс.
Настроить DNS	Прописывает DoT-серверы: Quad9 (9.9.9.9), Cloudflare (1.1.1.1), Яндекс (77.88.8.8 с доменами ru, su, рф).
Настроить DNS-маршрутизацию	Создаёт списки доменных имён и правила маршрутизации на роутере.
Скачать бэкап	Создаёт ZIP-архив с настройками, пирами, ключами, конфигами WireGuard и AmneziaWG.
Восстановить из файла	Восстанавливает состояние из ZIP-бэкапа: настройки, пиры, конфиги интерфейсов, автозапуск.

RCI-форматы

ncmanager использует следующие RCI-команды, проверенные на реальных роутерах KeeneticOS 5.x:

Установка компонентов:

{"components":{"install":[{"component":"wireguard"},{"component":"dns-tls"}]}}
{"components":{"commit":{}}}

DoT-серверы:

{"dns-proxy":{"tls":{"upstream":[
  {"address":"9.9.9.9","fqdn":"dns.quad9.net"},
  {"address":"77.88.8.8","fqdn":"common.dot.dns.yandex.net","domain":"ru"}
]}}}

DNS-маршруты:

{"object-group":{"fqdn":{"group_p1":{"include":[{"address":"example.com"}]}}}}
{"dns-proxy":{"route":[{"group":"group_p1","interface":"Wireguard0","auto":true}]}}

Резервное копирование и восстановление

Вкладка «Бэкап» позволяет создать полный архив состояния ncmanager и восстановить его на другом сервере.

Что попадает в бэкап

data/config.json — глобальные настройки (порт, подсеть, DNS, интерфейс, TLS)
data/peers.json — все пиры с ключами, allowed-ips, router-credentials
data/dns-routes.json — DNS-маршруты
data/server_private.key — приватный ключ WireGuard-сервера
data/.auth — хеш пароля администратора
data/.secret — HMAC-секрет для токенов
presets/dns-routes.json — пресеты DNS-маршрутов
/etc/wireguard/* — все файлы конфигурации WireGuard
/etc/amnezia/amneziawg/*.conf — конфиги AmneziaWG интерфейсов

Восстановление

При восстановлении из .zip:

Все перечисленные файлы записываются на свои места
wg0.conf регенерируется из актуальных настроек и поднимается через wg-quick
AmneziaWG интерфейсы поднимаются через awg-quick up и регистрируются в systemd для автозапуска (systemctl enable --now awg-quick@<name>)
Интерфейсы, присутствовавшие в бэкапе, будут активны после восстановления

Примечания

Бэкап содержит конфиденциальные данные (приватные ключи, пароли). Храните архив в защищённом месте.
templates/, static/ и ncmanager.service в бэкап не попадают — они поставляются с пакетом.
/tmp/* логи и временные файлы в бэкап не попадают.

Остановка

sudo wg-quick down wg0

Структура проекта

/var/lib/ncmanager/
├── data/
│   ├── config.json        # Глобальные настройки (создаётся автоматически)
│   ├── peers.json         # Пиры (создаётся автоматически)
│   └── dns-routes.json    # DNS-маршруты (создаётся автоматически)
├── presets/
│   └── dns-routes.json    # Пресеты DNS-маршрутов
├── static/                # Веб-интерфейс
├── templates/             # HTML-шаблоны
└── ncmanager.service      # systemd unit

/usr/local/bin/ncmanager   # Бинарник
/etc/wireguard/wg0.conf    # Конфигурация WireGuard

API

Все endpoints кроме / и /api/version требуют базовую аутентификацию.

Метод	Endpoint	Описание
GET	`/api/version`	Версия приложения (публичный)
GET	`/api/status`	Статус WireGuard
GET	`/api/config`	Текущая конфигурация
POST	`/api/config/save`	Сохранить конфигурацию
POST	`/api/peers`	Создать пира
DELETE	`/api/peers/{id}`	Удалить пира
GET	`/api/peers/{id}/config`	Скачать .conf файл
POST	`/api/peers/keenetic/{id}`	Настроить VPN на роутере Keenetic
POST	`/api/peers/keenetic-dns/{id}`	Настроить DoT-серверы
POST	`/api/peers/keenetic-dns-routes/{id}`	Настроить DNS-маршрутизацию
POST	`/api/peers/keenetic-components/{id}`	Установить компоненты роутера
POST	`/api/components/apply`	Установить компоненты (альтернативный endpoint)
GET	`/api/components/apply/status`	Статус установки компонентов
GET	`/api/dns/routes`	Список DNS-маршрутов
POST	`/api/dns/routes/create`	Добавить DNS-маршрут
POST	`/api/dns/routes/update`	Обновить DNS-маршрут
POST	`/api/dns/routes/delete`	Удалить DNS-маршрут
POST	`/api/dns/routes/apply`	Применить DNS-маршруты к роутерам
GET	`/api/dns/apply/status`	Статус применения DNS-маршрутов
GET	`/api/presets/dns-routes`	Пресеты DNS-маршрутов
POST	`/api/backup/create`	Скачать резервную копию (ZIP)
POST	`/api/backup/restore`	Восстановить из резервной копии (ZIP)

Лицензия

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 251 Commits
.github/workflows		.github/workflows
etc		etc
presets		presets
static		static
templates		templates
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
Makefile		Makefile
README.md		README.md
backup.go		backup.go
crypto.go		crypto.go
dns_routing.go		dns_routing.go
go.mod		go.mod
go.sum		go.sum
main.go		main.go
ncmanager.service		ncmanager.service
router.go		router.go
router_components.go		router_components.go
router_dns.go		router_dns.go
router_info.go		router_info.go
router_vpn.go		router_vpn.go

Navigation Menu

Repository files navigation

ncmanager

Changelog

Возможности

Требования

Установка

APT-репозиторий (рекомендуется)

Deb-пакет вручную

Запуск

Первый запуск

Настройка роутера Keenetic

Кнопки управления

RCI-форматы

Резервное копирование и восстановление

Что попадает в бэкап

Восстановление

Примечания

Остановка

Структура проекта

API

Лицензия

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

ncmanager

Changelog

Возможности

Требования

Установка

APT-репозиторий (рекомендуется)

Deb-пакет вручную

Запуск

Первый запуск

Настройка роутера Keenetic

Кнопки управления

RCI-форматы

Резервное копирование и восстановление

Что попадает в бэкап

Восстановление

Примечания

Остановка

Структура проекта

API

Лицензия

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages