个人整理 · 2026/11/20 18:22:38 · 技术笔记
Sonarqube9.9 docker 镜像启动后 conf 下的配置文件没有了
编程 复习要点 示例代码

目录问题根源SonarQube 9.9 Docker方案一先导出默认配置再挂载推荐需要手动改 sonar.properties 场景1. 临时启动容器拷贝默认 conf 出来不要挂载 conf2. 赋予权限容器内运行用户 uid9993. 正常启动并挂载 conf方案二不挂载 conf改用环境变量传参官方推荐生产方式方案三使用 docker named volume不使用宿主机路径 bind mount常见踩坑补充快速排查命令问题根源SonarQube 9.9 Docker宿主机空目录 bind mount 挂载/opt/sonarqube/conf直接覆盖容器内部自带的所有配置文件。 Docker 挂载机制宿主机空目录挂载到容器目录 → 容器内原有文件被 “遮住”看上去全部消失。SonarQube 9.9 官方镜像不会自动把默认配置复制进空的绑定挂载目录这是最常见坑。方案一先导出默认配置再挂载推荐需要手动改 sonar.properties 场景1. 临时启动容器拷贝默认 conf 出来不要挂载 conf# 临时运行不挂载conf docker run --rm -d --name sonar-tmp sonarqube:9.9.0-community # 等待10s让容器就绪复制配置到宿主机 docker cp sonar-tmp:/opt/sonarqube/conf /data/sonarqube/ # 销毁临时容器 docker stop sonar-tmp此时/data/sonarqube/conf内就有完整sonar.properties、wrapper.conf、logback.xml2. 赋予权限容器内运行用户 uid999chown -R 999:999 /data/sonarqube/conf3. 正常启动并挂载 confdocker run -d --name sonarqube9.9 \ -p 9000:9000 \ -v /data/sonarqube/conf:/opt/sonarqube/conf \ -v /data/sonarqube/data:/opt/sonarqube/data \ -v /data/sonarqube/logs:/opt/sonarqube/logs \ -v /data/sonarqube/extensions:/opt/sonarqube/extensions \ -e SONAR_ES_BOOTSTRAP_CHECKS_DISABLEtrue \ sonarqube:9.9.0-community⚠️ 重点宿主机 conf 目录必须预先存在文件不能是空目录直接挂载方案二不挂载 conf改用环境变量传参官方推荐生产方式SonarQube Docker 官方不建议 bind mount conf 目录升级版本容易出现配置兼容问题。 所有sonar.properties参数可以直接用环境变量注入 规则前缀SONAR_ 属性名.换成_示例-e SONAR_JDBC_URLjdbc:postgresql://postgres:5432/sonar -e SONAR_JDBC_USERNAMEsonar -e SONAR_JDBC_PASSWORDxxx -e SONAR_WEB_CONTEXT/sonar优点不需要挂载 conf 目录不会出现配置文件丢失问题compose 维护更干净。方案三使用 docker named volume不使用宿主机路径 bind mountdocker volume create sonar_conf # 先初始化volume配置 docker run --rm -v sonar_conf:/opt/sonarqube/conf sonarqube:9.9.0-community # 正式启动挂载命名卷 -v sonar_conf:/opt/sonarqube/conf缺点命名卷路径很深不方便直接在宿主机编辑文件。常见踩坑补充权限问题挂载后即便有文件启动报错无法读取配置宿主机目录属主必须改成 999chown -R 999:999 /data/sonarqubeCentOS/RHEL 开启 SELinux 可加上挂载标识:z-v /data/sonarqube/conf:/opt/sonarqube/conf:z不要直接新建空 sonar.properties缺少大量默认配置项启动会异常务必从镜像复制原始模板修改。Compose 完整可用模板先执行方案一导出 conf 再使用version: 3.8 services: sonarqube: image: sonarqube:9.9.0-community container_name: sonarqube9.9 ports: - 9000:9000 environment: SONAR_ES_BOOTSTRAP_CHECKS_DISABLE: true volumes: - /data/sonarqube/conf:/opt/sonarqube/conf - /data/sonarqube/data:/opt/sonarqube/data - /data/sonarqube/logs:/opt/sonarqube/logs - /data/sonarqube/extensions:/opt/sonarqube/extensions ulimits: nofile: soft: 65536 hard: 65536快速排查命令# 进入容器查看内部原始conf不挂载时 docker exec -it sonarqube ls /opt/sonarqube/conf # 确认挂载是否生效 docker inspect sonarqube | grep Mounts -A20