PCA/domen_hydra
1
0
Fork 0
mirror of https://github.com/andrey271192/domen_hydra.git synced 2026-09-20 14:42:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: полная переработка README — туннель, логины/пароли, ошибки, советы

Browse Source 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Андрей Бобырев
2026-04-28 10:09:27 +03:00
parent 708b4b04dc
commit 9ff5c61551
1 changed files with 330 additions and 115 deletions
Download Patch File Download Diff File Expand all files Collapse all files

445
README.md
View File

@@ -1,127 +1,302 @@
# 🌐 HydraRoute Manager
# HydraRoute Manager
Веб-интерфейс для централизованного управления конфигурацией **HydraRoute Neo** на роутерах Keenetic. Без мониторинга, без Telegram — только домены и IP.
Веб-панель для централизованного управления конфигурацией **HydraRoute Neo** на роутерах Keenetic. Редактируешь списки доменов и IP в браузере — одной кнопкой отправляешь на все роутеры.
> **Поддержать проект:** [Boosty](https://boosty.to/andrey27/donate) · [Ozon СБП](https://finance.ozon.ru/apps/sbp/ozonbankpay/019dc200-2a5d-7931-a619-782d285f6798) · Telegram: [@Iot_andrey](https://t.me/Iot_andrey)
![Превью веб-интерфейса](docs/preview.png)
---
## Интерфейс
## 1. Что это за проект
### Вкладка «Конфигурация» — группы доменов и IP
HydraRoute Neo — плагин для Keenetic, который маршрутизирует трафик по доменам и IP-адресам. Например: YouTube и Netflix — через VPN, всё остальное — напрямую. Конфигурация хранится в двух файлах на роутере: `domain.conf` и `ip.list`.
Карточки с переключателями вкл/выкл, политикой маршрутизации (HydraRoute, RU и т.д.), быстрым редактированием и кнопкой **«Обновить все роутеры»**.
Проблема: редактировать эти файлы напрямую неудобно, а если роутеров несколько — приходится делать всё вручную на каждом.
### Вкладка «Импорт файлов»
**Этот проект решает проблему:** устанавливаешь сервис на VPS, редактируешь домены и IP через браузер, нажимаешь «Обновить все роутеры» — файлы сами разъезжаются по всем роутерам через SSH.
Два текстовых поля для вставки содержимого `domain.conf` и `ip.list` с роутера, кнопки **«Сохранить на сервер»** и **«Сохранить + обновить все роутеры»**, ниже — экспорт текущей конфигурации для копирования.
```
┌──────────────────────────────┐
│ Браузер → http://VPS:8000 │ ← ты работаешь здесь
└──────────────┬───────────────┘
│
┌──────────────▼───────────────┐
│ HydraRoute Manager на VPS │ ← этот сервис
└──────────┬──────────┬────────┘
│ SSH │ SSH
┌──────▼──┐ ┌────▼──────┐
│Роутер 1 │ │ Роутер 2 │ ← конфиги обновляются автоматически
└─────────┘ └───────────┘
```
### Вкладка «Роутеры»
**Что умеет:**
- Редактировать группы доменов и IP через браузер.
- Включать/выключать группы одним переключателем.
- Отправлять конфиг сразу на все роутеры одной кнопкой.
- Снимать конфиг с конкретного роутера и подставлять в редактор.
- Отправлять конфиг на один конкретный роутер.
- Проверять SSH-соединение с роутером.
- Для роутеров **без белого IP** — встроенный мастер настройки обратного туннеля.
Список роутеров: **IP** — это хост для **SSH** (не веб-URL KeenDNS). У каждой строки:
- **Тест** — проверка SSH, каталога `/opt/etc/HydraRoute` (или `/opt/etc/hydra`) и наличия `domain.conf` / `ip.list` на роутере.
- **С роутера** — скачать эти файлы по SSH и подставить во вкладку **«Импорт файлов»** (сохранение на сервер — отдельной кнопкой).
- **На роутер** — отправить текущие `domain.conf` и `ip.list` с сервера **только на этот** роутер (аналог одной строки из «Обновить все роутеры»).
Внизу экрана — плашка **поддержки**: GitHub, Boosty (донат), Ozon СБП, Telegram @Iot_andrey.
API: `POST /api/routers/{имя}/test`, `GET /api/routers/{имя}/fetch`, `POST /api/routers/{имя}/push` (заголовок `X-Admin-Password`).
### Вкладка «Настройки»
Смена пароля администратора веб-интерфейса (запись в `server/.env`).
### Экран входа
При открытии сайта запрашивается пароль из `ADMIN_PASSWORD` в `.env`.
**Требования:**
- Роутер Keenetic с установленным HydraRoute Neo и Entware.
- Белый IP на WAN роутера **или** настроенный обратный тоннель (см. раздел 3).
---
## Возможности
## 2. Быстрая установка
- Управление группами доменов и IP через браузер
- Включение / отключение групп одним переключателем
- Импорт `domain.conf` и `ip.list` с роутера
- Отправка конфига на все роутеры одной кнопкой (SSH + `curl` с сервера)
- Авторизация по паролю
- Прямые ссылки для роутера: `/hydra/domain.conf`, `/hydra/ip.list`, `/hydra/version`
Вставляй команды на **VPS** (сервере), где будет работать панель.
---
## Установка сервера (Ubuntu 22/24)
Сначала перейди в **существующий** каталог (если ты был в удалённой папке вроде `/opt/keenetic-unified`, `git` выдаст `Unable to read current working directory` — тогда выполни `cd /opt` или `cd /`).
### Шаг 1 — клонируй и запусти установщик
```bash
cd /opt
git clone https://github.com/andrey271192/domen_hydra.git /opt/domen-hydra
cd /opt/domen-hydra
bash server/install.sh
nano server/.env # при необходимости поправь плейсхолдеры (см. ниже)
systemctl restart hydra-manager
sudo bash server/install.sh
```
Сервис `hydra-manager` появляется **только после** успешного `bash server/install.sh`; сообщение `Unit hydra-manager.service not found` значит, что установка не дошла до конца (часто из‑за ошибки `git clone` выше).
Установщик создаст Python-окружение и зарегистрирует systemd-сервис `hydra-manager`.
Скрипт `server/install.sh` при первом запуске **сам создаёт** `server/.env` из `server/.env.example` с уже заполненными полями (вместо паролей — текст-напоминание, его нужно заменить на свои секреты).
> Если видишь `Unable to read current working directory` — сначала выполни `cd /opt`, потом повтори.
### Файл `server/.env`
### Шаг 2 — задай пароли
| Переменная | Назначение |
|------------|------------|
| `HOST` | Адрес привязки HTTP (обычно `0.0.0.0`). |
| `PORT` | Порт веб-интерфейса (по умолчанию `8000`). |
| `ADMIN_PASSWORD` | Пароль входа в веб-интерфейс. |
| `SSH_USER` | Пользователь SSH для «Обновить все роутеры». |
| `SSH_PASS` | Пароль SSH по умолчанию (на карточке роутера можно задать свой). |
```bash
nano /opt/domen-hydra/server/.env
```
Шаблон по умолчанию (после установки открой `nano server/.env` и подставь реальные пароли):
Минимум что нужно поменять:
```env
HOST=0.0.0.0
PORT=8000
ADMIN_PASSWORD=ВАШ_НАДЁЖНЫЙ_ПАРОЛЬ_ВЕБ
```
ADMIN_PASSWORD=твой-пароль-для-панели
# SSH-пароль роутера (если у всех одинаковый)
SSH_USER=root
SSH_PASS=ПАРОЛЬ_SSH_РОУТЕРА
SSH_PASS=keenetic
```
Интерфейс: `http://ВАШ_IP:PORT` — значения `HOST` и `PORT` из `server/.env` подставляются в `hydra-manager.service` при запуске `server/install.sh`. Если поменяешь порт в `.env` уже после установки, снова выполни `bash server/install.sh` (или вручную обнови `ExecStart` в unit и `systemctl daemon-reload`).
Если планируешь **туннель** (для роутеров без белого IP) — добавь сюда же:
---
```
VPS_SSH_HOST=IP_или_домен_твоего_VPS
```
## Установка на роутер (Keenetic + Entware)
Подставь URL своего сервера:
### Шаг 3 — перезапусти сервис
```bash
export SERVER_URL="http://ВАШ_IP:8000" \
&& curl -fsSL https://raw.githubusercontent.com/andrey271192/domen_hydra/main/install_router.sh | sh
sudo systemctl restart hydra-manager
```
Роутер будет каждый день в **02:00** скачивать актуальный конфиг с сервера.
### Шаг 4 — открой панель
Ручное обновление:
```
http://IP_ТВОЕГО_VPS:8000
```
Введи пароль из `ADMIN_PASSWORD`.
### Обновление
```bash
sh /opt/bin/hydra_update.sh
cd /opt/domen-hydra && git pull && sudo systemctl restart hydra-manager
```
### Удаление
```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/domen_hydra/main/server/uninstall.sh | sudo bash
```
---
## Как пользоваться
## 3. Туннель — для роутеров без белого IP
1. Открой веб-интерфейс → введи пароль из `.env`
2. **Импорт**: вставь `domain.conf` и `ip.list` с роутера → «Сохранить на сервер»
3. Редактируй группы на вкладке «Конфигурация»
4. Нажми **«Обновить все роутеры»** — файлы запишутся в `/opt/etc/HydraRoute/` и выполнится `neo restart`
### Что такое «белый IP» и зачем он нужен
По умолчанию сервис подключается к роутеру по SSH напрямую. Для этого нужен **публичный IP** роутера — чтобы VPS мог до него «дотянуться».
Если провайдер выдаёт **серый IP** (роутер за NAT оператора — очень частая ситуация в России), VPS не может достучаться до роутера. Роутер сам должен инициировать соединение.
### Как работает туннель
Роутер сам открывает зашифрованное SSH-соединение на VPS и говорит: «слушай у себя порт 20100 — всё что придёт туда, перешли мне на порт 22 (SSH)».
```
Роутер (серый IP) ──SSH──▶ VPS :20100
│
VPS → hydra-manager ────────────▶│──▶ SSH роутера (порт 22)
```
В итоге сервис подключается к роутеру через `localhost:20100`, а не напрямую. Серый IP не мешает. Кнопки «Обновить все роутеры» и «На роутер» работают через тоннель автоматически.
### Что понадобится
- Публичный IP/домен VPS (уже есть).
- Роутер с установленным **Entware** (нужен для `autossh`).
### Установка Entware на роутер
> Entware — пакетный менеджер для роутеров, позволяет устанавливать дополнительные программы.
С KeeneticOS 4.2+ — прямо через браузер: открой `192.168.1.1/a` и следуй инструкциям.
Или через SSH на роутере (логин `root`, пароль `keenetic`, порт 22):
```sh
# MT7628/MT7621 → mipsel:
opkg disk storage:/ https://bin.entware.net/mipselsf-k3.4/installer/mipsel-installer.tar.gz
# MT7622/MT7981/MT7988 (ARM) → aarch64:
opkg disk storage:/ https://bin.entware.net/aarch64-k3.10/installer/aarch64-installer.tar.gz
```
Дождись окончания (~2 минуты), проверь: `opkg update` должен отработать без ошибок.
### Шаг 1 — настрой .env на VPS
```bash
nano /opt/domen-hydra/server/.env
```
Добавь или заполни:
```
VPS_SSH_HOST=IP_или_домен_VPS # публичный адрес, куда роутер будет коннектиться
VPS_SSH_PORT=22 # SSH-порт VPS (обычно 22)
VPS_SSH_USER=root # пользователь VPS
```
`VPS_SSH_PASS` не нужен — туннель работает через SSH-ключи, которые генерируются автоматически.
Перезапусти:
```bash
sudo systemctl restart hydra-manager
```
### Шаг 2 — добавь роутер в панель
Открой `http://VPS:8000` → вкладка «Роутеры».
**Вариант А** (роутер уже добавлен): нажми кнопку **«⇄»** напротив нужного роутера.
**Вариант Б** (роутер ещё не добавлен): введи имя и SSH-пароль роутера, нажми **«⇄ Тоннель»** вместо «+ Добавить» — роутер добавится и сразу откроется окно туннеля.
> Если кнопки «⇄ Тоннель» нет — проверь, что `VPS_SSH_HOST` в `.env` не пустой и сервис перезапущен.
### Шаг 3 — скопируй и выполни команду на роутере
В открывшемся окне появится одна команда вида:
```
curl -fsS 'http://VPS:8000/api/routers/andrey/tunnel-script?token=XXX' | sh
```
Нажми **«📋 Копировать»** (если не сработало — выдели текст и Cmd/Ctrl+C).
Зайди по SSH на **роутер** (не на VPS!) и вставь команду:
```
ssh root@192.168.1.1
```
> **Как отличить терминал роутера от VPS:**
> - Роутер: приглашение выглядит как `~ #` или `(none) ~ #`
> - VPS: выглядит как `root@имя-сервера:~#`
Скрипт автоматически:
1. Установит `autossh` через opkg.
2. Запишет SSH-ключ в `/opt/etc/hydra_tk`.
3. Создаст скрипт тоннеля `/opt/bin/hydra_tun`.
4. Пропишет автозапуск через Entware init.d.
5. Запустит тоннель в фоне.
В конце увидишь:
```
=== OK ===
Тоннель: localhost:22 (роутер) -> VPS:20100
```
### Шаг 4 — проверь связь
В браузере нажми **«⟳ Проверить связь»** — если всё хорошо, статус изменится на «✅ Активен».
После этого «Обновить все роутеры» и «📡 На роутер» будут работать через тоннель автоматически.
### Ручной запуск и диагностика
Если автоматический запуск не сработал (написало «ОШИБКА»):
```sh
# На роутере — запусти вручную (увидишь вывод):
/opt/bin/hydra_tun
# Проверить лог:
cat /tmp/hydra_tun.log
# Перезапустить через init.d:
killall autossh 2>/dev/null; sleep 1; /opt/etc/init.d/S99hydra_tun start
```
Если `/opt/bin/hydra_tun` работает вручную — попробуй перезагрузить роутер: при старте Entware сам запустит туннель.
### Проверка на VPS
```bash
ss -tlnp | grep 20100
# Должна быть строка с 127.0.0.1:20100 — значит туннель активен
```
---
## Формат файлов
## 4. Логины и пароли
**domain.conf:**
Здесь два разных набора учётных данных. Не перепутай.
### Пароль веб-панели (`ADMIN_PASSWORD`)
Пароль для входа на `http://VPS:8000`. Задаётся в `server/.env`. Никак не связан с роутерами.
### SSH-пароль роутера (`SSH_PASS`)
Это пароль для входа по SSH на роутер (`root` / `keenetic` по умолчанию). Нужен сервису, чтобы отправлять конфиги через SSH.
- **Общий для всех** — задаётся в `server/.env`: `SSH_PASS=keenetic`
- **Индивидуальный** — поле «SSH пароль» при добавлении роутера в панели (перекрывает глобальный).
> Поле **IP** — это адрес для SSH (LAN-адрес, белый IP или DDNS), **не** веб-ссылка KeenDNS. Если случайно вставил URL вроде `https://...` — сервис автоматически извлечёт из него хост.
### SSH-ключи для туннеля
Ничего делать не нужно — ключи генерируются на VPS автоматически при нажатии «⇄». Приватный ключ уходит на роутер через одноразовую ссылку (действует 10 минут). Пароль SSH для туннеля не используется.
---
## 5. Как добавлять домены и IP
### Вкладка «Конфигурация»
Здесь карточки с группами доменов и IP. Каждая группа имеет:
- **Имя** — например `youtube` или `ru-geoip`.
- **Политику** — `HydraRoute` (через VPN), `RU` (локально), `Google` и т.д.
- **Список записей** — домены или IP/CIDR, по одному на строку.
Нажми **«✏️»** на карточке → редактируй → **«💾 Сохранить»**.
### Вкладка «Импорт файлов»
На вкладке «Роутеры» нажми **«⬇ С роутера»** — файлы подтянутся автоматически и подставятся в поля импорта. Или вручную скопируй с роутера:
```sh
cat /opt/etc/HydraRoute/domain.conf
cat /opt/etc/HydraRoute/ip.list
```
### Формат domain.conf
```
##youtube
@@ -131,7 +306,7 @@ youtube.com,youtu.be,googlevideo.com/HydraRoute
avito.ru,ozon.ru/RU
```
**ip.list:**
### Формат ip.list
```
##geoip:ru
@@ -139,58 +314,98 @@ avito.ru,ozon.ru/RU
geoip:ru
```
---
### Отправка на роутеры
## Структура проекта
- **«📡 Обновить все роутеры»** — отправляет конфиг на все роутеры и делает `neo restart`.
- **«📡 На роутер»** на карточке роутера — только на один конкретный.
```
server/
main.py — FastAPI приложение
config.py — настройки из .env
hydra_manager.py — парсинг/генерация domain.conf + ip.list
models.py — модели данных
database.py — работа с JSON
install.sh — установка на Ubuntu
uninstall.sh — снятие systemd и каталога `/opt/domen-hydra` (см. README)
.env.example — шаблон конфигурации
templates/
index.html — веб-интерфейс
docs/
preview.png — превью интерфейса
install_router.sh — установка на роутер
hydra_update.sh — скачивание конфига с сервера
```
---
## Удаление с сервера (одной командой)
Останавливается `hydra-manager`, удаляется unit и каталог **`/opt/domen-hydra`**:
### Установка cron-обновления на роутер
```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/domen_hydra/main/server/uninstall.sh | sudo bash
export SERVER_URL="http://IP_ТВОЕГО_VPS:8000" \
&& curl -fsSL https://raw.githubusercontent.com/andrey271192/domen_hydra/main/install_router.sh | sh
```
Из каталога установки: `sudo bash server/uninstall.sh`
Ручное обновление прямо на роутере:
## Обновление
```sh
sh /opt/bin/hydra_update.sh
```
---
## 6. Частые ошибки и решения
### `Unit hydra-manager.service not found`
**Причина:** `server/install.sh` не дошёл до конца.
**Решение:**
```bash
cd /opt && sudo bash /opt/domen-hydra/server/install.sh
```
### `нет IP и нет тоннеля` при обновлении роутеров
**Причина:** Роутер добавлен без IP и без настроенного туннеля.
**Решение:** Укажи IP роутера или настрой туннель (кнопка «⇄» напротив роутера).
### Туннель пишет «autossh не запустился в фоне»
```sh
# Проверь вручную на роутере:
/opt/bin/hydra_tun
# Если работает — перезагрузи роутер. Если нет — смотри лог:
cat /tmp/hydra_tun.log
```
### `neo restart` завершается с ошибкой
**Причина:** HydraRoute Neo не установлен. Проверь: `opkg list-installed | grep hydraroute`.
### Панель не открывается (`http://VPS:8000`)
```bash
cd /opt/domen-hydra && git pull && systemctl restart hydra-manager
sudo ufw allow 8000/tcp
```
### Кнопка «📋 Копировать» не срабатывает
Встроен fallback — текст выделяется автоматически. Нажми Cmd+C (Mac) или Ctrl+C (Windows/Linux).
---
## 7. Полезные советы
**Как зайти на роутер по SSH:**
```
Адрес: 192.168.1.1 Логин: root Пароль: keenetic Порт: 22
```
**Управление сервисом на VPS:**
```bash
sudo systemctl status hydra-manager
sudo systemctl restart hydra-manager
sudo journalctl -u hydra-manager -n 50
```
**Проверить активные туннели:**
```bash
ss -tlnp | grep 2010
```
**Прямые ссылки для роутера:**
```
http://VPS:8000/hydra/domain.conf
http://VPS:8000/hydra/ip.list
http://VPS:8000/hydra/version
```
---
## Поддержка проекта
## Связанные проекты
[Boosty — донат](https://boosty.to/andrey27/donate). На GitHub доступна кнопка **Sponsor** (`.github/FUNDING.yml`).
**Связь:** [Telegram @Iot_andrey](https://t.me/Iot_andrey) — вопросы и обратная связь.
---
## Связь с Keenetic Unified
Логика парсинга `domain.conf` / `ip.list` и веб-интерфейс доменов взяты из проекта [keenetic-unified](https://github.com/andrey271192/keenetic-unified) в урезанном виде: только управление HydraRoute, без дашборда, watchdog и Telegram.
- [keenetic-dns-routes](https://github.com/andrey271192/keenetic-dns-routes) — встроенная DNS-маршрутизация без Neo
- [keenetic-unified](https://github.com/andrey271192/keenetic-unified) — Neo + дашборд + мониторинг
- [Keenetic SSH](https://github.com/andrey271192/Keenetic_SSH) — прямой SSH (нужен белый IP)