n8n 中文文档

用户管理SMTP,以及二次认证环境变量

提示

File-based configuration 基于文件的配置

您可以将 _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)或不使用 SSL(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 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 来增强安全性。

使用环境变量的实例所有者

将 N8N_INSTANCE_OWNER_MANAGED_BY_ENV 设置为 true 以从环境变量中预先配置实例所有者。请参阅使用环境变量管理实例设置 了解激活模式的工作原理。

变量 类型 默认 描述
N8N_INSTANCE_OWNER_MANAGED_BY_ENV Boolean false 设为 true 后,可通过环境变量管理实例所有者。启用后,n8n 会在每次启动时覆盖下方的实例所有者信息、锁定该用户在 UI 中的相关控件,并拒绝对其进行 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 哈希值。填入明文密码会导致无法登录。

警告

Owner email must be unique 所有者电子邮件必须是唯一的

N8N_INSTANCE_OWNER_EMAIL 不得已属于实例上的其他用户。此设置更新现有实例所有者帐户;它不会将所有权转让给其他现有用户或合并用户帐户。要使用已属于其他用户的电子邮件地址,请先更改或删除该用户,以便电子邮件可用。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。