Справка

Как подключиться к EndlessNet

Здесь только то, что нужно пользователю: войти в консоль, выбрать сеть, установить клиент, подключить устройство и проверить, что оно в сети.

Старт

EndlessNet создаёт частную WireGuard-совместимую сеть для ваших устройств. Ежедневная работа проходит в консоли: там видны сети, устройства, статусы и готовые команды подключения.

Нужен доступ к консоли Откройте консоль и войдите через доступный провайдер авторизации.
Нужна выбранная сеть Используйте существующую сеть или создайте новую в разделе “Сети”.

Консоль

После входа доступны четыре рабочих раздела:

  • Обзор — состояние сетей и устройств.
  • Сети — создание сети, CIDR и DNS.
  • Устройства — список узлов выбранной сети.
  • Доступ — команды установки и подключения клиента.

Установка клиента

Для Debian и Ubuntu используйте APT-репозиторий UNNG. Для других систем откройте раздел “Доступ” в консоли и скопируйте команду для своей платформы.

Автоматический APT-установщик поддерживает Debian 12/13 и Ubuntu 22.04/24.04/26.04 LTS на архитектурах amd64 и arm64.

sudo install -d -m 0755 /usr/share/keyrings
curl -fsSL https://apt.unng.ru/apt/unng.gpg | sudo tee /usr/share/keyrings/unng-archive-keyring.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/unng-archive-keyring.gpg] https://apt.unng.ru/apt stable main" | sudo tee /etc/apt/sources.list.d/unng.list
sudo apt update
sudo apt install -y unng-archive-keyring endlessnet-client
Windows Используйте endlessnet-client.exe и PowerShell-команды из раздела “Доступ”.
Android и iOS Импортируйте сгенерированный wg-endlessnet.conf в официальное приложение WireGuard.

Подключение устройства

Установщик только устанавливает клиент и запускает системную службу. Enrollment начинается исключительно после явной команды endlessnet up: клиент создаёт request, показывает ссылку одобрения и завершает подключение после approve в админке.

1. Установите клиент Установщик не создаёт устройство и не запускает enrollment.
2. Запустите up Выполните endlessnet up на подключаемой машине.
3. Одобрите request Откройте approval URL, который вывел клиент, и подтвердите устройство.
4. Complete enrollment Клиент poll’ит request и после approve получает node credential и signed map.
# Установка
curl -fsSL https://endlessnet.ru/install.sh | sh

# Enrollment и подключение
endlessnet up

Проверка и обслуживание

Используйте эти команды, когда нужно проверить состояние, обновить локальный WireGuard-конфиг или отключить устройство.

Показать статус endlessnet-client status --json
Обновить конфиг endlessnet-client sync --output ./wg-endlessnet.conf
Отключить локально endlessnet-client down --output ./wg-endlessnet.conf
Выйти и отозвать устройство endlessnet-client logout

Безопасность

  • Не передавайте посторонним session token, join token и файл wg-endlessnet.conf.
  • Не передавайте токены в аргументах команд: используйте --join-token-file или stdin.
  • Не копируйте один клиентский конфиг на несколько устройств.
  • Если устройство потеряно или передано другому пользователю, выполните logout или удалите его из консоли.
  • На Unix-системах храните клиентский конфиг доступным только владельцу файла.