🚀 简介
- 在开始之前,请确保你有一个合适的文本编辑器来创建 HTML 和 CSS 文件。我们推荐 Visual Studio Code 或任何你偏好的其他编辑器。
- 接下来,你需要在 Square Cloud 上创建一个账户,可以通过登录页面完成。你可以使用邮箱、GitHub 或两者结合来创建账户。
- 最后,你的账户需要有一个有效的付费计划。你可以在这里查看我们的计划并根据需求购买。
Square Cloud 为静态项目(例如 HTML/CSS 网站)提供原生支持。这意味着你可以轻松地在平台上托管你的 HTML、CSS 和其他静态资源。借助集成的高级 CDN,你的网站将快速交付给全球用户。
如果你通过 Square Cloud 网站上传应用,可以忽略下面这一部分。网站会自动为你创建
squarecloud.app 配置文件。📄 必需文件
- index.html(主文件示例)。
- vite.html(Vite 项目的主文件示例)。
- 404.html(404 错误路由文件,可选)。
🖥️ 准备项目
在将项目托管到 Square Cloud 之前,请先检查项目文件是否已正确配置以便托管。📤 如何托管你的项目
现在你已经为 HTML/CSS 项目准备好了所有文件,下一步就是将它们上传到 Square Cloud 并让你的应用上线。有多种上传方式,但我们将介绍两种:通过 Dashboard 或通过 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,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。

