邮件提供商概览

添加邮件提供商

1. 点击 Add，在 Category 中选择 Email。
2. 填入 SMTP 服务器的 Username、Password、Host 和 Port。
3. 设置 Email Title 和 Email Content（模板），然后保存。

SSL 模式

SSL mode 设置控制 SMTP 连接如何协商 TLS：

值	行为
Auto（默认）	由 gomail 根据端口决定。 465 端口使用隐式 SSL，其他端口尝试 STARTTLS。
启用	无论端口是多少都强制使用 SSL/TLS。当服务器在非标准端口上要求隐式 TLS 时使用。
关闭	禁用 SSL/TLS。只用于可信内网中的服务器。

原来勾选了 Disable SSL 的提供商会自动视为 Disable，无需手动迁移。

代理

如果 Casdoor 服务器无法直接访问 SMTP 服务器（例如在受限网络中使用 Gmail），开启 Enable proxy。邮件会通过 Casdoor 配置中定义的 SOCKS5 代理发送。

邮件内容与占位符

模板支持占位符，以及用于密码重置的 <reset-link> 块。

占位符	描述
%{'{'}user.friendlyName{'}'}	用户的显示名称或昵称。
%s	验证码（用于认证邮件）。
%link	密码重置地址。只能放在 <reset-link>...</reset-link> 中使用。

密码重置链接

要让用户点击邮件中的链接重置密码：

1. 把链接文字和 %link 放在 <reset-link> 标签中。
2. 这个块只在密码重置邮件中显示；注册 / 登录验证邮件中会被移除。

纯文本示例：

你在 Casdoor 申请了验证码。你的验证码是：%s，请在 5 分钟内输入。 <reset-link>或点击 %link 重置密码</reset-link>

HTML 示例：

<!DOCTYPE html>
<html>
<body>
    <h2>Password Reset Request</h2>
    <p>Hello %{'{'}user.friendlyName{'}'},</p>
    <p>Your verification code is: <strong>%s</strong></p>
    <p>This code will expire in 5 minutes.</p>
    <reset-link>
        <p>Alternatively, you can <a href="%link">click here to reset your password</a> directly.</p>
    </reset-link>
    <p>If you didn't request this, please ignore this email.</p>
</body>
</html>

非密码重置邮件（注册、登录验证）中会省略 <reset-link> 块。