Skip to main content
Square Cloud Bots 服务概览

​
为什么选择 Square Cloud？

我们是拉丁美洲最大的机器人托管平台，深受巴西 100 大 Discord 服务器中 80 家的信赖。机器人的成败取决于在线时间，以及它与 Discord、WhatsApp 和 Telegram 网关之间的延迟，因此从硬件到网络边缘，我们技术栈的每一层都经过调优，让你的进程 24/7 在线且响应迅速。

专为性能打造

每个机器人都运行在配备 10Gbps 上行链路的企业级 NVMe SSD 上，处于具备内核强制 CPU 与 RAM 限制的隔离容器中，邻居的流量激增永远不会变成你的延迟问题。

完整的开发者生态

CLI、JavaScript、Python 与 Go SDK、**VS Code 扩展**以及用于 CI/CD 的 GitHub Actions/Webhooks。从终端、编辑器或一次 git push 即可部署。

Square Shield + Cloudflare

由 Cloudflare 前置的边缘加上 Square Shield，让你的机器人保持在平台 API 速率限制（Discord 及其他平台）之内，避免导致机器人下线的封禁和冷却。

即时 snapshot

一键还原点，无需额外付费。几秒内即可回滚出错的 deploy，无数据丢失、无停机。
**大规模验证：**我们的声誉来自为拉丁美洲一些最繁忙的社区运行机器人：正是这种持续、高事件速率的负载，会悄然暴露薄弱的基础设施。你的机器人运行在同样的集群上。

​
支持的环境

使用你已经熟悉的平台和语言进行开发。

​
平台

Discord、WhatsApp、Telegram、Slack 和 X 都有附带代码的分步指南：点击卡片即可打开。

Discord

WhatsApp

Telegram

Slack

X (Twitter)

Instagram

Facebook

YouTube

​
语言

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

大多数其他语言和库也能直接运行。参见支持的语言和运行时。

​
主要特性

​
为常驻工作负载打造的基础设施

每个集群都运行在配备 10Gbps 上行链路的企业级 NVMe SSD 上，你的机器人运行在具有专属 CPU 与 RAM 上限的隔离、非特权容器中。隔离才能把”纸面上的快”变成生产中真正的快：你的进程永远不必与吵闹的邻居争抢 I/O 或 CPU，因此即使在持续的事件负载下，响应时间也能保持在低位。

​
Square Shield：始终保持在速率限制之内

Discord、WhatsApp 和 Telegram 会封禁超出其网关和 REST 速率限制的机器人。Square Shield 位于你的机器人与这些 API 之间，监控请求模式，让你保持在允许的额度之内。这正是平稳扩展的机器人与在最糟糕时刻被冷却下线的机器人之间的区别。

​
全面可视化地运维

还原点让你能在几秒内回滚出错的 deploy，无数据丢失、无停机。Pro 和 Enterprise 套餐还额外提供每日自动 snapshot。
实时查看应用的 stdout/stderr，一旦出现异常即可在生产环境中调试，无需重新部署。
在控制面板中实时跟踪 CPU、RAM 和网络消耗，合理调整资源规模，并在用户发现之前捕捉到性能回退。

​
开发工具

无论你在哪里工作，都能部署和管理你的机器人：
1

Square Cloud CLI

直接在终端中部署、重启、查看日志和管理你的应用。请从 CLI 快速开始入手。
2

VS Code 扩展

无需离开代码编辑器即可管理和部署你的应用。参见如何安装 VS Code 扩展。
3

GitHub

为你的机器人提供持续部署：连接你的 GitHub 仓库后，每次 push 都会自动更新应用；也可以用 GitHub Actions 从工作流中部署。
使用 GitHub Actions 部署需要一个 API key，它应保存在仓库的 secrets 中，绝不能写在代码里。

​
如何托管我的机器人？

添加配置文件

在项目根目录创建一个 squarecloud.app 文件。它告诉 Square Cloud 要运行哪个文件、预留多少内存以及使用哪个运行时。配置文件指南解释了每个字段。添加 AUTORESTART=true，让机器人在崩溃后自动重启。

包含依赖文件

将依赖文件保留在项目中：Node.js 使用 package.json，Python 使用 requirements.txt 或 pyproject.toml。Square Cloud 会在服务器上安装其中列出的所有内容。不要列出内置模块，例如 Node.js 中的 fs 或 Python 中的 random，因为它们随语言自带。

将项目打包成 zip

将代码、配置文件和依赖文件压缩成一个 .zip。不要包含 node_modules、package-lock.json 之类的锁文件以及其他生成的文件：依赖会在服务器上安装，而且上传的文件越小，部署越快。CLI 和 VS Code 扩展会自动排除锁文件。需要固定版本？请在 squarecloud.ignore 文件中添加 !package-lock.json。

上传你的机器人

在上传页面发送 .zip。Square Cloud 会安装依赖，根据你的配置文件设置环境，然后启动你的机器人。
正在上传应用到 Square Cloud

​
遇到问题？

应用无法启动

解决部署失败或启动时崩溃的问题：缺少模块、INVALID_DEPENDENCY、端口已被占用或内存不足。

Discord 机器人错误

无效的令牌、未授权的 intents、Lavalink 断开连接，以及本地正常但上线后掉线的机器人。

​
常见问题

我们推荐 Standard 套餐，每月 R44.99起∗∗，提供4GB内存和4个vCPU，足以应对繁忙的服务器和流量高峰。较轻量的机器人也可以在∗∗Hobby∗∗套餐（∗∗每月R44.99 起**，提供 4 GB 内存和 4 个 vCPU，足以应对繁忙的服务器和流量高峰。较轻量的机器人也可以在 **Hobby** 套餐（**每月 R12.49 起）上运行：机器人至少需要 256 MB 内存。完整对比请参见套餐与价格。
是的。你的机器人运行在拥有专属 CPU 和内存的隔离容器中，Square Cloud 的基础设施在整个平台上平均达到 99.99% 在线率。在配置文件中设置 AUTORESTART=true，机器人在崩溃后还会自动重启：该选项默认关闭。