在 Square Cloud 上自托管 n8n

​

简介

• 本文将指导你在 Square Cloud 上创建和托管一个 n8n 应用。
• 在开始之前，请确保你在 Square Cloud 上拥有一个账户，你可以在注册页面使用邮箱创建账户。
• 最后，你的账户上需要有一个至少 4GB RAM 的有效套餐，例如 Standard：n8n 以 3GB 运行（见下方的 MEMORY=3072），更小的套餐没有这么多 RAM。请比较可用套餐，并根据你的需求选择一个。

​

创建项目

• n8n 运行在 Node.js 上，因此项目只需要一个 package.json。
• package.json 在 dependencies 中列出 n8n，并包含一个启动它的脚本。以下是示例：

{
  "name": "squarecloud-n8n",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "n8n"
  },
  "author": "Square Cloud Education <squarecloud.app>",
  "license": "ISC",
  "dependencies": {
    "n8n": "2.41.3"
  }
}

• n8n 的版本是特意固定的：如果使用 latest，任何一次重新安装都可能跳到带有破坏性变更的新主版本。n8n 2.x 需要 Node.js 24 或更高版本，VERSION=recommended 即可满足。
• 以后要更新时，先用 npm view n8n version 查看最新版本，阅读 n8n 发行说明，修改 package.json 中的版本，然后重新上传你的项目。

​

ZIP 中的文件

• package.json
• squarecloud.app（下面的配置文件）
• .env（可选，包含下面的变量）

​

配置文件

• 通过控制面板上传时，请手动将运行时设置为 Node.js，并使用 npm run start 作为启动命令。在 squarecloud.app 配置文件中，它看起来是这样的：

DISPLAY_NAME=App name
RUNTIME=nodejs
START=npm run start
MEMORY=3072
VERSION=recommended
SUBDOMAIN=my-n8n-subdomain

• 上面的 MEMORY 值遵循平台的规格规则。如果你想调整它，请参见为什么会有 RAM 最低要求。
• 接下来，设置下面的环境变量。你可以将它们放在项目根目录的 .env 文件中（n8n 启动时会加载它），或在上传表单的 Advanced configuration 中设置。请将 my-n8n-subdomain 替换为你的 SUBDOMAIN。

N8N_PORT=80
N8N_LISTEN_ADDRESS=0.0.0.0
N8N_HOST=my-n8n-subdomain.squareweb.app
N8N_PROTOCOL=https
N8N_WEBHOOK_URL=https://my-n8n-subdomain.squareweb.app/

• N8N_PORT 和 N8N_LISTEN_ADDRESS 让 n8n 在所有网络接口的 80 端口上监听，Square Cloud 会将你子域名的流量转发到这里。n8n 不会读取 Square Cloud 设置的 PORT 变量，因此必须设置 N8N_PORT。
• N8N_HOST、N8N_PROTOCOL 和 N8N_WEBHOOK_URL 告诉 n8n 它的公共地址。如果没有 N8N_WEBHOOK_URL，n8n 在工作流中显示的 webhook URL 会指向内部端口，外部服务将无法访问。较早的指南把这个变量称为 WEBHOOK_URL，它在 n8n 2.x 中已被弃用。更多选项请参见 n8n endpoint 变量。
• 在控制面板中设置的变量优先于 .env 文件。管理方式请参阅环境变量。

​

将项目上传到 Square Cloud

​

通过控制面板

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

​

创建所有者账户

​

结语

​

后续步骤

​

联系我们