容器化部署的几个小坑
权限、网络、日志、升级顺序,这四个地方最容易出问题。
容器把运行环境打包在一起,但没有解决权限、网络和存储的本质问题。下面几个坑几乎每次部署都会遇到其中一个。
权限:UID 不会因为容器而消失
容器内的 root 默认就是宿主机的 root(未启用用户命名空间时)。挂载目录后,容器写出的文件在宿主机上可能是 root:root,宿主机用户改不动。
bash
docker run --rm -v /srv/data:/data alpine id
# 输出 uid=0(root) gid=0(root)解决方式:镜像里用非 root 用户运行,或者通过 user: "1000:1000" 指定 UID/GID。很多镜像支持 PUID/PGID 环境变量,本质也是这个。
网络:容器名不是域名
同一 compose 项目内可以用服务名互访,跨项目默认不通。端口映射只影响宿主机,容器之间访问应该用服务名 + 容器端口。
bash
docker network inspect app_default --format '{{json .Containers}}' | head排查“连不上”时,先确认两个容器是否在同一网络,再看是否监听在 0.0.0.0 而不是 127.0.0.1。
日志:默认会无限增长
json-file 驱动默认不轮转,几个月后能把磁盘写满。提前配置上限:
yaml
logging:
driver: json-file
options:
max-size: "50m"
max-file: "3"升级顺序
有依赖关系时,先升级被依赖的服务;数据库类先备份再升级,大版本升级通常不可逆。restart: unless-stopped 会让升级失败后不断重启,反而掩盖错误,升级时先看日志再放流量。
时区不一致会导致“数据对不上”
容器默认 UTC,应用按本地时间统计时会出现 8 小时偏差。统一在 compose 里设置 TZ=Asia/Shanghai,别在每个镜像里各写一套。
小结
容器不是虚拟机,权限、网络、日志、升级这四件事仍然要按系统的方式思考。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-08-30。