如何托管 Discord 机器人

简介

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

前置条件

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

创建项目

要创建 Discord 机器人，拥有一个 Discord 账户对于在平台上创建和管理机器人至关重要。如果你还没有账户，请访问 Discord 官方网站创建你的账户。

在 Discord 上创建机器人应用

创建应用

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

生成身份验证令牌

创建应用后，导航到 “Bot” 选项卡并点击 “Reset Token” 以生成身份验证令牌。复制生成的令牌，以便稍后在代码实现中使用。

启用特权 Intents

配置好令牌后，启用所需的 intents。停留在 “Bot” 选项卡，向下滚动并找到 “Privileged Gateway Intents”。按照图中所示启用这些 intents：

关键安全提示：请对你的机器人令牌绝对保密。此令牌授予对机器人的完全控制权，应当作为机密信息对待。

开发项目

现在我们有了机器人令牌，就可以开始编写代码了。你可以使用你喜欢的语言来实现。

Discord.js (Node.js)
Discord.py (Python)

Node.js 环境搭建

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

Terminal

npm init -y

安装 Discord.js 库：

Terminal

npm install discord.js

创建一个 JavaScript 文件（例如 index.js），并添加以下代码来创建一个基础的 Discord 机器人：

index.js

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

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

client.on("ready", () => {
  console.log(`${client.user.tag}!`);
});

client.on("messageCreate", (message) => {
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

client.login("your token here");

Python 环境搭建

确认系统中已安装 Python。如果没有，请从 Python 官方网站下载。
使用 pip 安装 discord.py 库：

Terminal

pip install discord.py

创建一个 Python 文件（例如 main.py），并添加以下代码来创建一个基础的 Discord 机器人：

main.py

import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.message_content = True

client = commands.Bot(command_prefix='!', intents=intents)

@client.event
async def on_ready():
    print(f'{client.user}')

@client.command()
async def hello(ctx):
    await ctx.reply('Hello!')

client.run('your token here')

创建一个 requirements.txt 文件，列出项目所需的所有外部库：

requirements.txt

discord.py

部署

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

通过控制面板

访问上传页面

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

配置你的环境

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

部署你的项目

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

确认你的应用已上线

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

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

通过 CLI

要使用此方法，你需要在项目根目录中创建一个名为 squarecloud.app 的配置文件。该文件将包含项目所需的配置。

配置文件指南

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

安装 CLI

首先，你的环境中需要已安装 CLI。如果尚未安装，请在终端中运行以下命令：

npm install -g @squarecloud/cli

如果你已经安装，我们建议对其进行更新。为此，请在终端中运行以下命令：

Windows
Linux、macOS 和 WSL

squarecloud update

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

进行身份验证

现在，要进行身份验证并使用其他 CLI 命令，你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后，运行以下命令：

squarecloud auth login

上传你的项目

最后，要使用 CLI 将应用部署到 Square Cloud，你需要运行以下命令：

squarecloud upload

或者，如果你手动创建了 zip 文件，可以使用：

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

确认你的应用已上线

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

squarecloud app status
squarecloud app logs

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

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

测试机器人

如果你正确地完成了所有步骤，下一步就是邀请你的机器人进行测试。为此，请按照以下步骤操作：

访问开发者门户。
选择你的机器人。
导航到 “OAuth2” 选项卡。
进入 “OAuth2 URL Generator”。
勾选 “bot” 选项。
选择使用此邀请链接邀请机器人时它将拥有的权限。
在权限下方，会生成一个机器人的邀请链接。它应该类似于这样：

https://discord.com/oauth2/authorize?client_id=00000000000000&permissions=8&scope=bot

请记住，URL 中的 client_id 应替换为你机器人的实际 ID。permissions 值可能也需要根据你希望机器人拥有的权限进行调整。现在，要测试是否一切正常，请在你的服务器上执行以下命令：!hello。

联系我们

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

教程

Bots

现成项目

数据库

APIs

网站

迁移指南

如何托管 Discord 机器人

简介

前置条件

创建项目

在 Discord 上创建机器人应用

开发项目

部署

通过控制面板

通过 CLI

配置文件指南

测试机器人

更多资源

联系我们

​简介

​前置条件

​创建项目

​在 Discord 上创建机器人应用

​开发项目

​部署

​通过控制面板

​通过 CLI

配置文件指南

​测试机器人

​更多资源

​联系我们

简介

前置条件

创建项目

在 Discord 上创建机器人应用

开发项目

部署

通过控制面板

通过 CLI

测试机器人

更多资源

联系我们