alexbarcelo/mailman3

Mailman 3容器

本Docker容器提供Mailman Core的独立运行环境，采用Postgres数据库，并预配置HyperKitty归档器（需单独部署）。若需深度自定义配置，建议替换容器内的docker-entrypoint.sh脚本（详见https://github.com/alexbarcelo/docker-mailman3%EF%BC%89%E3%80%82

容器的docker-entrypoint.sh会生成配置文件并启动主程序，位于容器根目录，作为ENTRYPOINT执行。

设置假设

1. Mailman Core独立运行；
2. 使用Postfix作为邮件传输代理（MTA）；
3. HyperKitty为唯一归档器，需通过HTTP连接（非SSL）访问（未包含在本容器内）。

环境变量

• MAILMAN_SITE_OWNER：Mailman站点所有者***（需指向实际联系人）；
• POSTGRES_USER：Postgres数据库用户，默认postgres；
• POSTGRES_PASSWORD：Postgres数据库密码，默认postgres（生产环境需修改）；
• POSTGRES_DB：Mailman使用的数据库名，默认mailman；
• POSTGRES_HOST：Postgres服务器地址，默认postgres；
• POSTGRES_PORT：Postgres端口，默认5432；
• MAILMAN_ADMIN_USER：Mailman API管理员用户名，默认mailman；
• MAILMAN_ADMIN_PASSWORD：Mailman API管理员密码，默认mailman（生产环境需修改）；
• HYPERKITTY_HOST：HyperKitty服务地址，默认hyperkitty；
• HYPERKITTY_PORT：HyperKitty归档API端口，默认8000；
• HYPERKITTY_ARCHIVER_API_KEY：HyperKitty归档API密钥，默认hyperkitty；
• HYPERKITTY_ENABLE：是否启用HyperKitty归档，默认yes；
• POSTFIX_HOST：Postfix服务地址，默认postfix；
• POSTFIX_PORT：Postfix端口，默认25。

注意：默认值仅适用于测试，生产环境需修改敏感参数（如密码、密钥）。

Postfix设置

请参考http://mailman.readthedocs.org/en/release-3.0/src/mailman/docs/MTA.html#postfix%E9%85%8D%E7%BD%AEPostfix%EF%BC%9A

1. 传输映射文件位于容器内/opt/mailman/var/data/，建议挂载该目录到主机；
2. 容器未运行postmap命令（使用mockup替代），需手动将传输映射文件转换为Postfix可识别的二进制格式；
3. Postfix与Mailman通过LMTP协议通信，容器监听8024端口；
4. 容器主机名需设置合理值（避免使用0.0.0.0），并在Postfix机器的/etc/hosts中配置对应映射。

示例部署

步骤1：创建环境变量文件

bash
# sample_deploy.env
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=mailman
MAILMAN_ADMIN_USER=mailman
MAILMAN_ADMIN_PASSWORD=mailman
MAILMAN_SITE_OWNER="me@example.net"
HYPERKITTY_ARCHIVER_API_KEY=hyperkitty

步骤2：启动Postgres服务

bash
docker run --name postgres-mailman-test -d \
           --env-file sample_deploy.env \
           postgres

步骤3：启动Mailman容器

bash
docker run --name mailman-test --hostname mailman-test \
           -d -p 8024:8024 -p 8001:8001 \
           -v `pwd`/mailman_var:/opt/mailman/var \
           --link postgres-mailman-test:postgres \
           --env-file sample_deploy.env \
           alexbarcelo/mailman3

说明：

• 容器暴露8024（LMTP）和8001（API）端口；
• mailman_var目录挂载到主机，存储Mailman数据（含传输映射文件）；
• API端点（3.1版本）：http://localhost:8001/3.1，使用MAILMAN_ADMIN_USER和MAILMAN_ADMIN_PASSWORD认证。

数据目录权限

容器内使用UID/GID为999的mailman用户，需确保挂载的mailman_var目录对该用户有写权限（容器启动时会自动执行chown -R mailman:mailman /opt/mailman）。

关于HyperKitty

HyperKitty需单独部署，可使用https://hub.docker.com/r/alexbarcelo/hyperkitty%E5%AE%B9%E5%99%A8%EF%BC%88https://github.com/alexbarcelo/docker-hyperkitty%EF%BC%89%E3%80%82%E5%BB%BA%E8%AE%AE%E5%B0%86Mailman%E4%B8%8EHyperKitty%E5%88%86%E5%BC%80%E9%83%A8%E7%BD%B2%EF%BC%8C%E4%BB%A5%E6%BB%A1%E8%B6%B3%E9%AB%98%E5%8F%AF%E7%94%A8%E6%80%A7%E5%92%8C%E5%AD%98%E5%82%A8%E9%9C%80%E6%B1%82%E3%80%82

集群支持

本容器未测试集群能力。若需扩展，可尝试多实例部署，但需注意列表创建和并发场景下的竞态问题，需深入了解Mailman机制后再实施。