首先，分析标题意图：
标题“高并发架构：配置 Redis + n8n Worker 模式实现分布式任务处理”属于典型的“教程/部署/实战/怎么做”类。它不仅要求解释概念（如模式B），更核心的是要求提供具体的配置步骤和架构实现。因此，选择 **模式 A** 进行撰写。

文章将聚焦于如何从零开始搭建这套架构，包含痛点分析、准备工作、具体的 Docker Compose 配置（核心实操）、n8n 后台设置以及避坑指南。

---

还在被 n8n 卡顿折磨？是时候升级你的“引擎”了

兄弟，如果你正在看这篇文章，大概率是遇到了 n8n 的性能瓶颈。笔者见过太多兄弟，工作流跑得好好的，任务量一上来，整个界面就开始转圈圈，甚至直接卡死。为什么？因为默认的 n8n 安装方式是单进程运行的，所有的 Web 界面操作、任务执行、日志记录全挤在同一个进程里。一旦并发任务稍微多点，就像早高峰挤地铁，谁也动不了。

这就是典型的“单机模式”的宿命。但在生产环境中，我们需要的是高可用、高并发。今天，N8N大学 就带大家硬核升级架构，引入业界标准的 Redis 作为消息队列，配合 n8n 的 Worker 模式，搭建一套真正的分布式任务处理系统。这套架构能让你的 n8n 处理能力瞬间提升数倍，而且极度稳定。

准备工作：手里得有“家伙”

在动手之前，咱们得确认一下手里的资源。别到时候代码写好了，环境不支持这就尴尬了。这套架构是基于 Docker Compose 部署的，也是目前最优雅的方案。

你需要准备：

• 一台 Linux 服务器：建议 2核4G 起步，配置太低 Redis 跑不起来。
• Docker & Docker Compose：这是容器化的基础，必须安装好。
• 一个文本编辑器：比如 Vim、Nano 或者 VS Code（远程连接服务器）。

核心实操：手把手配置分布式架构

这部分是全文的精华。我们将通过一个 docker-compose.yml 文件，同时启动 n8n 主进程、Redis 以及多个 n8n Worker 进程。这才是真正的工业化部署。

步骤 1：编写 Docker Compose 配置文件

在你的服务器上新建一个目录，创建一个 docker-compose.yml 文件。不要被代码吓到，N8N大学 已经为你注释好了每一行的含义。

version: '3.8'

services:
  # 1. Redis 服务：我们的消息中转站
  redis:
    image: redis:alpine
    container_name: n8n_redis
    restart: always
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data

  # 2. n8n 主服务 (Web UI + 调度器)
  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n_main
    restart: always
    environment:
      - TZ=Asia/Shanghai
      - N8N_ENCRYPTION_KEY=your_secure_secret_key_here # 必须修改！
      - N8N_PROTOCOL=http
      - WEBHOOK_URL=http://your_server_ip:5678/ # 替换成你的公网IP
      # 关键配置：告诉 n8n 使用 Redis
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - QUEUE_BULL_REDIS_PORT=6379
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - redis

  # 3. n8n Worker 服务 (专门干活的苦力)
  n8n-worker:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n_worker
    restart: always
    environment:
      - TZ=Asia/Shanghai
      - N8N_ENCRYPTION_KEY=your_secure_secret_key_here # 必须和上面一致！
      # 核心模式：只运行 Worker，不跑 Web UI
      - N8N_MODE=worker
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - QUEUE_BULL_REDIS_PORT=6379
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - redis
    # 如果需要高并发，可以在这里增加 replicas 数量
    # deploy:
    #   replicas: 2

volumes:
  n8n_data:
  redis_data:

步骤 2：启动并验证服务

配置写好后，在当前目录下运行启动命令：

docker-compose up -d

等待几分钟，让 Docker 拉取镜像并启动容器。输入 docker ps，你应该能看到三个正在运行的容器：一个 Redis，一个 n8n 主服务，一个 n8n Worker。此时，访问 http://你的服务器IP:5678，熟悉的 n8n 界面就出来了。

步骤 3：在 n8n 后台开启“上帝模式”

光部署好还不够，你得告诉 n8n：“兄弟们，活儿来了，排队干！”

1. 登录 n8n Web 界面。
2. 点击左上角的 Settings (设置) -> Community Nodes (其实这里是去全局设置，新版可能在 User Settings 里找 Execution)。
3. 我们需要通过环境变量彻底开启队列模式。在上面的 docker-compose.yml 中，我们已经设置了 EXECUTIONS_MODE=queue。这步主要是为了确认配置生效。
4. 新建一个工作流，随便跑一个简单的 HTTP Request 或者 Delay 节点。你会发现，主界面的 Log 依然在，但实际的计算任务已经悄悄分配给了 Worker 容器去处理了。

避坑指南：这些坑笔者替你踩过了

配置分布式架构最怕的就是“看着都对，就是跑不通”。下面这两个坑，90% 的人都会遇到。

坑点 1：加密密钥 (Encryption Key) 不一致

在上面的 Docker Compose 配置中，你注意到 N8N_ENCRYPTION_KEY 这个变量了吗？它必须在 n8n 主服务 和 n8n Worker 服务 中完全一致。

原因： Worker 需要解密 Redis 里传过来的任务数据。如果密钥对不上，Worker 就会报错 Error: Could not decrypt data，然后默默失败。这是最隐蔽的错误，因为你表面看日志可能没红字，但任务就是执行不完。

坑点 2：Webhook URL 配置错误

如果你的工作流包含 Webhook 节点，务必配置 WEBHOOK_URL 环境变量。

原因： 在分布式模式下，Webhook 请求是由主节点接收的，但具体的处理逻辑可能由 Worker 执行。如果不显式告诉 n8n 它的公网地址，n8n 生成的 Webhook URL 可能是 localhost:5678，这在外部是无法访问的，导致你的触发器失效。

FAQ 问答

Q1: 我只想用 Worker 模式，不装 Redis 行不行？
不行。Worker 模式的核心就是依赖 Redis 来做任务队列（Queue）。主进程把任务“扔”进 Redis，Worker 进程从 Redis 里“捡”任务。没有 Redis，这就断了链了。

Q2: 我该如何扩展 Worker 的数量？
非常简单。在 Docker Compose 中，找到 n8n-worker 服务，添加 deploy: replicas: 3（或者直接运行 docker-compose up -d --scale n8n-worker=3）。这样你就有了 3 个 Worker 同时在干活，处理速度直接起飞。

Q3: 这种架构会占用很多内存吗？
Redis 本身非常轻量。主要的内存消耗在于 n8n 的 Worker 进程。如果你的工作流经常处理大文件（如解析大 Excel），建议给 Worker 容器多分配点内存限制，或者优化工作流逻辑，避免内存溢出（OOM）。

总结与资源

从单机运行到基于 Redis 的分布式 Worker 架构，是 n8n 从“玩具”走向“生产力工具”的关键一步。这套架构不仅解决了高并发下的卡顿问题，还通过解耦 Web 和执行环节，大大提高了系统的稳定性。N8N大学 建议，只要你开始在生产环境跑重要任务，就请务必花 15 分钟把这套架构搭起来。

推荐阅读：

• n8n 官方文档：Queue Mode 深度解析
• Docker Compose 必备指令速查表
• 如何监控 Redis 队列积压情况