Fix APK v3 Xray extraction on OpenWrt 25

This commit is contained in:
kzolotarev95 committed 2026-10-29 13:32:42 +04:00
1 parent d7d350fd8b
commit fcde23bfc4
5 files changed
+376 -9

No files matched your search

+44
View File
@@ -117,3 +117,47 @@ JSON не заменяются. Проверяется SHA-256 реально з
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-reverse-vps.ps1" -Vps "root@138.124.79.58" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-reverse-vps.ps1" -Vps "root@138.124.79.58" -Action Rollback
```
## Установка APK на OpenWrt 25
Пакет `openwrt-xray-26.6.27-r1-aarch64_generic.apk` имеет формат APK v3/ADB
(`ADBd` в начале файла). Загрузчик сохраняет любой пакет как `xray.pkg`;
прежний распаковщик выбирал IPK по этому временному имени. Даже при прямом
вызове ветка APK использовала `apk add` и могла установить файлы в системный
`/usr/bin`, не проверив новый бинарник заранее.
Теперь исходное имя release asset передаётся распаковщику отдельным аргументом.
Для APK выполняется `apk extract --allow-untrusted --no-chown --destination`
в отдельный каталог RAM. Команда не устанавливает зависимости и не меняет
базу пакетов. После извлечения проверяется обычный файл `usr/bin/xray`;
проверки размера, запуска и совместимости транспорта остаются обязательными.
Ошибки `apk extract` показывают код и ограниченный фрагмент настоящего вывода.
Неполный кандидат и временный каталог удаляются; старый бинарник, UCI и кэш
не заменяются при неудаче.
В OpenWrt 25.12 используется apk-tools 3.0.5 с `minimal=true`; команда
`extract` входит и в минимальную сборку. Источники:
- https://github.com/openwrt/openwrt/blob/openwrt-25.12/package/system/apk/Makefile
- https://github.com/alpinelinux/apk-tools/blob/v3.0.5/meson.build
- https://github.com/alpinelinux/apk-tools/blob/v3.0.5/src/app_extract.c
Локальная установка заменяет только агент и повторяет `prepare-xray`.
Если первая установка прервалась до создания `/etc/owrt-remote/web.key`,
после подготовки Xray создаётся случайный ключ входа. Имеющийся ключ сохраняется.
Это завершает необходимый для открытия панели шаг прерванного `install.sh`:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-apk-fix.ps1" -Router "root@192.168.2.1" -Action Install
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\k.zolotarev95\Documents\openwrt overlay\vps\deploy-xray-apk-fix.ps1" -Router "root@192.168.2.1" -Action Rollback
```
Резервная копия агента: `/root/owrt-remote-backup-before-xray-apk-v119`.
Откат возвращает агент, сохраняя подготовленный бинарник и boot-кэш.
Рабочий JSON не пересобирается, туннель не перезапускается.
Тесты проверяют полный bootstrap с форматом APK и временным именем `.pkg`,
неудачное извлечение, отсутствие бинарника, несовместимого кандидата и IPK.
В тестах shell работает настоящий BusyBox ash, вызов `apk` заменён тестовым
обработчиком. Настоящий APK скачан и его формат проверен; запуск нативного
`apk extract` на OpenWrt 25.12.5 требуется подтвердить установкой на устройстве.
+70
View File
@@ -0,0 +1,70 @@
"""Local APK bootstrap update preserves code on failure and keeps the CGI untouched."""
import unittest
import test_xray_validation_deploy as base
class XrayApkDeploymentTests(base.XrayValidationDeploymentTests):
deploy_name = 'deploy-xray-apk-fix.ps1'
backup_name = 'owrt-remote-backup-before-xray-apk-v119'
success_marker = 'XRAY_APK_ROUTER_Install_OK'
def setUp(self):
super().setUp()
self.cgi_path = self.targets.pop('cgi')
self.old_cgi = self.original.pop('cgi')
self.key_file = self.root / 'web.key'
self.script = self.script.replace('key_file=/etc/owrt-remote/web.key',
'key_file=' + self.key_file.as_posix())
self.script = self.script.replace('/usr/sbin/owrt-remote prepare-xray', 'test_prepare_xray')
self.script = '''test_prepare_xray() { return "${PREPARE_RC:-0}"; }
''' + self.script
def deploy(self, *args, **kwargs):
result = super().deploy(*args, **kwargs)
self.assertEqual(self.cgi_path.read_bytes(), self.old_cgi)
return result
def test_bad_candidate_and_missing_backup_leave_both_files_unchanged(self):
result = self.deploy('Install', bad_item='agent')
self.assertNotEqual(result.returncode, 0)
self.assertFalse(self.backup.exists())
self.assertEqual(self.targets['agent'].read_bytes(), self.original['agent'])
result = self.deploy('Rollback')
self.assertNotEqual(result.returncode, 0)
self.assertIn('No complete backup', result.stderr)
self.assertEqual(self.targets['agent'].read_bytes(), self.original['agent'])
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.assertNotIn(self.success_marker, result.stdout)
self.assertIn('prepare-xray-apk', result.stderr)
self.assertEqual(self.targets['agent'].read_bytes(), self.original['agent'])
self.assertEqual(self.backup.joinpath('agent').read_bytes(), self.original['agent'])
self.assertFalse(self.key_file.exists())
def test_verify_failure_restores_both_files(self):
result = self.deploy('Install', fail_verify=True)
self.assertNotEqual(result.returncode, 0)
self.assertIn('Restoring the previous agent', result.stderr)
self.assertEqual(self.targets['agent'].read_bytes(), self.original['agent'])
self.assertFalse(self.key_file.exists())
def test_interrupted_first_install_gets_a_key_without_replacing_existing_key(self):
result = self.deploy('Install')
self.assertEqual(result.returncode, 0, result.stderr)
key = self.key_file.read_bytes()
self.assertEqual(len(key), 32)
self.assertTrue(all(chr(c) in '0123456789abcdef' for c in key))
self.assertNotIn(key.decode(), result.stdout + result.stderr)
custom = b'keep-the-existing-key\n'
self.key_file.write_bytes(custom)
result = self.deploy('Install')
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual(self.key_file.read_bytes(), custom)
if __name__ == '__main__':
unittest.main()
+95 -1
View File
@@ -48,6 +48,10 @@ ulimit() { [ "$1 $2" = '-f 32768' ]; }
xray_process_identity() { XRAY_SELF_PID=$$; XRAY_SELF_BIRTH=1; }
xray_process_start() { [ "$1" != "$$" ] || printf 1; }
'''
self.raw_process_mocks = r'''
xray_process_identity() { XRAY_SELF_PID=$$; XRAY_SELF_BIRTH=1; }
xray_process_start() { [ "$1" != "$$" ] || printf 1; }
''' if os.environ.get('OWRT_TEST_BUSYBOX') and os.name == 'nt' else ''
def shell(self, commands, mocks='', **env):
shell = os.environ.get('OWRT_TEST_BUSYBOX', base.SH)
@@ -62,7 +66,7 @@ xray_process_start() { [ "$1" != "$$" ] || printf 1; }
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,
script.write_text(self.agent + '\n' + base.MOCKS + '\n' + self.raw_process_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)
@@ -103,6 +107,95 @@ opkg() {
self.assertEqual(result.returncode, 0, result.stderr)
self.assertEqual((self.directory / 'extracted').read_bytes(), binary)
APK_EXTRACT_MOCK = r'''
apk() {
local destination archive allow
[ "$1" != --print-arch ] || { echo aarch64_generic; return 0; }
printf '%s\n' "$*" >>"$TEST_ROOT/apk-calls"
# Package installation/dependency resolution must never be used here.
[ "$1" = extract ] || return 91
shift
destination=''; archive=''; allow=0
while [ "$#" -gt 0 ]; do
case "$1" in
--allow-untrusted) allow=1; shift ;;
--no-chown) shift ;;
--destination) destination="$2"; shift 2 ;;
*) archive="$1"; shift ;;
esac
done
[ -n "$destination" ] && [ "$allow" = 1 ] && [ -s "$archive" ] || return 92
case "$destination" in "$TEST_ROOT/"*.package-extract.*/data) ;; *) return 93 ;; esac
mkdir -p "$destination/usr/bin"
if [ "${TEST_APK_FAIL:-0}" != 0 ]; then
echo 'ERROR: package integrity check failed' >&2
echo partial >"$destination/usr/bin/xray"
return "$TEST_APK_FAIL"
fi
[ "${TEST_APK_EMPTY:-0}" = 0 ] || return 0
cp "$TEST_ROOT/package-binary" "$destination/usr/bin/xray"
}
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"; }
'''
def apk_fixture(self, binary=None):
# Same ADBd signature as the downloaded yichya APK v3, staged under the
# format-neutral xray.pkg name used by the actual bootstrap.
(self.directory / 'release.pkg').write_bytes(b'ADBd-test-package')
data = binary or self.make_binary('Xray 26.6.27 APK')
(self.directory / 'package-binary').write_bytes(data)
return data
def test_apk_bootstrap_selects_real_format_despite_pkg_staging_name(self):
data = self.apk_fixture()
result = self.raw_shell('install_xray_tmp', mocks=self.APK_EXTRACT_MOCK)
self.assertEqual(result.returncode, 0, result.stderr)
self.assertIn('OK: Xray installed', result.stdout)
self.assertEqual(self.binary.read_bytes(), data)
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.assert_clean()
def test_apk_extract_failure_reports_real_reason_and_preserves_working_state(self):
good = self.apk_fixture()
cached = self.cache(good)
original_uci = (self.directory / 'uci').read_bytes()
result = self.raw_shell('install_xray_tmp', mocks=self.APK_EXTRACT_MOCK, TEST_APK_FAIL='13')
self.assertNotEqual(result.returncode, 0)
self.assertIn('apk extract (rc=13)', result.stderr)
self.assertIn('package integrity check failed', result.stderr)
self.assertNotIn('OK: Xray installed', result.stdout)
self.assertEqual(self.binary.read_bytes(), good)
self.assertEqual((self.directory / 'uci').read_bytes(), original_uci)
self.assertTrue(cached.exists())
self.assert_clean()
def test_apk_without_binary_fails_without_touching_working_core(self):
good = self.apk_fixture()
result = self.raw_shell('install_xray_tmp', mocks=self.APK_EXTRACT_MOCK, TEST_APK_EMPTY='1')
self.assertNotEqual(result.returncode, 0)
self.assertIn('usr/bin/xray', result.stderr)
self.assertNotIn('OK: Xray installed', result.stdout)
self.assertEqual(self.binary.read_bytes(), good)
self.assert_clean()
def test_apk_candidate_transport_is_validated_before_replacing_core(self):
bad = self.incompatible_binary()
good = self.make_binary('Xray 26.6.27 working')
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(self.binary.read_bytes(), good)
self.assertEqual((self.directory / 'uci').read_bytes(), original_uci)
self.assert_clean()
def cache(self, data=None):
data = data or self.make_binary()
self.store.mkdir(exist_ok=True)
@@ -116,6 +209,7 @@ opkg() {
self.assertFalse(list(self.runtime.glob('.restore.*')))
self.assertFalse(list(self.runtime.glob('.compat.*')))
self.assertFalse((self.runtime / 'xray.pkg').exists())
self.assertFalse(list(self.runtime.glob('*.package-extract.*')))
def test_compatible_mipsel_ipk_and_apk_asset_names(self):
for fmt, expected in (