From f4ccbf82f3a859406765c8e912b69bdb21192e7a Mon Sep 17 00:00:00 2001 From: kzolotarev95 Date: Fri, 20 Nov 2026 01:24:44 +0400 Subject: [PATCH] Run first-update log maintenance outside restricted Hub service --- docs/VPS_LOG_MAINTENANCE.md | 16 +++++++++++ tests/test_hub_update.py | 8 ++++-- tests/test_hub_update_components.py | 32 +++++++++++++++++++++ vps/owrt-remote-hub.py | 44 +++++++++++++++++++++++++++-- 4 files changed, 94 insertions(+), 6 deletions(-) diff --git a/docs/VPS_LOG_MAINTENANCE.md b/docs/VPS_LOG_MAINTENANCE.md index df415d2..73bd7a2 100644 --- a/docs/VPS_LOG_MAINTENANCE.md +++ b/docs/VPS_LOG_MAINTENANCE.md @@ -101,6 +101,14 @@ journald, ротация и активность таймера. Успех по API роутеров продолжают работать. Нестандартная конфигурация вызывает ошибку с причиной и откат, а не ложное сообщение об успехе. +Установка обслуживания при первом переходе запускается через отдельную службу +`owrt-remote-log-maintenance-` у системного systemd. Ограничение +`CapabilityBoundingSet=CAP_NET_BIND_SERVICE` у веб-службы Hub сохраняется: +проверка Nginx и ротация выполняются с системными правами в отдельной задаче. +Права и владельцы `/var/log/nginx/*.log` не меняются ради обхода ошибок доступа. +Предупреждение Nginx `protocol options redefined` само по себе не означает +отказ; итог определяется кодом возврата команды и её сообщением об ошибке. + Если после нажатия кнопки страница продолжает показывать прежнюю сборку, обновить её через Ctrl+F5. Номер версии остаётся v121; новая сборка определяется по SHA256. Отдельные команды установки выше сохраняются для ручного применения. @@ -233,6 +241,14 @@ Python `invalid escape sequence '\s'` в другом HTML-шаблоне Hub н новых настроек: копия текущего обновления успешно вернула исходные файлы, Hub продолжил работать, а результат обновления содержит причину отказа. +Отдельно воспроизведён `Permission denied` у `nginx -T` при ограничении +`CapabilityBoundingSet=CAP_NET_BIND_SERVICE`, используемом штатной службой Hub. +С этим же ограничением первый переход со старой сборки через кнопку успешно +установил обслуживание в отдельной задаче systemd. Ограничение Hub, владелец +и режим `www-data:adm 0640` журнала Nginx, ключи/настройки и целостность SQLite +сохранены. Проверены 9 регрессий установки компонентов, 19 проверок обновления +и 6 проверок локального тестового обновления. + Разработчикам: после изменения `vps/log-maintenance.py` выполнить `python scripts/embed-log-maintenance.py`; команда с `--check` и тесты проверяют, что встроенный скрипт совпадает с исходником. Внутренний параметр `--backup` diff --git a/tests/test_hub_update.py b/tests/test_hub_update.py index 0ece19d..976b56c 100644 --- a/tests/test_hub_update.py +++ b/tests/test_hub_update.py @@ -48,6 +48,7 @@ class UpdateTests(unittest.TestCase): mock.patch.object(hub, 'hub_update_lock', side_effect=lambda *a, **k: nullcontext()).start() self.install_logs = mock.patch.object(hub, 'hub_install_log_maintenance').start() self.rollback_logs = mock.patch.object(hub, 'hub_rollback_log_maintenance').start() + self.bootstrap_logs = mock.patch.object(hub, 'hub_run_log_maintenance_unit').start() mock.patch.object(hub, 'hub_prune_log_maintenance_backups').start() def response(self, data=NEW, url=None): @@ -247,7 +248,7 @@ class UpdateTests(unittest.TestCase): job = {'id': 'a' * 32, 'status': 'restarting', 'revision': hub.HUB_LOADED_REVISION, 'started_at': hub.time.time()} hub.hub_update_state(self.directory, job) - self.install_logs.side_effect = None + self.bootstrap_logs.side_effect = None captured = {} def thread(**kwargs): captured['install'] = kwargs['target'] @@ -258,8 +259,9 @@ class UpdateTests(unittest.TestCase): self.assertEqual(self.manager.snapshot()['job']['status'], 'installing') captured['install']() self.assertEqual(self.manager.log_maintenance_status, 'ready') - self.install_logs.assert_called_once_with(self.directory, job['id'], budget=40) - self.install_logs.side_effect = RuntimeError('disk full') + self.bootstrap_logs.assert_called_once_with(self.directory, job['id'], self.target) + self.install_logs.assert_not_called() + self.bootstrap_logs.side_effect = RuntimeError('disk full') captured['install']() self.assertEqual(self.manager.snapshot()['job']['status'], 'failed') self.assertIn('disk full', self.manager.snapshot()['job']['message']) diff --git a/tests/test_hub_update_components.py b/tests/test_hub_update_components.py index afe97d5..cdbd72c 100644 --- a/tests/test_hub_update_components.py +++ b/tests/test_hub_update_components.py @@ -92,6 +92,38 @@ class ComponentTests(unittest.TestCase): self.assertTrue(hub.hub_log_maintenance_directory(self.directory, 'b' * 32).exists()) self.assertTrue(other.exists()) + def test_bootstrap_runs_in_separate_system_service_and_checks_receipt(self): + target = self.directory / 'hub.py' + with mock.patch.object(hub.subprocess, 'run', return_value=subprocess.CompletedProcess([], 0, '', '')) as run, \ + mock.patch.object(hub, 'hub_log_maintenance_receipt', return_value={ + 'status': 'ready', 'sha256': hub.HUB_LOG_MAINTENANCE_SHA256}): + hub.hub_run_log_maintenance_unit(self.directory, self.job_id, target) + args = run.call_args.args[0] + self.assertEqual(args[0], 'systemd-run') + self.assertIn('--wait', args) + self.assertIn('--pipe', args) + self.assertIn('panel-log-maintenance-worker', args) + self.assertIn(str(target), args) + self.assertNotIn('--scope', args, 'a scope would inherit restricted Hub capabilities') + self.assertFalse(any('CapabilityBoundingSet' in arg for arg in args)) + self.assertEqual(args[-2:], ['--directory', str(self.directory)]) + + def test_bootstrap_rejects_failed_unit_or_missing_receipt(self): + for status, receipt, message in ((1, {}, 'Permission denied'), (0, {}, 'нет результата')): + with self.subTest(status=status), \ + mock.patch.object(hub.subprocess, 'run', return_value=subprocess.CompletedProcess([], status, '', 'Permission denied')), \ + mock.patch.object(hub, 'hub_log_maintenance_receipt', return_value=receipt): + with self.assertRaisesRegex(RuntimeError, message): + hub.hub_run_log_maintenance_unit(self.directory, self.job_id, self.directory / 'hub.py') + + def test_stale_privileged_worker_never_installs(self): + for job in ({'id': 'd' * 32}, {'id': self.job_id, 'status': 'failed', 'revision': hub.HUB_LOADED_REVISION}): + with mock.patch.object(hub, 'hub_update_state', return_value=job), \ + mock.patch.object(hub, 'hub_install_log_maintenance') as install: + with self.assertRaisesRegex(RuntimeError, 'устарела'): + hub.run_hub_log_maintenance_worker(self.job_id, self.directory) + install.assert_not_called() + if __name__ == '__main__': unittest.main() diff --git a/vps/owrt-remote-hub.py b/vps/owrt-remote-hub.py index 17be558..492f303 100644 --- a/vps/owrt-remote-hub.py +++ b/vps/owrt-remote-hub.py @@ -16217,6 +16217,39 @@ def hub_prune_log_maintenance_backups(directory, job_id): shutil.rmtree(path) +def run_hub_log_maintenance_worker(job_id, directory=None): + directory = Path(directory or STATE_DIR / 'panel-update') + job = hub_update_state(directory) + if (job.get('id') != job_id or job.get('revision') != HUB_LOADED_REVISION + or job.get('status') not in {'restarting', 'succeeded'}): + raise RuntimeError('Задача установки обслуживания журналов устарела.') + hub_install_log_maintenance(directory, job_id, budget=40) + + +def hub_run_log_maintenance_unit(directory, job_id, target): + """PID 1 launches the worker outside Hub's restricted capability set. + + Keep the worker independent of Hub's service: an old updater can roll back + the Hub while this unit safely finishes restoration of logging settings. + Never chmod nginx logs or broaden the web service's capabilities. + """ + hub_log_maintenance_directory(directory, job_id) # Validate before naming a unit. + result = subprocess.run([ + 'systemd-run', '--quiet', '--wait', '--pipe', '--collect', + '--unit=owrt-remote-log-maintenance-' + job_id, + '--property=Type=exec', '--property=RuntimeMaxSec=100', + '--setenv=OWRT_REMOTE_STATE_DIR=' + str(STATE_DIR), + sys.executable, str(target), 'panel-log-maintenance-worker', + '--job-id', job_id, '--directory', str(directory), + ], capture_output=True, text=True, errors='replace', timeout=110) + if result.returncode: + detail = ((result.stdout or '') + '\n' + (result.stderr or '')).strip()[-2000:] + raise RuntimeError('Задача обслуживания журналов: rc=' + str(result.returncode) + '; ' + detail) + receipt = hub_log_maintenance_receipt(directory, job_id) + if receipt.get('status') != 'ready' or receipt.get('sha256') != HUB_LOG_MAINTENANCE_SHA256: + raise RuntimeError('Задача обслуживания журналов не подтвердила установку: ' + str(receipt.get('error', 'нет результата'))[:1000]) + + def hub_update_state(directory, value=None): path = Path(directory) / 'job.json' if value is not None: @@ -16390,9 +16423,9 @@ class HubUpdateManager: self.log_maintenance_status = 'installing' def install(): try: - # The old worker's health wait is about a minute. Fail/restore - # within that budget rather than install after its rollback. - hub_install_log_maintenance(self.directory, job['id'], budget=40) + # Hub has only CAP_NET_BIND_SERVICE. Provision via PID 1, like + # the regular updater, so nginx tests/rotation have root caps. + hub_run_log_maintenance_unit(self.directory, job['id'], self.target) self.log_maintenance_status = 'ready' try: hub_prune_log_maintenance_backups(self.directory, job['id']) @@ -21470,6 +21503,11 @@ def parser(): update_worker.add_argument('--job-id', required=True) update_worker.set_defaults(func=lambda args: sys.exit(run_hub_update_worker(args.job_id))) + log_worker = sub.add_parser('panel-log-maintenance-worker', help=argparse.SUPPRESS) + log_worker.add_argument('--job-id', required=True) + log_worker.add_argument('--directory', required=True, type=Path) + log_worker.set_defaults(func=lambda args: run_hub_log_maintenance_worker(args.job_id, args.directory)) + serve = sub.add_parser("serve", help="run web dashboard") serve.add_argument("--host", default=os.environ.get("OWRT_REMOTE_BIND", "0.0.0.0")) serve.add_argument("--port", type=int, default=int(os.environ.get("OWRT_REMOTE_PORT", "8088")))