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

الحدود

الحد الأقصى لجهاز طلب HTTP يساوي حد الفيديو (100 ميغابايت)، لذلك لا يمكن أن يتجاوز الرفع. استفسر عن القيم الحية باستخدام GET /app/info (max_image_size, max_file_size, max_video_size). هذه الحدود يتم تجميعها بشكل افتراضي؛ لا يوجد متغير بيئة لهم.

طريقتان لتوفير وسائل الإعلام

تقبل كل نقطة نهاية للوسائط إما ملفًا ضمن طلب متعدد الأجزاء أو عنوان URL يجلب GOWA محتواه من جانب الخادم:
إرسال واحد أو الآخر، وليس كليهما. يجب أن تستخدم عناوين الوسائط البعيدة HTTP أو HTTPS وأن تعقد العزم على العناوين العامة. تقوم GOWA بحظر الحلقة الخلفية، الخاصة، والربط - المحلي، وغيرها من الوجهات المحجوزة، بما في ذلك إعادة توجيه الأهداف. تحميل الملفات المحلية كبيانات متعددة الأجزاء بدلاً من استخدام عنوان URL داخلي.

معالجة

تحتاج GOWA إلى Fmpeg و libwebp على المضيف (كلاهما في صورة Docker). /send/file يرسل المستندات دون تحويل. معالجة الصور تفحص أبعاد الترويسة قبل فك الترميز. أطول حافة مقبولة هي 768 32 بكسل. الصور غير JPEG لديها ميزانية 40 مليون بكسل. ولدى JPEGs سقف قدره 80 مليون بكسل بالإضافة إلى ميزانية تفكيك الذاكرة 320 ميغابايت، وبالتالي يرفض عدد كبير من JPEG تقدمي أو MYK دون سقف البكسل. يمكن لإرسال الصورة الأصلية حذف الصور المصغرة عندما يتجاوز فك الترميز الميزانية. الصور المتحركة التفاعلية لها حدود منفصلة أصغر في الرسائل التفاعلية.

الوسائط الواردة

عند ضبط WHATSAPP_AUTO_DOWNLOAD_MEDIA=true (الإعداد الافتراضي)، ينزّل GOWA الوسائط من الرسائل الواردة إلى statics/media/ ويضع المسار النسبي في حمولة خطاف الويب:
إحضاره على http://<host>:3000/statics/media/<file>. تعيين WHATSAPP_IGNORE_STATUS_MEDIA=true لتخطي الوسائط من تحديثات الحالة. مع إيقاف التحميل التلقائي، تحمل الحمولة عنوان WatsApp CDN بدلاً من ذلك. قم بالتحميل من خلال GOWA، الذي يقوم بفك تشفير الملف:
WhatsApp يحتفظ بالوسائط على خوادمه لفترة محدودة. قم بتنزيل ما تحتاجه على الفور. على نظام GOWA main بعد v9.9.0، يمكن للتنزيلات الصريحة وأجهزة إعادة التوجيه أن تطلب من الهاتف إعادة تحميل الوسائط التي انتهت صلاحيتها. يجب أن يكون الهاتف على الإنترنت ولا يزال لديه الملف. وتنتظر GOWA ما يصل إلى 30 ثانية للحصول على رد. وينطبق هذا أيضا على إجراءات MCP download_media و forward و Chatwoot Histimports.

التخزين والتنظيف

المسارات نسبية إلى دليل العملية، وعادةً ما يكون src/ عند التشغيل من المصدر أو /app في Docker. يربط Compose دليلي storages/ وstatics/ في المستودع داخل /app. لا يوجد إعداد للاحتفاظ بالوسائط بناءً على عمرها أو نقطة نهاية لتنظيفها. قد توجد نسخ من الصورة في كلٍّ من storages/ وstatics/media/. لا تحذف دليل storages/ بالكامل مطلقًا لاستعادة مساحة الوسائط. أوقف GOWA وأي عمليات أخرى تكتب البيانات مؤقتًا، وأنشئ نسخة احتياطية من الملفات المطلوبة، ثم عاين الملفات المراد حذفها. تُنفَّذ أمثلة GNU find هذه من دليل النشر وتختار الملفات التي مضى عليها 31 يومًا كاملًا على الأقل.
بعد مراجعة كل مسار، استبدل -print بـ -delete في الأوامر نفسها. احتفظ بملفات قاعدة البيانات، وملفات SQLite المصاحبة -wal و-shm، والمرفقات المجدولة، والملفات المخصصة. أعد تشغيل GOWA بعد ذلك. تتوقف المسارات المحذوفة وعناوين URL الثابتة عن العمل، ولا تؤدي إزالة الوسائط إلى حذف سجل المحادثات. WHATSAPP_AUTO_DOWNLOAD_MEDIA=false توقف التنزيلات التلقائية والنسخ الإضافية للصور في المستقبل. لا يزيل الملفات القديمة أو يمنع تنزيلات REST أو MCP الصريحة. راجع دليل تخزين وتنظيف الوسائط الكامل](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/media-storage.md). /statics لا يزال عاماً. ويتم استخدام HTML وSVG والنصوص النصية والمستندات الأخرى كمرفقات مع application/octet-stream وnosniff. وحدات البايت للصور المدعومة تحت مسارات معاينة الصورة يمكن أن تكون داخل الخط. حماية المحتوى هذه لا تقيد من يمكنه تنزيل ملف. حماية الوسائط الحساسة عند الوكيل العكسي.

استكشاف الأخطاء