n8n 的基础安装分享

[leia]

n8n 是什么

n8n 的名字来源于 “node to node” （节点到节点），发音是 “n-eight-n”。听起来有点怪，但你可以把它简单理解为一个低代码工作流平台——而且是非常强的那种。

n8n （读作“n-eight-n”）是一个开源、低代码的工作流自动化平台，旨在帮助用户通过可视化界面快速构建和自动化复杂的工作流程。它允许用户连接不同的应用程序、服务和数据源，实现数据和任务的自动化处理，减少手动操作，提高效率。以下是关于 n8n 的核心特点和功能的概述

核心特点

1. ​开源与自托管​：
   1. n8n 是基于公平代码（ fair-code ）许可的开源工具，用户可以免费自托管，拥有对数据和基础设施的完全控制，适合注重隐私和安全的企业。
   2. 提供云托管版本（ n8n.cloud ），适合不想自己维护服务器的用户。
2. ​节点式架构​：
   1. n8n 使用节点（ nodes ）来构建工作流，每个节点代表一个触发器（ trigger ）或动作（ action ），如发送邮件、调用 API 或处理数据。用户通过拖放界面连接节点，创建自动化流程。
   2. 支持触发节点（基于事件或时间调度）和动作节点（执行特定任务，如数据转换或通知）。
3. ​广泛的集成能力​：
   1. 支持超过 400 种应用程序和服务的集成，包括 Google Sheets 、Slack 、Airtable 、OpenAI 等，允许无缝连接各种工具。
   2. 对于未内置的应用，用户可通过 HTTP 请求节点调用任何具有 API 的工具。
4. ​低代码与代码灵活性​：
   1. 提供直观的拖放界面，适合非开发人员快速构建工作流。
   2. 同时支持 JavaScript 和 Python 代码，开发者可通过代码节点实现高级自定义逻辑。
5. ​AI 原生支持​：
   1. 内置 AI 功能，支持与大型语言模型（如 OpenAI 的 GPT-4.5 、Claude 等）集成，可用于内容生成、数据分类或构建 AI 代理。
   2. 支持 RAG （检索增强生成）系统，结合向量数据库处理外部数据。
6. ​社区与模板​：
   1. 提供超过 900 个现成的工作流模板，社区贡献丰富，方便新用户快速上手。
   2. 活跃的社区支持用户分享模板和解决问题。

部署方式

Docker n8n 中文版部署

步骤 1：安装 Docker 桌面版

步骤 2：拉取 n8n 镜像

打开 Docker Desktop ，搜索 n8nio/n8n，点击 pull 拉取镜像。

步骤 3：运行容器

按照官方示例配置运行

在 logs 中会出现本地链接，点击就能访问了。

中文汉化

浏览器打开：http://localhost:5678，需要输入账号密码（​这里的用户名密码随便填​），邮箱一定要真实的，便于后续可通过发送到邮箱的 key 进行免费认证使用完整付费服务

汉化操作：

下载n8n 中文汉化包

解压到本地目录

使用带中文配置的 Docker 命令运行

docker run -it --rm --name n8ntest \
-p 15678:5678 \
-v  [替换为下载的编辑器 UI 目录] :/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist \
-e N8N_DEFAULT_LOCALE=zh-CN \
-e N8N_SECURE_COOKIE=false \
n8nio/n8n

npx 本地启动 n8n 替换安装汉化

找到路径：C:\Users\xxxxxx\AppData\Local\npm-cache_npx\n8n\node_modules\n8n-editor-ui\dist
下载对应版本 editor-ui.tar.gz 文件
解压到 dist 目录下替换
设置环境变量 N8N_DEFAULT_LOCALE=zh-CN ，自行咨询 AI 设置方法
重启 n8n 服务

Windwos 配置环境变量

N8N_DEFAULT_LOCALE
zh-CN

Npx n8n 安装和部署

安装 Node.js 和 NPM

可以从Node.js 官网下载适合你操作系统的安装包并进行安装。安装完成后，可以通过在命令行输入node -v和npm -v

1. 使用 npx 安装和运行 n8n:

在命令行中，直接输入npx n8n。npx 会自动检查本地是否已安装 n8n ，如果本地没有，则会从 npm 仓库下载，然后执行 n8n 的入口脚本

常见问题处理

问题 1：端口被占用？

• 修改端口映射：
• 把主机端口改为 8080:5678
• 访问地址变为：http://localhost:8080

问题 2：无法保存工作流？

• 确认已正确挂载 /home/node/.n8n 目录
• 检查磁盘空间是否充足（至少保留 5GB ）

问题 3：报错 The container name "/n8n" is already in use

如果遇到这个错误：

Failed to run image. (HTTP code 409) unexpected - Conflict. The container name "/n8n" is already in use by container "4032df05ff2a513f2e24bf3b091a16d0f0c53e90bb147b0f42686efe8606dc1a". You have to remove (or rename) that container to be able to reuse that name.

这是 Docker 的一个基础规则：同一个名字只能被一个容器使用。切换到 Containers 标签页先删除已有的即可。

相关链接：

n8n 中文汉化包：https://github.com/other-blowsnow/n8n-i18n-chinese/releases

n8n 官方 GitHub：https://github.com/n8n-io/n8n

n8n 官方文档：https://docs.n8n.io/

Docker 桌面版：https://www.docker.com/