> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# インストール

> Docker、Docker Compose、リリースバイナリ、またはソースからGOWAをインストールし、リバースプロキシの後ろで実行します。

![GOWA展開とアクセス概要](https://mintcdn.com/gowa-docs/xwa06XWUO2vnG9_f/images/GOWA-Deployment-and-Access-Overview.png?fit=max\&auto=format\&n=xwa06XWUO2vnG9_f\&q=85\&s=dc847e074e7578d3cfb8c83f1d756040)

GOWAはバイナリとして出荷されています。REST API、Webhook、ダッシュボード、MCPエンドポイントはすべて`whatsapp rest`で始まります。

## 要件

| 項目 | 必須項目 |
| - | - |
| FFmpeg | メディア変換 (ビデオ, 音声ノート) Dockerイメージに含まれています。 |
| libwebp tools (`cwebp`, `dwebp`, `webpmux`) | アニメーションWebPを含むステッカーはDockerイメージに含まれています。 |
| 1.26+ | ソースからのみビルドします。 |

サポートされているプラットフォーム: 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`

```bash theme={null}
docker volume create gowa_storages
docker volume create gowa_statics

docker run -d --name gowa --restart always \
  -p 3000:3000 \
  -v gowa_storages:/app/storages \
  -v gowa_statics:/app/statics \
  -e APP_BASIC_AUTH=admin:changeme \
  aldinokemal2104/go-whatsapp-web-multidevice:latest
```

* `/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

```yaml docker-compose.yml theme={null}
services:
  gowa:
    image: aldinokemal2104/go-whatsapp-web-multidevice:latest
    container_name: gowa
    restart: always
    ports:
      - "3000:3000"
    environment:
      APP_BASIC_AUTH: admin:changeme
      WHATSAPP_WEBHOOK: https://example.com/wa-hook
      WHATSAPP_WEBHOOK_SECRET: ${WHATSAPP_WEBHOOK_SECRET}
    volumes:
      - gowa_storages:/app/storages
      - gowa_statics:/app/statics

volumes:
  gowa_storages:
  gowa_statics:
```

`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](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest) からアーカイブをダウンロードします。アーカイブ名は `whatsapp_<version>_<os>_<arch>.zip` です。例:

```bash theme={null}
curl -fLO https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/download/v9.9.0/whatsapp_9.9.0_linux_amd64.zip
unzip whatsapp_9.9.0_linux_amd64.zip
chmod +x whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

メディア ツールをホストにインストールします。

```bash theme={null}
# Debian/Ubuntu
sudo apt install ffmpeg webp
# macOS
brew install ffmpeg webp
```

同じリリースの `checksums.txt` に対してダウンロードを確認します。`./whatsapp version` はバージョンを表示します。`./whatsapp --help` は各フラグを一覧表示します。

## ソースから

```bash theme={null}
git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
cd go-whatsapp-web-multidevice/src
cp .env.example .env    # optional
go build -o whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

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

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

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

```bash theme={null}
# Raspberry Pi 2/3/4 (ARMv7)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -tags purego -o whatsapp-armv7
# Raspberry Pi Zero/1 (ARMv6)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -tags purego -o whatsapp-armv6
```

## ストレージ

デフォルトでは、`storages/`の下にあるSQLiteはすべて以下のようになります。

| データ | デフォルト | 設定 |
| - | - | - |
| WhatsAppセッションとキー | `file:storages/whatsapp.db` | `DB_URI` |
| セッションキーキャッシュ (任意、別のDB) | uses `DB_URI` | `DB_KEYS_URI` |
| チャット履歴、デバイスレジストリ、スケジュール | `file:storages/chatstorage.db` | 構成不能です |
| MCP OAuthクライアントとトークン | `file:storages/oauth.db` | `MCP_OAUTH_DB_URI` |

`DB_URI` はPostgreSQLも受け付けます。例えば `postgres://user:pass@host:5432/gowa?sslmode=verify-full` リモートPostgreSQLセッションは、有効なTLSモードが設定されていない場合に証明書の検証にデフォルトを保存します。 明示的なURI、環境、または PostgreSQL サービス TLS 設定が適用されます。[storage configuration](https://gowa-docs.mintlify.site/ja/configuration.md#%E3%82%B9%E3%83%88%E3%83%AC%E3%83%BC%E3%82%B8) を参照してください。

GOWAは、オーナー専用の`0600`権限を持つSQLiteファイルと、`0700`の新しい親ディレクトリを作成します。既存のディレクトリは権限を保持します。 `storages/` (または PostgreSQL プラスの `storages/`)をバックアップし、再構築されたペアリングされたデバイスを保持します。これらのバックアップを資格情報として扱います。

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

`APP_BASE_PATH`のサブパスの下でGOWAを提供し、`APP_TRUSTED_PROXIES`でプロキシの転送ヘッダーを信頼します。

```bash theme={null}
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password \
  --base-path=/gowa --trusted-proxies=10.0.0.0/8
```

```nginx theme={null}
location /gowa/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;     # WebSocket at /gowa/ws
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 100m;                  # largest upload GOWA accepts
}
```

`/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` をバインドします。

## 確認する

```bash theme={null}
curl http://localhost:3000/health                      # OK, no auth needed
curl -u admin:changeme http://localhost:3000/app/info  # server info, no device needed
curl -u admin:changeme http://localhost:3000/devices   # registered devices
```

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

## アップグレード中

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


## Related topics

- [クイックスタート](https://gowa-docs.mintlify.site/ja/quickstart.md)
- [JavaScript](https://gowa-docs.mintlify.site/ja/api-reference/sdks/javascript.md)
- [メディア処理](https://gowa-docs.mintlify.site/ja/examples/media-handling.md)
- [Production Best Practices](https://gowa-docs.mintlify.site/ja/advanced/best-practices.md)
- [APIリファレンス](https://gowa-docs.mintlify.site/ja/api-reference/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.