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

Dependency-Track على VPS: قوائم SBOM والتبعيات الهشة

يتضمّن التطبيق الحديث مئات المكتبات التي لم يخترها أحد واحدةً واحدة. ويوم تمسّ ثغرةٌ حرجة إحداها، يبقى السؤال الوحيد المهم: أين نشرناها؟ يجيب OWASP Dependency-Track عن هذا السؤال باستمرار. يرسل إليه خط CI لديك قائمة SBOM لكل بناء، فيطابق كل مكوّن مع قواعد بيانات الثغرات العامة وينبّهك فور تأثّر إصدار يعمل في الإنتاج. يثبّته هذا الدليل على VPS باستخدام Docker Compose، ويستبدل كلمة مرور المصنع، وينشره عبر HTTPS خلف nginx، ويربطه بخط CI لديك.

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

ما الذي يفعله Dependency-Track

Dependency-Track مشروع رائد من مشاريع OWASP، منشور برخصة Apache-2.0. لا يقرأ شيفرتك: بل يقرأ جرد ما يتضمّنه تطبيقك، أي قائمة SBOM (Software Bill of Materials)، بصيغة CycloneDX. يُعرَّف كل مكوّن فيها بعنوان Package URL الخاص به (pkg:npm/[email protected]، pkg:maven/…)، ما يتيح مطابقته دون لبس مع قواعد بيانات الثغرات: NVD وGitHub Advisories وOSV.

الفرق بينه وبين ماسح يُشغَّل في خط CI مسألة زمن. فالماسح يحكم على بناء اليوم؛ أما Dependency-Track فيحتفظ بكل إصدارات كل مشاريعك ويعيد تقييمها كلما تحدّثت قواعد بياناته. الثغرة التي تُنشر بعد ثلاثة أشهر ستُرصد على الإصدار الذي تنشره اليوم.

ما يقدّمه لك Dependency-Track

  • محفظة مشاريع — كل تطبيق وكل إصدار، مع قائمة مكوّناته المباشرة والمتعدّية.
  • تنبيهات بأثر رجعي — الثغرة المنشورة بعد النشر تظهر على الإصدارات العاملة في الإنتاج.
  • سياسات — تراخيص محظورة، وأقصى درجة خطورة مقبولة، ومكوّنات ممنوعة، تُقيَّم مع كل إرسال لقائمة SBOM.
  • فرز الثغرات — درجة الخطورة، ومؤشر EPSS لاحتمال الاستغلال، ومتابعة للتحليلات («غير معني»، «مُصحَّح»…).
  • إشعارات — Slack أو Microsoft Teams أو webhook أو البريد الإلكتروني، حسب المشروع ودرجة الخطورة.
  • واجهة API كاملة — إرسال قوائم SBOM وقراءة النتائج والإدارة، مع مفاتيح API لكل فريق.

ماسح لمرة واحدة أم Dependency-Track على خادمك

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

ماسح يُشغَّل في خط CIمع Dependency-Track على خادمك
توقيت التحليلعند البناء، ثم لا شيءمع كل بناء، ثم باستمرار
ثغرة منشورة بعد النشرغير مرئية حتى البناء التاليتُرصد على الإصدارات العاملة في الإنتاج
النظرة الشاملةتقرير لكل مستودعالمحفظة كاملة، مع البحث حسب المكوّن
التراخيصحسب الأداةسياسات تراخيص صريحة
أين يقيم الجردفي سجلات CIعلى خادمك، مع سجلّه التاريخي

تجهيز الخادم

جهّز خادم VPS بنظام Ubuntu 24.04 بذاكرة 4 غيغابايت ومعالجين افتراضيين على الأقل: خادم API، المكتوب بلغة Java، محدود بـ 2 غيغابايت، ويتقاسم PostgreSQL الباقي مع النظام. وإذا تجاوزت بضع عشرات من المشاريع المحللة يوميًا، فانتقل إلى 8 غيغابايت. واحسب 30 غيغابايت من القرص.

ثبّت Docker وإضافة Compose، ثم وجّه نطاقًا فرعيًا (مثلًا dtrack.example.com) إلى عنوان IP الخاص بالخادم: سترسل خطوطك قوائم SBOM إلى هذا العنوان، وستُفتح واجهة الويب عليه.

curl -fsSL https://get.docker.com | sh
docker compose version

تثبيت Dependency-Track باستخدام Docker Compose

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

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

    mkdir -p /opt/dependency-track && cd /opt/dependency-track
    cat > .env <<EOF
    DB_PASSWORD=$(openssl rand -hex 16)
    ADMIN_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. كتابة إعدادات الوكيل الداخلي

    تستدعي واجهة الويب واجهة API على عنوانها هي. لذلك يوجّه nginx صغير المسار /api إلى خادم API وكل ما عداه إلى الواجهة: منفذ واحد للنشر، ونطاق واحد، ودون أي ضبط لـ CORS.

    server {
      listen 80;
      client_max_body_size 64m;
      location /api/ {
        proxy_pass http://apiserver:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
      }
      location / {
        proxy_pass http://frontend:8080;
        proxy_set_header Host $host;
      }
    }

    احفظ هذه الكتلة في /opt/dependency-track/proxy.conf.

  3. كتابة ملف docker-compose.yml

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

    services:
      db:
        image: postgres:18.7-alpine
        restart: unless-stopped
        environment:
          POSTGRES_DB: dtrack
          POSTGRES_USER: dtrack
          POSTGRES_PASSWORD: ${DB_PASSWORD}
        volumes:
          - db:/var/lib/postgresql
        healthcheck:
          test: ["CMD-SHELL", "pg_isready -q -U dtrack -d dtrack"]
          interval: 10s
          retries: 30
    
      apiserver:
        image: ghcr.io/dependencytrack/apiserver:5.2.2
        restart: unless-stopped
        depends_on:
          db:
            condition: service_healthy
        deploy:
          resources:
            limits:
              memory: 2g
        environment:
          DT_DATASOURCE_URL: jdbc:postgresql://db:5432/dtrack
          DT_DATASOURCE_USERNAME: dtrack
          DT_DATASOURCE_PASSWORD: ${DB_PASSWORD}
        volumes:
          - data:/data
    
      frontend:
        image: ghcr.io/dependencytrack/frontend:5.2.2
        restart: unless-stopped
        environment:
          API_BASE_URL: ""
    
      proxy:
        image: nginx:1.27-alpine
        restart: unless-stopped
        depends_on: [apiserver, frontend]
        ports:
          - "127.0.0.1:8127:80"
        volumes:
          - ./proxy.conf:/etc/nginx/conf.d/default.conf:ro
    
    volumes:
      db: {}
      data: {}
  4. تشغيل الحزمة

    ينشئ التشغيل الأول مخطط قاعدة البيانات، ثم ينزّل خادم API قواعد بيانات الثغرات في الخلفية.

    docker compose up -d
    curl -s http://127.0.0.1:8127/api/version

    يردّ الأمر الثاني برقم إصدار الخادم فور جاهزية واجهة API.

  5. استبدال كلمة مرور المصنع

    يُنشأ الحساب admin بكلمة المرور admin. استبدلها قبل أي نشر:

    . ./.env
    curl -fsS http://127.0.0.1:8127/api/v1/user/forceChangePassword \
      --data-urlencode username=admin --data-urlencode password=admin \
      --data-urlencode newPassword="$ADMIN_PASSWORD" \
      --data-urlencode confirmPassword="$ADMIN_PASSWORD"

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

يفرض Dependency-Track فعلًا تغيير كلمة المرور عند أول تسجيل دخول، لكن بين التشغيل وهذا الدخول يستطيع أيٌّ كان أن يفعل ذلك بدلًا منك ويستولي على جرد تطبيقاتك — أي على قائمة ثغراتها. استبدل كلمة المرور قبل ضبط nginx.

نشر Dependency-Track عبر HTTPS خلف nginx

يستقبل nginx الخاص بالخادم النطاق ويمرّر الطلبات إلى المنفذ المحلي. ارفع الحدّ الأقصى لحجم الإرسال: فقائمة SBOM لتطبيق كبير تتجاوز سريعًا الميغابايت الواحد الذي يقبله nginx افتراضيًا.

server {
  server_name dtrack.example.com;
  client_max_body_size 64m;
  location / {
    proxy_pass http://127.0.0.1:8127;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

ثم أصدر الشهادة بالأمر certbot --nginx -d dtrack.example.com. افتح https://dtrack.example.com، وسجّل الدخول بالحساب admin وكلمة مرورك الجديدة، وأنشئ حسابات الفريق من Administration → Access Management.

إرسال قوائم SBOM من خط CI

من Administration → Access Management → Teams، افتح فريق Automation وأنشئ مفتاح API؛ واحفظه في أسرار CI. بعد ذلك ينتج الخط قائمة SBOM ويرسلها مع كل بناء — هنا باستخدام cdxgen، الذي يتعرّف على معظم المنظومات البرمجية (npm وMaven وPyPI وComposer وGo…):

# .github/workflows/sbom.yml
name: sbom
on: [push]
jobs:
  sbom:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx --yes @cyclonedx/cdxgen -o bom.json
      - run: |
          curl -fsS -X POST https://dtrack.example.com/api/v1/bom \
            -H "X-Api-Key: ${{ secrets.DT_API_KEY }}" \
            -F autoCreate=true -F projectName=${{ github.event.repository.name }} \
            -F projectVersion=${{ github.ref_name }} -F [email protected]

يظهر المشروع في المحفظة مع الإصدار المُرسَل. ولصورة حاوية، ينتج الأمر syft <image> -o cyclonedx-json > bom.json ما يعادل ذلك، بما فيه حزم النظام.

السياسات والإشعارات

تحوّل السياسةُ الملاحظةَ إلى قاعدة. من Policy Management، أنشئ مثلًا سياسة أمان ترصد كل ثغرة بدرجة خطورة *High* فما فوق، وسياسة تراخيص ترفض التراخيص التي يحظرها عقدك. يُقيَّم كل إرسال لقائمة SBOM، وتظهر المخالفات على المشروع.

ومن Administration → Notifications، اربط بعد ذلك قناةً — Slack أو Microsoft Teams أو webhook أو البريد الإلكتروني — بالحدثين *New Vulnerability* و*Policy Violation*، مقصورين على المشاريع المهمة. هذا التنبيه هو ما يصنع قيمة الأداة: يصل يوم نشر الثغرة، لا يوم البناء التالي.

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

كل الحالة المفيدة مخزنة في PostgreSQL: المشاريع وقوائم SBOM والتحليلات والإعدادات. انسخ قاعدة البيانات احتياطيًا، أما المجلد /data فيُعاد بناؤه (وهو يحمل أساسًا قواعد بيانات الثغرات المنزّلة).

cd /opt/dependency-track
docker compose exec -T db pg_dump -U dtrack dtrack | gzip > dtrack-$(date +%F).sql.gz

للتحديث، اقرأ ملاحظات الإصدار، وغيّر وسمَي الصورتين (apiserver وfrontend، دائمًا على الإصدار نفسه)، ثم شغّل docker compose pull && docker compose up -d. يرحّل خادم API المخطط عند التشغيل. واحتفظ بنسخة احتياطية حديثة قبل كل ترقية.

Dependency-Track بنقرة واحدة على ServOrbit

على خادم ServOrbit، يُثبَّت Dependency-Track من المتجر: الصور الرسمية وPostgreSQL والوكيل الداخلي جاهزة، وكلمة مرور المصنع لحساب admin مستبدلة بكلمة مرور مولّدة تُعرض في مساحة العميل، والوكيل العكسي nginx عبر HTTPS على نطاقك أو على النطاق الفرعي المجاني للخادم. لا يبقى عليك سوى إنشاء مفتاح API لخط CI وإرسال أول قائمة SBOM.

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

تبعياتك تحت المراقبة، على خادمك

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