الاستضافة الذاتية

SonarQube على VPS: جودة الشيفرة وأمانها على خادمك

مراجعة الشيفرة البشرية ترى النية، لكنها تُفلت استعلام SQL المركّب بالدمج، والمتغير غير المستخدم، والكتلة المنسوخة ثلاث مرات. يعيد SonarQube قراءة كل تحليل وفق آلاف القواعد ويحسم ببوابة جودة: إما أن تمر الشيفرة الجديدة أو لا تمر. يثبّت هذا الدليل النسخة مفتوحة المصدر SonarQube Community Build على VPS باستخدام Docker Compose، ويستبدل كلمة مرور المصنع، وينشرها عبر HTTPS خلف nginx، ويربطها بخط CI لديك.

انشر على VPS Cloud ←
6 دقائق للقراءةعدد الخطوات: 4

Orbi وكيل ذكاء اصطناعيالفهرس يتبع المقال، والمقالات ذات الصلة في أسفل الصفحة.

المحتويات· ما الذي يفعله SonarQube1/11
  1. 01ما الذي يفعله SonarQube
  2. 02ما الذي يقدمه لك SonarQube
  3. 03المراجعة اليدوية وحدها أم SonarQube على خادمك
  4. 04تجهيز الخادم
  5. 05تثبيت SonarQube باستخدام Docker Compose
  6. 06لا تنشر مثيلًا بكلمة المرور admin/admin أبدًا
  7. 07نشر SonarQube عبر HTTPS خلف nginx
  8. 08تحليل أول مشروع
  9. 09إيقاف خط CI عند بوابة الجودة
  10. 10النسخ الاحتياطي والتحديث
  11. 11SonarQube بنقرة واحدة على ServOrbit

ما الذي يفعله SonarQube

SonarQube منصة تحليل ساكن: تقرأ الشيفرة دون تشغيلها وتنبّه إلى ما قد ينكسر أو يسرّب بيانات أو يكلّف صيانة باهظة. يُصنَّف كل عيب — خطأ، ثغرة، نقطة أمنية حساسة للمراجعة، رائحة شيفرة — ويحيل إلى قاعدة موثقة مع مثال على التصحيح.

تنشر SonarSource نسخة Community Build برخصة LGPL-3.0. تغطي نحو عشرين لغة، منها Java وJavaScript وTypeScript وPython وPHP وC# وGo وKotlin، إضافة إلى البنية التحتية كشيفرة (Terraform وKubernetes وDockerfile). تحلل الفرع الرئيسي لكل مشروع؛ أما تحليل الفروع وطلبات الدمج ولغتي C وC++ فمن ميزات النسخ التجارية.

ما الذي يقدمه لك SonarQube

  • بوابة جودة — حكم واضح مع كل تحليل، يمكن لخطك انتظاره قبل النشر.
  • الأمان ضمن الحلقة — الحقن والأسرار المكشوفة والإعدادات الضعيفة تُكتشف منذ الإيداع.
  • قواعد مشروحة — كل عيب يحمل تبريره ومثالًا على تصحيحه.
  • المتابعة عبر الزمن — الدين التقني والشيفرة المكررة وتغطية الاختبارات، إصدارًا بعد إصدار.
  • شيفرتك تبقى عندك — لا شيء يغادر خادمك، لا الشيفرة ولا النتائج.
  • واجهة API كاملة — المشاريع والرموز وبوابات الجودة والخطافات قابلة للبرمجة.

المراجعة اليدوية وحدها أم SonarQube على خادمك

مرّر الجدول أفقيًا

المراجعة اليدوية وحدهامع SonarQube على خادمك
العيوب المتكررةرهن انتباه المراجعتُرصد مع كل تحليل
الثغرات المعروفةتُكتشف إن عرفها أحدقواعد أمان تُطبَّق في كل مكان
قرار النشربالتقديربوابة جودة صريحة
تطور الدين التقنيانطباع عامقياسات لكل إصدار
أين تعيش الشيفرةعلى منصة Git لديكعلى منصة Git لديك وعلى خادمك

تجهيز الخادم

خصص خادم VPS بنظام Ubuntu 24.04 بذاكرة 4 غيغابايت ومعالجين افتراضيين على الأقل: يشغّل SonarQube ثلاث عمليات Java — خادم الويب، ومحرك الحساب الذي يعالج التحليلات، وElasticsearch مدمجًا. ثبّت Docker وإضافة Compose.

إعدادان في النظام مهمان. يطلب Elasticsearch ضبط vm.max_map_count على 524288 على الأقل: اضبطه على المضيف بالأمر sysctl -w vm.max_map_count=524288 واجعله دائمًا في /etc/sysctl.d/99-sonarqube.conf. كما يرفض SonarQube الإقلاع إذا كانت المساحة الفارغة أقل من 10% من القرص: احتفظ بهامش كافٍ.

تثبيت SonarQube باستخدام Docker Compose

  1. تجهيز المجلد وملف ‎.env

    يحمل الملف كلمة مرور قاعدة PostgreSQL.

    mkdir -p /opt/sonarqube && cd /opt/sonarqube
    cat > .env <<EOF
    DB_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. كتابة ملف docker-compose.yml

    خدمتان: PostgreSQL وSonarQube. لا يُنشر المنفذ إلا على الواجهة المحلية: وحده nginx سيكون مكشوفًا للإنترنت.

    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. التشغيل والتحقق

    ينشئ التشغيل الأول مخطط قاعدة البيانات وفهارس البحث: احسب من دقيقتين إلى خمس دقائق. يجب أن تصل الحالة إلى UP.

    docker compose up -d
    docker compose logs -f sonarqube    # wait for "SonarQube is operational"
    curl -s http://127.0.0.1:9000/api/system/status
  4. استبدال كلمة مرور المصنع

    يُنشأ الحساب admin بكلمة المرور admin. استبدلها قبل نشر المثيل. يشترط SonarQube اثني عشر حرفًا على الأقل تتضمن حرفًا كبيرًا وحرفًا صغيرًا ورقمًا ورمزًا خاصًا.

    NEW='<your-password>'
    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}

لا تنشر مثيلًا بكلمة المرور admin/admin أبدًا

ما دامت كلمة مرور المصنع فعّالة، يصبح أول من يعثر على عنوانك مسؤولًا ويقرأ شيفرتك كلها. استبدلها قبل فتح الوكيل العكسي، ثم أنشئ حسابًا باسم كل مطور من الإدارة، الأمان، المستخدمون. تسجيل الدخول مطلوب افتراضيًا لعرض أي شيء: أبقِ هذا الإعداد مفعّلًا.

نشر SonarQube عبر HTTPS خلف nginx

احصل على شهادة باستخدام certbot، ثم عرّف كتلة server تمرّر الترويسة 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;
    }
}

بعد ذلك، من الإدارة، الإعدادات، عام، أدخل عنوان الخادم (https://sonarqube.example.com): يكتبه SonarQube في روابطه وإشعاراته وخطافاته.

تحليل أول مشروع

من حسابي، الأمان، أنشئ رمزًا من نوع Global Analysis Token. من جذر المشروع، شغّل الماسح الرسمي داخل حاوية، دون تثبيت أي شيء على جهازك:

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=my-project -Dsonar.sources=.

يظهر المشروع في SonarQube مع عيوبه ودينه التقني وحكم بوابة الجودة. لمشروع Java مبني بـ Maven أو Gradle، استخدم بدلًا من ذلك إضافة أداة البناء التي تقرأ الأصناف المترجمة.

إيقاف خط CI عند بوابة الجودة

احفظ SONAR_HOST_URL وSONAR_TOKEN في أسرار المستودع. مع sonar.qualitygate.wait=true ينتظر الماسح الحكم ويفشل إذا كانت بوابة الجودة حمراء: فلا تُنفَّذ خطوة النشر التالية.

# .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 }}

المبدأ نفسه على GitLab CI أو Jenkins أو Woodpecker: خطوة تشغّل الماسح بهذين المتغيرين.

النسخ الاحتياطي والتحديث

تعيش النتائج في PostgreSQL، والإضافات المثبتة في المجلد sonarqube-extensions. أما فهارس البحث فتُعاد بناؤها تلقائيًا عند الإقلاع ولا تحتاج إلى نسخ احتياطي.

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 .

للتحديث، انسخ احتياطيًا أولًا، وغيّر وسم الصورة، ثم نفّذ docker compose pull && docker compose up -d. إذا طلب SonarQube ترحيل قاعدة البيانات، افتح https://your-domain/setup وأطلقه.

SonarQube بنقرة واحدة على ServOrbit

يثبّت متجر ServOrbit هذه الحزمة نفسها: صورة SonarQube Community Build الرسمية مع PostgreSQL، ومنفذ منشور على 127.0.0.1 فقط، واستبدال كلمة مرور المصنع لحساب admin منذ التشغيل الأول، وإعلان عنوان الخادم، وضبط HTTPS على نطاقك أو على النطاق الفرعي المجاني للخادم. تظهر كلمة مرور المسؤول في مساحة العميل.

شارك هذا المقالservorbit.com/ma-ar/المدونة/استضافة-sonarqube-على-vps

تحليل شيفرتك على خادمك

الأسعار المعروضة قبل الضريبة، مع سعر التجديد.