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

​

简介

​

前置条件

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

​

创建项目

​

在 Discord 上创建机器人应用

创建应用

访问 开发者门户 并点击 “New Application”。为你的机器人指定一个名称，然后点击 “Create” 创建应用。

生成令牌

创建应用后，导航到 “Bot” 选项卡并点击 “Reset Token” 以生成身份验证令牌。复制它：你将在 Square Cloud 上把它设置为环境变量，而绝不是写在代码中。

启用特权 intents

示例机器人会读取消息文本，因此需要 Message Content Intent。停留在 “Bot” 选项卡，向下滚动到 “Privileged Gateway Intents”，然后启用 Message Content Intent。本示例不需要另外两个特权 intent（Presence 和 Server Members）。

​

开发机器人

npm init -y

npm install discord.js

const { Client, Events, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    // Privileged: turn on "Message Content Intent" in the Developer Portal
    GatewayIntentBits.MessageContent,
  ],
});

client.once(Events.ClientReady, (readyClient) => {
  console.log(`Logged in as ${readyClient.user.tag}`);
});

client.on(Events.MessageCreate, (message) => {
  if (message.author.bot) return;
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

// The token comes from the DISCORD_TOKEN environment variable
client.login(process.env.DISCORD_TOKEN);

pip install discord.py

import os

import discord
from discord.ext import commands

intents = discord.Intents.default()
# Privileged: turn on "Message Content Intent" in the Developer Portal
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.command()
async def hello(ctx):
    await ctx.reply("Hello!")


# The token comes from the DISCORD_TOKEN environment variable
bot.run(os.environ["DISCORD_TOKEN"])

discord.py

​

配置 Square Cloud

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

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

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

​

设置机器人令牌

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

squarecloud app env set DISCORD_TOKEN=your_token_here
squarecloud app restart

​

ZIP 中包含什么

• 你的主文件（index.js 或 main.py）和其他源文件。
• package.json 或 requirements.txt。
• squarecloud.app。

​

部署并验证

​

通过控制面板

1

访问上传页面

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

2

配置你的环境

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

3

部署你的项目

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

4

确认你的应用已上线

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

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

​

通过 CLI

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

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

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

squarecloud app status
squarecloud app logs

​

邀请机器人加入你的服务器

1. 访问 开发者门户 并选择你的机器人。
2. 导航到 “OAuth2” 选项卡，进入 “OAuth2 URL Generator”。
3. 在 “Scopes” 下勾选 “bot” 选项。
4. 在 “Bot Permissions” 下只勾选示例需要的权限：View Channels、Send Messages 和 Read Message History。避免勾选 Administrator：机器人很少需要它，而且一旦令牌泄露，对方就能控制你的整个服务器。
5. 复制生成的 URL，在浏览器中打开并将机器人添加到你的服务器。URL 类似于这样：

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=68608&scope=bot

​

常见错误

​

An invalid token was provided

​

Used disallowed intents

​

机器人在线，但不回应 !hello

​

后续步骤

​

联系我们