> ## 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，其中显示你的服务器数量和积分余额。

![登录后的 EchoAuth Bothosting 控制面板，显示 0 台服务器和 0.00 积分](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、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)

Store 页面，带有 Redeem code 按钮和 1 积分 = 1 个月的定价。

![已填入许可证代码的 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 内存、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)

从控制面板打开后的服务器列表。

新服务器启动时处于离线状态，文件管理器为空，等待你的代码。

![Console 标签页显示服务器为 offline，并带有 Start、Restart 和 Stop 按钮](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`）。
>
> ![Startup 标签页，显示 Node.js 启动命令以及设置为 Nodejs 26 的 Docker 镜像下拉菜单](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，此时它会在你的服务器目录中查找 `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`。

![Network 标签页，主机名为 bothosting-eu01.echoauth.dev，端口为 25500](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

有两种方式可以从外部访问你的机器人：

| 格式 | 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、内存和运行时间统计。

![控制台显示两行 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)

控制台中实时记录的两次 webhook 投递，下方是资源统计。

在 Python 运行环境上同样可以端到端工作：

![Python 控制台日志显示服务器启动，然后是来自两个不同来源 IP 的两行 Webhook received](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)

Python 机器人记录了通过直接端口和 HTTPS 代理收到的 webhook。

## 管理你的服务器

使用 Console 标签页中的 **Restart** 和 **Stop** 控制正在运行的进程。

### 备份

你的 Bot Container 方案包含 1 个备份名额。打开 **Backups** 并点击 **Create Backup** 为你的文件创建快照。

![Backups 标签页显示当前没有存储备份，并带有 Create Backup 按钮](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 个备份](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`）。再检查路径是否与你的代码期望的一致，这里的拼写错误会从你自己的服务器返回 404，而不是来自 EchoAuth。

> [accordion] 仍然无法解决？
>
> 在侧边栏打开 **Support Ticket**，附上你的服务器名称和你已尝试的操作。

## 常见问题

> [accordion] 我可以运行多少台服务器？
>
> 取决于你的积分余额，每个 Bot Container 花费 1 积分（1 个月），并每月从你的余额中扣费。

> [accordion] 我可以在 Node.js 运行环境中使用 TypeScript 吗？
>
> 可以，将 **Main File** 设为 `.ts` 文件，它会通过 `tsx` 而不是 `node` 运行。

> [accordion] 如果没有依赖项，Python 还需要 requirements.txt 吗？
>
> 不需要，它是可选的。如果存在，其中的包会在每次启动时安装；如果你的机器人只使用标准库，可以不要它。

> [accordion] 如果我的许可证用完了会怎样？
>
> 请在积分归零之前，在 Store 页面兑换新的许可证代码，新增的积分会自动用于你的下一个计费周期。


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