Ana içeriğe atla
GOWA dağıtımı ve erişimine genel bakış GOWA tek bir çalıştırılabilir dosya olarak sunulur. REST API, webhook’lar, kontrol paneli ve MCP uç noktası, 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-multidevice
  • ghcr.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 gowauser kullanıcısına düşürür (UID 20001, GID 20000).
  • Konteyner saati UTC’dir (TZ=UTC). Günlüklerde yerel zaman damgaları gerekiyorsa TZ değ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şivler whatsapp_<version>_<os>_<arch>.zip biçiminde adlandırılır; örneğin:
Medya araçlarını ana makineye kurun:
İndirdiğiniz dosyayı aynı sürümdeki checksums.txt ile doğrulayın. ./whatsapp version sürümü yazdırır; ./whatsapp --help tüm bayrakları listeler.

Kaynak koddan

macOS üzerinde derlemeden önce ayrıca 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 şey storages/ 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

Depolama başlatıldığında /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.