n8n 的基础安装分享

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

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

​开源与自托管​: n8n 是基于公平代码( fair-code )许可的开源工具,用户可以免费自托管,拥有对数据和基础设施的完全控制,适合注重隐私和安全的企业。 提供云托管版本( n8n.cloud ),适合不想自己维护服务器的用户。

​节点式架构​: n8n 使用节点( nodes )来构建工作流,每个节点代表一个触发器( trigger )或动作( action ),如发送邮件、调用 API 或处理数据。用户通过拖放界面连接节点,创建自动化流程。 支持触发节点(基于事件或时间调度)和动作节点(执行特定任务,如数据转换或通知)。

​广泛的集成能力​: 支持超过 400 种应用程序和服务的集成,包括 Google Sheets 、Slack 、Airtable 、OpenAI 等,允许无缝连接各种工具。 对于未内置的应用,用户可通过 HTTP 请求节点调用任何具有 API 的工具。

​低代码与代码灵活性​: 提供直观的拖放界面,适合非开发人员快速构建工作流。 同时支持 JavaScript 和 Python 代码,开发者可通过代码节点实现高级自定义逻辑。

​AI 原生支持​: 内置 AI 功能,支持与大型语言模型(如 OpenAI 的 GPT-4.5 、Claude 等)集成,可用于内容生成、数据分类或构建 AI 代理。 支持 RAG (检索增强生成)系统,结合向量数据库处理外部数据。

​社区与模板​: 提供超过 900 个现成的工作流模板,社区贡献丰富,方便新用户快速上手。 活跃的社区支持用户分享模板和解决问题。

部署方式 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

使用 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/