首页/云/Docker 容器速查/compose config --hash 检测配置变化
Compose 编排55 条

compose config --hash 检测配置变化

输出服务的配置哈希:对比两次哈希即可判断服务定义是否变化,适合在发布脚本里决定哪些服务需要重建。

Docker 容器速查云更新于 2026-10-12
用途服务配置指纹
语法docker compose config --hash [服务…] 或 --hash='*'
取值哈希按服务映射输出

示例

示例
docker compose config --hash='*'
docker compose config --hash web api
docker compose config --hash='*' > /tmp/compose-hash.new && diff /tmp/compose-hash.old /tmp/compose-hash.new
该能力在较新的 Compose v2 版本提供;老环境可退化为对 config 输出做 sha256sum 比对。

易错点

  • 哈希包含变量展开后的值,改动了环境变量即使文件没改也会变化,属预期行为
  • 把哈希比对当成重建决策依据时,记得镜像更新(同 tag 新内容)不在哈希范围内

数据来源与参考

  • Docker 官方 CLI 参考:docker compose config 的 --hash(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌