SonarQube Docker容器重启失败（离线环境）技术求助

兄弟，我前阵子刚在完全离线的防火墙/代理环境里踩过SonarQube Docker的重启坑！你的场景和我当时一模一样——首次启动正常，重启就出问题，还分两种故障情况，我给你梳理下亲测有效的解决办法：

SonarQube默认会依赖联网访问官方的更新中心、插件仓库来做状态校验和初始化，完全离线环境下这些请求失败就会导致重启时出错或者直接崩溃，咱们的核心思路就是彻底禁用所有联网相关的配置，同时确保离线环境的权限和配置加载正常。

问题原因 #

你手动装完插件重启时，SonarQube会尝试访问官方的update-center URL来校验插件的合法性和版本兼容性，离线环境下连不上这个地址就直接抛出错误，启动失败。

解决步骤 #

• 如果你是用宿主机挂载配置目录的方式运行容器，直接在宿主机找到挂载的conf/sonar.properties文件；如果没挂载，先进入容器：docker exec -it <容器ID/名称> bash，然后编辑$SONARQUBE_HOME/conf/sonar.properties
• 添加/修改这两个关键配置：

  # 完全禁用更新中心，禁止所有联网校验请求
  sonar.updatecenter.active=false
  # 可选但推荐：离线环境开启强制认证，避免未授权访问
  sonar.forceAuthentication=true
  

• 另外要注意：手动安装的插件必须和你的SonarQube版本完全兼容，离线环境下没法自动适配版本，版本不匹配也会导致重启失败，装插件前一定要提前在能联网的机器上确认好版本对应关系。

问题原因 #

这种情况大多是启动时SonarQube尝试做联网初始化（比如Elasticsearch节点发现、更新中心检查）失败，或者挂载目录权限不对导致无法读写数据，直接触发容器退出。

解决步骤 #

1. 先查日志定位问题：
   用这个命令看容器退出前的日志：docker logs <容器ID/名称>，大概率会看到网络相关的错误提示，确认是联网问题还是权限问题。
2. 禁用所有联网配置：
   除了上面的sonar.updatecenter.active=false，还要在sonar.properties里加这两个配置：

   # 强制使用IPv4，避免离线环境下IPv6解析失败
   sonar.web.javaAdditionalOpts=-Djava.net.preferIPv4Stack=true
   # 让内置的Elasticsearch绑定到所有地址，禁用自动节点发现（离线环境不需要）
   sonar.search.javaAdditionalOpts=-Dnode.network.host=0.0.0.0
   

3. 修复挂载目录权限：
   SonarQube容器默认用UID为1000的sonarqube用户运行，如果宿主机挂载的目录（比如data、extensions、conf）权限不对，容器启动后无法读写数据就会直接退出。执行这个命令修正权限：

   chown -R 1000:1000 <你的宿主机挂载目录路径>
   

4. 正确重启容器：
   不要直接用docker start，最好先停止容器再启动：docker stop <容器名> && docker start <容器名>，或者用docker restart <容器名>，确保修改后的配置能被重新加载。

如果不想每次重启都折腾配置，最好提前把需要的插件和修改好的配置打包成自定义Docker镜像，这样每次启动都直接用这个离线镜像，不会出问题。

制作步骤 #

1. 在能联网的机器上下载好对应版本的SonarQube官方镜像、需要的插件，以及修改好的sonar.properties文件
2. 写一个Dockerfile：

   FROM sonarqube:<你的SonarQube版本号>
   # 替换默认配置文件
   COPY sonar.properties $SONARQUBE_HOME/conf/sonar.properties
   # 复制离线插件到容器的插件目录
   COPY ./plugins/* $SONARQUBE_HOME/extensions/plugins/
   

3. 构建镜像：

   docker build -t my-offline-sonarqube .
   

4. 把这个镜像导出，传到你的离线环境机器上加载，之后用这个自定义镜像启动容器就行，再也不会有重启问题了

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