一、n8n是什么？
n8n（读作"nighty-night"）是一个开源的自动化工作流工具。你可以用它连接：
- 邮箱、网盘、社交媒体
- 云服务（如Google Drive、Slack）
- 物联网设备（如智能灯泡）
- 自建服务器应用
典型应用场景：
- 自动备份微信公众号文章到网盘
- 每天定时抓取股票数据生成报表
- 新用户注册自动发送欢迎邮件+创建CRM记录
二、零基础安装指南（Docker版）
1. 访问官网安装Docker Desktop（Windows/Mac）：
- Windows: https://www.docker.com/products/docker-desktop/
- Mac: 同上（需开启Intel/Apple芯片兼容模式）
2. 安装完成后右键点击系统托盘中的鲸鱼图标，确认状态为"Running"，然后登录。
三、搜索n8n镜像
- 打开Docker Desktop主界面
- 点击导航栏【Docker Hub】
- 在搜索框输入
n8n - 找到官方镜像（带蓝色认证标志）：
- 名称：
n8nio/n8n - 确认下载数超过100M+
四、下载镜像
- 点击【Pull】按钮下载镜像
- 在左侧【Images】标签查看下载进度
- 等待状态变为"Downloaded"
五、创建容器（重点步骤！）
1. 点击【Run】运行容器
在镜像列表点击 ▶️ 运行按钮，弹出配置窗口。
2. 基本配置
- Container name：输入
n8n - Ports：
5678
3. 高级配置
挂载卷（Volumes）
| Host path | Container path |
|---|---|
| C:\n8n-data (Windows) 或 /Users/你的用户名/n8n-data (Mac/Linux) | /home/node/.n8n |
如果路径不存在会自动创建
环境变量（Environment Variables）
| Name | Value |
|---|---|
| N8N_HOST | localhost |
| N8N_BASIC_AUTH_ACTIVE | true |
| N8N_BASIC_AUTH_USER | admin |
| N8N_BASIC_AUTH_PASSWORD | 123456 |
⚠️ 重要提示：生产环境请修改密码为强密码
六、启动容器
- 点击【Run】按钮
- 切换到【Containers】标签页
- 等待状态变为"Running"
七、访问n8n
- 浏览器打开：
http://localhost:5678
2. 输入账号密码：
- Email（邮箱）
- First Name（姓）
- Last Name（名）
- Password（密码）
这里的用户名密码随便填
登录成功示例图：
八、常见问题处理
问题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://docs.n8n.io/
- 加入中文社区：搜索"n8n中文用户组"获取实时帮助
- 进阶学习：尝试用"Function"节点编写简单JavaScript代码实现自定义逻辑
开发必备：API 全流程管理神器 Apifox
介绍完上文的工具，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、API 调试、API 设计、API 测试、API Mock、自动化测试等功能于一体的 API 管理工具，Apifox 可以说是开发者提升效率的必备工具之一。
如果你正在开发项目需要进行接口调试，不妨试试 Apifox。注册过程非常简单，你可以直接在这里注册使用。
注册成功后可以先看看官方提供的示例项目，这些案例都是经过精心设计的，能帮助你快速了解 Apifox 的主要功能。
使用 Apifox 的一大优势是它完全兼容 Postman 和 Swagger 数据格式，如果你之前使用过这些工具，数据导入会非常方便。而且它的界面设计非常友好，即使是第一次接触的新手也能很快上手，快去试试吧！
