1. 引言
在前两篇文章中，我们已经了解了n8n的基本概念和核心组件。现在，是时候动手实践，将这个强大的工作流自动化平台部署到您自己的环境中了。
n8n提供了多种安装方式，适应不同的需求和技术环境。本文将详细介绍各种安装选项，帮助您选择最适合自己情况的方法，并提供每种方法的详细步骤和最佳实践。同时，我们还将探讨数据库配置、安全设置以及常见问题的解决方案，确保您能够顺利地完成n8n的部署和配置。
2. 系统要求与准备工作
在开始安装n8n之前，了解系统要求并做好准备工作是确保安装顺利进行的关键。
2.1 硬件要求
n8n的硬件要求相对适中，但会根据您的使用规模和工作流复杂度而变化：
CPU：最低建议2核，生产环境建议4核或更多
内存：最低512MB，推荐2GB或更多（特别是对于复杂工作流或高并发场景）
存储：至少1GB可用空间（不包括数据库存储需求）
2.2 软件要求
n8n基于Node.js构建，因此需要以下软件环境：
Node.js：v16.9或更高版本（推荐使用LTS版本）
npm：v7或更高版本
数据库：默认使用SQLite，也支持PostgreSQL（推荐用于生产环境）
2.3 网络要求
端口：默认使用5678端口，确保该端口可用
网络连接：如果您的工作流需要访问外部服务，请确保有稳定的互联网连接
防火墙设置：如果您计划从外部访问n8n，需要配置防火墙允许相应端口的访问
2.4 准备工作清单
在开始安装前，请完成以下准备工作：
确认系统满足最低要求：检查CPU、内存和存储空间
安装Node.js和npm：访问Node.js官网下载并安装适合您系统的版本
准备数据库（可选）：如果计划使用PostgreSQL，请预先安装并创建数据库
检查网络设置：确保所需端口开放，网络连接正常
准备域名（可选）：如果计划公开访问，建议准备一个域名并配置DNS
准备SSL证书（可选）：生产环境建议使用HTTPS，需要准备SSL证书
3. 安装方式对比
n8n提供了多种安装方式，每种方式都有其优缺点。以下是主要安装方式的对比：
3.1 npm全局安装
优点：
安装简单快捷
适合快速测试和开发
直接使用本地文件系统
缺点：
依赖本地Node.js环境
可能与其他Node.js应用产生依赖冲突
不适合多用户生产环境
适用场景：个人开发环境、快速测试
3.2 Docker容器化部署
优点：
环境隔离，避免依赖冲突
易于在不同环境间迁移
便于集成到现有容器化基础设施
简化版本管理和升级
缺点：
需要了解Docker基础知识
配置稍复杂
可能需要额外的存储卷配置
适用场景：团队开发环境、生产部署、需要隔离的环境
3.3 二进制文件安装
优点：
无需安装Node.js环境
部署简单
适合不熟悉Node.js的用户
缺点：
不支持所有平台
更新可能不如其他方式及时
自定义配置相对有限
适用场景：简单的个人使用、不熟悉Node.js的用户
3.4 云服务（n8n.cloud）
优点：
无需自行维护服务器
自动更新到最新版本
内置高可用性和备份
专业支持
缺点：
需要付费订阅
数据存储在云端
自定义选项可能有限
适用场景：企业用户、需要高可用性的场景、不想自行维护基础设施的用户
4. 详细安装步骤
4.1 使用npm安装
npm安装是最直接的方式，适合快速开始使用n8n：
安装Node.js和npm（如果尚未安装）
# 在Linux上使用nvm安装Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
nvm install --lts
# 在Windows上，直接从官网下载安装包
# https://nodejs.org/
全局安装n8n
npm install n8n -g
启动n8n
n8n
访问n8n界面
打开浏览器，访问 http://localhost:5678
4.2 使用Docker安装
Docker安装提供了更好的隔离性和可移植性：
安装Docker（如果尚未安装）
Docker Desktop for Windows/Mac
Linux安装指南
创建数据卷（用于持久化数据）
docker volume create n8n_data
运行n8n容器
docker run -it --rm
--name n8n
-p 5678:5678
-v n8n_data:/home/node/.n8n
docker.n8n.io/n8nio/n8n
访问n8n界面
打开浏览器，访问 http://localhost:5678
4.3 使用Docker Compose安装
对于需要更复杂配置的环境，特别是需要集成PostgreSQL的场景，Docker Compose是更好的选择：
创建docker-compose.yml文件
version: '3'
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: always
ports:
- "5678:5678"
environment:
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=n8n
- N8N_HOST=${
N8N_HOST}
- NODE_ENV=production
- N8N_ENCRYPTION_KEY=${
N8N_ENCRYPTION_KEY}
volumes:
- n8n_data:/home/node/.n8n
depends_on:
- postgres
postgres:
image: postgres:13
restart: always
environment:
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=n8n
- POSTGRES_DB=n8n
volumes:
- postgres_data:/var/lib/postgresql/data
volumes:
n8n_data:
postgres_data:
创建.env文件（用于存储敏感配置）
N8N_HOST=localhost
N8N_ENCRYPTION_KEY=your-random-encryption-key
启动服务
docker-compose up -d
访问n8n界面
打开浏览器，访问 http://localhost:5678
5. 数据库选择与配置
n8n支持两种主要的数据库选项：SQLite（默认）和PostgreSQL。选择合适的数据库对于性能和可靠性至关重要。
5.1 SQLite（默认）
SQLite是n8n的默认数据库，无需额外配置即可使用。
优点：
零配置，开箱即用
适合小型部署和个人使用
数据存储在单个文件中，便于备份
缺点：
不适合高并发场景
不支持分布式部署
性能可能成为瓶颈
配置示例（默认配置，无需特别设置）：
# 使用npm安装时，SQLite数据库文件位于
~/.n8n/database.sqlite
# 使用Docker安装时，确保挂载数据卷以持久化数据
docker run -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
5.2 PostgreSQL
对于生产环境和团队使用场景，PostgreSQL是更好的选择。
优点：
更好的性能和可靠性
支持高并发访问
适合大规模部署
强大的备份和恢复功能
缺点：
需要额外安装和配置
资源消耗相对较高
配置示例：
环境变量配置
# 使用npm安装时的环境变量设置
export DB_TYPE=postgresdb
export DB_POSTGRESDB_DATABASE=n8n
export DB_POSTGRESDB_HOST=localhost
export DB_POSTGRESDB_PORT=5432
export DB_POSTGRESDB_USER=n8n
export DB_POSTGRESDB_PASSWORD=n8n
export DB_POSTGRESDB_SCHEMA=public
# 然后启动n8n
n8n
Docker环境变量配置
docker run -it --rm
--name n8n
-p 5678:5678
-e DB_TYPE=postgresdb
-e DB_POSTGRESDB_DATABASE=n8n
-e DB_POSTGRESDB_HOST=postgres
-e DB_POSTGRESDB_PORT=5432
-e DB_POSTGRESDB_USER=n8n
-e DB_POSTGRESDB_PASSWORD=n8n
-v n8n_data:/home/node/.n8n
docker.n8n.io/n8nio/n8n
5.3 数据库迁移
如果您从SQLite迁移到PostgreSQL，可以使用n8n的导出/导入功能：
导出现有数据
n8n export:workflow --all
n8n export:credentials --all
配置新数据库连接
导入数据到新数据库
n8n import:workflow --input=workflows.json
n8n import:credentials --input=credentials.json
6. 基础配置选项与环境变量
n8n提供了丰富的配置选项，可以通过环境变量进行设置。以下是一些常用的基础配置：
6.1 基本设置
# 设置n8n监听的端口（默认5678）
N8N_PORT=5678
# 设置n8n的基础URL（用于生成webhook URL等）
N8N_HOST=localhost
N8N_PROTOCOL=http
N8N_PATH=/
# 设置时区
GENERIC_TIMEZONE=Europe/Berlin
# 设置默认语言
N8N_DEFAULT_LOCALE=zh-CN
6.2 安全相关配置
# 设置加密密钥（重要：用于加密凭证）
N8N_ENCRYPTION_KEY=your-secure-encryption-key
# 启用用户管理
N8N_USER_MANAGEMENT_DISABLED=false
# 设置JWT密钥（用于用户认证）
N8N_JWT_AUTH_ACTIVE=true
N8N_JWT_AUTH_HEADER=Authorization
N8N_JWT_AUTH_HEADER_VALUE_PREFIX=Bearer
# 设置Cookie安全选项
N8N_SECURE_COOKIE=true
N8N_SAMESITE_COOKIE=lax
6.3 执行相关配置
# 设置最大执行时间（毫秒）
N8N_EXECUTIONS_TIMEOUT=300000
# 设置执行数据保留策略
N8N_EXECUTIONS_DATA_SAVE_ON_ERROR=all
N8N_EXECUTIONS_DATA_SAVE_ON_SUCCESS=all
N8N_EXECUTIONS_DATA_SAVE_ON_PROGRESS=true
N8N_EXECUTIONS_DATA_PRUNE=true
N8N_EXECUTIONS_DATA_MAX_AGE=336
# 设置执行并发数
N8N_EXECUTIONS_PROCESS=main
N8N_EXECUTION_CONCURRENCY=4
6.4 配置文件方式
除了环境变量，n8n还支持通过.env文件或配置文件进行配置：
使用.env文件
在n8n工作目录创建.env文件：
N8N_PORT=5678
N8N_ENCRYPTION_KEY=your-secure-encryption-key
DB_TYPE=postgresdb
DB_POSTGRESDB_DATABASE=n8n
# 其他配置...
使用配置文件
创建config.json文件：
{
"port": 5678,
"encryptionKey": "your-secure-encryption-key",
"database": {
"type": "postgresdb",
"postgresdb": {
"database": "n8n",
"host": "localhost",
"port": 5432,
"user": "n8n",
"password": "n8n"
}
}
}
然后使用--config参数启动：
n8n start --config=config.json
7. 安全设置与访问控制
保护您的n8n实例安全至关重要，特别是在生产环境中。以下是一些关键的安全设置：
7.1 用户认证与管理
n8n提供了内置的用户管理功能，可以通过以下步骤启用：
启用用户管理
N8N_USER_MANAGEMENT_DISABLED=false
设置初始用户
# 设置初始管理员用户
N8N_DEFAULT_USER_EMAIL=admin@example.com
N8N_DEFAULT_USER_PASSWORD=securepassword
N8N_DEFAULT_USER_FIRSTNAME=Admin
N8N_DEFAULT_USER_LASTNAME=User
配置密码策略（可选）
N8N_USER_PASSWORD_POLICY_ACTIVE=true
N8N_USER_PASSWORD_POLICY_MIN_LENGTH=8
N8N_USER_PASSWORD_POLICY_REQUIRE_SPECIAL_CHARACTERS=true
7.2 启用HTTPS
在生产环境中，强烈建议使用HTTPS保护通信安全：
使用反向代理（推荐）
使用Nginx或Apache作为反向代理，处理SSL终结：
Nginx配置示例：
server {
listen 443 ssl;
server_name n8n.example.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://localhost:5678;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
直接配置n8n使用SSL
N8N_PROTOCOL=https
N8N_SSL_KEY=/path/to/key.pem
N8N_SSL_CERT=/path/to/cert.pem
7.3 API访问控制
控制对n8n API的访问：
# 禁用公共API访问
N8N_PUBLIC_API_DISABLED=true
# 设置API访问密钥
N8N_API_REST_ACCESS_KEY=your-secure-api-key
7.4 文件访问限制
限制n8n对文件系统的访问：
# 限制文件访问范围
N8N_RESTRICT_FILE_ACCESS_TO=/data,/tmp
# 阻止访问n8n配置文件
N8N_BLOCK_FILE_ACCESS_TO_N8N_FILES=true
8. 常见安装问题与解决方案
在安装和配置n8n的过程中，可能会遇到一些常见问题。以下是这些问题的解决方案：
8.1 端口冲突
问题：启动n8n时报错”端口5678已被占用”
解决方案：
找出占用端口的进程：
# Linux/Mac
lsof -i :5678
# Windows
netstat -ano | findstr :5678
终止该进程或更改n8n端口：
# 更改n8n端口
N8N_PORT=5679 n8n
8.2 数据库连接问题
问题：无法连接到PostgreSQL数据库
解决方案：
检查数据库服务是否运行
验证连接参数（主机、端口、用户名、密码）
确认数据库用户有足够权限
检查网络连接和防火墙设置
查看PostgreSQL日志获取详细错误信息
8.3 加密密钥问题
问题：更改加密密钥后，无法访问之前保存的凭证
解决方案：
n8n使用加密密钥来加密凭证，更改密钥后之前的凭证将无法解密
在更改加密密钥前，导出所有凭证：
n8n export:credentials --all
更改密钥后，重新导入凭证：
n8n import:credentials --input=credentials.json
8.4 内存不足问题
问题：n8n运行一段时间后崩溃，日志显示内存不足
解决方案：
增加Node.js内存限制：
# 使用npm安装时
NODE_OPTIONS=--max-old-space-size=4096 n8n
# 使用Docker时
docker run -e NODE_OPTIONS="--max-old-space-size=4096" docker.n8n.io/n8nio/n8n
优化工作流，减少内存使用
考虑使用更强大的服务器
8.5 Docker数据持久化问题
问题：重启Docker容器后，所有数据丢失
解决方案：
确保正确挂载数据卷：
docker volume create n8n_data
docker run -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
使用Docker Compose时，确保定义了卷：
volumes:
n8n_data:
8.6 Webhook URL问题
问题：Webhook触发器生成的URL无法从外部访问
解决方案：
正确设置基础URL：
N8N_HOST=your-domain.com
N8N_PROTOCOL=https
确保防火墙和网络配置允许外部访问
如果使用反向代理，确保正确配置了代理设置
9. 总结
本文详细介绍了n8n的安装与配置过程，从系统要求到不同的安装方式，再到数据库配置、基础设置和安全措施。通过遵循本文提供的指南，您应该能够成功地在自己的环境中部署n8n，并根据自己的需求进行定制配置。
n8n的灵活性使其能够适应各种部署场景，从个人开发环境到企业级生产部署。选择合适的安装方式和配置选项，将帮助您充分发挥n8n的潜力，构建强大的自动化工作流。
10. 参考资源
n8n官方文档
n8n Docker安装指南
n8n环境变量参考
n8n数据库配置
n8n安全最佳实践
n8n社区论坛
暂无评论内容