Docker容器启用只读文件系统后,应用需要写入临时文件怎么办
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/app | tmpfs | 否 |
不要为了绕过一个写入错误,直接把整个 /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-datavolume:用于需要持久化的数据;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。有两种处理方式:
- 在应用配置中把缓存目录改为
/tmp/app-cache; - 只为
/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
处理顺序建议如下:
- 优先修改应用配置,将可执行文件放入镜像内预先创建的目录;
- 将临时文件和可执行文件分到不同目录;
- 只有确认业务确实需要时,才移除该 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



