n8n本地部署实战指南：含n8n本地部署硬件配置要求及中文说明

作者： Dr.n8n 更新时间：2025-10-17 21:10:03 分类：n8n教程

大家好，我是 Dr.N8N。在自动化和 Agent 领域的实战中，我见过太多团队因为一个错误的起点而步入深坑：将 n8n 本地部署（Self-Hosting）仅仅看作是 n8n Cloud 的“免费”替代品。这种心态往往导致他们在硬件选型上极度吝啬、在架构设计上掉以轻心，最终陷入性能瓶颈、Webhook 调试地狱和无尽的运维噩梦中 [1, 2, 3]。

这篇文章，就是为了终结这种混乱。我将带你走过从战略决策到生产运维的全过程，帮你搭建一个真正稳定、安全、可扩展的 n8n 实例。这不仅仅是一份技术手册，更是我多年踩坑经验的总结。读完它，你将明白本地部署的真正价值，并掌握驾驭它的核心能力。

为何选择本地部署？这首先是一个战略决策

在动手之前，我们必须明确：选择本地部署，意味着你选择用可控的技术投入，来换取云版本无法提供的三大核心优势：数据主权、成本可预测性和无限的定制能力 [4, 5]。所有工作流、凭证和执行日志都安放在你自己的服务器里，这对于处理敏感数据或有合规要求的企业至关重要 [6, 4]。

与 n8n Cloud 按执行次数付费的模式不同，本地部署的成本主要由服务器硬件构成。一个月可能只需花费 6 到 12 美元，你就能获得理论上无限的工作流执行次数，这对于高频、大规模的自动化场景，总拥有成本（TCO）优势极为明显 [7]。更关键的是，你可以在自托管环境中自由安装社区节点，甚至开发自己的私有节点来集成内部系统——这是 n8n Cloud 无法实现的 [6, 5]。

许可证提醒：n8n 采用“公平代码”许可证，明确禁止将 n8n 作为一项托管的 SaaS 产品直接提供给第三方 [6]。但你可以为客户提供咨询和部署服务，或用它构建强大的内部工具。在投入资源前，请务必评估你的商业模式是否合规。

硬件规划：你的第一道，也是最重要的防线

绝大多数 n8n 实例的崩溃问题，都源于硬件资源规划的失败，尤其是内存。官方的最低配置仅适用于最基础的测试，在生产环境中直接套用无异于自杀。

我见过太多用户因为 2GB 内存配置而导致实例频繁崩溃 [8]。请记住，硬件是对平台稳定性的基础投资，而不是一个需要削减的成本项。

负载等级	vCPU 核心数	内存 (RAM)	SSD 存储	数据库
开发/测试环境	2 核	4 GB	20 GB+	SQLite / PostgreSQL
小型团队/低频生产	2-4 核	8 GB (强烈推荐)	50 GB+	PostgreSQL
企业级/高并发	8+ 核	32 GB+	250 GB+	托管/集群 PostgreSQL

此外，在生产环境中绝对不能使用默认的 SQLite 数据库。SQLite 的并发处理能力很差，当多个工作流同时执行时，极易发生锁争用，导致执行失败甚至数据库损坏 [8]。因此，为生产环境选择 PostgreSQL 是强制性的，它能可靠地支持高并发负载 [9, 10, 11, 12, 13]。

生产级 Docker Compose 部署实战

忘掉那些只启动一个 n8n 容器的简陋教程吧。一个生产级的部署，必须包含反向代理来处理 HTTPS 加密和流量路由，这是从根源上解决 Webhook 和安全问题的唯一正确方法。我们将采用 n8n + PostgreSQL + Traefik 的三容器架构。

首先，在你的服务器上（推荐 Ubuntu 22.04 LTS）安装好 Docker 和 Docker Compose [9, 14]。然后创建一个项目目录，例如 ~/n8n-compose。

创建 .env 配置文件
将配置与代码分离是最佳实践。在项目目录下创建 .env 文件，填入你的信息：

# 域名配置
DOMAIN_NAME=your-domain.com
SUBDOMAIN=n8n

# 时区配置 (例如: Asia/Shanghai)
GENERIC_TIMEZONE=Asia/Shanghai

# Let's Encrypt SSL 证书申请邮箱
SSL_EMAIL=your-email@example.com

# PostgreSQL 数据库凭证 (请务必使用强密码)
POSTGRES_DB=n8n
POSTGRES_USER=n8n_user
POSTGRES_PASSWORD=your_strong_password_here

创建 docker-compose.yml 文件
这是我们的核心部署文件。它定义了三个协同工作的服务：

services:
  traefik:
    image: "traefik:v2.9"
    container_name: traefik
    restart: always
    command:
      - "--api.insecure=true"
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.web.http.redirections.entryPoint.to=websecure"
      - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
      - "--entrypoints.websecure.address=:443"
      - "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
      - "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
      - "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - traefik_data:/letsencrypt
      - /var/run/docker.sock:/var/run/docker.sock:ro

  postgres:
    image: postgres:15
    container_name: postgres
    restart: always
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data

  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: always
    depends_on:
      - postgres
      - traefik
    ports:
      - "127.0.0.1:5678:5678"
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)"
      - "traefik.http.routers.n8n.entrypoints=websecure"
      - "traefik.http.routers.n8n.tls.certresolver=mytlschallenge"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
    volumes:
      - n8n_data:/home/node/.n8n
      -./local-files:/files

volumes:
  n8n_data:
  postgres_data:
  traefik_data:

关键配置解析：

traefik: 我们的反向代理，它会自动处理 Let's Encrypt 的 SSL 证书，让你的 n8n 实例能通过 HTTPS 访问 [14]。
postgres: 独立的数据库容器，通过 volumes 挂载实现了数据持久化。
n8n:
- ports: - "127.0.0.1:5678:5678": 这是一个核心安全设置。它只将 n8n 端口暴露给服务器本地，所有外部流量都必须经过 Traefik 代理，由 Traefik 负责加密和路由 [14]。
- environment: 定义了数据库连接、时区以及最重要的 WEBHOOK_URL。这个 URL 必须是你的 n8n 实例的公网 HTTPS 地址，否则 Webhook 将无法工作 [14]。
- volumes: n8n_data 和 postgres_data 是命名卷，它们独立于容器的生命周期，确保了在升级或重启后你的工作流和数据都安然无恙。./local-files:/files 则提供了一个与宿主机共享文件的通道 [14]。

启动服务
在启动前，请确保你的域名 A 记录已指向服务器 IP。然后在 ~/n8n-compose 目录下执行：
```
# 以后台模式启动所有服务
docker compose up -d

# 查看容器状态，确保都是 running
docker compose ps
```
稍等片刻，待 Traefik 申请好 SSL 证书，你就可以通过 https://n8n.your-domain.com 访问你的实例了。

初始化与无痛维护

首次访问 n8n 实例时，系统会引导你创建 Owner 管理员账户 [15, 16]。这是实例的最高权限账户。为了支持用户邀请和密码重置，你还应该在 .env 文件中配置 SMTP 服务，这对于团队协作至关重要 [16]。

版本升级是很多初学者担心会丢失数据的地方，但得益于我们的 Docker Compose 配置，升级过程非常安全和简单。因为数据存储在持久化的数据卷中，升级时只会替换应用容器，数据卷会被重新挂载到新容器上。

标准升级流程仅需两步：

# 1. 进入项目目录
cd ~/n8n-compose

# 2. 拉取最新镜像
docker compose pull

# 3. 使用新镜像重新创建并启动服务
docker compose up -d

# 4. (可选) 清理旧的、未使用的镜像
docker image prune

就是这么简单，你的 n8n 实例就完成了无损升级 [17, 18, 19]。

常见“天坑”与排错指南

在我看来，90% 的新手问题都集中在以下三类，而这些问题都源于对周边技术（网络、资源、容器）的理解不足，而非 n8n 本身的缺陷。

Webhook 失效: 根本原因是你没有一个公网可访问的 HTTPS 地址，或者 WEBHOOK_URL 环境变量配置错误。我们前面采用的 Traefik 反向代理架构，就是这个问题的终极解决方案 [20, 21, 22]。
处理大数据时实例崩溃: 这几乎总是内存不足（Out of Memory）导致的 [1, 3, 23]。解决方案不是无脑增加硬件，而是优化你的工作流。使用 Split in Batches 节点将大任务分批处理，或者将复杂流程拆分为多个子工作流，可以极大地降低峰值内存消耗 [3, 23]。如果优化后仍然崩溃，那才是真正需要升级服务器内存的时候。
Docker 网络问题: 当 n8n 需要连接到运行在同一台服务器上的其他服务时（比如本地的 Ollama），请记住，在容器内部，localhost 指向的是容器自身，而不是宿主机。正确的做法是使用 Docker 提供的特殊 DNS 名称 host.docker.internal 来访问宿主机上的服务 [12, 24]。例如，地址应为 http://host.docker.internal:11434。