Nerva
_{Nerva: أداة سريعة لسطر أوامر لبصمة الخدمات}

الميزات • التثبيت • البدء السريع • الاستخدام • البروتوكولات • المكتبة • حالات الاستخدام • استكشاف الأخطاء وإصلاحها

بصمة خدمات عالية الأداء مكتوبة بلغة Go. حدد أكثر من 170 بروتوكول شبكة عبر وسائط النقل TCP وUDP وSCTP مع استخراج غني للبيانات الوصفية.

تكتشف Nerva وتحدد بسرعة الخدمات التي تعمل على منافذ الشبكة المفتوحة. استخدمها إلى جانب ماسحات المنافذ مثل Naabu لبصمة الخدمات المكتشفة، أو دمجها في خطوط أنابيب الأمان لديك للاستطلاع الآلي.

الميزات

• أكثر من 170 إضافة بروتوكول — قواعد البيانات، الوصول عن بُعد، خدمات الويب، المراسلة، البروتوكولات الصناعية والاتصالات
• 76 أداة بصمة HTTP — اكتشف تقنيات الويب بما في ذلك جدران الحماية وقواعد البيانات وخوادم الذكاء الاصطناعي/LLM والمزيد
• كشف سوء التكوين الأمني — حدد المشكلات الأمنية الشائعة مثل واجهات API غير المصادق عليها والبروتوكولات النصية الصريحة (--misconfigs)
• دعم وسائط نقل متعددة — TCP (افتراضي)، UDP (--udp)، وSCTP (--sctp، Linux فقط)
• دعم الوكيل — وجّه حركة الفحص بشفافية عبر وكلاء SOCKS5 أو HTTP مع دقة DNS قابلة للتكوين
• بيانات وصفية غنية — استخرج الإصدارات والتكوينات والتفاصيل ذات الصلة بالأمان من كل خدمة
• الوضع السريع — افحص المنافذ الافتراضية فقط للاستطلاع السريع (--fast)
• إخراج مرن — تنسيقات JSON أو CSV أو قابلة للقراءة البشرية
• متوافق مع خطوط الأنابيب — استقبل المدخلات من Naabu أو Nmap أو أي أداة تُخرج host:port
• مكتبة Go — استوردها مباشرة في تطبيقات Go الخاصة بك

التثبيت

الإصدارات

حمّل ملفاً تنفيذياً جاهزاً من صفحة الإصدارات.

من GitHub```sh

go install github.com/praetorian-inc/nerva/cmd/nerva@latest

### من المصدر```sh
git clone https://github.com/praetorian-inc/nerva.git
cd nerva
go build ./cmd/nerva
./nerva -h

Docker```sh

git clone https://github.com/praetorian-inc/nerva.git cd nerva docker build -t nerva . docker run --rm nerva -h docker run --rm nerva -t example.com:80 --json

## البدء السريع

بصمة هدف واحد:```sh
nerva -t example.com:22
# ssh://example.com:22

احصل على بيانات JSON وصفية مفصلة:```sh nerva -t example.com:22 --json

{"host":"example.com","ip":"93.184.216.34","port":22,"protocol":"ssh","transport":"tcp","metadata":{...}}

التوجيه من ماسح منافذ:```sh
naabu -host example.com -silent | nerva
# http://example.com:80
# ssh://example.com:22
# https://example.com:443

المرجع الكامل — كل أمر فرعي واسم مستعار وعلم، بما في ذلك تلك المخفية من --help — يتم توليده في docs/CLI.md.

الاستخدام```

nerva [flags]

TARGET SPECIFICATION: Requires host:port or ip:port format. Assumes ports are open.

EXAMPLES: nerva -t example.com:80 nerva -t example.com:80,example.com:443 nerva -l targets.txt nerva --json -t example.com:80 cat targets.txt | nerva

### أمثلة

**أهداف متعددة:**```sh
nerva -t example.com:22,example.com:80,example.com:443

من الملف:```sh nerva -l targets.txt --json -o results.json

**فحص UDP** (قد يتطلب صلاحيات الجذر):```sh
sudo nerva -t example.com:53 -U
# dns://example.com:53

فحص SCTP (لينكس فقط):```sh nerva -t telecom-server:3868 -S

diameter://telecom-server:3868

**الوضع السريع** (المنافذ الافتراضية فقط):```sh
nerva -l large-target-list.txt --fast --json

توجيه الوكيل مع تحليل DNS عن بُعد:```sh nerva -t target.internal:80 --proxy socks5://127.0.0.1:1080 --dns-order p

### اكتشاف الأخطاء الأمنية في الإعدادات

يمكن لـ Nerva تحديد الأخطاء الأمنية الشائعة في الإعدادات عند تمكينها باستخدام `--misconfigs`:```sh
nerva -t example.com:2375 --misconfigs --json

التكوينات الخاطئة المكتشفة:

مثال على المخرجات مع التكوينات الخاطئة:```json { "host": "example.com", "port": 2375, "protocol": "docker", "anonymous_access": true, "security_findings": [ { "id": "docker-unauth-api", "severity": "critical", "description": "Docker API accessible without authentication", "evidence": "Successfully queried /version endpoint without credentials" } ] }

### دعم البروكسي

يدعم Nerva توجيه حركة الفحص عبر بروكسيات SOCKS5 وHTTP مع دقة DNS قابلة للتكوين.

**مخططات البروكسي المدعومة:**

- `socks5://` - بروكسي SOCKS5 مع دقة DNS محلية
- `socks5h://` - بروكسي SOCKS5 مع دقة DNS من جانب البروكسي (دائمًا)
- `http://` - بروكسي HTTP CONNECT
- `https://` - بروكسي HTTPS CONNECT

**مصادقة البروكسي:**```sh
# Inline authentication (URL format)
nerva -t example.com:80 --proxy socks5://username:[email protected]:1080

# Separate authentication flag
nerva -t example.com:80 --proxy socks5://127.0.0.1:1080 --proxy-auth username:password

استراتيجيات تحليل DNS (--dns-order):

ملاحظة: مخطط socks5h:// يفرض تلقائياً تحليل DNS من جانب الوكيل (مكافئ لـ --dns-order p)

مثال فحص Tor:```sh

Scan .onion services through Tor (SOCKS5 proxy on port 9050)

nerva -t http://example.onion:80 --proxy socks5h://127.0.0.1:9050

**UDP عبر البروكسي:**```sh
# UDP scanning through SOCKS5 proxy (limited support)
nerva -t target.com:161 --proxy socks5://127.0.0.1:1080 --udp

⚠️ قيود UDP: دعم UDP عبر SOCKS5 محدود. لا تدعم جميع خوادم SOCKS5 اقتران UDP. قد يحدث الرجوع إلى UDP المحلي.

المسح المتوازي مع تحديد المعدل:```sh nerva -l large-target-list.txt -W 100 -H 5 -R 50 -v

**إيقاف التشغيل بلطف** (Ctrl+C يعيد نتائج جزئية):```sh
nerva -l huge-target-list.txt -W 50 -v
# Press Ctrl+C to stop — collected results are still printed

البروتوكولات المدعومة

أكثر من 170 إضافة لكشف الخدمات عبر TCP و UDP و SCTP:

وحدات بصمة HTTP (66)

كشف التقنيات لخدمات الويب، مُنظَّمة حسب الفئة:

الجدران النارية وأمن الشبكات (12)

الذكاء الاصطناعي/LLM وتعلّم الآلة (6)

قواعد البيانات ومخازن البيانات (12)

DevOps والبنية التحتية (14)

خوادم الويب وأطر العمل (10)

المؤسسات والأعمال (8)

المنزل وإنترنت الأشياء (2)

أخرى (2)

قواعد البيانات (20)

الوصول عن بُعد (6)

الويب وواجهات API (2)

المراسلة وقوائم الانتظار (10)

خدمات الملفات والمجلدات (7)

خدمات الشبكة (11)

أنظمة التحكم الصناعي (18)

الاتصالات وVoIP (17)

VPN والأمن (11)

الوصول عن بُعد والإدارة (10)

أدوات المطوّرين (8)

استخدام المكتبة

استورد Nerva في تطبيقات Go الخاصة بك:```go package main

import ( "context" "fmt" "log" "net/netip" "time"

"github.com/praetorian-inc/nerva/pkg/plugins"
"github.com/praetorian-inc/nerva/pkg/scan"

)

func main() { // Configure scan config := scan.Config{ DefaultTimeout: 2 * time.Second, FastMode: false, UDP: false, Proxy: "socks5://127.0.0.1:1080", // optional ProxyAuth: "username:password", // optional DNSOrder: "p", // resolver strategy }

// Create target
ip, _ := netip.ParseAddr("93.184.216.34")
target := plugins.Target{
    Address: netip.AddrPortFrom(ip, 22),
    Host:    "example.com",
}

// Run scan
results, err := scan.ScanTargets(context.Background(), []plugins.Target{target}, config)
if err != nil {
    log.Fatal(err)
}

// Process results
for _, result := range results {
    fmt.Printf("%s:%d - %s (%s)\n",
        result.Host, result.Port,
        result.Protocol, result.Transport)
}

}

راجع [examples/service-fingerprinting-example.go](https://github.com/praetorian-inc/nerva/blob/main/examples/service-fingerprinting-example.go) للحصول على مثال كامل قابل للتشغيل.

## حالات الاستخدام

### اختبار الاختراق

البصمة السريعة للخدمات المكتشفة أثناء الاستطلاع لتحديد نواقل الهجوم المحتملة.

### خطوط أنابيب اكتشاف الأصول

ادمج مع Naabu أو Masscan لجرد الأصول على نطاق واسع:```sh
naabu -host 10.0.0.0/24 -silent | nerva --json | jq '.protocol'

فحص أمان CI/CD

دمج في خطوط أنابيب النشر للتحقق من أن الخدمات المتوقعة فقط هي المكشوفة.

استطلاع Bug Bounty

تعداد الخدمات بسرعة عبر أهداف النطاق للعثور على نقاط نهاية مثيرة للاهتمام.

تحليل شبكات الاتصالات

بصمة عقد Diameter في شبكات LTE/5G باستخدام نقل SCTP (Linux):```sh nerva -t mme.telecom.local:3868 -S --json

## البنية المعمارية```mermaid
graph LR
    A[host:port input] --> B[Target Parser]
    B --> C[Scan Engine]
    C --> D{Transport}
    D -->|TCP| E[TCP Plugins]
    D -->|UDP| F[UDP Plugins]
    D -->|SCTP| G[SCTP Plugins]
    E --> H[Service Detection]
    F --> H
    G --> H
    H --> I[Metadata Extraction]
    I --> J[JSON/CSV/Text Output]

لماذا Nerva؟

مقابل Nmap

• إعدادات افتراضية أذكى: يتحقق Nerva من البروتوكول الأكثر احتمالاً أولاً بناءً على رقم المنفذ
• مخرجات منظمة: دعم أصلي لـ JSON/CSV لسهولة التحليل والتكامل مع خطوط الأنابيب
• مركّز: بصمة الخدمة فقط — اقرنه مع ماسحات المنافذ المخصصة للاستكشاف

مقابل zgrab2

• الكشف التلقائي: لا حاجة لتحديد البروتوكول مسبقاً
• استخدام أبسط: nerva -t host:port مقابل echo host | zgrab2 http -p port

استكشاف الأخطاء وإصلاحها

لا توجد مخرجات

السبب: المنفذ مغلق أو لم يتم اكتشاف خدمة مدعومة.

الحل: تحقق من أن المنفذ مفتوح:```sh nc -zv example.com 80

### أخطاء المهلة الزمنية

**السبب**: المهلة الافتراضية البالغة ثانيتين قصيرة جدًا للخدمات البطيئة.

**الحل**: قم بزيادة المهلة:```sh
nerva -t example.com:80 -w 5000  # 5 seconds

خدمات UDP غير المكتشفة

السبب: فحص UDP معطّل افتراضيًا.

الحل: فعّله باستخدام العلامة -U (قد يتطلب صلاحيات root):```sh sudo nerva -t example.com:53 -U

### SCTP لا يعمل

**السبب**: SCTP مدعوم فقط على Linux.

**الحل**: شغّله على نظام Linux أو حاوية:```sh
docker run --rm nerva -t telecom:3868 -S

المصطلحات

• الخدمة (Service): خدمة شبكية تعمل على منفذ (SSH، HTTP، PostgreSQL، إلخ)
• البصمة (Fingerprinting): اكتشاف وتحديد نوع الخدمة وإصدارها وتكوينها
• الإضافة (Plugin): وحدة كشف خاصة ببروتوكول معين
• الوضع السريع (Fast Mode): فحص المنفذ الافتراضي فقط لكل بروتوكول (تحسين 80/20)
• النقل (Transport): بروتوكول طبقة الشبكة (TCP، UDP، أو SCTP)

الدعم

إذا وجدت Nerva مفيدًا، يُرجى التفكير في منحه نجمة:

المساهمة

نرحب بالمساهمات! راجع CONTRIBUTING.md للحصول على الإرشادات.

الترخيص

Apache 2.0 — راجع LICENSE للحصول على التفاصيل.

شكر وتقدير

Nerva هو fork مُصان من fingerprintx، الذي طورته في الأصل دفعة المتدربين لعام 2022 في Praetorian:

• Soham Roy
• Jue Huang
• Henry Jung
• Tristan Wiesepape
• Joseph Henry
• Noah Tutt
• Nathan Sportsman