用户管理、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 <contact@n8n.com> |
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_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会忽略此设置 |