الانتقال إلى المحتوى الرئيسي

أمان

  • اضبط 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.
  • ربط خاص (APP_HOST=127.0.0.1 أو شبكة خاصة) عندما تحتاج الخدمات المحلية فقط إلى الوصول.
  • حد معدل الدخول الفاشلة في البروكسي؛ GOWA ليس لها حد المعدلات.

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

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

دوكر

  • ثبّت وسم إصدار محدد بدلًا من 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 للحصول على مثال nginx .

الرصد

  • فحص التشغيل: يعيد GET /health الحالة 200 OK عندما تكون العملية ومخزن البيانات قيد التشغيل. ولا يتحقق من WhatsApp.
  • اتصال WhatsApp: استطلاع الرأي GET /devices/{device_id}/status والتنبيه عندما يكون is_logged_in false.
  • الأحداث: اشترك في روابط الويب والتنبيه عن حركة المرور المفقودة لأرقام مشغولة.
  • السجلات: جمع سحب الحاوية؛ استخدم APP_DEBUG=true فقط أثناء استكشاف الأخطاء وإصلاحها.
تقوم GOWA بإعادة الاتصال تلقائيًا عند بدء التشغيل وتحقق من الاتصالات كل 5 دقائق. الجهاز الذي يسجل خروجه من الهاتف يجب أن يقترن مرة أخرى. GET /app/metrics عملية المصادقة والذاكرة والقرص ومقاييس الجهاز دون تحديد الجهاز. انظر مقاييس الخادم. التنبيه على 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 يوماً إذا ظل الهاتف غير متصل.