メインコンテンツへスキップ

セキュリティ

  • **長いランダムパスワードで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 はルートに残ります。
nginx の例については Installation を参照してください。

モニタリング

  • ライブネス 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を参照してください。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日後に仲間のリンクを解除します。