同一容器中SonarQube后配置NGINX SSL：NGINX启动失败排查

问题根源分析 #

1. CMD指令语法错误：原Dockerfile使用exec格式的CMD数组，&&是Shell语法在该格式下不生效，容器仅执行SonarQube启动命令，NGINX未被触发。同时NGINX命令存在引号嵌套错误（"daemon off"被外层引号包裹）及多余;;语法问题。
2. 用户权限不足：切换到sonarqube用户后，无法绑定80/443特权端口（Linux非root用户不能监听1024以下端口），导致NGINX启动失败。
3. 容器服务管理不当：service命令依赖systemd等初始化服务，容器环境通常无完整初始化系统，直接执行NGINX二进制文件更可靠。

修复步骤 #

1. 创建统一启动脚本 #

在项目目录下创建start.sh，用于协同启动两个服务：

#!/bin/bash

# 后台启动SonarQube
/opt/sonarqube/bin/run.sh &

# 等待SonarQube初始化（可选，避免反向代理时后端未就绪）
sleep 30

# 前台启动NGINX，维持容器存活
/usr/sbin/nginx -g "daemon off;"

给脚本添加执行权限：

chmod +x start.sh

2. 修改Dockerfile #

调整Dockerfile解决权限问题，改用启动脚本：

FROM sonarqube:7.9.3-community
USER root

# 安装NGINX
RUN apt-get update && apt-get install -y nginx

# 复制配置与启动脚本
COPY nginx.conf /etc/nginx/nginx.conf
COPY start.sh /opt/sonarqube/start.sh
RUN chmod +x /opt/sonarqube/start.sh

# 暴露端口
EXPOSE 80 443 9000

# 执行启动脚本
CMD ["/bin/bash", "/opt/sonarqube/start.sh"]

说明：保持root用户运行容器，因NGINX需绑定80/443特权端口；若必须用sonarqube用户，需额外配置端口权限（如setcap），但操作复杂度高，不推荐。

3. 验证NGINX配置 #

确保nginx.conf正确反向代理到SonarQube的9000端口，示例配置：

events {}
http {
    server {
        listen 80;
        server_name localhost;

        location / {
            proxy_pass http://localhost:9000;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }

    # SSL配置示例（需挂载证书文件到容器）
    # server {
    #     listen 443 ssl;
    #     server_name your-domain.com;

    #     ssl_certificate /opt/certs/fullchain.pem;
    #     ssl_certificate_key /opt/certs/privkey.pem;

    #     location / {
    #         proxy_pass http://localhost:9000;
    #         proxy_set_header Host $host;
    #         proxy_set_header X-Real-IP $remote_addr;
    #         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    #         proxy_set_header X-Forwarded-Proto $scheme;
    #     }
    # }
}

验证修复效果 #

1. 构建新镜像：

docker build -t sonarqube-nginx .

2. 运行容器：

docker run -d -p 80:80 -p 9000:9000 sonarqube-nginx

3. 检查进程：

docker exec -it <容器ID> ps aux

应能看到SonarQube和NGINX的相关进程。
4. 访问验证：
打开浏览器访问http://localhost，应正常加载SonarQube页面。

内容的提问来源于stack exchange，提问作者David González Jiménez