
whatsapp rest ile birlikte başlar.
Gereksinimler
Desteklenen platformlar: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL önerilir).
Docker
İmajlar Docker Hub ve GHCR üzerinde yayımlanır:aldinokemal2104/go-whatsapp-web-multideviceghcr.io/aldinokemal/go-whatsapp-web-multidevice
/app/storages, SQLite veritabanlarını (oturumlar, sohbet geçmişi, zamanlamalar, OAuth) barındırır. Kaybedilmesi tüm cihazların eşleştirmesini kaldırır./app/statics, QR görsellerini, yüklemeleri ve indirilen medyayı barındırır.- Varsayılan komut
restşeklindedir. Bayrakları bundan sonra iletin; örneğin... go-whatsapp-web-multidevice rest --autoreply="Away". - Giriş noktası, birim sahipliğini düzeltir ve yetkileri
gowauserkullanıcısına düşürür (UID 20001, GID 20000). - Konteyner saati UTC’dir (
TZ=UTC). Günlüklerde yerel zaman damgaları gerekiyorsaTZdeğerini değiştirin.
Docker Compose
docker-compose.yml
openssl rand -hex 32 ile kalıcı bir webhook anahtarı oluşturun ve WHATSAPP_WEBHOOK_SECRET değerini bu örneği başlatmadan önce kabuğunuzda veya Compose .env dosyasında ayarlayın.
Deponun kendi docker-compose.yml dosyası, imajı docker/golang.Dockerfile üzerinden derler ve src/.env dosyasını okur. Yerel olarak derlemek istediğinizde bunu kullanın: cp src/.env.example src/.env && docker compose up -d --build.
Sürümün çalıştırılabilir dosyası
GitHub Releases üzerinden bir arşiv indirin. Arşivlerwhatsapp_<version>_<os>_<arch>.zip biçiminde adlandırılır; örneğin:
checksums.txt ile doğrulayın. ./whatsapp version sürümü yazdırır; ./whatsapp --help tüm bayrakları listeler.
Kaynak koddan
export CGO_CFLAGS_ALLOW="-Xpreprocessor" çalıştırın.
C araç zinciri olmadan ARM
purego derleme etiketi, tamamen Go ile yazılmış bir SQLite sürücüsü seçer; böylece CGO devre dışıyken çapraz derleme yapabilirsiniz:
Depolama
Varsayılan olarak her şeystorages/ altında SQLite veritabanlarında tutulur:
DB_URI, PostgreSQL’i de kabul eder; örneğin postgres://user:pass@host:5432/gowa?sslmode=verify-full. Etkin bir TLS modu ayarlanmadığında uzak PostgreSQL oturum depolarında varsayılan olarak sertifika doğrulaması kullanılır. Açıkça belirtilen URI, ortam veya PostgreSQL hizmeti TLS ayarları geçerli olmaya devam eder. Depolama yapılandırmasına bakın.
GOWA, SQLite dosyalarını yalnızca sahibine erişim veren 0600 izinleriyle, yeni üst dizinleri ise 0700 izinleriyle oluşturur. Mevcut dizinler izinlerini korur. Yeniden derlemeler arasında eşleştirilmiş cihazları korumak için storages/ dizinini (veya PostgreSQL ile birlikte storages/ dizinini) yedekleyin. Bu yedekleri kimlik bilgileri gibi koruyun.
Ters vekil arkasında
GOWA’yıAPP_BASE_PATH ile bir alt yolda sunun ve APP_TRUSTED_PROXIES ile vekilin ilettiği başlıklara güvenin:
/health, temel yoldan bağımsız olarak yoklamaların çalışması için kökte kalır (/health olarak; /gowa/health olarak değil).
Tarayıcı kaynak korumasının genel erişime açık ana makineyi bilmesi gerekir. Yukarıdaki gibi Host başlığını koruyun veya güvenilen bir vekilden X-Forwarded-Host gönderin. Ayrı barındırılan bir kontrol panelinin tam kaynağı APP_TRUSTED_ORIGINS veya APP_CORS_ALLOWED_ORIGINS içinde tanımlanmalıdır. Joker karakter, durum değişikliklerine veya WebSocket bağlantılarına izin vermez. file:// sayfalarının güvenilmeyen null kaynağı olduğundan kontrol panelini HTTP veya HTTPS üzerinden sunun.
Varsayılan dinleyici, eksiksiz Basic Auth kimlik bilgileri olmadan başlamayı reddeder. APP_ALLOW_UNAUTHENTICATED=true ayarını yalnızca vekil çağrı yapanların kimliğini doğruluyorsa ve istemciler vekili atlayamıyorsa etkinleştirin. Kimlik doğrulamasız yerel geliştirme için APP_HOST=127.0.0.1 adresine bağlayın.
Doğrulama
/health, OK döndürür. Herhangi bir WhatsApp hesabının bağlı olup olmadığını bildirmez; bunun için GET /devices/{device_id}/status kullanın.
Yükseltme
storages/ dizinini yedekleyin, yeni imajı veya çalıştırılabilir dosyayı indirin ve yeniden başlatın. Önce uyumluluğu bozan değişiklikler için sürüm notlarını okuyun. Öne çıkanlar: v6, rest alt komutunu zorunlu kıldı; v7, çalıştırılabilir dosyaları GoReleaser arşivlerine taşıdı; v8, çoklu cihaz desteği ekledi (birden fazla cihaz olduğunda cihaz kapsamlı çağrılar X-Device-Id gerektirir); bağımsız whatsapp mcp modu (:8080/sse) ise REST sunucusundaki /mcp uç noktasıyla değiştirildi.