Skip to main content

🚀 简介

  • 在开始之前,请确保你有一个合适的文本编辑器来创建 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” 并为项目设置子域名。
3

部署你的项目

最后,点击 “Deploy” 按钮,即可将项目托管到 Square Cloud。
部署完成后,你可以在控制面板中监控项目的状态和日志。
正在上传应用到 Square Cloud
4

确认你的应用已上线

首次部署通常在一分钟内完成。在控制面板中,等待你的应用状态显示为运行中,并检查日志中是否有启动错误。
如果你部署的是网站或 API,请在浏览器中打开 https://<your-subdomain>.squareweb.app,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。
应用无法启动?请参见故障排除指南,了解最常见的原因和解决方法。

通过 CLI

要使用此方法,你需要在项目根目录中创建一个名为 squarecloud.app 的配置文件。该文件将包含项目所需的配置。

配置文件指南

了解如何创建定义你应用环境的 squarecloud.app 配置文件。
1

安装 CLI

首先,你的环境中需要已安装 CLI。如果尚未安装,请在终端中运行以下命令:
如果你已经安装,我们建议对其进行更新。为此,请在终端中运行以下命令:
2

进行身份验证

现在,要进行身份验证并使用其他 CLI 命令,你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后,运行以下命令:
3

上传你的项目

最后,要使用 CLI 将应用部署到 Square Cloud,你需要运行以下命令:
或者,如果你手动创建了 zip 文件,可以使用:
4

确认你的应用已上线

首次部署通常在一分钟内完成。直接在终端中检查你的应用状态和日志:
如果你部署的是网站或 API,请在浏览器中打开 https://<your-subdomain>.squareweb.app,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。
应用无法启动?请参见故障排除指南,了解最常见的原因和解决方法。

联系我们

如果你仍然遇到技术问题,我们的专业支持团队可以为你提供帮助。联系我们,我们很乐意协助你解决任何问题 —— 支持质量正是开发者给予 Square Cloud 4.9/5 评分(共 402 条评价)(Google 与 Trustpilot)的重要原因之一。