Skip to content

Commit bba86f4

Browse files
authored
Add files via upload
1 parent 7bf9487 commit bba86f4

11 files changed

Lines changed: 941 additions & 79 deletions

INSTALL.md

Lines changed: 56 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -41,13 +41,27 @@ sudo pacman -S nmap
4141

4242
### على نظام Windows
4343

44-
#### تثبيت Python
44+
#### الطريقة السريعة: استخدام سكريبت التثبيت التلقائي
45+
46+
1. قم بتنزيل أو استنساخ المستودع
47+
2. انقر بزر الماوس الأيمن على ملف `install.bat` واختر "Run as administrator" (تشغيل كمسؤول)
48+
3. سيقوم السكريبت تلقائيًا بتثبيت جميع المتطلبات بما في ذلك:
49+
- تثبيت Chocolatey (مدير حزم لنظام Windows)
50+
- تثبيت Python 3
51+
- تثبيت Nmap
52+
- إنشاء بيئة Python افتراضية
53+
- تثبيت جميع مكتبات Python المطلوبة
54+
- إنشاء ملف تشغيل سهل الاستخدام
55+
56+
#### الطريقة اليدوية: تثبيت المتطلبات يدويًا
57+
58+
##### تثبيت Python
4559

4660
1. قم بتنزيل أحدث إصدار من Python من [الموقع الرسمي](https://www.python.org/downloads/windows/)
4761
2. قم بتشغيل المثبت وتأكد من تحديد خيار "Add Python to PATH"
4862
3. اتبع تعليمات المثبت لإكمال عملية التثبيت
4963

50-
#### تثبيت Nmap
64+
##### تثبيت Nmap
5165

5266
1. قم بتنزيل أحدث إصدار من Nmap من [الموقع الرسمي](https://nmap.org/download.html)
5367
2. قم بتشغيل المثبت واتبع التعليمات لإكمال عملية التثبيت
@@ -91,6 +105,8 @@ pip install -e .
91105

92106
## التحقق من التثبيت
93107

108+
### على نظام Linux
109+
94110
بعد الانتهاء من التثبيت، يمكنك التحقق من نجاح العملية بتنفيذ الأمر التالي:
95111

96112
```bash
@@ -103,6 +119,27 @@ saudi-attacks --help
103119
python saudi_attacks.py --help
104120
```
105121

122+
### على نظام Windows
123+
124+
إذا قمت بالتثبيت باستخدام سكريبت التثبيت التلقائي:
125+
126+
```cmd
127+
saudi-attacks.bat --help
128+
```
129+
130+
أو إذا قمت بإضافة المجلد إلى متغير PATH أثناء التثبيت:
131+
132+
```cmd
133+
saudi-attacks --help
134+
```
135+
136+
أو يمكنك تشغيل الأداة مباشرة من المجلد:
137+
138+
```cmd
139+
cd C:\path\to\Saudi-Attacks
140+
.\saudi-attacks.bat --help
141+
```
142+
106143
يجب أن ترى قائمة بالخيارات المتاحة والتعليمات الخاصة باستخدام الأداة.
107144

108145
## استكشاف الأخطاء وإصلاحها
@@ -121,11 +158,26 @@ python saudi_attacks.py --help
121158

122159
### مشكلات شائعة على Windows
123160

161+
- **مشكلات في تشغيل سكريبت التثبيت**: تأكد من تشغيل ملف `install.bat` بصلاحيات المسؤول (Run as administrator).
162+
163+
- **مشكلات في تفعيل البيئة الافتراضية**: إذا واجهت خطأ عند تفعيل البيئة الافتراضية، قم بتنفيذ الأمر التالي في PowerShell بصلاحيات المسؤول:
164+
```powershell
165+
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
166+
```
167+
124168
- **مشكلات في تشغيل Nmap**: تأكد من إضافة Nmap إلى متغير PATH في نظام Windows.
125169

126170
- **مشكلات في تثبيت المكتبات**: قد تحتاج إلى تثبيت أدوات البناء لبعض المكتبات.
127-
```bash
128-
pip install --upgrade setuptools wheel
171+
```powershell
172+
python -m pip install --upgrade setuptools wheel
173+
```
174+
175+
- **مشكلات في تثبيت Chocolatey**: إذا فشل تثبيت Chocolatey، يمكنك تثبيته يدويًا باتباع التعليمات في [الموقع الرسمي](https://chocolatey.org/install).
176+
177+
- **مشكلات في تنفيذ الأداة**: إذا واجهت مشكلة في تنفيذ الأداة بعد التثبيت، جرب تشغيلها مباشرة من خلال Python:
178+
```cmd
179+
cd C:\path\to\Saudi-Attacks
180+
.\venv\Scripts\python.exe saudi_attacks.py --help
129181
```
130182

131183
## الخطوات التالية

README.txt

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# أداة SaudiAttacks
2+
3+
أداة اختبار اختراق آلي تم تطويرها بواسطة Saudi Linux
4+
البريد الإلكتروني: SaudiLinux7@gmail.com
5+
6+
## نظرة عامة
7+
8+
SaudiAttacks هي أداة متكاملة لاختبار الاختراق تتيح لك إجراء عمليات فحص أمنية متنوعة على الأنظمة والشبكات والتطبيقات. تم تصميم الأداة لتكون سهلة الاستخدام وفعالة في اكتشاف الثغرات الأمنية.
9+
10+
## المميزات الرئيسية
11+
12+
- فحص المنافذ المفتوحة
13+
- فحص خوادم الويب وتطبيقات الويب
14+
- فحص أنظمة إدارة المحتوى (ووردبريس، جوملا)
15+
- جمع معلومات عن الأهداف
16+
- فحص الثغرات الأمنية
17+
- إنشاء تقارير مفصلة
18+
19+
## التثبيت السريع على نظام Windows
20+
21+
1. انقر بزر الماوس الأيمن على ملف `install.bat` واختر "Run as administrator" (تشغيل كمسؤول)
22+
2. انتظر حتى اكتمال عملية التثبيت
23+
3. عند السؤال عن إضافة الأداة إلى متغير PATH، اكتب `y` للموافقة
24+
25+
## الاستخدام السريع
26+
27+
### الطريقة الأسهل: استخدام الواجهة التفاعلية
28+
29+
1. انقر بزر الماوس الأيمن على ملف `run-with-options.bat` واختر "Run as administrator"
30+
2. اختر العملية المطلوبة من القائمة التفاعلية
31+
3. اتبع التعليمات على الشاشة لإدخال الهدف ونوع الفحص
32+
33+
### استخدام سطر الأوامر
34+
35+
لفحص هدف محدد:
36+
```
37+
saudi-attacks.bat -t example.com -p -w
38+
```
39+
40+
لفحص شامل لهدف محدد:
41+
```
42+
saudi-attacks.bat -t 192.168.1.1 -a
43+
```
44+
45+
لعرض المساعدة:
46+
```
47+
saudi-attacks.bat --help
48+
```
49+
50+
## للمزيد من المعلومات
51+
52+
- راجع ملف README_WINDOWS.md للحصول على تفاصيل استخدام الأداة على نظام Windows
53+
- راجع ملف INSTALL.md للحصول على تفاصيل إضافية حول التثبيت
54+
- راجع ملف README.md للحصول على معلومات شاملة حول الأداة
55+
56+
## ملاحظات هامة
57+
58+
- يجب تشغيل الأداة دائمًا بصلاحيات المسؤول
59+
- قد يقوم جدار الحماية أو برامج مكافحة الفيروسات بحظر بعض وظائف الأداة
60+
- استخدم الأداة فقط على الأنظمة المصرح لك باختبارها

README_WINDOWS.md

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
# دليل استخدام أداة SaudiAttacks على نظام Windows
2+
3+
هذا الدليل يشرح كيفية تثبيت واستخدام أداة SaudiAttacks على نظام Windows.
4+
5+
## المتطلبات الأساسية
6+
7+
- نظام Windows 10 أو أحدث
8+
- صلاحيات المسؤول (Administrator)
9+
- اتصال بالإنترنت للتثبيت
10+
11+
## التثبيت السريع
12+
13+
1. قم بتنزيل أو استنساخ المستودع
14+
2. انقر بزر الماوس الأيمن على ملف `install.bat` واختر "Run as administrator" (تشغيل كمسؤول)
15+
3. انتظر حتى اكتمال عملية التثبيت
16+
4. عند السؤال عن إضافة الأداة إلى متغير PATH، اكتب `y` للموافقة
17+
18+
## استخدام الأداة
19+
20+
بعد اكتمال التثبيت، يمكنك استخدام الأداة بإحدى الطرق التالية:
21+
22+
### الطريقة 1: استخدام الواجهة التفاعلية (موصى بها للمبتدئين)
23+
24+
توفر الأداة واجهة تفاعلية سهلة الاستخدام تتيح لك اختيار نوع الفحص والأهداف بسهولة:
25+
26+
1. انقر بزر الماوس الأيمن على ملف `run-with-options.bat` واختر "Run as administrator"
27+
2. اختر العملية المطلوبة من القائمة التفاعلية
28+
3. اتبع التعليمات على الشاشة لإدخال الهدف ونوع الفحص
29+
30+
### الطريقة 2: استخدام ملف التشغيل المباشر (BAT)
31+
32+
```cmd
33+
cd C:\path\to\Saudi-Attacks
34+
.\saudi-attacks.bat --help
35+
```
36+
37+
### الطريقة 3: استخدام سكريبت PowerShell
38+
39+
```powershell
40+
cd C:\path\to\Saudi-Attacks
41+
# انقر بزر الماوس الأيمن على ملف run-saudi-attacks.ps1 واختر "Run with PowerShell as Administrator"
42+
# أو قم بتشغيله من PowerShell بصلاحيات المسؤول
43+
.\run-saudi-attacks.ps1 --help
44+
```
45+
46+
### الطريقة 4: إذا قمت بإضافة المجلد إلى متغير PATH
47+
48+
```cmd
49+
saudi-attacks --help
50+
```
51+
52+
## أمثلة على الاستخدام
53+
54+
### فحص هدف محدد
55+
56+
```cmd
57+
saudi-attacks.bat -t example.com -p -w
58+
```
59+
60+
هذا الأمر سيقوم بفحص المنافذ وخادم الويب للهدف example.com
61+
62+
### فحص شامل لهدف محدد
63+
64+
```cmd
65+
saudi-attacks.bat -t 192.168.1.1 -a
66+
```
67+
68+
هذا الأمر سيقوم بإجراء فحص شامل للهدف 192.168.1.1
69+
70+
### فحص قائمة من الأهداف
71+
72+
1. قم بإنشاء ملف نصي يحتوي على قائمة الأهداف (كل هدف في سطر منفصل)
73+
2. استخدم الأمر التالي:
74+
75+
```cmd
76+
saudi-attacks.bat -f C:\path\to\targets.txt -p
77+
```
78+
79+
## ملاحظات هامة
80+
81+
1. **صلاحيات المسؤول**: بعض عمليات الفحص تتطلب صلاحيات المسؤول، لذا يفضل تشغيل الأداة دائمًا بصلاحيات المسؤول.
82+
83+
2. **جدار الحماية**: قد يقوم جدار الحماية في Windows بحظر بعض عمليات الفحص، لذا قد تحتاج إلى تكوين استثناءات في جدار الحماية.
84+
85+
3. **برامج مكافحة الفيروسات**: قد تقوم بعض برامج مكافحة الفيروسات بحظر بعض وظائف الأداة، لذا قد تحتاج إلى إضافة استثناءات.
86+
87+
## استكشاف الأخطاء وإصلاحها
88+
89+
### مشكلات شائعة
90+
91+
- **خطأ في تنفيذ الأداة**: تأكد من تفعيل البيئة الافتراضية قبل تشغيل الأداة مباشرة:
92+
93+
```cmd
94+
cd C:\path\to\Saudi-Attacks
95+
.\venv\Scripts\activate
96+
python saudi_attacks.py --help
97+
```
98+
99+
- **مشكلات في تنفيذ سكريبت PowerShell**: إذا واجهت مشكلة في تنفيذ سكريبت PowerShell، قم بتنفيذ الأمر التالي في PowerShell بصلاحيات المسؤول:
100+
101+
```powershell
102+
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
103+
```
104+
105+
- **مشكلات في الاتصال بالشبكة**: تأكد من أن جدار الحماية لا يحظر اتصالات الأداة.
106+
107+
## للمزيد من المعلومات
108+
109+
- راجع ملف [INSTALL.md](INSTALL.md) للحصول على تفاصيل إضافية حول التثبيت.
110+
- راجع ملف [README.md](README.md) للحصول على معلومات شاملة حول الأداة.

install.bat

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
@echo off
2+
REM SaudiAttacks Installation Script Launcher
3+
REM This batch file launches the PowerShell installation script
4+
5+
echo تشغيل سكريبت تثبيت أداة SaudiAttacks...
6+
7+
REM Check if running as administrator
8+
powershell -Command "&{[bool](([System.Security.Principal.WindowsIdentity]::GetCurrent()).groups -match 'S-1-5-32-544')}" > %TEMP%\isadmin.txt
9+
set /p isadmin=<%TEMP%\isadmin.txt
10+
del %TEMP%\isadmin.txt
11+
12+
if "%isadmin%"=="False" (
13+
echo يجب تشغيل هذا السكريبت بصلاحيات المسؤول.
14+
echo الرجاء النقر بزر الماوس الأيمن على الملف واختيار "Run as administrator".
15+
pause
16+
exit /b 1
17+
)
18+
19+
REM Run the PowerShell installation script
20+
powershell -ExecutionPolicy Bypass -File "%~dp0install.sh"
21+
22+
pause

0 commit comments

Comments
 (0)