yakushstanislav/ultravioletمحرك اكتشاف وبحث للشبكات ذاتي الاستضافة مع مسح مستمر للمنافذ، وفحص عميق للبروتوكولات عبر حوالي 100 خدمة، ومطابقة محلية لـ CVE، وبحث نصي كامل لجرد البنية التحتية ومراقبة المخاطر.
اكتشاف وبحث شبكي ذاتي الاستضافة — نسختك الخاصة من Shodan، على أجهزتك.
فحص TCP/UDP · ~100 فحص بروتوكول · بصمات TLS/JARM · مطابقة CVE · بحث نصي كامل · تتبع الفروقات · تنبيهات
بدء سريع · الميزات · البنية · الوثائق · قائمة التحقق للإنتاج
مهم. افحص فقط الشبكات التي تملكها أو لديك إذن كتابي لفحصها. ينفّذ UltraViolet استطلاعًا سلبيًا للخدمات — فهو لا يستغل الثغرات.
| حالة الاستخدام | ما الذي تحصل عليه |
|---|---|
| حدود الشبكة والجرد | اكتشاف مستمر للمنافذ والخدمات المفتوحة عبر نطاقات CIDR |
| البحث في البنية التحتية | بحث نصي كامل عبر محتوى HTTP واللافتات وTLS وDNS والثغرات (CVEs) |
| المخاطر والامتثال | مطابقة محلية مع NVD بالإضافة إلى CISA KEV وEPSS — دون الاعتماد على السحابة |
| النشر المعزول (Air-gapped) | أرشيف دون اتصال يشمل صور Docker وبذرة CVE وملف GeoIP MMDB على القرص |
| تتبع التغييرات | الفروقات بين عمليات الفحص، وأحداث WebSocket، وتنبيهات على عمليات البحث المحفوظة |
مستأجر واحد، ومكدّس Docker Compose واحد، وسيطرة كاملة على بياناتك.
الاكتشاف
SCAN_ALLOWED_CIDRS مع حدود للمضيفات والمنافذفحوصات عميقة (~100 بروتوكول)
robots.txt وsecurity.txt ومكدّس التقنياتالإثراء
الثغرات (CVE) والمخاطر
العمليات
viewer / operator / admin)، JWT + رموز التحديث/metrics، وملف Grafana اختياريflowchart TB
Browser["Browser"]
FE["service-frontend<br/>React + nginx"]
API["uv-api<br/>REST · WS · metrics"]
PG[("PostgreSQL 16")]
SCAN["uv-scanner<br/>probe pipeline"]
Browser --> FE
FE -->|"/api"| API
FE -->|"/realtime"| API
API <--> PG
SCAN <--> PG
API -.->|LISTEN/NOTIFY| API
صورة واجهة المستخدم في الإصدار توجّه /api/ و/realtime إلى uv-api — أصل واحد، دون إعادة بناء للواجهة الأمامية لكل عنوان API.
| الدليل | الغرض |
|---|---|
service-api/ | Go: uv-api (واجهة HTTP API وWebSocket والعمال) + uv-scanner (خط المعالجة) |
service-frontend/ | React 19 + Vite + RTK — الفحوصات والمضيفون والبحث ولوحة المعلومات |
service-documentation-frontend/ | VitePress — وثائق المستخدم والمشغّل |
service-env/ | docker-compose والأسرار وinstall.sh / upgrade.sh / النسخ الاحتياطي |
قواعد تطوير الواجهة الخلفية: CLAUDE.md.
المتطلبات: Go 1.25+ ومحرك Docker ≥ 24 وذاكرة ~4 جيجابايت RAM. صور الإنتاج موجهة لنظام Linux amd64.
مسار المبتدئين — اسحب الصور المنشورة باستخدام
service-env/docker-compose.registry.yml:
cd service-env
cp env.registry.example .env
# set POSTGRES_PASSWORD, AUTH_JWT_SECRET, AUTH_BOOTSTRAP_PASSWORD
mkdir -p geoip catalog-seed
docker compose -f docker-compose.registry.yml pull
docker compose -f docker-compose.registry.yml up -d
# UI → http://localhost:3000
انظر Docker Registry في موقع الوثائق.
تنسخ صور الواجهة البرمجية والماسح الضوئي الملفات الثنائية المجمّعة مسبقًا من service-api/bin/ (لا تُجمَّع داخل Docker). يشغّل make dev الأمر make -C service-api build-linux قبل docker compose … --build.
git clone https://github.com/yakushstanislav/UltraViolet.git
cd UltraViolet/service-env
cp .env.example .env
mkdir -p secrets
openssl rand -hex 32 > secrets/postgres_password
openssl rand -hex 32 > secrets/auth_jwt_secret
cd ..
make dev
| URL | الغرض |
|---|---|
| http://localhost:3000 | واجهة المستخدم (API عبر nginx /api/) |
| http://localhost:8080 | API مباشرة |
| http://localhost:9090/metrics | Prometheus |
الإقلاع التطويري: admin / admin (فقط عندما APP_ENV≠production).
الدليل الكامل — VitePress في service-documentation-frontend/docs/:
make docs-dev # → http://localhost:5173
في بيئة الإنتاج، فعّل ملف docs:
cd service-env && docker compose --profile docs up -d
# → http://localhost:${UV_DOCUMENTATION_PORT:-3002}
الأقسام الرئيسية: التثبيت · الفحص · API · النشر · التثبيت دون اتصال.
make dev # build-linux → compose prod + dev override --build
أعد بناء ملفات Go الثنائية بعد تغييرات الواجهة الخلفية (make -C service-api build-linux)، ثم أعد التشغيل أو أعد تنفيذ make dev.
make dev-db # PostgreSQL only on :5432