需满足java 17、postgresql数据库及专用用户等前置条件；依次完成jdk配置、postgresql建库授权、sonarqube下载解压、sonar.properties数据库与网络配置、以sonar用户启动服务并访问web界面。
如果您希望在Linux系统中部署SonarQube以实现代码质量静态分析，则需满足Java运行环境、数据库支持及服务端资源配置等前置条件。以下是完成SonarQube安装与基础配置的具体步骤：
一、准备Java运行环境
SonarQube 9.x 及以上版本要求使用 Java 17，且仅支持 OpenJDK 或 Oracle JDK。必须确保系统中已安装并正确配置 Java 17，否则服务无法启动。
1、执行 java -version 检查当前Java版本，若非17则需卸载或切换。
2、下载 OpenJDK 17（如 Temurin 17.0.1+12），解压至 /opt/jdk-17 目录。
3、编辑 /etc/profile，追加以下三行：
export JAVA_HOME=/opt/jdk-17
export JRE_HOME=$JAVA_HOME/jre
export PATH=$PATH:$JAVA_HOME/bin
4、执行 source /etc/profile 并再次验证 java -version 输出是否为17。
二、配置PostgreSQL数据库
SonarQube官方推荐使用 PostgreSQL 12 或更高版本作为元数据存储。MySQL 和内置H2数据库不适用于生产环境，此处仅提供 PostgreSQL 配置路径。
1、执行 sudo apt update && sudo apt install postgresql postgresql-contrib（Ubuntu/Debian）或 sudo yum install postgresql-server postgresql-contrib（CentOS 7）。
2、初始化数据库：执行 postgresql-setup initdb（CentOS）或确认 /var/lib/postgresql/data 已存在（Ubuntu）。
3、切换至 postgres 用户并进入 psql：sudo -u postgres psql。
4、在 psql 中依次执行：
CREATE DATABASE sonarqube;
CREATE USER sonar WITH PASSWORD 'sonar';
GRANT ALL PRIVILEGES ON DATABASE sonarqube TO sonar;
\q
三、下载并解压SonarQube发行包
SonarQube 社区版可免费下载，但仅支持单机部署；企业版需许可证。本步骤使用社区版 10.4（LTS），其压缩包不含内嵌数据库，必须外接 PostgreSQL。
1、创建专用用户以提升安全性：sudo adduser --disabled-login --gecos "SonarQube" sonar。
2、切换至 sonar 用户主目录：cd /home/sonar。
3、下载 SonarQube 10.4 Linux 包：wget https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-10.4.0.85267.zip。
4、解压并重命名目录：unzip sonarqube-10.4.0.85267.zip && mv sonarqube-10.4.0 sonarqube。
5、修改属主：sudo chown -R sonar:sonar /home/sonar/sonarqube。
四、修改SonarQube配置文件
配置文件位于 /home/sonar/sonarqube/conf/sonar.properties，必须显式指定数据库连接参数与绑定地址，否则服务将使用默认 H2 数据库并启动失败。
1、用文本编辑器打开该文件：nano /home/sonar/sonarqube/conf/sonar.properties。
2、取消注释并修改以下三行：
sonar.jdbc.url=jdbc:postgresql://localhost:5432/sonarqube
sonar.jdbc.username=sonar
sonar.jdbc.password=sonar
3、取消注释并修改绑定地址行：sonar.web.host=0.0.0.0（如仅本地访问可设为 127.0.0.1）。
4、取消注释并设置 Web 端口：sonar.web.port=9000。
五、启动SonarQube服务
必须以 sonar 用户身份启动，禁止使用 root 启动，否则会因权限校验失败而退出。首次启动将自动初始化数据库表结构并生成必要索引。
1、切换用户：sudo su - sonar。
2、进入 bin 目录：cd /home/sonar/sonarqube/bin/linux-x86-64（根据实际架构选择子目录）。
3、执行启动脚本：./sonar.sh start。
4、查看日志确认状态：tail -f /home/sonar/sonarqube/logs/sonar.log，等待出现 SonarQube is operational 提示。
5、在浏览器中访问 http://服务器IP:9000，默认管理员账号密码均为 admin/admin。
