在统信UOS系统上需用Docker Compose一键部署SonarQube服务端并配置SonarScanner CLI,重点指定Java字节码路径、源码编码及排除规则,确保静态安全扫描成功执行。

在统信UOS系统上对Java、Python、JavaScript等项目执行本地化代码静态安全扫描,需先部署SonarQube服务端并配置客户端扫描器,避免因JDK版本冲突或容器环境未就绪导致启动失败。
用Docker Compose一键部署SonarQube(推荐新手)
该方法自动拉取适配UOS x86_64架构的官方镜像,内置H2数据库可快速验证流程,无需手动装Java或调参数。
1、启用Docker服务并设为开机自启:sudo systemctl enable docker && sudo systemctl start docker
2、将当前用户加入docker组,否则后续所有docker命令都得加sudo:sudo usermod -aG docker $USER → 退出终端重登生效
3、创建部署目录并进入:mkdir -p ~/sonarqube-deploy && cd ~/sonarqube-deploy
4、新建docker-compose.yml文件,粘贴以下内容(已适配UOS v20/1050+桌面版):
version: "3"services: sonarqube: image: sonarqube:9.9-community ports: - "9000:9000" environment: - SONAR_JDBC_URL=jdbc:h2:tcp://localhost/sonar - SONAR_JDBC_USERNAME=sonar - SONAR_JDBC_PASSWORD=sonar volumes: - sonarqube_data:/opt/sonarqube/data - sonarqube_extensions:/opt/sonarqube/extensions - sonarqube_logs:/opt/sonarqube/logsvolumes: sonarqube_data: sonarqube_extensions: sonarqube_logs:
5、启动容器:docker-compose up -d → 等待约90秒,期间不要中断
6、浏览器访问 http://localhost:9000,用默认账号【admin/admin】登录 → 必须立即修改密码,否则下次访问会被拒绝
配置SonarScanner CLI进行项目扫描
扫描器不依赖IDE,适合CI脚本或批量项目检查,关键是要让sonar-scanner识别UOS系统编码和Java字节码路径。
方法一:下载并解压Linux版Scanner
1、进入官网下载页,选SonarScanner CLI 5.0.1.3006 for Linux(非Windows/Mac包)
2、解压到/opt/sonar-scanner:sudo unzip sonar-scanner-cli-5.0.1.3006-linux.zip -d /opt/ → 改名:sudo mv /opt/sonar-scanner-5.0.1.3006-linux /opt/sonar-scanner
3、配置全局连接参数:sudo nano /opt/sonar-scanner/conf/sonar-scanner.properties,填入:
sonar.host.url=http://localhost:9000sonar.token=sqp_开头的长字符串(从Web界面生成)sonar.sourceEncoding=UTF-8
方法二:直接在项目根目录运行免配置扫描
1、确保项目已编译出target/classes(Java)或build/lib(Kotlin)等二进制目录
2、在项目根目录执行单行命令(替换projectKey和token):
sonar-scanner -Dsonar.projectKey=my-java-app -Dsonar.sources=. -Dsonar.java.binaries=target/classes -Dsonar.host.url=http://localhost:9000 -Dsonar.token=sqp_480f5126ff99c9208c21f3a3db21bb7f5e0cc23b
注意:如果提示command not found,需先将/opt/sonar-scanner/bin加入$PATH,或改用绝对路径/opt/sonar-scanner/bin/sonar-scanner
扫描Java项目时的关键配置项
Java项目必须显式声明字节码路径,否则SonarQube无法解析语法树,所有Bug和漏洞规则都会失效。
第一步:确认编译产物存在
执行ls target/classes(Maven)或ls build/classes/java/main(Gradle),若报错“no such file”,先运行mvn compile或./gradlew classes
第二步:在sonar-project.properties中强制指定
sonar.java.binaries=target/classes → 若用Gradle则改为build/classes/java/main
第三步:声明源码兼容级别(防止Java 17语法被误判为错误)
sonar.java.source=17sonar.java.target=17
第四步:排除测试类和资源文件(避免干扰覆盖率统计)
sonar.exclusions=**/test/**,**/resources/**,**/generated-sources/**
第五步:保存文件后,在该项目根目录直接运行sonar-scanner,看到EXECUTION SUCCESS即完成扫描











