Autoalojamiento

SonarQube en un VPS: calidad y seguridad del código

Una revisión de código humana ve la intención; deja pasar la consulta SQL concatenada, la variable sin usar o el bloque copiado tres veces. SonarQube relee cada análisis con miles de reglas y decide con un quality gate: el código nuevo pasa o no pasa. Esta guía instala la edición open source, SonarQube Community Build, en un VPS con Docker Compose, sustituye la contraseña de fábrica, la publica en HTTPS detrás de nginx y la conecta a su CI.

Desplegar en un VPS Cloud →
6 min de lectura4 pasos

Orbi agente IAEl índice sigue al artículo; los artículos relacionados le esperan al final.

Contenido· Qué hace SonarQube1/11
  1. 01Qué hace SonarQube
  2. 02Lo que SonarQube le aporta
  3. 03Revisión manual sola o SonarQube en su VPS
  4. 04Preparar el servidor
  5. 05Instalar SonarQube con Docker Compose
  6. 06No publique nunca una instancia con admin/admin
  7. 07Publicar SonarQube en HTTPS detrás de nginx
  8. 08Analizar un primer proyecto
  9. 09Bloquear un pipeline con el quality gate
  10. 10Copia de seguridad y actualización
  11. 11SonarQube en un clic en ServOrbit

Qué hace SonarQube

SonarQube es una plataforma de análisis estático: lee el código sin ejecutarlo y señala lo que puede romperse, filtrar datos o costar caro de mantener. Cada defecto se clasifica — bug, vulnerabilidad, punto sensible de seguridad que revisar, code smell — y remite a una regla documentada, con un ejemplo de corrección.

SonarSource publica la edición Community Build bajo licencia LGPL-3.0. Cubre una veintena de lenguajes, entre ellos Java, JavaScript y TypeScript, Python, PHP, C#, Go y Kotlin, además de la infraestructura como código (Terraform, Kubernetes, Dockerfile). Analiza la rama principal de cada proyecto; el análisis de ramas, de pull requests y de los lenguajes C y C++ corresponde a las ediciones comerciales.

Lo que SonarQube le aporta

  • Un quality gate — un veredicto claro en cada análisis, que su pipeline puede esperar antes de desplegar.
  • La seguridad en el ciclo — inyecciones, secretos en claro y configuraciones débiles detectados desde el commit.
  • Reglas explicadas — cada defecto lleva su justificación y un ejemplo de corrección.
  • Seguimiento en el tiempo — deuda técnica, código duplicado y cobertura de pruebas, versión tras versión.
  • Su código en casa — nada sale de su VPS, ni el código ni los resultados.
  • Una API completa — proyectos, tokens, quality gates y webhooks programables.

Revisión manual sola o SonarQube en su VPS

Desplace la tabla

Revisión manual solaCon SonarQube en su VPS
Defectos repetitivosDepende de la atención del revisorDetectados en cada análisis
Fallos conocidosSe ven si alguien los conoceReglas de seguridad aplicadas en todo
Decisión de desplegarA ojoQuality gate explícito
Evolución de la deudaImpresión generalMediciones por versión
Dónde vive el códigoEn su forjaEn su forja y en su VPS

Preparar el servidor

Prevea un VPS Ubuntu 24.04 con al menos 4 GB de RAM y 2 vCPU: SonarQube ejecuta tres procesos Java — el servidor web, el motor de cálculo que procesa los análisis y un Elasticsearch integrado. Instale Docker y el plugin Compose.

Dos ajustes del sistema importan. Elasticsearch pide vm.max_map_count en 524288 como mínimo: ajústelo en el host con sysctl -w vm.max_map_count=524288 y hágalo permanente en /etc/sysctl.d/99-sonarqube.conf. Y SonarQube se niega a arrancar cuando queda menos de un 10 % del disco libre: guarde margen.

Instalar SonarQube con Docker Compose

  1. Preparar la carpeta y el archivo .env

    El archivo guarda la contraseña de la base PostgreSQL.

    mkdir -p /opt/sonarqube && cd /opt/sonarqube
    cat > .env <<EOF
    DB_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. Escribir el archivo docker-compose.yml

    Dos servicios: PostgreSQL y SonarQube. El puerto solo se publica en la interfaz local: únicamente nginx quedará expuesto a Internet.

    services:
      db:
        image: postgres:17.12-alpine
        restart: unless-stopped
        environment:
          POSTGRES_DB: sonar
          POSTGRES_USER: sonar
          POSTGRES_PASSWORD: "${DB_PASSWORD}"
        volumes:
          - sonarqube-db:/var/lib/postgresql/data
    
      sonarqube:
        image: sonarqube:26.11.0.134175-community
        restart: unless-stopped
        depends_on: [db]
        environment:
          SONAR_JDBC_URL: "jdbc:postgresql://db:5432/sonar"
          SONAR_JDBC_USERNAME: sonar
          SONAR_JDBC_PASSWORD: "${DB_PASSWORD}"
          SONAR_TELEMETRY_ENABLE: "false"
          SONAR_ES_BOOTSTRAP_CHECKS_DISABLE: "true"
        ulimits:
          nofile: { soft: 131072, hard: 131072 }
          nproc: { soft: 8192, hard: 8192 }
        ports:
          - "127.0.0.1:9000:9000"
        volumes:
          - sonarqube-data:/opt/sonarqube/data
          - sonarqube-extensions:/opt/sonarqube/extensions
          - sonarqube-logs:/opt/sonarqube/logs
    
    volumes:
      sonarqube-db: {}
      sonarqube-data: {}
      sonarqube-extensions: {}
      sonarqube-logs: {}
  3. Arrancar y comprobar

    El primer arranque crea el esquema de la base y los índices de búsqueda: cuente de dos a cinco minutos. El estado debe pasar a UP.

    docker compose up -d
    docker compose logs -f sonarqube    # esperar «SonarQube is operational»
    curl -s http://127.0.0.1:9000/api/system/status
  4. Sustituir la contraseña de fábrica

    La cuenta admin se crea con la contraseña admin. Sustitúyala antes de publicar la instancia. SonarQube exige al menos 12 caracteres con una mayúscula, una minúscula, un dígito y un carácter especial.

    NEW='<su-contraseña>'
    curl -fsS -u admin:admin -X POST http://127.0.0.1:9000/api/users/change_password \
      --data-urlencode login=admin --data-urlencode previousPassword=admin \
      --data-urlencode "password=$NEW"
    curl -s -u admin:admin http://127.0.0.1:9000/api/authentication/validate   # {"valid":false}

No publique nunca una instancia con admin/admin

Mientras la contraseña de fábrica esté activa, cualquiera que encuentre su dirección se convierte en administrador y lee todo su código. Sustitúyala antes de abrir el proxy inverso y después cree una cuenta nominativa por desarrollador en Administración, Seguridad, Usuarios. Iniciar sesión es obligatorio por defecto para consultar cualquier cosa: mantenga ese ajuste activo.

Publicar SonarQube en HTTPS detrás de nginx

Obtenga un certificado con certbot y declare un server block que transmita la cabecera X-Forwarded-Proto:

server {
    listen 443 ssl;
    server_name sonarqube.example.com;
    ssl_certificate     /etc/letsencrypt/live/sonarqube.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/sonarqube.example.com/privkey.pem;
    client_max_body_size 50m;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
    }
}

Después, en Administración, Configuración, General, indique la URL del servidor (https://sonarqube.example.com): SonarQube la escribe en sus enlaces, notificaciones y webhooks.

Analizar un primer proyecto

En Mi cuenta, Seguridad, genere un token de tipo Global Analysis Token. Desde la raíz de un proyecto, ejecute el escáner oficial en un contenedor, sin instalar nada en su equipo:

docker run --rm \
  -e SONAR_HOST_URL=https://sonarqube.example.com \
  -e SONAR_TOKEN=<token> \
  -v "$PWD:/usr/src" \
  sonarsource/sonar-scanner-cli \
  -Dsonar.projectKey=mi-proyecto -Dsonar.sources=.

El proyecto aparece en SonarQube con sus defectos, su deuda y el veredicto del quality gate. Para un proyecto Java construido con Maven o Gradle, use en su lugar el plugin del build, que lee las clases compiladas.

Bloquear un pipeline con el quality gate

Guarde SONAR_HOST_URL y SONAR_TOKEN en los secretos del repositorio. Con sonar.qualitygate.wait=true, el escáner espera el veredicto y falla si el quality gate está en rojo: el paso de despliegue siguiente no se ejecuta.

# .github/workflows/sonarqube.yml
name: sonarqube
on:
  push:
    branches: [main]
jobs:
  analyse:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Analyse SonarQube
        run: |
          docker run --rm -e SONAR_HOST_URL -e SONAR_TOKEN -v "$PWD:/usr/src" \
            sonarsource/sonar-scanner-cli \
            -Dsonar.projectKey=${{ github.event.repository.name }} \
            -Dsonar.qualitygate.wait=true
        env:
          SONAR_HOST_URL: ${{ secrets.SONAR_HOST_URL }}
          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

El principio es el mismo en GitLab CI, Jenkins o Woodpecker: un paso que lanza el escáner con esas dos variables.

Copia de seguridad y actualización

Los resultados viven en PostgreSQL; los plugins añadidos, en el volumen sonarqube-extensions. Los índices de búsqueda se reconstruyen solos al arrancar y no necesitan copia de seguridad.

cd /opt/sonarqube
docker compose exec -T db pg_dump -U sonar sonar | gzip > sonar-$(date +%F).sql.gz
docker run --rm -v sonarqube_sonarqube-extensions:/src -v "$PWD:/dst" alpine \
  tar czf /dst/extensions-$(date +%F).tar.gz -C /src .

Para actualizar, haga primero la copia, cambie la etiqueta de la imagen y ejecute docker compose pull && docker compose up -d. Si SonarQube pide una migración de la base, abra https://su-dominio/setup y lánzela.

SonarQube en un clic en ServOrbit

El Marketplace de ServOrbit instala exactamente esta pila: la imagen oficial de SonarQube Community Build y PostgreSQL, puerto publicado solo en 127.0.0.1, contraseña de fábrica de la cuenta admin sustituida desde el primer arranque, URL del servidor declarada y HTTPS configurado en su dominio o en el subdominio gratuito del VPS. La contraseña de administrador aparece en su área de cliente.

Compartir este artículoservorbit.com/ma-es/blog/autoalojar-sonarqube-vps-calidad-codigo

Su análisis de código en su VPS

Precios sin IVA, mostrados con su precio de renovación.