> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# أفضل الممارسات الإنتاجية

> شغّل GOWA بأمان في بيئة الإنتاج: الأمان والتخزين والنسخ الاحتياطية والوكيل العكسي والمراقبة وممارسات الإرسال السليمة.

## أمان

* **اضبط `APP_BASIC_AUTH`** باستخدام كلمة مرور طويلة وعشوائية. يتطلب الربط بعنوان غير عنوان الاسترجاع المحلي بيانات اعتماد، ما لم يُعطَّل هذا التحقق صراحةً باستخدام `APP_ALLOW_UNAUTHENTICATED=true`. يمكن التشغيل على عنوان الاسترجاع المحلي دون بيانات اعتماد لأغراض التطوير المحلي.
* **قم بتعيين `WHATSAPP_WEBHOOK_SECRET` صراحةً.** بدونه، تقوم GOWA بتوليد مفتاح عشوائي يتغير عند إعادة التشغيل. تحقق من `X-Hub-Signature-256` فوق جسم الطلب الخام. استمر بتمكين التحقق عبر webhook TLS.
* **انهاء TLS** بوكيل عكسي؛ GOWA نفسها تتحدث HTTP واضحة.
* **قيّد الوصول إلى `/statics`.** تُقدَّم رموز QR والوسائط المنزّلة ضمن `/statics/*` **دون** مصادقة أساسية. احظر هذا المسار أو احمه على مستوى الوكيل إذا كانت الوسائط حساسة، ونظّف `statics/media` دوريًا.
* **لا تعرض `/chatwoot/webhook` بدون `CHATWOOT_WEBHOOK_SECRET`** عند تمكين Chatwoot.
* **تعيين `APP_CORS_ALLOWED_ORIGINS`** إذا استدعت المتصفحات API مباشرة؛ لا تصرح CORS بكتابة المتصفح أو `/ws`. تكوين أصول محددة في `APP_TRUSTED_ORIGINS` أو قائمة السماح لـ CORS. انظر [Authentication](https://gowa-docs.mintlify.site/ar/api-reference/authentication.md).
* **ربط خاص** (`APP_HOST=127.0.0.1` أو شبكة خاصة) عندما تحتاج الخدمات المحلية فقط إلى الوصول.
* حد معدل الدخول الفاشلة في البروكسي؛ GOWA ليس لها [حد المعدلات](https://gowa-docs.mintlify.site/ar/advanced/rate-limiting.md).

## التخزين والنسخ الاحتياطية

| المسار | المحتويات | النسخ الاحتياطي؟ |
| - | - | - |
| `storages/whatsapp.db` (أو `DB_URI`) | جلسات واتسآب والمفاتيح | نعم. فقدانه يعني إعادة إقران كل جهاز. |
| `storages/chatstorage.db` | الدردشات، الرسائل، الجداول الزمنية وغيرها من حالة GOWA | نعم |
| `storages/oauth.db` | عملاء MCP OAuth و تجزئة الرموز | إذا تم استخدام OAuth |
| `statics/` | رموز QR، محملة و مجدولة | اختياري |

* استخدم PostgreSQL ل `DB_URI` إذا كنت ترغب في إدارة النسخ الاحتياطية؛ تخزين الدردشة هو دائماً SQLite.
* النسخ الاحتياطي بينما يتم إيقاف نظام GOWA أو استخدام أدوات النسخ الاحتياطي لقاعدة البيانات الخاصة بك.
* تخزين النسخ الاحتياطي مشفر: قاعدة بيانات الجلسة تعادل حساب تسجيل الدخول.
* **قم بتشغيل مثال واحد من نموذج GWA لكل تخزين.** عمليتان تتقاسمان جلسة تسبب قطع الاتصال والنزاعات. لا تدعم GOWA الحجم الأفقي.

## دوكر

```bash theme={null}
docker run -d --name gowa --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v gowa-storages:/app/storages \
  -v gowa-statics:/app/statics \
  -e APP_BASIC_AUTH=admin:a-long-random-password \
  -e WHATSAPP_WEBHOOK=https://example.com/wa-hook \
  -e WHATSAPP_WEBHOOK_SECRET=another-long-random-secret \
  aldinokemal2104/go-whatsapp-web-multidevice:v9.9.0 rest
```

* ثبّت وسم إصدار محدد بدلًا من `latest`، واقرأ ملاحظات الإصدار قبل الترقية.
* تعمل الحاوية كمستخدم غير جذري (UID 20001)؛ تأكد من أن المجلدات المركبة قابلة للكتابة.
* مجموعات الصور `TZ=UTC`. الجداول تستخدم `timezone` التي تمارسها، لذلك لا يؤثر ذلك عليها.

## الوكيل العكسي

* تعيين `APP_TRUSTED_PROXIES` إلى نطاق عنوان الوكيل الخاص بك بحيث يتم قراءة عناوين IP العميل بشكل صحيح.
* السماح بترقيات WebSocket على `/ws`.
* رفع حد الجسم إلى 100 ميغابايت على الأقل (`client_max_body_size 100m;` في nginx).
* الحفاظ على مهلة الوكيل فوق مهلة طلب GOWA، 45 ثانية.
* بالنسبة لعمليات النشر في المسارات الفرعية استخدم `APP_BASE_PATH`; `/health` تبقى في الجذر.

انظر [Installation](https://gowa-docs.mintlify.site/ar/installation.md#%D8%AE%D9%84%D9%81-%D9%88%D9%83%D9%8A%D9%84-%D8%B9%D9%83%D8%B3%D9%8A) للحصول على مثال nginx .

## الرصد

* **فحص التشغيل:** يعيد `GET /health` الحالة `200 OK` عندما تكون العملية ومخزن البيانات قيد التشغيل. ولا يتحقق من WhatsApp.
* **اتصال WhatsApp:** استطلاع الرأي `GET /devices/{device_id}/status` والتنبيه عندما يكون `is_logged_in` `false`.
* **الأحداث:** اشترك في روابط الويب والتنبيه عن حركة المرور المفقودة لأرقام مشغولة.
* **السجلات:** جمع سحب الحاوية؛ استخدم `APP_DEBUG=true` فقط أثناء استكشاف الأخطاء وإصلاحها.

تقوم GOWA بإعادة الاتصال تلقائيًا عند بدء التشغيل وتحقق من الاتصالات كل 5 دقائق. الجهاز الذي يسجل خروجه من الهاتف يجب أن يقترن مرة أخرى.

`GET /app/metrics` عملية المصادقة والذاكرة والقرص ومقاييس الجهاز دون تحديد الجهاز. انظر [مقاييس الخادم](https://gowa-docs.mintlify.site/ar/api-reference/metrics.md). التنبيه على `device.logged_out`, `device.temporary_ban`, and `device.reachout_timelock` webhooks.

## مستقبلو Webhook

* أعِد استجابة `2xx` خلال 10 ثوانٍ؛ ونفّذ المعالجة بشكل غير متزامن.
* جدولة التكرار حسب الجهاز ونوع الحدث ومعرفات الحدث. معرفات الرسالة وحدها لا تميز التعديلات أو ردود الفعل أو حالات الإيصال اللاحقة.
* بعد خمس محاولات فاشلة تم إسقاط الحدث. استخدم `GET /chats` و `GET /chat/{jid}/messages` للحاق بالركب بعد الانقطاع.

## إرسال النظافة الصحية

* رسالة الأشخاص الذين اختاروا أو كتبوا أولاً.
* يرسل التسلسل مع التأخيرات والتأخير؛ ويتفادى النص المتطابق بالجملة.
* توقف عن `WA_REACHOUT_TIMELOCK`.
* أبقي `WHATSAPP_ACCOUNT_VALIDATION=true` الأعداد غير المسجلة تفشل بسرعة.
* WhatsApp يسمح بما يصل إلى أربعة أجهزة مصاحبة مرتبطة في كل حساب، ويفصّل وصلات المرافقين بعد حوالي 14 يوماً إذا ظل الهاتف غير متصل.


## Related topics

- [احصل على قياسات صحة الخادم](https://gowa-docs.mintlify.site/ar/api-reference/app/احصل-على-قياسات-صحة-الخادم.md)
- [الوب](https://gowa-docs.mintlify.site/ar/concepts/webhooks.md)
- [مقاييس الخادم](https://gowa-docs.mintlify.site/ar/api-reference/metrics.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.