واجهة RapidDNS CLI سطر الأوامر

中文文档

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

الميزات

• بحث DNS: البحث حسب النطاق أو عنوان IP أو CIDR.
• استعلام متقدم: استخدام صيغة استعلام قوية (مثل domain:example AND tld:com AND type:A).
• تصدير البيانات: إدارة مهام التصدير تلقائياً: البدء والتحقق من الحالة والتنزيل وفك الضغط.
• استخراج البيانات:
  • استخراج النطاقات الفرعية وحذف المكرر منها إلى قائمة.
  • استخراج عناوين IP وحذف المكرر منها إلى قائمة.
  • توليد إحصائيات القطاعات IP (عدد الشبكات الفرعية).
• خرج مرن: حفظ النتائج بتنسيقات JSON أو CSV أو نص.
• دعم الأنابيب (Pipeline): فصل نظيف بين stdout/stderr للتسلسل مع أدوات أخرى.
• الإعدادات: إدارة سهلة لمفاتيح API.

التثبيت

عبر go install

المتطلبات: Go 1.16+

يمكنك تثبيت أحدث إصدار مباشرة باستخدام:

go install github.com/rapiddns/rapiddns-cli@latest

بعد التثبيت، تأكد من أن $GOPATH/bin (أو دليل bin الخاص بـ Go لإعداداتك) موجود في PATH الخاص بك، ثم يمكنك تشغيل:

rapiddns-cli --help

البناء من المصدر

المتطلبات: Go 1.16+

1. استنساخ المستودع:

   root@kitploit:~

   git clone https://github.com/rapiddns/rapiddns-cli.git
   cd rapiddns-cli
   

2. بناء لمنصتك:

   Windows:

   root@kitploit:~

   go build -o rapiddns-cli
   

   Linux:

   root@kitploit:~

   GOOS=linux GOARCH=amd64 go build -o rapiddns-cli
   

   macOS (Intel):

   root@kitploit:~

   GOOS=darwin GOARCH=amd64 go build -o rapiddns-cli
   

   macOS (Apple Silicon/M1/M2):

   root@kitploit:~

   GOOS=darwin GOARCH=arm64 go build -o rapiddns-cli
   

الإعدادات

لاستخدام الميزات الكاملة لـ RapidDNS (خاصة التصدير والبحث غير المحدود)، تحتاج إلى مفتاح API.

1. احصل على مفتاح API الخاص بك من ملف RapidDNS الشخصي.
2. قم بتعيينه في واجهة CLI:

rapiddns-cli config set-key <YOUR_API_KEY>

التحقق من المفتاح الحالي:

rapiddns-cli config get-key

ملاحظة: بدون مفتاح API، قد تكون نتائج البحث محدودة، وسيتم تعطيل وظيفة التصدير.

الاستخدام

1. البحث الأساسي

البحث عن نطاق أو عنوان IP أو CIDR.

rapiddns-cli search tesla.com

الخيارات:

• --page: رقم الصفحة (الافتراضي 1).
• --type: التصفية حسب النوع (subdomain، same_domain، ip، ip_segment، advanced).
• -o, --output: تنسيق الخرج (json، csv، text). الافتراضي: json.
• -f, --file: حفظ الخرج في ملف معين.
• --column: إخراج عمود معين فقط إلى وحدة التحكم (subdomain، ، ، ).

أمثلة:

# حفظ بتنسيق CSV
rapiddns-cli search tesla.com -o csv -f results.csv

# جلب ما يصل إلى 1000 سجل تلقائيا
rapiddns-cli search tesla.com --max 1000

# استخراج النطاقات الفرعية فقط
rapiddns-cli search tesla.com --extract-subdomains

# استخراج عناوين IP والإحصائيات فقط
rapiddns-cli search tesla.com --extract-ips

# استخراج كليهما
rapiddns-cli search tesla.com --extract-subdomains --extract-ips

2. الأنابيب (Pipeline) وخرج وحدة التحكم

مصمم للمخترقين والأتمتة. المخرج القياسي (stdout) هو بيانات نظيفة، بينما تذهب الحالة والأخطاء إلى stderr.

إخراج النطاقات الفرعية فقط (قائمة نصية):

rapiddns-cli search tesla.com --column subdomain -o text

الخرج:

api.tesla.com
www.tesla.com
...

إخراج عناوين IP فقط (مصفوفة JSON):

rapiddns-cli search tesla.com --column ip -o json

الخرج:

[
  "1.2.3.4",
  "5.6.7.8"
]

الوضع الصامت (الاستخراج إلى ملفات فقط):

rapiddns-cli search tesla.com --extract-subdomains --silent

3. الاستعلام المتقدم

تنفيذ استعلامات معقدة باستخدام صيغة RapidDNS عبر الأمر search مع --type advanced.

rapiddns-cli search "domain:apple.com AND type:A" --type advanced

4. تصدير البيانات (موصى به للبيانات الكبيرة)

يتولى أمر التصدير سير العمل بأكمله: طلب التصدير، انتظار الانتهاء، تنزيل الملف، ومعالجته.

rapiddns-cli export start tesla.com

الخيارات:

• --type: نوع البحث (subdomain، sameip، ip_segment، advanced). استخدم advanced لصيغة الاستعلام.
• --max: الحد الأقصى للسجلات المراد تصديرها (0 يعني الكل، الافتراضي 0).
• --compress: ضغط النتيجة بصيغة ZIP (الافتراضي true).
• --extract-subdomains: استخراج النطاقات الفرعية من ملف CSV الذي تم تنزيله.
• --extract-ips: استخراج عناوين IP وتوليد إحصائيات الشبكات الفرعية من ملف CSV الذي تم تنزيله.

مثال سير عمل كامل:

rapiddns-cli export start tesla.com --max 10000 --extract-subdomains --extract-ips

مثال تصدير متقدم:

لاستخدام صيغة الاستعلام المتقدم للتصدير، قم بتعيين --type advanced:

rapiddns-cli export start "domain:apple AND type:A" --type advanced

هذا الأمر سيقوم بما يلي:

1. تشغيل مهمة تصدير لـ tesla.com.
2. انتظار معالجة الخادم.
3. تنزيل ملف ZIP إلى الدليل result/.
4. فك ضغط المحتويات.
5. إنشاء tesla.com_subdomains.txt (قائمة النطاقات الفرعية).
6. إنشاء tesla.com_ips.txt (قائمة عناوين IP الفريدة).
7. إنشاء tesla.com_ip_stats.txt (إحصائيات الشبكات الفرعية IP).

هيكل الخرج

يتم حفظ جميع النتائج افتراضياً في الدليل result/.

• {keyword}_subdomains.txt: قائمة نظيفة من النطاقات الفرعية الفريدة.
• {keyword}_ips.txt: قائمة نظيفة من عناوين IP الفريدة.
• {keyword}_ip_stats.txt: إحصائيات أعداد IP لكل شبكة فرعية (IPv4 /24, IPv6 /64).
• rapiddns_export_{keyword}_{date}.csv: بيانات التصدير الخام.

المساعدة

قم بتشغيل أي أمر مع --help لمشاهدة المزيد من التفاصيل.

rapiddns-cli --help
rapiddns-cli search --help
rapiddns-cli export --help