Docker容器启用只读文件系统后,应用需要写入临时文件怎么办

发布人:A5数据发布时间:2026-10-26 10:28阅读量:100

Docker 容器启用只读根文件系统后,仍然可以让应用写入指定的临时目录,不需要直接取消 --read-only。常用做法是为 /tmp、/var/tmp 或应用专用缓存目录挂载可写的 tmpfs;需要跨容器重启保留的数据,则使用 Docker volume 或绑定挂载。这样既保留根文件系统的只读约束,也为应用提供明确、有限的写入范围。

以下示例以 Linux Docker Engine 和 Docker Compose v2 为基础,适合首次部署使用只读容器的应用。示例中的 your-app:1.0、/var/lib/app 和 UID 10001 需要根据实际镜像和应用文档替换。

准备条件

确认 Docker 和镜像信息

先确认 Docker Engine、Compose 插件以及目标镜像可用:

docker version
docker compose version
docker image inspect your-app:1.0 --format 'image={{.RepoTags}} user={{.Config.User}} workdir={{.Config.WorkingDir}}'

预期能够看到 Docker 客户端和服务端版本,镜像检查命令能够返回镜像标签、默认用户和工作目录。

重点确认以下信息:

  • 应用是否默认以非 root 用户运行;
  • 应用临时文件默认写入哪个目录;
  • 应用数据、上传文件、缓存和运行时 PID 文件分别位于哪里;
  • 应用是否会写入 /tmp 之外的目录;
  • 应用是否需要执行临时目录中的脚本或二进制文件;
  • 应用是否依赖 /run、/var/run 或 /dev/shm。

如果镜像没有提供 Shell,不要为了排查而修改生产镜像的启动命令。后续可以使用应用健康检查、接口请求和容器日志验证。

区分临时数据和持久数据

只读根文件系统并不意味着容器内所有目录都必须不可写,而是要把写入位置明确划分出来。

准备条件 区分临时数据和持久数据配图

写入内容推荐位置挂载方式是否跨容器重启保留
临时上传、解压文件、构建中间文件/tmp 或应用专用临时目录tmpfs否
缓存、可重新生成的索引/tmp/app-cache 或独立缓存目录tmpfs 或可清理 volume视需求而定
用户上传、任务结果、数据库文件/var/lib/app 等数据目录Docker volume 或绑定挂载是
配置文件、证书、静态模板/etc/app 等配置目录只读绑定挂载或镜像内置通常不由应用写入
运行日志标准输出和标准错误docker logs 或日志驱动由日志驱动管理
PID 文件、Unix Socket/run/app 或 /var/run/apptmpfs否

不要为了绕过一个写入错误,直接把整个 /var、/app 或宿主机根目录挂载为可写。目录范围越大,应用进程可修改的内容越多,原本的只读隔离效果也会减弱。

容器只读运行需要清晰区分临时写入与持久数据,底层服务器资源也要适配应用的数据规模和运行负载。A5数据提供香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,覆盖常规建站、AMD计算及存储型方案,配置包含SSD、NVMe或大容量机械硬盘,可用于承载应用服务、数据库和持久化业务数据。

第一步:先验证只读根文件系统和临时目录

正式启动应用前,可以使用一个临时的 Alpine 容器验证 Docker 参数。这个验证不会修改宿主机文件,也不会创建持久数据。

docker run --rm \
  --read-only \
  --tmpfs /tmp:rw,nosuid,nodev,noexec,size=64m,mode=1777 \
  alpine:3.20 \
  sh -c '
    set -eu

    tmp_file="/tmp/a5idc-check-$$"
    printf "temporary-ok\n" > "$tmp_file"
    test "$(cat "$tmp_file")" = "temporary-ok"
    rm -f "$tmp_file"

    if touch "/etc/.a5idc-readonly-check-$$" 2>/dev/null; then
      echo "unexpected: root filesystem is writable"
      exit 1
    else
      echo "rootfs=readonly"
    fi

    echo "tmpfs=writable"
    df -h /tmp
  '

预期结果类似:

rootfs=readonly
tmpfs=writable
Filesystem      Size  Used Avail Use% Mounted on
tmpfs            64M     0   64M   0% /tmp

这里的 64m 是临时文件系统的容量上限,并不代表容器启动时一定立即占用 64 MiB 内存。文件写入后,tmpfs 才会按实际使用量消耗内存,具体还会受到宿主机内存和容器资源限制影响。

如果应用有多个并发任务,可以按峰值临时文件量估算容量。例如,预计同时运行 8 个任务,每个任务最多产生 6 MiB 临时文件:

8 × 6 MiB = 48 MiB
48 MiB × 1.2 = 57.6 MiB

此时可以将上限设置为 64 MiB。如果任务文件较大或峰值不确定,应提高容量并配合应用自身的清理机制,而不是无限扩大 tmpfs。

第二步:创建需要持久化的 volume

如果应用只需要临时文件,可以跳过这一步。如果应用还需要保存上传内容、任务结果或其他业务数据,先创建独立的 Docker volume:

docker volume create app-data
docker volume inspect app-data

预期能够看到 volume 的名称和宿主机存储位置。不要直接手工修改 docker volume inspect 返回的宿主机目录,Docker volume 的目录结构和权限应通过 Docker 命令或容器内操作管理。

处理非 root 用户权限

如果应用以 UID 10001、GID 10001 运行,volume 初始目录的所有者可能与应用用户不一致。可以在首次使用空 volume 时设置权限:

docker run --rm \
  --user 0:0 \
  --mount type=volume,src=app-data,dst=/data \
  alpine:3.20 \
  sh -c 'chown -R 10001:10001 /data'

这个命令会修改 volume 内文件的所有者。只适用于确认目录内容不需要保留,或已经完成备份的场景。已有业务数据的 volume 不应直接执行递归 chown,应先确认应用对 UID、GID 和文件权限的要求。

如果应用镜像由自己构建,更推荐在镜像构建阶段创建目录和设置权限:

FROM your-base-image:1.0

RUN install -d -o 10001 -g 10001 /var/lib/app

USER 10001:10001

这样可以减少容器首次启动时的权限修复操作。

第三步:使用 docker run 启动只读容器

下面的命令同时配置:

  • --read-only:将容器根文件系统设置为只读;
  • /tmp 的 tmpfs:用于临时文件;
  • app-data volume:用于需要持久化的数据;
  • TMPDIR=/tmp:告知遵循该环境变量的程序使用指定临时目录。
docker run -d \
  --name app-ro \
  --restart unless-stopped \
  --read-only \
  --tmpfs /tmp:rw,nosuid,nodev,noexec,size=64m,mode=1777 \
  --mount type=volume,src=app-data,dst=/var/lib/app \
  --env TMPDIR=/tmp \
  your-app:1.0

/var/lib/app 只是示例路径。如果应用实际把数据写入 /data,应将目标路径改成 /data。如果应用不需要持久化数据,可以删除 --mount type=volume... 这一行。

如果配置文件位于宿主机,建议以只读方式挂载:

docker run -d \
  --name app-ro \
  --read-only \
  --tmpfs /tmp:rw,nosuid,nodev,noexec,size=64m,mode=1777 \
  --mount type=bind,src="$PWD/config",dst=/etc/app,readonly \
  --mount type=volume,src=app-data,dst=/var/lib/app \
  --env TMPDIR=/tmp \
  your-app:1.0

验证容器是否启动

先确认容器状态和最近日志:

docker ps --filter name=app-ro
docker logs --tail 100 app-ro

如果状态为 Up,且日志没有出现 Read-only file system、Permission denied 或 No space left on device,说明启动阶段没有立即触发写入问题。

再查看 Docker 实际挂载结果:

docker inspect app-ro \
  --format '{{range .Mounts}}{{println .Destination .Type "rw=" .RW}}{{end}}'

示例结果:

/tmp tmpfs rw= true
/var/lib/app volume rw= true

如果配置文件使用只读绑定挂载,预期对应行的 rw 应为 false。

第四步:用应用自身路径验证写入

如果应用镜像包含 Shell,可以用专用测试文件验证两个目录的行为:

docker exec app-ro sh -c '
  set -eu

  temp_file="/tmp/a5idc-temp-check-$$"
  data_file="/var/lib/app/a5idc-data-check-$$"

  printf "temporary-ok\n" > "$temp_file"
  test "$(cat "$temp_file")" = "temporary-ok"
  rm -f "$temp_file"

  printf "persistent-ok\n" > "$data_file"
  test "$(cat "$data_file")" = "persistent-ok"
  rm -f "$data_file"

  echo "temporary and persistent paths are writable"
'

预期结果:

temporary and persistent paths are writable

如果应用使用非 root 用户运行,测试命令也会以该用户执行,因此能够同时验证 volume 的实际权限。

对于不包含 Shell 的镜像,应通过以下方式替代:

  • 调用应用已有的健康检查接口;
  • 上传一个小型测试文件并确认应用能够处理;
  • 执行一次会产生临时文件的测试任务;
  • 检查应用日志中是否出现写入失败;
  • 使用镜像内置的管理命令进行检查。

不要仅通过 docker exec 进入容器后手工创建目录来判断应用是否正常,因为手工测试的用户、环境变量和工作目录可能与主进程不同。

使用 Docker Compose 配置

如果应用通过 Compose 首次部署,可以将只读根文件系统和可写挂载写入 compose.yaml:

services:
  app:
    image: your-app:1.0
    container_name: app-ro
    read_only: true
    restart: unless-stopped
    environment:
      TMPDIR: /tmp
    tmpfs:
      - /tmp:rw,nosuid,nodev,noexec,size=64m,mode=1777
    volumes:
      - app-/var/lib/app

volumes:
  app-

启动前先检查 Compose 展开的配置:

docker compose config

确认 read_only: true、tmpfs 和 volumes 的缩进及路径正确后,再启动:

docker compose up -d
docker compose ps
docker compose logs --tail 100 app

如果应用只需要临时文件,不需要持久化目录,可以删除:

    volumes:
      - app-/var/lib/app

volumes:
  app-

如果应用还会写入 /run/app,可以增加独立的临时目录:

    tmpfs:
      - /tmp:rw,nosuid,nodev,noexec,size=64m,mode=1777
      - /run/app:rw,nosuid,nodev,size=16m,mode=0755

更稳妥的做法是同时在应用配置中指定 PID 文件或 Socket 路径为 /run/app,而不是让应用在 /var/run 下任意创建文件。

常见失败情况和处理方式

报错路径不是 /tmp

如果日志显示:

open /var/cache/app/index.tmp: read-only file system

说明应用没有使用 /tmp,而是将临时缓存写入 /var/cache/app。有两种处理方式:

  1. 在应用配置中把缓存目录改为 /tmp/app-cache;
  2. 只为 /var/cache/app 增加独立的 tmpfs。

例如:

docker run -d \
  --name app-ro \
  --read-only \
  --tmpfs /tmp:rw,nosuid,nodev,noexec,size=64m,mode=1777 \
  --tmpfs /var/cache/app:rw,nosuid,nodev,noexec,size=32m,mode=0755 \
  --mount type=volume,src=app-data,dst=/var/lib/app \
  your-app:1.0

如果该目录保存的是可重新生成的缓存,使用 tmpfs 较合适;如果里面是需要跨重启保留的索引或任务结果,应改用 volume。

报错 Permission denied

这通常不是只读根文件系统造成的,而是挂载目录的所有者或权限不匹配。先查看镜像默认用户:

docker image inspect your-app:1.0 \
  --format 'configured-user={{.Config.User}}'

再在临时容器中确认应用用户:

docker run --rm your-app:1.0 id

如果 volume 由 root 创建,而应用以 UID 10001 运行,需要将 volume 内目录设置为应用用户所有,或在镜像构建阶段预先创建正确权限的目录。不要为了快速解决问题把容器改为 root 运行,除非应用本身明确要求并且已经评估了风险。

报错 No space left on device

先检查 tmpfs 使用量:

docker exec app-ro df -h /tmp

如果 /tmp 已接近配置上限,优先检查应用是否遗漏了临时文件清理。确认清理逻辑正常后,再根据峰值需求调整 size,例如从 64m 调整为 128m。

如果临时文件本身可能达到数百 MiB 或更大,不建议全部放入 tmpfs。可以改用专用 volume,并通过应用定时清理、任务完成后删除文件或宿主机运维策略控制占用。

临时目录中的程序无法执行

示例中的 noexec 会禁止执行 /tmp 中的脚本和二进制文件。如果应用会先下载或解压可执行文件,再从 /tmp 启动,可能出现:

Permission denied
cannot execute binary file

处理顺序建议如下:

  1. 优先修改应用配置,将可执行文件放入镜像内预先创建的目录;
  2. 将临时文件和可执行文件分到不同目录;
  3. 只有确认业务确实需要时,才移除该 tmpfs 的 noexec 选项。

如果必须移除,可以使用:

--tmpfs /tmp:rw,nosuid,nodev,size=64m,mode=1777

这会扩大临时目录中恶意脚本或意外二进制被执行的风险,应限制镜像来源、应用依赖和容器内进程权限。

应用写入 /dev/shm

部分运行时或浏览器类应用使用 /dev/shm 保存共享内存数据。此时应调整共享内存大小,而不是把整个根文件系统改为可写:

docker run -d \
  --name app-ro \
  --read-only \
  --shm-size=128m \
  --tmpfs /tmp:rw,nosuid,nodev,noexec,size=64m,mode=1777 \
  your-app:1.0

--shm-size 与 /tmp 的 tmpfs 是两个不同的资源位置,需根据日志中的实际路径分别处理。

重启后文件消失

tmpfs 中的文件属于容器运行期间的临时数据,容器停止或重建后不应期待其继续存在。如果文件需要在重启后保留,应将目录改为 volume 或绑定挂载。

例如:

  • /tmp/task-123.tmp:重启后消失是预期行为;
  • /var/lib/app/result-123.json:如果需要保留,应放入 app-data;
  • 应用日志:应输出到标准输出,而不是写入只读根文件系统中的日志文件。

第五步:完成结果检查

部署完成后,至少检查以下几个方面。

检查根目录确实不可写

如果应用镜像包含 Shell,可以执行:

docker exec app-ro sh -c '
  check="/etc/a5idc-root-check-$$"
  if touch "$check" 2>/dev/null; then
    echo "FAIL: root filesystem is writable"
    rm -f "$check"
    exit 1
  else
    echo "PASS: root filesystem is read-only"
  fi
'

预期结果为:

PASS: root filesystem is read-only

检查临时目录可写且可清理

docker exec app-ro sh -c '
  f="/tmp/a5idc-transient-$$"
  printf "ok\n" > "$f"
  test -s "$f"
  rm -f "$f"
  test ! -e "$f"
  echo "PASS: temporary path"
'

检查持久化目录可写

docker exec app-ro sh -c '
  f="/var/lib/app/a5idc-persistent-$$"
  printf "ok\n" > "$f"
  test "$(cat "$f")" = "ok"
  rm -f "$f"
  echo "PASS: persistent path"
'

检查应用业务功能

最后执行一次与应用实际业务相关的操作,例如:

  • 上传一个小文件;
  • 创建一个测试任务;
  • 生成一次缓存或索引;
  • 调用健康检查接口;
  • 重启容器后确认业务数据仍然存在。

不要只以容器状态为 Up 作为验收标准。应用可能在容器保持运行的情况下持续重试某个写入操作,只有业务路径测试才能确认配置完整。

回滚处理

首次启用只读根文件系统前,建议保留原来的镜像标签、启动参数和 Compose 文件副本。对于已有业务数据,先备份 volume:

docker run --rm \
  --mount type=volume,src=app-data,dst=/data,readonly \
  --mount type=bind,src="$PWD",dst=/backup \
  alpine:3.20 \
  sh -c 'tar czf /backup/app-data-backup.tgz -C /data .'

该命令会把 volume 内容备份到当前目录的 app-data-backup.tgz。如果数据量较大,应确认当前目录所在磁盘有足够空间,并校验备份文件可以读取。

使用 docker run 部署时,回滚可以删除新容器并使用原来的镜像和启动参数重新创建:

docker rm -f app-ro

docker rm -f 会停止并删除容器,属于有影响的操作;它不会自动删除名为 app-data 的 volume,但仍应在执行前确认容器名称和数据挂载关系。不要使用以下命令,除非已经明确确认数据可以删除:

docker volume rm app-data

使用 Compose 时,可以先停止并删除容器,再恢复旧的 Compose 配置:

docker compose down
docker compose up -d

回滚时不要添加 -v,因为 docker compose down -v 会删除 Compose 管理的 volume。若新版本应用已经修改了数据库结构或持久化数据格式,仅恢复只读配置和旧镜像可能不够,还需要按照应用自身的数据库备份和迁移回退方案处理。

验收与回滚检查项

上线前逐项确认:

  • [ ] 根文件系统配置为只读,read_only 或 --read-only 已生效;
  • [ ] /tmp 或应用实际临时目录已单独挂载为可写;
  • [ ] 临时目录容量能够覆盖业务峰值,并设置了合理上限;
  • [ ] 需要保留的数据已挂载到独立 volume 或绑定目录;
  • [ ] volume 的 UID、GID 和权限与应用进程一致;
  • [ ] 配置文件和证书等只读内容没有被错误挂载为可写;
  • [ ] 应用日志中没有只读文件系统、权限或空间不足错误;
  • [ ] 临时文件能够创建并在任务完成后清理;
  • [ ] 持久化数据重启容器后仍然存在;
  • [ ] 已保存旧镜像标签、旧启动参数和 Compose 配置;
  • [ ] 已确认 volume 备份位置和恢复方式;
  • [ ] 回滚时不会误执行删除 volume 的命令。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5769.html

相关推荐