bunkerweb

<p align="center">
	<img alt="BunkerWeb logo" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/misc/logo.png" height=100 width=350 />
</p>

<p align="center">
	<img src="https://img.shields.io/github/v/release/bunkerity/bunkerweb?label=stable" />
	<img src="https://img.shields.io/github/v/release/bunkerity/bunkerweb?include_prereleases&amp;label=latest" />
	<br />
	<img src="https://img.shields.io/github/last-commit/bunkerity/bunkerweb" />
	<img src="https://img.shields.io/github/issues/bunkerity/bunkerweb">
	<img src="https://img.shields.io/github/issues-pr/bunkerity/bunkerweb">
	<br />
	<img src="https://img.shields.io/github/actions/workflow/status/bunkerity/bunkerweb/dev.yml?branch=dev&amp;label=CI/CD%20dev" />
	<img src="https://img.shields.io/github/actions/workflow/status/bunkerity/bunkerweb/staging.yml?branch=staging&amp;label=CI/CD%20staging" />
	<a href="https://github.com/bunkerity/bunkerweb/actions/workflows/release.yml"><img src="https://img.shields.io/github/actions/workflow/status/bunkerity/bunkerweb/release.yml?label=CI/CD%20release" alt="Release workflow status" /></a>
	<br />
	<a href="https://www.bestpractices.dev/projects/8001">
		<img src="https://www.bestpractices.dev/projects/8001/badge">
	</a>
	<a href="https://gitrated.com/bunkerity/bunkerweb"><img src="https://gitrated.com/bunkerity/bunkerweb/badge" alt="GitRated rating" /></a>
	<a href="https://score.getplumber.io/github.com/bunkerity/bunkerweb"><img src="https://score.getplumber.io/github.com/bunkerity/bunkerweb.svg" alt="Plumber CI/CD security score" /></a>
	<br />
	<a href="https://www.star-history.com/bunkerity/bunkerweb">
		<picture>
		<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=bunkerity/bunkerweb&theme=dark" />
		<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=bunkerity/bunkerweb" />
		<img alt="Star History Rank" src="https://api.star-history.com/badge?repo=bunkerity/bunkerweb" width=140 />
		</picture>
	</a>
</p>

<p align="center">
	🌐 <a href="https://www.bunkerweb.io/?utm_campaign=self&utm_source=github">الموقع الإلكتروني</a>
	 &#124;
	🤝 <a href="https://panel.bunkerweb.io/?utm_campaign=self&utm_source=github">لوحة التحكم</a>
	 &#124;
	📓 <a href="https://docs.bunkerweb.io/?utm_campaign=self&utm_source=github">التوثيق</a>
	 &#124;
	👨‍💻 <a href="https://demo.bunkerweb.io/?utm_campaign=self&utm_source=github">العرض التجريبي</a>
	 &#124;
	📱 <a href="https://demo-ui.bunkerweb.io/?utm_campaign=self&utm_source=github">واجهة العرض التجريبي</a>
	 &#124;
	🧩 <a href="https://github.com/bunkerity/bunkerweb-templates">القوالب</a>
	 &#124;
	🛡️ <a href="https://github.com/bunkerity/bunkerweb/raw/v1.6.15/examples">الأمثلة</a>
	<br/>
	💬 <a href="https://discord.com/invite/fTf46FmtyD">الدردشة</a>
	 &#124;
	📝 <a href="https://github.com/bunkerity/bunkerweb/discussions">المنتدى</a>
	 &#124;
	📝 <a href="https://community.bunkerweb.io/?utm_campaign=self&utm_source=github">المجتمع</a>
	 &#124;
	🗺️ <a href="https://www.bunkerweb.io/threatmap/?utm_campaign=self&utm_source=github">خريطة التهديدات</a>
	&#124;
	📊 <a href="https://status.bunkerweb.io/?utm_campaign=self&utm_source=github">الحالة</a>
	&#124;
	🔎 <a href="https://forms.gle/e3VgymAteYPnwM1j9">الملاحظات</a>
</p>

> 🛡️ لنجعل الأمان افتراضيًا رائعًا مرة أخرى!

# BunkerWeb

<p align="center">
	<img alt="Overview banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/intro-overview.svg" />
</p>

BunkerWeb هو جدار حماية تطبيقات الويب (WAF) مفتوح المصدر من الجيل التالي.

بصفته خادم ويب كامل الميزات (مبني على [NGINX](https://nginx.org/) في الأساس)، فإنه يحمي خدمات الويب الخاصة بك ليجعلها "آمنة افتراضيًا". يتكامل BunkerWeb بسلاسة مع بيئاتك الحالية ([Linux](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#linux)، [Docker](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#docker)، [Swarm](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#swarm)، [Kubernetes](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#kubernetes)، …) كخادم وكيل عكسي وقابل للتكوين بالكامل (لا تقلق، هناك [واجهة ويب رائعة](https://docs.bunkerweb.io/1.6.15/web-ui/?utm_campaign=self&utm_source=github) إذا كنت لا تحب واجهة سطر الأوامر) لتلبية حالات الاستخدام الخاصة بك. بعبارة أخرى، لم يعد الأمن السيبراني مصدر إزعاج.

يحتوي BunkerWeb على [ميزات أمان](https://docs.bunkerweb.io/1.6.15/advanced/?utm_campaign=self&utm_source=github#security-tuning) أساسية كجزء من النواة، ولكن يمكن توسيعه بسهولة بميزات إضافية بفضل [نظام الإضافات](https://docs.bunkerweb.io/1.6.15/plugins/?utm_campaign=self&utm_source=github).

## لماذا BunkerWeb؟

https://github.com/user-attachments/assets/c3fed740-28d8-4335-ab05-113a9e815b4f

- **سهولة التكامل مع البيئات الحالية**: تكامل BunkerWeb بسلاسة مع بيئات متنوعة مثل Linux وDocker وSwarm وKubernetes وغيرها. استمتع بانتقال سلس وتنفيذ خالٍ من المتاعب.
- **قابلية تخصيص عالية**: خصّص BunkerWeb وفقًا لمتطلباتك المحددة بسهولة. فعّل الميزات وعطّلها وكوّنها دون عناء، مما يتيح لك تخصيص إعدادات الأمان وفقًا لحالة الاستخدام الفريدة الخاصة بك.
- **آمن افتراضيًا**: يوفر BunkerWeb أمانًا بسيطًا جاهزًا وخاليًا من المتاعب لخدمات الويب الخاصة بك. استمتع براحة البال وحماية معززة منذ البداية.
- **واجهة ويب رائعة**: تحكم في BunkerWeb بكفاءة أكبر من خلال واجهة المستخدم الرسومية الاستثنائية. تنقّل في الإعدادات والتكوينات دون عناء من خلال واجهة رسومية سهلة الاستخدام، مما يلغي الحاجة إلى واجهة سطر الأوامر (CLI).
- **نظام الإضافات**: وسّع قدرات BunkerWeb لتلبية حالات الاستخدام الخاصة بك. ادمج تدابير أمان إضافية بسلاسة وخصّص وظائف BunkerWeb وفقًا لمتطلباتك المحددة.
- **حر كما في "الحرية"**: BunkerWeb مرخّص بموجب [رخصة AGPLv3](https://www.gnu.org/licenses/agpl-3.0.en.html) الحرة، ويتبنى مبادئ الحرية والانفتاح. استمتع بحرية استخدام البرنامج وتعديله وتوزيعه، بدعم من مجتمع داعم.
- **خدمات احترافية**: احصل على الدعم الفني والاستشارات المخصصة والتطوير المخصص مباشرة من القائمين على صيانة BunkerWeb. قم بزيارة [Bunker Panel](https://panel.bunkerweb.io/?utm_campaign=self&utm_source=github) لمزيد من المعلومات.

## ميزات الأمان

قائمة غير حصرية بميزات الأمان:

- دعم **HTTPS** مع أتمتة شفافة لـ **Let's Encrypt**
- **أمان ويب متطور**: رؤوس أمان HTTP، منع التسريبات، تقوية TLS، ...
- **ModSecurity WAF** مدمج مع **OWASP Core Rule Set**
- **الحظر التلقائي** للسلوكيات الغريبة بناءً على رموز حالة HTTP
- تطبيق **حدود الاتصال والطلبات** للعملاء
- **حظر الروبوتات** من خلال مطالبتها بحل **تحدٍ** (مثل ملف تعريف ارتباط، JavaScript، captcha، hCaptcha، أو reCAPTCHA)
- **حظر عناوين IP الضارة المعروفة** باستخدام القوائم السوداء الخارجية وDNSBL
- والكثير غير ذلك...

تعرّف على المزيد حول ميزات الأمان الأساسية في قسم [ضبط الأمان](https://docs.bunkerweb.io/1.6.15/advanced/?utm_campaign=self&utm_source=github#security-tuning) في التوثيق.

## العرض التجريبي

https://github.com/user-attachments/assets/6fc0e3c1-d353-4a84-bad0-15bf9b6623a5

يتوفر موقع ويب تجريبي محمي بـ BunkerWeb على [demo.bunkerweb.io](https://demo.bunkerweb.io/?utm_campaign=self&utm_source=github). لا تتردد في زيارته وإجراء بعض اختبارات الأمان.

## واجهة الويب

https://github.com/user-attachments/assets/a3ed56f8-c124-4ca9-b8b3-4be0913b3078

يوفر BunkerWeb [واجهة مستخدم](https://github.com/bunkerity/bunkerweb/blob/master/web-ui.md) اختيارية لإدارة نسخك وتكويناتها. يتوفر عرض تجريبي للقراءة فقط عبر الإنترنت على [demo-ui.bunkerweb.io](https://demo-ui.bunkerweb.io/?utm_campaign=self&utm_source=doc)، لا تتردد في تجربته بنفسك.

## BunkerWeb Cloud

لا ترغب في الاستضافة الذاتية وإدارة نسخ BunkerWeb الخاصة بك؟ قد تكون مهتمًا بـ BunkerWeb Cloud، وهو عرض SaaS المُدار بالكامل الخاص بنا لـ BunkerWeb.

اطلب [نسخة BunkerWeb Cloud](https://panel.bunkerweb.io/store/bunkerweb-cloud?utm_campaign=self&utm_source=doc) واحصل على إمكانية الوصول إلى:

- نسخة BunkerWeb مُدارة بالكامل مستضافة في السحابة الخاصة بنا
- جميع ميزات BunkerWeb، بما في ذلك ميزات PRO
- منصة مراقبة مع لوحات معلومات وتنبيهات
- دعم فني لمساعدتك في التكوين

إذا كنت مهتمًا بعرض BunkerWeb Cloud، فلا تتردد في [الاتصال بنا](https://panel.bunkerweb.io/contact.php?utm_campaign=self&utm_source=doc) حتى نتمكن من مناقشة احتياجاتك.

## نسخة PRO

ابدأ تجربة مجانية لمدة 30 يومًا لـ BunkerWeb PRO من [لوحة BunkerWeb](https://panel.bunkerweb.io/store/bunkerweb-pro?utm_campaign=self&utm_source=doc).

عند استخدام BunkerWeb، لديك خيار النسخة التي تريد استخدامها: مفتوحة المصدر أو PRO.

سواء كان الأمر يتعلق بأمان معزز، أو تجربة مستخدم مُثراة، أو مراقبة تقنية، فإن نسخة BunkerWeb PRO تتيح لك الاستفادة الكاملة من BunkerWeb وتلبية احتياجاتك المهنية.

في التوثيق أو واجهة المستخدم، يتم تمييز ميزات PRO بتاج <img src="https://docs.bunkerweb.io/1.6.15/assets/img/pro-icon.svg" alt="crown pro icon" height="32px" width="32px"> لتمييزها عن تلك المدمجة في النسخة مفتوحة المصدر.

يمكنك الترقية من النسخة مفتوحة المصدر إلى نسخة PRO بسهولة وفي أي وقت. العملية مباشرة:

- ابدأ [تجربتك المجانية لمدة 30 يومًا لـ BunkerWeb PRO](https://panel.bunkerweb.io/store/bunkerweb-pro?utm_campaign=self&utm_source=doc)
- بمجرد الاتصال بمنطقة العميل، انسخ مفتاح ترخيص PRO الخاص بك
- الصق مفتاح الترخيص في BunkerWeb باستخدام [واجهة الويب](https://docs.bunkerweb.io/1.6.15/web-ui/#upgrade-to-pro) أو [إعداد محدد](https://docs.bunkerweb.io/1.6.15/features/#pro)

لا تتردد في زيارة [لوحة BunkerWeb](https://panel.bunkerweb.io/knowledgebase?utm_campaign=self&utm_source=doc) أو [الاتصال بنا](https://panel.bunkerweb.io/contact.php?utm_campaign=self&utm_source=doc) إذا كانت لديك أي أسئلة بخصوص نسخة PRO.

## الخدمات الاحترافية

استفد إلى أقصى حد من BunkerWeb من خلال الحصول على خدمات احترافية مباشرة من القائمين على صيانة المشروع. من الدعم الفني إلى الاستشارات والتطوير المخصص، نحن هنا لمساعدتك في أمان خدمات الويب الخاصة بك.

ستجد مزيدًا من المعلومات من خلال زيارة [لوحة BunkerWeb](https://panel.bunkerweb.io/?utm_campaign=self&utm_source=doc)، منصتنا المخصصة للخدمات الاحترافية.

لا تتردد في [الاتصال بنا](https://panel.bunkerweb.io/contact.php?utm_campaign=self&utm_source=doc) إذا كانت لديك أي أسئلة؛ سنكون سعداء بالاستجابة لاحتياجاتك.

## النظام البيئي والمجتمع والموارد

المواقع الرسمية والأدوات والموارد حول BunkerWeb:

- [**الموقع الإلكتروني**](https://www.bunkerweb.io/?utm_campaign=self&utm_source=doc): احصل على مزيد من المعلومات والأخبار والمقالات حول BunkerWeb
- [**لوحة التحكم**](https://panel.bunkerweb.io/?utm_campaign=self&utm_source=doc): منصة مخصصة لطلب وإدارة الخدمات الاحترافية (مثل الدعم الفني) حول BunkerWeb
- [**التوثيق**](https://docs.bunkerweb.io): التوثيق التقني لحل BunkerWeb
- [**العرض التجريبي**](https://demo.bunkerweb.io/?utm_campaign=self&utm_source=doc): موقع ويب تجريبي لـ BunkerWeb، لا تتردد في محاولة شن هجمات لاختبار متانة الحل
- [**واجهة الويب**](https://demo-ui.bunkerweb.io/?utm_campaign=self&utm_source=doc): عرض تجريبي للقراءة فقط عبر الإنترنت لواجهة الويب الخاصة بـ BunkerWeb
- [**خريطة التهديدات**](https://www.bunkerweb.io/threatmap/?utm_campaign=self&utm_source=doc): هجمات سيبرانية حية محظورة بواسطة نسخ BunkerWeb في جميع أنحاء العالم

المجتمع وشبكات التواصل الاجتماعي:

- [**Discord**](https://discord.com/invite/fTf46FmtyD)
- [**LinkedIn**](https://www.linkedin.com/company/bunkerity/)
- [**Twitter**](https://twitter.com/bunkerity)
- [**Reddit**](https://www.reddit.com/r/BunkerWeb/)

# المفاهيم

<p align="center">
	<img alt="Concepts banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/concepts.svg" />
</p>

ستجد مزيدًا من المعلومات حول المفاهيم الأساسية لـ BunkerWeb في [التوثيق](https://docs.bunkerweb.io/1.6.15/concepts/?utm_campaign=self&utm_source=github).

## التكاملات

المفهوم الأول هو تكامل BunkerWeb مع البيئة المستهدفة. نفضل استخدام كلمة "تكامل" بدلاً من "تثبيت" لأن أحد أهداف BunkerWeb هو التكامل بسلاسة مع البيئات الحالية.

التكاملات التالية مدعومة رسميًا:

- [Docker](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#docker)
- [Linux](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#linux)
- [Docker autoconf](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#docker-autoconf)
- [Kubernetes](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#kubernetes)
- [Swarm](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#swarm)
- [Microsoft Azure](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#microsoft-azure)

## الإعدادات

بمجرد تكامل BunkerWeb مع بيئتك، ستحتاج إلى تكوينه لخدمة تطبيقات الويب الخاصة بك وحمايتها.

يتم تكوين BunkerWeb باستخدام ما نسميه "الإعدادات" أو "المتغيرات". يتم تحديد كل إعداد باسم مثل `AUTO_LETS_ENCRYPT` أو `USE_ANTIBOT`. يمكنك تعيين قيم للإعدادات لتكوين BunkerWeb.

إليك مثال وهمي لتكوين BunkerWeb:```conf
SERVER_NAME=www.example.com
AUTO_LETS_ENCRYPT=yes
USE_ANTIBOT=captcha
REFERRER_POLICY=no-referrer
USE_MODSECURITY=no
USE_GZIP=yes
USE_BROTLI=no
```
## وضع المواقع المتعددة

يُعدّ وضع المواقع المتعددة مفهومًا جوهريًا يجب فهمه عند استخدام BunkerWeb. ولأن الهدف هو حماية تطبيقات الويب، فإننا نرث بطبيعتنا مفهوم "المضيف الافتراضي" أو "vhost" (مزيد من المعلومات [هنا](https://en.wikipedia.org/wiki/Virtual_hosting)) الذي يتيح تقديم عدة تطبيقات ويب من نسخة واحدة (أو مجموعة نسخ).

بشكل افتراضي، يكون وضع المواقع المتعددة في BunkerWeb معطّلًا، ما يعني أنه سيتم تقديم تطبيق ويب واحد فقط وستُطبَّق عليه جميع الإعدادات. الحالة الاستخدامية النموذجية هي عندما يكون لديك تطبيق واحد لحمايته: لا داعي للقلق بشأن المواقع المتعددة، وينبغي أن يكون السلوك الافتراضي هو المناسب لك.

عند تفعيل وضع المواقع المتعددة، سيقوم BunkerWeb بتقديم وحماية عدة تطبيقات ويب. يُعرَّف كل تطبيق ويب باسم خادم فريد وله مجموعته الخاصة من الإعدادات. الحالة الاستخدامية النموذجية هي عندما يكون لديك عدة تطبيقات لحمايتها وتريد استخدام نسخة واحدة (أو مجموعة حسب التكامل) من BunkerWeb.

## الإعدادات المخصصة

نظرًا لأن تلبية جميع الحالات الاستخدامية باستخدام الإعدادات فقط ليس خيارًا مطروحًا (حتى مع [الإضافات الخارجية](https://docs.bunkerweb.io/1.6.15/plugins/?utm_campaign=self&utm_source=github))، يمكنك استخدام إعدادات مخصصة لحل تحدياتك الخاصة.

في جوهره، يستخدم BunkerWeb خادم الويب الشهير NGINX، ولهذا يمكنك الاستفادة من نظام الإعدادات الخاص به لتلبية احتياجاتك المحددة. يمكن تضمين إعدادات NGINX المخصصة في [سياقات](https://docs.nginx.com/nginx/admin-guide/basic-functionality/managing-configuration-files/#contexts) مختلفة مثل HTTP أو الخادم (جميع الخوادم و/أو كتلة خادم محددة).

من المكونات الأساسية الأخرى في BunkerWeb جدار حماية تطبيقات الويب ModSecurity: يمكنك أيضًا استخدام إعدادات مخصصة لتصحيح بعض النتائج الإيجابية الخاطئة أو إضافة قواعد مخصصة، على سبيل المثال.

## قاعدة البيانات

<p align="center">
	<img alt="Database model" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/bunkerweb_db.svg" />
</p>

تُخزَّن حالة الإعدادات الحالية لـ BunkerWeb في قاعدة بيانات خلفية تحتوي على البيانات التالية:

- الإعدادات المعرَّفة لجميع الخدمات
- الإعدادات المخصصة
- نسخ BunkerWeb
- البيانات الوصفية حول تنفيذ المهام
- الملفات المخزَّنة مؤقتًا

قواعد البيانات الخلفية المدعومة هي: SQLite وMariaDB وMySQL وPostgreSQL.

## المجدول

لجعل كل شيء يعمل معًا بشكل تلقائي، توجد خدمة مخصصة تُسمى المجدول (scheduler) مسؤولة عن:

- تخزين الإعدادات والإعدادات المخصصة داخل قاعدة البيانات
- تنفيذ مهام متنوعة (تُسمى jobs)
- توليد إعدادات يفهمها BunkerWeb
- العمل كوسيط للخدمات الأخرى (مثل واجهة الويب أو autoconf)

بعبارة أخرى، المجدول هو عقل BunkerWeb.

# الإعداد

هل تبني صور الحاويات أو حزم Linux من المصدر؟ راجع [دليل البناء المجتمعي](https://github.com/bunkerity/bunkerweb/blob/master/docs/building.md).

<!--## BunkerWeb Cloud

<p align="center">
	<img alt="Docker banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/bunkerweb-cloud.webp" />
</p>

BunkerWeb Cloud هو أسهل طريقة للبدء مع BunkerWeb. يوفّر لك خدمة BunkerWeb مُدارة بالكامل دون عناء. فكّر فيه كـ BunkerWeb-as-a-Service!

ستجد مزيدًا من المعلومات حول النسخة التجريبية من BunkerWeb Cloud [هنا](https://www.bunkerweb.io/saas-offer-cloud/?utm_campaign=self&utm_source=docs) ويمكنك التقديم مجانًا [في لوحة BunkerWeb](https://panel.bunkerweb.io/store/bunkerweb-cloud?utm_campaign=self&utm_source=docs).
-->
## Linux

<p align="center">
	<img alt="Linux banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/integration-linux.svg" />
</p>

قائمة توزيعات Linux المدعومة:

- Debian 12 "Bookworm"
- Debian 13 "Trixie"
- Ubuntu 22.04 "Jammy"
- Ubuntu 24.04 "Noble"
- Ubuntu 26.04 "Resolute Raccoon"
- Fedora 43
- Fedora 44
- RHEL وCentOS وRocky Linux وAlmaLinux 8 و9 و10

ستجد مزيدًا من المعلومات في [قسم Linux](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#linux) من التوثيق.

## Docker

<p align="center">
	<img alt="Docker banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/integration-docker.svg" />
</p>

نوفّر صورًا مبنية مسبقًا جاهزة للاستخدام لمنصات x64 وx86 وarmv7 وarm64 على [Docker Hub](https://hub.docker.com/u/bunkerity).

المفاهيم الأساسية لتكامل Docker هي:

- **متغيرات البيئة** لتهيئة BunkerWeb
- حاوية **المجدول** لتخزين الإعدادات وتنفيذ المهام
- **الشبكات** لكشف المنافذ للعملاء والاتصال بخدمات الويب المصدرية

ستجد مزيدًا من المعلومات في [قسم تكامل Docker](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#docker) من التوثيق.

## Docker autoconf

<p align="center">
	<img alt="Docker autoconf banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/integration-autoconf.svg" />
</p>

الجانب السلبي لاستخدام متغيرات البيئة هو أن الحاوية تحتاج إلى إعادة إنشائها في كل مرة يحدث فيها تحديث، وهو أمر ليس مريحًا للغاية. لمواجهة هذه المشكلة، يمكنك استخدام صورة أخرى تُسمى **autoconf** والتي ستستمع لأحداث Docker وتعيد تهيئة BunkerWeb تلقائيًا في الوقت الفعلي دون إعادة إنشاء الحاوية.

بدلًا من تعريف متغيرات البيئة لحاوية BunkerWeb، يمكنك ببساطة إضافة **تسميات (labels)** إلى حاويات تطبيقات الويب الخاصة بك وستتولى **autoconf** الباقي "تلقائيًا".

ستجد مزيدًا من المعلومات في [قسم Docker autoconf](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#docker-autoconf) من التوثيق.

## Kubernetes

<p align="center">
	<img alt="Kubernetes banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/integration-kubernetes.svg" />
</p>

يعمل autoconf كـ [وحدة تحكم Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/) وسيقوم بتهيئة نسخ BunkerWeb وفقًا لـ [موارد Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/). كما يراقب كائنات Kubernetes الأخرى مثل [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/) للإعدادات المخصصة.

مخطط [Helm](https://helm.sh/) الرسمي لـ BunkerWeb متاح في [مستودع bunkerity/bunkerweb-helm](https://github.com/bunkerity/bunkerweb-helm).

ستجد مزيدًا من المعلومات في [قسم Kubernetes](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#kubernetes) من التوثيق.

## Microsoft Azure

<p align="center">
	<img alt="Azure banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/integration-azure.webp" />
</p>

BunkerWeb مُدرَج في [Azure Marketplace](https://azuremarketplace.microsoft.com/fr-fr/marketplace/apps/bunkerity.bunkerweb?tab=Overview) وقالب ARM متاح في [مجلد misc](https://github.com/bunkerity/bunkerweb/raw/v1.6.15/misc/integrations/azure-arm-template.json).

ستجد مزيدًا من المعلومات في [قسم Microsoft Azure](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#microsoft-azure) من التوثيق.

## Swarm

<p align="center">
	<img alt="Swarm banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.15/docs/assets/img/integration-swarm.svg" />
</p>

لتهيئة نسخ BunkerWeb تلقائيًا، ستستمع خدمة خاصة تُسمى **autoconf** لأحداث Docker Swarm مثل إنشاء الخدمة أو حذفها وتهيّئ **نسخ BunkerWeb** تلقائيًا في الوقت الفعلي دون توقف.

مثل [تكامل Docker autoconf](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#docker-autoconf)، تُعرَّف إعدادات خدمات الويب باستخدام تسميات تبدأ بالبادئة الخاصة **bunkerweb.**.

ستجد مزيدًا من المعلومات في [قسم Swarm](https://docs.bunkerweb.io/1.6.15/integrations/?utm_campaign=self&utm_source=github#swarm) من التوثيق.

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

بمجرد إعداد BunkerWeb بالتكامل الذي اخترته، يمكنك اتباع [دليل البدء السريع](https://docs.bunkerweb.io/1.6.15/quickstart-guide/?utm_campaign=self&utm_source=github) الذي سيغطي التثبيت والتهيئة الأولى لحماية خدمة ويب.

# ضبط الأمان

يوفّر BunkerWeb العديد من ميزات الأمان التي يمكنك تهيئتها باستخدام [الميزات](https://docs.bunkerweb.io/1.6.15/features/?utm_campaign=self&utm_source=github). حتى لو كانت القيم الافتراضية للإعدادات تضمن حدًا أدنى من "الأمان افتراضيًا"، فإننا نوصي بشدة بضبطها. وبذلك، ستتمكن من ضمان مستوى أمان من اختيارك وكذلك إدارة النتائج الإيجابية الخاطئة.

ستجد مزيدًا من المعلومات في [قسم ضبط الأمان](https://docs.bunkerweb.io/1.6.15/advanced/?utm_campaign=self&utm_source=github#security-tuning) من التوثيق.

# الإعدادات

كقاعدة عامة، عند تفعيل وضع المواقع المتعددة، إذا أردت تطبيق إعدادات ذات سياق المواقع المتعددة على خادم محدد، فستحتاج إلى إضافة اسم الخادم الأساسي (الأول) كبادئة مثل `www.example.com_USE_ANTIBOT=captcha` أو `myapp.example.com_USE_GZIP=yes`، على سبيل المثال.

عندما تُعتبر الإعدادات "متعددة"، فهذا يعني أنه يمكنك الحصول على مجموعات متعددة من الإعدادات لنفس الميزة بإضافة أرقام كلاحقات مثل `REVERSE_PROXY_URL_1=/subdir` و`REVERSE_PROXY_HOST_1=http://myhost1` و`REVERSE_PROXY_URL_2=/anotherdir` و`REVERSE_PROXY_HOST_2=http://myhost2`، ... على سبيل المثال.

راجع [قسم الميزات](https://docs.bunkerweb.io/1.6.15/features/?utm_campaign=self&utm_source=github) من التوثيق للحصول على القائمة الكاملة.

# واجهة الويب

https://github.com/user-attachments/assets/a3ed56f8-c124-4ca9-b8b3-4be0913b3078

"واجهة الويب" هي تطبيق ويب يساعدك على إدارة نسخة BunkerWeb الخاصة بك باستخدام واجهة سهلة الاستخدام بدلًا من واجهة سطر الأوامر.

فيما يلي قائمة الميزات التي توفّرها واجهة الويب:

- الحصول على عرض شامل للهجمات المحظورة
- بدء وإيقاف وإعادة تشغيل وإعادة تحميل نسخة BunkerWeb الخاصة بك
- إضافة وتعديل وحذف الإعدادات لتطبيقات الويب الخاصة بك
- إضافة وتعديل وحذف الإعدادات المخصصة لـ NGINX وModSecurity
- تثبيت وإلغاء تثبيت الإضافات الخارجية
- استكشاف الملفات المخزَّنة مؤقتًا
- مراقبة تنفيذ المهام وإعادة تشغيلها عند الحاجة
- عرض السجلات وأنماط البحث

ستجد مزيدًا من المعلومات في [قسم واجهة الويب](https://docs.bunkerweb.io/1.6.15/web-ui/?utm_campaign=self&utm_source=github) من التوثيق.

# الإضافات

يأتي BunkerWeb مع نظام إضافات لجعل إضافة ميزات جديدة أمرًا سهلًا. بمجرد تثبيت إضافة، يمكنك إدارتها باستخدام إعدادات إضافية تعرّفها الإضافة.

فيما يلي قائمة الإضافات "الرسمية" التي نُصونها (راجع مستودع [bunkerweb-plugins](https://github.com/bunkerity/bunkerweb-plugins/?utm_campaign=self&utm_source=github) لمزيد من المعلومات):

|      الاسم      | الإصدار | الوصف                                                                                                                      |                                                الرابط                                                 |
| :------------: | :-----: | :------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------: |
|   **ClamAV**   |   1.9   | يفحص الملفات المرفوعة تلقائيًا باستخدام محرك مكافحة الفيروسات ClamAV ويرفض الطلب عند اكتشاف ملف ضار. |     [bunkerweb-plugins/clamav](https://github.com/bunkerity/bunkerweb-plugins/tree/main/clamav)     |
|   **Coraza**   |   1.9   | يفحص الطلبات باستخدام Coraza WAF (بديل ModSecurity).                                                              |     [bunkerweb-plugins/coraza](https://github.com/bunkerity/bunkerweb-plugins/tree/main/coraza)     |
|  **Discord**   |   1.9   | يرسل إشعارات أمنية إلى قناة Discord باستخدام Webhook.                                                                |    [bunkerweb-plugins/discord](https://github.com/bunkerity/bunkerweb-plugins/tree/main/discord)    |
|   **Slack**    |   1.9   | يرسل إشعارات أمنية إلى قناة Slack باستخدام Webhook.                                                                  |      [bunkerweb-plugins/slack](https://github.com/bunkerity/bunkerweb-plugins/tree/main/slack)      |
| **VirusTotal** |   1.9   | يفحص الملفات المرفوعة تلقائيًا باستخدام VirusTotal API ويرفض الطلب عند اكتشاف ملف ضار.          | [bunkerweb-plugins/virustotal](https://github.com/bunkerity/bunkerweb-plugins/tree/main/virustotal) |
|  **WebHook**   |   1.9   | يرسل إشعارات أمنية إلى نقطة نهاية HTTP مخصصة باستخدام Webhook.                                                           |    [bunkerweb-plugins/webhook](https://github.com/bunkerity/bunkerweb-plugins/tree/main/webhook)    |

ستجد مزيدًا من المعلومات في [قسم الإضافات](https://docs.bunkerweb.io/1.6.15/plugins/?utm_campaign=self&utm_source=github) من التوثيق.

# دعم اللغات والتعريب

تدعم واجهة BunkerWeb لغات متعددة. تُدار الترجمات في المجلد `src/ui/app/static/locales`. اللغات المتاحة حاليًا هي:

- العربية (ar)
- البنغالية (bn)
- البرتغالية البرازيلية (br)
- الألمانية (de)
- الإنجليزية (en)
- الإسبانية (es)
- الفرنسية (fr)
- الهندية (hi)
- الإيطالية (it)
- الكورية (ko)
- البولندية (pl)
- البرتغالية (pt)
- الروسية (ru)
- التركية (tr)
- الصينية التقليدية (tw)
- الأردية (ur)
- الصينية المبسطة (zh)

راجع [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.15/src/ui/app/static/locales/README.md) للحصول على تفاصيل حول مصدر الترجمات وحالة المراجعة.

## المساهمة في الترجمات

نرحّب بالمساهمات لتحسين أو إضافة ملفات لغات جديدة!

**كيفية المساهمة بترجمة:**

1. عدّل ملف `src/ui/app/lang_config.py` لإضافة لغتك (الرمز، الاسم، العلم، english_name).
2. انسخ `en.json` كقالب في `src/ui/app/static/locales/`، وأعد تسميته إلى رمز لغتك (مثل `de.json` للألمانية).
3. ترجم القيم في ملفك الجديد.
4. حدّث الجدول في `locales/README.md` لإضافة لغتك والإشارة إلى من أنشأها/راجعها.
5. أرسل طلب سحب (pull request).

للتحديثات، عدّل الملف المعني وحدّث جدول المصدر حسب الحاجة.

راجع [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.15/src/ui/app/static/locales/README.md) للحصول على الإرشادات الكاملة.

# الدعم

## الاحترافي

احصل على دعم تقني مباشرة من مُصوني BunkerWeb. ستجد مزيدًا من المعلومات بزيارة [لوحة BunkerWeb](https://panel.bunkerweb.io/?utm_campaign=self&utm_source=github)، منصتنا المخصصة للخدمات الاحترافية.

لا تتردد في [الاتصال بنا](https://panel.bunkerweb.io/contact.php?utm_campaign=self&utm_source=github) إذا كانت لديك أي أسئلة؛ سنكون سعداء بالاستجابة لاحتياجاتك.

## المجتمع

للحصول على دعم مجاني من المجتمع، يمكنك استخدام الوسائط التالية:

- قناة #help الخاصة بـ BunkerWeb في [خادم Discord](https://discord.com/invite/fTf46FmtyD)
- فئة المساعدة في [مناقشات GitHub](https://github.com/bunkerity/bunkerweb/discussions)
- منتدى [/r/BunkerWeb](https://www.reddit.com/r/BunkerWeb) الفرعي
- منتديات [Server Fault](https://serverfault.com/) و[Super User](https://superuser.com/)

يُرجى عدم استخدام [مشكلات GitHub](https://github.com/bunkerity/bunkerweb/issues) لطلب المساعدة؛ استخدمها فقط للإبلاغ عن الأخطاء وطلبات الميزات.

# الترخيص

هذا المشروع مُرخَّص بموجب شروط [رخصة GNU Affero العامة (AGPL) الإصدار 3](https://github.com/bunkerity/bunkerweb/raw/v1.6.15/LICENSE.md).

# المساهمة

إذا كنت ترغب في المساهمة في الإضافات، يمكنك قراءة [إرشادات المساهمة](https://github.com/bunkerity/bunkerweb/blob/master/.github/CONTRIBUTING.md) للبدء.

# سياسة الأمان

نحن نتعامل مع أخطاء الأمان كمسائل خطيرة ونشجّع على الإفصاح المسؤول؛ راجع [سياسة الأمان](https://github.com/bunkerity/bunkerweb/blob/master/.github/SECURITY.md) الخاصة بنا لمزيد من المعلومات.

<!-- Star History chart hidden: GitHub restricted the stargazers API, so the chart renders an error
     notice instead of data. Uncomment once upstream serves real charts again.

# Star History

<a href="https://star-history.com/#bunkerity/bunkerweb&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=bunkerity/bunkerweb&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=bunkerity/bunkerweb&type=Date" />
   Star History Chart
 </picture>
</a>
-->