Discord bot をホストする

Lizard (lizard.build) で Discord bot をホストするには、バックグラウンド worker として実行します。gateway bot は Discord へのアウトバウンド接続を開くだけで HTTP を提供しないため、lizard up --port 0（containerPort=0）でデプロイし、bot トークンごとにレプリカを 1 つに保ってください。Lizard は package.json から Node.js の bot を検出し、npm run start で起動します。Python の bot には Procfile の web: 行が必要です。

テスト状況: サンプルの bot は discord.js 14.27.0 を使ってローカルで動作し、偽のトークンを渡すと TokenInvalid で停止します。ビルドプランは、Lizard が使う lizardpack で確認しました。このガイドを Lizard から実際の Discord に対して実行したことはまだありません。運用に使う前に、テストメッセージを送ってログを確認してください。

始める前に

• bot トークン。 Discord Developer Portal でアプリケーションを作成し、Bot を開いて Reset Token を押します。トークンは非公開にしてください。トークンを持つ人は誰でも bot を操作できます。
• Message Content intent。 この例は !ping を読み取るため、Bot → Privileged Gateway Intents で Message Content Intent をオンにします。スラッシュコマンドにだけ応答する bot には不要です。
• サーバーに追加した bot。 OAuth2 → URL Generator で bot スコープと、View Channels、Send Messages、Read Message History の権限にチェックを入れ、生成された URL を開いてサーバーを選びます。
• Lizard CLI とプラン。 CLI をインストールし、lizard login を実行します。サービスは Lizard Pro またはその 7 日間トライアル（カードが必要）で動作します。料金を参照してください。

bot を書く

2 つのファイルを入れるフォルダーを作成します。

package.json:

{
  "name": "discord-bot",
  "private": true,
  "type": "module",
  "scripts": {
    "start": "node bot.js"
  },
  "dependencies": {
    "discord.js": "^14.27.0"
  }
}

bot.js:

import { Client, Events, GatewayIntentBits } from "discord.js";
 
const token = process.env.DISCORD_TOKEN;
if (!token) {
  console.error("DISCORD_TOKEN is not set");
  process.exit(1);
}
 
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});
 
client.once(Events.ClientReady, (ready) => {
  console.log(`Logged in as ${ready.user.tag}`);
});
 
client.on(Events.MessageCreate, async (message) => {
  if (message.author.bot) return;
  if (message.content === "!ping") {
    await message.reply("pong");
  }
});
 
client.login(token);

npm install を実行して package-lock.json を作成し、lock ファイルを package.json と同じ場所に置いてください。lock ファイルがあると、Lizard は npm ci でインストールします。node_modules と .env を書いた .gitignore も追加します。

手元のコンピューターで bot を試すには、トークンをファイルに保存せずに貼り付けてから起動します:

read -rs DISCORD_TOKEN && export DISCORD_TOKEN
npm start

bot が閲覧できるチャンネルで !ping と入力すると、pong と返ってきます。デプロイの前にローカルのコピーを停止してください。2 つのコピーが動いていると、どちらもすべてのメッセージに応答します。

worker としてデプロイする

bot のフォルダーから実行します:

lizard init --name discord-bot
lizard add --service bot
read -rs DISCORD_TOKEN
lizard secrets set DISCORD_TOKEN="$DISCORD_TOKEN" --service bot
lizard up --service bot --port 0

• lizard add --service bot は空のサービスを作成し、続く lizard up --service bot がそこにコードを入れます。
• lizard secrets set はトークンを bot サービスだけに保存します。変数とシークレットを参照してください。
• --port 0 は worker mode を有効にします。Lizard は PORT を設定せず、ポートのヘルスチェックを実行せず、HTTP ルートも追加しません。サービスに onlizard.com ドメインが表示されることはありますが、そこでは何も応答しません。

git リポジトリ内では、lizard up は .gitignore に書かれたものをスキップします。git の外では .env ファイルもアップロードするため、このフォルダー内のファイルにトークンを置かないか、先に git init を実行してください。ローカルコードからデプロイするを参照してください。

git push to deploy を使う場合は、代わりにフォルダーを GitHub に push して リポジトリを接続 し、サービスを worker mode に切り替えます:

lizard port 0 --service bot
lizard redeploy --service bot

トークンごとにレプリカは 1 つ

各レプリカは同じトークンでそれぞれ gateway セッションを開くため、どのレプリカもすべてのメッセージに応答します。bot サービスはレプリカ 1 つのままにしてください。worker の新しいバージョンをデプロイするとき、Lizard は新しいプロセスを起動する前に古いプロセスを停止します。そのため、返信が重複するのではなく、短時間停止します。2,500 を超えるサーバーに参加している bot は Discord の sharding を使う必要があります。これはコードの変更であり、同じプロセスのレプリカを増やすことではありません。

Python の bot

discord.py を使う場合は、requirements.txt に記載し、Procfile を追加します:

web: python bot.py

lizardpack は worker であっても Procfile の web: 行だけを読み取り、worker: 行は無視します。Procfile がない場合は python main.py を実行するため、bot が main.py にあれば Procfile は不要です。同じコマンドと --port 0 でデプロイしてください。Python のバージョンを選ぶには、ランタイムバージョンを参照してください。

Managed Postgres にデータを保存する

コンテナ内に書き込んだファイルは、次のデプロイで失われます。設定、スコア、キューは Managed Postgres に保存してください:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service bot

シングルクォートで囲むと、シェルは ${{…}} を解釈しません。Lizard は bot の起動時に 参照 を解決し、変数の変更によって bot は再起動します。pg などのクライアントで process.env.DATABASE_URL を読み取って接続します。ハンドラーは 2 回実行されても安全なようにしてください。再起動によって、処理中だった作業がもう一度実行されることがあります。

動作を確認する

lizard port --service bot
lizard logs --service bot --tail 50
lizard ps

lizard port は worker mode と表示します。ログには Logged in as と bot の名前が表示されます。次に、サーバーで !ping と入力し、pong が 1 回だけ返ることを確認します。実行中と表示されている worker でも、この確認は必要です。Discord に拒否されていても、プロセスは動き続けることがあります。

よくある問題

Interactions Endpoint URL 経由でスラッシュコマンドにだけ応答する bot は、worker ではなく HTTP サービスです。実際のポートでデプロイし、その HTTPS URL を Discord に設定してください。

関連項目

• バックグラウンドワーカー
• Telegram bot を実行する
• Node.js アプリをデプロイする
• ログ
• 制限
• discord.js ガイド

更新日 2026年10月12日