Fix OpenWrt Xray release discovery and installer diagnostics
This commit is contained in:
1 parent
6cf3ae7c0f
commit
edbc86697a
13 files changed
+1030
-278
No files matched your search
@@ -7,8 +7,9 @@
|
||||
не защищает отдельное VLESS-соединение на 8443.
|
||||
|
||||
Локальное исправление сохраняет существующий протокол и VPS-конфигурацию.
|
||||
По умолчанию используется последняя сборка до запрета — **26.6.27** из
|
||||
`yichya/openwrt-xray`. TLS/REALITY этим исправлением не добавляются; для
|
||||
Сборка выбирается из опубликованных GitHub Releases до запрета транспорта;
|
||||
версия не закреплена. Источник — `yichya/openwrt-xray`.
|
||||
TLS/REALITY этим исправлением не добавляются; для
|
||||
использования 26.7.11+ нужен отдельный согласованный переход обоих концов.
|
||||
|
||||
Источники проверки:
|
||||
@@ -23,7 +24,8 @@
|
||||
включая ARM64, MIPSel и особые имена `i386_pentium`/`arm_cortex-a5-vfpv4`.
|
||||
- Найденный работающий старый core сохраняется. Известный core 26.7.11+
|
||||
для `encryption=none` заменяется совместимым: сначала проверенный boot-кэш,
|
||||
затем загрузка закреплённого пакета. Ошибка сети не удаляет старый бинарник.
|
||||
затем поиск существующего совместимого пакета через GitHub Releases API.
|
||||
Ошибка сети не удаляет старый бинарник.
|
||||
- До замены runtime/кэша/UCI кандидат выполняет `-test` на несекретной пробной
|
||||
конфигурации публичного VLESS reverse. `xray version` больше недостаточно.
|
||||
- Возвращаемый на Flash core также проверяется перед установкой в RAM.
|
||||
@@ -156,7 +158,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\
|
||||
Откат возвращает агент, сохраняя подготовленный бинарник и boot-кэш.
|
||||
Рабочий JSON не пересобирается, туннель не перезапускается.
|
||||
|
||||
Тесты проверяют полный bootstrap с форматом APK и временным именем `.pkg`,
|
||||
Тесты проверяют полный bootstrap с форматом APK и выбором распаковщика по asset,
|
||||
неудачное извлечение, отсутствие бинарника, несовместимого кандидата и IPK.
|
||||
В тестах shell работает настоящий BusyBox ash, вызов `apk` заменён тестовым
|
||||
обработчиком. Настоящий APK скачан и его формат проверен; запуск нативного
|
||||
|
||||
@@ -0,0 +1,115 @@
|
||||
# Поиск совместимого Xray: локальное исправление v121
|
||||
|
||||
## Подтверждённая причина
|
||||
|
||||
Прежний загрузчик строил имя APK из закреплённой версии и вывода
|
||||
`apk --print-arch`. В некоторых OpenWrt 25 этот вывод — общий ABI `mipsel`,
|
||||
а опубликованный asset называется `...-mipsel_24kc.apk`. Получался URL
|
||||
несуществующего `...-mipsel.apk`, и GitHub возвращал 404.
|
||||
|
||||
В ответе [GitHub Releases API](https://api.github.com/repos/yichya/openwrt-xray/releases)
|
||||
найден настоящий `openwrt-xray-26.6.27-r1-mipsel_24kc.apk`; скачанный файл
|
||||
имеет SHA256
|
||||
`275e6f1141796e057befb0d3b8daa33a3731e22da9d749d6edc0290950dc6c80`,
|
||||
совпадающий с `digest` asset. Это проверка источника, а не закрепление версии.
|
||||
|
||||
`Command failed: Not found` до подготовки Xray соответствует безусловному
|
||||
`owrt-remote-logs restart` при первой установке: стандартный `restart`
|
||||
сначала вызывает удаление ещё не зарегистрированной службы через ubus.
|
||||
Теперь установщик останавливает службу только после успешного `running`,
|
||||
а затем выполняет `start`. Вывод Netis после исправления нужен, чтобы
|
||||
исключить дополнительную ошибку на конкретном устройстве.
|
||||
У rpcd, uhttpd и Remote также проверяется наличие работающего экземпляра:
|
||||
для первой активации используется `start`, для работающей службы — `reload`.
|
||||
|
||||
## Новый механизм
|
||||
|
||||
- Приоритет у APK; команды opkg на APK-системе не выполняются.
|
||||
- Точная архитектура берётся из менеджера пакетов. Общий ABI уточняется
|
||||
через `DISTRIB_ARCH` из `/etc/openwrt_release`, без угадывания по `uname`.
|
||||
- Загружаются реальные Releases и Assets. Порядок JSON и номер ревизии пакета
|
||||
не зашиты в код. Обрабатываются до десяти страниц по 20 релизов; временные
|
||||
ответы и число запросов ограничены. Если кандидаты не проходят проверку,
|
||||
поиск продолжается на следующей странице с более старыми релизами.
|
||||
При успешном кандидате лишние страницы не загружаются.
|
||||
- Draft, prerelease, чужие URL, другой CPU, отсутствие SHA256 и слишком
|
||||
большой пакет отклоняются. URL проверяется HEAD перед GET при наличии curl;
|
||||
для минимальных клиентов проверкой доступности служит ограниченный GET.
|
||||
- Для существующего VLESS reverse без TLS исключаются версии с известным
|
||||
запретом транспорта (26.7.11+). Это граница совместимости, а не версия
|
||||
скачивания. Дополнительно каждый кандидат выполняет настоящий `-test`.
|
||||
- Проверяются размер и SHA256 пакета, метаданные, ABI и зависимости.
|
||||
APK проверяет нативный solver: `apk add --simulate --no-network`.
|
||||
Он не устанавливает скачанный пакет. APK извлекается через `apk extract`;
|
||||
IPK — в отдельный каталог. Системный `/usr/bin/xray` не перезаписывается.
|
||||
- Версия исполняемого бинарника должна совпасть с релизом. Его запуск
|
||||
проверяет совместимость с ABI/прошивкой, а не только совпадение имени CPU.
|
||||
- Проверенный сжатый boot-кэш публикуется атомарно на постоянном разделе
|
||||
до замены runtime. Кэш проверяется распаковкой и SHA256. Без места или
|
||||
доступного постоянного раздела подготовка завершается явной ошибкой.
|
||||
- Рабочий core используется без повторной загрузки; после перезагрузки
|
||||
проверенный кэш восстанавливается без сети/API. Старые имена кэша читаются.
|
||||
- Ошибки загрузки, распаковки и проверки сохраняют прежний бинарник,
|
||||
рабочий JSON и `/etc/config/owrtremote`. Откат локального исправления
|
||||
возвращает код агента, сохраняя подготовленный core и boot-кэш.
|
||||
|
||||
## Диагностика установщика
|
||||
|
||||
`OWRT_REMOTE_INSTALL_DIAGNOSTIC=1 sh install.sh` показывает этап, команду,
|
||||
rc и отдельные stdout/stderr. При ошибке эти сведения выводятся и без
|
||||
диагностического режима; последующие критические этапы не выполняются.
|
||||
Вывод каждого потока ограничен 32 КиБ. Shell xtrace не включается.
|
||||
Файлы проекта сначала загружаются/копируются во временный файл в каталоге
|
||||
назначения и заменяются атомарно. Ошибка загрузки не обрезает прежний агент.
|
||||
|
||||
После подготовки Xray установщик для уже включённого клиента проверяет JSON,
|
||||
запуск процесса и Heartbeat. Исходный UCI сохраняется. Первая установка с
|
||||
`enabled=0` сообщает, что для соединения необходим OpenWrt config из Hub.
|
||||
Намеренную остановку Xray через Remote установщик уважает.
|
||||
|
||||
Диагностика без ключей: `owrt-remote xray-package-diagnostics`.
|
||||
|
||||
## Установка локального исправления и откат
|
||||
|
||||
Подставить доступный SSH-адрес удалённого роутера вместо `АДРЕС_РОУТЕРА`:
|
||||
|
||||
```powershell
|
||||
$Fix = "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-release-fix.ps1"
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router "root@АДРЕС_РОУТЕРА" -Action Install
|
||||
```
|
||||
|
||||
Резервная копия: `/root/owrt-remote-backup-before-xray-release-v121`.
|
||||
Устанавливается агент и выполняется подготовка core/кэша. Рабочий JSON
|
||||
не пересобирается, туннель этим скриптом не перезапускается. При прерванной
|
||||
первой установке создаётся отсутствующий web.key; имеющийся ключ сохраняется.
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $Fix -Router "root@АДРЕС_РОУТЕРА" -Action Rollback
|
||||
```
|
||||
|
||||
## Проверки и ограничения
|
||||
|
||||
- `test_xray_release_selection.py`: реальное уточнение CPU/ABI, выбор asset,
|
||||
ревизии, пагинация, несовместимый CPU, metadata, dependency solver,
|
||||
ошибки API и некорректный JSON.
|
||||
- `test_xray_bootstrap.py`: SHA256, повреждённый пакет/кэш, HTTP-ошибка,
|
||||
переход к следующему asset, отсутствие сети, сохранение старого core,
|
||||
офлайн-восстановление после удаления RAM-копии, конкурирующие установки.
|
||||
- `test_install_diagnostics.py`: повторная установка в изолированный ROOT,
|
||||
сохранение UCI, этап/команда/rc/stdout/stderr, остановка после ошибки.
|
||||
- `test_xray_release_deploy.py`: установка, откат и автоматическое
|
||||
восстановление кода при ошибке подготовки.
|
||||
- Синтаксис и тесты shell проверяются MSYS sh и BusyBox ash на Windows.
|
||||
|
||||
Результат локального прогона выбора релизов, bootstrap, проверки конфигурации
|
||||
и установки/отката: 76 тестов, 70 успешно, 6 пропущены (четыре требуют
|
||||
внешних настоящих бинарников Xray, два требуют Linux /proc для проверки
|
||||
дочерних процессов и конкуренции). Эти два сценария отдельно проходили
|
||||
в MSYS sh. После добавления атомарной установки и выбора start/reload
|
||||
повторно прошли все 5 тестов установщика. Shell syntax и PowerShell parser
|
||||
ошибок не обнаружили.
|
||||
|
||||
Физического Netis N6 в этой среде нет. Нативные `apk adbdump/extract`,
|
||||
бинарник Linux/MIPSel, реальная перезагрузка и успешный туннель на
|
||||
OpenWrt 25.12.2 должны быть подтверждены после установки на устройстве.
|
||||
Эмуляция перезагрузки в тестах не заменяет эту проверку.
|
||||
@@ -0,0 +1,101 @@
|
||||
"""Installer stages/streams and existing configuration preservation."""
|
||||
import os
|
||||
from pathlib import Path
|
||||
import subprocess
|
||||
import tempfile
|
||||
import unittest
|
||||
import test_host_policy as base
|
||||
|
||||
|
||||
class InstallDiagnosticsTests(unittest.TestCase):
|
||||
def setUp(self):
|
||||
self.temp=tempfile.TemporaryDirectory(prefix='owrt-install-tests-')
|
||||
self.addCleanup(self.temp.cleanup)
|
||||
self.root=Path(self.temp.name)
|
||||
self.env={**os.environ,'TMPDIR':self.root.as_posix()}
|
||||
self.installer=base.ROOT/'install.sh'
|
||||
shell=os.environ.get('OWRT_TEST_BUSYBOX',base.SH)
|
||||
self.args=[shell,'ash'] if 'busybox' in shell.lower() else [shell]
|
||||
|
||||
def test_full_local_copy_preserves_existing_uci_on_repeat_install(self):
|
||||
config=self.root/'etc/config/owrtremote'
|
||||
config.parent.mkdir(parents=True)
|
||||
original=b"config remote 'main'\n option router_name 'keep custom name'\n option hub_token 'test-secret'\n"
|
||||
config.write_bytes(original)
|
||||
env={**self.env,'ROOT':self.root.as_posix()}
|
||||
for _ in range(2):
|
||||
result=subprocess.run(self.args+[self.installer.as_posix()],env=env,cwd=base.ROOT,
|
||||
capture_output=True,encoding='utf-8',timeout=30)
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertEqual(config.read_bytes(),original)
|
||||
self.assertNotIn('test-secret',result.stdout+result.stderr)
|
||||
self.assertTrue((self.root/'usr/sbin/owrt-remote').exists())
|
||||
self.assertEqual((self.root/'usr/sbin/owrt-remote').read_bytes(),
|
||||
(base.ROOT/'files/usr/sbin/owrt-remote').read_bytes())
|
||||
|
||||
def test_critical_failure_names_stage_command_rc_and_both_streams(self):
|
||||
source=self.installer.read_text(encoding='utf-8').split('# Stop the old log writer')[0]
|
||||
source+='''\nfail_command() { echo sample-stdout; echo sample-stderr >&2; return 19; }
|
||||
run_step example-phase fail_command
|
||||
echo UNREACHABLE
|
||||
'''
|
||||
script=self.root/'driver.sh'; script.write_text(source,encoding='utf-8',newline='\n')
|
||||
result=subprocess.run(self.args+[script.as_posix()],capture_output=True,encoding='utf-8',timeout=20,env=self.env)
|
||||
self.assertEqual(result.returncode,19,result.stderr)
|
||||
for text in ['example-phase','fail_command','rc=19','sample-stdout','sample-stderr']:
|
||||
self.assertIn(text,result.stderr)
|
||||
self.assertNotIn('UNREACHABLE',result.stdout)
|
||||
|
||||
def test_successful_stderr_is_available_in_diagnostic_mode(self):
|
||||
source=self.installer.read_text(encoding='utf-8').split('# Stop the old log writer')[0]
|
||||
source+='\nprobe() { echo sample-warning >&2; }; run_step probe-stage probe\n'
|
||||
script=self.root/'driver.sh'; script.write_text(source,encoding='utf-8',newline='\n')
|
||||
result=subprocess.run(self.args+[script.as_posix()],capture_output=True,encoding='utf-8',timeout=20,
|
||||
env={**self.env,'OWRT_REMOTE_INSTALL_DIAGNOSTIC':'1'})
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertIn('sample-warning',result.stderr)
|
||||
self.assertIn('rc=0',result.stderr)
|
||||
|
||||
def test_failed_file_download_preserves_installed_agent_and_cleans_staging(self):
|
||||
target=self.root/'usr/sbin/sample-agent'
|
||||
target.parent.mkdir(parents=True)
|
||||
target.write_bytes(b'working agent\n')
|
||||
source=self.installer.read_text(encoding='utf-8').split('# Stop the old log writer')[0]
|
||||
source+='''\nfetch() { echo partial-candidate >"$2"; echo 'HTTP 404' >&2; return 22; }
|
||||
install_file usr/sbin/sample-agent 0755
|
||||
echo UNREACHABLE
|
||||
'''
|
||||
script=self.root/'driver.sh'; script.write_text(source,encoding='utf-8',newline='\n')
|
||||
result=subprocess.run(self.args+[script.as_posix()],capture_output=True,encoding='utf-8',timeout=20,
|
||||
env={**self.env,'ROOT':self.root.as_posix()})
|
||||
self.assertEqual(result.returncode,22,result.stderr)
|
||||
self.assertIn('HTTP 404',result.stderr)
|
||||
self.assertEqual(target.read_bytes(),b'working agent\n')
|
||||
self.assertFalse(list(target.parent.glob('sample-agent.new.*')))
|
||||
self.assertNotIn('UNREACHABLE',result.stdout)
|
||||
|
||||
def test_web_services_start_on_first_install_and_reload_when_running(self):
|
||||
for name in ['rpcd','uhttpd']:
|
||||
helper=self.root/'etc/init.d'/name
|
||||
helper.parent.mkdir(parents=True,exist_ok=True)
|
||||
helper.write_text('''#!/bin/sh
|
||||
printf '%s %s\\n' "${0##*/}" "$1" >>"$INSTALL_CALL_LOG"
|
||||
case "$1" in
|
||||
running) [ "$SERVICE_RUNNING" = 1 ] ;;
|
||||
start|reload) exit 0 ;;
|
||||
*) echo 'unexpected service command' >&2; exit 99 ;;
|
||||
esac
|
||||
''',encoding='utf-8',newline='\n')
|
||||
helper.chmod(0o755)
|
||||
calls=self.root/'service-calls'
|
||||
for running,operation in [('0','start'),('1','reload')]:
|
||||
calls.write_text('')
|
||||
result=subprocess.run(self.args+[self.installer.as_posix()],capture_output=True,encoding='utf-8',timeout=30,
|
||||
env={**self.env,'ROOT':self.root.as_posix(),
|
||||
'INSTALL_CALL_LOG':calls.as_posix(),'SERVICE_RUNNING':running})
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertEqual(calls.read_text().splitlines(),['rpcd running','rpcd '+operation,
|
||||
'uhttpd running','uhttpd '+operation])
|
||||
|
||||
|
||||
if __name__=='__main__': unittest.main()
|
||||
@@ -31,6 +31,11 @@ class XrayBootstrapTests(unittest.TestCase):
|
||||
xray_cache_dir() { printf '%s' "$TEST_ROOT/flash"; }
|
||||
xray_release_asset() { printf openwrt-xray_26.6.27-1_aarch64_cortex-a53-aarch64_cortex-a53.ipk; }
|
||||
xray_arch() { printf aarch64; }
|
||||
xray_discover_releases() {
|
||||
printf 'v26.6.27|test.ipk|https://github.com/test|%s|%s\n' "$(xray_digest "$TEST_ROOT/release.pkg")" "$(wc -c <"$TEST_ROOT/release.pkg")" >"$1"
|
||||
}
|
||||
xray_probe_url() { return 0; }
|
||||
xray_check_package_metadata() { return 0; }
|
||||
xray_package_extract_binary() { cp "$TEST_ROOT/release.pkg" "$2"; }
|
||||
ensure_ca_certificates() { return 0; }
|
||||
ensure_fetch_tool() { return 0; }
|
||||
@@ -72,13 +77,13 @@ xray_process_start() { [ "$1" != "$$" ] || printf 1; }
|
||||
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()
|
||||
data = f'#!/bin/sh\ncase "$1" in version) echo "Xray 26.6.27 ({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'''
|
||||
result = self.raw_shell('xray_arch', mocks=r'''
|
||||
opkg() {
|
||||
[ "$1" = print-architecture ] || return 1
|
||||
printf '%s\n' 'arch all 1' 'arch noarch 1' 'arch aarch64_cortex-a53 10'
|
||||
@@ -86,7 +91,7 @@ opkg() {
|
||||
''')
|
||||
self.assertEqual(result.returncode, 0, result.stderr)
|
||||
self.assertEqual(result.stdout.strip().splitlines()[-1],
|
||||
'openwrt-xray_26.6.27-1_aarch64_cortex-a53-aarch64_cortex-a53.ipk')
|
||||
'aarch64_cortex-a53')
|
||||
|
||||
def test_yichya_ipk_extracts_only_usr_bin_xray(self):
|
||||
binary = self.make_binary('package')
|
||||
@@ -139,6 +144,12 @@ ensure_ca_certificates() { return 0; }
|
||||
ensure_fetch_tool() { return 0; }
|
||||
xray_cache_dir() { printf '%s' "$TEST_ROOT/flash"; }
|
||||
fetch_file() { echo "$1" >>"$TEST_ROOT/downloads"; cp "$TEST_ROOT/release.pkg" "$2"; }
|
||||
xray_discover_releases() {
|
||||
printf 'v26.6.27|openwrt-xray-26.6.27-r1-aarch64_generic.apk|https://github.com/test/openwrt-xray-26.6.27-r1-aarch64_generic.apk|%s|%s\n' "$(xray_digest "$TEST_ROOT/release.pkg")" "$(wc -c <"$TEST_ROOT/release.pkg")" >"$1"
|
||||
}
|
||||
xray_probe_url() { return 0; }
|
||||
xray_check_package_metadata() { return 0; }
|
||||
|
||||
'''
|
||||
|
||||
def apk_fixture(self, binary=None):
|
||||
@@ -158,7 +169,7 @@ fetch_file() { echo "$1" >>"$TEST_ROOT/downloads"; cp "$TEST_ROOT/release.pkg" "
|
||||
self.assertIn('/openwrt-xray-26.6.27-r1-aarch64_generic.apk',
|
||||
(self.directory / 'downloads').read_text())
|
||||
self.assertTrue((self.directory / 'apk-calls').read_text().startswith('extract '))
|
||||
self.assertTrue(list(self.store.glob('openwrt-xray-26.6.27-r1-aarch64_generic.apk.*.gz')))
|
||||
self.assertTrue(list(self.store.glob('xray-aarch64_generic.*.gz')))
|
||||
self.assert_clean()
|
||||
|
||||
def test_apk_extract_failure_reports_real_reason_and_preserves_working_state(self):
|
||||
@@ -190,8 +201,8 @@ fetch_file() { echo "$1" >>"$TEST_ROOT/downloads"; cp "$TEST_ROOT/release.pkg" "
|
||||
self.apk_fixture(bad)
|
||||
original_uci = (self.directory / 'uci').read_bytes()
|
||||
result = self.raw_shell('install_xray_tmp', mocks=self.APK_EXTRACT_MOCK)
|
||||
self.assertEqual(result.returncode, 23, result.stderr)
|
||||
self.assertIn('vless without TLS', result.stderr)
|
||||
self.assertEqual(result.returncode, 1, result.stderr)
|
||||
self.assertIn('binary version does not match release', result.stderr)
|
||||
self.assertEqual(self.binary.read_bytes(), good)
|
||||
self.assertEqual((self.directory / 'uci').read_bytes(), original_uci)
|
||||
self.assert_clean()
|
||||
@@ -210,11 +221,12 @@ fetch_file() { echo "$1" >>"$TEST_ROOT/downloads"; cp "$TEST_ROOT/release.pkg" "
|
||||
self.assertFalse(list(self.runtime.glob('.compat.*')))
|
||||
self.assertFalse((self.runtime / 'xray.pkg').exists())
|
||||
self.assertFalse(list(self.runtime.glob('*.package-extract.*')))
|
||||
self.assertFalse(list(self.runtime.glob('.download.*')))
|
||||
|
||||
def test_compatible_mipsel_ipk_and_apk_asset_names(self):
|
||||
def test_cache_label_is_independent_of_download_version(self):
|
||||
for fmt, expected in (
|
||||
('ipk', 'openwrt-xray_26.6.27-1_mipsel_24kc-mipsel_24kc.ipk'),
|
||||
('apk', 'openwrt-xray-26.6.27-r1-mipsel_24kc.apk'),
|
||||
('ipk', 'xray-mipsel_24kc'),
|
||||
('apk', 'xray-mipsel_24kc'),
|
||||
):
|
||||
result = self.raw_shell('xray_release_asset', mocks=
|
||||
f'xray_arch() {{ printf mipsel_24kc; }}; xray_package_format() {{ printf {fmt}; }}')
|
||||
@@ -238,8 +250,8 @@ exit 23
|
||||
(self.directory / 'release.pkg').write_bytes(bad)
|
||||
original_uci = (self.directory / 'uci').read_bytes()
|
||||
result = self.shell('install_xray_tmp', mocks='fetch_file() { cp "$TEST_ROOT/release.pkg" "$2"; }')
|
||||
self.assertEqual(result.returncode, 23, result.stderr)
|
||||
self.assertIn('vless without TLS', result.stderr)
|
||||
self.assertEqual(result.returncode, 1, result.stderr)
|
||||
self.assertIn('binary version does not match release', result.stderr)
|
||||
self.assertEqual(self.binary.read_bytes(), good)
|
||||
self.assertEqual((self.directory / 'uci').read_bytes(), original_uci)
|
||||
self.assertTrue(cached.exists())
|
||||
@@ -365,12 +377,66 @@ fetch_file() { echo download >>"$TEST_ROOT/downloads"; cp "$TEST_ROOT/release.pk
|
||||
self.assertEqual(len(list(self.store.glob('*.gz'))), 1)
|
||||
self.assert_clean()
|
||||
|
||||
def test_release_checksum_mismatch_cannot_replace_binary_or_cache(self):
|
||||
old = self.make_binary('working')
|
||||
cached = self.cache(old)
|
||||
(self.directory / 'release.pkg').write_bytes(old)
|
||||
result = self.shell('install_xray_tmp', mocks=r'''
|
||||
xray_discover_releases() {
|
||||
printf 'v26.6.27|test.ipk|https://github.com/test|%064d|%s\n' 0 "$(wc -c <"$TEST_ROOT/release.pkg")" >"$1"
|
||||
}
|
||||
fetch_file() { cp "$TEST_ROOT/release.pkg" "$2"; }
|
||||
''')
|
||||
self.assertNotEqual(result.returncode, 0)
|
||||
self.assertIn('SHA256 mismatch', result.stderr)
|
||||
self.assertEqual(self.binary.read_bytes(), old)
|
||||
self.assertEqual(gzip.decompress(cached.read_bytes()), old)
|
||||
self.assert_clean()
|
||||
|
||||
def test_unavailable_asset_tries_next_published_candidate(self):
|
||||
data = self.make_binary('candidate')
|
||||
self.binary.unlink()
|
||||
(self.directory / 'release.pkg').write_bytes(data)
|
||||
result = self.shell('install_xray_tmp', mocks=r'''
|
||||
xray_discover_releases() {
|
||||
printf 'v26.6.27|missing.ipk|https://github.com/missing|%s|%s\n' "$(xray_digest "$TEST_ROOT/release.pkg")" "$(wc -c <"$TEST_ROOT/release.pkg")" >"$1"
|
||||
printf 'v26.6.27|published.ipk|https://github.com/published|%s|%s\n' "$(xray_digest "$TEST_ROOT/release.pkg")" "$(wc -c <"$TEST_ROOT/release.pkg")" >>"$1"
|
||||
}
|
||||
xray_probe_url() { case "$1" in */missing) return 22 ;; esac; }
|
||||
fetch_file() { cp "$TEST_ROOT/release.pkg" "$2"; }
|
||||
''')
|
||||
self.assertEqual(result.returncode, 0, result.stderr)
|
||||
self.assertIn('URL unavailable (rc=22)', result.stderr)
|
||||
self.assertEqual(self.binary.read_bytes(), data)
|
||||
self.assert_clean()
|
||||
|
||||
def test_rejected_candidates_continue_with_older_release_page(self):
|
||||
data = self.make_binary('older published candidate')
|
||||
self.binary.unlink()
|
||||
(self.directory / 'release.pkg').write_bytes(data)
|
||||
result = self.shell('install_xray_tmp', mocks=r'''
|
||||
xray_discover_releases() {
|
||||
case "$3" in
|
||||
1) asset=rejected.ipk; printf '2\n' >"$2/next-release-page" ;;
|
||||
2) asset=accepted.ipk; rm -f "$2/next-release-page" ;;
|
||||
*) return 99 ;;
|
||||
esac
|
||||
printf 'v26.6.27|%s|https://github.com/test|%s|%s\n' "$asset" "$(xray_digest "$TEST_ROOT/release.pkg")" "$(wc -c <"$TEST_ROOT/release.pkg")" >"$1"
|
||||
}
|
||||
xray_check_package_metadata() { [ "$3" != rejected.ipk ]; }
|
||||
fetch_file() { cp "$TEST_ROOT/release.pkg" "$2"; }
|
||||
''')
|
||||
self.assertEqual(result.returncode, 0, result.stderr)
|
||||
self.assertIn('searching older published releases', result.stderr)
|
||||
self.assertEqual(self.binary.read_bytes(), data)
|
||||
self.assert_clean()
|
||||
|
||||
def test_full_or_unmounted_flash_never_breaks_existing_xray(self):
|
||||
self.make_binary()
|
||||
for mock in ('xray_cache_dir() { return 1; }',
|
||||
'df() { printf "Filesystem blocks used available capacity mount\\nflash 100 99 1 99%% /overlay\\n"; }'):
|
||||
result = self.shell('prepare_xray', mocks=mock)
|
||||
self.assertEqual(result.returncode, 0, result.stderr)
|
||||
self.assertNotEqual(result.returncode, 0, result.stderr)
|
||||
self.assertTrue(self.binary.exists())
|
||||
self.assertFalse(list(self.store.glob('*.gz')))
|
||||
self.assert_clean()
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
"""Local release-selector payload install/rollback without router access."""
|
||||
import unittest
|
||||
from test_xray_apk_deploy import XrayApkDeploymentTests
|
||||
|
||||
|
||||
class XrayReleaseDeploymentTests(XrayApkDeploymentTests):
|
||||
deploy_name = 'deploy-xray-release-fix.ps1'
|
||||
backup_name = 'owrt-remote-backup-before-xray-release-v121'
|
||||
success_marker = 'XRAY_RELEASE_ROUTER_Install_OK'
|
||||
|
||||
def test_failed_xray_preparation_restores_agent_and_retains_backup(self):
|
||||
self.env['PREPARE_RC'] = '13'
|
||||
result = self.deploy('Install')
|
||||
self.assertEqual(result.returncode, 13, result.stderr)
|
||||
self.assertIn('prepare-xray-release', result.stderr)
|
||||
self.assertEqual(self.targets['agent'].read_bytes(), self.original['agent'])
|
||||
self.assertEqual(self.backup.joinpath('agent').read_bytes(), self.original['agent'])
|
||||
|
||||
|
||||
if __name__ == '__main__': unittest.main()
|
||||
@@ -0,0 +1,193 @@
|
||||
"""Release discovery/ABI/checksum regression tests using BusyBox-compatible shell.
|
||||
|
||||
No network or router credentials. Transport/cache tests are in bootstrap suite.
|
||||
"""
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
import shlex
|
||||
import subprocess
|
||||
import unittest
|
||||
|
||||
import test_xray_bootstrap as bootstrap
|
||||
import test_host_policy as base
|
||||
|
||||
|
||||
class XrayReleaseSelectionTests(unittest.TestCase):
|
||||
setUp = bootstrap.XrayBootstrapTests.setUp
|
||||
config = base.RouterShellTests.config
|
||||
shell = bootstrap.XrayBootstrapTests.raw_shell
|
||||
|
||||
def setUp(self):
|
||||
bootstrap.XrayBootstrapTests.setUp(self)
|
||||
release = self.directory / 'openwrt_release'
|
||||
release.write_text("DISTRIB_RELEASE='25.12.2'\nDISTRIB_ARCH='mipsel_24kc'\n")
|
||||
self.env['OWRT_REMOTE_RELEASE_FILE'] = release.as_posix()
|
||||
# JSON filter double supports the exact documented jsonfilter paths.
|
||||
self.query = self.directory / 'query.py'
|
||||
self.query.write_text('''import json,re,sys
|
||||
sys.stdout.reconfigure(newline='\\n')
|
||||
data=json.load(open(sys.argv[1],encoding='utf-8-sig'))
|
||||
parts=re.findall(r'\\[(\\d+|\\*)\\]|\\.([A-Za-z_]+)',sys.argv[2])
|
||||
values=[data]
|
||||
for idx,key in parts:
|
||||
out=[]
|
||||
for v in values:
|
||||
try:
|
||||
if key: out.append(v[key])
|
||||
elif idx=='*': out.extend(v)
|
||||
else: out.append(v[int(idx)])
|
||||
except (KeyError,IndexError,TypeError): pass
|
||||
values=out
|
||||
for v in values:
|
||||
print(json.dumps(v,separators=(',',':')) if not isinstance(v,str) else v)
|
||||
sys.exit(0 if values else 1)
|
||||
''')
|
||||
self.fixture = self.directory / 'api.json'
|
||||
self.fixture.write_text('[]')
|
||||
self.common = r'''
|
||||
apk() {
|
||||
case "$1" in
|
||||
--print-arch) echo "${TEST_ARCH:-mipsel}" ;;
|
||||
adbdump) cat "$TEST_ROOT/metadata.json" ;;
|
||||
add) printf '%s\n' "$*" >>"$TEST_ROOT/dependency-checks"; return "${TEST_DEP_RC:-0}" ;;
|
||||
*) return 1 ;;
|
||||
esac
|
||||
}
|
||||
opkg() { echo forbidden-opkg >&2; return 99; }
|
||||
jsonfilter() { "$TEST_PYTHON" "$TEST_ROOT/query.py" "$2" "$4"; }
|
||||
fetch_file() {
|
||||
echo "$1" >>"$TEST_ROOT/fetched"
|
||||
[ "${TEST_FETCH_RC:-0}" = 0 ] || return "$TEST_FETCH_RC"
|
||||
cp "$TEST_ROOT/api.json" "$2"
|
||||
}
|
||||
'''
|
||||
self.directory.joinpath('metadata.json').write_text(json.dumps({'info': {'name':'openwrt-xray','arch':'mipsel'}}))
|
||||
|
||||
def run_case(self, command, mocks='', **env):
|
||||
return self.shell(command, mocks=self.common + mocks, **env)
|
||||
|
||||
def asset(self, tag='v26.6.22', arch='mipsel_24kc', digest=None):
|
||||
name=f'openwrt-xray-{tag[1:]}-r1-{arch}.apk'
|
||||
return {'name':name,'state':'uploaded','size':123,
|
||||
'digest':'sha256:'+(digest or 'a'*64),
|
||||
'browser_download_url':'https://github.com/yichya/openwrt-xray/releases/download/'+tag+'/'+name}
|
||||
|
||||
def release(self, tag='v26.6.22', assets=None, **kw):
|
||||
return dict(tag_name=tag,draft=False,prerelease=False,assets=assets or [self.asset(tag)],**kw)
|
||||
|
||||
def manifest(self, releases):
|
||||
self.fixture.write_text(json.dumps(releases),encoding='utf-8')
|
||||
|
||||
def discover(self, **env):
|
||||
return self.run_case('xray_discover_releases "$TEST_ROOT/candidates" "$TEST_ROOT"; rc=$?; cat "$TEST_ROOT/candidates"; exit "$rc"',**env)
|
||||
|
||||
def test_apk_generic_abi_refined_from_openwrt_and_never_calls_opkg(self):
|
||||
result=self.run_case('xray_arch; xray_package_format')
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertEqual(result.stdout.splitlines(),['mipsel_24kc','apk'])
|
||||
self.assertNotIn('forbidden',result.stderr)
|
||||
|
||||
def test_precise_apk_architecture_remains_authoritative(self):
|
||||
result=self.run_case('xray_arch',TEST_ARCH='aarch64_cortex-a53')
|
||||
self.assertEqual(result.stdout.strip(),'aarch64_cortex-a53')
|
||||
|
||||
def test_selects_published_asset_with_checksum_not_constructed_name(self):
|
||||
item=self.asset(); item['name']=item['name'].replace('-r1-','-r7-')
|
||||
item['browser_download_url']=item['browser_download_url'].replace('-r1-','-r7-')
|
||||
self.manifest([self.release(assets=[item])])
|
||||
result=self.discover()
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertIn('-r7-mipsel_24kc.apk',result.stdout)
|
||||
self.assertIn('a'*64,result.stdout)
|
||||
self.assertNotIn('-mipsel.apk',result.stdout)
|
||||
|
||||
def test_future_plain_vless_incompatible_release_is_skipped(self):
|
||||
self.manifest([self.release('v26.10.31'),self.release('v26.6.22')])
|
||||
result=self.discover()
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertIn('v26.6.22',result.stdout)
|
||||
self.assertNotIn('v26.10.31',result.stdout)
|
||||
|
||||
def test_api_uses_json_even_when_minified_or_reordered(self):
|
||||
release=self.release()
|
||||
release=dict(reversed(list(release.items())))
|
||||
self.manifest([release])
|
||||
result=self.discover()
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
|
||||
def test_other_cpu_draft_prerelease_and_missing_digest_rejected(self):
|
||||
for changes in ({'draft':True},{'prerelease':True},
|
||||
{'assets':[self.asset(arch='mipsel_74kc')]},
|
||||
{'assets':[dict(self.asset(),digest=None)]}):
|
||||
with self.subTest(changes=changes):
|
||||
r=self.release(); r.update(changes); self.manifest([r])
|
||||
result=self.discover()
|
||||
self.assertNotEqual(result.returncode,0)
|
||||
self.assertIn('No compatible Xray package found',result.stderr)
|
||||
|
||||
def test_github_api_failure_is_explicit(self):
|
||||
result=self.discover(TEST_FETCH_RC='22')
|
||||
self.assertNotEqual(result.returncode,0)
|
||||
self.assertIn('GitHub API unavailable',result.stderr)
|
||||
self.assertFalse(self.binary.exists())
|
||||
|
||||
def test_invalid_json_and_api_error_object_are_not_accepted(self):
|
||||
for data in ('{invalid','{"message":"API rate limit exceeded"}'):
|
||||
self.fixture.write_text(data)
|
||||
result=self.discover()
|
||||
self.assertNotEqual(result.returncode,0)
|
||||
|
||||
def test_apk_metadata_requires_target_abi_and_dependency_solver(self):
|
||||
result=self.run_case('xray_check_package_metadata dummy "$TEST_ROOT" file.apk')
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertIn('--simulate --no-network --allow-untrusted',self.directory.joinpath('dependency-checks').read_text())
|
||||
self.assertNotIn('forbidden-opkg',result.stderr)
|
||||
|
||||
def test_matching_filename_does_not_override_metadata_abi(self):
|
||||
self.directory.joinpath('metadata.json').write_text(json.dumps({'info':{'name':'openwrt-xray','arch':'aarch64'}}))
|
||||
result=self.run_case('xray_check_package_metadata dummy "$TEST_ROOT" file.apk')
|
||||
self.assertNotEqual(result.returncode,0)
|
||||
self.assertIn('incompatible APK ABI',result.stderr)
|
||||
|
||||
def test_dependency_failure_does_not_install_downloaded_package(self):
|
||||
result=self.run_case('xray_check_package_metadata dummy "$TEST_ROOT" file.apk',TEST_DEP_RC='7')
|
||||
self.assertNotEqual(result.returncode,0)
|
||||
self.assertIn('dependencies incompatible',result.stderr)
|
||||
|
||||
def test_url_outside_official_release_is_rejected(self):
|
||||
asset=self.asset(); asset['browser_download_url']='https://evil.example/file.apk'
|
||||
self.manifest([self.release(assets=[asset])])
|
||||
result=self.discover()
|
||||
self.assertNotEqual(result.returncode,0)
|
||||
|
||||
def test_second_api_page_is_used_when_first_has_only_incompatible_cores(self):
|
||||
self.manifest([self.release('v26.10.'+str(day)) for day in range(1,21)])
|
||||
self.directory.joinpath('page2.json').write_text(json.dumps([self.release()]))
|
||||
result=self.run_case('xray_discover_releases "$TEST_ROOT/candidates" "$TEST_ROOT"; rc=$?; cat "$TEST_ROOT/candidates"; exit "$rc"', mocks=r'''
|
||||
fetch_file() {
|
||||
echo "$1" >>"$TEST_ROOT/fetched"
|
||||
case "$1" in *page=2) cp "$TEST_ROOT/page2.json" "$2" ;; *) cp "$TEST_ROOT/api.json" "$2" ;; esac
|
||||
}
|
||||
''')
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertIn('mipsel_24kc.apk',result.stdout)
|
||||
self.assertIn('page=2',self.directory.joinpath('fetched').read_text())
|
||||
|
||||
def test_generic_cpu_without_openwrt_target_does_not_guess_24kc(self):
|
||||
Path(self.env['OWRT_REMOTE_RELEASE_FILE']).write_text("DISTRIB_RELEASE='25.12.2'\n")
|
||||
self.manifest([self.release()])
|
||||
result=self.discover()
|
||||
self.assertNotEqual(result.returncode,0)
|
||||
self.assertIn('No compatible Xray package found',result.stderr)
|
||||
|
||||
def test_older_page_is_bookmarked_without_fetching_it_before_validation(self):
|
||||
self.manifest([self.release()]+[self.release('v26.10.'+str(i)) for i in range(1,20)])
|
||||
result=self.discover()
|
||||
self.assertEqual(result.returncode,0,result.stderr)
|
||||
self.assertEqual(self.directory.joinpath('next-release-page').read_text().strip(),'2')
|
||||
self.assertEqual(len(self.directory.joinpath('fetched').read_text().splitlines()),1)
|
||||
|
||||
|
||||
if __name__=='__main__': unittest.main()
|
||||
@@ -37,6 +37,7 @@ class XrayValidationTests(unittest.TestCase):
|
||||
self.target.write_text('{"working":true}\n', encoding="utf-8")
|
||||
binary = self.directory / "xray"
|
||||
binary.write_text(r'''#!/bin/sh
|
||||
if [ "$1" = version ]; then printf 'Xray 26.6.27 (validation fixture)\n'; exit 0; fi
|
||||
[ "$1" = -test ] && [ "$2" = -config ] || exit 99
|
||||
printf '%s\n' "$*" >>"$TEST_ROOT/xray-tests"
|
||||
case "$3" in *.json) ;; *) echo 'Failed to get format' >&2; exit 1 ;; esac
|
||||
|
||||
Reference in new issue
Block a user