Docker Compose 不处理日志格式化，仅透传 logging 配置给 Docker 引擎；真正控制格式的是 logging driver（如 json-file、syslog、fluentd）及其选项，默认 json-file 输出固定 JSON 结构，无法通过 Compose 直接定制显示格式。
理解 Docker Compose 的 logging 配置机制
Docker Compose 本身不处理日志格式化，它只是将日志配置透传给底层 Docker 引擎。真正控制日志输出格式的是 Docker 的 logging driver（如 json-file、syslog、fluentd 等）及其选项。默认使用 json-file，它把每条日志存为 JSON 对象，含 time、stream（stdout/stderr）、log 字段——但这个结构是固定的，无法通过 Compose 直接“定制显示格式”（比如加服务名、颜色或自定义字段）。
在 docker-compose.yml 中配置 logging driver 和选项
你可以在服务级别用 logging 键指定 driver 及其参数。常用且实用的组合是 json-file + max-size/max-file 控制轮转，或切换为 syslog / fluentd 做集中格式化：
-
限制本地日志体积（推荐）：避免磁盘被撑爆
logging: driver: "json-file" options: max-size: "10m" max-file: "3" -
转发到 syslog（便于统一格式化）：
logging: driver: "syslog" options: syslog-address: "tcp://localhost:514" syslog-format: "rfc5424" -
对接 Fluentd（支持自定义 tag 和 format）：
logging: driver: "fluentd" options: fluentd-address: "localhost:24224" fluentd-async-connect: "true" tag: "myapp.${SERVICE_NAME}.${HOSTNAME}"
真正实现“统一定制格式”的可行路径
想让日志终端输出带服务名、时间戳、颜色或结构化字段，需分层处理：
-
应用层打日志时主动添加上下文：在代码中用结构化日志库（如 Python 的
structlog、Go 的logrus），注入service_name、env等字段，输出 JSON 日志。Docker 会原样保存，再由日志收集器解析渲染。 -
用
docker compose logs -f配合外部工具美化：例如用ccat或jq实时解析 JSON 并高亮：docker compose logs -f | jq -r 'select(.log) | "(.time | sub("\.\d+Z"; "Z")) [(.service)] (.log)"' -
部署轻量日志代理（如 loki + promtail）：Promtail 可在采集时重写标签、提取字段、添加静态 label（如
job="myapp"），Loki 查询时按 service/time/group 展示，前端 Grafana 可自由排版。
避坑提醒：哪些“格式定制”在 Compose 中行不通
以下操作不会生效，别白费力气：
- 试图在
logging.options里写format: "text"或template——json-filedriver 不支持日志内容格式化。 - 期望
docker compose logs默认显示服务名前缀 —— 它只显示容器名（如web-1），不是服务名（web）。可用--prefix（v2.20+）临时开启：docker compose logs --prefix，但仅限 CLI 输出，不改变日志文件内容。 - 在
environment或command中改stdout格式 —— 容器内进程输出什么，Docker 就收什么；格式化必须发生在写入前（应用层）或读取后（展示层）。
