> ## 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.

# Production Best Practices

> セキュリティ、ストレージ、バックアップ、リバースプロキシ、モニタリング、衛生状態の送信など、GOWAを安全に運用します。

## セキュリティ

* \*\*長いランダムパスワードで`APP_BASIC_AUTH`\*\*を設定します。ループバックでないバインドは、`APP_ALLOW_UNAUTHENTICATED=true` が明示的にチェックを無効にしない限り、資格情報を必要とします。 Loopback プラグインは、ローカル開発の資格情報なしで実行できます。
* **明示的に`WHATSAPP_WEBHOOK_SECRET`を設定してください。** GOWAは再起動時に変更されるランダムなキーを生成します。 生のリクエスト本文で `X-Hub-Signature-256` を確認します。送信する webhook TLS 検証を有効にしてください。
* **TLSをリバースプロキシで終了**します。GOWA自体はプレーンなHTTPを話します。
* **`/statics`を制限します。** `/statics/*`の下にあるQRコードとダウンロードされたメディアは基本認証なしで\*\*提供されます。 メディアが敏感な場合は、プロキシのパスをブロックまたは保護し、定期的に `statics/media` を削除します。
* \*\*Chatwootが有効な場合は、`CHATWOOT_WEBHOOK_SECRET`\*\*なしで`/chatwoot/webhook`を公開しないでください。
* \*\*ブラウザがAPIを直接呼び出す場合は、`APP_CORS_ALLOWED_ORIGINS`\*\*を設定します。ワイルドカードCORSはブラウザの書き込みまたは`/ws`を許可しません。 `APP_TRUSTED_ORIGINS` または CORS 許可リストで特定のオリジンを設定します。 [Authentication](https://gowa-docs.mintlify.site/ja/api-reference/authentication.md) を参照してください。
* ローカルサービスのみがアクセスする必要がある場合、**プライベートにバインド** (`APP_HOST=127.0.0.1` またはプライベートネットワーク)
* プロキシでログイン失敗の頻度を制限してください。GOWA には[レート制限](https://gowa-docs.mintlify.site/ja/advanced/rate-limiting.md)機能が組み込まれていません。

## ストレージとバックアップ

| パス | 内容 | バックアップ？ |
| - | - | - |
| `storages/whatsapp.db` (または `DB_URI`) | WhatsAppセッションとキー | はい。紛失するとすべてのデバイスを再ペアリングすることになります。 |
| `storages/chatstorage.db` | チャット、メッセージ、スケジュール、その他のGOWAの状態 | はい |
| `storages/oauth.db` | MCP OAuthクライアントとトークンハッシュ | OAuth が使用されている場合 |
| `statics/` | QRコード、ダウンロードおよびスケジュールされたメディア | 省略可能 |

* 管理バックアップが必要な場合は、`DB_URI`にPostgreSQLを使用します。チャットストレージは常にSQLiteです。
* GOWAが停止中にバックアップするか、データベースのオンラインバックアップツールを使用します。
* バックアップが暗号化された保存:セッションデータベースはログインしたアカウントと同等です。
* **ストレージあたり1つのGOWAインスタンスを実行します。** セッションを共有する2つのプロセスは切断と競合を引き起こします。GOWAは水平スケーリングをサポートしていません。

## Docker

```bash theme={null}
docker run -d --name gowa --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v gowa-storages:/app/storages \
  -v gowa-statics:/app/statics \
  -e APP_BASIC_AUTH=admin:a-long-random-password \
  -e WHATSAPP_WEBHOOK=https://example.com/wa-hook \
  -e WHATSAPP_WEBHOOK_SECRET=another-long-random-secret \
  aldinokemal2104/go-whatsapp-web-multidevice:v9.9.0 rest
```

* `latest`ではなくバージョンタグをピン留めし、アップグレードする前にリリースノートを読んでください。
* コンテナは、非 root ユーザー (UID 20001) として実行されます。マウントされたボリュームが書き込み可能であることを確認します。
* 画像は`TZ=UTC`を設定します。スケジュールは渡す`timezone`を使用しますので、これには影響しません。

## リバースプロキシ

* `APP_TRUSTED_PROXIES` をプロキシのアドレス範囲に設定すると、クライアントの IP が正しく読み込まれます。
* `/ws`でWebSocketのアップグレードを許可します。
* ボディの制限を少なくとも 100 MB (nginx では `client_max_body_size 100m;` )に上げます。
* GOWAの45秒リクエストタイムアウトの上にプロキシタイムアウトを保持します。
* サブパス展開では、`APP_BASE_PATH` を使用します。`/health` はルートに残ります。

nginx の例については [Installation](https://gowa-docs.mintlify.site/ja/installation.md#%E3%83%AA%E3%83%90%E3%83%BC%E3%82%B9%E3%83%97%E3%83%AD%E3%82%AD%E3%82%B7%E3%81%AE%E8%83%8C%E5%BE%8C%E3%81%AB%E3%81%82%E3%82%8B) を参照してください。

## モニタリング

* **ライブネス** `GET /health` は、プロセスとストアがアップされたときに `200 OK` を返します。WhatsAppはチェックしません。
* **WhatsAppの接続:** `GET /devices/{device_id}/status` をポーリングし、`is_logged_in` が `false` の場合に警告します。
* **イベント:** Webhookを購読し、トラフィックの不足を警告します。
* **ログ:** コンテナの stdout を収集します。トラブルシューティング中のみ、 `APP_DEBUG=true` を使用します。

GOWAは起動時に自動的に再接続し、5分ごとに接続を確認します。端末からログアウトした端末を再度ペアリングする必要があります。

`GET /app/metrics` はデバイスを選択せずに認証されたプロセス、メモリ、ディスク、およびデバイスのメトリックを返します。 [Server metrics](https://gowa-docs.mintlify.site/ja/api-reference/metrics.md)を参照してください。`device.logged_out`, `device.temporary_ban`, そして `device.reachout_timelock` webhookのアラート。

## Webhook受信機

* `2xx`を10秒以内に返します。プロセスは非同期に動作します。
* デバイス、イベントタイプ、およびイベントの識別子によって削除されます。メッセージ ID だけでは、編集、反応、またはそれ以降の受信状態は区別されません。
* 5 回失敗すると、イベントは破棄されます。障害復旧後は、`GET /chats` と `GET /chat/{jid}/messages` を使用して未取得のデータを補完してください。

## 衛生状態を送信中

* 選択または最初に書いた人にメッセージを送信します。
* 遅延とジッタを伴うペースで送信します。同じバルクテキストを避けてください。
* `WA_REACHOUT_TIMELOCK` を停止します。
* `WHATSAPP_ACCOUNT_VALIDATION=true` を保持してください。
* WhatsAppは、アカウントごとに最大4つのリンクされたコンパニオンデバイスを可能にし、電話がオフラインのままであれば約14日後に仲間のリンクを解除します。


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