update_0.2 #1

Merged
pyrschtjag merged 1 commits from update_0.2 into main 2026-02-18 01:37:25 +04:00
4 changed files with 125 additions and 148 deletions
+67 -57
View File
@@ -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>Если домен не в списке — пакет уходит через провайдера.
+17 -2
View File
@@ -1,3 +1,4 @@
config xray-manager 'main'
option table_name 'xray'
option tproxy_port '61219'
@@ -29,10 +30,24 @@ config xray-list 'lnet'
list ip '203.0.113.0/24'
config xray-list
option list 'exclude'
option name 'bf2'
option direction 'dst'
option exclude '0'
list domain 'bf2hub.com'
list ip '185.107.96.22'
config xray-list
option name 'proxyserver'
option direction 'dst'
option exclude '1'
list domain 'bf2hub.com'
list ip '178.173.249.148'
config xray-list
option name 'cloudflare'
option direction 'dst'
option exclude '0'
list ip '1.1.1.1'
list ip '1.0.0.1'
config xray-list
option name 'local'
Regular → Executable
+1
View File
@@ -7,6 +7,7 @@ extra_command "update" "Download and refresh remote lists"
start_service() {
xray-manager start
xray-manager update
procd_open_instance
procd_set_param command tail -f /dev/null
Regular → Executable
+40 -89
View File
@@ -3,9 +3,7 @@
. /lib/functions.sh
_log() {
local msg="$1"
local level="${2:-info}"
local to_console="${3:-0}"
local msg="$1" level="${2:-info}" to_console="${3:-0}"
logger -t xray-manager -p "daemon.$level" "$msg"
[ "$to_console" = "1" ] && echo "[$level] $msg"
}
@@ -15,20 +13,23 @@ _get_md5() { echo "$1" | md5sum | cut -d' ' -f1; }
_nft_init() {
[ -z "$TABLE" ] && return 1
nft add table ip "$TABLE" 2>/dev/null
nft add chain ip "$TABLE" prerouting { type filter hook prerouting priority mangle \; policy accept \; } 2>/dev/null
nft add chain ip "$TABLE" output { type route hook output priority mangle \; policy accept \; } 2>/dev/null
nft flush chain ip "$TABLE" prerouting
nft flush chain ip "$TABLE" output
nft add rule ip "$TABLE" prerouting fib daddr type local accept
[ -z "$TPROXY_MARK" ] && TPROXY_MARK="10"
local mark_hex=$(printf '0x%x' "$TPROXY_MARK")
ip route show table 110 | grep -q "local default" || ip route add local default dev lo table 110
ip rule show | grep -q "fwmark $mark_hex lookup 110" || ip rule add fwmark "$TPROXY_MARK" table 110
if [ "$ROUTE_LOCAL" = "1" ]; then
[ -z "$TPROXY_MARK" ] && TPROXY_MARK="10"
local mark_hex=$(printf '0x%x' "$TPROXY_MARK")
if ! ip route show table 110 | grep -q "local default"; then
ip route add local default dev lo table 110
fi
if ! ip rule show | grep -q "fwmark $mark_hex lookup 110"; then
ip rule add fwmark "$TPROXY_MARK" table 110
fi
nft add chain ip "$TABLE" output { type route hook output priority mangle \; policy accept \; } 2>/dev/null
nft flush chain ip "$TABLE" output
nft add rule ip "$TABLE" output fib daddr type local accept
else
nft delete chain ip "$TABLE" output 2>/dev/null || true
fi
}
@@ -36,6 +37,9 @@ _nft_apply_data() {
local sname="$1" file="$2" exc="$3" dir="$4" type="$5" changed="$6"
[ -z "$TABLE" ] && return 1
local has_output=0
nft list chain ip "$TABLE" output >/dev/null 2>&1 && has_output=1
local flags="interval"
[ "$type" = "dom" ] || [ "$type" = "udom" ] && flags="interval,timeout"
@@ -48,99 +52,60 @@ _nft_apply_data() {
fi
if [ "$exc" = "1" ]; then
local selector="ip daddr"
[ "$dir" = "src" ] && selector="ip saddr"
local selector="ip daddr"; [ "$dir" = "src" ] && selector="ip saddr"
nft insert rule ip "$TABLE" prerouting $selector "@$sname" accept
[ "$ROUTE_LOCAL" = "1" ] && nft insert rule ip "$TABLE" output $selector "@$sname" accept
[ "$has_output" = "1" ] && nft insert rule ip "$TABLE" output $selector "@$sname" accept
elif [ "$dir" = "src" ]; then
nft add rule ip "$TABLE" prerouting ip saddr "@$sname" ct mark set 0x66
[ "$ROUTE_LOCAL" = "1" ] && nft add rule ip "$TABLE" output ip saddr "@$sname" ct mark set 0x66
[ "$has_output" = "1" ] && nft add rule ip "$TABLE" output ip saddr "@$sname" ct mark set 0x66
else
for proto in tcp udp; do
nft add rule ip "$TABLE" prerouting ct mark 0x66 ip daddr "@$sname" meta l4proto $proto tproxy to 127.0.0.1:"$TPROXY_PORT" meta mark set "$TPROXY_MARK" accept
[ "$ROUTE_LOCAL" = "1" ] && nft add rule ip "$TABLE" output ct mark 0x66 ip daddr "@$sname" meta l4proto $proto meta mark set "$TPROXY_MARK" accept
[ "$has_output" = "1" ] && nft add rule ip "$TABLE" output ip daddr "@$sname" meta l4proto $proto ct mark set 0x66 meta mark set "$TPROXY_MARK" accept
done
fi
}
_process_item() {
local id="$1" val="$2" type="$3" dir="$4" exc="$5"
local fullpath hfile changed=0
local id="$1" val="$2" type="$3" dir="$4" exc="$5" fullpath hfile changed=0
[ -z "$DNSMASQ_DIR" ] || [ -z "$IPNET_DIR" ] && return 1
[ "$type" = "dom" ] || [ "$type" = "udom" ] && fullpath="$DNSMASQ_DIR/$id.lst" || fullpath="$IPNET_DIR/$id.lst"
hfile="$CACHE_DIR/$id.hash"
echo "$fullpath" >> "$ACTIVE_LIST"
echo "$hfile" >> "$ACTIVE_LIST"
# 1. Сначала считаем хэш текущего конфига
local new_hash=$(_get_md5 "$val")
local old_hash=$(cat "$hfile" 2>/dev/null)
# 2. ОДНА проверка для режима reload/start (SKIP_URL)
if [ "$SKIP_URL" = "1" ] && { [ "$type" = "uip" ] || [ "$type" = "udom" ]; }; then
# Проверяем, не изменился ли список ссылок в UCI
if [ "$new_hash" != "$old_hash" ]; then
_log "$id: Configuration changed (URLs modified). Please run 'update' to sync!" "warn" "1"
fi
if [ -f "$fullpath" ]; then
_nft_apply_data "$id" "$fullpath" "$exc" "$dir" "$type" "0"
return
else
_log "$id: File not found. Run 'update' to download." "warn" "1"
return
fi
[ "$new_hash" != "$old_hash" ] && _log "$id: Configuration changed. Run 'update' to sync!" "warn" "1"
[ -f "$fullpath" ] && { _nft_apply_data "$id" "$fullpath" "$exc" "$dir" "$type" "0"; return; }
_log "$id: File not found. Run 'update' to download." "warn" "1"; return
fi
# 3. Режим UPDATE (или обработка локальных списков)
if [ "$new_hash" != "$old_hash" ] || [ ! -f "$fullpath" ]; then
changed=1
case "$type" in
ip)
echo "$val" | tr ' ' '\n' | sed 's/\r//g; /^#/d; /^[[:space:]]*$/d; /\//! s|$|/32|' | sort -u > "$fullpath"
;;
ip) echo "$val" | tr ' ' '\n' | sed 's/\r//g; /^#/d; /^[[:space:]]*$/d; /\//! s|$|/32|' | sort -u > "$fullpath" ;;
dom)
echo "$val" | tr ' ' '\n' | tr '[:upper:]' '[:lower:]' | grep -oE '([a-z0-9-]+\.)+[a-z]{2,}' | sort -u | \
sed "s|^|nftset=/|; s|\$|/4#ip#$TABLE#$id|" > "$fullpath"
DNS_CHANGES=1 ;;
uip|udom)
_log "Processing $id (multiple URLs)..." "info"
local tmp_all="/tmp/dl_all_$id"
: > "$tmp_all"
_log "Processing $id..." "info"
local tmp_all="/tmp/dl_all_$id"; : > "$tmp_all"
for url in $val; do
local tmp_part="/tmp/dl_part"
_log "Downloading part from $url" "info"
if curl -sSfL --connect-timeout 10 "$url" -o "$tmp_part"; then
cat "$tmp_part" >> "$tmp_all"
echo "" >> "$tmp_all"
rm -f "$tmp_part"
else
_log "Failed to download: $url" "err" "1"
fi
curl -sSfL --connect-timeout 10 "$url" -o "$tmp_part" && { cat "$tmp_part" >> "$tmp_all"; echo "" >> "$tmp_all"; rm -f "$tmp_part"; }
done
if [ -s "$tmp_all" ]; then
local out="/tmp/out_$id"
if [ "$type" = "uip" ]; then
sed 's/\r//g; /^#/d; /^[[:space:]]*$/d; /\//! s|$|/32|' "$tmp_all" | sort -u > "$out"
else
tr '[:upper:]' '[:lower:]' < "$tmp_all" | grep -oE '([a-z0-9-]+\.)+[a-z]{2,}' | sort -u | \
sed "s|^|nftset=/|; s|\$|/4#ip#$TABLE#$id|" > "$out"
DNS_CHANGES=1
fi
mv "$out" "$fullpath"
rm -f "$tmp_all"
changed=1
else
_log "All downloads for $id failed" "err" "1"
rm -f "$tmp_all"
return
fi
;;
[ "$type" = "uip" ] && sed 's/\r//g; /^#/d; /^[[:space:]]*$/d; /\//! s|$|/32|' "$tmp_all" | sort -u > "$out" || \
{ tr '[:upper:]' '[:lower:]' < "$tmp_all" | grep -oE '([a-z0-9-]+\.)+[a-z]{2,}' | sort -u | sed "s|^|nftset=/|; s|\$|/4#ip#$TABLE#$id|" > "$out"; DNS_CHANGES=1; }
mv "$out" "$fullpath"; rm -f "$tmp_all"; changed=1
fi ;;
esac
echo "$new_hash" > "$hfile"
fi
@@ -148,12 +113,9 @@ _process_item() {
}
_process_section() {
local s="$1" name dir exc
config_get name "$s" name
config_get dir "$s" direction "dst"
config_get exc "$s" exclude "0"
local s="$1" name dir exc ips doms uips udoms
config_get name "$s" name; config_get dir "$s" direction "dst"; config_get exc "$s" exclude "0"
[ -z "$name" ] && return
local ips doms uips udoms
_append_list() { CURRENT_VAL="${CURRENT_VAL}${CURRENT_VAL:+ }$1"; }
CURRENT_VAL=""; config_list_foreach "$s" ip _append_list; ips="$CURRENT_VAL"
CURRENT_VAL=""; config_list_foreach "$s" domain _append_list; doms="$CURRENT_VAL"
@@ -171,9 +133,8 @@ _cleanup_orphans() {
[ -e "$f" ] || continue
if ! grep -Fxq "$f" "$ACTIVE_LIST" 2>/dev/null; then
local base="${f##*/}"
_log "Removing orphan: $base" "info"
[ "$(dirname "$f")" = "$DNSMASQ_DIR" ] && DNS_CHANGES=1
rm -f "$f" "$CACHE_DIR/${base%.*}.hash" "$CACHE_DIR/${base%.*}.tstamp"
rm -f "$f" "$CACHE_DIR/${base%.*}.hash"
fi
done
rm -f "$ACTIVE_LIST"
@@ -186,30 +147,21 @@ _load_config() {
TPROXY_MARK=$(uci -q get xray-manager.@xray-manager[0].tproxy_mark)
IPNET_DIR=$(uci -q get xray-manager.@xray-manager[0].ipnet_dir)
DNSMASQ_DIR=$(uci -q get xray-manager.@xray-manager[0].dnsmasq_dir)
CACHE_DIR="/tmp/xray-manager.cache"
ACTIVE_LIST="/tmp/xray_active_files"
CACHE_DIR="/tmp/xray-manager.cache"; ACTIVE_LIST="/tmp/xray_active_files"
ROUTE_LOCAL=$(uci -q get xray-manager.@xray-manager[0].route_local)
[ -z "$IPNET_DIR" ] || [ -z "$DNSMASQ_DIR" ] && return 1
mkdir -p "$IPNET_DIR" "$DNSMASQ_DIR" "$CACHE_DIR"
if ! uci show dhcp.@dnsmasq[0].confdir 2>/dev/null | grep -q "'$DNSMASQ_DIR'"; then
uci add_list dhcp.@dnsmasq[0].confdir="$DNSMASQ_DIR"
uci commit dhcp
DNS_CHANGES=1
uci add_list dhcp.@dnsmasq[0].confdir="$DNSMASQ_DIR"; uci commit dhcp; DNS_CHANGES=1
fi
}
_run() {
DNS_CHANGES=0
_load_config || return 1
: > "$ACTIVE_LIST"
_nft_init || return 1
DNS_CHANGES=0; _load_config || return 1; : > "$ACTIVE_LIST"; _nft_init || return 1
local lnet_val=$(uci -q get xray-manager.@lnet[0].ip)
[ -n "$lnet_val" ] && _process_item "lnet" "$lnet_val" "ip" "dst" "1"
config_foreach _process_section "xray-list"
_cleanup_orphans
if [ "$DNS_CHANGES" = "1" ]; then
/etc/init.d/dnsmasq restart
fi
[ "$DNS_CHANGES" = "1" ] && /etc/init.d/dnsmasq restart
}
_stop() {
@@ -218,7 +170,6 @@ _stop() {
ip rule del fwmark "$TPROXY_MARK" table 110 2>/dev/null
ip route del local default dev lo table 110 2>/dev/null
rm -rf "$IPNET_DIR"/* "$DNSMASQ_DIR"/* "$CACHE_DIR"/*
_log "Xray-manager stopped." "info" "1"
/etc/init.d/dnsmasq restart
}