使用 client.containers.run() 创建容器时须显式处理 detach、remove 和异常清理：detach=True 实现后台运行，auto_remove=True 可自动清理退出容器，否则需 reload() 检查状态后手动 stop/remove；销毁前应过滤标签、清理网络与卷，并避免命名冲突。
直接用 client.containers.run() 创建、container.remove() 销毁，但必须显式处理 detach、remove、异常清理三类逻辑，否则容器会残留或脚本卡死。
创建容器时 detach=True 和 remove=True 的组合陷阱
很多人以为加了 remove=True 就能“自动销毁”，其实它只在容器**退出后立即删除**——前提是容器必须能正常退出。如果容器启动后阻塞（比如 nginx -g "daemon off;" 这种前台运行模式），它就永远不会退出，remove=True 彻底失效。
-
detach=True是后台运行的必要条件，不加会导致 Python 主线程卡住等待输出 -
remove=True仅对非 daemon 容器有效；长期运行服务（如 Web 服务）必须手动管理生命周期 - 若需自动清理，推荐用
auto_remove=True（仅限client.containers.run()，不是create()+start()） - 测试场景中更安全的做法：用
client.containers.run(..., detach=True)启动，再用container.wait(timeout=30)等待退出，最后调用container.remove(force=True)
销毁容器前必须 reload() 并检查状态
容器状态可能已变更（如被外部 stop 或 crash），直接 container.remove() 会报 409 Conflict 错误。SDK 不会自动刷新容器元数据。
- 每次操作前先调用
container.reload()，否则container.status可能是过期值 - 销毁前判断：
if container.status in ["exited", "created"]:再 remove；否则先container.stop(timeout=5) - 强制删除要加
force=True，否则正在运行的容器删不掉 - 批量销毁时别用
client.containers.list(all=True)直接遍历删除——可能误删系统容器，建议加 name 或 label 过滤：client.containers.list(filters={"label": "managed_by=myscript"})
自动化流程中容易漏掉的清理点
容器销毁只是表层，真正残留的是网络、卷、临时镜像。SDK 默认不会级联清理。
立即学习“Python免费学习笔记（深入）”；
- 容器退出后，挂载的匿名卷仍存在，要用
client.volumes.list(filters={"label": "container_name"})配合volume.remove() - 自定义网络不会因容器删除而自动移除，需单独调用
network.remove()，且必须确保无容器连接 - 用
client.containers.run(..., auto_remove=False)启动的容器，即使脚本崩溃，也要靠atexit.register()或 try/finally 保证 remove 调用 - CI/CD 场景下建议加超时兜底：用
threading.Timer在 5 分钟后强制 kill 所有匹配标签的容器
最常被忽略的是容器日志驱动和 ulimit 配置——它们不影响销毁动作，但会让下次同名容器启动失败（如 docker: Error response from daemon: Conflict. The container name "/xxx" is already in use.）。销毁前务必确认 container.name 不冲突，或启动时用 name=f"temp-{uuid.uuid4().hex[:8]}" 动态生成。
