Publish v119 update safeguards and yichya Xray bootstrap fixes

This commit is contained in:
kzolotarev95 committed 2026-10-27 22:07:15 +04:00
1 parent 730b54c939
commit 5956daa8c2
73 files changed
+980 -306

No files matched your search

+2 -2
View File
@@ -1,4 +1,4 @@
# Heartbeat: HTTPS, авторизация и диагностика (v118)
# Heartbeat: HTTPS, авторизация и диагностика (v119)
## Разбор сбоя 15.10.2026
@@ -82,7 +82,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
Обновляются агент и WAN helper. Перезапускается только экземпляр Heartbeat
под procd; Xray и удалённый туннель скрипт не перезапускает. Остановленный
экземпляр остаётся остановленным. Резервная копия первых файлов сохраняется
в `/root/owrt-remote-backup-before-heartbeat-transport-v118`.
в `/root/owrt-remote-backup-before-heartbeat-transport-v119`.
Маркер `HEARTBEAT_TRANSPORT_ROUTER_Install_OK` подтверждает установку кода,
а доступность Hub проверяется отдельно:
+12 -12
View File
@@ -1,4 +1,4 @@
# Фиксация VPS host и независимое соединение Remote через WAN (v118)
# Фиксация VPS host и независимое соединение Remote через WAN (v119)
`vps_host_mode=manual` сохраняет заданный на роутере адрес. Это значение
используется и когда опция отсутствует у старой установки. Только явно
@@ -42,8 +42,8 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-hub-url-fix.
```
Откат: те же команды с `-Action Rollback`, без `-HubUrl`. Резервные копии:
`/root/owrt-remote-backup-before-hub-url-v118` на роутере и
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-url-v118` на VPS.
`/root/owrt-remote-backup-before-hub-url-v119` на роутере и
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-url-v119` на VPS.
`HEARTBEAT_OK` подтверждает ответ Hub. Если файлы установлены, но Hub недоступен,
скрипт отдельно сообщает `HEARTBEAT_FAILED`; это не подтверждение связи.
@@ -125,21 +125,21 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.
Установка загружает локальные файлы, без Git. До остановки службы проверяются
доступность WAN и поддержка таблицы реальной командой ip на роутере.
На роутер загружается и файл LuCI: версия v118 появляется и в основной
На роутер загружается и файл LuCI: версия v119 появляется и в основной
CGI-панели, и в странице входа в неё через LuCI.
Сначала сохраняются файлы
и конфигурация; после замены проверяется heartbeat/health. При ошибке
автоматически восстанавливается состояние перед текущей попыткой.
Сохранённая резервная копия для ручного отката не перезаписывается.
* Роутер: `/root/owrt-remote-backup-before-host-policy-v118` — агент,
* Роутер: `/root/owrt-remote-backup-before-host-policy-v119` — агент,
helper, init, CGI, UCI-конфигурация и Xray-конфиг (в закрытом каталоге).
* VPS: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-host-policy-v118`.
* VPS: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-host-policy-v119`.
База роутеров и настройки авторизации не заменяются.
Успешная установка заканчивается `HOST_POLICY_ROUTER_V118_OK` на роутере
и `HOST_POLICY_VPS_V118_Install_OK` на VPS. Старые резервные копии предыдущей
версии сохраняются; новые команды отката используют отдельные копии для v118.
Успешная установка заканчивается `HOST_POLICY_ROUTER_V119_OK` на роутере
и `HOST_POLICY_VPS_V119_Install_OK` на VPS. Старые резервные копии предыдущей
версии сохраняются; новые команды отката используют отдельные копии для v119.
### Переход с nftables-маркировки на адресную маршрутизацию
@@ -148,11 +148,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-v118" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.ps1" -Target Router -Machine "root@192.168.2.1" -BackupName "podkop-compat-v118" -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-v119" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "vps\deploy-host-policy.ps1" -Target Router -Machine "root@192.168.2.1" -BackupName "podkop-compat-v119" -Action Rollback
```
Копия: `/root/owrt-remote-backup-before-podkop-compat-v118`.
Копия: `/root/owrt-remote-backup-before-podkop-compat-v119`.
После установки повторите диагностику Podkop. Предупреждение от прежних правил
Remote должно исчезнуть. Настоящие дополнительные правила других приложений
по-прежнему обнаруживаются штатной диагностикой.
+46 -13
View File
@@ -1,10 +1,12 @@
# Обновление панели из Hub (v118)
# Обновление панели из Hub (v119)
Перед «Поиск роутеров» владелец видит кнопку «Обновление панели».
Перед «Поиск роутеров» владелец видит кнопку «Проверить обновление панели».
Обе кнопки оформлены как остальные элементы шапки и стоят рядом на ПК.
На мобильных устройствах каждая занимает отдельную строку.
Подтверждённая актуальная сборка обозначается зелёным, доступное обновление —
жёлтым. Проверка и ошибка проверки остаются нейтральными. Сообщение проверки
Подтверждённая актуальная сборка обозначается зелёной кнопкой «Обновление не требуется»,
без отдельного информационного блока на ПК и мобильном. Кнопка по-прежнему позволяет
повторно проверить обновление. Доступное обновление обозначается жёлтым.
Проверка и ошибка проверки остаются нейтральными. Сообщение проверки
размещено первым блоком панели над шапкой, выровнено по центру и отделено
от элементов управления отступом. Во всех состояниях текст блока белый,
рамка полупрозрачная, как у «Открыть группы роутеров», фон прозрачный. Ширина ограничена
@@ -18,15 +20,41 @@
групп и статистики используется единый интервал 8 пикселей. Раскрытые блоки
отделены тем же интервалом; скрытые элементы не оставляют пустых промежутков.
Для локальной установки изменения кнопки и скрытия блока актуальной версии:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-update-status-ui.ps1" -Vps "root@193.233.82.38" -Action Install
```
Скрипт сохраняет отдельную резервную копию `owrt-remote-hub.py.bak-before-update-status-ui-v119`.
Для отката выполнить ту же команду с `-Action Rollback`. После установки или отката
обновить страницу через Ctrl+F5.
Успех подтверждается только при совпадении SHA-256 загруженного файла и сборки,
которая отвечает на `/health?panel-update=1`. Ответа `{"ok":true}` недостаточно.
До публикации локальный файл отличается от репозитория: кнопка может предложить
опубликованную сборку и при подтверждении заменить ею локальный фикс.
Чтобы проверить именно зелёную кнопку «Обновление не требуется» без публикации,
выполнить `test-hub-self-update.ps1 -Action Retest`, подтвердить обновление с источником
«Локальный тест на VPS (без GitHub)» и дождаться перезагрузки страницы. Обе тестовые
сборки содержат текущий локальный интерфейс; отдельного блока актуальности после
перезагрузки быть не должно. Команды подготовки и возврата приведены ниже.
При открытии панели запускается общая фоновая проверка исходного файла Hub.
Проверки кешируются на 5 минут; открытые видимые вкладки опрашивают результат
раз в минуту. Нажатие кнопки позволяет запросить проверку раньше, с ограничением
не чаще одного сетевого запроса за 15 секунд. Во время установки статус
запрашивается раз в 2 секунды. Скрытые вкладки приостанавливают опрос.
Сравнивается SHA-256 файла, поэтому изменения обнаруживаются и при неизменной
версии v118. «Доступно обновление» означает, что опубликованный файл отличается
от запущенного. Установка требует подтверждения конкретной проверенной сборки.
Сравниваются номер версии и SHA-256 файла: более старая опубликованная версия
не предлагается и не может быть установлена через кнопку/API. Это сохраняет
локальную v119, пока в источнике опубликована предыдущая версия. Кнопка остаётся
зелёной с подписью «Обновление не требуется», отдельного баннера актуальности нет.
Подсказка кнопки показывает номера установленной и более старой опубликованной
версии. Ограничение проверяется и перед запуском задачи, и в процессе установки
до замены файла. Явный откат из PowerShell сохраняет своё прежнее поведение.
Внутри одной версии по-прежнему сравнивается SHA-256: исправления обнаруживаются
и при неизменной версии v119. Установка требует подтверждения конкретной сборки.
Ветка GitHub использует свой `RAW_REPO_BASE`; при переносе в GitVerse необходимо
сохранить его собственный `RAW_REPO_BASE`. Адрес не принимается от браузера.
@@ -38,8 +66,8 @@ systemd, сохраняет резервную копию, проверяет р
в `STATE_DIR/panel-update/job.json`; предыдущий файл — `previous.py` рядом.
После успеха страница автоматически перезагружается один раз.
После перезагрузки сообщение завершённой задачи больше не обещает повторную
перезагрузку: при подтверждённой актуальности выводится «У вас последняя версия
панели, обновление не требуется». Следующие проверки и доступные новые сборки
перезагрузку: при подтверждённой актуальности остаётся только зелёная кнопка
«Обновление не требуется». Следующие проверки и доступные новые сборки
показывают текущее состояние, даже если сохранена предыдущая успешная задача.
Очередь, состояние и резервная копия ограничены одним обновлением. Блокировка
@@ -62,7 +90,7 @@ API доступен только владельцу, POST требует CSRF-
## Проверка через кнопку без публикации
Скрипт ниже подготавливает на VPS две временные сборки из текущего локального
исходника v118. Различается только тестовая отметка, поэтому их SHA-256 разные.
исходника v119. Различается только тестовая отметка, поэтому их SHA-256 разные.
Первая сборка устанавливается скриптом, вторая предлагается кнопкой обновления.
Только эти временные сборки читают файл-кандидат на самой VPS вместо GitHub.
Ссылки установки и `RAW_REPO_BASE` остаются прежними. Данные обычной очереди
@@ -135,7 +163,7 @@ Hub, проверяет `/health`, затем удаляет только соз
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-hub-self-update.ps1" -Vps "root@193.233.82.38" -Action Install
```
После `HUB_SELF_UPDATE_V118_Install_OK` обновить страницу через Ctrl+F5.
После `HUB_SELF_UPDATE_V119_Install_OK` обновить страницу через Ctrl+F5.
Откат локальной установки:
@@ -144,18 +172,20 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```
Используется резервная копия
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-self-update-v118`.
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-hub-self-update-v119`.
## Проверки
```powershell
python tests/test_hub_update.py -v
python tests/test_hub_self_update_local.py -v
python tests/test_update_status_ui_deploy.py -v
node tests/test_hub_update_ui.cjs
```
Python проверяет загрузку из правильного источника, ошибки сети и синтаксиса,
неизменную версию, проверку контрольной суммы, сохранение рабочего файла,
неизменную версию, отказ от понижения версии при проверке/API/установке,
переход на более новую версию, проверку контрольной суммы, сохранение рабочего файла,
установку и откат, восстановление состояния после перезапуска и права API.
Перезапуск systemd и ответы health в этих тестах моделируются.
Отдельный тест локального сценария проверяет реальные файлы и HTTP `/health`
@@ -163,6 +193,9 @@ Python проверяет загрузку из правильного исто
возврат исходного файла, сохранение обычного состояния обновления и подготовку
UTF-8 файлов из Windows PowerShell. Команды systemd в автоматическом тесте
моделируются; их выполнение на VPS проверяется ручным сценарием выше.
Тест установки интерфейса использует HTTP `/health` и проверяет отказ при
ответе другой запущенной сборки или при отсутствии контрольной суммы,
сохранение резервной копии и автоматический возврат предыдущего файла.
Браузер проверяет размеры 1280, 980, 320, 390, 430, 844 и 932 пикселя,
положение статуса над шапкой, перенос текста, размеры мобильных кнопок,
подтверждение/отмену,
+2 -2
View File
@@ -1,4 +1,4 @@
# Journal collector liveness fix (local v118)
# Journal collector liveness fix (local v119)
## What the reported evidence does and does not prove
@@ -68,7 +68,7 @@ WAN/DNS or policy routing. VPS files and hosting URLs are untouched.
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-log-collector-fix.ps1" -Router "root@192.168.2.1" -Action Install
```
Retained backup: `/root/owrt-remote-backup-before-log-collector-v118`.
Retained backup: `/root/owrt-remote-backup-before-log-collector-v119`.
Rollback leaves journal data intact:
```powershell
+1 -1
View File
@@ -1,4 +1,4 @@
# Persistent client journal (v118 local fix)
# Persistent client journal (v119 local fix)
The helper is `/usr/lib/owrt-remote/logs.sh`. It changes only Remote's private
journal, not logd, network configuration, policy routing or Xray configuration.
+3 -3
View File
@@ -1,4 +1,4 @@
# reCAPTCHA v3 в OpenWrt Remote Hub v118
# reCAPTCHA v3 в OpenWrt Remote Hub v119
В меню владельца, в блоке «Капча на экране входа», доступны цифры,
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-v118`
* `/opt/owrt-remote/captcha-before-recaptcha-v3-v118.json` (режим 0600).
* `/opt/owrt-remote/owrt-remote-hub.py.bak-before-recaptcha-v3-v119`
* `/opt/owrt-remote/captcha-before-recaptcha-v3-v119.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 v118
# Аудит ресурсов OpenWrt Remote Hub v119
Исправления внесены поверх `7f809fd`. Версия панели остаётся v118.
Исправления внесены поверх `7f809fd`. Версия панели остаётся v119.
## 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-v118`,
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-resource-fix-v119`,
атомарно заменяет Python файл, перезапускает `owrt-remote` и проверяет health.
Существующая резервная копия не перезаписывается. При ошибке установки
восстанавливается файл, работавший непосредственно перед текущей попыткой.
+2 -2
View File
@@ -1,4 +1,4 @@
# Обновление всех роутеров из Hub, v118
# Обновление всех роутеров из Hub, v119
В меню владельца «Доступ к Hub» добавлен блок «Обновить все роутеры разом».
Ссылка «Открыть терминал обновления» открывает отдельную вкладку. В ней задаются
@@ -128,7 +128,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-router-updates.ps1" -Vps "root@193.233.82.38" -Action Rollback
```
Резервная копия: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-router-reboot-all-v118`.
Резервная копия: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-router-reboot-all-v119`.
Не устанавливай/не откатывай Hub, пока его очередь работает.
## Проверки
+12 -6
View File
@@ -1,13 +1,13 @@
# Версия v118
# Версия v119
Версия v118 указана в панели VPS, на экране входа, в мобильной шапке,
Версия v119 указана в панели VPS, на экране входа, в мобильной шапке,
CGI и представлении LuCI роутера. Скрипты локальной установки, их проверки
и документация используют тот же номер. Ссылки источников не менялись.
Установить локальную сборку на VPS:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-version-v118.ps1" -Vps "root@193.233.82.38" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-version-v119.ps1" -Vps "root@193.233.82.38" -Action Install
```
В ходе текущего тестирования обновления через кнопку вместо обычной установки
@@ -20,10 +20,16 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
Установить версию интерфейса роутера (CGI и LuCI):
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-version-v118.ps1" -Router "root@192.168.2.1" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-version-v119.ps1" -Router "root@192.168.2.1" -Action Install
```
Скрипт сохраняет первую резервную копию и проверяет файлы до установки.
На VPS дополнительно сверяется SHA-256 запущенной сборки через `/health?panel-update=1`;
ответ от другой сборки не подтверждает успешную установку.
Обновление через кнопку не позволяет установить более старую опубликованную
версию поверх локальной v119. Для исправлений с тем же номером версии
по-прежнему проверяется SHA-256. Отдельный баннер «последняя версия» скрыт:
при отсутствии обновлений остаётся зелёная кнопка «Обновление не требуется».
При ошибке после замены возвращает файлы предыдущей попытки.
Установщики не выполняют миграцию настроек роутера; после установки
интерфейса нужно обновить страницу через Ctrl+F5.
@@ -31,8 +37,8 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
Для отката обычной установки VPS либо роутера повторить соответствующую
команду с `-Action Rollback`. Копии:
- VPS: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-v118`.
- Роутер: `/root/owrt-remote-backup-before-v118` (CGI и LuCI).
- VPS: `/opt/owrt-remote/owrt-remote-hub.py.bak-before-v119`.
- Роутер: `/root/owrt-remote-backup-before-v119` (CGI и LuCI).
Для возврата из тестового режима обновления VPS повторить команду
`test-hub-self-update.ps1` с `-Action Restore`: его копия хранится отдельно,
+4 -4
View File
@@ -1,4 +1,4 @@
# Виджеты ресурсов VPS (v118)
# Виджеты ресурсов VPS (v119)
Три карточки ЦП, ОЗУ и ДИСК находятся над кнопками «Рестарт Xray VPS»,
профилем и выходом. На ПК ширина и высота совпадают с кнопками под ними.
@@ -24,7 +24,7 @@ vCPU и объёмы занятой/общей памяти и диска.
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-vps-resources-fix.ps1" -Vps "root@193.233.82.38" -Action Install
```
После `VPS_RESOURCES_LIVE_V118_Install_OK` обновите страницу через Ctrl+F5.
После `VPS_RESOURCES_LIVE_V119_Install_OK` обновите страницу через Ctrl+F5.
Скрипт загружает локальный файл, проверяет его до замены, перезапускает
службу и проверяет health. При ошибке после замены восстанавливает файл
перед текущей попыткой. База данных и настройки не заменяются.
@@ -34,8 +34,8 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```
Откат использует неизменяемую копию первого состояния до установки:
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-vps-resources-live-v118`.
Успешное завершение: `VPS_RESOURCES_LIVE_V118_Rollback_OK`.
`/opt/owrt-remote/owrt-remote-hub.py.bak-before-vps-resources-live-v119`.
Успешное завершение: `VPS_RESOURCES_LIVE_V119_Rollback_OK`.
## Локальные проверки
+2 -2
View File
@@ -1,4 +1,4 @@
# WAN IPv4 DNS fallback (local v118 fix)
# WAN IPv4 DNS fallback (local v119 fix)
`files/usr/lib/owrt-remote/wan.sh` now explicitly queries
`nslookup -type=A -timeout=3 -retry=1 "$host" "$dns"`.
@@ -58,7 +58,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```
The installer saves the first backup at
`/root/owrt-remote-backup-before-wan-dns-v118/wan.sh`, checks shell syntax and
`/root/owrt-remote-backup-before-wan-dns-v119/wan.sh`, checks shell syntax and
reloads only the supervised heartbeat instance so it reads the new helper.
It does not restart Xray or regenerate configuration/routing. Installation
verification/reload failures restore the file from that attempt.
+2 -2
View File
@@ -1,4 +1,4 @@
# Несколько WAN интерфейсов и резервирование (v118)
# Несколько WAN интерфейсов и резервирование (v119)
Кнопка **Выбрать интерфейсы** раскрывает список с галочками. Можно отметить
один, два, три и больше интерфейсов. Список содержит имена
@@ -46,7 +46,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
Скрипт устанавливает CGI, LuCI, агент, WAN helper и hotplug вместе. До замены
сохраняются прежние файлы, UCI-настройки и Xray config в
`/root/owrt-remote-backup-before-wan-multi-v118`.
`/root/owrt-remote-backup-before-wan-multi-v119`.
Успех подтверждает `WAN_MULTI_ROUTER_Install_OK`. После установки обновить
панель роутера через Ctrl+F5, отметить интерфейсы и сохранить выбор.
VPS обновлять не требуется. Старый `deploy-wan-interface-picker.ps1`
+2 -2
View File
@@ -1,4 +1,4 @@
# Восстановление Xray после пропажи выбранного WAN (v118)
# Восстановление Xray после пропажи выбранного WAN (v119)
Сообщения `No selected WAN has a physical IPv4 default route`, ошибки
генерации конфигурации и `crash loop 6 crashes` описывают последовательность:
@@ -50,7 +50,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```
Скрипт обновляет агент и WAN helper парой, сохраняет первую копию в
`/root/owrt-remote-backup-before-wan-recovery-v118`, проверяет shell-синтаксис
`/root/owrt-remote-backup-before-wan-recovery-v119`, проверяет shell-синтаксис
и побайтовое совпадение. Затем перезагружает только работающий Heartbeat,
чтобы в RAM не остался прежний shell с уже загруженными функциями.
Туннель при исправном Xray не перезапускается. Остановленный Heartbeat
+3 -3
View File
@@ -1,4 +1,4 @@
# Исправление запуска прямого WAN в v118
# Исправление запуска прямого WAN в v119
На проблемном роутере обычный `wan` был поднят, имел IPv4-адрес,
маршрут и рабочий DNS. Проверка `ip -4 route show table 210` возвращала
@@ -16,7 +16,7 @@ instance после шести падений. Из-за остановленн
конфигурации останавливают агент до запуска Xray.
Изменены только `files/usr/lib/owrt-remote/wan.sh` и
`files/usr/sbin/owrt-remote`. Версия остаётся v118. Настройки Podkop,
`files/usr/sbin/owrt-remote`. Версия остаётся v119. Настройки Podkop,
LAN и источники установки GitHub/GitLab не меняются. Обновление VPS
для этого исправления не требуется.
@@ -28,7 +28,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
Скрипт перед заменой проверяет синтаксис и подготовку WAN новым helper,
сохраняет агент, helper, UCI и Xray-конфигурацию в
`/root/owrt-remote-backup-before-wan-stability-v118`. Сохранённая копия
`/root/owrt-remote-backup-before-wan-stability-v119`. Сохранённая копия
не перезаписывается при повторной установке. После замены выполняются
перезапуск, проверка процесса Xray и настоящий heartbeat до Hub.
При ошибке восстанавливается состояние до текущей попытки.
+6 -6
View File
@@ -1,4 +1,4 @@
# Применение OpenWrt config через панель роутера (v118)
# Применение OpenWrt config через панель роутера (v119)
При отправке textarea браузер кодирует переносы строк как CRLF. CGI
декодировал их без нормализации и записывал CR в исполняемый shell-скрипт.
@@ -22,7 +22,7 @@ CRLF и LF, heredoc, пустые строки, кодированные сим
Скрипт обновляет только CGI на роутере. VPS обновлять для этого фикса
не требуется. До замены сохраняется первая резервная копия CGI:
`/root/owrt-remote-backup-before-xray-apply-v118/owrt-remote`.
`/root/owrt-remote-backup-before-xray-apply-v119/owrt-remote`.
Из PowerShell Windows 11; замените IP, если адрес роутера отличается:
@@ -53,7 +53,7 @@ python tests/test_xray_apply.py -v
Переносы строк в формах описаны в [стандарте HTML](https://html.spec.whatwg.org/multipage/form-control-infrastructure.html).
## Мобильная вставка команд (локальный фикс v118)
## Мобильная вставка команд (локальный фикс v119)
Воспроизведён отдельный случай `rc=255`: в строке
`uci set owrtremote.main.router_name=‘Дом у моря’` типографские кавычки
@@ -77,7 +77,7 @@ python tests/test_xray_apply.py -v
Обновляется только `/www/cgi-bin/owrt-remote` на роутере, без перезапуска
служб и изменений настроек при установке. Резервная копия отдельная:
`/root/owrt-remote-backup-before-xray-mobile-v118/owrt-remote`.
`/root/owrt-remote-backup-before-xray-mobile-v119/owrt-remote`.
Установка из PowerShell Windows 11:
@@ -101,7 +101,7 @@ python tests/test_xray_mobile_deploy.py -v
```
## Проверка Xray и ошибка Heartbeat после применения (локальный фикс v118)
## Проверка Xray и ошибка Heartbeat после применения (локальный фикс v119)
В предоставленном журнале Xray 26.3.27 запускается успешно, а завершающая
команда `owrt-remote heartbeat` возвращает `rc=1` с `Failed to allocate
@@ -153,7 +153,7 @@ CGI получает этап выполнения от агента. Ошибк
Новый скрипт `vps/deploy-xray-validation-fix.ps1` обновляет CGI и агент,
не пересобирает настройки и не перезапускает службы при установке/откате.
Первая резервная копия обоих файлов:
`/root/owrt-remote-backup-before-xray-validation-v118`. Если установка
`/root/owrt-remote-backup-before-xray-validation-v119`. Если установка
оборвалась или проверка файлов не прошла, возвращаются файлы до этой попытки.
На роутере друга нужно указать его доступный SSH-адрес вместо локального IP.
+2 -2
View File
@@ -1,4 +1,4 @@
# Восстановление Xray после перезагрузки (локальный фикс v118)
# Восстановление Xray после перезагрузки (локальный фикс v119)
В предоставленном журнале node-3 после перезагрузки отсутствовал
`/tmp/owrt-xray/xray`. Повторная загрузка завершилась
@@ -56,7 +56,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
```
Скрипт заменяет только `/usr/sbin/owrt-remote`, сохраняет первую резервную
копию в `/root/owrt-remote-backup-before-xray-boot-v118`, подготавливает кэш,
копию в `/root/owrt-remote-backup-before-xray-boot-v119`, подготавливает кэш,
перезагружает отдельный Heartbeat instance и запрашивает запуск Xray, если
тот остановлен при работающем Heartbeat. Здоровый туннель не перезапускается.
`XRAY_BOOT_ROUTER_Install_OK` подтверждает установку кода, а не установление
+3 -3
View File
@@ -43,7 +43,7 @@ class GlobalLogsDeploymentTests(unittest.TestCase):
mappings['/etc/init.d/rpcd'] = (self.root / 'etc/init.d/rpcd').as_posix()
mappings['/etc/init.d/uhttpd'] = (self.root / 'etc/init.d/uhttpd').as_posix()
mappings['/tmp/owrt-remote-logs'] = (self.root / 'journal').as_posix()
mappings['/root/owrt-remote-backup-before-global-logs-stop-v118'] = self.backup.as_posix()
mappings['/root/owrt-remote-backup-before-global-logs-stop-v119'] = self.backup.as_posix()
pattern = '|'.join(re.escape(target) for target in sorted(mappings, key=len, reverse=True))
self.script = re.sub(pattern, lambda match: mappings[match.group()], self.script)
# Existing sandbox service scripts only print markers. Mock readiness.
@@ -104,7 +104,7 @@ logger() { printf '%s\\n' "$3" | sh "$TEST_LOG_HELPER" append; }
self.assertIn('GLOBAL_LOGS_ROUTER_Install_OK', result.stdout)
for item in ('cgi', 'luci'):
installed = self.root / self.targets[item].lstrip('/')
self.assertIn('v118', installed.read_text(encoding='utf-8'))
self.assertIn('v119', installed.read_text(encoding='utf-8'))
for item, data in self.initial.items():
self.assertEqual(self.backup.joinpath(item).read_bytes(), data)
result = self.deploy('Rollback')
@@ -131,7 +131,7 @@ logger() { printf '%s\\n' "$3" | sh "$TEST_LOG_HELPER" append; }
self.assert_initial()
def test_rollback_restores_existing_log_service_and_helper(self):
# This fix is normally applied on top of v118's already installed journal.
# This fix is normally applied on top of v119's already installed journal.
for item in ('logs.sh', 'logs-init'):
target = self.root / self.targets[item].lstrip('/')
target.parent.mkdir(parents=True, exist_ok=True)
+2 -2
View File
@@ -20,7 +20,7 @@ class VpsLogDeployTests(unittest.TestCase):
self.target = self.root / 'hub.py'
self.previous = b'print("previous Hub")\n'
self.target.write_bytes(self.previous)
self.backup = self.root / 'hub.py.bak-before-global-logs-ui-v118'
self.backup = self.root / 'hub.py.bak-before-global-logs-ui-v119'
source = (ROOT / 'vps/deploy-global-logs-vps.ps1').read_text(encoding='utf-8')
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace('/opt/owrt-remote/owrt-remote-hub.py', self.target.as_posix())
@@ -55,7 +55,7 @@ sleep() { return 0; }
for _ in range(2):
result = self.deploy('Install')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertIn('GLOBAL_LOGS_VPS_V118_Install_OK', result.stdout)
self.assertIn('GLOBAL_LOGS_VPS_V119_Install_OK', result.stdout)
self.assertIn(b'def receive_router_logs(', self.target.read_bytes())
self.assertEqual(self.backup.read_bytes(), self.previous)
result = self.deploy('Rollback')
+1 -1
View File
@@ -25,7 +25,7 @@ class HeartbeatTransportDeploymentTests(unittest.TestCase):
self.env["PATH"] = str(GIT_BIN) + os.pathsep + self.env["PATH"]
source = (ROOT / "vps/deploy-heartbeat-transport-fix.ps1").read_text(encoding="utf-8")
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-heartbeat-transport-v118",
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-heartbeat-transport-v119",
"backup_dir=" + shlex.quote(self.backup.as_posix()))
self.script = self.script.replace("printf /usr/lib/owrt-remote/wan.sh", "printf %s " + shlex.quote(self.targets["wan.sh"].as_posix()))
self.script = self.script.replace("printf /usr/sbin/owrt-remote", "printf %s " + shlex.quote(self.targets["agent"].as_posix()))
+1 -1
View File
@@ -169,7 +169,7 @@ class LocalTestTests(unittest.TestCase):
env={**os.environ, 'TEMP': str(self.root), 'TMP': str(self.root)})
self.assertEqual(result.returncode, 0, result.stderr)
stage = Path(next(line.split(': ', 1)[1] for line in result.stdout.splitlines() if line.startswith('Prepared only: ')))
self.assertEqual(stage.parent, self.root)
self.assertTrue(stage.parent.samefile(self.root), 'staging stays in the requested temporary directory')
compile((stage / 'run.py').read_bytes(), 'prepared-tool.py', 'exec')
self.assertEqual((stage / 'hub.py').read_bytes(), SOURCE)
+56 -1
View File
@@ -6,6 +6,7 @@ import io
import json
import os
from pathlib import Path
import re
import subprocess
import sys
import tempfile
@@ -24,6 +25,13 @@ with mock.patch.dict(os.environ, {'OWRT_REMOTE_STATE_DIR': STATE.name}):
spec.loader.exec_module(hub)
SOURCE = (ROOT / 'vps/owrt-remote-hub.py').read_bytes()
NEW = SOURCE + b'\n# update test build\n'
CURRENT_VERSION = int(hub.HUB_LOADED_VERSION[1:])
def versioned_source(version):
return re.sub(rb'(appBannerVersion[^>]*>)v[0-9]+',
lambda match: match[1] + ('v' + str(version)).encode('ascii'),
SOURCE, count=1)
class UpdateTests(unittest.TestCase):
@@ -59,7 +67,7 @@ class UpdateTests(unittest.TestCase):
self.assertEqual(fetch.call_args.args[0].full_url, source + '/vps/owrt-remote-hub.py')
data = self.manager.snapshot()
self.assertTrue(data['available'])
self.assertEqual(data['remote_version'], 'v118')
self.assertEqual(data['remote_version'], 'v119')
self.assertEqual(data['remote_revision'], hashlib.sha256(NEW).hexdigest())
self.assertEqual(self.target.read_bytes(), SOURCE)
@@ -75,6 +83,53 @@ class UpdateTests(unittest.TestCase):
self.assertFalse(data['available'])
self.assertEqual(self.target.read_bytes(), SOURCE)
def test_older_published_version_is_not_offered_and_stale_start_is_rejected(self):
older = versioned_source(CURRENT_VERSION - 1)
with mock.patch.object(hub.urllib.request, 'urlopen', return_value=self.response(older)):
self.manager._check()
state = self.manager.snapshot()
self.assertNotEqual(state['remote_revision'], state['current_revision'])
self.assertFalse(state['available'])
self.assertTrue(state['source_older'])
self.assertFalse(state['error'])
self.assertEqual(state['current_version'], hub.HUB_LOADED_VERSION)
self.assertEqual(state['remote_version'], 'v' + str(CURRENT_VERSION - 1))
with mock.patch.object(hub.subprocess, 'run') as run:
with self.assertRaisesRegex(ValueError, 'Понижение версии'):
self.manager.start(state['remote_revision'])
self.assertFalse(run.called)
self.assertEqual(self.target.read_bytes(), SOURCE)
self.assertFalse((self.directory / 'candidate.py').exists())
self.assertFalse((self.directory / 'job.json').exists())
def test_newer_version_is_offered_and_installed(self):
newer = versioned_source(CURRENT_VERSION + 1)
with mock.patch.object(hub.urllib.request, 'urlopen', return_value=self.response(newer)):
self.manager._check()
self.assertTrue(self.manager.snapshot()['available'])
self.assertFalse(self.manager.snapshot()['source_older'])
with mock.patch.object(hub.subprocess, 'run'):
job = self.manager.start(self.manager.remote_revision)
with mock.patch.object(hub.time, 'sleep'), mock.patch.object(hub.subprocess, 'run'), \
mock.patch.object(hub, 'hub_update_health', return_value=True):
self.assertEqual(hub.run_hub_update_worker(job['id'], self.directory, self.target), 0)
self.assertEqual(self.target.read_bytes(), newer)
self.assertEqual(hub.hub_update_state(self.directory)['status'], 'succeeded')
def test_worker_rejects_a_downgrade_job_before_replacing_or_restarting(self):
job = self.prepare()
older = versioned_source(CURRENT_VERSION - 1)
(self.directory / 'candidate.py').write_bytes(older)
job.update(revision=hashlib.sha256(older).hexdigest(), version=hub.hub_update_version(older))
hub.hub_update_state(self.directory, job)
with mock.patch.object(hub.time, 'sleep'), mock.patch.object(hub.subprocess, 'run') as run:
self.assertEqual(hub.run_hub_update_worker(job['id'], self.directory, self.target), 1)
self.assertFalse(run.called)
self.assertEqual(self.target.read_bytes(), SOURCE)
self.assertFalse((self.directory / 'previous.py').exists())
self.assertFalse((self.directory / 'candidate.py').exists())
self.assertIn('Понижение версии', hub.hub_update_state(self.directory)['message'])
def test_timeout_and_https_downgrade_never_modify_target(self):
with mock.patch.object(hub.urllib.request, 'urlopen', side_effect=TimeoutError('DNS/TLS timeout')):
self.manager._check()
+23 -2
View File
@@ -10,7 +10,7 @@ execFileSync(process.env.TEST_PYTHON || 'python', ['tests/test_vps_resources.py'
const pageHtml = fs.readFileSync(path.join(output, 'dashboard.html'), 'utf8');
function state() {
return {ok:true,checked:true,checking:false,error:'',source:'https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main',
current_revision:'a'.repeat(64),remote_revision:'b'.repeat(64),remote_version:'v118',available:true,job:{},csrf:'test-csrf'};
current_revision:'a'.repeat(64),current_version:'v119',remote_revision:'b'.repeat(64),remote_version:'v119',source_older:false,available:true,job:{},csrf:'test-csrf'};
}
async function createFixture(browser,width,height,mobile) {
const page = await browser.newPage({viewport:{width,height},isMobile:mobile,hasTouch:mobile});
@@ -83,7 +83,28 @@ async function createFixture(browser,width,height,mobile) {
await page.evaluate(()=>window.dispatchEvent(new Event('pageshow')));
await page.waitForFunction(()=>document.querySelector('[data-hub-update]').dataset.updateState==='current');
assert.equal(await button.evaluate(el=>getComputedStyle(el).color),'rgb(187, 247, 208)','current build is green');
assert.equal(await button.textContent(),'Обновление не требуется');
assert(await notice.isHidden(),'current build has no separate notice on desktop or mobile');
assert.equal(await notice.textContent(),'','previous update notice is cleared');
const checks=fixture.checks;
await button.click();
assert.equal(fixture.checks,checks+1,'current build button still checks for updates');
assert(await notice.isHidden(),'manual check of current build leaves no banner');
await page.screenshot({path:path.join(output,'current-'+width+'.png'),fullPage:false});
fixture.data.source_older=true;
fixture.data.remote_version='v'+(Number(fixture.data.current_version.slice(1))-1);
fixture.data.remote_revision='d'.repeat(64);
await page.evaluate(()=>window.dispatchEvent(new Event('pageshow')));
await page.waitForFunction(()=>document.querySelector('[data-hub-update]').title.includes('Более старая версия'));
assert.equal(await button.textContent(),'Обновление не требуется');
assert.equal(await button.getAttribute('data-update-state'),'current');
assert(await notice.isHidden(),'older published version never produces an update banner');
fixture.data.remote_version='v'+(Number(fixture.data.current_version.slice(1))-2);
await button.click();
await page.waitForFunction(version=>document.querySelector('[data-hub-update]').title.includes('в источнике '+version),fixture.data.remote_version);
assert.equal(fixture.starts,0,'older source only permits checking, never installation');
assert(await page.locator('#hubUpdateConfirm').isHidden(),'older source never asks to install');
fixture.data.source_older=false;fixture.data.remote_version=fixture.data.current_version;
fixture.data.error='Не удалось проверить обновление: Сборка в источнике ещё не поддерживает проверяемое обновление из панели.';
await page.evaluate(()=>window.dispatchEvent(new Event('pageshow')));
await page.waitForFunction(()=>document.querySelector('[data-hub-update]').dataset.updateState==='error');
@@ -122,7 +143,7 @@ async function createFixture(browser,width,height,mobile) {
await page.waitForFunction(()=>document.getElementById('hubUpdateNotice').dataset.result==='succeeded',null,{timeout:6000});
await page.waitForTimeout(1700);
assert.equal(fixture.views,2,'exactly one automatic page reload');
await page.waitForFunction(()=>document.getElementById('hubUpdateNotice').textContent==='У вас последняя версия панели, обновление не требуется.');
await page.waitForFunction(()=>document.querySelector('[data-hub-update]').textContent==='Обновление не требуется'&&document.getElementById('hubUpdateNotice').hidden);
assert.equal(await button.getAttribute('data-update-state'),'current','updated build is current after reload');
await page.waitForTimeout(1700);assert.equal(fixture.views,2,'successful old job must not cause reload loop');
assert.equal(fixture.starts,1,'reconnect never resends install');
+1 -1
View File
@@ -29,7 +29,7 @@ class CollectorDeploymentTests(unittest.TestCase):
text = (ROOT / 'vps/deploy-log-collector-fix.ps1').read_text(encoding='utf-8')
self.script = text.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
mapping = {target: (self.root / target.lstrip('/')).as_posix() for target in self.targets.values()}
mapping['/root/owrt-remote-backup-before-log-collector-v118'] = self.backup.as_posix()
mapping['/root/owrt-remote-backup-before-log-collector-v119'] = self.backup.as_posix()
pattern = '|'.join(re.escape(path) for path in sorted(mapping, key=len, reverse=True))
self.script = re.sub(pattern, lambda m: mapping[m.group()], self.script)
mocks = r'''
+3 -3
View File
@@ -42,7 +42,7 @@ class PersistentLogsDeploymentTests(unittest.TestCase):
mappings['/etc/init.d/rpcd'] = (self.root / 'etc/init.d/rpcd').as_posix()
mappings['/etc/init.d/uhttpd'] = (self.root / 'etc/init.d/uhttpd').as_posix()
mappings['/tmp/owrt-remote-logs'] = (self.root / 'journal').as_posix()
mappings['/root/owrt-remote-backup-before-persistent-logs-v118'] = self.backup.as_posix()
mappings['/root/owrt-remote-backup-before-persistent-logs-v119'] = self.backup.as_posix()
pattern = '|'.join(re.escape(target) for target in sorted(mappings, key=len, reverse=True))
self.script = re.sub(pattern, lambda match: mappings[match.group()], self.script)
# Existing sandbox service scripts only print markers. Mock readiness.
@@ -102,7 +102,7 @@ logger() { printf '%s\\n' "$3" | sh "$TEST_LOG_HELPER" append; }
self.assertIn('PERSISTENT_LOGS_ROUTER_Install_OK', result.stdout)
for item in ('cgi', 'luci'):
installed = self.root / self.targets[item].lstrip('/')
self.assertIn('v118', installed.read_text(encoding='utf-8'))
self.assertIn('v119', installed.read_text(encoding='utf-8'))
for item, data in self.initial.items():
self.assertEqual(self.backup.joinpath(item).read_bytes(), data)
result = self.deploy('Rollback')
@@ -129,7 +129,7 @@ logger() { printf '%s\\n' "$3" | sh "$TEST_LOG_HELPER" append; }
self.assert_initial()
def test_rollback_restores_existing_log_service_and_helper(self):
# This fix is normally applied on top of v118's already installed journal.
# This fix is normally applied on top of v119's already installed journal.
for item in ('logs.sh', 'logs-init'):
target = self.root / self.targets[item].lstrip('/')
target.parent.mkdir(parents=True, exist_ok=True)
+2 -2
View File
@@ -20,7 +20,7 @@ class VpsLogDeployTests(unittest.TestCase):
self.target = self.root / 'hub.py'
self.previous = b'print("previous Hub")\n'
self.target.write_bytes(self.previous)
self.backup = self.root / 'hub.py.bak-before-persistent-logs-sync-v118'
self.backup = self.root / 'hub.py.bak-before-persistent-logs-sync-v119'
source = (ROOT / 'vps/deploy-persistent-logs-vps.ps1').read_text(encoding='utf-8')
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace('/opt/owrt-remote/owrt-remote-hub.py', self.target.as_posix())
@@ -73,7 +73,7 @@ sleep() { return 0; }
for _ in range(2):
result = self.deploy('Install')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertIn('PERSISTENT_LOGS_VPS_V118_Install_OK', result.stdout)
self.assertIn('PERSISTENT_LOGS_VPS_V119_Install_OK', result.stdout)
self.assertIn(b'def receive_router_logs(', self.target.read_bytes())
self.assertEqual(self.backup.read_bytes(), self.previous)
result = self.deploy('Rollback')
+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"v118" in self.request("/")
assert b"v119" in self.request("/")
self.app.snapshot_router_states()
def __exit__(self, *args):
+2 -2
View File
@@ -21,7 +21,7 @@ class RouterUpdatesDeployTests(unittest.TestCase):
self.target = self.root / 'hub.py'
self.previous = b'print("previous Hub")\n'
self.target.write_bytes(self.previous)
self.backup = self.root / 'hub.py.bak-before-router-reboot-all-v118'
self.backup = self.root / 'hub.py.bak-before-router-reboot-all-v119'
source = (ROOT / 'vps/deploy-router-updates.ps1').read_text(encoding='utf-8')
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace('/opt/owrt-remote/owrt-remote-hub.py', self.target.as_posix())
@@ -56,7 +56,7 @@ sleep() { return 0; }
for _ in range(2):
result = self.deploy('Install')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertIn('ROUTER_UPDATES_V118_Install_OK', result.stdout)
self.assertIn('ROUTER_UPDATES_V119_Install_OK', result.stdout)
self.assertIn(b'class RouterUpdateManager:', self.target.read_bytes())
self.assertEqual(self.backup.read_bytes(), self.previous)
result = self.deploy('Rollback')
+139
View File
@@ -0,0 +1,139 @@
"""Do not confirm a local UI install when HTTP still serves another build."""
import hashlib
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
import json
import os
from pathlib import Path
import shutil
import subprocess
import sys
import tempfile
import threading
import unittest
ROOT = Path(__file__).resolve().parents[1]
GIT_BIN = Path(os.environ.get('ProgramFiles', 'C:/Program Files')) / 'Git/usr/bin'
SH = str(GIT_BIN / 'sh.exe') if os.name == 'nt' else shutil.which('sh')
@unittest.skipUnless(SH, 'POSIX shell required')
class UpdateStatusDeployTests(unittest.TestCase):
deploy_file = 'deploy-update-status-ui.ps1'
backup_name = 'hub.py.bak-before-update-status-ui-v119'
success_marker = 'UPDATE_STATUS_UI_V119_Install_OK'
def setUp(self):
self.temp = tempfile.TemporaryDirectory(prefix='update-status-ui-')
self.addCleanup(self.temp.cleanup)
self.root = Path(self.temp.name)
self.target = self.root / 'hub.py'
self.previous = b'print("previous Hub")\n'
self.target.write_bytes(self.previous)
self.backup = self.root / self.backup_name
self.running_revision = None
self.report_revision = True
self.request_paths = []
test = self
class HealthHandler(BaseHTTPRequestHandler):
def do_GET(self):
test.request_paths.append(self.path)
data = {'ok': True}
if test.report_revision:
data['revision'] = (test.running_revision or
hashlib.sha256(test.target.read_bytes()).hexdigest())
body = json.dumps(data).encode()
self.send_response(200)
self.send_header('Content-Length', str(len(body)))
self.end_headers()
self.wfile.write(body)
def log_message(self, *args):
pass
self.server = ThreadingHTTPServer(('127.0.0.1', 0), HealthHandler)
self.thread = threading.Thread(target=self.server.serve_forever, daemon=True)
self.thread.start()
self.addCleanup(self.close_server)
source = (ROOT / 'vps' / self.deploy_file).read_text(encoding='ascii')
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace('/opt/owrt-remote/owrt-remote-hub.py', self.target.as_posix())
self.script = self.script.replace('python_bin=/opt/owrt-remote/venv/bin/python',
'python_bin="' + Path(sys.executable).as_posix() + '"')
self.script = self.script.replace('[ -x "$python_bin" ] || python_bin=python3', '')
self.script = self.script.replace('http://127.0.0.1:8088',
'http://127.0.0.1:' + str(self.server.server_port))
mocks = '''
systemctl() { return 0; }
journalctl() { echo sandbox-journal; }
sleep() { return 0; }
'''
self.script = self.script.replace('test -s "$target"', mocks + '\ntest -s "$target"', 1)
self.env = dict(os.environ)
if os.name == 'nt':
self.env['PATH'] = str(GIT_BIN) + os.pathsep + self.env['PATH']
def close_server(self):
self.server.shutdown()
self.server.server_close()
self.thread.join(timeout=5)
def deploy(self, action, candidate=None):
stage = self.root / 'stage'
stage.mkdir()
if action == 'Install':
stage.joinpath('hub.py').write_bytes(candidate if candidate is not None else
(ROOT / 'vps/owrt-remote-hub.py').read_bytes())
script = self.script.replace('stage=/tmp/__UPLOAD_NAME__', 'stage="' + stage.as_posix() + '"')
script = script.replace('__UPLOAD_NAME__', 'sandbox').replace('__ACTION__', action)
result = subprocess.run([SH], input=script, encoding='utf-8', capture_output=True,
env=self.env, timeout=30)
self.assertFalse(stage.exists(), 'temporary HTTP output and upload are cleaned up')
self.assertFalse(list(self.root.glob('*.new-sandbox')))
return result
def test_install_and_rollback_confirm_running_revision_and_preserve_backup(self):
for _ in range(2):
result = self.deploy('Install')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertIn(self.success_marker, result.stdout)
self.assertIn(hashlib.sha256(self.target.read_bytes()).hexdigest(), result.stdout)
self.assertEqual(self.backup.read_bytes(), self.previous)
result = self.deploy('Rollback')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(self.target.read_bytes(), self.previous)
self.assertTrue(all(path == '/health?panel-update=1' for path in self.request_paths))
def test_old_running_build_is_rejected_despite_ok_health_and_file_replacement(self):
self.running_revision = hashlib.sha256(self.previous).hexdigest()
result = self.deploy('Install')
self.assertNotEqual(result.returncode, 0)
self.assertNotIn(self.success_marker, result.stdout)
self.assertIn('Running Hub revision does not match', result.stderr)
self.assertIn(self.running_revision, result.stderr)
self.assertEqual(self.target.read_bytes(), self.previous)
self.assertEqual(self.backup.read_bytes(), self.previous)
def test_health_without_revision_cannot_confirm_install(self):
self.report_revision = False
result = self.deploy('Install')
self.assertNotEqual(result.returncode, 0)
self.assertIn('(not reported)', result.stderr)
self.assertEqual(self.target.read_bytes(), self.previous)
def test_invalid_candidate_never_replaces_working_file(self):
result = self.deploy('Install', candidate=b'if invalid:\n')
self.assertNotEqual(result.returncode, 0)
self.assertFalse(self.backup.exists())
self.assertEqual(self.target.read_bytes(), self.previous)
self.assertFalse(self.request_paths)
class VersionDeployTests(UpdateStatusDeployTests):
deploy_file = 'deploy-version-v119.ps1'
backup_name = 'hub.py.bak-before-v119'
success_marker = 'HUB_V119_Install_OK'
if __name__ == '__main__':
unittest.main()
+1 -1
View File
@@ -35,7 +35,7 @@ class WanDnsDeploymentTests(unittest.TestCase):
source = (ROOT / "vps/deploy-wan-dns-fix.ps1").read_text(encoding="utf-8")
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace("target=/usr/lib/owrt-remote/wan.sh", "target=" + shlex.quote(self.target.as_posix()))
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-wan-dns-v118",
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-wan-dns-v119",
"backup_dir=" + shlex.quote(self.backup.as_posix()))
def deploy(self, action="Install", bad=False, fail_verify=False, fail_signal=False):
+1 -1
View File
@@ -25,7 +25,7 @@ class WanRecoveryDeploymentTests(unittest.TestCase):
self.env["PATH"] = str(GIT_BIN) + os.pathsep + self.env["PATH"]
source = (ROOT / "vps/deploy-wan-recovery-fix.ps1").read_text(encoding="utf-8")
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-wan-recovery-v118",
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-wan-recovery-v119",
"backup_dir=" + shlex.quote(self.backup.as_posix()))
self.script = self.script.replace("printf /usr/lib/owrt-remote/wan.sh", "printf %s " + shlex.quote(self.targets["wan.sh"].as_posix()))
self.script = self.script.replace("printf /usr/sbin/owrt-remote", "printf %s " + shlex.quote(self.targets["agent"].as_posix()))
+1 -1
View File
@@ -31,7 +31,7 @@ class WanStabilityRollbackTests(unittest.TestCase):
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-v118', 'backup=' + shlex.quote(self.backup.as_posix()))
script = script.replace('backup=/root/owrt-remote-backup-before-wan-stability-v119', '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()) + ' ;;')
+1 -1
View File
@@ -28,7 +28,7 @@ class XrayBootDeploymentTests(unittest.TestCase):
source = (ROOT / 'vps/deploy-xray-boot-fix.ps1').read_text(encoding='utf-8')
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace('target=/usr/sbin/owrt-remote', 'target=' + shlex.quote(self.target.as_posix()))
self.script = self.script.replace('backup_dir=/root/owrt-remote-backup-before-xray-boot-v118',
self.script = self.script.replace('backup_dir=/root/owrt-remote-backup-before-xray-boot-v119',
'backup_dir=' + shlex.quote(self.backup.as_posix()))
def deploy(self, action='Install', bad=False, fail_verify=False, fail_prepare=False,
+51 -14
View File
@@ -4,12 +4,13 @@ OWRT_TEST_BUSYBOX selects real BusyBox ash and its built-in applets.
"""
import gzip
import hashlib
import io
import os
from pathlib import Path
import shlex
import subprocess
import tarfile
import unittest
import zipfile
import test_host_policy as base
@@ -28,8 +29,9 @@ class XrayBootstrapTests(unittest.TestCase):
self.env['PATH'] = str(Path(base.SH).parent) + os.pathsep + os.environ['PATH']
self.mocks = r'''
xray_cache_dir() { printf '%s' "$TEST_ROOT/flash"; }
xray_release_asset() { printf Xray-linux-arm64-v8a.zip; }
xray_release_asset() { printf openwrt-xray_26.10.21-1_aarch64_cortex-a53.ipk; }
xray_arch() { printf aarch64; }
xray_package_extract_binary() { cp "$TEST_ROOT/release.pkg" "$2"; }
ensure_ca_certificates() { return 0; }
ensure_fetch_tool() { return 0; }
'''
@@ -56,16 +58,55 @@ xray_process_start() { [ "$1" != "$$" ] || printf 1; }
return subprocess.run(args + [script.as_posix()], capture_output=True, encoding='utf-8',
env={**self.env, **env}, timeout=40)
def raw_shell(self, commands, mocks='', **env):
shell = os.environ.get('OWRT_TEST_BUSYBOX', base.SH)
args = [shell, 'ash'] if 'busybox' in shell.lower() else [shell]
script = self.directory / 'raw-run.sh'
script.write_text(self.agent + '\n' + base.MOCKS + '\n' + mocks + '\n' + commands,
encoding='utf-8', newline='\n')
return subprocess.run(args + [script.as_posix()], capture_output=True, encoding='utf-8',
env={**self.env, **env}, timeout=40)
def make_binary(self, text='Xray test version'):
data = f'#!/bin/sh\ncase "$1" in version) echo "{text}" ;; *) exit 0 ;; esac\n'.encode()
self.binary.write_bytes(data)
self.binary.chmod(0o755)
return data
def test_yichya_asset_uses_openwrt_opkg_architecture(self):
result = self.raw_shell('xray_release_asset', mocks=r'''
opkg() {
[ "$1" = print-architecture ] || return 1
printf '%s\n' 'arch all 1' 'arch noarch 1' 'arch aarch64_cortex-a53 10'
}
''')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(result.stdout.strip().splitlines()[-1],
'openwrt-xray_26.10.21-1_aarch64_cortex-a53.ipk')
def test_yichya_ipk_extracts_only_usr_bin_xray(self):
binary = self.make_binary('package')
inner = io.BytesIO()
with tarfile.open(fileobj=inner, mode='w') as archive:
entry = tarfile.TarInfo('./usr/bin/xray')
entry.mode = 0o755
entry.size = len(binary)
archive.addfile(entry, io.BytesIO(binary))
data = gzip.compress(inner.getvalue())
outer = io.BytesIO()
with tarfile.open(fileobj=outer, mode='w') as archive:
entry = tarfile.TarInfo('./data.tar.gz')
entry.size = len(data)
archive.addfile(entry, io.BytesIO(data))
(self.directory / 'release.pkg').write_bytes(gzip.compress(outer.getvalue()))
result = self.raw_shell('xray_package_extract_binary "$TEST_ROOT/release.pkg" "$TEST_ROOT/extracted"')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual((self.directory / 'extracted').read_bytes(), binary)
def cache(self, data=None):
data = data or self.make_binary()
self.store.mkdir(exist_ok=True)
path = self.store / ('Xray-linux-arm64-v8a.zip.' + hashlib.sha256(data).hexdigest() + '.gz')
path = self.store / ('openwrt-xray_26.10.21-1_aarch64_cortex-a53.ipk.' + hashlib.sha256(data).hexdigest() + '.gz')
path.write_bytes(gzip.compress(data))
return path
@@ -122,10 +163,10 @@ xray_process_start() { [ "$1" != "$$" ] || printf 1; }
self.assertEqual(gzip.decompress(cached.read_bytes()), data)
self.assert_clean()
def test_invalid_zip_preserves_working_binary_and_cache(self):
def test_invalid_package_preserves_working_binary_and_cache(self):
data = self.make_binary()
cached = self.cache(data)
result = self.shell('install_xray_tmp', mocks='fetch_file() { echo invalid >"$2"; }')
result = self.shell('install_xray_tmp', mocks='fetch_file() { echo invalid >"$2"; }; xray_package_extract_binary() { return 1; }')
self.assertNotEqual(result.returncode, 0)
self.assertEqual(self.binary.read_bytes(), data)
self.assertTrue(cached.exists())
@@ -136,15 +177,12 @@ xray_process_start() { [ "$1" != "$$" ] || printf 1; }
cached = self.cache(old)
new = self.make_binary('new')
self.binary.write_bytes(old)
with zipfile.ZipFile(self.directory / 'release.zip', 'w') as archive:
archive.writestr('xray', new)
archive.writestr('../should-not-extract', 'no')
result = self.shell('install_xray_tmp', mocks='fetch_file() { cp "$TEST_ROOT/release.zip" "$2"; }')
(self.directory / 'release.pkg').write_bytes(new)
result = self.shell('install_xray_tmp', mocks='fetch_file() { cp "$TEST_ROOT/release.pkg" "$2"; }')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(self.binary.read_bytes(), new)
self.assertFalse(cached.exists())
self.assertEqual(len(list(self.store.glob('*.gz'))), 1)
self.assertFalse((self.directory / 'should-not-extract').exists())
self.assert_clean()
def test_full_or_unmounted_flash_never_breaks_existing_xray(self):
@@ -212,11 +250,10 @@ sleep() { printf '%s\n' "$1" >>"$TEST_ROOT/delays"; }
def test_two_concurrent_preparations_download_once_and_release_lock(self):
data = self.make_binary()
self.binary.unlink()
with zipfile.ZipFile(self.directory / 'release.zip', 'w') as archive:
archive.writestr('xray', data)
(self.directory / 'release.pkg').write_bytes(data)
script = self.directory / 'parallel.sh'
script.write_text(self.agent + '\n' + base.MOCKS + '\n' + self.mocks + r'''
fetch_file() { echo download >>"$TEST_ROOT/downloads"; sleep 2; cp "$TEST_ROOT/release.zip" "$2"; }
fetch_file() { echo download >>"$TEST_ROOT/downloads"; sleep 2; cp "$TEST_ROOT/release.pkg" "$2"; }
ensure_xray_available
''', encoding='utf-8', newline='\n')
processes = [subprocess.Popen([base.SH, script.as_posix()], env=self.env, stdout=subprocess.PIPE,
@@ -253,7 +290,7 @@ curl() {
def test_each_download_redirect_uses_wan_dns_and_keeps_tls_verification(self):
self.config(wan_direct='1')
result = self.shell('fetch_file https://github.com/XTLS/release.zip "$TEST_ROOT/download"',
result = self.shell('fetch_file https://github.com/yichya/openwrt-xray/releases/download/v26.10.21/openwrt-xray_26.10.21-1_aarch64_cortex-a53.ipk "$TEST_ROOT/download"',
mocks=self.CURL_MOCK, http_proxy='', https_proxy='')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual((self.directory / 'resolved').read_text().splitlines(),
+1 -1
View File
@@ -29,7 +29,7 @@ class XrayMobileDeploymentTests(unittest.TestCase):
source = (ROOT / "vps/deploy-xray-mobile-fix.ps1").read_text(encoding="utf-8")
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace("target=/www/cgi-bin/owrt-remote", "target=" + shlex.quote(self.target.as_posix()))
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-xray-mobile-v118",
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-xray-mobile-v119",
"backup_dir=" + shlex.quote(self.backup_dir.as_posix()))
def deploy(self, action, content=None, fail_verify=False):
+1 -1
View File
@@ -25,7 +25,7 @@ class XrayValidationDeploymentTests(unittest.TestCase):
self.env["PATH"] = str(GIT_BIN) + os.pathsep + self.env["PATH"]
source = (ROOT / "vps/deploy-xray-validation-fix.ps1").read_text(encoding="utf-8")
self.script = source.split("$RemoteScript = @'\n", 1)[1].split("\n'@", 1)[0]
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-xray-validation-v118",
self.script = self.script.replace("backup_dir=/root/owrt-remote-backup-before-xray-validation-v119",
"backup_dir=" + shlex.quote(self.backup.as_posix()))
self.script = self.script.replace("printf /www/cgi-bin/owrt-remote", "printf %s " + shlex.quote(self.targets["cgi"].as_posix()))
self.script = self.script.replace("printf /usr/sbin/owrt-remote", "printf %s " + shlex.quote(self.targets["agent"].as_posix()))