Zeabur で Convoy をデプロイ

Convoy は、高速・安全なオープンソースの Webhook ゲートウェイです。送信 Webhook（リトライ、レート制限、署名、配信ログ）と受信 Webhook（HMAC 検証、ソース管理、リプレイ）を管理します。このテンプレートは、Convoy をワンクリックで Zeabur 上に自前ホスティングし、必要な 2 つの依存サービス（永続化用の PostgreSQL とキュー用の Redis）を同時にデプロイします。

Convoy は Frain Technologies が開発し、Elastic License 2.0 で提供されています。このテンプレートはデプロイのレシピであり、あなた自身のインスタンスをホストし、データと API キーは完全にあなたの管理下にあります。

このテンプレートで作成されるもの

1 つのプロジェクトに 3 つのサービス：

サービス	イメージ	役割
`convoy`	`getconvoy/convoy:latest`	API、ダッシュボード、Webhook 配信ワーカー（単一バイナリ）。初回起動時に DB マイグレーションを自動実行。
`postgresql`	`postgres:18`	プロジェクト、エンドポイント、イベント、配信、試行履歴を保存
`redis`	`redis/redis-stack-server:latest`	ジョブキュー、レート制限カウンター、キャッシュ

Convoy は Zeabur のプライベートネットワーク経由で PostgreSQL と Redis に自動接続されます。手動設定は不要です。

デプロイ手順

このテンプレートの Deploy をクリックします。
Convoy ドメイン のプレフィックスを選びます（テスト用途ならデフォルトで OK。後から Zeabur 管理画面でカスタムドメインも設定可能）。
3 つのサービスが起動するまで約 30 秒待ちます。Convoy は初回起動時に自動で DB マイグレーションを実行します。
Zeabur が convoy サービスに表示する URL を開きます。

初回ログイン

初回起動時、Convoy はデフォルトのスーパーユーザーを作成します。convoy サービスのランタイムログに次のように出力されます：

Superuser created successfully:
  Username: [email protected]
  Password: default

この情報でログインしたら、すぐに：

自分の組織とユーザーを作成する
デフォルトの [email protected] を削除する
本番トラフィック用の API キーをローテーションする

次のステップ

最初の Webhook 送信：ダッシュボードで Project を作成 → Endpoint を追加 → Event を発行。Convoy が署名・配信し、結果を記録します。
Webhook 受信：Project 下で Source を作成すると、Convoy が https://convoy.zeabur.app/ingest/<id> 形式の URL を発行し、サードパーティに渡せます。
API：詳細は getconvoy.io/docs/api-reference。
セルフホストドキュメント：getconvoy.io/docs。

設定可能な変数

すべての設定は convoy サービスの Variables タブで調整できます。よく使うもの：

変数	説明
`CONVOY_HOST`	Convoy の公開 URL。Zeabur のドメインに既定設定済み。カスタムドメインを使う場合は更新してください。
`CONVOY_SIGNUP_ENABLED`	`true` で UI から新規ユーザー登録を許可。`false` でロックダウン。
`CONVOY_DB_MAX_OPEN_CONN`	PostgreSQL コネクションプール（デフォルト 100）。小規模プランでは下げてください。
`CONVOY_SMTP_*`	パスワードリセットや招待メールの SMTP 設定（任意）。

すべての環境変数：convoy.env.example。

運用

DB バックアップ：Zeabur は PostgreSQL を自動でスナップショットします。postgresql サービスの Backup タブから復元できます。
アップグレード：Convoy の新バージョンは getconvoy/convoy:latest に公開されます。convoy サービスを再起動するだけで新しいイメージを取得し、次回起動時にマイグレーションも自動適用されます。
リソース：軽い負荷（約 10 req/s）なら各サービス 1 vCPU / 1 GB で十分です。配信レイテンシが上がってきたら、まず convoy の CPU を増やしてください。

トラブルシューティング

初回デプロイで 502：Convoy はマイグレーションで約 15 秒かかります。少し待ってから再アクセスしてください。
マイグレーションがリトライ中（retrying in 5s）：PostgreSQL がまだ起動中です。Convoy が自動で最大 1 分ほどリトライします。
失敗した配信が見つからない：PostgreSQL の event_deliveries テーブル、または Convoy UI の Project → Event Deliveries を確認してください。

クレジット

ソース：github.com/frain-dev/convoy（2,800+ ⭐）· Elastic License 2.0
公式サイト：getconvoy.io

Convoy

サービス

postgresql

redis

convoy