ما الذي يفعله 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
تجهيز المجلد وملف .env
يحمل الملف كلمة مرور قاعدة PostgreSQL.
mkdir -p /opt/sonarqube && cd /opt/sonarqube cat > .env <<EOF DB_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envكتابة ملف 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: {}التشغيل والتحقق
ينشئ التشغيل الأول مخطط قاعدة البيانات وفهارس البحث: احسب من دقيقتين إلى خمس دقائق. يجب أن تصل الحالة إلى
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استبدال كلمة مرور المصنع
يُنشأ الحساب
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
