kda-homenode

Установка узла на Synology — по шагам

Понадобится: Synology с DSM 7 и пакетом Container Manager (в DSM 7.0–7.1 он называется Docker), вход в DSM под администратором и файл homenode-….yaml, полученный от владельца хаба. Консоль, SSH и команды не нужны.

Файл одноразовый и действует сутки с момента выдачи. Если не успели — попросите новый.

Шаг 1. Поставить Container Manager (если ещё нет)

Центр пакетов → поиск «Container Manager» → Установить. Открыть его один раз, чтобы он дозапустился.

Шаг 2. Создать проект

  1. Открыть Container Manager → слева Проект → кнопка Создать.
  2. Имя проекта: homenode.
  3. Путь: нажать «Задать путь», выбрать общую папку docker (или любую другую) и создать в ней подпапку homenode.
  4. Источник: выбрать Создать docker-compose.yml. Откроется окно с текстом.
  5. Удалить всё, что там есть, и вставить содержимое присланного файла целиком (открыть файл в Блокноте → Ctrl+A → Ctrl+C → в окно Container Manager Ctrl+V).
  6. Далее → на следующем экране про веб-портал ничего не включать → Далее → Готово.

Container Manager скачает образ (1–3 минуты, зависит от канала) и запустит контейнер. В списке «Проект» у homenode появится зелёный статус «Выполняется».

Шаг 3. Проверить

В браузере на любом устройстве в вашей домашней сети открыть http://<адрес NAS>:8472 — например http://192.168.1.50:8472 (адрес NAS виден в Панели управления → Сеть → Сетевой интерфейс).

Должно быть: Связь с хабом: есть. Если «нет» — подождать минуту и обновить страницу; если не появилось за 5 минут — см. ниже «Если не работает».

Это ваша страница управления: пауза, лимит скорости, трафик, удаление. Она открывается только из вашей домашней сети и не требует пароля.

Если не работает

В журнале проекта «amneziawg-go не поднял awg0» или «нет /dev/net/tun». На части NAS сетевой модуль tun не загружен. Один раз сделать задачу:

  1. Панель управления → Планировщик задач → Создать → Запускаемая задача → Пользовательский скрипт.
  2. Вкладка «Общие»: имя insmod tun, пользователь root, событие Загрузка.
  3. Вкладка «Параметры задачи», поле «Пользовательский скрипт» — вставить:
#!/bin/sh
[ -c /dev/net/tun ] || insmod /lib/modules/tun.ko
mkdir -p /dev/net
[ -c /dev/net/tun ] || mknod /dev/net/tun c 10 200
  1. ОК → выделить задачу → Запустить (правой кнопкой или кнопкой сверху). Контейнер сам подхватит tun через несколько секунд, перезапускать не нужно.

«Токен не подходит» или «токен просрочен». Файл устарел или уже использован — попросить у владельца новый файл, вставить его в проект заново (Проект → homenode → Действие → Остановить → Редактировать → заменить текст → Сохранить и запустить).

Образ не скачивается. В сети иногда недоступны реестры Docker. Подождать и нажать в проекте «Собрать» ещё раз. Если не помогает — владелец пришлёт файл образа: Container Manager → Образ → Добавить → Добавить из файла, после чего снова запустить проект.

Как остановить, снять с паузы, удалить

  • Пауза — кнопка на странице http://<адрес NAS>:8472. Трафик через вас не идёт, связь с хабом остаётся.
  • Остановить совсем — Container Manager → Проект → homenode → Действие → Остановить.
  • Удалить — сначала кнопка «Удалить узел» на странице :8472 (отзывает регистрацию и стирает ключи), затем Проект → homenode → Действие → Удалить.

Для владельца хаба

Файл для получателя узла выдаёт карточка узла в админке: «Скачать compose.yaml с токеном», там же одноразовая ссылка вида https://hub.kda7889.ru/get/<код> — по ней открывается страница с кнопкой скачивания и этой инструкцией, без входа. Образ в compose — из настроек (node_image), по умолчанию hub.kda7889.ru/kda-homenode:1 из реестра на самом хабе (см. install-hub.md). Запасной путь — файл образа: docker save hub.kda7889.ru/kda-homenode:1 | gzip -1 > kda-homenode.tgz (архитектуру NAS получателя видно в Панели управления → Информационный центр → ЦП). Установка по SSH, если получателю так удобнее: sudo /usr/local/bin/docker compose up -d в папке с файлом.