Fix APK v3 Xray extraction on OpenWrt 25
This commit is contained in:
1 parent
d7d350fd8b
commit
fcde23bfc4
5 files changed
+376
-9
No files matched your search
@@ -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 требуется подтвердить установкой на устройстве.
|
||||
@@ -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()
|
||||
@@ -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 (
|
||||
|
||||
Reference in new issue
Block a user