这个本地 CVE-2026-19553 实验环境将 CPython 3.13.15 与已修补的 CPython 3.13.16 进行对比。安装程序面向现有的 Ubuntu 24.04 LTS 虚拟机,包括已安装 MCPJam 和 Apache 的 Ubuntu 24.04.5。
此仓库是公开的。克隆和拉取不需要 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 GiB 可用存储空间。默认使用来自 Astral 的 python-build-standalone 项目的、校验和固定的便携式
CPython 构建,这与 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 项目位于其他位置,请设置 MCPJAM_DIR。你在步骤 1 中生成的
~/acw3/checks/versions-before.txt 会被保留并用于比较。
如果步骤 1 只包含部分版本,每个已保存条目仍必须匹配。
系统会给出提示,说明历史记录不完整,并为本次运行的前后检查使用一份完整的全新基线。
空的或不匹配的已保存基线仍会中止 setup。--no-remove 会阻止软件包移除。此策略适用于该命令。~/acw3/python-VERSION 目录中。
版本、架构、供应商 URL 和摘要记录在
python-downloads.json 中,并附有指向确切
上游元数据提交的链接。两个解释器都必须能导入实验模块
并通过易受攻击/已修补行为检查。默认配置不会请求 SQLite、OpenSSL 或其他开发包。
这避免了依赖冲突,例如 libsqlite3-dev 请求
升级虚拟机现有的 libsqlite3-0。先前被阻止的尝试所下载的 APT 软件包
可能仍留在缓存中;此 setup 不会安装
这些缓存的开发包。
如果 setup 仍打印 BLOCKED,请停止并检查错误。即使缺少
运行时工具,也可能需要替换已安装的库;该事务
会被拒绝。不要移除防护来强制升级。
安装程序不会编辑 Apache/MCPJam 配置、重启其 服务、更改默认 Python 命令、更改网络设置,或 将生成的 CA 安装到系统信任中。添加缺失的软件包 仍会更改虚拟机;你的快照可在需要时提供回滚。
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
在终端 1 中完成后按 Ctrl+C。bash setup.sh check 提供只读状态检查;bash setup.sh deps 仅运行依赖安装。
| 测试 | Python | 预期结果 |
|---|---|---|
| T01 | 3.13.15 | 缺少主机名时,模拟请求可到达 other.lab |
| T02 | 3.13.15 | 显式指定主机名会拒绝 other.lab |
| T03 | 3.13.15 | service.lab 成功 |
| T04 | 3.13.16 | 缺少主机名时在连接前被拒绝 |
| T05 | 3.13.16 | 显式指定主机名会拒绝 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 文件。各项测试请参见运行手册。
公开下载无需登录。如需为将来的推送进行身份验证,请运行:
bash setup.sh login
这会使用相同的软件包防护机制安装 GitHub CLI,启动浏览器登录流程,然后配置 Git 的 HTTPS 凭据助手。如果 Ubuntu 上没有浏览器,请在你的 Mac 上打开显示的 GitHub 设备页面。切勿提交令牌,也不要将令牌放入仓库 URL 中。
bash -n setup.sh
python3 -m unittest discover -s tests -v
本地验证通过了全部 31 项防护/归档测试。四个固定版本的 Linux 归档均已下载,并验证了其校验和与目录结构。T01-T07 以及预期的服务器回执计数也在等效的 macOS 便携构建上通过了。这些检查不构成 Ubuntu 环境下的执行验证。
GitHub Actions 工作流面向 Ubuntu 24.04,检查防护项,在该一次性运行器中预装运行时工具,并使用两个 Python 版本和全部七项 TLS 测试运行默认便携安装程序。请查看 Actions 获取最新结果。已知的账户计费限制导致托管作业无法启动,因此这并不代表 Ubuntu 运行成功。托管运行器验证无法保证在每台现有 VM 上完成依赖安装;防护检查针对的是实际 VM 的软件包事务。
客户端、服务器和演示源码均从 sh-yap/ACW3-CVE-2026-19553 的提交 bd2d9a86204e06109a1d406101fd46a88f5685f8 原样复制。源仓库将 sh-yap 和 WilsonTeng8778 列为贡献者。其原始 README 保留为 ORIGINAL_README.md。安装程序、保留检查、回归测试和 CI 工作流是本副本中新增的内容。未对原始代码主张新的许可证。
生成的证书、私钥、日志和 Python 构建产物已从发布的源码中排除。