BOT DEPLOY

Telegram Bot 的 Zeabur 部署流程。

这页专门记录 Telegram-AI-Bot-Pro 以后怎么部署到 Zeabur,怎么填环境变量,怎么避免 BackOff。

STEPS

标准部署顺序

01

确认 Telegram-AI-Bot-Pro 代码已经推送到 GitHub。

02

确认 package.json 有正确的 start 脚本。

03

确认代码监听 process.env.PORT。

04

在 Zeabur 从 GitHub 创建项目。

05

填写 BOT_TOKEN、AI_PROVIDER、AI_MODEL、Gemini Key 等环境变量。

06

如果使用 SQLite,创建 Volume 并挂载到 /data。

07

先部署最小文本 Bot,确认不会 BackOff。

08

再打开 Gemini 文本和图片能力。

09

最后再接 Gemini Live、语音、文件解析和按钮交互。

ENV

环境变量

BOT_TOKENAI_PROVIDERAI_MODELAI_API_KEYAI_BASE_URLGEMINI_API_KEYGEMINI_MODELGEMINI_LIVE_API_KEYGEMINI_LIVE_MODELDATABASE_FILEPASSWORDPORT

ENV TEMPLATE

推荐模板

AI_PROVIDER=gemini
AI_MODEL=gemini-2.0-flash
DATABASE_FILE=/data/database.sqlite
PORT=8080

# Telegram
BOT_TOKEN=

# Gemini
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.0-flash

# Gemini Live
GEMINI_LIVE_API_KEY=
GEMINI_LIVE_MODEL=gemini-2.5-flash-preview-native-audio-dialog

ORDER

上线顺序

推荐部署顺序:

1. 固定回复 Bot
2. 普通 Gemini 文本
3. 图片理解
4. 文件解析
5. Inline button 交互
6. Gemini Live 语音能力

不要一次性全部打开,否则排错会很麻烦。

DEBUG

失败时先查这里

01

BackOff:先看 Runtime Logs 最后 100 行。

02

端口错误:确认代码使用 process.env.PORT。

03

环境变量缺失:确认 BOT_TOKEN 和模型 Key 已填写。

04

pdf-parse 错误:检查 ESM 导入方式。

05

数据库丢失:确认 DATABASE_FILE 指向 Volume 路径。

06

功能太多导致难排错:先关掉 Live 和文件解析,只保留文本 Bot。