n8n（德国）

n8n

德国团队开发的工作流自动化平台（源码可用、支持自托管）：拖拽节点编排 400+ 应用集成。

国内可直接使用：自托管版无网络限制，Docker 一键部署；云端版需特殊网络环境。

采集于 2026-10-05 · 关键步骤请以官方最新文档为准

一句话简介：德国团队开发的工作流自动化平台（源码可用、支持自托管）：拖拽节点编排 400+ 应用集成。

主流功能：自托管工作流自动化、AI Agent 节点、MCP 服务

可用性：国内可直接使用：自托管版无网络限制，Docker 一键部署；云端版需特殊网络环境。

适用人群：开发者/运维：想自建自动化中枢，数据不出内网

前置条件：

服务器或本地电脑：Linux 服务器（推荐，2核4G 起）、Windows/Mac 本地电脑均可
Docker：已安装 Docker + Docker Compose（本教程核心路径
网络：拉镜像需 Docker Hub 访问——配置国内镜像加速器即可（见步骤 2）
（可选）大模型 Key：DeepSeek 开放平台（platform.deepseek.com）注册获取 API Key，国内直连可用

分步骤教程

第一部分：Docker 自托管部署（重点，约 20 分钟）

步骤 1：安装 Docker（以 Ubuntu/Debian 为例，国内源）

# 卸载旧版（如有）
sudo apt remove docker docker-engine docker.io containerd runc -y

# 用阿里云镜像源安装
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl enable --now docker
docker --version # 显示版本号即成功

步骤 2：配置 Docker 国内镜像加速（关键，否则拉取超时）

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://docker.1ms.run",
"https://docker.xuanyuan.me"
]
}
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker

镜像站可用性会变化，若某个拉取失败就换列表里下一个；也可直接用华为云 SWR 镜像：swr.cn-east-3.myhuaweicloud.com/kubesre/docker.n8n.io/n8nio/n8n:latest。

步骤 3：拉取并启动 n8n

# 创建数据卷（持久化工作流与凭证，删容器不丢数据）
docker volume create n8n_data

# 启动（后台运行 + 开机自启 + 上海时区）
docker run -d --name n8n --restart always \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
-e TZ=Asia/Shanghai \
-e N8N_SECURE_COOKIE=false \
docker.n8n.io/n8nio/n8n:latest

# 确认状态
docker ps | grep n8n # 显示 Up 即成功
docker logs --tail 50 n8n # 看启动日志排错

docker.n8n.io/n8nio/n8n 是官方推荐的镜像地址；n8nio/n8n（Docker Hub）也可，走加速器同样能拉到。

步骤 4：首次打开与注册

浏览器访问 http://服务器IP:5678（本机就是 http://localhost:5678），按提示注册管理员账号（邮箱+密码，自托管本地账号，无需真实邮箱验证）。部分版本会提示输入 license key——去你填的邮箱查收 n8n 官方邮件，点击激活即可（免费）。

步骤 5：升级 n8n（以后用）

docker stop n8n && docker rm n8n
docker pull docker.n8n.io/n8nio/n8n:latest
# 用步骤 3 同样的 docker run 命令重新启动（数据卷还在，数据不丢）

第二部分：创建第一个 AI 工作流（约 15 分钟）

以"AI 聊天问答"为例，打通 n8n + DeepSeek。

步骤 6：新建工作流，加"聊天触发器"

首页点 Create Workflow → 点画布中央 + → 搜索 On chat message（聊天消息触发器）→ 添加。这是工作流的入口。

步骤 7：添加 AI Agent 节点

点触发器后面的 + → 在 AI 分类下选 AI Agent。AI Agent 节点有三个"插槽"：Chat Model（大脑）、Memory（记忆，可选）、Tool（工具，可选）。

步骤 8：接入 DeepSeek 大模型

点 AI Agent 下方的 Chat Model 插槽的 + → 搜索 DeepSeek（或 OpenAI 兼容节点选 DeepSeek）。
点 Create new credential → 粘贴从 https://platform.deepseek.com/api_keys 获取的 API Key → 保存。
选择模型 deepseek-chat（日常对话）或 deepseek-reasoner（深度思考）。

步骤 9：测试对话

回到画布，点 On chat message 节点 → 点 Open chat → 在聊天框输入"你好，介绍一下你自己"，稍等即看到 DeepSeek 的回复。恭喜，第一个 AI 工作流跑通了！

步骤 10：扩展——给 Agent 加工具（进阶示例）

在 AI Agent 的 Tool 插槽点 + → 加 HTTP Request 工具（如查天气 API），或加 Google Sheets / 邮箱 等 400+ 集成；
在 AI Agent 的 System Message 里写清职责，例如"你是一个销售助理，能查库存表回答客户问题"；
点右上角 Execute Workflow 全链路测试 → 没问题后点 Save，再把右上角开关拨到 Active，工作流正式生效。

更多玩法：把触发器换成 On a Schedule（定时）+ HTTP Request（抓数据）+ AI Agent（分析整理）+ Email/Slack（推送），就是"每日热点早报"自动化。

第三部分：云端版注册（可选）

访问 https://n8n.io 点 Get started，邮箱注册（需特殊网络环境）；
免费试用云端托管版，无需自己维护服务器；
自托管与云端的工作流 JSON 可互相导入导出（工作流右上角 … → Download/Copy），迁移无压力。

常见问题

docker pull 一直超时怎么办？ 先确认 daemon.json 镜像加速器已配好并重启了 Docker；逐个尝试列表里的加速地址；终极方案用华为云 SWR 的 n8n 镜像（见步骤 2）。
浏览器打开 5678 没反应？ 检查：① docker ps 容器是否在 Up 状态；② 云服务器安全组/防火墙是否放行 5678 端口；③ docker logs n8n 看是否有报错。
自托管和云端版功能差多少？ 核心功能一致；云端版省去运维但按执行量收费、数据在境外；自托管免费且数据自有，但升级、备份、HTTPS（建议用 Nginx + Let's Encrypt 反代）都要自己管。
AI Agent 节点能用国产大模型吗？ 能。DeepSeek 最顺（官方有专用节点）；通义千问、智谱、Kimi 等走"OpenAI 兼容"节点，填其兼容接口的 Base URL + Key 即可。
n8n 真的免费吗？企业能用吗？ 自托管社区版免费，但采用 fair-code 许可：个人/内部使用没问题，直接拿去做商业 SaaS 对外售卖受限制。企业大规模商用建议看官方 Enterprise 版或咨询法务。

← 返回教程目录

n8n