Langsung ke konten utama

Keamanan

  • Atur APP_BASIC_AUTH dengan kata sandi acak yang panjang. Bind ke alamat non-loopback memerlukan kredensial, kecuali APP_ALLOW_UNAUTHENTICATED=true secara eksplisit menonaktifkan pemeriksaan tersebut. Loopback dapat berjalan tanpa kredensial untuk pengembangan lokal.
  • Atur WHATSAPP_WEBHOOK_SECRET secara eksplisit. Tanpanya, GOWA membuat kunci acak yang berubah setiap kali dimulai ulang. Verifikasi X-Hub-Signature-256 terhadap 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 bersihkan statics/media secara rutin.
  • Jangan mengekspos /chatwoot/webhook tanpa CHATWOOT_WEBHOOK_SECRET saat Chatwoot diaktifkan.
  • Atur APP_CORS_ALLOWED_ORIGINS jika browser memanggil API secara langsung; CORS wildcard tidak memberikan izin operasi tulis dari browser atau akses /ws. Konfigurasikan origin tertentu di APP_TRUSTED_ORIGINS atau daftar izin CORS. Lihat Autentikasi.
  • Bind ke alamat privat (APP_HOST=127.0.0.1 atau 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_URI jika 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 menggunakan timezone yang Anda berikan, sehingga pengaturan ini tidak memengaruhinya.

Reverse proxy

  • Atur APP_TRUSTED_PROXIES ke 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; /health tetap berada di root.
Lihat Instalasi untuk contoh nginx.

Pemantauan

  • Liveness: GET /health mengembalikan 200 OK jika proses dan penyimpanan berjalan. Ini tidak memeriksa WhatsApp.
  • Konektivitas WhatsApp: periksa GET /devices/{device_id}/status secara berkala dan kirim peringatan jika is_logged_in bernilai false.
  • Event: berlangganan webhook dan kirim peringatan jika tidak ada lalu lintas pada nomor yang biasanya aktif.
  • Log: kumpulkan stdout container; gunakan APP_DEBUG=true hanya saat menelusuri masalah.
GOWA tersambung kembali secara otomatis saat dimulai dan memeriksa koneksi setiap 5 menit. Perangkat yang dikeluarkan dari akun melalui ponsel harus ditautkan ulang. 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 2xx dalam 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 /chats dan GET /chat/{jid}/messages untuk 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=true agar 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.