内容转自：https://nodeloc.cc/t/topic/48709

前几天有朋友提议NL提供免费邮箱服务，这几天有空研究了一下市面上常见的邮箱程序，甄选了一下后选择了Mailu，主要原因就是节省资源，同时还支持OIDC(非官方支持)，这里简单出个教程，教大家如何在几分钟内快速搭建免费邮箱服务，当然，如果你并不想提供，只是想自用，也是一样可以的。

第一步

准备干净的系统，比如Debian12，安装一下更新包及Docker

apt update && apt upgrade -y
apt install docker-compose

第二步，设置初始化参数

打开 https://setup.mailu.io/2024.06/ ，按照您的域名填写对应信息即可。

这个就填写一下域名就好了

这个选一下webmail的界面，然后输入一下邮箱地址，下一步。

基本安装命令都给你了

mkdir /mailu
cd /mailu
wget https://setup.mailu.io/2024.06/file/4e81bf52-603c-4cad-8d07-431efebe48f1/docker-compose.yml
wget https://setup.mailu.io/2024.06/file/4e81bf52-603c-4cad-8d07-431efebe48f1/mailu.env

把对应命令拷贝到服务器运行就好了

第三步 替换镜像源

因为mailu官方不支持OIDC，我们使用 GitHub - heviat/Mailu-OIDC: Mailu email service extended by OpenID Connect user authentication 这个帅哥提供的镜像来实现OIDC登录。

方法很简单，把刚才下载下来的 docker-compose.yml 里边的 ghcr.io/mailu 替换为 ghcr.io/heviat ，使用以下命令即可

sed -i 's|ghcr.io/mailu|ghcr.io/heviat|g' docker-compose.yml

编辑一下 mailu.env 文件，在文件最后加以下内容

################################### 
# OpenID Connect settings
###################################

OIDC_ENABLED=True
# OIDC地址，比如NL的就是 https://conn.nodeloc.cc/oauth2
OIDC_PROVIDER_INFO_URL=https://conn.nodeloc.cc/oauth2
# OIDC的Client ID，在 https://conn.nodeloc.cc/apps 创建一个应用，会给你这个信息
OIDC_CLIENT_ID=<CLIENT_ID>
# Client Secret
OIDC_CLIENT_SECRET=<CLIENT_SECRET>
# Label text for OpenID Connect login button. Default: OpenID Connect
OIDC_BUTTON_NAME=NodeLoc Connect
# Disable TLS certificate verification for the OIDC client. Possible values: True, False
OIDC_VERIFY_SSL=True
# 这个是默认使用OIDC里边提供的用户名
OIDC_USERNAME_CLAIM=preferred_username
# 这个是提供邮箱的域名
OIDC_USER_DOMAIN=loc.cc

这里其实如果你有多个邮箱，可以不输入

OIDC_USERNAME_CLAIM=preferred_username
OIDC_USER_DOMAIN=loc.cc

这样默认会使用传入的email作为邮箱，如果不存在域或者邮箱，都会自动创建。

第四步 启动

刚才的事情都做完成，运行 docker-compose up -d 启动，就可以访问 https://mail.你的域名 来使用OIDC登录了。如果用户不存在会自动创建，存在的用户会自动登录。

整体过程很快，几分钟就okay了。