セキュリティ
- **長いランダムパスワードで
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 を参照してください。 - ローカルサービスのみがアクセスする必要がある場合、プライベートにバインド (
APP_HOST=127.0.0.1またはプライベートネットワーク) - プロキシでログイン失敗の頻度を制限してください。GOWA にはレート制限機能が組み込まれていません。
ストレージとバックアップ
- 管理バックアップが必要な場合は、
DB_URIにPostgreSQLを使用します。チャットストレージは常にSQLiteです。 - GOWAが停止中にバックアップするか、データベースのオンラインバックアップツールを使用します。
- バックアップが暗号化された保存:セッションデータベースはログインしたアカウントと同等です。
- ストレージあたり1つのGOWAインスタンスを実行します。 セッションを共有する2つのプロセスは切断と競合を引き起こします。GOWAは水平スケーリングをサポートしていません。
Docker
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はルートに残ります。
モニタリング
- ライブネス
GET /healthは、プロセスとストアがアップされたときに200 OKを返します。WhatsAppはチェックしません。 - WhatsAppの接続:
GET /devices/{device_id}/statusをポーリングし、is_logged_inがfalseの場合に警告します。 - イベント: Webhookを購読し、トラフィックの不足を警告します。
- ログ: コンテナの stdout を収集します。トラブルシューティング中のみ、
APP_DEBUG=trueを使用します。
GET /app/metrics はデバイスを選択せずに認証されたプロセス、メモリ、ディスク、およびデバイスのメトリックを返します。 Server metricsを参照してください。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日後に仲間のリンクを解除します。
