Fix direct WAN startup with missing routing tables

This commit is contained in:
kzolotarev95 committed 2026-10-13 17:15:32 +04:00
1 parent e0317344b4
commit 8ac9f84078
6 files changed
+416 -11

No files matched your search

+59
View File
@@ -0,0 +1,59 @@
# Исправление запуска прямого WAN в v114
На проблемном роутере обычный `wan` был поднят, имел IPv4-адрес,
маршрут и рабочий DNS. Проверка `ip -4 route show table 210` возвращала
`Dump terminated`, а `wan-preflight` — код 1. Генерация Xray-конфигурации
прерывалась, но агент всё равно запускал Xray с пустым аргументом `-config`.
В журнале появлялось `Failed to get format of`, затем procd останавливал
instance после шести падений. Из-за остановленного туннеля Hub показывал
роутер офлайн и ошибки proxy.
Теперь после такой ошибки чтения таблицы выполняется дополнительное
чтение всех таблиц. Только успешный полный вывод позволяет проверить,
пуста ли таблица 210. Учитываются её числовой ID и имена из `rt_tables`.
Чужая таблица или неудачный повторный запрос по-прежнему блокируют
подготовку WAN. Ошибка генерации, пустой путь или отсутствующий файл
конфигурации останавливают агент до запуска Xray.
Изменены только `files/usr/lib/owrt-remote/wan.sh` и
`files/usr/sbin/owrt-remote`. Версия остаётся v114. Настройки Podkop,
LAN и источники установки GitHub/GitLab не меняются. Обновление VPS
для этого исправления не требуется.
Установка из PowerShell Windows 11:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-wan-stability-fix.ps1" -Router "root@192.168.1.1" -Action Install
```
Скрипт перед заменой проверяет синтаксис и подготовку WAN новым helper,
сохраняет агент, helper, UCI и Xray-конфигурацию в
`/root/owrt-remote-backup-before-wan-stability-v114`. Сохранённая копия
не перезаписывается при повторной установке. После замены выполняются
перезапуск, проверка процесса Xray и настоящий heartbeat до Hub.
При ошибке восстанавливается состояние до текущей попытки.
Успех подтверждается `WAN_STABILITY_ROUTER_Install_OK`.
Откат из того же PowerShell:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-wan-stability-fix.ps1" -Router "root@192.168.1.1" -Action Rollback
```
Откат возвращает также настройки, сохранённые перед установкой. Если
в момент сохранения старый WAN-режим уже был включён и сломан, откат
вернёт и этот режим; его можно выключить в панели роутера.
Резервная копия хранится на конкретном роутере: установка на одном
IP не создаёт копию на другом. При отсутствии или неполноте копии
скрипт сообщает причину и завершает откат до остановки сервиса.
Локальные тесты с подменёнными OpenWrt UCI/ip/netifd проверяют ошибку
пустой таблицы, именованную чужую таблицу, отказ в чтении, запрет
пустой конфигурации и успешный запуск с корректной конфигурацией.
Также запускаются существующие проверки резервирования WAN, формы
выбора интерфейсов и применения Xray-команд. Все 64 проверки прошли;
PowerShell и подготовленные shell-скрипты установки/отката прошли
проверку синтаксиса, payload подготовлен в UTF-8 без BOM с LF.
Три дополнительные проверки отката подтверждают восстановление
полной копии и отсутствие изменений при отсутствующей/неполной копии.
Реальное устройство проверяет пользователь.
+61
View File
@@ -115,8 +115,16 @@ ip() {
priority) echo '104: from all fwmark 0x10000 lookup 105' ;;
esac ;;
'-4 route show table 210')
case "${TABLE_QUERY_ERROR:-}" in
busybox) echo 'Dump terminated' >&2; return 2 ;;
denied) echo 'RTNETLINK answers: Operation not permitted' >&2; return 2 ;;
esac
if [ "${TABLE_MISSING:-0}" = 1 ]; then echo 'Error: ipv4: FIB table does not exist.' >&2; return 2; fi
[ "${TABLE_CONFLICT:-}" != route ] || echo 'default via 192.0.2.1 dev other-wan' ;;
'-4 route show table all')
[ "${ALL_TABLES_FAIL:-0}" = 0 ] || { echo 'Dump terminated' >&2; return 2; }
echo 'default via 10.0.0.1 dev pppoe-wan table main'
[ "${ALL_TABLES_FOREIGN:-0}" = 0 ] || echo "default via 192.0.2.1 dev other-wan table ${ALL_TABLES_NAME:-210}" ;;
esac
return 0
}
@@ -426,6 +434,59 @@ printf '%s' "$(uci_get hub_url '')"
self.assertIn("<--post302>", args)
self.assertIn("<--post303>", args)
def test_busybox_empty_table_is_confirmed_before_wan_start(self):
self.config(vps_host="193.233.82.38", hub_url="https://hub.example", wan_direct="1", vless_uuid="test-uuid")
result = self.run_shell('render_client_config --stdout', TABLE_QUERY_ERROR="busybox")
self.assertEqual(result.returncode, 0, result.stderr)
config = json.loads(result.stdout)
self.assertEqual(config["outbounds"][2]["settings"]["address"], "193.233.82.38")
routes = self.directory.joinpath("ip").read_text()
self.assertIn("-4 route show table all", routes)
self.assertIn("-4 route replace default", routes)
self.assertEqual(self.directory.joinpath("owrt-remote-wan/active-interface").read_text().strip(), "wan")
def test_table_dump_error_does_not_hide_foreign_routes_or_read_failures(self):
self.config(vps_host="193.233.82.38")
for settings in ({"TABLE_QUERY_ERROR": "busybox", "ALL_TABLES_FOREIGN": "1"},
{"TABLE_QUERY_ERROR": "busybox", "ALL_TABLES_FAIL": "1"},
{"TABLE_QUERY_ERROR": "denied"}):
with self.subTest(settings=settings):
result = self.run_shell('wan_prepare', **settings)
self.assertNotEqual(result.returncode, 0)
self.assertNotIn("route replace", self.directory.joinpath("ip").read_text())
def test_table_dump_fallback_recognizes_named_foreign_table(self):
self.config(vps_host="193.233.82.38")
result = self.run_shell('''
wan_table_names() { printf '210\nremote_named\n'; }
wan_prepare
''', TABLE_QUERY_ERROR="busybox", ALL_TABLES_FOREIGN="1", ALL_TABLES_NAME="remote_named")
self.assertNotEqual(result.returncode, 0)
self.assertIn("does not belong to Remote", result.stderr)
self.assertNotIn("route replace", self.directory.joinpath("ip").read_text())
def test_xray_is_not_executed_with_a_failed_or_empty_configuration(self):
executable = self.directory / "fake-xray"
executable.write_text('#!/bin/sh\nprintf "%s\\n" "$*" >>"$TEST_ROOT/xray-called"\n', encoding="utf-8", newline="\n")
executable.chmod(0o755)
self.config(enabled="1", xray_bin=executable.as_posix())
for render in ('return 7', 'return 0', 'printf "%s" "$TEST_ROOT/missing-config"'):
with self.subTest(render=render):
result = self.run_shell('ensure_xray_available_with_retry() { return 0; }; render_client_config() { ' + render + '; }; run_xray')
self.assertNotEqual(result.returncode, 0)
self.assertFalse(self.directory.joinpath("xray-called").exists())
def test_xray_runs_with_the_successfully_rendered_configuration(self):
executable = self.directory / "fake-xray"
executable.write_text('#!/bin/sh\n[ "$1" != help ] || { echo run; exit; }; printf "%s\\n" "$*" >"$TEST_ROOT/xray-called"\n', encoding="utf-8", newline="\n")
executable.chmod(0o755)
config = self.directory / "valid-config.json"
config.write_text('{"outbounds": []}')
self.config(enabled="1", xray_bin=executable.as_posix())
result = self.run_shell('ensure_xray_available_with_retry() { return 0; }; render_client_config() { printf "%s" "$TEST_ROOT/valid-config.json"; }; run_xray')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(self.directory.joinpath("xray-called").read_text().strip(), 'run -config ' + config.as_posix())
def test_plain_http_heartbeat_accepts_json_after_redirect_follow(self):
self.config(vps_host="193.233.82.38", vps_host_mode="manual")
result = self.run_shell('''
+86
View File
@@ -0,0 +1,86 @@
"""Execute rollback locally with fake router paths; never connect to a router."""
import os
from pathlib import Path
import shlex
import shutil
import subprocess
import tempfile
import unittest
ROOT = Path(__file__).resolve().parents[1]
GIT_BIN = Path(os.environ.get("ProgramFiles", "C:/Program Files")) / "Git/usr/bin"
SH = shutil.which("sh")
if os.name == "nt" and (GIT_BIN / "sh.exe").exists():
SH = str(GIT_BIN / "sh.exe")
@unittest.skipUnless(SH, "A POSIX shell is required")
class WanStabilityRollbackTests(unittest.TestCase):
def setUp(self):
self.temp = tempfile.TemporaryDirectory(prefix="owrt-wan-rollback-")
self.addCleanup(self.temp.cleanup)
self.root = Path(self.temp.name)
self.stage = self.root / "stage"
self.stage.mkdir()
self.backup = self.root / "backup"
self.files = {name: self.root / name for name in ("config", "agent", "wan.sh", "xray")}
for name, path in self.files.items():
path.write_text("current-" + name, encoding="utf-8")
service = self.root / "service"
service.write_text('#!/bin/sh\nprintf "%s\\n" "$*" >>"$TEST_ROOT/service-calls"\n', encoding="utf-8", newline="\n")
source = (ROOT / "vps/deploy-wan-stability-fix.ps1").read_text(encoding="utf-8")
script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
script = script.replace('stage=/tmp/__UPLOAD_NAME__', 'stage=' + shlex.quote(self.stage.as_posix()))
script = script.replace('backup=/root/owrt-remote-backup-before-wan-stability-v114', 'backup=' + shlex.quote(self.backup.as_posix()))
script = script.replace('config=/etc/config/owrtremote', 'config=' + shlex.quote(self.files["config"].as_posix()))
for name, original in (("agent", "/usr/sbin/owrt-remote"), ("wan.sh", "/usr/lib/owrt-remote/wan.sh")):
script = script.replace('printf ' + original + ' ;;', "printf '%s' " + shlex.quote(self.files[name].as_posix()) + ' ;;')
script = script.replace('/etc/init.d/owrt-remote', 'sh ' + shlex.quote(service.as_posix()))
script = script.replace('__ACTION__', 'Rollback')
script = script.replace('xray_config=$(uci -q get owrtremote.main.xray_config || echo /etc/xray/owrt-remote-client.json)',
'xray_config=' + shlex.quote(self.files["xray"].as_posix()))
self.script = script
self.env = {**os.environ, "TEST_ROOT": self.root.as_posix()}
if os.name == "nt":
self.env["PATH"] = str(GIT_BIN) + os.pathsep + self.env["PATH"]
def run_rollback(self):
return subprocess.run([SH], input=self.script, encoding="utf-8", capture_output=True,
env=self.env, timeout=20)
def assert_unchanged(self):
for name, path in self.files.items():
self.assertEqual(path.read_text(), "current-" + name)
self.assertFalse(self.root.joinpath("service-calls").exists())
def test_missing_backup_explains_failure_without_stopping_service(self):
result = self.run_rollback()
self.assertNotEqual(result.returncode, 0)
self.assertIn("No backup on this router:", result.stderr)
self.assertIn("Nothing changed.", result.stderr)
self.assert_unchanged()
def test_incomplete_backup_is_rejected_before_restore(self):
self.backup.mkdir()
self.backup.joinpath("complete").touch()
result = self.run_rollback()
self.assertNotEqual(result.returncode, 0)
self.assertIn("Backup is incomplete:", result.stderr)
self.assert_unchanged()
def test_complete_backup_restores_files_and_settings_then_restarts(self):
self.backup.mkdir()
for name in self.files:
self.backup.joinpath(name).write_text("saved-" + name)
self.backup.joinpath("xray-path").write_text(self.files["xray"].as_posix())
self.backup.joinpath("complete").touch()
result = self.run_rollback()
self.assertEqual(result.returncode, 0, result.stderr)
for name, path in self.files.items():
self.assertEqual(path.read_text(), "saved-" + name)
self.assertEqual(self.root.joinpath("service-calls").read_text(), "stop\nrestart\n")
self.assertIn("WAN_STABILITY_ROUTER_Rollback_OK", result.stdout)
if __name__ == "__main__":
unittest.main()