メインコンテンツへスキップ
GOWA展開とアクセス概要 GOWAはバイナリとして出荷されています。REST API、Webhook、ダッシュボード、MCPエンドポイントはすべてwhatsapp restで始まります。

要件

サポートされているプラットフォーム: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSLが推奨).

Docker

イメージは Docker Hub と GHCR に公開されます。
  • aldinokemal2104/go-whatsapp-web-multidevice
  • ghcr.io/aldinokemal/go-whatsapp-web-multidevice
  • /app/storagesはSQLiteデータベース(セッション、チャット履歴、スケジュール、OAuth)を保持しています。紛失するとデバイスごとにペアリングが解除されます。
  • /app/staticsはQR画像、アップロード、ダウンロードしたメディアを保持します。
  • デフォルトのコマンドはrestです。フラグの後に... go-whatsapp-web-multidevice rest --autoreply="Away"などを渡します。
  • エントリポイントはボリュームの所有権を修正し、gowauser (UID 20001、GID 20000)の権限を削除します。
  • コンテナ時間はUTC(TZ=UTC)です。ローカルログタイムスタンプが必要な場合は、TZを上書きします。

Docker Compose

docker-compose.yml
openssl rand -hex 32で安定したWebフックキーを生成し、シェルにWHATSAPP_WEBHOOK_SECRETを設定するか、この例を開始する前に.envを作成します。 リポジトリの docker-compose.yml は、docker/golang.Dockerfile からイメージをビルドし、src/.env ローカルでビルドしたい場合は、 cp src/.env.example src/.env && docker compose up -d --build を使用します。

バイナリをリリース

GitHub Releases からアーカイブをダウンロードします。アーカイブ名は whatsapp_<version>_<os>_<arch>.zip です。例:
メディア ツールをホストにインストールします。
同じリリースの checksums.txt に対してダウンロードを確認します。./whatsapp version はバージョンを表示します。./whatsapp --help は各フラグを一覧表示します。

ソースから

macOS では、ビルドする前に export CGO_CFLAGS_ALLOW="-Xpreprocessor" もあります。

C ツールチェーンのないARM

purego ビルドタグは純粋な SQLite ドライバーを選択するため、CGO を無効にしてクロスコンパイルすることができます。

ストレージ

デフォルトでは、storages/の下にあるSQLiteはすべて以下のようになります。 DB_URI はPostgreSQLも受け付けます。例えば postgres://user:pass@host:5432/gowa?sslmode=verify-full リモートPostgreSQLセッションは、有効なTLSモードが設定されていない場合に証明書の検証にデフォルトを保存します。 明示的なURI、環境、または PostgreSQL サービス TLS 設定が適用されます。storage configuration を参照してください。 GOWAは、オーナー専用の0600権限を持つSQLiteファイルと、0700の新しい親ディレクトリを作成します。既存のディレクトリは権限を保持します。 storages/ (または PostgreSQL プラスの storages/)をバックアップし、再構築されたペアリングされたデバイスを保持します。これらのバックアップを資格情報として扱います。

リバースプロキシの背後にある

APP_BASE_PATHのサブパスの下でGOWAを提供し、APP_TRUSTED_PROXIESでプロキシの転送ヘッダーを信頼します。
/health はルート(/health、/gowa/healthではなく)にとどまりますので、基本パスに関係なくプローブは動作します。 ブラウザーのオリジンガードには公開ホストが必要です。上記のように Host を保持するか、信頼できるプロキシから X-Forwarded-Host を送信してください。 別々にホストされているダッシュボードは、 APP_TRUSTED_ORIGINS または APP_CORS_ALLOWED_ORIGINS で正確な起点を必要とします。 ワイルドカードは変更またはWebSocketsを許可しません。file://ページに信頼できないnullオリジンがあるため、HTTPまたはHTTPSを介してダッシュボードを提供します。 デフォルトのリスナーは完全な Basic Auth 資格情報なしでの開始を拒否します。 プロキシが発信者とクライアントをバイパスできない場合、APP_ALLOW_UNAUTHENTICATED=true を有効にします。認証なしでローカル開発を行う場合は、APP_HOST=127.0.0.1 をバインドします。

確認する

/health はストレージが初期化されるとOK を返します。WhatsAppアカウントが接続されているかどうかは報告されません。GET /devices/{device_id}/status を使用してください。

アップグレード中

storages/をバックアップし、新しいイメージまたはバイナリを取り出し、再起動します。最初に変更を破棄するには、release notesを読んでください。 注目すべき: v6 は rest サブコマンドを必須にしました。v7 はバイナリを GoReleaser アーカイブに移動しました。 v8がマルチデバイスを追加しました (複数のデバイスが存在する場合、デバイススコープの呼び出しには X-Device-Id が必要です) スタンドアロンの whatsapp mcp モード (:8080/sse) は REST サーバーの /mcp エンドポイントに置き換えられました。