如何配置Nginx在readonlyRootfilesystem（只读根文件系统）下正常运行？

先澄清一个误解 #

你提到执行nginx -v仍显示日志路径为/var/log/nginx，这是对命令的误判——nginx -v仅输出Nginx的版本信息，根本不会显示任何配置路径。你看到的日志路径提示，实际是Nginx启动失败时的错误输出，而非nginx -v的结果。

正确配置步骤 #

要让Nginx在只读根文件系统下正常运行，需要确保所有需要写入的路径都指向可写的/tmp卷，且提前创建好所需目录（只读根文件系统无法自动创建目录）：

1. 修改Nginx核心配置

编辑/etc/nginx/nginx.conf，将所有涉及写入的路径统一指向/tmp下的专属目录，示例配置片段：

# 指定PID文件路径
pid /tmp/nginx/nginx.pid;

# 指定日志文件路径
error_log /tmp/nginx/logs/error.log warn;
access_log /tmp/nginx/logs/access.log main;

http {
    # 各类临时文件存储目录（处理请求时需要写入临时文件）
    client_body_temp_path /tmp/nginx/client_body_temp;
    proxy_temp_path /tmp/nginx/proxy_temp;
    fastcgi_temp_path /tmp/nginx/fastcgi_temp;
    uwsgi_temp_path /tmp/nginx/uwsgi_temp;
    scgi_temp_path /tmp/nginx/scgi_temp;

    # 其余HTTP配置保持不变...
}

2. 提前创建可写目录并配置权限

由于根文件系统只读，Nginx无法自动创建上述目录，需要手动提前创建并赋予Nginx进程读写权限：

# 创建所有需要的目录
mkdir -p /tmp/nginx/logs /tmp/nginx/client_body_temp /tmp/nginx/proxy_temp /tmp/nginx/fastcgi_temp /tmp/nginx/uwsgi_temp /tmp/nginx/scgi_temp

# 给Nginx用户（默认是nginx）赋予目录权限
chown -R nginx:nginx /tmp/nginx

3. 验证配置正确性

使用nginx -t命令测试配置文件的语法和路径有效性，不要用nginx -v：

nginx -t -c /etc/nginx/nginx.conf

如果配置正确，会输出类似nginx: configuration file /etc/nginx/nginx.conf test is successful的提示。

4. 启动Nginx

确保以前台模式启动Nginx（Docker容器需要前台进程防止退出），并指定配置文件：

nginx -c /etc/nginx/nginx.conf -g "daemon off;"

镜像构建层面优化（可选） #

如果是自定义Docker镜像，可以将上述步骤写入Dockerfile，简化容器启动流程：

FROM nginx:alpine

# 替换默认配置
COPY nginx.conf /etc/nginx/nginx.conf

# 创建目录并设置权限
RUN mkdir -p /tmp/nginx/logs /tmp/nginx/client_body_temp /tmp/nginx/proxy_temp /tmp/nginx/fastcgi_temp /tmp/nginx/uwsgi_temp /tmp/nginx/scgi_temp \
    && chown -R nginx:nginx /tmp/nginx

EXPOSE 8000

# 前台启动Nginx
CMD ["nginx", "-g", "daemon off;"]

启动容器时只需执行：

docker run --read-only -v /tmp -p 8000:8000 <image>

内容的提问来源于stack exchange，提问作者Aditya Singh