用户管理 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。
N8N_SMTP_OAUTH_PRIVATE_KEY	String	-	通过服务账号使用 2LO 时，填写私钥。
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 密钥。默认由 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	是否启用双因素身份验证，true 表示启用，false 表示禁用。如果现有用户已经启用 2FA，n8n 会忽略此设置。
N8N_INVITE_LINKS_EMAIL_ONLY	Boolean	false	设为 true 时，n8n 只通过邮件发送邀请链接，不通过 API 暴露，避免程序或高权限用户获取邀请 URL，以提高安全性。

通过环境变量管理实例所有者

将 N8N_INSTANCE_OWNER_MANAGED_BY_ENV 设为 true，通过环境变量预配置实例所有者。启用机制请参阅通过环境变量管理实例设置。

变量	类型	默认值	说明
N8N_INSTANCE_OWNER_MANAGED_BY_ENV	Boolean	false	设为 true，通过环境变量管理实例所有者。当值为 true 时，n8n 会在每次启动时覆盖下方的实例所有者信息，锁定该用户的界面控件，并拒绝通过 API 修改。
N8N_INSTANCE_OWNER_EMAIL	String	-	实例所有者的电子邮件地址。
N8N_INSTANCE_OWNER_FIRST_NAME	String	-	实例所有者的名。
N8N_INSTANCE_OWNER_LAST_NAME	String	-	实例所有者的姓。
N8N_INSTANCE_OWNER_PASSWORD_HASH	String	-	实例所有者密码的 bcrypt 哈希值。设置明文密码会导致无法登录。

注意

所有者邮箱必须唯一

N8N_INSTANCE_OWNER_EMAIL 不能已属于实例中的其他用户。此设置更新现有实例所有者账号，不会将所有权转移给其他现有用户，也不会合并账号。要使用已属于其他用户的邮箱，请先更改或删除该用户，释放邮箱。

相关资源

• 环境变量