简介
要在 Square Cloud 上开发和托管 ,遵循一套结构化的配置和前置条件流程至关重要。本技术指南将涵盖整个过程,从初始设置到生产环境部署。前置条件
创建项目
机器人的身份验证和绑定需要已安装并配置好的 WhatsApp。如果你还没有该应用,请访问 WhatsApp 官方网站 下载并设置。WhatsApp Web 的远程路径配置
WhatsApp Web 的远程路径配置
如果你的实现需要访问 WhatsApp Web 版本的远程路径,请按照以下技术流程操作:
- 访问 wa-version 仓库
- 选择所需的版本(始终建议使用最新版本)
- 点击 “Raw” 以查看文件
- 复制生成的 URL 以备后用
开发项目
- Node.js 检查:确认你的系统已安装 Node.js。否则,请从 Node.js 官方网站 下载。
- 项目初始化:运行初始化命令来搭建一个新的 Node.js 项目:
Terminal
- 安装依赖:安装机器人功能所需的核心库:
Terminal
- 创建主文件:编写包含机器人基础结构的
index.js文件:
index.js
部署
准备好项目文件后,你现在可以将它们上传到 Square Cloud 并托管你的项目。 为此,请创建一个包含所有项目文件的 ZIP 文件。通过控制面板
1
访问上传页面
访问上传页面并上传你的项目 zip 文件。
2
配置你的环境
上传 zip 后,你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目,请务必选择 “Web Publication” 并为项目设置子域名。
如果你上传的是 Web 项目,请务必选择 “Web Publication” 并为项目设置子域名。
3
部署你的项目
最后,点击 “Deploy” 按钮,即可将项目托管到 Square Cloud。
部署完成后,你可以在控制面板中监控项目的状态和日志。
部署完成后,你可以在控制面板中监控项目的状态和日志。

4
确认你的应用已上线
首次部署通常在一分钟内完成。在控制面板中,等待你的应用状态显示为运行中,并检查日志中是否有启动错误。
如果你部署的是网站或 API,请在浏览器中打开
如果你部署的是网站或 API,请在浏览器中打开
https://<your-subdomain>.squareweb.app,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。
通过 CLI
要使用此方法,你需要在项目根目录中创建一个名为squarecloud.app 的配置文件。该文件将包含项目所需的配置。
配置文件指南
了解如何创建定义你应用环境的
squarecloud.app 配置文件。1
安装 CLI
首先,你的环境中需要已安装 CLI。如果尚未安装,请在终端中运行以下命令:如果你已经安装,我们建议对其进行更新。为此,请在终端中运行以下命令:
- Windows
- Linux、macOS 和 WSL
2
进行身份验证
现在,要进行身份验证并使用其他 CLI 命令,你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后,运行以下命令:
3
上传你的项目
最后,要使用 CLI 将应用部署到 Square Cloud,你需要运行以下命令:或者,如果你手动创建了 zip 文件,可以使用:
4
确认你的应用已上线
首次部署通常在一分钟内完成。直接在终端中检查你的应用状态和日志:如果你部署的是网站或 API,请在浏览器中打开
https://<your-subdomain>.squareweb.app,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。
测试机器人
在 Square Cloud 控制面板中查看应用日志:首次启动时,你会看到二维码生成的日志,用手机上的 WhatsApp 扫描后,出现WhatsApp client successfully initialized! 消息即确认会话已激活。然后从另一个号码向已链接的 WhatsApp 账户发送 !ping,并确认它回复 pong - Bot working correctly!。
使用 Baileys 代替 whatsapp-web.js
Baileys 是一个替代库,它通过 WebSocket 直接连接到 WhatsApp 的多设备 API,无需启动无头浏览器。由于没有 Chromium/Puppeteer 实例需要运行,它比 whatsapp-web.js 使用的内存明显更少。 由于 Baileys 没有浏览器会话可以依赖,它必须在重启之间自行持久化身份验证状态(auth 文件夹中的creds.json 文件和密钥),否则每次重新部署时链接的设备会话都会丢失,你将需要重新扫描二维码。我们建议将该 auth 文件夹提交到持久化存储中,例如 Square Cloud Blob Storage,以便会话在重新部署后仍然保留。
- 安装该库:
Terminal
- 使用
makeWASocket和useMultiFileAuthState创建一个index.js文件,用于加载和持久化会话:
index.js
MEMORY 值:
squarecloud.config

