> ## 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.

# Üretim Ortamı İçin En İyi Uygulamalar

> GOWA'yı üretimde güvenle çalıştırın: güvenlik, depolama, yedekler, ters vekil, izleme ve sağlıklı gönderim.

## Güvenlik

* **`APP_BASIC_AUTH` değerini ayarlayın** ve uzun, rastgele bir parola kullanın. `APP_ALLOW_UNAUTHENTICATED=true` bu denetimi açıkça devre dışı bırakmadıkça, loopback dışındaki bir adrese bağlanmak kimlik bilgileri gerektirir. Yerel geliştirme için loopback üzerinde kimlik bilgileri olmadan çalışılabilir.
* **`WHATSAPP_WEBHOOK_SECRET` değerini açıkça ayarlayın.** Aksi halde GOWA, yeniden başlatıldığında değişen rastgele bir anahtar üretir. Ham istek gövdesi üzerinden `X-Hub-Signature-256` değerini doğrulayın. Giden webhook'lar için TLS doğrulamasını etkin tutun.
* **TLS'yi bir ters vekilde sonlandırın**; GOWA'nın kendisi düz HTTP kullanır.
* **`/statics` erişimini kısıtlayın.** `/statics/*` altındaki QR kodları ve indirilen medya Basic Auth **olmadan** sunulur. Medya hassassa bu yolu vekilde engelleyin veya koruyun ve `statics/media` dizinini düzenli olarak temizleyin.
* Chatwoot etkinken **`/chatwoot/webhook` yolunu `CHATWOOT_WEBHOOK_SECRET` olmadan dışarı açmayın**.
* Tarayıcılar API'yi doğrudan çağırıyorsa **`APP_CORS_ALLOWED_ORIGINS` değerini ayarlayın**; joker karakterli CORS, tarayıcıdan yazma işlemlerine veya `/ws` erişimine yetki vermez. `APP_TRUSTED_ORIGINS` veya CORS izin listesinde belirli kaynakları yapılandırın. Bkz. [Kimlik doğrulama](https://gowa-docs.mintlify.site/tr/api-reference/authentication.md).
* Yalnızca yerel hizmetlerin erişmesi gerekiyorsa **özel bir adrese bağlanın** (`APP_HOST=127.0.0.1` veya özel ağ).
* Başarısız girişlere vekilde hız sınırı uygulayın; GOWA'da yerleşik [hız sınırlama](https://gowa-docs.mintlify.site/tr/advanced/rate-limiting.md) yoktur.

## Depolama ve yedekler

| Yol | İçerik | Yedeklensin mi? |
| - | - | - |
| `storages/whatsapp.db` (veya `DB_URI`) | WhatsApp oturumları ve anahtarları | Evet. Kaybolursa her cihazın yeniden eşleştirilmesi gerekir. |
| `storages/chatstorage.db` | Sohbetler, mesajlar, zamanlamalar ve diğer GOWA durumu | Evet |
| `storages/oauth.db` | MCP OAuth istemcileri ve belirteç karmaları | OAuth kullanılıyorsa |
| `statics/` | QR kodları, indirilen ve zamanlanmış medya | İsteğe bağlı |

* Yönetilen yedekler istiyorsanız `DB_URI` için PostgreSQL kullanın; sohbet depolaması her zaman SQLite'tır.
* GOWA durdurulmuşken yedekleyin veya veritabanınızın çevrimiçi yedekleme araçlarını kullanın.
* Yedekleri şifreli saklayın: oturum veritabanı, oturum açmış bir hesapla eşdeğerdir.
* **Her depolama için bir GOWA örneği çalıştırın.** Aynı oturumu paylaşan iki süreç bağlantı kopmalarına ve çakışmalara yol açar. GOWA yatay ölçeklemeyi desteklemez.

## Docker

```bash theme={null}
docker run -d --name gowa --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v gowa-storages:/app/storages \
  -v gowa-statics:/app/statics \
  -e APP_BASIC_AUTH=admin:a-long-random-password \
  -e WHATSAPP_WEBHOOK=https://example.com/wa-hook \
  -e WHATSAPP_WEBHOOK_SECRET=another-long-random-secret \
  aldinokemal2104/go-whatsapp-web-multidevice:v9.9.0 rest
```

* `latest` yerine belirli bir sürüm etiketi kullanın ve yükseltmeden önce sürüm notlarını okuyun.
* Konteyner, root olmayan bir kullanıcıyla (UID 20001) çalışır; bağlanan birimlerin yazılabilir olduğundan emin olun.
* İmaj `TZ=UTC` değerini ayarlar. Zamanlamalar verdiğiniz `timezone` değerini kullandığından bu durum onları etkilemez.

## Ters vekil

* İstemci IP'lerinin doğru okunması için `APP_TRUSTED_PROXIES` değerini vekilinizin adres aralığına ayarlayın.
* `/ws` üzerinde WebSocket yükseltmelerine izin verin.
* Gövde sınırını en az 100 MB'a yükseltin (nginx'te `client_max_body_size 100m;`).
* Vekil zaman aşımlarını GOWA'nın 45 saniyelik istek zaman aşımından yüksek tutun.
* Alt yola dağıtımlar için `APP_BASE_PATH` kullanın; `/health` kökte kalır.

Nginx örneği için [Kurulum](https://gowa-docs.mintlify.site/tr/installation.md#ters-vekil-arkas%C4%B1nda) sayfasına bakın.

## İzleme

* **Canlılık:** süreç ve depolama çalışıyorsa `GET /health`, `200 OK` döndürür. WhatsApp'ı denetlemez.
* **WhatsApp bağlantısı:** `GET /devices/{device_id}/status` yolunu düzenli sorgulayın ve `is_logged_in`, `false` olduğunda uyarı verin.
* **Olaylar:** webhook'lara abone olun ve yoğun numaralarda trafik kesilirse uyarı verin.
* **Günlükler:** konteynerin standart çıktısını toplayın; `APP_DEBUG=true` değerini yalnızca sorun giderirken kullanın.

GOWA başlangıçta otomatik olarak yeniden bağlanır ve bağlantıları her 5 dakikada bir denetler. Telefondan oturumu kapatılan bir cihazın yeniden eşleştirilmesi gerekir.

`GET /app/metrics`, cihaz seçmeden kimlik doğrulaması gerektiren süreç, bellek, disk ve cihaz ölçümlerini döndürür. Bkz. [Sunucu ölçümleri](https://gowa-docs.mintlify.site/tr/api-reference/metrics.md). `device.logged_out`, `device.temporary_ban` ve `device.reachout_timelock` webhook'larında uyarı verin.

## Webhook alıcıları

* 10 saniye içinde `2xx` yanıtı verin; işi eşzamansız işleyin.
* Cihaz, olay türü ve olayın tanımlayıcılarına göre yinelenenleri ayıklayın. Mesaj kimlikleri tek başına düzenlemeleri, tepkileri veya sonraki alındı durumlarını ayırt etmez.
* 5 başarısız denemeden sonra olay atılır. Kesintiden sonra eksikleri tamamlamak için `GET /chats` ve `GET /chat/{jid}/messages` kullanın.

## Sağlıklı gönderim

* İzin vermiş veya önce size yazmış kişilere mesaj gönderin.
* Gönderim hızını gecikmeler ve rastgele süre değişimleriyle ayarlayın; aynı toplu metinlerden kaçının.
* `WA_REACHOUT_TIMELOCK` durumunda durun.
* Kayıtlı olmayan numaraların hızla hata vermesi için `WHATSAPP_ACCOUNT_VALIDATION=true` değerini koruyun.
* WhatsApp, hesap başına en fazla dört bağlı yardımcı cihaza izin verir ve telefon çevrimdışı kalırsa yaklaşık 14 gün sonra yardımcı cihazların bağlantısını kaldırır.


## Related topics

- [En son bülten (kanal) mesajlarını getir](https://gowa-docs.mintlify.site/tr/api-reference/newsletter/en-son-bülten-kanal-mesajlarını-getir.md)
- [Deneysel bir etkileşimli mesaj gönder](https://gowa-docs.mintlify.site/tr/api-reference/send/deneysel-bir-etkileşimli-mesaj-gönder.md)
- [Deneysel etkileşimli mesajlar](https://gowa-docs.mintlify.site/tr/examples/interactive-messages.md)
- [Chatwoot Entegrasyonu](https://gowa-docs.mintlify.site/tr/integrations/chatwoot.md)
- [Telefondan daha eski sohbet geçmişini iste](https://gowa-docs.mintlify.site/tr/api-reference/chat/telefondan-daha-eski-sohbet-geçmişini-iste.md)


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