【AI工具箱】n8n：AI工作流自动化平台

n8n 是什么？

想象一下，你有很多重复性的工作需要做：比如每天收集邮件信息整理到表格、或者定时抓取网站数据、又或者让 AI 自动回复客户消息。如果手动操作，既费时又枯燥。

n8n 就像是你的"数字员工"，它可以：

• 🤖 自动完成重复性任务（比如每天早上 9 点发送天气预报到你的微信）
• 🔗 连接不同的软件（把 A 软件的数据自动传到 B 软件）
• 🧠 集成 AI 能力（让 ChatGPT 帮你自动处理文档、回复邮件）

全程自动，不需要你动手！

官方文档： https://docs.n8n.io/^[1]

安装教程

如何选择安装方式？

就像买车有不同配置，n8n 也有三种"配置"可选：

• 方式一（PM2本地部署）：就像自己组装电脑，自由度高，适合喜欢折腾的人
- • ✅ 适合人群：有一定电脑基础，想深入了解的
- • ❌ 不适合：完全零基础，怕麻烦的
• 方式二（Docker官方镜像）：就像买品牌电脑，开箱即用，最省心 ⭐推荐新手
- • ✅ 适合人群：想快速上手，不想折腾的
- • ✅ 最大优点：一键安装，出问题也好解决
• 方式三（Docker自定义镜像）：就像改装车，需要特殊功能才用
- • ✅ 适合人群：需要处理音视频、爬网页等特殊需求的
- • ❌ 不适合：普通使用的（用方式二就够了）

新手建议：直接看"方式二"，最简单！

方式一：本地 PM2 部署（适合开发和小规模使用）

优点：直接运行在本地，方便调试和开发
缺点：需要手动管理依赖和服务

1. 前置条件

确保本地已安装以下工具：

• Node.js（v22+）
- • 下载：https://nodejs.org/
• pm2（进程管理工具）
```
npm install pm2 -g
```
• n8n（核心服务）
```
npm install n8n -g
```

2. 配置 PM2

创建配置文件 ecosystem.config.js：

module.exports = {
  apps: [
    {
      name: 'n8n',
      script: 'n8n',
      args: 'start',
      env: {
        N8N_PORT: 5678
      }
    }
  ]
};

3. 启动服务

pm2 start ecosystem.config.js

4. 服务管理命令

# 查看服务状态
pm2 status

# 查看日志
pm2 logs n8n

# 重启服务
pm2 restart ecosystem.config.js

# 停止服务
pm2 stop ecosystem.config.js

# 停止并删除服务
pm2 delete ecosystem.config.js

# 设置开机自启动
pm2 startup
pm2 save

5. 访问 n8n

浏览器访问：http://localhost:5678

方式二：Docker 官方镜像（⭐推荐新手，最简单！）

为什么推荐这个方式？

想象 Docker 是一个"集装箱"，把 n8n 和它需要的所有东西都打包在一起。你只需要：

1. 下载这个"集装箱"
2. 一键启动
3. 就能用了！

优点：

• ✅ 超级简单，不用自己装一堆软件
• ✅ 出问题好解决，网上教程多
• ✅ 适合长期使用

缺点：

• ⚠️ 需要先装 Docker（但很简单，10分钟搞定）

1. 前置条件

只需要装一个东西：Docker

• **Docker 是什么？**就像一个"虚拟容器"，可以在里面运行各种程序
• 怎么装？
- • Windows/Mac：去 https://www.docker.com/ 下载 Docker Desktop，一路"下一步"就行
- • 装完 Docker 20.10+ 版本，Docker Compose 会自动带上（不用单独装）

2. 创建配置文件

创建 docker-compose.yml：

version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    ports:
      - "5678:5678"
    volumes:
      - ./n8n-data:/home/node/.n8n
    restart: unless-stopped

3. 启动服务

准备工作：

1. 确保你在刚才创建 docker-compose.yml 文件的那个文件夹里
2. 打开终端（命令行）

一键启动：

# Docker Compose V2（推荐，新版本用这个）
docker compose up -d

# 旧版 Docker Compose（如果上面不行，用这个）
docker-compose up -d

如果看到报错怎么办？

• 确认 Docker 是不是在运行（Windows 看托盘图标）
• 把错误信息复制到百度/Google 搜索

4. 管理命令

# 查看服务状态
docker compose ps

# 查看日志
docker compose logs -f n8n

# 重启服务
docker compose restart

# 停止服务
docker compose down

# 停止并删除数据（谨慎）
docker compose down -v

5. 访问 n8n（见证奇迹！）

打开浏览器，在地址栏输入：

http://localhost:5678

如果打开了，恭喜你成功了！ 🎉

第一次打开会让你注册账号，这个账号只存在你的电脑上，放心填写就行。

如果打不开：

• 等1-2分钟再试（可能还在启动）
• 检查 Docker 是否在运行
• 看看是不是端口被占用了（换个端口试试）

方式三：Docker 自定义镜像（适合需要额外工具的场景）

什么时候用这个方式？

如果你的工作流需要：

• 🎬 处理音频视频（比如自动剪辑、转换格式）
• 🕷️ 爬取网页内容（比如抓取电商价格）
• 🖼️ 处理图片（比如加水印、压缩）

那就需要这个"加强版"。普通使用的话，用方式二就够了，不用看这个！

1. 创建 Dockerfile

FROM n8nio/n8n:latest

USER root

# 安装系统工具和依赖
RUN apk add --no-cache \
    ffmpeg \
    chromium \
    nss \
    freetype \
    harfbuzz \
    ca-certificates \
    ttf-freefont \
    fontconfig \
    wqy-zenhei

# 安装中文字体
RUN apk add --no-cache --virtual .build-deps \
    wget \
    && wget -O /tmp/fonts.zip https://github.com/source-foundry/Hack/releases/download/v3.003/Hack-v3.003-ttf.zip \
    && unzip /tmp/fonts.zip -d /usr/share/fonts/truetype/ \
    && rm /tmp/fonts.zip \
    && fc-cache -f -v \
    && apk del .build-deps

# 设置 Chromium 环境变量
ENV CHROME_BIN=/usr/bin/chromium-browser
ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser

USER node

2. 构建镜像

docker build -t n8n-allinone:latest .

验证镜像：

docker images | grep n8n-allinone

3. 创建 docker-compose.yml

使用上面"方式二"的配置，将所有 image: n8nio/n8n:latest 改为 image: n8n-allinone:latest

4. 启动服务

docker compose up -d

5. 验证自定义工具

在 n8n 中创建「Execute Command」节点，测试：

# 测试 ffmpeg
ffmpeg -version

# 测试 chromium
chromium-browser --version

# 测试中文字体
fc-list :lang=zh

6. 更新镜像

修改 Dockerfile 后重新构建：

docker build -t n8n-allinone:latest .
docker compose down
docker compose up -d

汉化方案（看不懂英文？教你变中文！）

**新手常见问题：**打开 n8n 全是英文，看不懂怎么办？

💡 别担心！有两个办法把界面变成中文：

n8n 默认是英文界面，如果需要中文界面，有以下两种方案：

方案一：替换编辑器文件（彻底汉化，推荐）

这个方案做什么？
把 n8n 的英文界面文件换成中文版，所有用户打开都是中文。

项目地址： https://github.com/other-blowsnow/n8n-i18n-chinese

Docker 部署汉化步骤

1. 下载汉化包
从上述 GitHub 仓库下载 editor-ui.tar.gz 文件
2. 解压文件
将 editor-ui.tar.gz 解压到 docker-compose.yml 所在目录，得到 dist 文件夹

3. 修改 docker-compose.yml
在 n8n-main 服务中添加以下配置：

n8n-main:
  image: n8nio/n8n:latest
  environment:
    N8N_DEFAULT_LOCALE: zh-CN  # 启用中文
  volumes:
    - ./app-data:/home/node/.n8n
    - ./dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist  # 挂载汉化文件

4. 重启服务

docker compose down
docker compose up -d

PM2 本地部署汉化步骤

1. 找到 n8n-editor-ui 目录
查找 n8n 安装路径下的 n8n-editor-ui/dist 目录：

# Windows 示例路径
C:\Users\你的用户名\AppData\Roaming\npm\node_modules\n8n\node_modules\n8n-editor-ui\dist

# Mac/Linux 示例路径
/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist

2. 备份并替换 dist

# 备份原文件
mv dist dist.backup

# 将下载的汉化 dist 文件夹复制到此处
cp -r /path/to/downloaded/dist ./

3. 修改 ecosystem.config.js
在环境变量中添加：

env: {
  N8N_DEFAULT_LOCALE: "zh-CN",  // 启用中文
  // ... 其他配置
}

4. 重启服务

pm2 restart ecosystem.config.js

方案二：使用油猴子脚本

这个方案做什么？
不改 n8n 文件，只在你的浏览器里"翻译"界面。就像看网页时用翻译插件一样。

优点：

• ✅ 超级简单
• ✅ 不会破坏 n8n
• ✅ 适合个人使用

使用步骤（跟着做，3 步搞定！）

第一步：安装"油猴"扩展

💡 **油猴是什么？**就像一个"脚本管理器"，可以给浏览器加各种功能。

• Chrome/Edge 浏览器：
1. 1. 打开 Tampermonkey官网^[2]
2. 2. 点击"下载"→"Chrome"
3. 3. 安装后，浏览器右上角会出现一个小图标
• Firefox 浏览器：
1. 1. 打开 Greasemonkey官网^[3]
2. 2. 点击"添加到 Firefox"

第二步：安装汉化脚本

1. 打开脚本地址：https://greasyfork.org/zh-CN/scripts/490750-n8n-中文脚本/^[4]
2. 点击绿色的"安装此脚本"按钮
3. 在弹出窗口再点一次"安装"

第三步：刷新页面

重新打开 n8n 界面（http://localhost:5678），界面就变中文了！

优点：

• ✅ 无需修改 n8n 文件
• ✅ 安装简单，适合快速体验
• ✅ 不影响 n8n 升级

缺点：

• ⚠️ 需要在每个浏览器上单独安装
• ⚠️ 翻译可能不如方案一完整

进阶技巧

Windows 安装社区节点失败怎么办？

什么是社区节点？
n8n 有很多第三方开发的功能扩展（节点），比如微信公众号、钉钉等国内应用的节点。有时候在 Windows 上通过界面安装会失败。

解决办法：手动安装

💡 适用场景：在 n8n 界面安装节点时提示失败，或者一直转圈安装不上。

操作步骤：

# 1. 进入 n8n 自定义节点目录
cd "C:\Users\user\.n8n\nodes"

# 2. 如果目录不存在，先创建
mkdir C:\Users\user\.n8n\nodes -Force
cd C:\Users\user\.n8n\nodes

# 3. 初始化 npm（如果没有 package.json）
npm init -y

# 4. 直接安装节点包（以微信公众号节点为例）
npm install n8n-nodes-wechat-offiaccount

# 5. 重启 n8n

如何找节点包名？

• 去 n8n 社区论坛：https://community.n8n.io/
• 或者 npm 搜索：https://www.npmjs.com/search?q=n8n-nodes

使用 MCP 协议连接 n8n

什么是 MCP？
MCP（Model Context Protocol）是一个让 AI 助手（如 Claude、Windsurf）能够直接操作 n8n 的协议。简单说，就是让 AI 帮你创建和管理 n8n 工作流。

项目地址： https://github.com/czlonkowski/n8n-mcp

适用场景：

• 你在用支持 MCP 的 AI 工具（如 Claude Desktop、Windsurf）
• 想让 AI 帮你自动创建 n8n 工作流
• 通过聊天方式管理 n8n

配置方法：

在你的 MCP 配置文件中添加（通常是 claude_desktop_config.json 或 .windsurf/mcp.json）：

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "你的n8n API密钥"
      }
    }
  }
}

重要配置说明：

1. N8N_API_URL：你的 n8n 访问地址
- • 本地部署：http://localhost:5678
- • 服务器部署：http://你的服务器IP:5678
2. N8N_API_KEY：n8n 的 API 密钥
- • **如何获取？**在 n8n 界面中：
  1. 1. 点击右上角头像
  2. 2. 选择"Settings"（设置）
  3. 3. 点击"API"
  4. 4. 点击"Create API Key"（创建 API 密钥）
  5. 5. 复制生成的密钥

配置完成后：

• 重启你的 AI 工具
• 就可以用自然语言让 AI 帮你操作 n8n 了
• 比如："帮我创建一个每天早上 9 点发送邮件的工作流"

💡 建议：这是高级功能，新手可以先不用，等熟悉 n8n 基本操作后再尝试。

引用链接

[1] https://docs.n8n.io/: https://docs.n8n.io
[2] Tampermonkey官网: https://www.tampermonkey.net/
[3] Greasemonkey官网: https://addons.mozilla.org/zh-CN/firefox/addon/greasemonkey/
[4] https://greasyfork.org/zh-CN/scripts/490750-n8n-中文脚本/: https://greasyfork.org/zh-CN/scripts/490750-n8n-中文脚本