首页/云/Docker 容器速查/compose configs 挂载配置文件
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose configs 挂载配置文件

把配置文件按名声明并注入服务:与 secrets 类似的声明方式,适合 nginx 配置、应用参数文件等只读内容的分发。

Docker 容器速查云更新于 2026-10-12
顶层configs: 名称: {file: 路径}
服务引用configs: [名称] 或带 target 的映射
默认挂载/<配置名>,可用 target 指定完整路径

示例

示例
services:
  web:
    image: nginx:1.27-alpine
    configs:
      - source: nginx_conf
        target: /etc/nginx/nginx.conf

configs:
  nginx_conf:
    file: ./nginx.conf
配置文件挂载后内容随容器重建更新;需要热更新配置的流程仍要走 reload。

易错点

  • 复杂目录结构用 configs 逐个声明会很啰嗦,目录级内容更适合 bind 挂载
  • target 指向已存在路径的覆盖行为要验证,避免静默覆盖镜像内文件造成意外

数据来源与参考

  • Docker 官方文档:Compose configs(docs.docker.com/reference/compose-file/configs)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌