Güvenlik
APP_BASIC_AUTHdeğerini ayarlayın ve uzun, rastgele bir parola kullanın.APP_ALLOW_UNAUTHENTICATED=truebu 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_SECRETdeğ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 üzerindenX-Hub-Signature-256değ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.
/staticseriş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 vestatics/mediadizinini düzenli olarak temizleyin.- Chatwoot etkinken
/chatwoot/webhookyolunuCHATWOOT_WEBHOOK_SECRETolmadan dışarı açmayın. - Tarayıcılar API’yi doğrudan çağırıyorsa
APP_CORS_ALLOWED_ORIGINSdeğerini ayarlayın; joker karakterli CORS, tarayıcıdan yazma işlemlerine veya/wserişimine yetki vermez.APP_TRUSTED_ORIGINSveya 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.1veya ö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_URIiç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
latestyerine 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=UTCdeğerini ayarlar. Zamanlamalar verdiğiniztimezonedeğerini kullandığından bu durum onları etkilemez.
Ters vekil
- İstemci IP’lerinin doğru okunması için
APP_TRUSTED_PROXIESdeğ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_PATHkullanın;/healthkökte kalır.
İzleme
- Canlılık: süreç ve depolama çalışıyorsa
GET /health,200 OKdöndürür. WhatsApp’ı denetlemez. - WhatsApp bağlantısı:
GET /devices/{device_id}/statusyolunu düzenli sorgulayın veis_logged_in,falseolduğ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=truedeğerini yalnızca sorun giderirken kullanın.
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
2xxyanı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 /chatsveGET /chat/{jid}/messageskullanı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_TIMELOCKdurumunda durun.- Kayıtlı olmayan numaraların hızla hata vermesi için
WHATSAPP_ACCOUNT_VALIDATION=truedeğ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.
