> ## 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 مع Docker, Docker Compose، ثنائي الإصدار أو من المصدر، وتشغيله خلف وكيل عكسي.

![لمحة عامة عن الانتشار والوصول إلى GWAWA](https://mintcdn.com/gowa-docs/xwa06XWUO2vnG9_f/images/GOWA-Deployment-and-Access-Overview.png?fit=max\&auto=format\&n=xwa06XWUO2vnG9_f\&q=85\&s=dc847e074e7578d3cfb8c83f1d756040)

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

## المتطلبات

| البند | مطلوب لـ |
| - | - |
| FFmpeg | تحويل الوسائط (فيديو، ملاحظات صوتية). متضمنة في صورة Docker. |
| أدوات libwebp (`cwebp`، `dwebp`، `webpmux`) | الملصقات، بما في ذلك WebP. متضمنة في صورة Docker. |
| الذهاب 1.26+ | البناء من المصدر فقط. |

المنصات المدعومة: 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`

```bash theme={null}
docker volume create gowa_storages
docker volume create gowa_statics

docker run -d --name gowa --restart always \
  -p 3000:3000 \
  -v gowa_storages:/app/storages \
  -v gowa_statics:/app/statics \
  -e APP_BASIC_AUTH=admin:changeme \
  aldinokemal2104/go-whatsapp-web-multidevice:latest
```

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

### تكوين المرسى

```yaml docker-compose.yml theme={null}
services:
  gowa:
    image: aldinokemal2104/go-whatsapp-web-multidevice:latest
    container_name: gowa
    restart: always
    ports:
      - "3000:3000"
    environment:
      APP_BASIC_AUTH: admin:changeme
      WHATSAPP_WEBHOOK: https://example.com/wa-hook
      WHATSAPP_WEBHOOK_SECRET: ${WHATSAPP_WEBHOOK_SECRET}
    volumes:
      - gowa_storages:/app/storages
      - gowa_statics:/app/statics

volumes:
  gowa_storages:
  gowa_statics:
```

أنشئ مفتاحًا ثابتًا للويب هوك باستخدام `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](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). المحفوظات تسمى `whatsapp_<version>_<os>_<arch>.zip`، على سبيل المثال:

```bash theme={null}
curl -fLO https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/download/v9.9.0/whatsapp_9.9.0_linux_amd64.zip
unzip whatsapp_9.9.0_linux_amd64.zip
chmod +x whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

تثبيت أدوات الوسائط على المضيف:

```bash theme={null}
# Debian/Ubuntu
sudo apt install ffmpeg webp
# macOS
brew install ffmpeg webp
```

تحقّق من الملف المنزّل بمقارنته مع `checksums.txt` من الإصدار نفسه. يطبع `./whatsapp version` رقم الإصدار؛ ويعرض `./whatsapp --help` جميع الخيارات.

## من المصدر

```bash theme={null}
git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
cd go-whatsapp-web-multidevice/src
cp .env.example .env    # optional
go build -o whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

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

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

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

```bash theme={null}
# Raspberry Pi 2/3/4 (ARMv7)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -tags purego -o whatsapp-armv7
# Raspberry Pi Zero/1 (ARMv6)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -tags purego -o whatsapp-armv6
```

## التخزين

بشكل افتراضي كل شيء هو SQLite تحت `storages/`:

| البيانات | الافتراضي | الإعدادات |
| - | - | - |
| جلسات واتسآب والمفاتيح | `file:storages/whatsapp.db` | `DB_URI` |
| ذاكرة التخزين المؤقت لمفتاح الجلسة (اختياري، فصل DB) | uses `DB_URI` | `DB_KEYS_URI` |
| سجل المحادثات، سجل الجهاز، الجداول الزمنية | `file:storages/chatstorage.db` | غير قابل للتكوين |
| عملاء MCP OAuth والرموز المميزة | `file:storages/oauth.db` | `MCP_OAUTH_DB_URI` |

`DB_URI` يقبل أيضا PostgreSQL، على سبيل المثال `postgres://user:pass@host:5432/gowa?sslmode=verify-full`. تخزن جلسة PostgreSQL الافتراضية للتحقق من الشهادة عندما لا يتم تعيين وضع TLS فعال. لا تزال إعدادات عنوان URL الصريح أو البيئة أو خدمة PostgreSQL الخدمة TLS مطبقة. انظر [إعدادات التخزين](https://gowa-docs.mintlify.site/ar/configuration.md#%D8%A7%D9%84%D8%AA%D8%AE%D8%B2%D9%8A%D9%86).

ينشئ GOWA ملفات SQLite بالأذونات `0600` التي تقتصر على المالك، والمجلدات الأم الجديدة بالأذونات `0700`. وتحتفظ المجلدات الموجودة بأذوناتها. انسخ `storages/` احتياطيًا (أو PostgreSQL مع `storages/`) للحفاظ على الأجهزة المقترنة عند إعادة البناء. تعامل مع هذه النسخ الاحتياطية باعتبارها بيانات اعتماد.

## خلف وكيل عكسي

خدمة GOWA تحت مسار فرعي مع `APP_BASE_PATH`، وثق في العناوين التي تم توجيهها للوكيل مع `APP_TRUSTED_PROXIES`:

```bash theme={null}
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password \
  --base-path=/gowa --trusted-proxies=10.0.0.0/8
```

```nginx theme={null}
location /gowa/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;     # WebSocket at /gowa/ws
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 100m;                  # largest upload GOWA accepts
}
```

`/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`.

## تحقق

```bash theme={null}
curl http://localhost:3000/health                      # OK, no auth needed
curl -u admin:changeme http://localhost:3000/app/info  # server info, no device needed
curl -u admin:changeme http://localhost:3000/devices   # registered devices
```

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

## ترقية

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


## Related topics

- [تثبيت أو إلغاء تثبيت الدردشة](https://gowa-docs.mintlify.site/ar/api-reference/chat/تثبيت-أو-إلغاء-تثبيت-الدردشة.md)
- [البداية السريعة](https://gowa-docs.mintlify.site/ar/quickstart.md)
- [التعامل مع الوسائط](https://gowa-docs.mintlify.site/ar/examples/media-handling.md)


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