phiilu/mailman

Mailman

Mailman是一个基于React开发的单页应用（SPA），用于管理邮件服务器数据库，需配合Thomas Leister邮件服务器教程中的数据库模型使用。

核心功能

• ✅ 创建、更新和删除域名、账户、别名及TLS策略
• ✅ 账户可创建别名并修改自身密码
• ✅ 响应式Web界面
• ❌ 域级管理员（待实现）
• ❌ UI定制（待实现）

使用场景

适用于需要管理邮件服务器数据库的运维人员或邮件服务管理员，可简化邮件相关数据的维护操作。

配置说明

前提条件

需拥有符合Thomas Leister教程（Mailserver mit Dovecot, Postfix, MySQL und Rspamd unter Debian 9 Stretch）的邮件服务器数据库模型，并配置数据库用户权限：

sql
-- 授予现有vmail用户权限
grant select, insert, update, delete on vmail.* to 'vmail'@'localhost' identified by 'vmaildbpass';

-- 或创建新用户
grant select, insert, update, delete on vmail.* to 'vmail_mailman'@'localhost' identified by 'vmaildbpass';

Docker部署

1. 下载示例.env文件：

bash
wget https://github.com/phiilu/mailman/raw/master/sample.env -O .env

2. 修改.env文件中的变量（如数据库用户、密码、端口等）
3. 启动容器：

bash
docker run -d --net="host" --env-file .env --restart=always --name mailman docker.xuanyuan.run/phiilu/mailman

• -d：后台运行容器
• --net="host"：共享主机网络（需访问本地数据库）
• --env-file .env：加载环境变量
• --name mailman：设置容器名称

子文件夹配置（访问路径为/mailman）

1. 下载子文件夹示例.env：

bash
wget https://github.com/phiilu/mailman/raw/master/sample.subfolder.env -O .env

2. 修改.env变量后，使用subfolder标签启动：

bash
docker run -d --net="host" --env-file .env --restart=always --name mailman docker.xuanyuan.run/phiilu/mailman:subfolder

手动部署

1. 安装依赖工具：

bash
sudo apt install build-essential python

2. 安装Node.js（通过nvm）：

bash
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.6/install.sh | bash
nvm install 9.1.0

3. 安装PM2进程管理器：

bash
npm i -g pm2

4. 克隆仓库：

bash
git clone https://github.com/phiilu/mailman.git

5. 创建.env文件：

bash
cp sample.env .env

修改变量（如MAILMAN_SECRET、数据库信息等），生成随机密钥可使用：

bash
head /dev/urandom | tr -dc A-Za-z0-9 | head -c 128 ; echo ''

6. 构建应用：

bash
cd mailman && npm install && cd client && npm install && cd - && npm run build

7. 启动应用：

bash
npm start

更新方法

手动部署

bash
git stash && git pull && npm install && cd client && npm install && cd - && npm run build && pm2 restart all

Docker部署

bash
docker pull docker.xuanyuan.run/phiilu/mailman:latest

拉取新镜像后重启容器即可。

反向代理（NGINX示例）

nginx
server {
    listen 80;
    server_name mailman.example.org;

    # 子域名配置
    #location / {
    #  proxy_pass       http://localhost:4000;
    #  proxy_set_header Host      $host;
    #  proxy_set_header X-Real-IP $remote_addr;
    #}

    # 子文件夹配置
    #location /mailman {
    #  proxy_pass       http://localhost:4000;
    #  proxy_set_header Host      $host;
    #  proxy_set_header X-Real-IP $remote_addr;
    #}
}

Catch All***地址

参考Thomas Leister的指南：Wie kann ich mit diesem Setup Catch-All Adressen realisieren? (German)

许可证

本项目采用MIT许可证。

致谢

感谢Thomas Leister提供的优秀邮件服务器安装指南。