Fix OpenWrt Xray release discovery and installer diagnostics

This commit is contained in:
kzolotarev95 committed 2026-11-06 21:40:47 +04:00
1 parent 6cf3ae7c0f
commit edbc86697a
13 files changed
+1030 -278

No files matched your search

+6 -4
View File
@@ -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 скачан и его формат проверен; запуск нативного
+115
View File
@@ -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 должны быть подтверждены после установки на устройстве.
Эмуляция перезагрузки в тестах не заменяет эту проверку.
+101
View File
@@ -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()
+78 -12
View File
@@ -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()
+20
View File
@@ -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()
+193
View File
@@ -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()
+1
View File
@@ -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