fauria/mailman

fauria/mailman

镜像概述和主要用途

基于Ubuntu 16.04的完整GNU Mailman解决方案，集成Mailman 2.1、Apache HTTP Server 2.4和Exim 4.8邮件传输代理。无需依赖其他服务，通过环境变量即可完成初始化配置，单命令即可部署功能完善的邮件列表服务。

核心功能和特性

• 独立部署：包含所有必要组件，无需额外依赖服务
• 自动初始化：通过运行时环境变量配置系统参数
• 完整组件：
  • Ubuntu 16.04 LTS基础镜像
  • Mailman 2.1邮件列表管理系统
  • Apache HTTP Server 2.4 Web服务器
  • Exim 4.8邮件传输代理(MTA)
• DKIM支持：自动生成或使用自定义DKIM密钥对
• 多语言支持：可添加除英语外的其他Mailman支持语言

安装方法

从Docker Hub拉取镜像：

bash
docker pull docker.xuanyuan.run/fauria/mailman

使用要求

主机名

启动容器时必须指定主机名，使用-h参数，例如：-h lists.example.com

环境变量

通过以下环境变量配置容器运行参数：

• 变量名: URL_FQDN
  默认值: lists.example.com
  接受值: 任何完全限定域名
  描述: 用于通过Web服务器访问Mailman界面的域名，通常与EMAIL_FQDN相同

• 变量名: EMAIL_FQDN
  默认值: lists.example.com
  接受值: 任何完全限定域名
  描述: 邮件列表发件域名，必须与-h参数指定的主机名匹配，通常与URL_FQDN相同

• 变量名: LIST_ADMIN
  默认值: admin@lists.example.com
  接受值: 任何有效的电子邮件地址
  描述: 列表管理员***地址，用于创建必填的mailman邮件列表

• 变量名: MASTER_PASSWORD
  默认值: example
  接受值: 任何字符串
  描述: 列表管理员密码，用于创建必填的mailman邮件列表

• 变量名: LIST_LANGUAGE_CODE
  默认值: en
  接受值: Mailman支持的任何ISO-639代码
  描述: 除英语外添加的语言代码，不覆盖英语

• 变量名: LIST_LANGUAGE_NAME
  默认值: English
  接受值: Mailman支持的任何语言名称
  描述: 除英语外添加的语言名称，不替换英语，仅新增一种语言

• 变量名: DEBUG_CONTAINER
  默认值: false
  接受值: false、true
  描述: 控制容器输出，默认仅显示相关信息；设为true时显示所有安装命令执行过程

暴露端口和卷

端口

• 80: Apache Web服务器端口
• 25: Exim邮件传输代理端口

卷

• /var/log/mailman: Mailman日志
• /var/log/exim4: Exim MTA日志
• /var/log/apache2: Apache Web服务器日志
• /var/lib/mailman/archives: 邮件列表归档
• /var/lib/mailman/lists: 邮件列表数据
• /etc/exim4/tls.d: Exim DKIM密钥（需包含private.pem和public.pem；若未提供，运行时自动生成新密钥对）

推荐配置

1. 为邮件列表使用专用子域名（如lists.example.com）
2. 确保能在域名DNS主区域添加TXT记录
3. 除配置https://www.linode.com/docs/networking/dns/dns-records-an-introduction#dkim外，建议添加https://www.linode.com/docs/networking/dns/dns-records-an-introduction#spf记录，将服务器设为列表域的唯一发件源
4. 如需使用自定义RSA密钥对进行DKIM，在主机创建目录并包含private.pem和public.pem，运行容器时挂载该目录至/etc/exim4/tls.d（如-v /my/local/dir/keys:/etc/exim4/tls.d）

使用场景和示例

1. 测试用临时容器（默认配置）

bash
docker run -i -t --rm -h lists.example.com -e DEBUG_CONTAINER=true docker.xuanyuan.run/fauria/mailman

2. 生产环境容器（无卷，域名为whatever.example.com）

bash
docker run -d --restart=always -h whatever.example.com \
  -e URL_FQDN=whatever.example.com \
  -e EMAIL_FQDN=whatever.example.com \
  -e MASTER_PASSWORD=SecretPassword \
  -e LIST_ADMIN=whoever@example.com \
  -p 49780:80 -p 25:25 docker.xuanyuan.run/fauria/mailman

3. 生产环境容器（带卷和西班牙语支持）

bash
docker run -d --restart=always --name my-mailing-list -h whatever.example.com \
  -e URL_FQDN=whatever.example.com \
  -e EMAIL_FQDN=whatever.example.com \
  -e MASTER_PASSWORD=SecretPassword \
  -e LIST_LANGUAGE_CODE=es \
  -e LIST_LANGUAGE_NAME=Spanish \
  -e LIST_ADMIN=whoever@example.com \
  -e DEBUG_CONTAINER=false \
  -p 49780:80 -p 25:25 \
  -v /my/local/dir/archives:/var/lib/mailman/archives \
  -v /my/local/dir/lists:/var/lib/mailman/lists \
  -v /my/local/dir/keys:/etc/exim4/tls.d \
  -v /my/local/dir/log/apache2:/var/log/apache2 \
  -v /my/local/dir/log/exim4:/var/log/exim4 \
  -v /my/local/dir/log/mailman:/var/log/mailman docker.xuanyuan.run/fauria/mailman

主机目录权限配置

挂载卷前需在主机创建目录并设置正确权限：

bash
mkdir -p /my/local/dir/archives/{private,public}
mkdir -p /my/local/dir/lists
chown -R 0:38 /my/local/dir/{archives,lists}
chown 33 /my/local/dir/archives/private
mkdir -p /my/local/dir/log/{apache2,exim4,mailman}
chown 0:4 /my/local/dir/log/apache2
chown 105:4 /my/local/dir/log/exim4
chown 0:38 /my/local/dir/log/mailman

权限对应以下用户ID：

• uid=33(www-data) gid=33(www-data)（Apache）
• uid=38(list) gid=38(list)（Mailman）
• uid=105(Debian-exim) gid=108(Debian-exim)（Exim）