SeigRobotics1. n8n与外部执行器架构解析
n8n作为一款开源工作流自动化工具，其核心价值在于将不同系统的API连接成自动化流程。2.9.2版本引入了关键的外部执行器(External Executor)功能，这种架构设计将工作流编排与任务执行分离，带来三个显著优势：
- 资源隔离：执行器节点可独立部署，避免核心服务受资源密集型任务影响
- 横向扩展：通过增加执行器节点即可提升任务并发处理能力
- 安全增强：敏感操作限制在执行器环境，降低主系统风险
典型企业级部署会采用"1个主节点+N个执行器"的拓扑结构。主节点负责UI展示、工作流设计等轻量操作，而图像处理、视频转码等重负载任务则自动路由到执行器节点。
注意：执行器节点需要开放5701端口供主节点通信，企业内网部署需确保防火墙规则允许该端口TCP连接
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Docker部署环境准备
2.1 基础环境配置
推荐使用Docker 20.10+版本，实测在以下环境通过验证：
- Linux：Ubuntu 22.04 LTS（内核5.15+）
- Windows：WSL2 + Docker Desktop 4.12+
- macOS：Docker Desktop 4.15+（M1/M2需Rosetta转译）
关键依赖检查命令：
bash复制# 检查Docker版本
docker --version
# 检查docker-compose插件
docker compose version
# 验证虚拟化支持（Windows/macOS）
systeminfo | find "Hyper-V" # Windows
sysctl kern.hv_support # macOS
2.2 目录结构规划
建议采用以下标准化目录结构：
code复制/n8n-deploy/
├── docker-compose.yml # 主服务编排文件
├── executor/
│ ├── docker-compose.yml # 执行器专用编排
│ └── config/
│ └── n8n-executor.json
├── data/
│ ├── postgres/ # 数据库持久化
│ └── n8n/ # 工作流数据
└── traefik/ # 反向代理配置
3. 主服务Docker-Compose配置详解
3.1 核心服务定义
yaml复制version: '3.8'
services:
n8n:
image: n8nio/n8n:2.9.2
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_PROTOCOL=https
- N8N_HOST=workflow.yourdomain.com
- DB_TYPE=postgresdb
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=your_strong_password
- N8N_EXECUTIONS_MODE=queue
- EXECUTIONS_PROCESS=main
- N8N_BASIC_AUTH_ACTIVE=true
- N8N_BASIC_AUTH_USER=admin
- N8N_BASIC_AUTH_PASSWORD=secure_password
volumes:
- ./data/n8n:/home/node/.n8n
depends_on:
- postgres
postgres:
image: postgres:13-alpine
restart: unless-stopped
environment:
- POSTGRES_DB=n8n
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=your_strong_password
volumes:
- ./data/postgres:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U n8n"]
interval: 10s
timeout: 5s
retries: 5
3.2 关键参数解析
-
执行模式配置：
EXECUTIONS_PROCESS=main：指定当前节点为主控节点N8N_EXECUTIONS_MODE=queue：启用队列模式提升高并发稳定性
-
安全增强设置：
yaml复制- N8N_BASIC_AUTH_ACTIVE=true # 强制启用基础认证 - GENERIC_TIMEZONE=Asia/Shanghai # 时区配置 - N8N_DIAGNOSTICS_ENABLED=false # 生产环境关闭诊断 -
性能调优参数：
yaml复制- N8N_MAX_EXECUTION_TIMEOUT=3600 # 任务超时(秒) - N8N_DISABLE_PRODUCTION_MAIN_PROCESS=false
4. 外部执行器部署实战
4.1 执行器节点配置
创建executor/docker-compose.yml：
yaml复制version: '3.8'
services:
n8n-executor:
image: n8nio/n8n:2.9.2
restart: unless-stopped
environment:
- EXECUTIONS_PROCESS=worker
- N8N_PROTOCOL=http
- N8N_HOST=executor01
- QUEUE_BULL_REDIS_HOST=redis
- QUEUE_BULL_REDIS_DB=0
- N8N_LOG_LEVEL=verbose
volumes:
- ./config/n8n-executor.json:/home/node/.n8n/config.json
depends_on:
- redis
redis:
image: redis:6-alpine
restart: unless-stopped
command: redis-server --save 60 1 --loglevel warning
volumes:
- redis_data:/data
volumes:
redis_data:
4.2 执行器连接配置
config/n8n-executor.json示例：
json复制{
"executions": {
"process": "worker",
"worker": {
"queueMode": "redis",
"redis": {
"host": "redis",
"db": 0
}
}
},
"generic": {
"timezone": "Asia/Shanghai"
}
}
4.3 主节点连接配置
在主服务配置中追加：
yaml复制environment:
- QUEUE_BULL_REDIS_HOST=redis
- QUEUE_BULL_REDIS_DB=0
- N8N_QUEUE_BULL_REDIS_CONNECTION_TIMEOUT=30000
5. 集群网络与安全配置
5.1 自定义Docker网络
创建专用网络提升安全性：
bash复制docker network create --driver bridge --subnet 172.28.0.0/16 n8n_net
在compose文件中添加：
yaml复制networks:
default:
external: true
name: n8n_net
5.2 防火墙规则建议
| 方向 | 协议 | 端口 | 源/目标 | 用途 |
|---|---|---|---|---|
| 入站 | TCP | 5678 | 客户端 | n8n Web访问 |
| 入站 | TCP | 5701 | 执行器节点 | Hazelcast通信 |
| 出站 | TCP | 5432 | Postgres | 数据库连接 |
6. 运维监控与排错指南
6.1 健康检查端点
主节点监控端点：
http://localhost:5678/healthz- 服务健康状态http://localhost:5678/metrics- Prometheus格式指标
执行器节点检查命令：
bash复制docker exec -it n8n-executor curl localhost:5678/healthz
6.2 常见问题排查
问题1：执行器节点无法连接Redis
log复制ERROR: Failed to connect to Redis at redis:6379: Connection refused
解决方案：
- 检查Redis容器是否正常运行
- 验证网络连通性：
bash复制docker run --rm --network n8n_net busybox ping redis
问题2：主节点工作流未分发
log复制WARN: No available workers found for execution
检查步骤：
- 确认执行器
EXECUTIONS_PROCESS=worker设置正确 - 检查Redis连接配置：
bash复制docker exec -it n8n-executor redis-cli -h redis KEYS '*'
7. 性能优化实战技巧
7.1 资源限制配置
yaml复制# 主节点资源限制
deploy:
resources:
limits:
cpus: '2'
memory: 4G
# 执行器节点资源配置
n8n-executor:
deploy:
resources:
limits:
cpus: '4'
memory: 8G
7.2 数据库优化参数
Postgres配置追加：
yaml复制environment:
- POSTGRES_SHARED_BUFFERS=1GB
- POSTGRES_EFFECTIVE_CACHE_SIZE=3GB
- POSTGRES_MAX_WORKER_PROCESSES=8
7.3 日志轮转配置
在n8n服务中添加：
yaml复制logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "5"