> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord ボットホスティングセットアップガイド

> 登録、ライセンスの引き換えを行い、EchoAuth Bothosting で Node.js または Python の Discord ボットを稼働させて webhook を受信します。

EchoAuth Bothosting は、[bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev) 上の独立したコンテナで Discord ボットを稼働させます。アカウントとクレジットを管理する課金ダッシュボードと、サーバー自体（コンソール、ファイル、起動設定）を操作する [Pterodactyl](https://pterodactyl.io) ベースのコントロールパネルを備えています。

このガイドでは、アカウントの作成、ライセンスの引き換え、サーバーの作成、ボットのアップロード、webhook の受信という全体の流れを説明します。

## クイックスタート

1. [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register) で[アカウントを作成](#create-account)する
2. Store ページで[ライセンスを引き換え](#redeem-license)てクレジットを追加する
3. [サーバーを作成](#create-server)する：ランタイムを選び、名前を付けて確定する
4. [ボットのファイルをアップロード](#upload-bot-files)し、起動変数を設定する
5. [サーバーを起動して webhook をテスト](#start-server)する

> [!NOTE]
>
> **開始前に、以下をご用意ください：**
>
> * ライセンスコード（ホスティング時間を購入したときのチェックアウトメールに記載）
> * ボットのコード：Node.js の `index.js` または Python の `app.py`。依存関係がある場合は Python の `requirements.txt` も必要です

## アカウントを作成する

[control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register) に移動してアカウントを作成し、ログインします。サーバー数とクレジット残高が表示される Dashboard が開きます。

![サーバー 0 台と 0.00 クレジットを表示する、ログイン直後の EchoAuth Bothosting ダッシュボード](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/01-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44a55bf2156a5be753248292b30a0ffa)

ログイン直後のダッシュボード：サーバー 0 台、クレジット 0。

## ライセンスを引き換える

サイドバーの **Store** を開き、**Redeem code** をクリックしてライセンスコードを入力します。

> [!TIP]
>
> 1 クレジット = ボットコンテナ 1 つの 1 か月分の稼働時間です。コンテナの数に制限はなく、各コンテナに月額を賣うのに十分なクレジットがあればいいだけです。

![1、6、12 か月のライセンスオプションと Redeem code ボタンを表示する Store ページ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/02-store.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d22be1809910deac312b6cc81cc0708f)

Redeem code ボタンと「1 クレジット = 1 か月」の価格を表示する Store ページ。

![ライセンスコードを入力した Redeem voucher code ダイアログ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/03-redeem-filled.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=5e5333a498707f29e30f975978eef72b)

Redeem voucher code ダイアログに入力したライセンスコード。

引き換えると、クレジットはすぐに残高へ加算され、ダッシュボードの Activity Logs に記録されます。

![1.00 クレジットが追加されたことを示す成功メッセージを表示する引き換えダイアログ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/04-redeem-success.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=a79d87f20c1c7ebed2268dbdcbecd925)

引き換えに成功すると、クレジットがすぐに残高へ加算されます。

## サーバーを作成する

**Servers** に移動し、**Create Server** をクリックします。名前を付け、**Language** を **Node.js** または **Python** から選びます。ロケーションとリソースプラン（**Bot Container** プロダクト：0.3 vCPU、256 MB RAM、512 MB ディスク、バックアップ 1 つ、ポート 1 つ、1 クレジット/月）は自動で入力されます。

![名前を入力し、言語として Node.js を選択し、下に Bot Container プランの詳細が並ぶサーバー作成フォーム](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/05-create-server.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d2eca2740ee95cbaf0c73a1282542ab0)

Node.js を選択したサーバー作成フォーム。Bot Container のリソースプランと価格が表示されています。

**Create server** をクリックします。クレジット残高からすぐに課金され、Servers ページに **Active** として表示されます。

![ステータス Active、仕様 Node.js、リソースプラン Bot Container、月 1.00 クレジットの価格を表示するサーバーカード](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/06-server-active.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8efdd67bc293af11210788908d4f7f12)

新しいサーバー。アクティブで、月 1.00 クレジットで課金されます。

## コントロールパネルを見てみる

サーバーカードのレンチアイコンをクリックすると、[controlpanel.echoauth.dev](https://controlpanel.echoauth.dev) のコントロールパネルでサーバーが開きます。パネルには **Console**、**Files**、**Databases**、**Schedules**、**Users**、**Backups**、**Network**、**Startup**、**Settings**、**Activity** の各タブがあります。

![新しく作成したサーバーを一覧表示する Pterodactyl パネルのダッシュボード](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/07-panel-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=338631775f65f91731e5077d1d39bd43)

ダッシュボードから開いた直後のコントロールパネルのサーバー一覧。

新しいサーバーはオフラインで始まり、ファイルマネージャーは空で、あなたのコードを待っています。

![サーバーが offline と表示され、Start、Restart、Stop ボタンがある Console タブ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/08-console-offline.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=065bea5d4fd06fd09ed92566554b0b8f)

まだ起動していないサーバーの Console タブ。

![ファイルがない /home/container ディレクトリを表示する空のファイルマネージャー](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/09-files-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=1bb3ee4e94d3e98217f508c56db8fa4d)

作成したばかりのサーバーのファイルマネージャー。

## ボットのファイルをアップロードする

まず **Startup** タブを開き、ランタイムが何を期待しているかを確認します。

> [tab] Node.js
>
> 起動コマンドは `/home/container` から `${MAIN_FILE}` を実行します。**Main File** 変数のデフォルトは **`index.js`** です。エントリーファイルの名前が異なる場合は、この変数を合わせて更新してください（`.js` または `.ts` を指定できます）。
>
> ![Node.js の起動コマンドと、Nodejs 26 に設定された Docker イメージのドロップダウンを表示する Startup タブ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/10-startup-command.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44f941a8fa4f4797b6d95348d78b4af3)
>
> Node.js の起動コマンドと Docker イメージのセレクター。
>
> ![デフォルト値が index.js の Main File 起動変数](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/11-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=373d4355cf41af1cf989e5cc5e1f1d8b)
>
> Main File 変数。デフォルトは index.js です。
>
> Node.js ランタイムには独立した HTTP/HTTPS の切り替えはありません。どちらで待ち受けるかはあなたのコードが決めます。

> [tab] Python
>
> 起動コマンドは常に `/home/container` から **`app.py`** を実行します。エントリーファイルはちょうどその名前にしてください（"App Py File" 変数は説明用であり、実際のコマンドには置換されません）。
>
> ![デフォルト値が app.py の App Py File 起動変数](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/19-python-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=0a2a66543153c5bf520179357ef7d1a5)
>
> Python の App Py File 変数。app.py のままにしてください。
>
> Python ランタイムには **Use HTTPS** スイッチもあります：`0` = HTTP（デフォルト）、`1` = HTTPS で、HTTPS の場合はサーバーディレクトリ内の `cert.pem` と `key.pem` を探し、見つからない場合は自己署名証明書にフォールバックします。
>
> ![トグルがオフの Use HTTPS 起動変数。説明は 0 = HTTP（デフォルト）、1 = HTTPS](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/20-python-use-https.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=eb21f9df848c94c86d160a8158528de1)
>
> Use HTTPS 変数。Python ランタイムでのみ利用できます。
>
> > [!WARNING]
> >
> > 公開の HTTPS webhook プロキシ（後述）は、ボットが通常の HTTP で待ち受けていることを前提としています。TLS を自分で終端し、ポートに直接接続する場合を除いて、**Use HTTPS** は `0` のままにしてください。
>
> ボットに必要なパッケージは **`requirements.txt`** に記載してください。起動時に自動的にインストールされます。

**Files** を開き、**New File**（または **Upload** でパソコンからファイルを送信）をクリックして、コードを追加します。

![サンプルの webhook サーバーコードを貼り付けた新規ファイルエディター](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/12-new-file-editor.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=202c32cf6ecd7d4021aa46cd952ba328)

パネルのファイルエディターで直接ボットコードを記述します。

> [tab] Node.js
>
> ![/home/container の index.js を表示するファイルマネージャー](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/13-files-index-js.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=ed83b61d895d03949133422c43be0ce0)
>
> index.js をアップロード済みで、実行の準備ができました。

> [tab] Python
>
> ![/home/container の app.py と requirements.txt を表示するファイルマネージャー](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/21-python-files.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8fb281d9be6156356abed7fcb9b1c0c6)
>
> app.py と requirements.txt をアップロード済みで、実行の準備ができました。

## サーバーを起動する

**Console** に移動し、**Start** をクリックします。パネルが Docker イメージを取得し、起動コマンドを実行して、出力をリアルタイムで表示します。

![起動スクリプトの実行と、その後の Bot webhook server listening on port 25500 を表示するコンソール](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/14-console-running.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=f118d50404f795183ec1dd8b0b1ef499)

Node.js サーバーを起動した直後のコンソール出力。ボットが待ち受け中であることをログに出しています。

## サーバーのアドレスとポートを確認する

**Network** タブを開きます。サーバーの公開アドレスは `<hostname>:<port>` です（例：`bothosting-eu01.echoauth.dev:25500`）。使用できるポートは `25500`〜`25650` の範囲です。

![ホスト名 bothosting-eu01.echoauth.dev とポート 25500 を表示する Network タブ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/15-network-tab.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=72e0554fadab4528c1cbd9a90b694380)

サーバーのホスト名と割り当てられたポートを表示する Network タブ。

## webhook を受信する

外部からボットに到達する方法は 2 つあります：

| 形式 | URL | 補足 |
| - | - | - |
| 直接 HTTP | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | コンテナのポートに直接到達します。 |
| HTTPS プロキシ | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | TLS を代わりに終端します。ボットが HTTP モード（`Use HTTPS = 0`）であることが必要です。 |

```bash Direct HTTP theme={null}
curl -X POST http://bothosting-eu01.echoauth.dev:25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

```bash HTTPS proxy theme={null}
curl -X POST https://bothosting-eu01.echoauth.dev/hook/25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

どちらも、上記のサンプルボットから同じレスポンスが返ります：

```json theme={null}
{"status": "ok", "received": true}
```

……そしてどちらの呼び出しも、サーバーの CPU、メモリ、稼働時間の統計とともに、コンソールにリアルタイムで表示されます。

![2 行の Webhook received ログと、Address、Uptime、CPU Load、Memory の統計タイルを表示するコンソール](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/16-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9da134cabf2ca3125e723ba7374ebc3b)

コンソールにリアルタイムで記録された 2 件の webhook 配信。下にリソース統計があります。

Python ランタイムでも、同じことがエンドツーエンドで動作します：

![サーバーの起動と、異なる 2 つの送信元 IP からの Webhook received 2 行を示す Python コンソールログ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/22-python-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=59e609ce210b24b4f1811e9e4300c632)

直接ポートと HTTPS プロキシの両方で受信した webhook をログに出す Python ボット。

## サーバーを管理する

Console タブの **Restart** と **Stop** で、実行中のプロセスを制御します。

### バックアップ

Bot Container プランには、バックアップ枠が 1 つ含まれます。**Backups** を開いて **Create Backup** をクリックすると、ファイルのスナップショットを取得できます。

![保存済みのバックアップがないことと、Create Backup ボタンを表示する Backups タブ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/17-backups-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9770bee3f420389ffac1676a6999477e)

まだバックアップがありません：新しいサーバーの Backups タブ。

![数秒前に作成されたバックアップ 1 件、1/1 使用済みを表示するバックアップ一覧](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/18-backup-created.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=7ccf5835b8ca402d763fac7997c4ffbe)

最初のバックアップを作成し、利用できる状態になりました。

### ライセンスを更新する

[ライセンスを引き換える](#redeem-license)と同じ方法で、別のライセンスコードを購入または引き換えます。追加したクレジットは、サーバーの次の月次課金サイクルを自動的にカバーします。

## トラブルシューティング

> [accordion] サーバーが起動しない
>
> **Startup** タブを確認してください：Node.js では、**Main File** 変数がアップロードしたファイル名と完全に一致している必要があり、Python ではエントリーファイルの名前が `app.py` でなければなりません。ファイルがない、または名前が間違っているのが最もよくある原因です。

> [accordion] ポートに到達できない
>
> 自分で選んだポートではなく、**Network** タブに表示されている正確なホスト名とポートを使ってください。割り当てられたポート（`25500`〜`25650` の範囲）だけがコンテナにルーティングされます。

> [accordion] webhook が届かない
>
> ボットのモードに合った形式を使っているか確認してください：HTTPS プロキシ（`/hook/<port>/<path>`）は、ボットが通常の HTTP で待ち受けている場合（Python では `Use HTTPS = 0`）にのみ動作します。パスがコードの想定と一致しているかも再確認してください。ここのタイプミスは、EchoAuth ではなくあなた自身のサーバーから 404 を返します。

> [accordion] まだ解決しない？
>
> サイドバーの **Support Ticket** を開き、サーバー名とこれまでに試したことを記入してください。

## FAQ

> [accordion] サーバーはいくつまで稼働できますか？
>
> クレジット残高で賄えるだけです。各 Bot Container は 1 クレジット（1 か月）を消費し、毎月残高から課金されます。

> [accordion] Node.js ランタイムで TypeScript を使えますか？
>
> はい。**Main File** を `.ts` ファイルに設定すると、`node` ではなく `tsx` で実行されます。

> [accordion] 依存関係がない場合、Python で requirements.txt は必要ですか？
>
> いいえ、任意です。ある場合は、起動のたびにパッケージがインストールされます。ボットが標準ライブラリのみを使う場合は、省略できます。

> [accordion] ライセンスが切れたらどうなりますか？
>
> クレジットがゼロになる前に、Store ページで新しいライセンスコードを引き換えてください。追加したクレジットは、次の課金サイクルに自動的に適用されます。


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