一、速览

入门

n8n 是一个工作流自动化平台，你可以把它理解成一个“智能管家”：你告诉它“如果发生这件事，就去做那件事”，它就会自动帮你完成。比如“每天早上 9 点把天气信息发到我的邮箱”“当有新的表单提交时，自动同步到表格并通知我”。

它最大的特点是可视化画布：你不需要写代码，只要把一个个“节点”拖到画布上，用线连接起来，就能组成一条自动化流程。每个节点代表一个动作，比如“读取邮件”“调用 AI”“发送消息”。

n8n 既能部署在自己的服务器上（数据自己保管），也能用官方云服务。它支持 400+ 集成，覆盖常见应用如 Slack、Google Sheets、Telegram、GitHub 等，还内置了 AI 相关节点，可以把大模型接入你的流程。

如果你每天都有一些重复的复制粘贴、发通知、整理数据的工作，n8n 可以帮你把这些事串起来自动跑，省下时间做更有价值的事。

二、快速部署

入门

部署 n8n 最简单的方式是用 Docker（一种把软件打包成“集装箱”、随处可运行的工具）。你不需要手动安装 Node.js、配置数据库，一条命令就能把 n8n 跑起来。

前置条件：你需要一台能联网的 Linux 服务器或自己的电脑，并且已经装好 Docker。如果不确定是否已安装，可以在终端里输入 docker --version，如果显示版本号就说明已就绪。

先创建一个数据卷（可以理解为一个专门的“存储抽屉”，用来保存 n8n 的配置和流程数据，即使容器删掉数据也不会丢）：

docker volume create n8n_data

然后启动 n8n 容器：

docker run -it --rm --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

这条命令做了几件事：把容器内的 5678 端口映射到本机 5678 端口，把刚才创建的数据卷挂载到容器内保存数据的目录，最后用官方镜像启动。

注意：命令中的 --rm 表示容器停止后自动删除，但数据不会丢，因为数据已经存在数据卷 n8n_data 里。如果你想以后每次都手动启动，可以去掉 --rm。

启动后，打开浏览器访问 http://localhost:5678（如果是远程服务器，把 localhost 换成服务器 IP）。第一次进入会引导你创建管理员账号。

三、配置详解

进阶 · 推荐细读

n8n 通过环境变量来调整运行参数，就像给软件设置不同的“开关和旋钮”。在使用 Docker 启动时，可以在 docker run 命令里加上 -e 变量名=值 来传入。

常用的环境变量整理如下：

数据卷的挂载点固定为容器内的 /home/node/.n8n，这是 n8n 存放所有工作流、凭证和执行历史的地方。只要把这个目录映射到宿主机或数据卷，升级或重启都不会丢失数据。

端口方面，默认使用 5678。如果本机 5678 被占用，可以改左边的映射端口，例如 -p 5679:5678，然后用 http://localhost:5679 访问。

如果想让 n8n 用外部数据库（比如 PostgreSQL），还可以设置 DB_TYPE=postgresdb 以及对应的 DB_POSTGRESDB_HOST、DB_POSTGRESDB_DATABASE 等变量。不过新手阶段用默认的 SQLite 就足够了。

四、功能导览

入门

登录之后你会看到一个干净的工作台，左侧是节点面板，中间是画布。点击右上角的“New Workflow”可以创建一条新流程。

n8n 的核心是节点和触发器。节点代表一个具体的动作，比如“发一封邮件”“调用一个 API”（API 可以理解成餐厅服务员，你告诉它要什么，它把结果端给你）。触发器则决定流程什么时候开始跑，比如“定时触发”“收到 webhook 请求时触发”。

创建一个简单流程通常分三步：

1. 添加一个触发器节点，例如 Schedule Trigger，设置每天 9 点运行。
2. 添加一个动作节点，例如 Gmail 里的发送邮件，填写收件人和内容。
3. 把两个节点连起来，点击右上角“Execute Workflow”手动测试，或点“Activate”让流程自动运行。

n8n 还内置了 AI 节点，你可以把 OpenAI、Anthropic 或本地大模型接到流程里，让 AI 参与处理数据。比如“读取新邮件 → 交给 AI 分类 → 根据结果自动回复或存档”。

如果你不知道从何下手，可以打开 n8n 的模板库。里面提供了大量现成的流程模板，点击即可导入到自己的工作台，改一改参数就能用，这是新手最快的学习路径。

五、常见问题

进阶 · 推荐细读

端口冲突怎么办？

如果 5678 端口已经被其他程序占用，启动会报错。解决办法是修改宿主机映射端口，例如 -p 5679:5678，然后访问 http://localhost:5679。可以用 docker ps 查看当前容器占用的端口。

为什么浏览器打不开？

先确认容器是否在运行：docker ps。如果容器已停止，用 docker start n8n 重新启动。如果容器运行中但无法访问，检查服务器防火墙是否放行了对应端口，以及访问地址是否正确。

数据会丢吗？

只要数据卷 n8n_data 没被手动删除，数据就一直都在。即使容器被删除或升级，重新启动容器并挂载同一个数据卷即可恢复。不要删除数据卷，否则所有工作流和凭证都会丢失。

Docker 权限不够怎么办？

如果你在使用 docker 命令时遇到 permission denied，通常需要把当前用户加入 docker 组。执行 sudo usermod -aG docker $USER 然后重新登录终端即可。或者用 sudo docker 临时提权。

六、运维进阶

深入 · 老手可选

当 n8n 需要正式对外提供服务时，建议配好 HTTPS 和反向代理。反向代理就像公司前台，外部请求先到前台，再由前台转给内部对应的服务。常用工具是 Caddy 或 Nginx。

以 Caddy 为例，配置一个简单的站点文件：

n8n.example.com {
    reverse_proxy localhost:5678
}

Caddy 会自动申请并续期 SSL 证书，让你通过 https://n8n.example.com 安全访问。使用反向代理后，记得设置 WEBHOOK_URL 为完整的 https:// 地址，否则外部系统回调可能失败。

升级 n8n 时，建议先备份数据卷，再拉取新镜像重新创建容器。备份数据卷的一种方法是运行一个临时容器把数据卷内容打包：

docker run --rm -v n8n_data:/data -v $(pwd):/backup alpine \
  tar czf /backup/n8n_backup.tar.gz -C /data .

恢复时用相同方式解包回数据卷即可。升级前先停止旧容器，然后用新的镜像启动，并挂载同一个数据卷，n8n 会自动完成数据库结构迁移。

对于更严肃的生产环境，建议把 n8n 的数据库切换到 PostgreSQL，并设置定期任务自动备份数据库和文件。这样可以获得更好的并发性能，也方便做增量恢复。

当你熟悉了基本操作后，可以进一步探索 n8n 的子流程、错误处理和表达式系统。这些能力能让你的自动化流程更健壮，也更接近真实业务场景。

项目信息

参考链接

• GitHub 仓库
• 项目主页

延伸阅读

想继续探索？这些同领域的教程可能也适合你：

• 「GithubStarsManager」中文使用教程
• 「HivisionIDPhotos」中文使用教程
• 「ChatGPT」中文使用教程