Docker Engine 29.10.0 发布:本地 registry 安全性变更与 Engine API 迁移
Docker Engine 29.10.0 发布,显式配置 insecure-registries 后回环地址不再自动视为不安全仓库,本地 HTTP registry 推送可能失败;Engine API 规范迁移到 OpenAPI 3.2。使用自建仓库的团队需要评估。
Docker Engine 29.10.0 收紧本地 registry 默认放行
Docker Engine 29.10.0 的核心变化是本地 registry 安全策略收紧,并把 Engine API 规范迁移到 OpenAPI 3.2。 版本同时补充了三个企业发行版的软件包与多项修复。
回环地址不再自动放行
如果你在 daemon.json 里显式配置了 insecure-registries,或使用了 --insecure-registry,引擎不再自动把回环地址 127.0.0.0/8 与 ::1/128 视为不安全仓库。官方原文称:“Docker Engine no longer automatically treats loopback addresses (127.0.0.0/8 and ::1/128) as insecure registries.”(来源:Docker 官方发布说明)
升级后,指向 HTTP 或不受信任 TLS 证书的本地仓库的拉取与推送可能失败,除非把这些地址显式写进不安全仓库配置,例如 localhost:5000。完全省略该字段时,回环仓库仍按不安全处理;设置 "insecure-registries": [] 会关闭全部默认放行。
Engine API 迁移到 OpenAPI 3.2
Engine API 规范现在以 OpenAPI 3.2 为源格式,文件放在 api/openapi.yaml。为兼容现有工具,仍会发布由它生成的 Swagger 2.0 版本 api/swagger.yaml,并附带一份固定到 API v1.57 的副本。发布说明写明,后续 API 版本不再提供逐版本的 Swagger 2.0 文件。
新平台与实验特性
软件包新增 AlmaLinux、Oracle Linux 与 Rocky Linux。实验性 jobs 能力可通过 --enable-extension org.mobyproject.jobs.v0 启用,支持一次性与 cron 调度负载;容器也能从 /etc/docker/containerd.d/ 读取自定义 containerd 配置。打包侧把 BuildKit 更新到 v0.35.0、Go 运行时更新到 1.27.4,API 版本提升到 1.57。
本地 registry 推送与 Swagger 工具链都需要调整
自建本地镜像仓库的开发与 CI 流程最容易受影响,推送环节要先确认仓库地址是否被显式放行。
本地推送可能中断
在 CI 里往 localhost:5000 这类 HTTP 仓库推送的团队,升级后第一次推送就可能被拒绝。从官方描述看,这不是功能移除,而是安全默认值收紧,把需要的地址补进配置即可恢复。
工具链要跟着规范走
依赖 api/swagger.yaml 或逐版本 Swagger 文件做代码生成与 SDK 构建的流程,需要改用 OpenAPI 3.2 源文件。发布说明明确后续版本不再生成旧格式副本,越晚迁移成本越高。
运行时与网络修复
版本修复了 containerd 镜像存储在主机平台未拉取时 docker image inspect 与 docker image ls 显示空镜像的问题,也修正了 docker manifest annotate 拒绝 linux/loong64 等合法平台的情况。网络侧修复了 nftables 后端的端口发布报错与 overlay 网络重建问题。
自建 HTTP registry 的团队先在测试环境验证
使用自建 HTTP registry 或依赖 Swagger 文件的团队,建议在测试环境验证后再升级;只跑官方镜像的项目风险较低。
谁需要先验证
在 daemon.json 里写过 insecure-registries、用自签名证书搭私有仓库、或靠 Swagger 文件生成客户端的团队,属于需要先验证的一组。把本地仓库地址显式加入配置,再执行一次拉取与推送即可确认。
怎么升级
按你的发行版通过官方软件包渠道升级到 29.10.0;新增的 AlmaLinux、Oracle Linux 与 Rocky Linux 安装说明以官方页面为准。升级后重点回归镜像推送、多平台 manifest 与 overlay 网络。
风险与回退
官方未披露逐版本回退步骤。从官方描述看,最主要的破坏性变更集中在本地 registry 配置,提前改好配置可以避开大部分问题。相关的运行时版本变化也可以参考 Go 1.27.4 安全更新。
常见问题
- Docker Engine 29.10.0 对本地仓库做了什么调整?
- 显式配置 insecure-registries 后,回环地址不再被自动当作不安全仓库,需要把本地仓库地址写进配置。
- 升级 Docker Engine 后向本地仓库推送失败怎么办?
- 把需要的地址显式加入 insecure-registries,例如 localhost:5000,或为仓库配置受信任的 TLS 证书。
- Docker Engine 的 Engine API 规范有什么变化?
- 源格式迁移到 OpenAPI 3.2,仍发布 Swagger 2.0 副本,但后续 API 版本不再提供逐版本 Swagger 2.0 文件。
- Docker Engine 29.10.0 适合直接上生产吗?
- 使用自建 HTTP registry 或依赖 Swagger 文件的团队建议先在测试环境验证,再分批升级。
相关术语
- Docker Engine
- Docker Engine 是 Docker 的容器运行时与守护进程,负责镜像、容器和网络的生命周期管理。
- insecure-registries
- insecure-registries 是 Docker 守护进程配置项,用于放行使用 HTTP 或不受信任 TLS 证书的镜像仓库。
- OpenAPI
- OpenAPI 是描述 HTTP API 的规范格式,可用于生成文档、客户端和测试代码。
- BuildKit
- BuildKit 是 Docker 的镜像构建引擎,负责执行 Dockerfile 并产出镜像层。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- Docker Engine 29.10.0 · Docker · 2026-11-17
「Docker Engine 29.10.0」 —— Docker
文章目录