在 Heroku 上托管 n8n
本托管指南向您展示如何在 Heroku 上自托管 n8n。它使用:
- Docker Compose{:target="_blank" .external-link} 创建和定义应用程序组件以及它们如何协同工作。
- Heroku 的 PostgreSQL 服务{:target="_blank" .external-link} 托管 n8n 的数据存储。
- Deploy to Heroku 按钮提供一键式部署,只需少量配置。
提示
Self-hosting knowledge prerequisites 自托管知识先决条件
自托管 n8n 需要技术知识,包括:
- 设置和配置服务器和容器
- 管理应用程序资源和扩展
- 保护服务器和应用程序
- 配置 n8n
n8n 建议专家用户使用自托管。错误可能会导致数据丢失、安全问题和停机。如果您没有管理服务器的经验,n8n 推荐 n8n Cloud。
提示
稳定版和测试版
n8n 每周都会发布新的次要版本。 stable 版本用于生产用途。 beta 是最新版本。 beta版本可能不稳定。要报告问题,请使用 论坛。
当前 stable:2.47.7
当前 beta:2.48.4
使用部署模板创建Heroku项目
开始将 n8n 部署到 Heroku 的最快方法是使用 Deploy to Heroku 部署到 Heroku 按钮:
这将在 Heroku 上打开 Create New App 页面。为项目设置名称,并选择要部署项目的区域。
配置环境变量
Heroku 预填充了在 app.json 文件的 env 部分中定义的配置选项,这也为 n8n 使用的环境变量设置了默认值。
您可以更改任何这些值以满足您的需求。您必须更改以下值:
- N8N_ENCRYPTION_KEY,n8n 在保存到数据库之前使用它来加密用户帐户详细信息。
- WEBHOOK_URL 应与您创建的应用程序名称匹配,以确保 webhook 具有正确的 URL。
部署 n8n
选择 Deploy app。
Heroku 构建和部署应用程序后,它提供 Manage App 或 View 应用程序的链接。
提示
Heroku and DNS Heroku 和 DNS
请参阅 Heroku 文档 了解如何将您的域连接到 Heroku 应用程序。
更改部署模板
您可以复刻仓库,然后从您的复刻版本进行部署,以更改部署模板。
Dockerfile
默认情况下,Dockerfile 会拉取最新的 n8n 镜像。如果您想使用其他版本或固定版本,请更新 Dockerfile 顶行的镜像标签。
Heroku 和公开端口
Heroku 不允许基于 Docker 的应用程序使用 EXPOSE 命令定义公开端口。Heroku 会改为提供一个 PORT 环境变量,并在应用程序运行时动态填充值。entrypoint.sh 文件会覆盖默认的 Docker 镜像命令,改为设置 Heroku 提供的端口变量。然后,您可以在 Web 浏览器中通过端口 80 访问 n8n。
提示
Docker limitations with Heroku Heroku 的 Docker 限制
阅读本指南,了解有关将 Docker 与 Heroku 结合使用的限制的更多详细信息。
配置 Heroku
heroku.yml 文件定义您要在 Heroku 上创建的应用程序。它由两个部分组成:
setup>addons定义要使用的 Heroku 插件。在此示例中,它是 PostgreSQL 数据库插件。build部分定义 Heroku 如何构建应用程序。在此示例中,它使用 Docker buildpack,根据提供的Dockerfile构建web服务。
后续步骤
- 了解更多关于 n8n 配置和扩展的信息。
- 或继续探索如何使用 n8n:试试 Quickstarts 快速入门。
相关资源
- 使用云提供商
- 部署到 DigitalOcean
- 部署到 Hetzner
- 部署到AWS
- 部署到 Azure
- 部署到 Google Cloud Run
- 部署到 Google Kubernetes
- 部署到 OpenShift Local (CRC)
- 使用 Docker Compose