Ana içeriğe atla

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.
  • 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 yoktur.

Depolama ve yedekler

  • 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

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