匠人学院 JR Academy学AI来匠人
匠人学院 JR Academy学AI来匠人

Follow Us

linkedinfacebooktwitterinstagramweiboyoutubebilibilitiktokxigua

We Accept

/image/layout/pay-paypal.png/image/layout/pay-visa.png/image/layout/pay-master-card.png/image/layout/pay-airwallex.png/image/layout/pay-alipay.png
EN

关于公司

关于我们元宇宙课堂新闻资讯匠人工作成为导师匠人导师联系我们匠人商店J3.Club

匠人资源

工作内推匠人活动1对1私教行业白皮书线上学习平台面试中心分享面试经验Internship会员中心

AI 工具

AI 工具箱考证匠 Cert Master求职匠 Job Hunter牛小匠 UniMate AI

AI 学习方向

全部学习方向AI EngineerContext EngineeringVibe CodingPrompt MasterAI BuilderAI 产品经理Python 入门

AI 应用提效

AI 办公提效AI 数据分析AI 财务AI 内容创作AI 视觉创作前端开发Hermes AgentOpenClaw 本地智能体

大学资源

墨尔本大学昆士兰大学新南威尔士大学悉尼大学莫那什大学阿德莱德大学RMITQUTUTS

少儿 AI 教育

Airbotix 少儿 AI 编程澳洲家长实用资料库NAPLAN 成绩单怎么看My School 学校数据指南悉尼私校学费 2026少儿编程课程与训练营

移民服务

澳洲移民技术移民189/190/491雇主担保482/186/494投资移民188/888英国移民美国移民加拿大移民

企业合作

P3职业孵化器Enterprise (EN)企业培训实习合作招聘合作申请合作

求职代理

岗位代投职位监控LinkedIn代运营LinkedIn人脉代加了解P3项目

匠人支持

FAQsTerms & ConditionsPrivacy PolicyCancellation & Refund PolicySite map

Top Categories

Web全栈班DevOps项目班数据工程全栈班数据分析项目班编程入门班Business Analyst实习算法集训营

求职就业

BA和产品经理实习数据科学实习数据分析实习Marketing实习简历修改面试指导导师指导VIP

地址

Level 10b, 144 Edward Street, Brisbane CBD(Headquarter)
Level 2, 171 La Trobe St, Melbourne VIC 3000
四川省成都市武侯区桂溪街道天府大道中段500号D5东方希望天祥广场B座45A13号
Business Hub, 155 Waymouth St, Adelaide SA 5000

联系方式

hello@jiangren.com.au0421-672-555

Disclaimer

footer-disclaimerfooter-disclaimer

JR Academy acknowledges Traditional Owners of Country throughout Australia and recognises the continuing connection to lands, waters and communities. We pay our respect to Aboriginal and Torres Strait Islander cultures; and to Elders past and present. Aboriginal and Torres Strait Islander peoples should be aware that this website may contain images or names of people who have since passed away.

匠人学院网站上的所有内容,包括课程材料、徽标和匠人学院网站上提供的信息,均受澳大利亚政府知识产权法的保护。严禁未经授权使用、销售、分发、复制或修改。违规行为可能会导致法律诉讼。通过访问我们的网站,您同意尊重我们的知识产权。JR Academy Pty Ltd 保留所有权利,包括专利、商标和版权。任何侵权行为都将受到法律追究。查看用户协议

© 2017-2026 JR Academy Pty Ltd. All rights reserved.

ABN 26621887572

首页/资源中心/文章详情
JR Academy · Blog职业洞察

n8n 自动化工作流实战指南 — n8n 自托管部署完全指南:从零到生产环境

Docker Compose + PostgreSQL 标准配置、Nginx HTTPS、Cloudflare Tunnel、备份策略、常见踩坑——一篇搞定生产级自托管

发布日期2026-09-20
阅读时长2 分钟
作者

快速导航

  • 选服务器:先别省钱
  • 标准部署方案:Docker Compose + PostgreSQL
  • 目录结构
  • docker-compose.yml
  • .env 文件
  • HTTPS 方案一:Nginx + Let's Encrypt
  • 安装 Certbot
  • Nginx 配置 /etc/nginx/sites-available/n8n
  • HTTPS 方案二:Cloudflare Tunnel(推荐,零开端口)
  • 步骤
  • 备份:最容易被忽视,最不能出错
  • 版本升级:不要每次都升 latest
  • 最常见的 7 个踩坑
  • 成本速算

自托管的最大价值是:数据不出你的服务器,执行次数无上限,成本随量封顶。但 60% 的人在上线前 30 天就因为配置失误或缺少备份而遭遇故障。这章把正确姿势一次说清。

n8n 自托管架构


选服务器:先别省钱

场景 RAM CPU 存储
测试 / 个人项目 2 GB 1 vCPU 20 GB SSD
小团队生产(<50 workflow) 4 GB 2 vCPU 40 GB SSD
中型团队(50–200 workflow) 8 GB 4 vCPU 80 GB SSD

存储必须用 SSD——n8n 每次执行都会写日志,HDD 的随机写入速度会让 workflow 队列积压。RAM 不够会让 Node.js 进程在执行高并发 workflow 时直接 crash。

推荐供应商:Hetzner(性价比最高,欧洲数据中心)、DigitalOcean(文档友好)、Vultr(中国大陆网络相对快)。


标准部署方案:Docker Compose + PostgreSQL

这是官方推荐的生产配置。SQLite 仅适合本地测试,生产环境必须换 PostgreSQL。

目录结构

/opt/n8n/
├── docker-compose.yml
├── .env
└── local-files/        # workflow 读写本地文件的共享目录

docker-compose.yml

version: "3.8"

services:
  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 10

  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"    # 只绑定本机,不直接暴露到公网
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres
      DB_POSTGRESDB_PORT: 5432
      DB_POSTGRESDB_DATABASE: ${POSTGRES_DB}
      DB_POSTGRESDB_USER: ${POSTGRES_USER}
      DB_POSTGRESDB_PASSWORD: ${POSTGRES_PASSWORD}
      N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY}
      N8N_HOST: ${N8N_HOST}
      N8N_PORT: 5678
      N8N_PROTOCOL: https
      WEBHOOK_URL: https://${N8N_HOST}/
      GENERIC_TIMEZONE: Australia/Sydney
      EXECUTIONS_DATA_PRUNE: "true"
      EXECUTIONS_DATA_MAX_AGE: 168         # 保留7天执行历史(小时)
    volumes:
      - n8n_data:/home/node/.n8n
      - ./local-files:/files
    depends_on:
      postgres:
        condition: service_healthy

volumes:
  postgres_data:
  n8n_data:

关键细节:ports 写 127.0.0.1:5678:5678 而非 5678:5678,这样 n8n 只监听本机回环,不直接暴露在公网——只有 Nginx 反向代理才能访问它。

.env 文件

POSTGRES_USER=n8n
POSTGRES_PASSWORD=换成强随机密码_至少20位
POSTGRES_DB=n8n

N8N_ENCRYPTION_KEY=换成随机字符串_至少32位_丢失则凭证全废
N8N_HOST=n8n.your-domain.com

启动:

cd /opt/n8n
docker compose up -d

# 查看日志确认启动成功
docker compose logs n8n --tail=50 -f

HTTPS 方案一:Nginx + Let's Encrypt

适合有固定公网 IP 的 VPS,80/443 端口可以对外开放。

安装 Certbot

apt install -y nginx certbot python3-certbot-nginx

# 申请证书(替换域名)
certbot --nginx -d n8n.your-domain.com

Nginx 配置 /etc/nginx/sites-available/n8n

server {
    listen 80;
    server_name n8n.your-domain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name n8n.your-domain.com;

    ssl_certificate /etc/letsencrypt/live/n8n.your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/n8n.your-domain.com/privkey.pem;

    # WebSocket 支持(n8n 实时推送需要)
    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_read_timeout 300s;     # webhook 长轮询需要较大超时
        client_max_body_size 50M;    # 允许上传文件
    }
}
ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

HTTPS 方案二:Cloudflare Tunnel(推荐,零开端口)

不需要固定 IP,不需要开放防火墙端口,安全性更好。适合家庭宽带或有 NAT 的环境。

步骤

  1. 在 Cloudflare 后台创建 Tunnel,下载 cloudflared 凭证文件(JSON)
  2. 在 docker-compose.yml 里加一个 cloudflared 服务:
  cloudflared:
    image: cloudflare/cloudflared:latest
    restart: unless-stopped
    command: tunnel --no-autoupdate run
    environment:
      TUNNEL_TOKEN: ${CLOUDFLARE_TUNNEL_TOKEN}
    depends_on:
      - n8n
  1. 在 .env 里加 CLOUDFLARE_TUNNEL_TOKEN=你的token
  2. 在 Cloudflare 后台把 Tunnel 路由到 http://n8n:5678(容器内部网络名)

完成后公网用 https://n8n.your-domain.com 访问,流量全程走 Cloudflare Edge,服务器无需开任何入站端口。


备份:最容易被忽视,最不能出错

# 备份脚本 /opt/n8n/backup.sh
#!/bin/bash
set -euo pipefail

DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR=/opt/n8n/backups

mkdir -p "$BACKUP_DIR"

# 备份 PostgreSQL
docker exec n8n-postgres-1 \
  pg_dump -U n8n n8n | gzip > "$BACKUP_DIR/db_$DATE.sql.gz"

# 备份 .n8n 目录(包含凭证加密数据)
docker run --rm \
  -v n8n_n8n_data:/data \
  -v "$BACKUP_DIR":/backup \
  alpine tar czf "/backup/n8n_data_$DATE.tar.gz" /data

# 只保留最近 7 天
find "$BACKUP_DIR" -name "*.gz" -mtime +7 -delete

echo "备份完成: $DATE"

加入 crontab(每天凌晨3点执行):

chmod +x /opt/n8n/backup.sh
crontab -e
# 加入:
# 0 3 * * * /opt/n8n/backup.sh >> /var/log/n8n-backup.log 2>&1

备份同时要异地存储:用 rclone 把备份文件同步到对象存储(如 Cloudflare R2、AWS S3、阿里云 OSS)。


版本升级:不要每次都升 latest

# 1. 先查看当前版本
docker exec n8n-n8n-1 n8n --version

# 2. 升级前备份
/opt/n8n/backup.sh

# 3. 拉新镜像并重启
docker compose pull n8n
docker compose up -d n8n

# 4. 查看日志确认正常
docker compose logs n8n --tail=20 -f

建议策略:锁定小版本(如 image: docker.n8n.io/n8nio/n8n:1.85),每月人工评估一次是否升级,安全补丁版本立即跟进。


最常见的 7 个踩坑

坑 症状 解法
N8N_ENCRYPTION_KEY 没设或丢了 凭证全部无法解密,需要重新配所有 API Key 首次启动前设好,妥善保存到密码管理器
SQLite 用于生产 并发执行时数据丢失 换 PostgreSQL
5678 端口直接暴露公网 不需要登录就能访问 n8n 用 Nginx/Cloudflare Tunnel 做反向代理
忘记配置 WEBHOOK_URL Webhook 节点生成错误的回调地址 设 WEBHOOK_URL=https://你的域名/
服务器时区错误 Cron 触发器时间不准 设 GENERIC_TIMEZONE=Asia/Shanghai(或对应时区)
磁盘被执行日志撑满 n8n 突然停止运行 开启 EXECUTIONS_DATA_PRUNE=true
没有备份 服务器故障后数据全丢 按上面的备份脚本每天自动备份

成本速算

自托管的盈亏点大约在 每月 20,000 次执行:

  • Hetzner CX22(4GB/2vCPU):约 €4/月
  • n8n Cloud Pro(10,000次执行):€60/月
  • n8n Cloud Business(40,000次执行):€800/月

执行量大的团队用自托管节省的费用,一年可以买下好几台服务器。

作者
一键分享或复制链接
Lightman Wang
Reviewer: Lightman Wang

Founder of JR Academy

查看该作者的更多文章 →
← 上一篇n8n 自动化工作流实战指南 — n8n 核心体系:Trigger、Node、Expression 全解下一篇 →n8n 自动化工作流实战指南 — n8n AI Agent 深度实战:Claude + 记忆 + 工具 + RAG 知识库

相关文章推荐

太狠了太狠了😭 NVIDIA这个AI免费项目真的太狠了

2026-09-21

GitHub Copilot 实战指南 — 常见问题、定价与选型建议

2026-09-20

GitHub Copilot 实战指南 — 进阶玩法:Coding Agent、自定义指令与 MCP

2026-09-20

GitHub Copilot 实战指南 — 核心功能深度解析:补全、Chat 与 Agent Mode

2026-09-20

GitHub Copilot 实战指南 — 快速上手:注册免费版 + 第一次 AI 编程

2026-09-20

GitHub Copilot 实战指南 — GitHub Copilot 是什么:全球最大的 AI 编程助手

2026-09-20
查看全部文章 →
JR Academy
全球华人学习 AI 第一站
✓15000+ 学员
✓50+ 课程
✓AI 驱动学习平台
训练营免费资源AI学习职业辅导
精选推荐
AI 职业影响地图
测测你的职业风险等级,查看转型路径与学习方向
热门工具
AI & 数据训练营
系统化课程 + 真实项目实战,快速提升竞争力
热门课程
1v1 就业辅导
资深导师一对一指导,简历优化 + 面试准备
就业保障
企业内训定制
AI 技能培训方案,助力团队升级
企业服务
热门标签
Vibe CodingAI 编程CursorClaude求职攻略Prompt前端开发后端开发
订阅更新

获取最新 AI 学习资源、技术教程和求职攻略,直接送达邮箱。

我们尊重您的隐私,不会发送垃圾邮件