n8n 免费部署教程:Koyeb + Neon + 中文界面
✅ 成果:永久保存工作流、支持 Webhook、自动休眠、中文界面、安全认证
📌 适用平台:Koyeb 免费账户 + Neon PostgreSQL(社区版,无需企业许可证)
一、注册账号
1.1 注册 Koyeb
- 访问 https://app.koyeb.com
- 点击 Sign in
- 使用 GitHub 账号登录(推荐)
- 完成邮箱验证
1.2 注册 Neon.tech
- 访问 https://neon.tech
- 点击 Sign in
- 使用 GitHub 账号登录
- 无需信用卡,直接进入控制台
二、创建 Neon PostgreSQL 数据库
- 登录 Neon 控制台
- 点击 Create a Project
- 填写项目名(如
n8n-db) - 选择区域(推荐
eu-central-1) - 点击 Create Project
记录以下信息(后续用到):
| 参数 | 说明 |
|---|---|
| Host | 形如 ep-xxx-xxx-pooler.c-2.eu-central-1.aws.neon.tech |
| Port | 5432 |
| User | 通常是 neondb_owner |
| Password | 点击 Generate password 获取(仅显示一次!) |
| Database | 通常是 neondb |
⚠️ 重要:密码一旦关闭页面将无法找回,请立即保存!
三、在 Koyeb 部署 n8n
3.1 创建 Service
- 登录 Koyeb 控制台
- 点击 Services → Create Service
- 选择 Docker Image
3.2 基础配置
| 项 | 值 |
|---|---|
| Service Name | n8n |
| Docker Image | n8nio/n8n:latest |
| Port | 5678 |
| Region | fra(法兰克福) |
| Instance Type | Free |
3.3 环境变量(关键!)
# === 语言与安全 ===
N8N_DEFAULT_LOCALE=zh
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=your_admin_username
N8N_BASIC_AUTH_PASSWORD=your_strong_password
# === 时区 ===
GENERIC_TIMEZONE=Asia/Shanghai
# === PostgreSQL 连接 ===
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=your_neon_host_from_step_2
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_USER=your_neon_user
DB_POSTGRESDB_PASSWORD=your_neon_password
DB_POSTGRESDB_DATABASE=your_neon_database
DB_POSTGRESDB_SCHEMA=n8n
# === SSL 配置(必须!)===
DB_POSTGRESDB_SSL=true
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED=false
# === Webhook 支持(部署后回填)===
N8N_HOST=your-app-name.koyeb.app
WEBHOOK_URL=https://your-app-name.koyeb.app/
💡 替换说明:
your_admin_username:自定义管理员用户名your_strong_password:至少 16 位强密码your_neon_*:替换为第二步获取的真实值your-app-name.koyeb.app:部署成功后从 Koyeb 控制台复制
3.4 其他设置
- Volumes:留空(免费账户不支持)
- Health Check:默认 TCP on port 5678
3.5 部署
- 点击 Deploy
- 等待状态变为 Running
四、启用中文界面
- 访问你的 n8n 地址(如
https://your-app-name.koyeb.app) - 如果仍是英文,在地址栏末尾添加:
?locale=zh
完整 URL:https://your-app-name.koyeb.app/?locale=zh - 按回车,页面将切换为中文
- 后续访问将自动保持中文
✅ 原理:n8n 会将语言偏好保存到浏览器 localStorage,一次切换永久生效。
五、验证与备份
5.1 验证持久化
- 创建一个测试工作流
- 在 Koyeb 控制台点击 Redeploy
- 刷新页面,确认工作流仍在
5.2 手动备份
- 点击右上角 Settings (⚙️)
- 选择 Export All Workflows
- 保存 JSON 文件到本地或 GitHub
六、常见问题
Q:为什么不能用 S3/R2?
A:社区版不支持 S3 二进制存储(需企业许可证)。所有数据已存入 PostgreSQL,无需额外存储。
Q:服务会休眠吗?
A:会。65 分钟无访问后自动休眠,下次访问需 10-30 秒唤醒。
Q:Python 节点能用吗?
A:不能。但 JS Code 节点完全可用。