用户管理、SMTP及双因子认证环境变量#
基于文件的配置
您可以为单个变量添加 _FILE 后缀，以便在独立文件中提供其配置。更多细节请参阅在独立文件中保存敏感数据。
有关设置用户管理和电子邮件的更多信息，请参阅用户管理。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_EMAIL_MODE | 字符串 | smtp | 启用电子邮件功能 |
N8N_SMTP_HOST | 字符串 | - | 您的SMTP服务器名称 |
N8N_SMTP_PORT | 数字 | - | 您的SMTP服务器端口 |
N8N_SMTP_USER | 字符串 | - | 您的SMTP用户名 |
N8N_SMTP_PASS | 字符串 | - | 您的SMTP密码 |
N8N_SMTP_OAUTH_SERVICE_CLIENT | 字符串 | - | 若使用服务账户进行2LO认证，此项为客户端ID |
N8N_SMTP_OAUTH_PRIVATE_KEY | 字符串 | - | 若使用服务账户进行2LO认证，此项为私钥 |
N8N_SMTP_SENDER | 字符串 | - | 发件人邮箱地址。可选择性包含发件人名称。含名称示例：N8N <[email protected]> |
N8N_SMTP_SSL | 布尔值 | true | 是否对SMTP使用SSL（true启用，false禁用） |
N8N_SMTP_STARTTLS | 布尔值 | true | 是否对SMTP使用STARTTLS（true启用，false禁用） |
N8N_UM_EMAIL_TEMPLATES_INVITE | 字符串 | - | HTML邮件模板的完整路径。将覆盖默认的邀请邮件模板 |
N8N_UM_EMAIL_TEMPLATES_PWRESET | 字符串 | - | HTML邮件模板的完整路径。将覆盖默认的密码重置邮件模板 |
N8N_UM_EMAIL_TEMPLATES_WORKFLOW_SHARED | 字符串 | - | 覆盖默认的工作流共享通知HTML模板。请提供模板的完整路径 |
N8N_UM_EMAIL_TEMPLATES_CREDENTIALS_SHARED | 字符串 | - | 覆盖默认的凭据共享通知HTML模板。请提供模板的完整路径 |
N8N_UM_EMAIL_TEMPLATES_PROJECT_SHARED | 字符串 | - | 覆盖默认的项目共享通知HTML模 板。请提供模板的完整路径 |
N8N_USER_MANAGEMENT_JWT_SECRET | 字符串 | - | 设置特定的JWT密钥。默认情况下n8n会在启动时自动生成 |
N8N_USER_MANAGEMENT_JWT_DURATION_HOURS | 数字 | 168 | 设置JWT过期时间（以小时为单位） |
N8N_USER_MANAGEMENT_JWT_REFRESH_TIMEOUT_HOURS | 数字 | 0 | JWT过期前多少小时自动刷新。0表示N8N_USER_MANAGEMENT_JWT_DURATION_HOURS时长的25%。-1表示永不刷新，强制用户在N8N_USER_MANAGEMENT_JWT_DURATION_HOURS定义的周期后重新登录 |
N8N_MFA_ENABLED | 布尔值 | true | 是否启用双因子认证（true启用，false禁用）。若现有用户已启用2FA，n8n将忽略此设置 |
N8N_INVITE_LINKS_EMAIL_ONLY | 布尔值 | false | 设置为true时，n8n将仅通过电子邮件发送邀请链接，不会通过API暴露。此选项通过阻止邀请URL被程序化访问或高权限用户获取来增强安全性 |