部署托管/Configuration/Environment_variables
用户管理、SMTP 和双因素认证环境变量#
基于文件的配置
你可以为单个变量添加 _FILE 后缀，以在单独的文件中提供其配置。更多详情请参阅 将敏感数据保存在独立文件中。
有关设置用户管理和邮件功能的更多信息，请参阅 用户管理。
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_EMAIL_MODE | 字符串（String） | smtp | 启用邮件功能。 |
N8N_SMTP_HOST | 字符串（String） | - | 你的_SMTP服务器名称_ |
N8N_SMTP_PORT | 数字（Number） | - | 你的_SMTP服务器端口_ |
N8N_SMTP_USER | 字符串（String） | - | 你的_SMTP用户名_ |
N8N_SMTP_PASS | 字符串（String） | - | 你的_SMTP密码_ |
N8N_SMTP_OAUTH_SERVICE_CLIENT | 字符串（String） | - | 若使用服务账户进行两步登录（2LO），则为此处填写客户端 ID（client ID）。 |
N8N_SMTP_OAUTH_PRIVATE_KEY | 字符串（String） | - | 若使用服务账户进行两步登录（2LO），则为此处填写私钥（private key）。 |
N8N_SMTP_SENDER | 字符串（String） | - | 发件人邮箱地址。可选择性地包含发件人姓名。示例（含姓名）：N8N<contact@n8n.com> |
N8N_SMTP_SSL | 布尔值（Boolean） | true | 是否对 SMTP 使用 SSL（true）或不使用（false）。 |
N8N_SMTP_STARTTLS | 布尔值（Boolean） | true | 是否对 SMTP 使用 STARTTLS（true）或不使用（false）。 |
N8N_UM_EMAIL_TEMPLATES_INVITE | 字符串（String） | - | 自定义 HTML 邮件模板的完整路径。此设置将覆盖邀请邮件的默认模板。 |
N8N_UM_EMAIL_TEMPLATES_PWRESET | 字符串（String） | - | 自定义 HTML 邮件模板的完整路径。此设置将覆盖密码重置邮件的默认模板。 |
N8N_UM_EMAIL_TEMPLATES_WORKFLOW_SHARED | 字符串（String） | - | 覆盖工作流共享通知邮件的默认 HTML 模板。请提供模板的完整路径。 |
N8N_UM_EMAIL_TEMPLATES_CREDENTIALS_SHARED | 字符串（String） | - | 覆盖凭据共享通知邮件的默认 HTML 模板。请提供模板的完整路径。 |
N8N_UM_EMAIL_TEMPLATES_PROJECT_SHARED | 字符串（String） | - | 覆盖项目共享通知邮件的默认 HTML 模板。请提供模板的完整路径。 |
N8N_USER_MANAGEMENT_JWT_SECRET | 字符串（String） | - | 设置特定的 JWT 密钥（secret）。默认情况下，n8n 在启动时自动生成一个。 |
N8N_USER_MANAGEMENT_JWT_DURATION_HOURS | 数字（Number） | 168 | 设置 JWT 的有效期（小时）。 |
N8N_USER_MANAGEMENT_JWT_REFRESH_TIMEOUT_HOURS | 数字（Number） | 0 | 在 JWT 过期前多少小时自动刷新。0 表示为 N8N_USER_MANAGEMENT_JWT_DURATION_HOURS 的 25%；-1 表示永不自动刷新，即用户必须在 N8N_USER_MANAGEMENT_JWT_DURATION_HOURS 定义的时间后重新登录。 |
N8N_MFA_ENABLED | 布尔值（Boolean） | true | 是否启用双因素认证（2FA）（true）或禁用（false）。如果已有用户启用了 2FA，n8n 将忽略此设置。 |
N8N_INVITE_LINKS_EMAIL_ONLY | 布尔值（Boolean） | false | 当设置为 true 时，n8n 将仅通过电子邮件发送邀请链接，而不会通过 API 暴露这些链接。此选项增强了安全性，防止邀请 URL 被程序化访问或被高权限用户获取。 |