如何 7×24 小时托管 Telegram 机器人

简介

要在 Square Cloud 上开发和托管 Telegram 机器人，遵循一套结构化的配置和前置条件流程至关重要。本技术指南将涵盖整个过程，从初始设置到生产环境部署。

前置条件

Square Cloud 账户：通过注册页面使用你的邮箱进行注册。
有效套餐：为你的应用提供专属资源和优化的性能。查看我们可用的套餐，选择最适合你需求的方案。

创建项目

一个 Telegram 账户对于测试你的机器人并与之交互至关重要。如果你还没有账户，请访问 Telegram 官方网站创建你的账户。

在 Telegram 上创建机器人应用

开始上手

访问 Telegram Web 并搜索官方的 BotFather 机器人，它负责在平台上创建和管理机器人。

获取身份验证令牌

与 BotFather 开始一段对话并输入 /start。然后，选择 /newbot 选项来创建一个新机器人。系统会要求你为机器人指定一个名称，确认后，将自动生成所需的身份验证令牌。

关键安全提示：请对你的机器人令牌绝对保密。此令牌授予对机器人的完全控制权。切勿将它写在代码中或放进 ZIP：下面的示例会从 TELEGRAM_BOT_TOKEN 环境变量中读取它。

开发项目

选择哪个库或框架取决于你打算使用的编程语言。下面是一些最受欢迎的选项：

Node.js - grammY
Python - telebot

环境搭建

确认系统中已安装 Node.js。否则，请从 Node.js 官方网站下载。
初始化一个新的 Node.js 项目：

Terminal

npm init -y

安装 grammY 库：

Terminal

npm install grammy

基础实现

创建主文件（index.js），结构如下：

index.js

const { Bot } = require("grammy");

// The token comes from the TELEGRAM_BOT_TOKEN environment variable
const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN);

// Reply to every text message with an echo
bot.on("message:text", async (ctx) => {
  await ctx.reply(`${ctx.me.username} responds: ${ctx.message.text}`);
});

// Long polling: the bot asks Telegram for new messages, so no public URL is needed
bot.start({
  onStart: (botInfo) => console.log(`Bot ${botInfo.username} started successfully!`),
});

环境搭建

确认已安装 Python 和 pip。否则，请从 Python 官方网站下载。
安装 pyTelegramBotAPI 库：

Terminal

pip install pyTelegramBotAPI

基础实现

创建主文件（main.py）：

main.py

import os

import telebot

# The token comes from the TELEGRAM_BOT_TOKEN environment variable
bot = telebot.TeleBot(os.environ["TELEGRAM_BOT_TOKEN"])
bot_name = bot.get_me().username


# Echo every message that isn't a command
@bot.message_handler(func=lambda message: not message.text.startswith("/"))
def echo_handler(message):
    bot.reply_to(message, f"{bot_name} responds: {message.text}")


if __name__ == "__main__":
    print(f"Bot {bot_name} started successfully!")
    # Long polling: no public URL is needed
    bot.infinity_polling()

创建 requirements.txt 文件来管理依赖：

requirements.txt

pyTelegramBotAPI

配置 Square Cloud

在项目根目录、主文件旁边创建 squarecloud.app 文件。它告诉 Square Cloud 如何运行你的机器人：

DISPLAY_NAME=My Telegram Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Telegram Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

MAIN 是 Square Cloud 运行的文件，MEMORY 是机器人的内存（单位 MB）。机器人至少需要 256 MB；512 MB 则留有增长空间。
AUTORESTART=true 会在机器人崩溃时重新启动它。请参阅自动重启的工作方式。
没有 SUBDOMAIN：使用长轮询时，机器人不需要公开 URL。

你的 ZIP 包含主文件、它的依赖文件（package.json 或 requirements.txt）和 squarecloud.app。不要包含 node_modules：Square Cloud 会在部署时安装依赖。所有字段请参阅配置文件参考。

设置机器人令牌

你的代码从 TELEGRAM_BOT_TOKEN 环境变量读取令牌，因此令牌永远不会出现在你的文件中。可以通过以下任一方式设置：

控制面板：在上传页面打开 Advanced configuration，添加名为 TELEGRAM_BOT_TOKEN 的变量，值为你的令牌。对于已部署的机器人，请在应用的 Environment Variables 页面添加它，然后重启机器人。
CLI：上传机器人后（参见部署），立即使用 squarecloud app env set 设置它并重启机器人：

squarecloud app env set TELEGRAM_BOT_TOKEN=your_token_here
squarecloud app restart

机器人在启动时读取环境变量，因此每次修改后都要重启它。管理环境变量的其他方式请参阅环境变量。

如果想先在你的电脑上运行机器人，请在终端中设置该变量：在 macOS 和 Linux 上使用 export TELEGRAM_BOT_TOKEN=your_token_here，在 PowerShell 中使用 $env:TELEGRAM_BOT_TOKEN="your_token_here"。

部署

准备好项目文件后，你现在可以将它们上传到 Square Cloud 并托管你的项目。为此，请创建一个包含所有项目文件的 ZIP 文件。

通过控制面板

访问上传页面

访问上传页面并上传你的项目 zip 文件。

配置你的环境

上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。

部署你的项目

最后，点击 “Deploy” 按钮，即可将项目托管到 Square Cloud。
部署完成后，你可以在控制面板中监控项目的状态和日志。

确认你的应用已上线

首次部署通常在一分钟内完成。在控制面板中，等待你的应用状态显示为运行中，并检查日志中是否有启动错误。
如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。

应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

通过 CLI

要使用此方法，你的项目根目录中需要有一个名为 squarecloud.app 的配置文件。它告诉 Square Cloud 如何运行你的应用。

配置文件指南

了解如何创建定义你应用环境的 squarecloud.app 配置文件。

安装 CLI

安装 Square Cloud CLI。如果你已经安装，运行同一条命令即可更新：

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

运行下面的命令。它会打开你的浏览器：在浏览器中批准登录后，CLI 即可使用。无需复制任何 API 密钥。如需在脚本和 CI 中使用，请参阅 CLI 身份验证。

squarecloud auth login

上传你的项目

在项目文件夹中运行下面的命令。CLI 会将当前文件夹打包为 zip（排除 squarecloud.ignore 中列出的内容）并上传：

squarecloud upload

要上传你自己创建的 zip，请通过 --file 传入：

squarecloud upload --file <path/to/zip>

确认你的应用已上线

首次部署通常在一分钟内完成。直接在终端中检查你的应用状态和日志：

squarecloud app status
squarecloud app logs

如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。

应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

测试机器人

部署成功后，在 Telegram 上找到你的机器人并发送一条测试消息。机器人应该会回显你的消息作为响应，从而确认实现功能正常。

后续步骤

应用无法启动

修复缺少模块、内存错误和其他启动失败问题。

环境变量

管理机器人的令牌和其他密钥。

python-telegram-bot 与 aiohttp

在使用 python-telegram-bot？修复频繁出现的 NetworkError 异常。

联系我们

如果你仍然遇到技术问题，我们的专业支持团队可以为你提供帮助。联系我们，我们很乐意协助你解决任何问题，支持质量正是开发者给予 Square Cloud 4.9/5 评分（共 402 条评价）（Google 与 Trustpilot）的重要原因之一。

Bots

网站

API 与后端

数据库

自托管应用

指南

迁移指南

如何 7×24 小时托管 Telegram 机器人

简介

前置条件

创建项目

在 Telegram 上创建机器人应用

开发项目

配置 Square Cloud

设置机器人令牌

部署

通过控制面板

通过 CLI

配置文件指南

测试机器人

更多资源

后续步骤

应用无法启动

环境变量

python-telegram-bot 与 aiohttp

联系我们

​简介

​前置条件

​创建项目

​在 Telegram 上创建机器人应用

​开发项目

​配置 Square Cloud

​设置机器人令牌

​部署

​通过控制面板

​通过 CLI

配置文件指南

​测试机器人

​更多资源

​后续步骤

应用无法启动

环境变量

python-telegram-bot 与 aiohttp

​联系我们

简介

前置条件

创建项目

在 Telegram 上创建机器人应用

开发项目

配置 Square Cloud

设置机器人令牌

部署

通过控制面板

通过 CLI

测试机器人

更多资源

后续步骤

联系我们