docker实现e2e测试环境的核心是“从零开始、互不干扰、用完即焚”：通过专用docker-compose.test.yml编排最小服务栈，依赖healthcheck与--wait确保就绪，tmpfs卷避免残留，-p指定唯一project name保障并行隔离，三步原子化执行启动、测试、清理。
在CI/CD中用Docker快速拉起临时、隔离的端到端（E2E）测试环境，关键不是“启动容器”，而是“每次测试都从零开始、互不干扰、用完即焚”。核心逻辑是：定义专用编排文件 → 启动时等待就绪 → 测试过程只依赖容器内服务名通信 → 无论成败都彻底清理。
用独立 docker-compose.test.yml 定义最小必要服务栈
不复用开发或生产配置。新建 docker-compose.test.yml，只包含E2E测试真正需要的服务（如前端、后端API、数据库、Selenium Grid），并显式控制行为：
- 指定 version: "3.8" 或更高，确保 CI 平台兼容
- 每个服务设 restart: "no"，防止测试中途自启干扰状态
- 用 depends_on + healthcheck（如 PostgreSQL 的
pg_isready）保证依赖服务真正就绪，而非仅容器启动 - 所有数据卷声明为 tmpfs 类型（
volumes: [db-data:/var/lib/postgresql/data:rw]配合driver_opts: {type: tmpfs}），避免磁盘残留 - 为前端或测试驱动器（如 Cypress/Selenium）添加 SE_OPTS 环境变量，禁用共享内存等非容器友好选项
在CI脚本中三步原子化执行
把启动、测试、清理写成紧耦合的连续操作，不拆分步骤，避免中间态残留：
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
-
启动：运行
docker compose -f docker-compose.test.yml -p ci-$RUN_ID up -d --wait（--wait是 v2.15+ 原生健康等待，比 shell 轮询更可靠） -
测试：执行 E2E 命令，如
npx cypress run --config baseUrl=http://app:3000，注意用服务名（app）而非localhost访问，确保走 Docker 内网 -
清理：用
docker compose -f docker-compose.test.yml -p ci-$RUN_ID down -v --rmi local强制删除网络、tmpfs 卷、容器及本次构建的本地镜像
确保多流水线并行不冲突
当多个 PR 或分支同时触发测试时，必须避免容器名、网络名、卷名碰撞：
- 始终通过 -p 参数指定唯一 project name，如
-p ci-${{ github.run_id }}或-p ci-$CI_PIPELINE_ID - 禁用
ports:映射（如-p 3000:3000），E2E 测试在容器内执行，无需暴露宿主机端口；若需调试，改用docker compose logs -f - 验证隔离性：在测试容器内执行
curl -s http://host.docker.internal:3000应失败（除非显式启用 host networking）
提速与稳定性增强技巧
减少等待时间、提升成功率：
- 对被测应用使用 multi-stage 构建，Dockerfile 中分离 build 和 runtime 阶段，减小最终镜像体积和拉取耗时
- CI 中启用 BuildKit：
export DOCKER_BUILDKIT=1，配合--cache-from复用前次构建层 - 第三方服务（PostgreSQL、Redis、Selenium）直接用官方镜像，不打包定制，避免版本漂移和维护负担
- 前端E2E测试容器内安装中文字体、禁用GPU渲染等，参考 Selenium 官方镜像定制实践，避免截图/定位异常
