部署 Deno 应用或机器人

​

开始之前

• 你的电脑上需要安装 Deno，可以使用 Deno 官方安装程序，也可以使用 npm 包（npm install deno）。
• 一个 Square Cloud 账户：使用邮箱或 GitHub 注册。
• 一个有效的计划。查看计划并选择适合你项目的计划。

​

配置 Square Cloud

npm install deno

RUNTIME=nodejs
START=npx deno run --allow-net --allow-env main.ts
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My bot

RUNTIME=nodejs
START=npx deno run --allow-net --allow-env main.ts
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website
SUBDOMAIN=mywebsite

​

Square Cloud 运行什么

• START 会被直接执行。有关配置文件参数的更多信息，请访问配置参数。
• 如果应用没有 node_modules 文件夹，Square Cloud 会在启动它之前运行 npm install --no-audit --no-fund，这也会安装 deno 以及 package.json 中列出的所有 npm 模块。由于运行时设置了 NODE_ENV=production，devDependencies 中的包不会被安装。如果 node_modules 已经存在，则跳过安装步骤。

​

网站和 API 的端口与主机

Deno.serve(
  { port: Number(Deno.env.get("PORT") ?? 80), hostname: "0.0.0.0" },
  () => new Response("Hello, World!"),
);

​

准备项目

​

必需文件

• squarecloud.app，位于 ZIP 的根目录。
• 你的入口文件，例如 main.ts。
• 在 dependencies 中列出 deno 的 package.json。缺少它的上传会以 INVALID_DEPENDENCY 失败。
• 可选：用于任务、导入和其他 Deno 设置的 deno.json 或 deno.jsonc。

​

不需要包含的文件

• node_modules：Square Cloud 会从你的上传内容中移除此文件夹，并在首次启动时根据 package.json 安装依赖。
• deno_dir 或 .cache/deno：Deno 缓存目录，Deno 会在服务器上重新填充它。
• 锁文件：CLI 和 VS Code 扩展默认不会上传 package-lock.json、yarn.lock 和 pnpm-lock.yaml。如果你需要 package-lock.json 中的确切版本，请在你的 squarecloud.ignore 中用 !package-lock.json 重新包含它。

​

故障排除

​

部署

​

通过控制面板

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

​

后续步骤

​

联系我们