🚀 简介
- 在开始之前,请确保您的系统上已安装 .NET (Dotnet)。如果您还没有安装,可以从 Dotnet 官方网站下载。
- 接下来,您需要在 Square Cloud 上创建一个账户,可以通过登录页面完成。您可以使用邮箱、GitHub 或两者结合来创建账户。
- 最后,您的账户需要拥有一个有效的付费套餐。您可以在这里查看我们的套餐并根据需要购买。
⚙️ squarecloud.app 文件配置
如果你通过 Square Cloud 网站上传应用,可以忽略本节内容。网站会自动为你创建
squarecloud.app 配置文件。了解更多:如何为 Square Cloud 创建配置文件。
squarecloud.app 文件是一个配置文件,用于配置你的应用;它用来定义名称、描述、
版本、主文件等内容。
📄 必需文件
- project/project.csproj(主文件示例)。
在上面的示例中,主应用程序文件位于一个文件夹内。如果您的配置文件也位于某个文件夹内,则需要在
MAIN字段中定义路径,例如:MAIN=folder/file.csproj - squarecloud.app(包含 Square Cloud 配置的文件)。
▶️ 如何启动您的应用程序
-
如果配置文件中未定义
START字段,Square Cloud 默认会使用restore & run流程来启动您的应用程序。如果定义了START字段,其中的值将被直接执行。有关配置文件参数的更多信息,请访问配置参数。 -
Square Cloud 使用
dotnet restore来恢复项目依赖,并使用dotnet run --project MAIN来编译并运行在MAIN中指定的项目。
🖥️ 准备项目
在将您的项目托管到 Square Cloud 之前,请先检查项目文件是否已正确配置以便托管。📤 如何托管您的项目
现在您已经为 C# 项目准备好了所有文件,下一步就是将它们上传到 Square Cloud 并让您的应用程序上线。上传方式有多种,我们将介绍其中两种:通过控制面板或通过 CLI。通过控制面板
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,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。

