添加USER到Dockerfile后无法访问FastAPI端点问题排查

核心问题1：非root用户无法监听1024以下端口 #

Nginx默认配置监听80端口（属于1024以下的特权端口），Linux系统限制非root用户不能绑定这类端口。哪怕日志显示Starting nginx: nginx.，实际Nginx大概率因为端口绑定失败静默退出了。

解决方法：

• 修改Nginx配置文件（nginx.conf），把监听端口改成1024以上的端口，比如8080：

  server {
      listen 8080;  # 替换原来的listen 80;
      # 其他配置保持不变
  }
  

• 同步调整Docker端口映射，将宿主机的80端口映射到容器的8080端口（比如原来的-p 80:80改成-p 80:8080）。

核心问题2：Nginx依赖的目录权限不全 #

你已经修改了/var/lib/nginx、/var/log/nginx、/etc/nginx的权限，但Nginx启动时需要写入/run/nginx目录存放PID文件，这个目录你没给admin用户权限，导致Nginx无法正常启动。

解决方法：
在Dockerfile的chown命令中添加/run/nginx目录，先确保目录存在：

RUN mkdir -p /run/nginx && chown -R admin:admin /var/lib/nginx /var/log/nginx /etc/nginx /app /run/nginx

核心问题3：service nginx start不适用于非root用户 #

service命令是管理系统服务的工具，需要root权限才能操作。非root用户执行这个命令时，无法正确初始化Nginx运行环境，哪怕日志显示启动，实际进程可能没正常运行。

解决方法：
直接用Nginx二进制命令启动，修改docker-starter.sh：

# 替换原来的service nginx start
nginx -g "daemon off;" & 
gunicorn -k uvicorn.workers.UvicornWorker -w 4 -b 0.0.0.0:8000 src.main:app

-g "daemon off;"让Nginx以非后台模式启动（加&放到后台不阻塞gunicorn启动），确保它以当前admin用户身份正常运行。

额外验证步骤 #

1. 启动容器后，进入容器检查进程状态：

   docker exec -it <容器ID> ps aux
   

   如果Nginx进程不存在，查看错误日志定位问题：

   docker exec -it <容器ID> cat /var/log/nginx/error.log
   

2. 直接在容器内访问gunicorn的8000端口，确认FastAPI服务本身正常：

   docker exec -it <容器ID> curl http://localhost:8000/你的端点路径
   

   如果能返回结果，说明问题完全出在Nginx的配置或启动环节。

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