update_0.2

2026-02-18 01:36:35 +04:00
parent 03b0fa3241
commit d30dcaa2ed
4 changed files with 125 additions and 148 deletions
@@ -28,7 +28,7 @@ opkg install dnsmasq-full
 ```
 ### 2. Клонирование репозитория

-Рекомендуется устанавливать в папку /opt:
+Рекомендуется устанавливать в директорию `/opt/.xray-manager`:
 ```bash
 git clone gitea@gitea.lan:pyrschtjag/xray-manager.git /opt/.xray-manager
 ```
@@ -48,38 +48,54 @@ ln -s /opt/.xray-manager/init.d/xray-manager /etc/init.d/xray-manager
 ln -s /opt/.xray-manager/xray-manager.sh /usr/sbin/xray-manager
 ```

-## Использование
+## Команды управления

-Скрипт поддерживает стандартные команды OpenWrt:
+Скрипт интегрирован в систему и поддерживает стандартные методы управления OpenWrt. Основное различие между командами заключается в работе с сетью и кэшем.

-* **xray-manager start** — Инициализация таблиц и применение текущих списков из кэша.
-* **xray-manager reload** — Применение изменений из конфига без скачивания URL. Если ссылки изменились, скрипт выведет предупреждение.
-* **xray-manager update** — Скачивание всех внешних списков, дедупликация и обновление правил.
-* **xray-manager stop** — Полная очистка таблиц nftables и удаление временных файлов.
-* **xray-manager restart** — Остановка и повторный запуск.
+* **/etc/init.d/xray-manager start** — **Холодный запуск** <br> Полная инициализация системы: создание таблиц nftables, цепочек и правил. При первом запуске скрипт автоматически скачает все списки из URL. Если списки уже есть в кэше — применит их.
+
+* **/etc/init.d/xray-manager reload** — **Локальное обновление** <br> Применяет изменения, внесенные в конфигурационный файл /etc/config/xray-manager (например, изменение портов или добавление новых секций), но не обращается к сети. Если вы изменили URL в конфиге, скрипт выдаст предупреждение о необходимости запуска update.
+
+* **/etc/init.d/xray-manager update** — **Умная синхронизация** <br> Скрипт опрашивает все внешние URL. Благодаря системе хеширования (Hashing), загрузка и пересборка правил произойдет только для тех списков, которые реально изменились на удаленном сервере. Это экономит трафик и минимизирует нагрузку на процессор роутера.
+
+* **/etc/init.d/xray-manager stop** — **Полная очистка** <br> Удаляет все таблицы и цепочки из nftables, очищает временные файлы и возвращает маршрутизацию в исходное состояние. Полезно для диагностики или временного отключения проксирования.
+
+* **/etc/init.d/xray-manager restart** — **Перезапуск** <br> Последовательное выполнение команд stop и start.

 ## Конфигурация

-### Глобальные параметры
+### Глобальные параметры (`section main`)

-Секция config xray-manager 'main' (обязательна):
+| Параметр | Тип | По умолчанию | Описание |
+| :--- | :--- | :--- | :--- |
+| **table_name** | `string` | `xray` | Имя основной таблицы в `nftables`. |
+| **tproxy_port** | `int` | `61219` | Порт, на котором Xray/Sing-box слушает TProxy входящие соединения. |
+| **tproxy_mark** | `int` | `10` | Метка (`fwmark`), используемая для маршрутизации пакетов в таблицу 110. |
+| **timeout** | `string` | `1h` | Время жизни динамических записей в сетах (для доменов). |
+| **ipnet_dir** | `string` | `/tmp/ipnet` | Директория для хранения списков IP-адресов в формате `.lst`. |
+| **dnsmasq_dir** | `string` | `/tmp/dnsmasq.d` | Директория для `.conf` файлов dnsmasq (автоматически добавляется в `confdir` по пути `/etc/config/dhcp`). |
+| **cache_dir** | `string` | `/tmp/.xray-manager/cache` | Место хранения хэш-файлов для отслеживания изменений в списках. |
+| **active_list** | `string` | `/tmp/.xray-manager/active_files` | Файл-индекс для автоматической очистки «осиротевших» (удаленных) списков. |
+| **route_local** | `bool` | `0` | `1` — перехватывать и проксировать трафик самого роутера; <br> `0` — только трафик клиентов. |
+
+ Пример:

 ```bash
 config xray-manager 'main'
-    option table_name 'xray'       # Имя таблицы в nftables
-    option tproxy_port '61219'    # Порт Xray (TProxy)
-    option tproxy_mark '10'       # fwmark для трафика
-    option timeout '1h'           # Время жизни (для nftables set)
-    option ipnet_dir '/tmp/ipnet' # Путь к спискам IP
-    option dnsmasq_dir '/tmp/dnsmasq.d' # Путь к конфигам dnsmasq
+    option table_name 'xray'
+    option tproxy_port '61219'
+    option tproxy_mark '10'
+    option timeout '1h'
+    option ipnet_dir '/tmp/ipnet'
+    option dnsmasq_dir '/tmp/dnsmasq.d'
    option cache_dir '/tmp/.xray-manager/cache'
    option active_list '/tmp/.xray-manager/active_files'
-    option route_local '1'        # Проксировать трафик самого роутера
+    option route_local '1'
 ```

 ### Исключения (Whitelist)

-Секция lnet для защиты локальных адресов. Требуется для подстраховки, так как некоторые ресурсы могут подменять реальный IP на localhost при резолвинге:
+Секция `lnet` для защиты локальных адресов. Требуется для подстраховки, так как некоторые ресурсы могут подменять реальный IP на localhost при резолвинге:

 ```bash
 config xray-list 'lnet'
@@ -97,61 +113,55 @@ config xray-list 'lnet'
    list ip '0.0.0.0/8'
 ```

-### Списки маршрутов
+### Списки маршрутов (List)

 Каждая секция `config xray-list` определяет, какой именно трафик будет перехвачен или пропущен.

 | Параметр | Значение | Описание |
 | :--- | :--- | :--- |
 | **name** | `string` | Уникальное имя. Используется для названия сета в `nftables` (например, `@v2ray_udom`) и имени файла в `/tmp`. |
-| **direction** | `dst` или `src` | **Направление фильтрации**. <br> `dst`: проверка IP назначения (куда идем). <br> `src`: проверка IP отправителя (кто идет). |
-| **exclude** | `0` или `1` | **Тип правила**. <br> `0`: Направлять трафик в прокси. <br> `1`: Пропускать трафик напрямую (исключение). |
-
-### Типы списков (list)
+| **direction** | `dst` или `src` | **Направление фильтрации**: <br> `dst`: проверка IP назначения (куда идём). <br> `src`: проверка IP отправителя (кто идёт). |
+| **exclude** | `0` или `1` | **Тип правила**: <br> `0`: Направлять трафик в прокси. <br> `1`: Пропускать трафик напрямую (исключение). |

 Внутри каждой секции можно комбинировать разные типы данных:

-* **list ip**: Одиночный IP-адрес или подсеть в формате CIDR (например, `1.1.1.1` или `192.168.1.0/24`). Заносится напрямую в `nftables`.
-* **list domain**: Одиночный домен. Скрипт создаст файл конфигурации для `dnsmasq`, который будет перехватывать IP-адреса этого домена при резолвинге и динамически добавлять их в соответствующий сет `nftables`.
-* **list url_ip**: Ссылка на внешний текстовый файл со списком IP/подсетей. Скрипт скачает, очистит от комментариев и объединит данные.
-* **list url_domain**: Ссылка на список доменов. Аналогично `url_ip`, но данные готовятся для обработки через `dnsmasq`.
+| Тип записи | Формат | Описание |
+| :--- | :--- | :--- |
+| **list ip** | `1.1.1.1` или `CIDR` | Статический IP или подсеть. Заносится напрямую в `nftables`. |
+| **list domain** | `example.com` | Домен. Создает правило dnsmasq для динамического добавления IP в сет. |
+| **list url_ip** | `http(s)://...` | Ссылка на сырой текстовый файл с IP. Скрипт скачает и объединит данные. |
+| **list url_domain** | `http(s)://...` | Ссылка на сырой текстовый файл с доменами. Готовит данные для dnsmasq. |

-#### Пример 1: Направление доменов в прокси (назначение):
+### Практический пример по выборочной маршрутизации

-```bash
+**Задача**: Направить трафик конкретного устройства (10.1.0.2) через прокси только при обращении к ресурсам Spotify, не затрагивая остальных клиентов сети.
+
+#### Шаг 1: Определение источника (src)
+
+Сначала мы указываем «доверенную» группу устройств, которым разрешен доступ к проксированию. Для этого создается секция с типом фильтрации по источнику:
+
+```Bash
 config xray-list
-    option name 'v2ray'
-    option direction 'dst'
-    option exclude '0'
-    list url_domain '[https://raw.githubusercontent.com/.../spotify](https://raw.githubusercontent.com/.../spotify)'
-    list url_domain '[https://raw.githubusercontent.com/.../openai](https://raw.githubusercontent.com/.../openai)'
-    list domain 'private.example.com'
+    option name 'my_pc'      # Уникальное имя группы
+    option direction 'src'   # Фильтр отправителя (Source)
+    option exclude '0'       # Направлять в прокси
+    list ip '10.1.0.2'       # IP адрес вашего устройства
 ```

-#### Пример 2: Направление целой подсети локальных клиентов в прокси (источник):
+#### Шаг 2: Определение назначения (dst)

+Затем мы загружаем список ресурсов, которые должны перехватываться. В данном случае используем домены Spotify из внешнего репозитория:

-```bash
+```Bash
 config xray-list
-    option name 'local_network'
-    option direction 'src'
-    option exclude '0'
-    list ip '10.1.0.0/24'
+    option name 'spotify'
+    option direction 'dst'   # Фильтр назначения (Destination)
+    option exclude '0'       # Направлять в прокси
+    list url_domain 'https://raw.githubusercontent.com/v2ray/domain-list-community/master/data/spotify'
 ```

-#### Пример 3: Исключение конкретного устройства из проксирования:
-```bash
-config xray-list
-    option name 'my_pc_bypass'
-    option direction 'src'
-    option exclude '1'
-    list ip '10.1.0.6'
-```
-
-## Логика работы (Flow)
-
-1.  **Цепочка Prerouting**: Весь входящий трафик от клиентов попадает в таблицу `nftables`.
-2.  **Исключения (Exclude 1)**: Сначала проверяются списки с `exclude '1'`. Если совпадение найдено, пакет помечается `accept` и уходит по обычному маршруту.
-3.  **Маркировка (Direction src)**: Если IP клиента найден в списке с `direction 'src'`, пакет помечается меткой `0x66`.
-4.  **Перехват (Direction dst)**: Для пакетов с меткой `0x66` проверяются списки назначений (`dst`). Если финальный IP найден в сете — пакет перенаправляется на локальный порт TProxy.
-5.  **DNS-фильтрация**: При запросе домена из списка `domain`/`url_domain`, `dnsmasq` сохраняет полученный IP в сет `nftables` на время, указанное в `option timeout`.
+Как это работает (Логика связки):
+1. Пакет приходит на роутер с IP 10.1.0.2.
+2. Скрипт видит совпадение в секции src и ставит пакету внутреннюю метку (mark).
+3. Далее роутер проверяет адрес назначения этого помеченного пакета.
+4. Если домен соответствует списку spotify, пакет перенаправляется в TProxy. <br>Если домен не в списке — пакет уходит через провайдера.