【n8n教程】:自托管n8n配置完全指南

【n8n教程】:自托管n8n配置完全指南

n8n配置就像给一个应用设置”说明书”。通过配置,你可以告诉n8n:

  • 使用什么数据库存储工作流和凭证
  • 用户如何登录(邮件、密码等)
  • 工作流如何运行(并发数、超时时间等)
  • 如何处理敏感信息(加密、密钥等)

简单来说,配置就是用环境变量来定制n8n的行为。


什么是环境变量?

环境变量是操作系统传递给应用程序的参数。比如:

这三行告诉n8n:”使用PostgreSQL数据库,地址是localhost,端口是5432″。

核心环境变量速查表

环境变量 说明 默认值 示例 数据库类型 sqlite postgresdb / mysqldb 加密密钥 自动生成 至少32个字符 访问地址 localhost n8n.example.com 时区 America/New_York Asia/Shanghai 日志级别 info debug / warn / error 执行超时(秒) -1(无限) 3600

方法1️⃣ : npm命令行设置

Linux/Mac (Bash):

Windows (CMD):

Windows (PowerShell):

方法2️⃣ : Docker参数传递

使用 标志在启动时传递环境变量:

方法3️⃣ : Docker Compose文件(推荐)

创建 :

然后启动:

方法4️⃣ : 使用文件存储敏感数据

不想在环境变量中暴露密码?使用 后缀!

n8n会自动从指定文件读取密钥。


SQLite(默认,适合开发)

优点 :开箱即用,无需额外设置 缺点:不适合生产环境,并发性能差

PostgreSQL(推荐生产环境)

完整的PostgreSQL配置示例:

SSL连接配置(如果数据库需要):

MySQL(另一选择)

快速迁移:SQLite → PostgreSQL


SMTP配置(邮件邀请)

用户邀请和密码重置需要邮件功能。配置SMTP:

🔐 Pro Tip: 使用Gmail应用专用密码,不要用主密码!

首次设置流程

  1. 启动n8n后 ,访问
  2. 创建Owner账户:输入邮箱和密码(密码至少8字符,需大写+数字)
  3. 邀请用户:左下角用户菜单 → Settings → Users → Invite
  4. 用户收到邮件,点击链接加入

SSO集成(高级)

n8n 工作流 教程

SAML配置:
OIDC配置:
LDAP配置:

什么是Task Runners?

Task Runners是独立的执行环境,用于运行Code节点中的JavaScript和Python代码。分为两种模式:

内部模式(开发用)

特点:简单易用,但n8n进程和运行器在同一进程,不推荐生产。

外部模式(生产推荐)

需要运行 容器:


并发执行限制

日志配置

监控和指标(Prometheus)

访问 查看Prometheus指标。

加密和安全

⚠️ 重要:生成强随机密钥:


场景:定时数据采集和邮件通知

这个工作流会:

  1. ⏰ 每天早上9点运行
  2. 📊 从API获取数据
  3. 📈 处理和转换数据
  4. 📧 发送邮件报告
Docker Compose完整配置
.env文件

创建 文件(保存敏感信息):

启动命令
完整的n8n工作流JSON代码
如何导入这个工作流
  1. 在n8n中,点击 Create Workflow 或打开现有工作流
  2. 点击 Menu (≡) → Open
  3. 选择 Import from fileImport from URL
  4. 上传JSON文件
  5. 配置SMTP凭证并激活工作流

问题 解决方案 无法连接数据库 检查 、端口、密码 邮件无法发送 验证SMTP配置,检查防火墙和应用密码 工作流执行超时 增加 值 权限错误 检查Docker卷权限,运行 内存不足 减少 或增加服务器内存

  • 官方文档
  • n8n系列教程
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/246103.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月15日 下午6:59
下一篇 2026年3月15日 下午6:59


相关推荐

关注全栈程序员社区公众号