n8n-hosting

照着模板把 n8n 部署到 Docker/K8s，自托管不求人

n8n-hosting 是 n8n 官方维护的自托管部署示例仓库，解决用户把 n8n 工作流自动化平台跑在自己服务器或集群上的配置难题。它针对 Docker、Docker Compose、Kubernetes（含 Helm Chart）、AWS、GCP、Azure 等不同环境给出可直接参考的部署模板和配置片段，涵盖数据库（Postgres）、队列模式、反向代理、持久化存储、环境变量与密钥管理等关键环节。核心能力是提供经过官方验证的部署样板，让运维和开发者不必从零摸索容器编排细节，降低自托管门槛，同时展示生产级高可用与横向扩展的推荐做法。仓库以 Go Template 等模板文件为主，本身不是可运行产品，而是配套 n8n 主项目的部署指南集合，适合需要私有化、数据自主可控的团队快速落地。

开源 free 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1740

维护状态活跃

是否开源是

定价模式 free

项目数据

分类自动化工作流

开发团队n8n-io

所属国家

官网地址

GitHubhttps://github.com/n8n-io/n8n-hosting

定价模式free

价格说明开源免费，需自行部署

访问状态

是否开源是

开源协议MIT

主要语言Go Template

技术栈/模型

GitHub 星标★ 1740

30天Star增速

HF 下载量

上线时间2024-04-02 00:00:00

最近更新2026-09-19 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-20

浏览次数0

使用教程

难度：入门约 15 分钟部署方式：Docker 5 步

环境要求

已安装 Git，可克隆仓库
已安装 Docker 与 Docker Compose（模板均为 Compose 文件）
生产环境建议采用 PostgreSQL 17 或 18（兼容 16），模板默认部署 18
队列模式需额外 Redis，推荐 7+（设置 Redis 用户名时需 6+）

安装与启动步骤

1克隆官方仓库

把 n8n 官方托管配置仓库拉到本地，仓库内是各环境的部署模板，不含可执行程序。
```
git clone https://github.com/n8n-io/n8n-hosting.git
```
2挑选部署模板

按场景选目录：单机选 withPostgres；队列模式选 withPostgresAndWorker；子目录 SSL 选 subfolderWithSSL；Caddy 反代选 docker-caddy。
```
cd n8n-hosting/docker-compose/withPostgres
```
3检查并调整配置

打开所选目录内的 compose 与环境变量文件，确认数据库版本、镜像 tag、密钥等；生产环境把镜像 tag 固定为具体版本。
4启动容器服务

在所选模板目录下用 Docker Compose 拉起服务，首次运行会拉取镜像并初始化数据库。
```
docker compose up -d
```
5访问并初始化

浏览器打开 n8n 服务地址，出现初始化/登录页面即部署成功，随后创建管理员账号。

关键配置

配置项	必填	说明	示例
`PostgreSQL 版本`	是	生产推荐数据库，模板部署 18，也支持 17 与 16	`18`
`Redis 版本`	否	仅队列模式需要，推荐 7+，设置用户名时需 6+	`7`
`数据库类型`	否	非队列模式默认 SQLite；MySQL/MariaDB 后端不支持	`PostgreSQL`

如何确认成功

浏览器打开 n8n 服务地址，出现初始化或登录页面，且容器正常运行时即表示启动成功。

常见问题

Q：可以用 MySQL 或 MariaDB 做后端吗？

A：不支持。MySQL/MariaDB 后端在 v1.0 废弃、v2.0 移除，请改用 PostgreSQL；MySQL 节点本身不受影响。

Q：什么时候必须部署 Redis？

A：只有启用队列模式（带 worker）时才需要，推荐 Redis 7+；若设置 Redis 用户名则至少需要 6+。

Q：SQLite 能用于生产吗？

A：SQLite 是关闭队列模式时的默认项，适合开发和小型单实例；生产环境建议使用 PostgreSQL。

Q：Amazon Aurora PostgreSQL 支持吗？

A：属于实验性支持，仅由 HA CloudFormation 模板提供以实现更快故障切换，n8n 未测试认证，版本策略不覆盖它。

Q：生产环境镜像 tag 怎么选？

A：按 n8n 最新稳定版部署，并固定具体镜像 tag，不要依赖 stable 或 latest。

注意事项

仓库本身不含可执行程序，只是官方维护的部署模板集合，需按目录选用。
README 未给出逐版本支持矩阵，部署前请对照 n8n 官方文档确认目标版本。
生产环境务必固定镜像 tag，并做好密钥与持久化存储管理。
MySQL/MariaDB 作为 n8n 后端已被移除，新部署不要沿用旧方案。

核心亮点

官方维护，与 n8n 主版本同步更新，配置不易过时
覆盖 Docker、K8s、Helm 及主流云厂商多种部署形态
包含 Postgres、队列模式、反向代理等生产级配置参考

不足之处

只是示例模板，不提供一键部署脚本或托管服务
部分云厂商方案依赖特定平台，迁移需自行改造

适用场景

团队在内网服务器用 Docker Compose 私有化部署 n8n
在 Kubernetes 集群用 Helm 部署高可用 n8n 队列模式
参考云厂商模板把 n8n 跑在 AWS/GCP/Azure 上

替代项目

n8n-docker-caddy、awesome-selfhosted

项目介绍

n8n-hosting 是一个自动化工作流领域的开源项目，官方简介：Example of self-hosting n8n in various environments like docker, kubernetes, etc.。项目使用 Go Template 开发，在 GitHub 上获得 1740 星标。

上一篇：n8n-docs

下一篇：n8n-nodes-starter