Langsung ke konten utama
Gambaran Umum Deployment dan Akses GOWA GOWA didistribusikan sebagai satu biner. REST API, webhook, dasbor, dan endpoint MCP semuanya dijalankan dengan whatsapp rest.

Persyaratan

Platform yang didukung: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; disarankan menggunakan WSL).

Docker

Image diterbitkan di Docker Hub dan GHCR:
  • aldinokemal2104/go-whatsapp-web-multidevice
  • ghcr.io/aldinokemal/go-whatsapp-web-multidevice
  • /app/storages menyimpan basis data SQLite (sesi, riwayat chat, jadwal, OAuth). Kehilangannya akan memutus penautan semua perangkat.
  • /app/statics menyimpan gambar QR, unggahan, dan media yang diunduh.
  • Perintah bawaannya adalah rest. Berikan flag setelahnya, misalnya ... go-whatsapp-web-multidevice rest --autoreply="Away".
  • Entrypoint memperbaiki kepemilikan volume dan menurunkan hak akses ke gowauser (UID 20001, GID 20000).
  • Waktu kontainer menggunakan UTC (TZ=UTC). Ubah TZ jika Anda memerlukan stempel waktu lokal pada log.

Docker Compose

docker-compose.yml
Buat kunci webhook tetap dengan openssl rand -hex 32 dan tetapkan WHATSAPP_WEBHOOK_SECRET di shell atau .env Compose sebelum menjalankan contoh ini. Berkas docker-compose.yml bawaan repositori membangun image dari docker/golang.Dockerfile dan membaca src/.env. Gunakan jika Anda ingin membangun secara lokal: cp src/.env.example src/.env && docker compose up -d --build.

Biner rilis

Unduh arsip dari GitHub Releases. Arsip diberi nama whatsapp_<version>_<os>_<arch>.zip, misalnya:
Instal alat media pada host:
Verifikasi hasil unduhan dengan checksums.txt dari rilis yang sama. ./whatsapp version menampilkan versi; ./whatsapp --help mencantumkan semua flag.

Dari kode sumber

Di macOS, jalankan juga export CGO_CFLAGS_ALLOW="-Xpreprocessor" sebelum membangun.

ARM tanpa toolchain C

Tag build purego memilih driver SQLite Go murni, sehingga Anda dapat melakukan kompilasi silang dengan CGO dinonaktifkan:

Penyimpanan

Secara bawaan, semua data disimpan dalam SQLite di storages/: DB_URI juga menerima PostgreSQL, misalnya postgres://user:pass@host:5432/gowa?sslmode=verify-full. Penyimpanan sesi PostgreSQL jarak jauh secara bawaan memverifikasi sertifikat jika tidak ada mode TLS efektif yang ditetapkan. Pengaturan TLS eksplisit dari URI, lingkungan, atau layanan PostgreSQL tetap berlaku. Lihat konfigurasi penyimpanan. GOWA membuat berkas SQLite dengan izin 0600 yang hanya mengizinkan pemilik mengaksesnya, dan direktori induk baru dengan izin 0700. Izin direktori yang sudah ada tetap dipertahankan. Cadangkan storages/ (atau PostgreSQL beserta storages/) agar perangkat tetap tertaut setelah pembangunan ulang. Perlakukan cadangan ini sebagai kredensial.

Di belakang reverse proxy

Sajikan GOWA di bawah subpath dengan APP_BASE_PATH, dan percayai header yang diteruskan proxy melalui APP_TRUSTED_PROXIES:
/health tetap berada di root (/health, bukan /gowa/health) agar probe berfungsi terlepas dari base path. Pelindung origin browser memerlukan host publik. Pertahankan Host seperti di atas, atau kirim X-Forwarded-Host dari proxy tepercaya. Dasbor yang dihosting terpisah memerlukan origin persisnya dalam APP_TRUSTED_ORIGINS atau APP_CORS_ALLOWED_ORIGINS. Wildcard tidak memberikan izin untuk mutasi atau WebSocket. Sajikan dasbor melalui HTTP atau HTTPS karena halaman file:// memiliki origin null yang tidak dipercaya. Listener bawaan menolak dijalankan tanpa kredensial Basic Auth yang lengkap. Aktifkan APP_ALLOW_UNAUTHENTICATED=true hanya jika proxy mengautentikasi pemanggil dan klien tidak dapat melewatinya. Untuk pengembangan lokal tanpa autentikasi, gunakan alamat bind APP_HOST=127.0.0.1.

Verifikasi

/health mengembalikan OK setelah penyimpanan diinisialisasi. Endpoint ini tidak melaporkan apakah ada akun WhatsApp yang terhubung; gunakan GET /devices/{device_id}/status untuk memeriksanya.

Memperbarui versi

Cadangkan storages/, ambil image atau biner baru, lalu jalankan ulang. Baca catatan rilis terlebih dahulu untuk mengetahui perubahan yang merusak kompatibilitas. Perubahan penting: v6 mewajibkan subperintah rest, v7 memindahkan biner ke arsip GoReleaser, v8 menambahkan dukungan multi-perangkat (panggilan dalam cakupan perangkat memerlukan X-Device-Id jika ada lebih dari satu perangkat), dan mode mandiri whatsapp mcp (:8080/sse) digantikan oleh endpoint /mcp pada server REST.