الانتقال إلى المحتوى الرئيسي
لمحة عامة عن الانتشار والوصول إلى GWAWA يُوزَّع GOWA كملف تنفيذي واحد. تبدأ واجهة REST API والـ webhooks ولوحة التحكم ونقطة نهاية MCP جميعها بالأمر whatsapp rest.

المتطلبات

المنصات المدعومة: Linux (amd64, arm64, armv7, 386)، macOS (Intel, Apple Silicon)، Windows (amd64, 386؛ WSL موصى بها).

دوكر

تُنشر الصور على Docker Hub و GHCR:
  • aldinokemal2104/go-whatsapp-web-multidevice
  • ghcr.io/aldinokemal/go-whatsapp-web-multidevice
  • /app/storages يحتوي على قواعد بيانات SQLite (دورات، سجل الدردشة، الجداول الزمنية، OAuth). فقدانها يزيل أزواج كل جهاز.
  • /app/statics يحمل صور QR والتحميلات والوسائط التي تم تنزيلها.
  • الأمر الافتراضي هو rest. مرر أعلام بعده ، على سبيل المثال ... go-whatsapp-web-multidevice rest --autoreply="Away".
  • نقطة الدخول تحدد ملكية الحجم وتسقط الامتيازات إلى gowauser (UID 20001, GID 20000).
  • وقت الحاوية هو UTC (TZ=UTC). تجاوز TZ إذا كنت بحاجة إلى علامات تسجيل زمنية محلية.

تكوين المرسى

docker-compose.yml
أنشئ مفتاحًا ثابتًا للويب هوك باستخدام openssl rand -hex 32 واضبط WHATSAPP_WEBHOOK_SECRET في الصدفة أو ملف .env الخاص بـ Compose قبل تشغيل هذا المثال. يبني ملف docker-compose.yml الخاص بالمستودع الصورة من docker/golang.Dockerfile ويقرأ src/.env. استخدمه عندما تريد البناء محليًا: cp src/.env.example src/.env && docker compose up -d --build.

الإصدار الثنائي

تحميل أرشيف من GitHub Releases. المحفوظات تسمى whatsapp_<version>_<os>_<arch>.zip، على سبيل المثال:
تثبيت أدوات الوسائط على المضيف:
تحقّق من الملف المنزّل بمقارنته مع checksums.txt من الإصدار نفسه. يطبع ./whatsapp version رقم الإصدار؛ ويعرض ./whatsapp --help جميع الخيارات.

من المصدر

على macOS، نفّذ أيضًا export CGO_CFLAGS_ALLOW="-Xpreprocessor" قبل البناء.

ARM بدون سلسلة أدوات C

علامة البناء purego تختار مشغل pure-Go SQLite ، بحيث يمكنك التجميع مع معطل CGO :

التخزين

بشكل افتراضي كل شيء هو SQLite تحت storages/: DB_URI يقبل أيضا PostgreSQL، على سبيل المثال postgres://user:pass@host:5432/gowa?sslmode=verify-full. تخزن جلسة PostgreSQL الافتراضية للتحقق من الشهادة عندما لا يتم تعيين وضع TLS فعال. لا تزال إعدادات عنوان URL الصريح أو البيئة أو خدمة PostgreSQL الخدمة TLS مطبقة. انظر إعدادات التخزين. ينشئ GOWA ملفات SQLite بالأذونات 0600 التي تقتصر على المالك، والمجلدات الأم الجديدة بالأذونات 0700. وتحتفظ المجلدات الموجودة بأذوناتها. انسخ storages/ احتياطيًا (أو PostgreSQL مع storages/) للحفاظ على الأجهزة المقترنة عند إعادة البناء. تعامل مع هذه النسخ الاحتياطية باعتبارها بيانات اعتماد.

خلف وكيل عكسي

خدمة GOWA تحت مسار فرعي مع APP_BASE_PATH، وثق في العناوين التي تم توجيهها للوكيل مع APP_TRUSTED_PROXIES:
/health يبقى في الجذر (/health، ليس /gowa/health) لذا فإن المسح يعمل بغض النظر عن المسار الأساسي. تحتاج آلية التحقق من أصل المتصفح إلى المضيف العام. حافظ على Host كما سبق، أو أرسل X-Forwarded-Host من وكيل موثوق. وتتطلب لوحة التحكم المستضافة بصورة منفصلة إدراج أصلها الدقيق في APP_TRUSTED_ORIGINS أو APP_CORS_ALLOWED_ORIGINS. لا يمنح حرف البدل الإذن بعمليات التعديل أو اتصالات WebSocket. قدّم لوحة التحكم عبر HTTP أو HTTPS، لأن صفحات file:// لها أصل null غير موثوق. يرفض المستمع الافتراضي البدء دون إكمال بيانات اعتماد المصادقة الأساسية. فقط تمكين APP_ALLOW_UNAUTHENTICATED=true عندما يصدق الوكيل المتصلين والعملاء لا يمكن تجاوزه. للتنمية المحلية بدون مصادقة، ربط APP_HOST=127.0.0.1.

تحقق

/health يرجع OK بمجرد تهيئة التخزين. لا يبلغ عما إذا كان أي حساب WhatsApp متصلا؛ استخدم GET /devices/{device_id}/status لهذا الغرض.

ترقية

انسخ storages/ احتياطيًا، ثم اسحب الصورة أو الملف التنفيذي الجديد وأعِد التشغيل. اقرأ ملاحظات الإصدار أولًا لمعرفة التغييرات غير المتوافقة مع الإصدارات السابقة. ومن أبرزها: جعل v6 الأمر الفرعي rest إلزاميًا، ونقل v7 الملفات التنفيذية إلى أرشيفات GoReleaser، وأضاف v8 دعم الأجهزة المتعددة (تتطلب الاستدعاءات الخاصة بجهاز الترويسة X-Device-Id بمجرد وجود أكثر من جهاز)، واستُبدل وضع whatsapp mcp المستقل (:8080/sse) بنقطة النهاية /mcp على خادم REST.