如何实现重启后自动持久化Docker Swarm Stack容器日志

核心逻辑是不需要每次部署后手动操作，要么从Docker引擎层做全局默认配置，要么在stack编排文件里预置规则，一次配置后所有部署自动生效。

方案1：全局配置Docker引擎默认日志规则（全集群所有服务自动生效，零后续操作） #

这是最省事儿的方案，改完配置后所有新启动的Swarm服务自动按规则持久化日志，不需要修改任何stack的yml文件。
操作步骤：

• 登录Swarm集群所有节点（包括manager和所有worker节点，服务会随机调度到任意节点，漏改节点会导致规则失效），编辑Docker守护进程配置文件/etc/docker/daemon.json
• 配置原生json-file日志驱动（Docker自带，不需要装任何额外组件），同时设置日志滚动策略避免占满磁盘，示例配置：

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "5",
    "labels": "com.docker.swarm.service.name,com.docker.stack.namespace"
  }
}

• 配置说明：json-file驱动默认会把所有容器输出到stdout/stderr的日志，自动持久化到宿主机的/var/lib/docker/containers/<容器ID>/<容器ID>-json.log路径，不需要手动挂载任何卷，不存在部署后手动操作的问题。max-size是单个日志文件的大小上限，max-file是最多保留的历史日志文件数，超过后自动滚动删除旧日志。
• 配置保存后执行systemctl reload docker重载Docker配置即可，注意该配置仅对重载后新创建的容器生效，存量运行的服务重新部署后就会应用规则。
• 如果需要把日志归集到固定目录方便查看，可以在所有节点配置一次crontab定时任务，每天按容器的Swarm服务标签，把对应日志文件软链到统一目录比如/var/log/swarm_services/下，按服务名命名，一次配置永久生效，不需要每次部署调整。

方案2：Stack编排文件预置配置（仅对指定Stack生效，不影响集群其他服务） #

如果不想修改全局Docker配置，只需要给特定业务Stack做日志持久化，直接在stack的yml文件里提前写好规则，每次执行docker stack deploy时自动生效，不需要部署后手动挂载。
配置示例：

version: '3.8'
# 抽离公共日志配置，所有服务复用，避免重复写
x-logging: &default-logging
  driver: "json-file"
  options:
    max-size: "100m"
    max-file: "3"

services:
  api:
    image: your-registry/api:latest
    logging: *default-logging
    # 如果应用本身把日志写到容器内文件而不是标准输出，提前配置好绑定挂载，部署时Docker会自动创建宿主机目录，不需要手动建
    volumes:
      - /var/log/your-stack/api:/app/logs
    deploy:
      replicas: 2
    # 其余原有配置（端口、环境变量、依赖等）保持不变

  web:
    image: your-registry/web:latest
    logging: *default-logging
    volumes:
      - /var/log/your-stack/web:/app/logs
    deploy:
      replicas: 2

• 配置说明：如果应用日志是输出到stdout/stderr，完全不需要配置volumes挂载，Docker会自动通过json-file驱动把日志存到宿主机，只要配好logging段的规则就行。之前遇到的配置失效问题，大多是因为只在manager节点写了配置，服务调度到worker节点时没读到对应规则，或者没配日志滚动导致旧日志被自动清理。

避坑说明 #

• 不要手动挂载/var/lib/docker/containers目录到容器里，会打乱Docker本身的文件权限，容易导致引擎运行异常。
• 所有集群节点的Docker日志配置必须保持一致，避免服务调度到不同节点时日志规则不统一。
• 持久化的json日志本身自带时间戳、输出来源字段，可以直接用命令行工具解析查看，不需要额外装日志平台。

内容的提问来源于stack exchange，提问作者Jsef bch