Add multi-WAN failover and release v112

This commit is contained in:
kzolotarev95 committed 2026-10-09 08:45:30 +04:00
1 parent 50a18ae33c
commit bcbcb071cc
23 files changed
+910 -76

No files matched your search

+14 -11
View File
@@ -1,4 +1,4 @@
# Фиксация VPS host и независимое соединение Remote через WAN (v111)
# Фиксация VPS host и независимое соединение Remote через WAN (v112)
`vps_host_mode=manual` сохраняет заданный на роутере адрес. Это значение
используется и когда опция отсутствует у старой установки. Только явно
@@ -24,7 +24,10 @@ OpenWrt config / автоматическое переприменение ко
опция выключена в поставляемой конфигурации и старых установках. Скрипт
локальной установки ниже включает её для тестирования на вашем роутере.
* `wan_interface=wan` — логическое имя интерфейса OpenWrt. Реальный
* `wan_interface=wan` — логическое имя интерфейса OpenWrt. Для резервирования
допустим список через пробел, например `wan wwan modem4g`; в панели эти
интерфейсы выбираются галочками. Remote выбирает один рабочий и при
его отключении переводит соединение на другой выбранный. Реальный
`l3_device` (включая PPPoE) берётся через ubus. Он должен иметь физический
default route в main; TUN-устройства не принимаются как WAN.
* Таблица маршрутов `210` и приоритет `104` принадлежат Remote.
@@ -93,21 +96,21 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.
Установка загружает локальные файлы, без Git. До остановки службы проверяются
доступность WAN и поддержка таблицы реальной командой ip на роутере.
На роутер загружается и файл LuCI: версия v111 появляется и в основной
На роутер загружается и файл LuCI: версия v112 появляется и в основной
CGI-панели, и в странице входа в неё через LuCI.
Сначала сохраняются файлы
и конфигурация; после замены проверяется heartbeat/health. При ошибке
автоматически восстанавливается состояние перед текущей попыткой.
Сохранённая резервная копия для ручного отката не перезаписывается.
* Роутер: `/root/owrt-remote-backup-before-host-policy-v111` — агент,
* Роутер: `/root/owrt-remote-backup-before-host-policy-v112` — агент,
helper, init, CGI, UCI-конфигурация и Xray-конфиг (в закрытом каталоге).
* VPS: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-host-policy-v111`.
* VPS: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-host-policy-v112`.
База роутеров и настройки авторизации не заменяются.
Успешная установка заканчивается `HOST_POLICY_ROUTER_V111_OK` на роутере
и `HOST_POLICY_VPS_V111_Install_OK` на VPS. Старые резервные копии предыдущей
версии сохраняются; новые команды отката используют отдельные копии для v111.
Успешная установка заканчивается `HOST_POLICY_ROUTER_V112_OK` на роутере
и `HOST_POLICY_VPS_V112_Install_OK` на VPS. Старые резервные копии предыдущей
версии сохраняются; новые команды отката используют отдельные копии для v112.
### Переход с nftables-маркировки на адресную маршрутизацию
@@ -116,11 +119,11 @@ CGI-панели, и в странице входа в неё через LuCI.
Обновление VPS для этого изменения не требуется.
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.ps1" -Target Router -Machine "root@192.168.2.1" -PreserveConnectionSettings -BackupName "podkop-compat-v111" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.ps1" -Target Router -Machine "root@192.168.2.1" -BackupName "podkop-compat-v111" -Action Rollback
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.ps1" -Target Router -Machine "root@192.168.2.1" -PreserveConnectionSettings -BackupName "podkop-compat-v112" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.ps1" -Target Router -Machine "root@192.168.2.1" -BackupName "podkop-compat-v112" -Action Rollback
```
Копия: `/root/owrt-remote-backup-before-podkop-compat-v111`.
Копия: `/root/owrt-remote-backup-before-podkop-compat-v112`.
После установки повторите диагностику Podkop. Предупреждение от прежних правил
Remote должно исчезнуть. Настоящие дополнительные правила других приложений
по-прежнему обнаруживаются штатной диагностикой.
+3 -3
View File
@@ -1,4 +1,4 @@
# reCAPTCHA v3 в OpenWrt Remote Hub v111
# reCAPTCHA v3 в OpenWrt Remote Hub v112
В меню владельца, в блоке «Капча на экране входа», доступны цифры,
Google reCAPTCHA v2 Checkbox и Google reCAPTCHA v3. Установка обновления
@@ -74,8 +74,8 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-recaptcha-v3
непосредственно перед попыткой. Резервные копии при повторном запуске
не перезаписываются:
* `/opt/owrt-remote/owrt-remote-hub.py.bak-before-recaptcha-v3-v111`
* `/opt/owrt-remote/captcha-before-recaptcha-v3-v111.json` (режим 0600).
* `/opt/owrt-remote/owrt-remote-hub.py.bak-before-recaptcha-v3-v112`
* `/opt/owrt-remote/captcha-before-recaptcha-v3-v112.json` (режим 0600).
Скрипт рассчитан на стандартные пути установленного Hub:
`/opt/owrt-remote/owrt-remote-hub.py`, `/var/lib/owrt-remote/hub-auth.json`
+3 -3
View File
@@ -1,6 +1,6 @@
# Аудит ресурсов OpenWrt Remote Hub v111
# Аудит ресурсов OpenWrt Remote Hub v112
Исправления внесены поверх `7f809fd`. Версия панели остаётся v111.
Исправления внесены поверх `7f809fd`. Версия панели остаётся v112.
## SQLite
@@ -115,7 +115,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-resource-fix
Установщик загружает локальный файл без Git, запускает изолированные тесты,
сохраняет исходный серверный файл:
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-resource-fix-v111`,
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-resource-fix-v112`,
атомарно заменяет Python файл, перезапускает `owrt-remote` и проверяет health.
Существующая резервная копия не перезаписывается. При ошибке установки
восстанавливается файл, работавший непосредственно перед текущей попыткой.
+4 -4
View File
@@ -1,4 +1,4 @@
# Виджеты ресурсов VPS (v111)
# Виджеты ресурсов VPS (v112)
Три карточки ЦП, ОЗУ и ДИСК находятся над кнопками «Рестарт Xray VPS»,
профилем и выходом. На ПК ширина и высота совпадают с кнопками под ними.
@@ -23,7 +23,7 @@ vCPU и объёмы занятой/общей памяти и диска.
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-vps-widgets.ps1" -Vps "root@193.233.82.38" -Action Install
```
После `VPS_WIDGETS_V111_Install_OK` обновите страницу через Ctrl+F5.
После `VPS_WIDGETS_V112_Install_OK` обновите страницу через Ctrl+F5.
Скрипт загружает локальный файл, проверяет его до замены, перезапускает
службу и проверяет health. При ошибке после замены восстанавливает файл
перед текущей попыткой. База данных и настройки не заменяются.
@@ -33,8 +33,8 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```
Откат использует неизменяемую копию первого состояния до установки:
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-vps-widgets-v111`.
Успешное завершение: `VPS_WIDGETS_V111_Rollback_OK`.
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-vps-widgets-v112`.
Успешное завершение: `VPS_WIDGETS_V112_Rollback_OK`.
## Локальные проверки
+81
View File
@@ -0,0 +1,81 @@
# Несколько WAN интерфейсов и резервирование (v112)
Кнопка **Выбрать интерфейсы** раскрывает список с галочками. Можно отметить
один, два, три и больше интерфейсов. Список содержит имена
логических интерфейсов OpenWrt. Он собирается при открытии страницы из
конфигурации `network` (UCI) и списка netifd (`ubus network.interface dump`).
Поэтому доступны и настроенные, но ещё отключённые 4G/Wi-Fi интерфейсы.
Повторяющиеся имена объединяются. Текущее значение остаётся выбранным,
даже если интерфейс временно пропал из списка; пустое старое значение
означает `wan`.
**Сохранить и запустить** сохраняет весь выбранный список в существующей
настройке `owrtremote.main.wan_interface`, например `wan wwan modem4g`.
Уже сохранённые интерфейсы идут первыми в списке, поэтому добавление
резервных сохраняет прежний основной выбор первым. При запуске берётся
первый доступный интерфейс из сохранённого списка.
Пустой список при включённом прямом WAN отклоняется до изменения настроек.
Старое одиночное значение продолжает работать.
Remote использует один доступный интерфейс из выбранных. Доступность
определяется по `l3_device` netifd и IPv4 default route этого устройства.
Если текущий интерфейс отключился, при следующем heartbeat или событии
hotplug выбирается резервный. DNS и отдельная таблица маршрутов Remote
переводятся на него. Изменение привязки работающего Xray вызывает один
перезапуск обратных туннелей: одного изменения маршрутов недостаточно,
поскольку [Xray sockopt.interface](https://xtls.github.io/en/config/transports/sockopt.html)
привязывает соединение к конкретному устройству.
Рабочий резерв сохраняется, когда другой выбранный интерфейс возвращается.
Это предотвращает повторные разрывы при нестабильном основном канале.
При ручном перезапуске проверяется доступность выбранных интерфейсов заново.
Если все выбранные интерфейсы отключены, прямое подключение завершается
ошибкой; невыбранные интерфейсы и TUN-прокси в качестве резерва не используются.
Это резервирование по состоянию интерфейса и маршрута, без проверки доступа
в Интернет на стороне провайдера при остающемся поднятым интерфейсе.
Сетевые интерфейсы эта форма не создаёт и не перенастраивает. Список содержит
все логические интерфейсы; наличие `lan` в списке не означает, что он подходит
для WAN. LAN, dnsmasq и конфигурация Podkop не изменяются.
Установка из PowerShell Windows 11 (при необходимости заменить IP):
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-wan-multi.ps1" -Router "root@192.168.2.1" -Action Install
```
Скрипт устанавливает CGI, LuCI, агент, WAN helper и hotplug вместе. До замены
сохраняются прежние файлы, UCI-настройки и Xray config в
`/root/owrt-remote-backup-before-wan-multi-v112`.
Успех подтверждает `WAN_MULTI_ROUTER_Install_OK`. После установки обновить
панель роутера через Ctrl+F5, отметить интерфейсы и сохранить выбор.
VPS обновлять не требуется. Старый `deploy-wan-interface-picker.ps1`
теперь вызывает эту же установку, чтобы новый интерфейс формы не
устанавливался отдельно от механизма резервирования.
Откат файлов и сохранённых перед установкой настроек:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-wan-multi.ps1" -Router "root@192.168.2.1" -Action Rollback
```
Успех отката подтверждает `WAN_MULTI_ROUTER_Rollback_OK`. Восстанавливаются
и настройки до установки, поэтому откат совместим с предыдущим агентом,
который поддерживал только одно имя WAN.
Локальные проверки:
```powershell
python tests/test_wan_interface_picker.py -v
python tests/test_wan_failover.py -v
python tests/test_xray_apply.py -v
```
Тесты выполняют настоящие CGI-запросы с подменёнными UCI/netifd и проверяют
список интерфейсов, сохранение нескольких выборов, недоступный uplink,
экранирование HTML и авторизацию. Тесты резервирования моделируют потерю
основного и двух первых каналов, выбор DNS резервного, маршруты, привязку
Xray и сохранение здорового резерва. PowerShell проверяется парсером и через `-PrepareOnly`;
это не выполняет SSH и не устанавливает файлы на устройство.
Источник API: [OpenWrt network.sh](https://git.openwrt.org/openwrt/openwrt/tree/?path=package%2Fbase-files%2Ffiles%2Flib%2Ffunctions%2Fnetwork.sh).
+2 -2
View File
@@ -1,4 +1,4 @@
# Применение OpenWrt config через панель роутера (v111)
# Применение OpenWrt config через панель роутера (v112)
При отправке textarea браузер кодирует переносы строк как CRLF. CGI
декодировал их без нормализации и записывал CR в исполняемый shell-скрипт.
@@ -22,7 +22,7 @@ CRLF и LF, heredoc, пустые строки, кодированные сим
Скрипт обновляет только CGI на роутере. VPS обновлять для этого фикса
не требуется. До замены сохраняется первая резервная копия CGI:
`/root/owrt-remote-backup-before-xray-apply-v111/owrt-remote`.
`/root/owrt-remote-backup-before-xray-apply-v112/owrt-remote`.
Из PowerShell Windows 11; замените IP, если адрес роутера отличается:
+1 -1
View File
@@ -131,7 +131,7 @@ class HubFixture:
assert "groups" in json.loads(self.request("/api/router-groups"))
assert "notifications" in json.loads(self.request("/api/notifications"))
assert self.request("/access/test-router/") == b"router proxy fixture"
assert b"v111" in self.request("/")
assert b"v112" in self.request("/")
self.app.snapshot_router_states()
def __exit__(self, *args):
+181
View File
@@ -0,0 +1,181 @@
"""Selected-uplink failover with mocked OpenWrt netifd and kernel routes."""
import json
import os
from pathlib import Path
import unittest
import test_host_policy as host_policy
SH = host_policy.SH
UPLINK_MOCKS = r'''
ubus() {
local iface up device dns
iface="${2#network.interface.}"
up=1; device=''; dns=''
case "$iface" in
wan) [ ! -e "$TEST_ROOT/wan-down" ] || up=0; device=eth0; dns=1.1.1.1 ;;
wwan) [ ! -e "$TEST_ROOT/wwan-down" ] || up=0; device=wlan1; dns=9.9.9.9 ;;
modem4g) [ ! -e "$TEST_ROOT/modem-down" ] || up=0; device=wwan0; dns=8.8.8.8 ;;
proxy) device=tun0; dns=127.0.0.1 ;;
*) return 1 ;;
esac
[ "$up" = 1 ] || device=''
printf '{"up":%s,"l3_device":"%s","dns-server":["%s"]}' "$up" "$device" "$dns"
}
jsonfilter() {
if [ "$1" = -i ]; then
"$TEST_PYTHON" "$TEST_ROOT/jsonfilter.py" "$2" "$4"
return
fi
"$TEST_PYTHON" "$TEST_ROOT/jsonfilter.py" - "$2"
}
ip() {
printf '%s\n' "$*" >>"$TEST_ROOT/ip"
case "$*" in
'-4 route show table main default dev eth0') [ -e "$TEST_ROOT/wan-down" ] || echo 'default via 192.0.2.1 dev eth0' ;;
'-4 route show table main default dev wlan1') [ -e "$TEST_ROOT/wwan-down" ] || echo 'default via 192.0.2.2 dev wlan1' ;;
'-4 route show table main default dev wwan0') [ -e "$TEST_ROOT/modem-down" ] || echo 'default dev wwan0' ;;
'-4 route show table main default dev tun0') echo 'default dev tun0' ;;
'-6 route show table main default dev '*) return 0 ;;
'-6 rule show') return 0 ;;
'-4 rule show') return 0 ;;
esac
return 0
}
'''
JSONFILTER = '''import json, re, sys
data = json.load(sys.stdin if sys.argv[1] == "-" else open(sys.argv[1]))
query = sys.argv[2]
if query == "@.l3_device":
value = data.get("l3_device", "")
elif query == '@["dns-server"][0]':
value = next(iter(data.get("dns-server", [])), "")
else:
tag = re.search(r'tag="([^"]+)"', query).group(1)
row = next((row for row in data.get("outbounds", []) if row.get("tag") == tag), {})
if query.endswith(".interface"):
value = row.get("streamSettings", {}).get("sockopt", {}).get("interface", "")
else:
value = row.get("settings", {}).get("address", "")
sys.stdout.buffer.write(str(value).encode())
'''
@unittest.skipUnless(SH, "A POSIX shell is required")
class WanFailoverTests(unittest.TestCase):
setUp = host_policy.RouterShellTests.setUp
config = host_policy.RouterShellTests.config
run_shell = host_policy.RouterShellTests.run_shell
def prepare(self, interfaces="wan wwan modem4g"):
self.config(wan_interface=interfaces, wan_direct="1", vps_host="192.0.2.10", vps_host_mode="manual",
hub_url="https://hub.example", hub_token="test-token", vless_uuid="test-uuid")
self.directory.joinpath("jsonfilter.py").write_text(JSONFILTER, encoding="utf-8")
def shell(self, commands):
return self.run_shell(UPLINK_MOCKS + "\n" + commands)
def test_down_primary_selects_wifi_and_uses_its_dns_and_routes(self):
self.prepare()
self.directory.joinpath("wan-down").touch()
result = self.shell('wan_prepare && printf "active=%s device=%s dns=%s" "$(cat "$WAN_STATE/active-interface")" "$(wan_device)" "$(wan_dns_server)"')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(result.stdout, "active=wwan device=wlan1 dns=9.9.9.9")
self.assertIn("via 192.0.2.2 dev wlan1 onlink table 210", self.directory.joinpath("ip").read_text())
def test_third_uplink_is_used_when_first_two_are_down(self):
self.prepare()
self.directory.joinpath("wan-down").touch()
self.directory.joinpath("wwan-down").touch()
result = self.shell('wan_prepare && printf "%s %s" "$(wan_device)" "$(wan_dns_server)"')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(result.stdout, "wwan0 8.8.8.8")
def test_healthy_backup_is_retained_when_primary_returns(self):
self.prepare()
result = self.shell('touch "$TEST_ROOT/wan-down"; wan_prepare || exit; rm "$TEST_ROOT/wan-down"; wan_prepare || exit; cat "$WAN_STATE/active-interface"')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(result.stdout.strip(), "wwan")
def test_failover_rebinds_rendered_reverse_connections_and_heartbeat(self):
self.prepare()
result = self.shell('wan_prepare || exit; touch "$TEST_ROOT/wan-down"; render_client_config --stdout')
self.assertEqual(result.returncode, 0, result.stderr)
config = json.loads(result.stdout)
for outbound in config["outbounds"]:
if outbound["tag"].startswith("vps-"):
self.assertEqual(outbound["streamSettings"]["sockopt"]["interface"], "wlan1")
else:
self.assertNotIn("streamSettings", outbound)
result = self.shell('wan_post_json https://hub.example/api/heartbeat test-token "$TEST_ROOT/payload"')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertIn("<wlan1>", self.directory.joinpath("curl").read_text())
self.assertIn("WAN failover: wan -> wwan", self.directory.joinpath("log").read_text())
def test_only_selected_real_uplinks_are_used_and_all_down_fails(self):
self.prepare("proxy wan")
result = self.shell('printf "%s" "$(wan_select_interface)"')
self.assertEqual(result.stdout, "wan")
self.directory.joinpath("wan-down").touch()
result = self.shell("wan_prepare")
self.assertNotEqual(result.returncode, 0)
self.assertFalse(self.directory.joinpath("owrt-remote-wan/lock").exists())
self.assertFalse(self.directory.joinpath("owrt-remote-wan/active-interface").exists())
def test_xray_reconnect_is_requested_only_for_a_changed_binding(self):
self.prepare()
config = self.directory / "xray.json"
config.write_text(json.dumps({"outbounds": [{"tag": "vps-interconn", "streamSettings": {"sockopt": {"interface": "eth0"}}}]}))
self.config(wan_interface="wan wwan", wan_direct="1", vps_host="192.0.2.10", xray_config=config.as_posix())
result = self.shell('''
xray_running() { return 0; }
wan_reconnect_xray() { printf '%s -> %s\n' "$1" "$2" >>"$TEST_ROOT/reconnect"; }
wan_prepare || exit
wan_reconcile_xray || exit
touch "$TEST_ROOT/wan-down"
wan_prepare || exit
wan_reconcile_xray
''')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(self.directory.joinpath("reconnect").read_text(), "eth0 -> wlan1\n")
def test_concurrent_reconnect_requests_restart_once_and_release_lock(self):
self.prepare()
restart = self.directory / "restart"
restart.write_text('#!/bin/sh\nprintf "%s\\n" "$*" >>"$TEST_ROOT/restarts"\n', encoding="utf-8", newline="\n")
restart.chmod(0o755)
original = "/etc/init.d/owrt-remote restart >/dev/null 2>&1 || log 'WAN failover tunnel restart failed'"
self.assertIn(original, self.agent)
self.agent = self.agent.replace(original, '"$TEST_ROOT/restart" restart >/dev/null 2>&1')
result = self.shell('wan_reconnect_xray eth0 wlan1; wan_reconnect_xray eth0 wlan1; sleep 2')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(self.directory.joinpath("restarts").read_text(), "restart\n")
self.assertFalse(self.directory.joinpath("owrt-remote-wan-restart").exists())
def test_hotplug_handles_selected_wifi_and_modem_events_and_ignores_others(self):
self.prepare()
self.config(enabled="1", wan_direct="1", wan_interface="wan wwan modem4g")
hotplug = (host_policy.ROOT / "files/etc/hotplug.d/iface/99-owrt-remote").read_text(encoding="utf-8")
hotplug = hotplug.replace('/usr/sbin/owrt-remote', 'test_hotplug_agent').replace('/etc/init.d/owrt-remote', 'test_hotplug_restart')
callbacks = r'''
sleep() { :; }
test_hotplug_agent() { printf '%s\n' "$*" >>"$TEST_ROOT/hotplug-calls"; }
test_hotplug_restart() { printf restart >>"$TEST_ROOT/hotplug-calls"; }
'''
for iface, action, expected in (("wwan", "ifup", True), ("modem4g", "ifdown", True), ("lan", "ifup", False)):
with self.subTest(iface=iface, action=action):
calls = self.directory / "hotplug-calls"
calls.unlink(missing_ok=True)
result = self.run_shell(callbacks + '\n' + hotplug, INTERFACE=iface, ACTION=action, DEVICE="wlan1")
self.assertEqual(result.returncode, 0, result.stderr)
if expected:
self.assertEqual(calls.read_text(), "heartbeat wan-reconnect\n")
else:
self.assertFalse(calls.exists())
if __name__ == "__main__":
unittest.main()
+199
View File
@@ -0,0 +1,199 @@
"""Router uplink picker regressions using real CGI requests and mocked netifd/UCI."""
from html.parser import HTMLParser
import json
import os
from pathlib import Path
import shutil
import subprocess
import sys
import tempfile
import unittest
from urllib.parse import urlencode
ROOT = Path(__file__).resolve().parents[1]
SH = shutil.which("sh")
GIT_BIN = Path(os.environ.get("ProgramFiles", "C:/Program Files")) / "Git/usr/bin"
if os.name == "nt" and (GIT_BIN / "sh.exe").exists():
SH = str(GIT_BIN / "sh.exe")
class FormParser(HTMLParser):
def __init__(self):
super().__init__()
self.fields = {}
self.options = []
def handle_starttag(self, tag, attrs):
attrs = dict(attrs)
if tag == "input" and attrs.get("name"):
if attrs["name"] == "wan_interface" and attrs.get("type") == "checkbox":
selected = "checked" in attrs
self.options.append((attrs.get("value", ""), selected))
if selected:
self.fields.setdefault("wan_interface", []).append(attrs.get("value", ""))
return
if attrs.get("type") != "checkbox" or "checked" in attrs:
self.fields[attrs["name"]] = attrs.get("value", "")
MOCKS = r'''
uci() {
[ "$1" != -q ] || shift
case "$1" in
show) cat "$TEST_ROOT/network" ;;
get)
[ "$2" != owrtremote.main ] || { printf remote; return; }
awk -F= -v key="$2" '$1==key { sub(/^[^=]*=/, ""); print; found=1; exit } END { if (!found) exit 1 }' "$TEST_ROOT/config"
;;
set)
key="${2%%=*}"; value="${2#*=}"
awk -F= -v key="$key" '$1!=key' "$TEST_ROOT/config" >"$TEST_ROOT/config.new"
printf '%s=%s\n' "$key" "$value" >>"$TEST_ROOT/config.new"
mv "$TEST_ROOT/config.new" "$TEST_ROOT/config"
;;
commit) printf '%s\n' "$*" >>"$TEST_ROOT/commits" ;;
esac
}
ubus() {
[ "$*" = 'call network.interface dump' ] || return 1
cat "$TEST_ROOT/runtime"
}
jsonfilter() {
[ "$*" = '-e @.interface[*].interface' ] || return 1
"$TEST_PYTHON" -c 'import json, sys; sys.stdout.buffer.write("\n".join(i["interface"] for i in json.load(sys.stdin).get("interface", [])).encode())'
}
service_enabled() { return 0; }
xray_running() { return 0; }
render_page() {
if [ "${TEST_FULL_PAGE:-0}" = 1 ]; then render_full_page; return; fi
printf '<form><input name="key" value="test-web-key"><input type="checkbox" name="wan_direct" value="1" checked>'
field router_name 'Название'
field vps_host 'VPS host'
wan_interface_field
printf '</form><p>%s</p>' "$RESULT_TITLE"
}
'''
@unittest.skipUnless(SH, "A POSIX shell is required")
class WanInterfacePickerTests(unittest.TestCase):
def setUp(self):
self.temp = tempfile.TemporaryDirectory(prefix="owrt-wan-picker-")
self.addCleanup(self.temp.cleanup)
self.directory = Path(self.temp.name)
self.directory.joinpath("key").write_text("test-web-key", encoding="utf-8")
self.directory.joinpath("config").write_text(
"owrtremote.main.wan_interface=wan\nowrtremote.main.wan_direct=1\n"
"owrtremote.main.vps_host=192.0.2.25\nowrtremote.main.vps_host_mode=manual\n"
"owrtremote.main.router_name=Test router\n", encoding="utf-8")
self.network(["lan", "wan", "wwan", "modem4g"], ["lan", "wan", "wwan"])
source = (ROOT / "files/www/cgi-bin/owrt-remote").read_text(encoding="utf-8")
self.cgi = self.directory / "cgi"
source = source.replace('render_page() {', 'render_full_page() {', 1)
self.cgi.write_text(source.replace("\nread_request\n", MOCKS + "\nread_request\n", 1), encoding="utf-8", newline="\n")
self.env = {**os.environ, "TMPDIR": self.directory.as_posix(), "TEST_ROOT": self.directory.as_posix(),
"TEST_PYTHON": Path(sys.executable).as_posix(), "KEY_FILE": (self.directory / "key").as_posix(),
"AGENT": "true"}
if os.name == "nt":
self.env["PATH"] = str(GIT_BIN) + os.pathsep + self.env["PATH"]
def network(self, configured, runtime):
self.directory.joinpath("network").write_text(
"network.globals=globals\n" + "".join(f"network.{name}=interface\nnetwork.{name}.proto='dhcp'\n" for name in configured), encoding="utf-8")
self.directory.joinpath("runtime").write_text(json.dumps({"interface": [{"interface": name} for name in runtime]}), encoding="utf-8")
def select(self, value):
path = self.directory / "config"
rows = [row for row in path.read_text().splitlines() if not row.startswith("owrtremote.main.wan_interface=")]
path.write_text("\n".join(rows) + f"\nowrtremote.main.wan_interface={value}\n", encoding="utf-8")
def request(self, data=None, key="test-web-key"):
body = urlencode(data or {}, doseq=True).encode("ascii")
result = subprocess.run([SH, self.cgi.as_posix()], input=body, capture_output=True,
env={**self.env, "QUERY_STRING": urlencode({"key": key}),
"REQUEST_METHOD": "POST" if data else "GET", "CONTENT_LENGTH": str(len(body)),
"CONTENT_TYPE": "application/x-www-form-urlencoded"}, timeout=30)
self.assertEqual(result.returncode, 0, result.stderr.decode("utf-8", errors="replace"))
page = result.stdout.decode("utf-8")
parser = FormParser()
parser.feed(page)
return page, parser
def test_all_configured_and_runtime_interfaces_appear_once_in_real_page(self):
self.env["TEST_FULL_PAGE"] = "1"
self.network(["lan", "wan", "wwan", "modem4g"], ["wan", "wwan", "lte"])
page, form = self.request()
self.assertEqual(form.options, [("wan", True), ("lan", False), ("lte", False), ("modem4g", False), ("wwan", False)])
self.assertIn('<details class="wanPicker" data-wan-picker>', page)
self.assertNotIn('<select name="wan_interface"', page)
def test_custom_saved_uplink_is_selected_without_reset(self):
for name in ("wwan", "modem4g"):
with self.subTest(name=name):
self.select(name)
_, form = self.request()
self.assertEqual(form.fields["wan_interface"], [name])
self.assertEqual(sum(selected for _, selected in form.options), 1)
def test_unavailable_saved_interface_survives_list_failure(self):
self.select("internet2")
self.network([], [])
page, form = self.request()
self.assertEqual(form.options, [("internet2", True)])
self.assertIn('data-wan-picked>internet2</div>', page)
self.assertIn("owrtremote.main.wan_interface=internet2", self.directory.joinpath("config").read_text())
def test_empty_legacy_value_uses_wan_and_keeps_offline_choices(self):
self.select("")
self.network(["modem4g", "wwan"], [])
_, form = self.request()
self.assertEqual(form.options, [("wan", True), ("modem4g", False), ("wwan", False)])
def test_invalid_runtime_names_are_filtered_and_saved_value_is_escaped(self):
self.select('old"<&interface')
self.network(["wan"], ["wan", 'evil"><script>', "two names"])
page, form = self.request()
self.assertEqual(form.options, [('old"<&interface', True), ("wan", False)])
self.assertNotIn("<script>", page)
self.assertIn('value="old&quot;&lt;&amp;interface"', page)
def test_form_saves_selected_modem_and_preserves_other_fields(self):
_, form = self.request()
form.fields.update({"action": "save", "wan_interface": "modem4g"})
page, saved = self.request(form.fields)
self.assertEqual(saved.fields["wan_interface"], ["modem4g"])
self.assertIn("Настройки сохранены", page)
config = self.directory.joinpath("config").read_text()
for row in ("wan_interface=modem4g", "wan_direct=1", "vps_host=192.0.2.25", "vps_host_mode=manual", "router_name=Test router"):
self.assertIn("owrtremote.main." + row + "\n", config)
self.assertEqual(self.directory.joinpath("commits").read_text(), "commit owrtremote\n")
self.assertEqual(self.directory.joinpath("network").read_text().count("=interface\n"), 4)
def test_two_or_three_selections_save_and_reopen_without_losing_choices(self):
_, form = self.request()
form.fields.update({"action": "save", "wan_interface": ["wan", "wwan", "modem4g", "wan"]})
_, saved = self.request(form.fields)
self.assertEqual(set(saved.fields["wan_interface"]), {"wan", "wwan", "modem4g"})
self.assertIn("owrtremote.main.wan_interface=wan wwan modem4g\n", self.directory.joinpath("config").read_text())
_, reopened = self.request()
self.assertEqual(set(reopened.fields["wan_interface"]), {"wan", "wwan", "modem4g"})
self.assertEqual(reopened.fields["wan_interface"][0], "wan")
def test_empty_or_invalid_selection_is_rejected_before_configuration_changes(self):
before = self.directory.joinpath("config").read_bytes()
for choice in ([], ["wan", "invalid interface"], ["wan", "bad;name"]):
with self.subTest(choice=choice):
page, _ = self.request({"action": "save_start", "wan_interface_picker": "1", "wan_direct": "1", "wan_interface": choice})
self.assertIn("Настройки не сохранены", page)
self.assertEqual(self.directory.joinpath("config").read_bytes(), before)
self.assertFalse(self.directory.joinpath("commits").exists())
def test_unauthorized_request_cannot_list_or_save_interfaces(self):
page, form = self.request({"action": "save", "wan_interface": "modem4g"}, key="wrong-key")
self.assertIn("Доступ запрещен", page)
self.assertFalse(form.options)
self.assertIn("owrtremote.main.wan_interface=wan\n", self.directory.joinpath("config").read_text())
if __name__ == "__main__":
unittest.main()
+37
View File
@@ -0,0 +1,37 @@
// Exercise the actual router picker script: checkbox changes must not close it.
const assert = require('node:assert/strict');
const fs = require('node:fs');
const vm = require('node:vm');
const source = fs.readFileSync('files/www/cgi-bin/owrt-remote', 'utf8');
const begin = source.indexOf("document.querySelectorAll('[data-wan-picker]')");
const end = source.indexOf('</script>', begin);
assert(begin >= 0 && end > begin);
for (const mobile of [false, true]) {
const inputs = ['wan', 'wwan', 'modem4g'].map(value => ({value, checked: value === 'wan'}));
const count = {}, picked = {}, handlers = {};
const picker = {
open: false,
closest() { return {querySelector: selector => selector === '[data-wan-count]' ? count : picked}; },
querySelectorAll() { return inputs; },
addEventListener(name, handler) { handlers[name] = handler; },
};
vm.runInNewContext(source.slice(begin, end), {
document: {querySelectorAll: () => [picker]},
window: {matchMedia: () => ({matches: mobile})},
});
assert.equal(count.textContent, 1);
assert.equal(picked.textContent, 'wan');
picker.open = true;
inputs[1].checked = true;
inputs[2].checked = true;
handlers.change();
assert.equal(count.textContent, 3);
assert.equal(picked.textContent, 'wan, wwan, modem4g');
assert.equal(picker.open, true);
for (const input of inputs) input.checked = false;
handlers.change();
assert.equal(count.textContent, 0);
assert.equal(picked.textContent, 'Интерфейсы не выбраны');
assert.equal(picker.open, true);
}
console.log('WAN_PICKER_UI_OK: multiple checks, count, empty selection and open-list persistence');