Skip to main content
Java 运行时在 JDK 25 上运行可执行 JAR 文件：机器人、Worker、API 和网站。你在自己的电脑上构建 JAR，Square Cloud 用 java -jar 启动它。

​
开始之前

  • 你的电脑上需要安装 Java 开发工具包（JDK）。如果尚未安装，可以从 Adoptium 下载 Eclipse Temurin。
  • 一个 Square Cloud 账户：使用邮箱或 GitHub 注册。
  • 一个有效的计划。查看计划并选择适合你项目的计划。

​
配置 Square Cloud

如果你通过控制面板上传应用，可以跳过本节：控制面板会自动为你创建 squarecloud.app 配置文件。

配置文件参考

squarecloud.app 文件告诉 Square Cloud 如何运行你的应用：主文件、内存、运行时版本、名称，以及网站所用的子域名。
将 MAIN 指向你的 JAR。每种应用的完整配置文件：
squarecloud.app
MAIN 最多接受 32 个字符。如果路径更长，请改用 RUNTIME=java 和 START=java -jar <path-to-your.jar>。

​
Square Cloud 运行什么

  • 如果配置文件中未定义 START 字段，Square Cloud 将执行 java -jar MAIN，其中 MAIN 指定的文件即为 JAR 文件。如果定义了 START 字段，则会直接执行其中的值。有关配置文件参数的更多信息，请访问配置参数。

​
网站和 API 的端口与主机

Square Cloud 会将 PORT 环境变量设为 80。你的服务器必须在该端口和所有网络接口（0.0.0.0）上监听。使用 Spring Boot 时，请在 application.properties 中设置 server.port=${PORT:80}，如 Spring Boot 指南所示。

​
准备项目

Square Cloud 不会编译 Java 项目：请在你的电脑上构建可执行 JAR 并上传它。
  • Maven： 运行 mvn package；JAR 会写入 target/。要将依赖打包进单个可运行的 JAR，请使用 Maven Shade 或 Assembly 插件，并将其配置为设置 Main-Class。
  • Gradle： 运行 ./gradlew build（或 gradle build）；JAR 会写入 build/libs/。要打包依赖，请使用 Shadow 插件（./gradlew shadowJar），或在 jar 任务的 manifest 中设置 Main-Class。
上传之前，请确认该 JAR 可以通过 java -jar your-app.jar 启动。请为 Java 25 或更早版本编译：运行时无法运行为更新 Java 版本构建的类。

​
必需文件

  • squarecloud.app，位于 ZIP 的根目录。
  • 你的可执行 JAR，在 MAIN 中设置。它的 META-INF/MANIFEST.MF 位于 JAR 内部，而不是一个单独的文件，并且必须声明应用的 Main-Class。
配置文件（squarecloud.app）必须位于 zip 文件的根目录中。否则，Square Cloud 在部署时将无法找到它。

​
不需要包含的文件

  • 源代码和构建文件夹是可选的：JAR 已经包含编译好的应用。

​
框架指南

Spring Boot

​
故障排除

JAR 的 manifest 中没有 Main-Class，因此 java -jar 无法启动它。请按照准备项目中的说明构建可执行 JAR。
该 JAR 是为比 JDK 25 更新的 Java 版本编译的。请为 Java 25 或更早版本构建它。
其他问题请参阅故障排除。

​
部署

​
通过控制面板

1

访问上传页面

访问上传页面并上传你的项目 zip 文件。
2

配置你的环境

上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。
3

部署你的项目

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

确认你的应用已上线

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

​
通过 CLI

要使用此方法，你的项目根目录中需要有一个名为 squarecloud.app 的配置文件。它告诉 Square Cloud 如何运行你的应用。

配置文件指南

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

安装 CLI

安装 Square Cloud CLI。如果你已经安装，运行同一条命令即可更新：
2

登录

运行下面的命令。它会打开你的浏览器：在浏览器中批准登录后，CLI 即可使用。无需复制任何 API 密钥。如需在脚本和 CI 中使用，请参阅 CLI 身份验证。
3

上传你的项目

在项目文件夹中运行下面的命令。CLI 会将当前文件夹打包为 zip（排除 squarecloud.ignore 中列出的内容）并上传：
要上传你自己创建的 zip，请通过 --file 传入：
4

确认你的应用已上线

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

​
后续步骤

环境变量

将密钥和设置放在代码之外，并在运行时读取。

自定义域名

在 Standard 及以上计划中，用你自己的域名提供应用。

故障排除

修复无法启动的应用或没有响应的站点。

​
联系我们

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