零成本部署 n8n：在 HuggingFace 上搭建自动化工作流引擎

什么是 n8n？#

n8n 是一个开源的工作流自动化引擎，类似 Zapier 或 Make（原 Integromat）， 但可以自部署且完全免费。它通过可视化拖拽的方式，将不同服务串联成自动化流程——

• 收到 GitHub Star → 发送 Telegram 通知
• 定时抓取 RSS → AI 摘要 → 存入 Notion
• Webhook 触发 → 调用大模型 API → 返回结果

n8n 内置了 400+ 集成节点，支持 AI Agent、Webhook、定时任务、代码节点等。 唯一的门槛是：它需要一台服务器来运行。

而 HuggingFace Spaces 的免费 Docker 容器，恰好可以承载它。

准备材料#

开始之前，你需要准备以下四项：

资源	用途	获取地址
GitHub 账号	Fork 项目仓库	github.com
HuggingFace 账号 + Token	部署容器	huggingface.co/settings/tokens
Cloudflare API Key	内网穿透 / 域名	dash.cloudflare.com

三个账号均免费注册，不需要绑定信用卡。

1. 获取 HuggingFace Token#

进入 HuggingFace Token 页面，创建一个 Write 权限的 Token：

1. 点击 New Token
2. Token type 选择 Write
3. 填写名称（如 n8n-space）
4. 复制生成的 Token 并妥善保存

2. 获取 Cloudflare API Key#

如果你希望通过自定义域名或 Cloudflare Tunnel 公开访问 n8n：

1. 登录 Cloudflare 控制台
2. 右上角头像 → My Profile → API Tokens
3. 创建 Token，选择 Create Custom Token
4. 权限至少包含 Zone:DNS:Edit

部署步骤#

第一步：Fork 项目#

打开 Hugging8N 仓库，点击右上角 Fork 到你的 GitHub 账号。

这个项目已经配置好了 n8n 的 Dockerfile 和 HuggingFace Spaces 所需的配置文件。

第二步：在 HuggingFace 创建 Space#

1. 进入 huggingface.co/new-space
2. Space 名称随意（如 my-n8n）
3. SDK 选择 Docker → Docker
4. 模板选择 Blank
5. 点击 Create Space

第三步：关联 GitHub 仓库#

Space 创建完成后：

1. 进入 Space 页面 → Settings → Repository
2. 将仓库地址改为你 Fork 后的 GitHub 地址
3. 在 Secrets 区域，添加以下环境变量：

变量名	值
HF_TOKEN	你的 HuggingFace Write Token
CLOUDFLARE_API_KEY	你的 Cloudflare API Key

4. 回到 Settings → Factory rebuild → 点击 Rebuild

第四步：等待构建#

HuggingFace 会拉取 Dockerfile 并构建镜像。整个过程大约需要 5-10 分钟。

构建日志可以在 Space 页面的 Builder 标签页中查看。出现以下日志表示成功：

Running on Docker
Build completed successfully

构建完成后，Space 会自动启动容器。你会看到 n8n 的初始化界面。

第五步：注册登录#

首次访问 n8n 时，系统会要求你创建一个管理员账号：

1. 填写邮箱和密码
2. 登录后即可进入工作流编辑器
3. 建议在 Settings → Users 中关闭公开注册（防止他人滥用）

架构原理#

用户请求 → Cloudflare Tunnel → HuggingFace Space (Docker)
                                    └── n8n 服务 (端口 5678)
                                          ├── SQLite 数据库 (本地持久化)
                                          └── 工作流引擎

组件	作用
HuggingFace Spaces	免费的 Docker 运行环境（2 vCPU, 16GB RAM）
Cloudflare Tunnel	将 HuggingFace 内部端口暴露到公网
SQLite	n8n 默认的本地数据库（数据存在容器内）

注意事项#

免费限制#

HuggingFace Spaces 的免费 Docker 容器有以下限制：

• 休眠机制：长时间无请求时容器会休眠，首次唤醒需要约 30 秒
• 存储不持久：如果 Space 被重建，未持久化的数据会丢失
• 资源限制：2 vCPU / 16GB RAM，适合个人和小团队使用

保持活跃#

防止容器休眠的几种方法：

# 方法一：使用 Cron 定时请求
# 在任意有 Cron 的机器上执行：
*/10 * * * * curl -s https://your-space.hf.space/healthz > /dev/null

# 方法二：使用 UptimeRobot 等免费监控服务
# 每 5 分钟 ping 一次你的 Space URL

数据备份#

建议定期备份 n8n 的工作流配置：

1. n8n 内 → Settings → Workflows → Export
2. 导出为 JSON 文件保存到本地
3. 或配置 n8n 的 GitHub 自动同步功能

总结#

通过 HuggingFace Spaces + Hugging8N 项目，你可以在不花一分钱的情况下 拥有一台 7×24 运行的 n8n 工作流引擎。对于个人自动化需求（消息通知、 内容抓取、AI 工作流编排）来说，这套方案完全够用。

白嫖的快乐，懂的都懂 🤫