如何在自己的服务器上部署 n8n

前言

n8n 是一款强大的低/无代码工作流自动化平台，支持超过 400 + 种集成服务。相比使用其云服务，自建部署（Self-host）可掌控数据、安全、资源，以及定制化程度。官方将 Self-host 方式作为「适合有一定运维经验的用户」选择。(docs.n8n.io)

本篇文章将从准备、安装、配置、运行、运维等角度，带你一步一步在自己服务器上部署 n8n。

---

一、准备工作

在开始之前，请确认并准备以下事项：

1. 服务器环境

• 建议使用 Linux 系统（如 Ubuntu 20.04、Debian 12 等），社区中很多教程以 Ubuntu 为例。(n8n Community)

• 推荐至少 1 GB -- 2 GB 内存，小负载可以更低，但生产环境建议更多。(n8n Community)

• 有公网 IP 或 域名，并可指向你的服务器。最好使用子域名指向，例如 n8n.example.com。(n8n Community)

• 安装 Docker 与 docker-compose（后续步骤会用到）。

• 如果生产环境建议配置 HTTPS/SSL 、反向代理（如 Nginx）、防火墙、备份方案。

2. 域名／DNS 指向

• 在你的域名服务商后台，将子域名（如 n8n）的 A 记录指向服务器公网 IP。(n8n Community)

• 等待记录生效（可能几十分钟至数小时）。

• 如果你要使用 HTTPS ，建议预先设置好与证书申请相关端口（如 80/443 端口可访问）。

3. 安全与访问控制考虑

• n8n 部署后一般含编辑界面、Webhook 触发等入口，建议至少做基本认证。

• n8n 官方文档提醒，自建部署需懂得「配置、服务器管理、资源监控、安全措施」三者。(docs.n8n.io)

• 若是生产环境，更应考虑备份机制、数据库安全、HTTPS、限制外部访问等。

---

二、安装流程

下面以使用 Docker + docker-compose 的方式安装社区版 n8n 为主，步骤简明且通用。你也可参考官方文档其它安装方式。(docs.n8n.io)

1. 登录服务器并更新系统

sudo apt update && sudo apt upgrade -y
sudo apt install -y docker.io docker-compose
sudo systemctl enable docker && sudo systemctl start docker

2. 创建工作目录

例如在根目录下创建 /root/n8n（或任意你希望存放数据的目录）：

mkdir -p /root/n8n
cd /root/n8n

3. 创建 .env 配置文件

在这个目录下创建 .env 文件，示例如下（根据你实际环境修改）：

# 这个目录用于存放 n8n 的数据文件
DATA_FOLDER=/root/n8n/

# 顶域名与子域名
DOMAIN_NAME=example.com
SUBDOMAIN=n8n

# 访问地址将会是：https://n8n.example.com
N8N_BASIC_AUTH_USER=你的用户名
N8N_BASIC_AUTH_PASSWORD=你的密码

# 时区设置（可选，默认纽约时区）
GENERIC_TIMEZONE=Asia/Shanghai

# 用于申请 SSL 证书的邮箱（若使用 Let's Encrypt 或类似方式）
EMAIL_ADDRESS=your-email@example.com

以上示例根据社区帖子整理。(n8n Community)
重要提示：请务必将用户名和密码替换为安全的值，避免默认配置造成安全隐患。

4. 创建 docker-compose.yml 文件

仍然在 /root/n8n 目录下，使用你熟悉的编辑器（如 vim 或 nano）创建 docker-compose.yml，示例如下：

version: "3.8"

services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=${N8N_BASIC_AUTH_USER}
      - N8N_BASIC_AUTH_PASSWORD=${N8N_BASIC_AUTH_PASSWORD}
      - WEBHOOK_TUNNEL_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}
      - VUE_APP_URL_BASE_API=https://${SUBDOMAIN}.${DOMAIN_NAME}/
    volumes:
      - ${DATA_FOLDER}:/home/node/.n8n

这个配置是最简单的社区版 n8n 部署结构。你可以根据需求扩展例如数据库、队列模式（queue mode）、反向代理、HTTPS 等。参考官方文档。(docs.n8n.io)

5. 启动服务

sudo docker-compose up -d

执行后，Docker 会拉取镜像并启动容器。如果一切正常，你可以访问 https://n8n.example.com （替换为你的域名）查看是否可以登录。

6. （可选）设置反向代理 + SSL

如果你想让 n8n 运行在标准 80/443 端口且支持 HTTPS，建议使用 Nginx 或 Caddy 等作为反向代理，再申请免费 SSL 证书（如 Let's Encrypt）。在此处不赘述所有细节，但这一步在生产环境中很重要。

---

三、基本配置与使用

安装完成后，你还应做一些基本配置，优化使用体验。

1. 登录界面

使用你在 .env 中设置的 用户名/密码 登录。建议第一次登录后立即修改相关设置（如密码、用户管理）。

2. 数据库配置（可选）

虽然默认 n8n 会使用 SQLite，但如果你要运行更大规模或生产环境，建议使用 PostgreSQL 或 MySQL 作为后端数据库。社区讨论中也提到：

"Docker without Database: 简单且适合测试；Database-Connected Docker: 提供更好的性能、可扩展性" (Reddit)

你可以在 docker-compose 中新增数据库服务，或使用外部数据库，并通过环境变量进行连接。

3. 访问与Webhook URL

• 确认 WEBHOOK_TUNNEL_URL 和 VUE_APP_URL_BASE_API 已设置为你真实访问域名，否则部分 Webhook 或编辑界面可能无法正常工作。

• 如果你的服务器背后还有反向代理或负载均衡器，确保 n8n 能正确接收外部访问请求。

4. 安全设置

• 启用基本认证（如上已配置）或更强认证方式。

• 限制编辑界面访问来源（如仅特定 IP）。

• 定期更新 n8n 镜像与依赖，避免安全漏洞。

• 定期备份数据文件夹及数据库。

• 若你在离线环境运行，还可以通过配置禁用 Telemetry 等外部请求。(n8n Community)

5. 扩展与维护

• 若你希望运行大量任务、并发多、Webhook 频繁触发，可考虑 queue 模式、多 worker 节点部署。社区有关于 「部署扩展/最佳实践」的讨论。(n8n Community)

• 可监控 Docker 容器资源、数据库状态、Webhook 请求延迟、执行结果等指标。

---

四、升级与运维建议

升级流程

• 停止 n8n 服务（如 docker-compose down）

• 拉取最新镜像（例如 docker-compose pull）

• 启动服务（docker-compose up -d）

• 检查日志和服务状态，确认无异常。

  建议在升级前做备份，以防出现兼容性问题。

备份方案

• 定期备份 DATA_FOLDER（n8n 配置、执行数据）

• 若使用外部数据库，备份 PostgreSQL／MySQL 数据。

• 保留 docker-compose.yml 和 .env 文件快照。

• 定期演练恢复流程。

监控与提示

• 检查服务器磁盘、内存、CPU 使用率。

• 检查 Docker 容器 Logs。

• 监控 n8n 执行失败率、Webhook 延迟、数据库连接情况。

• 若 workflow 逻辑复杂、触发器多、建议增加 Alert、监控系统。

---

五、总结

通过以上步骤，你就可以在自己的服务器上成功部署 n8n 社区版，并开始搭建自己的自动化工作流。虽然过程并不复杂，但生产环境中仍建议关注安全、监控、备份、升级等运维细节。正如官方所言："如果你没经验管理服务器、容器、资源、网络等组件，自建部署可能会带来数据丢失、安全或 downtime 的风险"。(docs.n8n.io)

✨ 若你在部署过程中遇到具体问题（如 docker 日志报错、Webhook 无法访问、数据库连接失败等），欢迎随时告诉我，我可以帮你逐步排查。

祝你部署顺利、自动化飞起来！