🚀 简介
- 在开始之前，请确保你的系统上已安装 Node.js 和 npm。如果尚未安装，你可以从 Node.js 官方网站 下载。
- 接下来，你需要在 Square Cloud 上创建一个账户，可以通过登录页面完成。你可以使用邮箱、GitHub 或两者结合来创建账户。
- 最后，你的账户需要有一个有效的付费计划。你可以在这里查看我们的计划并根据需求购买。
⚙️ squarecloud.app 文件配置
如果你通过 Square Cloud 网站上传应用，可以忽略本节内容。网站会自动为你创建
squarecloud.app 配置文件。了解更多：如何为 Square Cloud 创建配置文件。
squarecloud.app 文件是一个配置文件，用于配置你的应用；它用来定义名称、描述、
版本、主文件等内容。
📄 必需文件
- JavaScript
- TypeScript
- 如果配置文件中未定义
START字段，Square Cloud 将默认使用优化选项和特定参数执行node。如果定义了START字段，则会直接执行其中的值。有关配置文件参数的更多信息，请访问配置参数。
- 如果
node_modules文件夹不存在，Square Cloud 将执行npm install --no-package-lock --no-audit --no-fund来安装依赖并清理.npm文件夹。
🖥️ 准备项目
📁 必要的配置文件
在为 Square Cloud 部署准备 Node.js 项目时，请确保将配置文件（squarecloud.app/.config）和应用的必要文件都放入一个 zip 文件中。
🗑️ 上传前需排除的文件
node_modules：此文件夹无需上传，因为它会在生产环境安装过程中重新创建。package-lock.json：此文件不必要，因为生产环境将基于package.json安装依赖。
🤔 为什么要排除这些文件？
在上传项目之前排除node_modules 和 package-lock.json 有几个原因：
-
安装一致性： 不上传
node_modules可确保依赖由生产环境安装，从而得到一致的构建，避免本地系统的差异。 -
最新安装： 生产环境将安装
package.json中所列依赖的最新兼容版本，为你的应用提供一个干净的起点。 - 减小上传体积： 不包含这些文件夹可减小上传文件的大小，加快上传过程并使部署更高效。
📄 必需文件
托管 Node 项目需要三个文件：- squarecloud.app/.config
- mainFile.js/.ts（主文件示例）
- package.json（依赖文件）
Square Cloud 原生支持
TypeScript，通过 ts-node 执行你的项目，但由于我们是一个生产平台，始终建议将其编译为 JavaScript。💡 故障排查
主文件无效或已损坏
主文件无效或已损坏
当配置文件中为你的应用定义为 “main” 的文件不存在、拼写错误或路径有误时，就会出现此错误。例如，如果你的主文件位于某个文件夹内，则必须指定为
folder/file.js。内存不足
内存不足
托管一个机器人所需的最低内存为 256MB，托管网站/API 则为 512MB。不过，根据应用的大小和复杂程度，可能需要分配更多的内存，以避免应用因内存耗尽而崩溃。
📤 如何托管你的项目
现在你已经为 Node.js 项目准备好了所有文件，下一步就是将它们上传到 Square Cloud 并让你的应用上线。有多种上传方式，但我们将介绍两种：通过 Dashboard 或通过 CLI。通过控制面板
访问上传页面
访问上传页面并上传你的项目 zip 文件。
通过 CLI
要使用此方法，你需要在项目根目录中创建一个名为squarecloud.app 的配置文件。该文件将包含项目所需的配置。
了解更多：如何为 Square Cloud 创建配置文件。
squarecloud.app 文件是一个配置文件，用于配置你的应用；它将用于定义你的环境。
安装 CLI
首先，你的环境中需要已安装 CLI。如果尚未安装，请在终端中运行以下命令：如果你已经安装，我们建议对其进行更新。为此，请在终端中运行以下命令：
- Windows
- Linux、macOS 和 WSL
进行身份验证
现在，要进行身份验证并使用其他 CLI 命令，你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后，运行以下命令：