From 042cb116ea7828983436013c46efdee72c088a6e Mon Sep 17 00:00:00 2001 From: Denozordec Date: Fri, 30 Oct 2026 21:53:53 +0700 Subject: [PATCH] Hub docs: the two servers are mdns.shnt.top and ndns.shnt.top, the hub is on dnss.shnt.top Co-Authored-By: Claude Opus 5.5 --- docs/compose.hub.example.yaml | 10 +++---- docs/compose.shnt.example.yaml | 8 ++--- docs/hub-deploy.md | 54 +++++++++++++++++----------------- 3 files changed, 36 insertions(+), 36 deletions(-) diff --git a/docs/compose.hub.example.yaml b/docs/compose.hub.example.yaml index cb07793..06e90c2 100644 --- a/docs/compose.hub.example.yaml +++ b/docs/compose.hub.example.yaml @@ -9,7 +9,7 @@ version: "3.8" # 2. Administration > Users: пользователь hub-reader в этой группе. # 3. Войти под ним и создать токен: Administration > Sessions > Create API Token. # Токены кладутся в .env рядом с этим файлом (не в git): -# DNS_TOKEN=... +# MDNS_TOKEN=... # NDNS_TOKEN=... # HUB_USER=... # логин в сам хаб # HUB_PASSWORD=... # длинный пароль: у хаба нет ограничения числа попыток входа @@ -25,18 +25,18 @@ services: - dns-net environment: # id=адрес, по порядку; токен каждого берётся из _TOKEN - - HUB_SERVERS=dns=https://dns.shnt.top,ndns=https://ndns.shnt.top - - DNS_TOKEN=${DNS_TOKEN} + - HUB_SERVERS=mdns=https://mdns.shnt.top,ndns=https://ndns.shnt.top + - MDNS_TOKEN=${MDNS_TOKEN} - NDNS_TOKEN=${NDNS_TOKEN} - HUB_USER=${HUB_USER} - HUB_PASSWORD=${HUB_PASSWORD} - - HUB_DOMAIN=hub.shnt.top + - HUB_DOMAIN=dnss.shnt.top - TZ=Asia/Novosibirsk labels: - "traefik.enable=true" - "traefik.docker.network=dns-net" - - "traefik.http.routers.hub.rule=Host(`hub.shnt.top`)" + - "traefik.http.routers.hub.rule=Host(`dnss.shnt.top`)" - "traefik.http.routers.hub.entrypoints=websecure" - "traefik.http.routers.hub.tls.certresolver=myresolver" - "traefik.http.routers.hub.service=hub-svc" diff --git a/docs/compose.shnt.example.yaml b/docs/compose.shnt.example.yaml index d5b01ff..140af40 100644 --- a/docs/compose.shnt.example.yaml +++ b/docs/compose.shnt.example.yaml @@ -173,7 +173,7 @@ services: # Хаб: одна консоль со статистикой обоих серверов на https://dnss.shnt.top # (docs/hub-deploy.md). Только чтение. Токены и вход хаба берутся из .env: - # DNS_TOKEN, NDNS_TOKEN (пользователь hub-reader на каждом сервере), HUB_USER, HUB_PASSWORD. + # MDNS_TOKEN, NDNS_TOKEN (пользователь hub-reader на каждом сервере), HUB_USER, HUB_PASSWORD. # Обновление: docker compose pull technitium-hub && docker compose up -d technitium-hub technitium-hub: image: git.shx.one/denozord/technitium-hub:latest @@ -183,9 +183,9 @@ services: - dns-net environment: # id=адрес по порядку; токен каждого из _TOKEN. Сервер на ЭТОМ же хосте можно - # указать изнутри сети, мимо Traefik: dns=http://technitium-smart:5380 - - HUB_SERVERS=dns=https://dns.shnt.top,ndns=https://ndns.shnt.top - - DNS_TOKEN=${DNS_TOKEN} + # указать изнутри сети, мимо Traefik: ndns=http://technitium-smart:5380 + - HUB_SERVERS=mdns=https://mdns.shnt.top,ndns=https://ndns.shnt.top + - MDNS_TOKEN=${MDNS_TOKEN} - NDNS_TOKEN=${NDNS_TOKEN} - HUB_USER=${HUB_USER} - HUB_PASSWORD=${HUB_PASSWORD} diff --git a/docs/hub-deploy.md b/docs/hub-deploy.md index c976f72..8dcda5f 100644 --- a/docs/hub-deploy.md +++ b/docs/hub-deploy.md @@ -1,16 +1,16 @@ # Хаб: запуск по шагам -Хаб показывает статистику двух серверов Technitium DNS (`dns.shnt.top` и `ndns.shnt.top`) в одной консоли. Это один маленький контейнер. Он отдаёт ту же консоль и сам ходит в API обоих серверов по их токенам: +Хаб показывает статистику двух серверов Technitium DNS (`mdns.shnt.top` и `ndns.shnt.top`) в одной консоли. Это один маленький контейнер. Он отдаёт ту же консоль и сам ходит в API обоих серверов по их токенам: - запрос «All servers» хаб отправляет на оба сервера и складывает ответы; - запрос к одному серверу хаб пересылает только ему; - запись хаб не выполняет никогда. -Серверы Technitium не меняются, кластер не нужен. В инструкции хаб ставится на хост, где уже работают Traefik и `technitium-smart` (`docs/compose.shnt.example.yaml`). Адрес хаба: `https://hub.shnt.top`. +Серверы Technitium не меняются, кластер не нужен. В инструкции хаб ставится на хост, где уже работают Traefik и `technitium-smart` (`docs/compose.shnt.example.yaml`). Адрес хаба: `https://dnss.shnt.top`. ``` -браузер ─► Traefik (hub.shnt.top, TLS) ─► technitium-hub:8080 - ├─► https://dns.shnt.top/api/... (DNS_TOKEN) +браузер ─► Traefik (dnss.shnt.top, TLS) ─► technitium-hub:8080 + ├─► https://mdns.shnt.top/api/... (MDNS_TOKEN) └─► https://ndns.shnt.top/api/... (NDNS_TOKEN) ``` @@ -43,7 +43,7 @@ git tag hub-v1.0.0 && git push origin hub-v1.0.0 ## Шаг 1. Пользователь только для чтения на каждом сервере -Сделайте это **на обоих серверах**: `https://dns.shnt.top` и `https://ndns.shnt.top`. Войдите в консоль сервера как администратор. +Сделайте это **на обоих серверах**: `https://mdns.shnt.top` и `https://ndns.shnt.top`. Войдите в консоль сервера как администратор. 1. **Группа.** Administration › Groups › **Add Group**: имя `hub-readers`, описание любое. 2. **Права группы.** Administration › Permissions: у группы `hub-readers` отметьте только **View** в четырёх разделах: @@ -65,18 +65,18 @@ git tag hub-v1.0.0 && git push origin hub-v1.0.0 Можно и под администратором: Administration › Sessions › **Create Token**, пользователь `hub-reader`. 5. Проверьте токен с любой машины. В ответе должно быть `"status":"ok"`: ```bash - curl -s "https://dns.shnt.top/api/dashboard/stats/get?type=LastHour&token=ТОКЕН" | head -c 200 + curl -s "https://mdns.shnt.top/api/dashboard/stats/get?type=LastHour&token=ТОКЕН" | head -c 200 ``` - `"status":"invalid-token"` значит, что скопирован не тот токен; - `"status":"error"` с сообщением об отказе в доступе значит, что у группы не хватает права View. -Результат шага: два токена, `DNS_TOKEN` (с `dns.shnt.top`) и `NDNS_TOKEN` (с `ndns.shnt.top`). +Результат шага: два токена, `MDNS_TOKEN` (с `mdns.shnt.top`) и `NDNS_TOKEN` (с `ndns.shnt.top`). --- -## Шаг 2. DNS-запись для hub.shnt.top +## Шаг 2. DNS-запись для dnss.shnt.top -В Cloudflare (зона `shnt.top`) создайте запись `hub` той же формы, что `dns`: `A` на IP хоста или `CNAME` на `dns.shnt.top`. +В Cloudflare (зона `shnt.top`) создайте запись `dnss` типа `A` на IP хоста, где работает хаб. Сертификат Traefik получит сам. В compose уже настроен `certresolver=myresolver` с DNS-challenge через Cloudflare (`CF_DNS_API_TOKEN`), отдельно открывать порт 80 для проверки не нужно. @@ -88,7 +88,7 @@ git tag hub-v1.0.0 && git push origin hub-v1.0.0 ```dotenv # Хаб: токены пользователей hub-reader с шага 1 -DNS_TOKEN=вставьте_токен_dns +MDNS_TOKEN=вставьте_токен_mdns NDNS_TOKEN=вставьте_токен_ndns # Вход в сам хаб (это НЕ логин Technitium) @@ -121,17 +121,17 @@ chmod 600 .env - dns-net environment: # id=адрес, по порядку; токен каждого берётся из _TOKEN - - HUB_SERVERS=dns=https://dns.shnt.top,ndns=https://ndns.shnt.top - - DNS_TOKEN=${DNS_TOKEN} + - HUB_SERVERS=mdns=https://mdns.shnt.top,ndns=https://ndns.shnt.top + - MDNS_TOKEN=${MDNS_TOKEN} - NDNS_TOKEN=${NDNS_TOKEN} - HUB_USER=${HUB_USER} - HUB_PASSWORD=${HUB_PASSWORD} - - HUB_DOMAIN=hub.shnt.top + - HUB_DOMAIN=dnss.shnt.top - TZ=Asia/Novosibirsk labels: - "traefik.enable=true" - "traefik.docker.network=dns-net" - - "traefik.http.routers.hub.rule=Host(`hub.shnt.top`)" + - "traefik.http.routers.hub.rule=Host(`dnss.shnt.top`)" - "traefik.http.routers.hub.entrypoints=websecure" - "traefik.http.routers.hub.tls.certresolver=myresolver" - "traefik.http.routers.hub.service=hub-svc" @@ -142,10 +142,10 @@ chmod 600 .env Про имена в `HUB_SERVERS`: - имя слева от `=` видно в консоли в селекторе «Server»; -- из имени получается переменная токена: `dns` даёт `DNS_TOKEN`, `ndns` даёт `NDNS_TOKEN`, `my-dns` дал бы `MY_DNS_TOKEN`; +- из имени получается переменная токена: `mdns` даёт `MDNS_TOKEN`, `ndns` даёт `NDNS_TOKEN`, `my-dns` дал бы `MY_DNS_TOKEN`; - первый в списке сервер считается основным. -Адреса серверов указываются публичные (`https://dns.shnt.top`). API Technitium доступно по тому же адресу, что и консоль (роутер `panel-old` в Traefik), отдельный порт не нужен. +Адреса серверов указываются публичные (`https://mdns.shnt.top`). API Technitium доступно по тому же адресу, что и консоль (роутер `panel-old` в Traefik), отдельный порт не нужен. --- @@ -174,19 +174,19 @@ docker compose logs -f technitium-hub ## Шаг 6. Проверка -1. Откройте `https://hub.shnt.top` и войдите с `HUB_USER` / `HUB_PASSWORD` из `.env`. +1. Откройте `https://dnss.shnt.top` и войдите с `HUB_USER` / `HUB_PASSWORD` из `.env`. 2. На Dashboard над заголовком должен быть селектор **Server: All servers**. -3. Сверьте цифры. Total Queries в «All servers» должна равняться сумме значений в консолях `dns.shnt.top` и `ndns.shnt.top` за тот же период. Расхождение в пределах минуты нормально: хаб кеширует ответы на 15 секунд, а Last Hour обновляется на ходу. -4. Выберите в селекторе `dns`, затем `ndns`: цифры каждого сервера должны совпасть с его собственной консолью. +3. Сверьте цифры. Total Queries в «All servers» должна равняться сумме значений в консолях `mdns.shnt.top` и `ndns.shnt.top` за тот же период. Расхождение в пределах минуты нормально: хаб кеширует ответы на 15 секунд, а Last Hour обновляется на ходу. +4. Выберите в селекторе `mdns`, затем `ndns`: цифры каждого сервера должны совпасть с его собственной консолью. 5. Откройте Logs › Query Logs, нажмите **Query**. Записи обоих серверов идут вместе, в колонке **Server** видно, чья запись. -6. Кнопка статуса справа в шапке показывает `hub.shnt.top`. Если какой-то сервер не ответил, там будет «1 server not answering», а по нажатию появится причина. +6. Кнопка статуса справа в шапке показывает `dnss.shnt.top`. Если какой-то сервер не ответил, там будет «1 server not answering», а по нажатию появится причина. Проверка без браузера (подставьте пароль хаба): ```bash -T=$(curl -s -X POST https://hub.shnt.top/api/user/login \ +T=$(curl -s -X POST https://dnss.shnt.top/api/user/login \ --data-urlencode "user=admin" --data-urlencode "pass=ПАРОЛЬ_ХАБА" | sed -E 's/.*"token":"([^"]+)".*/\1/') -curl -s -H "Authorization: Bearer $T" "https://hub.shnt.top/api/dashboard/stats/get?type=LastHour" | head -c 300 -curl -s -H "Authorization: Bearer $T" "https://hub.shnt.top/api/dashboard/stats/get?type=LastHour&node=ndns" | head -c 300 +curl -s -H "Authorization: Bearer $T" "https://dnss.shnt.top/api/dashboard/stats/get?type=LastHour" | head -c 300 +curl -s -H "Authorization: Bearer $T" "https://dnss.shnt.top/api/dashboard/stats/get?type=LastHour&node=ndns" | head -c 300 ``` --- @@ -217,7 +217,7 @@ docker compose rm -f technitium-hub # удалить контейнер | Переменная | По умолчанию | Что задаёт | |---|---|---| | `HUB_SERVERS` | обязательна | Серверы по порядку: `id=https://адрес,...` | -| `_TOKEN` | обязательна для каждого | API-токен сервера (`DNS_TOKEN`, `NDNS_TOKEN`, ...) | +| `_TOKEN` | обязательна для каждого | API-токен сервера (`MDNS_TOKEN`, `NDNS_TOKEN`, ...) | | `HUB_USER`, `HUB_PASSWORD` | обязательны | Вход в хаб | | `HUB_DOMAIN` | `hub` | Имя, которое консоль показывает как имя сервера | | `HUB_CACHE_SECONDS` | `15` | Сколько секунд хранить ответы серверов (0 выключает кеш) | @@ -226,7 +226,7 @@ docker compose rm -f technitium-hub # удалить контейнер Третий сервер добавляется строкой в `HUB_SERVERS` и его токеном: ```yaml - - HUB_SERVERS=dns=https://dns.shnt.top,ndns=https://ndns.shnt.top,lab=https://lab.shnt.top + - HUB_SERVERS=mdns=https://mdns.shnt.top,ndns=https://ndns.shnt.top,lab=https://lab.shnt.top - LAB_TOKEN=${LAB_TOKEN} ``` @@ -237,8 +237,8 @@ docker compose rm -f technitium-hub # удалить контейнер | Признак | Причина и что делать | |---|---| | Контейнер сразу завершается | В `docker compose logs technitium-hub` будет названа недостающая переменная. Проверьте `.env` и что compose его видит (`docker compose config \| grep TOKEN`). | -| `https://hub.shnt.top` не открывается, ошибка сертификата | Нет DNS-записи `hub` (шаг 2) или Traefik ещё получает сертификат: смотрите `docker logs traefik`. | -| 404 от Traefik | Контейнер не в сети `dns-net` или опечатка в `Host(\`hub.shnt.top\`)`. | +| `https://dnss.shnt.top` не открывается, ошибка сертификата | Нет DNS-записи `dnss` (шаг 2) или Traefik ещё получает сертификат: смотрите `docker logs traefik`. | +| 404 от Traefik | Контейнер не в сети `dns-net` или опечатка в `Host(\`dnss.shnt.top\`)`. | | Вход в хаб: «Invalid username or password» | Неверные `HUB_USER`/`HUB_PASSWORD` в `.env`. После правки `.env` нужен `docker compose up -d technitium-hub`. | | В шапке «1 server not answering», в подсказке `ndns: its API token was refused` | Токен `NDNS_TOKEN` отозван или скопирован с ошибкой. Создайте новый (шаг 1.4) и перезапустите хаб. | | В подсказке `... did not answer: ...` или `ECONNREFUSED` / `timeout` | Хаб не достучался до сервера. Проверьте с хоста хаба: `docker exec technitium-hub node -e "fetch('https://ndns.shnt.top/api/status').then(r=>console.log(r.status))"`. |