n8n-hosting

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署自动化工作流 🍴 复刻 877 🐛 待处理 46 👀 关注 24

GitHub ↗

GitHub 星标 ★ 1760

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，需自行部署

项目预览

n8n-hosting 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类自动化工作流

开发团队n8n-io

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Go Template

GitHub 星标★ 1760

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

代码更新2026-11-03

仓库体积1.3 MB

本站数据更新2026-11-03

维护状态活跃

收录时间2026-09-20

浏览次数1

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-20 · 当前星标 ★ 1760

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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`