Keamanan
- Atur
APP_BASIC_AUTHdengan kata sandi acak yang panjang. Bind ke alamat non-loopback memerlukan kredensial, kecualiAPP_ALLOW_UNAUTHENTICATED=truesecara eksplisit menonaktifkan pemeriksaan tersebut. Loopback dapat berjalan tanpa kredensial untuk pengembangan lokal. - Atur
WHATSAPP_WEBHOOK_SECRETsecara eksplisit. Tanpanya, GOWA membuat kunci acak yang berubah setiap kali dimulai ulang. VerifikasiX-Hub-Signature-256terhadap body permintaan mentah. Tetap aktifkan verifikasi TLS untuk webhook keluar. - Lakukan terminasi TLS di reverse proxy; GOWA sendiri menggunakan HTTP biasa.
- Batasi
/statics. Kode QR dan media yang diunduh di/statics/*disajikan tanpa Basic Auth. Blokir atau lindungi jalur tersebut di proxy jika media bersifat sensitif, dan bersihkanstatics/mediasecara rutin. - Jangan mengekspos
/chatwoot/webhooktanpaCHATWOOT_WEBHOOK_SECRETsaat Chatwoot diaktifkan. - Atur
APP_CORS_ALLOWED_ORIGINSjika browser memanggil API secara langsung; CORS wildcard tidak memberikan izin operasi tulis dari browser atau akses/ws. Konfigurasikan origin tertentu diAPP_TRUSTED_ORIGINSatau daftar izin CORS. Lihat Autentikasi. - Bind ke alamat privat (
APP_HOST=127.0.0.1atau jaringan privat) jika hanya layanan lokal yang memerlukan akses. - Batasi laju percobaan login yang gagal di proxy; GOWA tidak memiliki pembatasan laju bawaan.
Penyimpanan dan pencadangan
- Gunakan PostgreSQL untuk
DB_URIjika Anda menginginkan pencadangan terkelola; penyimpanan chat selalu menggunakan SQLite. - Buat cadangan saat GOWA dihentikan, atau gunakan tool pencadangan online database Anda.
- Simpan cadangan dalam bentuk terenkripsi: database sesi setara dengan akun yang sudah login.
- Jalankan satu instance GOWA per penyimpanan. Dua proses yang berbagi sesi menyebabkan koneksi terputus dan konflik. GOWA tidak mendukung penskalaan horizontal.
Docker
- Gunakan tag versi tertentu alih-alih
latest, dan baca catatan rilis sebelum melakukan upgrade. - Container berjalan sebagai pengguna non-root (UID 20001); pastikan volume yang di-mount dapat ditulis.
- Image menetapkan
TZ=UTC. Jadwal menggunakantimezoneyang Anda berikan, sehingga pengaturan ini tidak memengaruhinya.
Reverse proxy
- Atur
APP_TRUSTED_PROXIESke rentang alamat proxy Anda agar IP klien dibaca dengan benar. - Izinkan upgrade WebSocket pada
/ws. - Naikkan batas body menjadi setidaknya 100 MB (
client_max_body_size 100m;di nginx). - Atur timeout proxy lebih lama dari timeout permintaan GOWA yang sebesar 45 detik.
- Untuk deployment pada subjalur, gunakan
APP_BASE_PATH;/healthtetap berada di root.
Pemantauan
- Liveness:
GET /healthmengembalikan200 OKjika proses dan penyimpanan berjalan. Ini tidak memeriksa WhatsApp. - Konektivitas WhatsApp: periksa
GET /devices/{device_id}/statussecara berkala dan kirim peringatan jikais_logged_inbernilaifalse. - Event: berlangganan webhook dan kirim peringatan jika tidak ada lalu lintas pada nomor yang biasanya aktif.
- Log: kumpulkan stdout container; gunakan
APP_DEBUG=truehanya saat menelusuri masalah.
GET /app/metrics mengembalikan metrik proses, memori, disk, dan perangkat dengan autentikasi, tanpa perlu memilih perangkat. Lihat Metrik server. Kirim peringatan untuk webhook device.logged_out, device.temporary_ban, dan device.reachout_timelock.
Penerima webhook
- Balas dengan
2xxdalam 10 detik; proses pekerjaan secara asinkron. - Hilangkan duplikat berdasarkan perangkat, jenis event, dan pengenal event. ID pesan saja tidak membedakan edit, reaksi, atau status tanda terima berikutnya.
- Setelah 5 percobaan gagal, event dibuang. Gunakan
GET /chatsdanGET /chat/{jid}/messagesuntuk mengambil data yang tertinggal setelah gangguan.
Praktik pengiriman
- Kirim pesan kepada orang yang telah menyetujui atau menghubungi lebih dahulu.
- Atur laju pengiriman dengan jeda dan variasi acak; hindari teks massal yang identik.
- Hentikan pengiriman saat menerima
WA_REACHOUT_TIMELOCK. - Tetap aktifkan
WHATSAPP_ACCOUNT_VALIDATION=trueagar nomor yang tidak terdaftar segera ditolak. - WhatsApp mengizinkan hingga empat perangkat pendamping tertaut per akun, dan memutus tautan perangkat pendamping setelah sekitar 14 hari jika ponsel tetap offline.
