部署 Go 应用、API 或机器人

​

开始之前

• 你的电脑上需要安装 Go。如果尚未安装，可以从 Go 官方网站 下载。
• 一个 Square Cloud 账户：使用邮箱或 GitHub 注册。
• 一个有效的计划。查看计划并选择适合你项目的计划。

​

配置 Square Cloud

MAIN=main.go
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My bot

MAIN=main.go
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My API
SUBDOMAIN=my-api

​

Square Cloud 运行什么

• 如果配置文件中未定义 START 字段，Square Cloud 将执行 go run MAIN 来编译并运行 MAIN 中指定的 Go 文件。如果定义了 START 字段，则会直接执行其中的值。有关配置文件参数的更多信息，请访问配置参数。
• go run MAIN 只编译 MAIN 中设置的文件。如果你的 main 包分布在多个文件中，请设置 START=go run .。
• Square Cloud 不会运行 go mod tidy：请在上传之前在你的电脑上运行它，让 go.mod 和 go.sum 列出所有依赖。go run 会在应用启动时下载这些模块。

​

网站和 API 的端口与主机

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func main() {
	// Square Cloud sets PORT=80. ":" + port listens on all network interfaces.
	port := os.Getenv("PORT")
	if port == "" {
		port = "80"
	}

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "Hello, World!")
	})

	log.Fatal(http.ListenAndServe(":"+port, nil))
}

​

准备项目

​

必需文件

• squarecloud.app，位于 ZIP 的根目录。
• main.go，或 MAIN 中设置的文件。
• go.mod，工作区则为 go.work：两者都没有的上传会以 INVALID_DEPENDENCY 失败。
• go.sum，模块有依赖时必需。

​

不需要包含的文件

• 编译好的二进制文件（.exe 文件或 go build 的输出）：Square Cloud 会自行构建程序。
• vendor/，除非你的构建有意使用它：go run 会下载 go.sum 中列出的模块。

​

故障排除

​

部署

​

通过控制面板

1

访问上传页面

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

2

配置你的环境

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

3

部署你的项目

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

4

确认你的应用已上线

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

应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

​

通过 CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

后续步骤

​

联系我们