Skip to content

E
etersoft-admin-essentials
Commit a34e70af authored by Vitaly Lipatov's avatar Vitaly Lipatov
Browse files
Options

router/docs: update docs for options, table resolution and zero-downtime reload

Co-Authored-By: 's avatarClaude Opus 4.6 <noreply@anthropic.com>
parent 6db5739f
Hide whitespace changes
Inline Side-by-side
Showing with 56 additions and 33 deletions
router/docs/egw-ogw-gateways.md
View file @ a34e70af
......@@ -140,7 +140,7 @@ graph LR
**igw** (CT 516): default via 91.232.225.1 (провайдер). Распределяет трафик по туннелям через policy routing (ip rule + таблицы dgw/ogw/egw).
**egw** (CT 528): default via 91.232.225.122 (gre.hetzner.egw). Весь трафик идёт через GRE-туннель на hetzner. Конфиг: `/etc/systemd/network/eth0.network`.
**egw** (CT 528): default via 91.232.225.122 (gre.hetzner.egw). Весь трафик идёт через GRE-туннель на hetzner. Default route управляется через `route-update.sh` (опция `set-default` в `routes.d/dgw/options`).
**egw-контейнеры:** default route через туннель (gre1/tun0/xray0/vpns) → VDS → интернет.
......
router/route-update.md
View file @ a34e70af
......@@ -11,55 +11,58 @@
```
routes.d/ # IPv4
├── dgw/ # группа "dgw" (direct, через дефолтный шлюз)
│ ├── gateway # default
│ ├── table # 2
│ ├── gateway # 91.232.225.122 (или default)
│ ├── options # set-default (опционально)
│ └── dgw.list -> /root/egw-route/dgw.list
│
├── egw/ # группа "egw"
│ ├── gateway # 91.232.225.112
│ ├── table # 112
│ └── egw.list -> /root/egw-route/egw.list
│
├── ogw/ # группа "ogw"
│ ├── gateway # 91.232.225.12
│ ├── table # 12
│ ├── ogw.list -> /root/egw-route/ogw.list
│ ├── youtube.list -> /root/egw-route/youtube.list
│ └── antifilter-*.list -> /root/antifilter/...
│
routes6.d/ # IPv6
├── dgw/ # direct, через дефолтный IPv6 шлюз
│ ├── gateway # default
│ ├── table # 2
│ ├── gateway # 2a03:5a00:c:20::122 (или default)
│ ├── options # set-default (опционально)
│ └── dgw.list -> /root/egw-route/dgw.list
│
├── egw/ # обход блокировок через GRE-туннель
│ ├── gateway # 2a03:5a00:c:20::122
│ ├── table # 201
│ ├── egw.list -> /root/egw-route/egw.list
│ ├── ogw.list -> /root/egw-route/ogw.list
│ └── ai.list, discord.list, fakenews.list
│
└── gre/ # трафик через GRE (Telegram, YouTube, ...)
├── gateway # 2a03:5a00:c:20::122
├── table # 222
├── youtube.list -> /root/egw-route/youtube.list
├── telegram.list -> /root/egw-route/telegram.list
└── whatsapp.list -> /root/egw-route/whatsapp.list
```
Файл `table` больше не нужен — номер таблицы определяется автоматически:
1. Из `/etc/iproute2/rt_tables` по имени каталога
2. Из последнего октета IP шлюза (автоматически регистрируется в rt_tables)
Каталоги `routes.d/`, `routes6.d/` и `.state/` — site-specific, не хранятся в git.
При запуске скрипт:
1. Для каждой группы читает `gateway` и `table`
1. Для каждой группы читает `gateway` и определяет номер таблицы
2. Собирает все `.list` файлы (следуя симлинкам)
3. Проверяет изменения (MD5 хэш содержимого)
3. Проверяет изменения (MD5 хэш содержимого); при изменении только gateway — переиспользует cached resolved IPs
4. Файлы с IP/подсетями — пропускает напрямую (IPv4-адреса фильтруются в IPv6 режиме)
5. Файлы с доменами — резолвит через `adnshost` (bulk async) + `dig` (fallback)
6. Сравнивает resolved IPs с предыдущими
7. Загружает маршруты через `ip -batch`
8. Создаёт `ip rule` для таблицы
9. Если ip rules/routes потеряны (перезагрузка сети), автоматически восстанавливает
7. Загружает маршруты через `ip -batch` (zero-downtime: replace + удаление stale, без flush)
8. Проверяет количество маршрутов в таблице
9. Создаёт `ip rule` для таблицы
10. Если `set-default` в `options` — устанавливает системный default route через gateway
11. Если ip rules/routes потеряны (перезагрузка сети), автоматически восстанавливает
12. При изменении номера таблицы в rt_tables — очищает старую и перезагружает в новую
## IPv6 поддержка
......@@ -159,17 +162,21 @@ default
91.232.225.112
```
### table
Номер таблицы маршрутизации:
```
12
```
### table (legacy)
Файл `table` больше не требуется. Номер таблицы определяется автоматически:
1. Из файла `table` (обратная совместимость)
2. Из `/etc/iproute2/rt_tables` по имени каталога группы
3. Из последнего октета IP шлюза (91.232.225.**122** → 122); при этом запись автоматически добавляется в rt_tables
Приоритет `ip rule` = table × 10 (table 12 → pref 120).
Таблицы IPv4 и IPv6 с одинаковым номером — независимы в ядре.
Имена таблиц определяются в `/etc/iproute2/rt_tables`.
### options
Опциональный файл с флагами, по одному на строку:
- `set-default` — помимо загрузки маршрутов в таблицу, также устанавливает системный default route через gateway группы. Полезно для управления дефолтом через route-update.sh/route-health.sh.
### .list файлы
Симлинки на файлы со списками. Формат списка:
- Домены: `example.com` — будут зарезолвлены (A для IPv4, AAAA для IPv6)
......@@ -217,28 +224,35 @@ default
## Обнаружение изменений
Двухуровневое:
Многоуровневое:
1. **Хэш файлов** — MD5 содержимого всех .list файлов + gateway + table.
1. **Хэш файлов** — MD5 содержимого всех .list файлов + gateway + options.
Если не изменился — группа пропускается (быстрый путь).
2. **Diff resolved IPs** — после резолва сравниваются IP с предыдущим запуском.
2. **Хэш списков** — отдельный MD5 только .list файлов. Если изменились только
gateway/options, а списки те же — переиспользуются cached resolved IPs без резолва.
3. **Diff resolved IPs** — после резолва сравниваются IP с предыдущим запуском.
Если DNS вернул те же адреса — маршруты не трогаются, обновляется только хэш.
3. **Проверка ip rules/routes** — даже при совпадении хэшей скрипт проверяет,
4. **Проверка ip rules/routes** — даже при совпадении хэшей скрипт проверяет,
что ip rule и маршруты в таблице существуют. Если потеряны (перезагрузка
сети, `networkctl reconfigure`), автоматически перезагружает группу.
Частичная потеря маршрутов тоже обнаруживается: если количество маршрутов
в таблице упало более чем на 1% от ожидаемого, группа перезагружается.
5. **Смена номера таблицы** — если номер в rt_tables изменился, старая таблица
очищается и маршруты загружаются в новую.
| Событие | Что происходит |
|---|---|
| Файл .list изменился | Хэш меняется → резолв + проверка |
| Файл .list изменился | Хэш меняется → резолв + reload |
| Симлинк добавлен/убран | Хэш меняется → пересборка |
| Gateway изменился | Хэш меняется → перезагрузка маршрутов |
| Gateway изменился | Хэш меняется → reuse resolved IPs, reload маршрутов |
| DNS вернул те же IP | Маршруты не перезагружаются |
| ip rules/routes потеряны | Автоматическая перезагрузка |
| Маршруты частично потеряны (>1%) | Автоматическая перезагрузка |
| Номер таблицы изменился в rt_tables | Flush старой, reload в новую |
| Все .list убраны из группы | Таблица очищается |
| Каталог группы удалён | Cleanup находит осиротевший state → flush |
......@@ -310,10 +324,11 @@ ip -6 rule show (IPv6):
.state/
├── routes.d/
│ ├── egw/
│ │ ├── hash # MD5 содержимого .list + gateway + table
│ │ ├── table # номер таблицы (для cleanup)
│ │ ├── gateway # копия gateway (для обнаружения смены шлюза)
│ │ └── resolved # sorted список IP после резолва
│ │ ├── hash # MD5 содержимого .list + gateway + options
│ │ ├── lists_hash # MD5 только .list файлов (для skip resolve)
│ │ ├── table # номер таблицы (для обнаружения смены)
│ │ ├── gateway # копия gateway (для обнаружения смены шлюза)
│ │ └── resolved # sorted список IP после резолва
│ └── ogw/
│ └── ...
└── routes6.d/
......@@ -325,8 +340,8 @@ ip -6 rule show (IPv6):
### Новая группа
```bash
mkdir routes.d/mygroup
echo '10.0.0.1' > routes.d/mygroup/gateway
echo '50' > routes.d/mygroup/table
echo '91.232.225.50' > routes.d/mygroup/gateway
# table = 50 (из последнего октета, авто-регистрация в rt_tables)
ln -s /path/to/domains.list routes.d/mygroup/domains.list
./route-update.sh
```
......@@ -334,12 +349,20 @@ ln -s /path/to/domains.list routes.d/mygroup/domains.list
### Новая IPv6 группа
```bash
mkdir routes6.d/mygroup
echo '2a03:5a00:c:20::1' > routes6.d/mygroup/gateway
echo '50' > routes6.d/mygroup/table
echo '2a03:5a00:c:20::50' > routes6.d/mygroup/gateway
ln -s /path/to/domains.list routes6.d/mygroup/domains.list
./route-update.sh
```
### Группа с управлением дефолтом
```bash
mkdir routes.d/dgw
echo '91.232.225.122' > routes.d/dgw/gateway
echo 'set-default' > routes.d/dgw/options
ln -s /path/to/direct.list routes.d/dgw/dgw.list
./route-update.sh # установит default route via 91.232.225.122
```
### Добавить список в существующую группу
```bash
ln -s /root/egw-route/newlist.list routes.d/ogw/newlist.list
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment