## وضع المواقع المتعددة

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

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

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

## التكوينات المخصصة

نظرًا لأن تلبية جميع حالات الاستخدام باستخدام الإعدادات فقط ليس خيارًا (حتى مع [الإضافات الخارجية](https://docs.bunkerweb.io/1.6.13/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="نموذج قاعدة البيانات" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/docs/assets/img/bunkerweb_db.svg" />
</p>

يتم تخزين حالة التكوين الحالي لـ BunkerWeb في قاعدة بيانات خلفية تحتوي على البيانات التالية:

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

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

## المجدول

لجعل الأمور تعمل تلقائيًا معًا، هناك خدمة مخصصة تسمى المجدول مسؤولة عن:

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

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

# الإعداد

<!--## BunkerWeb Cloud

<p align="center">
	<img alt="لافتة Docker" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/docs/assets/img/bunkerweb-cloud.webp" />
</p>

BunkerWeb Cloud هي أسهل طريقة للبدء مع BunkerWeb. تقدم لك خدمة BunkerWeb مُدارة بالكامل دون عناء. فكر فيها كخدمة BunkerWeb كخدمة!

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

<p align="center">
	<img alt="لافتة لينكس" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/docs/assets/img/integration-linux.svg" />
</p>

قائمة توزيعات لينكس المدعومة:

- 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

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

## Docker

<p align="center">
	<img alt="لافتة Docker" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/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.13/integrations/?utm_campaign=self&utm_source=github#docker) من التوثيق.

## Docker autoconf

<p align="center">
	<img alt="لافتة Docker autoconf" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/docs/assets/img/integration-autoconf.svg" />
</p>

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

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

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

## Kubernetes

<p align="center">
	<img alt="لافتة Kubernetes" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/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.13/integrations/?utm_campaign=self&utm_source=github#kubernetes) من التوثيق.

## Microsoft Azure

<p align="center">
	<img alt="لافتة Azure" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/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.13/misc/integrations/azure-arm-template.json).

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

## Swarm

<p align="center">
	<img alt="لافتة Swarm" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/docs/assets/img/integration-swarm.svg" />
</p>

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

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

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

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

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

# ضبط الأمان

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

ستجد مزيدًا من المعلومات في [قسم ضبط الأمان](https://docs.bunkerweb.io/1.6.13/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.13/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.13/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 (بديل لـ 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   | يقوم تلقائيًا بفحص الملفات المرفوعة باستخدام API VirusTotal ويرفض الطلب عند اكتشاف ملف ضار.                                    | [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.13/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.13/src/ui/app/static/locales/README.md) للحصول على تفاصيل حول مصدر الترجمة وحالة المراجعة.

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

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

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

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

للتحديثات، قم بتحرير الملف ذي الصلة وتحديث جدول المصدر حسب الحاجة.

راجع [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/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)
- subreddit [/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 General Public License (AGPL) الإصدار 3](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/LICENSE.md).

# المساهمة

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

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

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

# تاريخ النجوم

<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" />
   <img alt="مخطط تاريخ النجوم" src="https://assets.kitploit.com/production/public/readmes/placeholders/f0fc86cfe65f76d40e15aaec61704ec8220a56dc89d4be03c46f67cb31b9fa8c.svg" />
 </picture>
</a>