修改Authentik推送邮件的内容与样式

q2019的小站

宝塔面板安装使用Guacamole教程银河麒麟系统下龙芯浏览器无法使用中文输入法的解决方案关于存在于Wordpress 主题Argon中的越权修改漏洞百度智能云服务器HAS组件卸载 JIEBA分词WASM版本编译全过程 UBUNTU使用国内腾讯镜像源安装GITLAB-CE 基于Qwen微调猫娘大模型解决Argon主题出现Warning Undefined array key “HTTP_USER_AGENT” 报错 BookStack配置渲染Latex公式 NinjaForms问题解决(出现混乱的页面、Recaptcha 地址替换、Pjax导致表单不显示） roboflow/sports库的安装配置与使用

q2019 · 2026-05-29 · via q2019的小站

摘要

本文介绍了如何通过修改模版的方案自定义Authentik发送的各种邮件的内容与样式

前言

Authentik作为一个统一身份管理系统，在其日常的运行中，不可避免的需要向用户发送一些邮件（用户有时候需要通过邮箱来找回密码、接收2FA信息）。但是Authentik默认发送的邮件样式有些不美观，在部分邮箱客户端上面显示的邮件还有些不协调（如图1所示），并且我们也有自定义邮件通知内容以及图标样式等的需求。

所以这篇文章，我将会来介绍下如何对Authentik推送的邮件样式进行修改。本文适用于使用Docker Compose部署的Authentik实例，但是采用其他方案部署的实例也可以参考本文章的部分内容。

图1 Authentik发送的密码重置邮件在Outlook（经典版）里头的显示界面

大体思路

Authentik的后端是基于Django进行开发的，其使用了Django的模版语言来渲染部分页面^[1]。而Authentik发送的邮件，也是基于模版生成的。所以我们需要自己设计一个邮件模版，然后让Authentik基于这个模版生成邮件发送给用户，即可达成自定义推送邮件的样式以及内容。

具体操作

准备自己的模版

首先，我们的邮件模版肯定要能接入变量，否则无法动态显示用户所需要的信息。Authentik邮件常用的变量如表1所示

变量名	变量含义
{{ url }}	发送给用户的链接（比如说重置密码 / 验证邮箱的链接）
{{ user.username }}	触发此邮件操作的用户名
{{ user.email }}	触发此邮件操作的用户邮箱
{{ expires }}	邮件中的链接有效期

表1 Authentik邮件模版常用变量

根据上述的变量，我们先写一个简单的html模版出来。

{% load i18n %}
{% load humanize %}

<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <title>重置密码</title>
</head>
<body>
  <p>{{ user.username }}，您好：</p>

  <p>您正在请求重置您的账号密码。</p>

  <p>请打开下面的链接重置密码：</p>

  <p><a href="{{ url }}">{{ url }}</a></p>

  <p>如果不是您本人操作，请忽略此邮件。</p>

  <p>该链接将在 {{ expires|naturaltime }} 失效。</p>

  <p>此致，敬礼</p>
</body>
</html>

当然，自从Authentik 2024.2版本之后，Authentik支持发送同时包含txt与html内容的Multipart邮件^[2]。

如果想要发送Multipart邮件的话，只需再配置一个txt文件版本的模版，与html版本的文件名一致，但是文件扩展名为txt。txt版本的模版跟html版本的大部分变量都是相同的。我下面也给一个例子

{% load humanize %}

{{ user.username }}，您好：

您正在请求重置您的账号密码。

请打开下面的链接重置密码：

{{ url }}

如果不是您本人操作，请忽略此邮件。

该链接将在 {{ expires|naturaltime }} 失效。

此致，敬礼

将您设计的两个文件分别准备好，并设置好文件名，比如说html版本叫做password_reset.html，然后txt版本叫做password_reset.txt。txt 版本的邮件不是必须的，可以只准备html版本。

将模版挂载到Authentik容器里

默认情况下，使用Authentik官方的compose.yml文件部署的实例默认会挂载compose.yml同级目录中的custom-templates目录到内部的模版目录中。

所以，我们找到当时启动Authentik的目录（即compose.yml所在的目录），找到custom-templates文件夹（如果没有这个目录，请手动创建），如图2所示，然后将刚刚我们准备的两个模版文件（password_reset.txt与password_reset.html)拷贝到这个目录中。