projectdiscovery/dnsxdnsx هي أداة DNS سريعة ومتعددة الأغراض تتيح لك تشغيل استعلامات DNS متعددة من اختيارك باستخدام قائمة من المحللات التي يقدمها المستخدم.
<h1 align="center">
<img src="https://assets.kitploit.com/production/public/readmes/3923/abdf7c5ef50e7d740b96aad5a151b9ac75700de029a681a6b3dc6b51efe45b7d.png" alt="dnsx" width="200px">
<br>
</h1>
<h4 align="center">مجموعة أدوات DNS سريعة ومتعددة الأغراض مصممة لتشغيل استعلامات DNS</h4>
<p align="center">
<a href="https://goreportcard.com/report/github.com/projectdiscovery/dnsx"><img src="https://goreportcard.com/badge/github.com/projectdiscovery/dnsx"></a>
<a href="https://github.com/projectdiscovery/dnsx/issues"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat"></a>
<a href="https://github.com/projectdiscovery/dnsx/releases"><img src="https://img.shields.io/github/release/projectdiscovery/dnsx"></a>
<a href="https://twitter.com/pdiscoveryio"><img src="https://img.shields.io/twitter/follow/pdiscoveryio.svg?logo=twitter"></a>
<a href="https://discord.gg/projectdiscovery"><img src="https://img.shields.io/discord/695645237418131507.svg?logo=discord"></a>
</p>
<p align="center">
<a href="#features">الميزات</a> •
<a href="#installation-instructions">التثبيت</a> •
<a href="#usage">الاستخدام</a> •
<a href="#running-dnsx">تشغيل `dnsx`</a> •
<a href="#wildcard-filtering">Wildcard</a> •
<a href="#-notes">ملاحظات</a> •
<a href="https://discord.gg/projectdiscovery">انضم إلى Discord</a>
</p>
---
`dnsx` هي مجموعة أدوات DNS سريعة ومتعددة الأغراض مصممة لتشغيل استعلامات متنوعة عبر مكتبة [retryabledns](https://github.com/projectdiscovery/retryabledns). وهي تدعم استعلامات DNS متعددة، والمحللات المقدمة من المستخدم، وتصفية DNS wildcard مثل [shuffledns](https://github.com/projectdiscovery/shuffledns) وغيرها.
# الميزات
<h1 align="left">
<img src="https://assets.kitploit.com/production/public/readmes/3923/e0be49be16e94055f8ca00845ffa701135d23cba6aca284260e6208fa8c20026.png" alt="dnsx" width="700px"></a>
<br>
</h1>
- أداة بسيطة ومفيدة للاستعلام عن سجلات DNS.
- دعم استعلامات **A, AAAA, CNAME, PTR, NS, MX, TXT, SRV, SOA**
- دعم **تحليل** / **تخمين** DNS
- دعم إدخال **resolver** مخصص
- دعم صيغ resolver متعددة **(TCP/UDP/DOH/DOT)**
- دعم **stdin** و **stdout**
- دعم التعامل التلقائي مع **wildcard**
# تعليمات التثبيت
يتطلب `dnsx` الإصدار **go1.21** للتثبيت بنجاح. شغّل الأمر التالي لتثبيت أحدث إصدار:
```sh
go install -v github.com/projectdiscovery/dnsx/cmd/dnsx@latest
```
# الاستخدام
```sh
dnsx -h
```
سيعرض هذا المساعدة الخاصة بالأداة. فيما يلي جميع الخيارات التي تدعمها.
```console
INPUT:
-l, -list string list of sub(domains)/hosts to resolve (file or stdin)
-d, -domain string list of domain to bruteforce (file or comma separated or stdin)
-w, -wordlist string list of words to bruteforce (file or comma separated or stdin)
QUERY:
-a query A record (default)
-aaaa query AAAA record
-cname query CNAME record
-ns query NS record
-txt query TXT record
-srv query SRV record
-ptr query PTR record
-mx query MX record
-soa query SOA record
-any query ANY record
-axfr query AXFR
-caa query CAA record
-recon query all the dns records (a,aaaa,cname,ns,txt,srv,ptr,mx,soa,axfr,caa)
-e, -exclude-type value dns query type to exclude (a,aaaa,cname,ns,txt,srv,ptr,mx,soa,axfr,caa) (default none)
FILTER:
-re, -resp display dns response
-ro, -resp-only display dns response only
-rc, -rcode string filter result by dns status code (eg. -rcode noerror,servfail,refused)
PROBE:
-cdn display cdn name
-asn display host asn information
RATE-LIMIT:
-t, -threads int number of concurrent threads to use (default 100)
-rl, -rate-limit int number of dns request/second to make (disabled as default) (default -1)
UPDATE:
-up, -update update dnsx to latest version
-duc, -disable-update-check disable automatic dnsx update check
OUTPUT:
-o, -output string file to write output
-j, -json write output in JSONL(ines) format
-omit-raw, -or omit raw dns response from jsonl output
-ot, -output-template string custom output template (e.g. -ot '{{host}} {{a}}')
DEBUG:
-hc, -health-check run diagnostic check up
-silent display only results in the output
-v, -verbose display verbose output
-raw, -debug display raw dns response
-stats display stats of the running scan
-version display version of dnsx
-nc, -no-color disable color in output
OPTIMIZATION:
-retry int number of dns attempts to make (must be at least 1) (default 2)
-hf, -hostsfile use system host file
-trace perform dns tracing
-trace-max-recursion int Max recursion for dns trace (default 32767)
-resume resume existing scan
-stream stream mode (wordlist, wildcard, stats and stop/resume will be disabled)
-timeout value maximum time to wait for a DNS query to complete (default 3s)
CONFIGURATIONS:
-auth configure projectdiscovery cloud (pdcp) api key (default true)
-r, -resolver string list of resolvers to use (file or comma separated)
-wt, -wildcard-threshold int wildcard filter threshold (default 5)
-aw, -auto-wildcard automatically detect wildcard domains for filtering
-wd, -wildcard-domain string domain name for manual wildcard filtering (mutually exclusive with -auto-wildcard; other flags will be ignored - json output recommended)
```
## تشغيل dnsx
### تحليل DNS
تصفية أسماء المضيفين النشطة من قائمة النطاقات الفرعية السلبية، التي تم الحصول عليها من مصادر متنوعة:
```console
subfinder -silent -d hackerone.com | dnsx -silent
a.ns.hackerone.com
www.hackerone.com
api.hackerone.com
docs.hackerone.com
mta-sts.managed.hackerone.com
mta-sts.hackerone.com
resources.hackerone.com
b.ns.hackerone.com
mta-sts.forwarding.hackerone.com
events.hackerone.com
support.hackerone.com
```
طباعة سجلات **A** لقائمة النطاقات الفرعية المعطاة:
```console
subfinder -silent -d hackerone.com | dnsx -silent -a -resp
www.hackerone.com [104.16.100.52]
www.hackerone.com [104.16.99.52]
hackerone.com [104.16.99.52]
hackerone.com [104.16.100.52]
api.hackerone.com [104.16.99.52]
api.hackerone.com [104.16.100.52]
mta-sts.forwarding.hackerone.com [185.199.108.153]
mta-sts.forwarding.hackerone.com [185.199.109.153]
mta-sts.forwarding.hackerone.com [185.199.110.153]
mta-sts.forwarding.hackerone.com [185.199.111.153]
a.ns.hackerone.com [162.159.0.31]
resources.hackerone.com [52.60.160.16]
resources.hackerone.com [3.98.63.202]
resources.hackerone.com [52.60.165.183]
resources.hackerone.com [read.uberflip.com]
mta-sts.hackerone.com [185.199.110.153]
mta-sts.hackerone.com [185.199.111.153]
mta-sts.hackerone.com [185.199.109.153]
mta-sts.hackerone.com [185.199.108.153]
gslink.hackerone.com [13.35.210.17]
gslink.hackerone.com [13.35.210.38]
gslink.hackerone.com [13.35.210.83]
gslink.hackerone.com [13.35.210.19]
b.ns.hackerone.com [162.159.1.31]
docs.hackerone.com [185.199.109.153]
docs.hackerone.com [185.199.110.153]
docs.hackerone.com [185.199.111.153]
docs.hackerone.com [185.199.108.153]
support.hackerone.com [104.16.51.111]
support.hackerone.com [104.16.53.111]
mta-sts.managed.hackerone.com [185.199.108.153]
mta-sts.managed.hackerone.com [185.199.109.153]
mta-sts.managed.hackerone.com [185.199.110.153]
mta-sts.managed.hackerone.com [185.199.111.153]
```
استخراج سجلات **A** لقائمة النطاقات الفرعية المعطاة:
```console
subfinder -silent -d hackerone.com | dnsx -silent -a -resp-only
104.16.99.52
104.16.100.52
162.159.1.31
104.16.99.52
104.16.100.52
185.199.110.153
185.199.111.153
185.199.108.153
185.199.109.153
104.16.99.52
104.16.100.52
104.16.51.111
104.16.53.111
185.199.108.153
185.199.111.153
185.199.110.153
185.199.111.153
```
استخراج سجلات **CNAME** لقائمة النطاقات الفرعية المعطاة:
```console
subfinder -silent -d hackerone.com | dnsx -silent -cname -resp
support.hackerone.com [hackerone.zendesk.com]
resources.hackerone.com [read.uberflip.com]
mta-sts.hackerone.com [hacker0x01.github.io]
mta-sts.forwarding.hackerone.com [hacker0x01.github.io]
events.hackerone.com [whitelabel.bigmarker.com]
```
استخراج سجلات **ASN** لقائمة النطاقات الفرعية المعطاة:
```console
subfinder -silent -d hackerone.com | dnsx -silent -asn
b.ns.hackerone.com [AS13335, CLOUDFLARENET, US]
a.ns.hackerone.com [AS13335, CLOUDFLARENET, US]
hackerone.com [AS13335, CLOUDFLARENET, US]
www.hackerone.com [AS13335, CLOUDFLARENET, US]
api.hackerone.com [AS13335, CLOUDFLARENET, US]
support.hackerone.com [AS13335, CLOUDFLARENET, US]
```
الاستعلام باستخدام [dns status code](https://github.com/projectdiscovery/dnsx/wiki/RCODE-ID-VALUE-Mapping) على قائمة (النطاقات الفرعية) المعطاة:
```console
subfinder -silent -d hackerone.com | dnsx -silent -rcode noerror,servfail,refused
ns.hackerone.com [NOERROR]
a.ns.hackerone.com [NOERROR]
b.ns.hackerone.com [NOERROR]
support.hackerone.com [NOERROR]
resources.hackerone.com [NOERROR]
mta-sts.hackerone.com [NOERROR]
www.hackerone.com [NOERROR]
mta-sts.forwarding.hackerone.com [NOERROR]
docs.hackerone.com [NOERROR]
```
استخراج النطاقات الفرعية من نطاق شبكة معطى باستخدام استعلام `PTR`:
```console
echo 173.0.84.0/24 | dnsx -silent -resp-only -ptr
cors.api.paypal.com
trinityadminauth.paypal.com
cld-edge-origin-api.paypal.com
appmanagement.paypal.com
svcs.paypal.com
trinitypie-serv.paypal.com
ppn.paypal.com
pointofsale-new.paypal.com
pointofsale.paypal.com
slc-a-origin-pointofsale.paypal.com
fpdbs.paypal.com
```
استخراج النطاقات الفرعية من ASN معطى باستخدام استعلام `PTR`:
```console
echo AS17012 | dnsx -silent -resp-only -ptr
apiagw-a.paypal.com
notify.paypal.com
adnormserv-slc-a.paypal.com
a.sandbox.paypal.com
apps2.paypal-labs.com
pilot-payflowpro.paypal.com
www.paypallabs.com
paypal-portal.com
micropayments.paypal-labs.com
minicart.paypal-labs.com
```
---------
### تنسيق الإخراج المخصص
يتيح لك الخيار `-output-template` (`-ot`) تخصيص تنسيق الإخراج باستخدام قالب، بدلاً من التنسيق الافتراضي بين الأقواس (مثل `example.com [A] [104.20.23.154]`). يمكنك تحديد القالب مباشرة على سطر الأوامر للتحكم في كيفية عرض البيانات التي تم تحليلها.
تتوافق متغيرات القالب مع أسماء الحقول نفسها المستخدمة في إخراج JSONL (`-json`)، لذا يمكن الإشارة إلى أي مما يلي بصيغة `{{field}}`:
`host`, `a`, `aaaa`, `cname`, `ns`, `txt`, `mx`, `srv`, `ptr`, `soa`, `caa`, `ttl`, `resolver`, `status_code`, `cdn-name`, `cdn-type`, `asn`, `query-time`. يوجد اختصار ملائم `{{ip}}` يحتوي على سجلات `A` و `AAAA` مجتمعة.
يتم دمج السجلات ذات القيم المتعددة (مثل عدة سجلات `A`) بفاصلة داخل حقل واحد.
```console
echo example.com | dnsx -silent -a -ot '{{host}} {{a}}'
example.com 104.20.23.154,172.66.147.243
```
```console
echo example.com | dnsx -silent -a -ot '{{ip}} - {{host}}'
104.20.23.154,172.66.147.243 - example.com
```
> [!NOTE]
> إذا لم يكن الحقل المحدد موجوداً أو لم يحتوي على قيمة، فسيتم ببساطة حذفه من الإخراج. لا يمكن دمج `-output-template` مع `-json` أو `-raw`.
---------
### تخمين DNS
تخمين النطاقات الفرعية لنطاق معطى أو قائمة نطاقات باستخدام الخيارين `d` و `w`:
```console
dnsx -silent -d facebook.com -w dns_worldlist.txt
blog.facebook.com
booking.facebook.com
api.facebook.com
analytics.facebook.com
beta.facebook.com
apollo.facebook.com
ads.facebook.com
box.facebook.com
alpha.facebook.com
apps.facebook.com
connect.facebook.com
c.facebook.com
careers.facebook.com
code.facebook.com
```
تخمين نطاق فرعي مستهدف باستخدام إدخال كلمة مفتاحية واحدة أو متعددة، حيث يدعم الخيار `d` أو `w` إدخالات الملفات أو الكلمات المفتاحية المفصولة بفواصل:
```console
dnsx -silent -d domains.txt -w jira,grafana,jenkins
grafana.1688.com
grafana.8x8.vc
grafana.airmap.com
grafana.aerius.nl
jenkins.1688.com
jenkins.airbnb.app
jenkins.airmap.com
jenkins.ahn.nl
jenkins.achmea.nl
jira.amocrm.com
jira.amexgbt.com
jira.amitree.com
jira.arrival.com
jira.atlassian.net
jira.atlassian.com
```
يتم قبول القيم من **stdin** لجميع أنواع الإدخال (`-list`, `-domain`, `-wordlist`). الخيار `-list` يعتمد افتراضياً على `stdin`، ولكن يمكن تحقيق الشيء نفسه لأنواع الإدخال الأخرى بإضافة `-` (شرطة) كمعامل:
```console
cat domains.txt | dnsx -silent -w jira,grafana,jenkins -d -
grafana.1688.com
grafana.8x8.vc
grafana.airmap.com
grafana.aerius.nl
jenkins.1688.com
jenkins.airbnb.app
jenkins.airmap.com
jenkins.ahn.nl
jenkins.achmea.nl
jira.amocrm.com
jira.amexgbt.com
jira.amitree.com
jira.arrival.com
jira.atlassian.net
jira.atlassian.com
```
#### تخمين DNS باستخدام قائمة كلمات قائمة على العنصر النائب
```bash
$ cat tld.txt
com
by
de
be
al
bi
cg
dj
bs
```
```console
dnsx -d google.FUZZ -w tld.txt -resp
_ __ __
__| | _ __ ___ \ \/ /
/ _' || '_ \ / __| \ /
| (_| || | | |\__ \ / \
\__,_||_| |_||___//_/\_\ v1.1.2
projectdiscovery.io
google.de [142.250.194.99]
google.com [142.250.76.206]
google.be [172.217.27.163]
google.bs [142.251.42.35]
google.bi [216.58.196.67]
google.al [216.58.196.68]
google.by [142.250.195.4]
google.cg [142.250.183.131]
google.dj [142.250.192.3]
```
### تصفية Wildcard
من الميزات الخاصة لـ `dnsx` قدرتها على التعامل مع **wildcards متعددة المستويات القائمة على DNS**، والقيام بذلك بعدد قليل جداً من طلبات DNS. في بعض الأحيان يتم تحليل جميع النطاقات الفرعية، مما يؤدي إلى الكثير من البيانات غير المرغوب فيها في الإخراج. الطريقة التي يتعامل بها `dnsx` مع هذا هي من خلال تتبع عدد النطاقات الفرعية التي تشير إلى عنوان IP، وإذا تجاوز عدد النطاقات الفرعية حداً معيناً، فسيتحقق من wildcards على جميع مستويات المضيفين لعنوان IP هذا بشكل تكراري.
```console
dnsx -l subdomain_list.txt -wd airbnb.com -o output.txt
```
لاكتشاف وتصفية wildcard DNS تلقائياً عبر نطاقات متعددة في تشغيل واحد مع الحفاظ على وضع الإخراج المحدد:
```console
dnsx -l subdomain_list.txt -auto-wildcard -o output.txt
```
الخيار `-auto-wildcard` و `-wd` / `-wildcard-domain` متنافيان. استخدم `-wd` عندما تريد تدفق تصفية wildcard اليدوي الحالي لنطاق واحد؛ استخدم `-auto-wildcard` عندما تريد من dnsx اكتشاف جذور wildcard تلقائياً عبر إدخال نطاقات مختلطة.
---
### Dnsx كمكتبة
من الممكن استخدام المكتبة مباشرة في برامج golang الخاصة بك. مقتطفات الكود التالية هي مثال على الاستخدام في برامج golang. يرجى الرجوع إلى [هنا](https://pkg.go.dev/github.com/projectdiscovery/[email protected]/libs/dnsx) للحصول على تفاصيل تكوين الحزمة واستخدامها.
```go
package main
import (
"fmt"
"github.com/projectdiscovery/dnsx/libs/dnsx"
)
func main() {
// Create DNS Resolver with default options
dnsClient, err := dnsx.New(dnsx.DefaultOptions)
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
// DNS A question and returns corresponding IPs
result, err := dnsClient.Lookup("hackerone.com")
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
for idx, msg := range result {
fmt.Printf("%d: %s\n", idx+1, msg)
}
// Query
rawResp, err := dnsClient.QueryOne("hackerone.com")
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
fmt.Printf("rawResp: %v\n", rawResp)
jsonStr, err := rawResp.JSON()
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
fmt.Println(jsonStr)
return
}
```
# 📋 ملاحظات
- بشكل افتراضي، يتحقق `dnsx` من سجل **A**.
- بشكل افتراضي يستخدم `dnsx` محللات Google و Cloudflare و Quad9 [resolver](https://github.com/projectdiscovery/dnsx/blob/43af78839e237ea8cbafe571df1ab0d6cbe7f445/libs/dnsx/dnsx.go#L31).
- يمكن تحميل قائمة resolver مخصصة باستخدام الخيار `r`.
- يكتشف `-auto-wildcard` تلقائياً نطاقات wildcard عبر جذور قابلة للتسجيل متعددة في تشغيل واحد.
- اسم النطاق (`-wd`) مطلوب فقط لتصفية wildcard اليدوية ولا يمكن استخدامه مع `-auto-wildcard`.
- عند استخدام تصفية wildcard اليدوية مع `-wd`، يتم تجاهل خيارات سجلات DNS الأخرى ويوصى بإخراج JSON.
- لا يمكن استخدام تحليل DNS (`l`) وتخمين DNS (`w`) معاً.
- يميل مشغلو VPN إلى تصفية حركة DNS/UDP العالية، لذلك قد تواجه الأداة فقدان الحزم (مثل [Mullvad VPN](https://github.com/projectdiscovery/dnsx/issues/221)). تحقق من [هذا الحل المحتمل](https://github.com/projectdiscovery/dnsx/blob/dev/MULLVAD.md).
صُنع `dnsx` بـ 🖤 بواسطة فريق [projectdiscovery](https://projectdiscovery.io).