一、什么是 n8n¶

n8n 是一款开源、可自托管、可视化的工作流自动化平台。你可以把它理解成一个“节点式自动化引擎”，通过拖拽节点把不同服务串起来，完成定时任务、数据同步、消息通知和 AI 自动化。

官网：

https://n8n.io

GitHub：

https://github.com/n8n-io/n8n

二、n8n 的核心特点¶

2.1 开源和自托管¶

MIT 许可；
可以部署在本地、Docker、Kubernetes 或云服务器；
更适合注重数据可控性的团队。

2.2 可视化节点编排¶

拖拽式工作流；
节点之间通过数据流连接；
支持 IF、循环、分支、合并等控制逻辑。

2.3 集成能力强¶

支持很多常见服务，例如：

Slack、Email、Telegram；
PostgreSQL、MySQL、MongoDB；
GitHub、Webhook、HTTP Request；
OpenAI、Hugging Face 等 AI 模型。

2.4 数据处理灵活¶

所有节点都围绕 JSON 数据流转，还可以通过 Code 节点写 JavaScript 实现定制逻辑。

三、n8n 可以做什么¶

典型场景包括：

自动内容分发；
数据同步；
智能告警；
日报/周报自动发送；
AIOps 自动化运维；
AI Agent 工具编排。

四、部署前准备¶

4.1 准备机器¶

可以选择：

阿里云服务器；
本地 Linux；
虚拟机环境。

4.2 放行端口¶

如果用云服务器，记得在安全组里放行 5678 端口。

4.3 安装 Docker¶

sudo apt update
sudo apt install docker.io docker-compose

如果镜像拉取慢，可以继续配置加速器：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerhub.timeweb.cloud"
  ]
}
EOF
sudo systemctl start docker
sudo systemctl enable docker

五、启动 n8n¶

5.1 创建数据卷¶

sudo docker volume create n8n_data

5.2 运行容器¶

sudo docker run -d \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="Asia/Shanghai" \
  -e TZ="Asia/Shanghai" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

这个命令里最关键的是：

-p 5678:5678：
映射访问端口。
-v n8n_data:/home/node/.n8n：
持久化工作流和凭证。
GENERIC_TIMEZONE 和 TZ：
保证定时任务按上海时区运行。

5.3 访问网页¶

浏览器访问：

http://<your-server-ip>:5678

image/png

如果发现 cookie 或登录相关问题，可以重新启动容器并增加：

N8N_SECURE_COOKIE=false

六、License 和账号设置¶

n8n 某些能力可能需要邮箱激活或 license 流程，所以注册邮箱最好填写正确。

设置页示意：