配置自托管 n8n 的用户管理功能#
n8n 的用户管理功能允许您邀请他人使用您的 n8n 实例。
本文档描述了如何配置 n8n 实例以支持用户管理，以及开始邀请用户的步骤。
有关使用方面的更多信息，请参阅主用户管理指南，包括：
关于 LDAP 设置信息，请参阅 LDAP。
关于 SAML 设置信息，请参阅 SAML。
基本认证和 JWT 已移除
n8n 在 1.0 版本中移除了对基本认证和 JWT 的支持。
设置步骤#
在 n8n 中设置用户管理功能分为三个阶段：
- 配置 n8n 实例使用您的 SMTP 服务器。
- 启动 n8n 并按照应用内的设置步骤操作。
- 邀请用户。
第一步：SMTP 配置#
n8n 建议设置 SMTP 服务器，用于发送用户邀请和密码重置邮件。
0.210.1 版本起可选
从 0.210.1 版本开始，此步骤变为可选。您可以选择手动复制并发送邀请链接，而无需配置 SMTP。请注意，如果跳过此步骤，用户将无法重置密码。
从您的 SMTP 服务提供商处获取以下信息：
- 服务器名称
- SMTP 用户名
- SMTP 密码
- SMTP 发件人名称
要为 n8n 配置 SMTP，请为您的 n8n 实例设置 SMTP 环境变量。有关如何设置环境变量的信息，请参阅配置指南
| 变量名 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
N8N_EMAIL_MODE |
string | smtp |
必填 |
N8N_SMTP_HOST |
string | 您的SMTP服务器名称 | 必填 |
N8N_SMTP_PORT |
number | 您的SMTP服务器端口 默认为 465 |
可选 |
N8N_SMTP_USER |
string | 您的SMTP用户名 | 可选 |
N8N_SMTP_PASS |
string | 您的SMTP密码 | 可选 |
N8N_SMTP_OAUTH_SERVICE_CLIENT |
string | 您的OAuth服务客户端 | 可选 |
N8N_SMTP_OAUTH_PRIVATE_KEY |
string | 您的OAuth私钥 | 可选 |
N8N_SMTP_SENDER |
string | 发件人邮箱地址。可包含发件人名称。带名称示例：N8N <contact@n8n.com> |
必填 |
N8N_SMTP_SSL |
boolean | 是否使用 SSL 加密（true 使用，false 不使用）。默认为 true。 |
可选 |
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 实例已在运行，需要重启以启用新的 SMTP 设置。
更多配置选项
还有更多可通过环境变量配置的选项。如需完整列表，请参阅环境变量文档。这些选项包括禁用标签、工作流模板和个人化调查的设置（如果您不希望用户看到这些功能）。
初次接触 SMTP？
如果您不熟悉 SMTP，SendGrid 的这篇博客文章提供了简短介绍，而维基百科的简单邮件传输协议文章则提供了更详细的技术背景。
第二步：应用内设置#
首次设置用户管理时，您需要创建一个所有者账户。
- 打开 n8n。应用会显示注册界面。
- 输入您的详细信息。密码必须至少包含8个字符，其中至少包含一个数字和一个大写字母。
- 点击 下一步。n8n 将使用您的新所有者账户登录。
第三步：邀请用户#
您现在可以邀请其他用户加入您的 n8n 实例。
- 使用所有者账号登录您的工作区（如果您在管理员面板中，请从仪表板打开工作区）
- 点击左下角用户图标旁边的三个点，然后选择设置。n8n 将打开您的个人设置页面。
- 点击用户进入用户管理页面。
- 点击邀请按钮。
- 输入新用户的电子邮件地址。
- 点击邀请用户。n8n 将向该用户发送包含加入链接的电子邮件。