
Локальная лаборатория TLS для CVE-2026-19553 с защищённой конфигурацией Ubuntu 24.04 и семью демонстрационными тестами.
Эта локальная лаборатория CVE-2026-19553 сравнивает CPython 3.13.15 с исправленным CPython 3.13.16. Установщик рассчитан на существующую виртуальную машину Ubuntu 24.04 LTS, включая Ubuntu 24.04.5 с уже установленными MCPJam и Apache.
Этот репозиторий является публичным. Клонирование и получение изменений не требуют входа в GitHub. Введите эти команды в Ubuntu, по одной строке за раз:
cd ~
git clone https://github.com/monkeyyey/acw3-tls-lab.git lab
cd lab
bash setup.sh
Для существующего клона выполните cd ~/lab, git pull --ff-only, затем bash setup.sh.
Сохраните снимок виртуальной машины. Запускайте от имени обычной учётной записи, без sudo; скрипт
запрашивает sudo для зависимостей и чтения защищённой конфигурации Apache.
Требуется не менее 1 ГиБ свободного места. По умолчанию используются закреплённые по контрольной сумме портативные
сборки CPython из проекта python-build-standalone от Astral — того же
дистрибутивного проекта, который использует uv. Поддерживаются ARM64 (aarch64) и x86-64.
Каждый интерпретатор и его встроенные библиотеки остаются в ~/acw3; изменения PATH,
глобальные символические ссылки или замена системного Python не выполняются.
Если Git отсутствует, но доступен curl:
cd ~
curl -fL https://github.com/monkeyyey/acw3-tls-lab/archive/refs/heads/main.tar.gz -o lab.tar.gz
tar -xf lab.tar.gz
cd acw3-tls-lab-main
bash setup.sh
~/mcpjam.
Задайте MCPJAM_DIR, если ваш проект MCPJam находится в другом месте. Ваш существующий
~/acw3/checks/versions-before.txt из шага 1 сохраняется и сравнивается.
Если шаг 1 содержит только некоторые версии, каждая сохранённая запись всё равно должна совпадать.
Уведомление указывает на неполную историю, и для проверок до/после этого запуска
используется полная свежая базовая линия. Пустые или несовпадающие сохранённые
базовые линии всё равно останавливают setup.--no-remove блокирует удаление пакетов. Эта политика применяется к указанной команде.~/acw3/python-VERSION после проверки закреплённых хешей SHA-256.
Версия, архитектура, URL-адреса поставщиков и дайджесты записаны в
python-downloads.json со ссылкой на точный
коммит метаданных upstream. Оба интерпретатора должны импортировать модули лаборатории
и пройти проверки уязвимого/исправленного поведения.По умолчанию не запрашиваются SQLite, OpenSSL или другие пакеты для разработки.
Это позволяет избежать конфликта зависимостей, например когда libsqlite3-dev требует
обновления существующего в VM пакета libsqlite3-0. Загруженные пакеты APT из
предыдущей заблокированной попытки могут остаться в кеше; этот setup не устанавливает
эти кешированные пакеты для разработки.
Если setup всё ещё выводит BLOCKED, остановитесь и изучите ошибку. Даже отсутствующий
инструмент среды выполнения может потребовать замены установленной библиотеки; такая транзакция
отклоняется. Не удаляйте защиту, чтобы принудительно выполнить обновление.
Установщик не редактирует конфигурацию Apache/MCPJam, не перезапускает их службы, не меняет команду Python по умолчанию, не меняет сетевые настройки и не устанавливает сгенерированный CA в системное хранилище доверия. Добавление отсутствующих пакетов всё равно изменяет VM; ваш снимок обеспечивает откат при необходимости.
bash setup.sh source сохраняет исходный подход со сборкой из исходников. Он
использует официальные архивы python.org и make altinstall в приватных префиксах,
а также запрашивает xz-utils, build-essential, pkg-config, libssl-dev и
zlib1g-dev с той же защитой пакетов. Необязательные пакеты для разработки SQLite, Tk и баз данных
опускаются. Режим сборки из исходников всё ещё может быть заблокирован, когда
заголовочные файлы для разработки требуют замены существующих библиотек среды выполнения. Освободите
6 GiB; ACW3_JOBS=1 bash setup.sh source снижает параллелизм компилятора.
Локальные журналы сохраняются вне Git в ~/acw3/checks/runs/. Успешный
автоматический запуск выводит 7/7 tests passed и завершается пройденными проверками
сохранности. Журналы включают сборки, вывод клиента, server.txt и
results.tsv. Повторные запуски используют исправные приватные установки Python.
Для двух терминалов выполните эти команды из папки репозитория:
# Terminal 1
bash setup.sh server
# Terminal 2
bash setup.sh test
Нажмите Ctrl+C в терминале 1 по завершении. bash setup.sh check выполняет
проверку статуса только для чтения; bash setup.sh deps запускает только настройку зависимостей.
| Тест | Python | Ожидаемый результат |
|---|---|---|
| T01 | 3.13.15 | Отсутствие hostname позволяет mock-запросу достичь other.lab |
| T02 | 3.13.15 | Явный hostname отклоняет other.lab |
| T03 | 3.13.15 | service.lab завершается успешно |
| T04 | 3.13.16 | Отсутствие hostname отклоняется до соединения |
| T05 | 3.13.16 | Явный hostname отклоняет other.lab |
| T06 | 3.13.16 | service.lab завершается успешно |
| T07 | 3.13.15 | Несвязанный CA отклоняет сертификат атакующего |
Эндпоинты привязываются к 127.0.0.1:8443 и 127.0.0.1:8444. Обычный порт
MCPJam 6274 и порты Apache 80/443 являются отдельными. Изменения DNS или
файла hosts не требуются. Отдельные тесты см. в runbook.
Публичные загрузки не требуют входа. Для аутентификации для будущих push-операций выполните:
bash setup.sh login
Устанавливает GitHub CLI с той же защитой пакетов, запускает процесс входа через браузер, затем настраивает HTTPS credential helper для Git. Откройте отображаемую страницу устройства GitHub на вашем Mac, если в Ubuntu нет браузера. Никогда не коммитьте токены и не помещайте их в URL репозиториев.
bash -n setup.sh
python3 -m unittest discover -s tests -v
Локальная проверка прошла все 31 тест guard/archive. Все четыре закреплённых Linux-архива были загружены, их контрольные суммы и структура проверены. T01-T07 и ожидаемые счётчики серверных квитанций также прошли с эквивалентными портативными сборками для macOS. Эти проверки не являются выполнением на Ubuntu.