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