
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-multideviceghcr.io/aldinokemal/go-whatsapp-web-multidevice
/app/storagesmenyimpan basis data SQLite (sesi, riwayat chat, jadwal, OAuth). Kehilangannya akan memutus penautan semua perangkat./app/staticsmenyimpan 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). UbahTZjika Anda memerlukan stempel waktu lokal pada log.
Docker Compose
docker-compose.yml
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 namawhatsapp_<version>_<os>_<arch>.zip, misalnya:
checksums.txt dari rilis yang sama. ./whatsapp version menampilkan versi; ./whatsapp --help mencantumkan semua flag.
Dari kode sumber
export CGO_CFLAGS_ALLOW="-Xpreprocessor" sebelum membangun.
ARM tanpa toolchain C
Tag buildpurego memilih driver SQLite Go murni, sehingga Anda dapat melakukan kompilasi silang dengan CGO dinonaktifkan:
Penyimpanan
Secara bawaan, semua data disimpan dalam SQLite distorages/:
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 denganAPP_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
Cadangkanstorages/, 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.