tozd/mail

tozd/mail

镜像概述和主要用途

tozd/mail是一个提供完整电子邮件服务的Docker镜像，支持虚拟用户管理。该镜像集成了多种电子邮件服务组件，旨在通过扩展配置或挂载必要文件，提供企业级的电子邮件解决方案。它需要与tozd/sympa（邮件列表）和tozd/postfixadmin（虚拟用户管理）等镜像配合使用，并推荐使用tozd/postgresql作为数据库后端。

镜像继承关系

tozd/base ← tozd/dinit ← tozd/postfix ← tozd/mail

核心功能和特性

集成服务组件

• tozd/postfix - 发送和接收电子邮件，作为基础镜像扩展
• tozd/sympa - 邮件列表服务，需与本镜像配合运行
• tozd/postfixadmin - 虚拟用户管理，需与本镜像配合运行
• Amavis - 病毒和垃圾邮件扫描接口
• Clamav - 防病毒引擎
• SpamAssassin - 反垃圾邮件平台
• Postgrey - 灰名单服务
• Dovecot - IMAP和POP3服务器

使用场景和适用范围

本镜像适用于需要自建完整电子邮件服务的企业或组织，特别是需要：

• 支持虚拟用户管理的邮件系统
• 集成邮件列表功能
• 具备垃圾邮件和病毒防护能力
• 提供IMAP/POP3访问
• 需要灵活配置和扩展的邮件服务

详细使用方法和配置说明

前置要求

该镜像必须通过扩展（或挂载必要文件）才能运行，需要与以下组件配合使用：

• tozd/sympa 和 tozd/postfixadmin 镜像
• PostgreSQL 数据库（推荐使用tozd/postgresql镜像）
• 可能需要tozd/external-ip镜像获取外部IP

卷挂载要求

必须挂载以下配置卷：

配置文件结构

/config卷必须包含以下文件和目录结构：

/config
├── amavis/
│   └── 50-user              # Amavis配置文件
├── dovecot/
│   ├── connect.conf         # PostgreSQL连接配置
│   └── local.conf           # Dovecot主配置文件
├── postfix/
│   ├── main.cf.append       # Postfix主配置附加内容
│   └── master.cf.append     # Postfix主程序配置附加内容
├── postfixadmin/
│   └── pgpass               # PostgreSQL密码文件
├── postgrey/
│   ├── whitelist_clients.local  # 客户端白名单
│   ├── whitelist_recipients.local  # 收件人白名单
│   ├── run.config           # Postfix启动时运行的配置脚本
│   └── run.initialization   # Postfix进程启动前运行的初始化脚本
├── spamassassin/
│   └── local.cf             # SpamAssassin配置
└── ssl/                     # SSL证书存储目录（建议）

关键配置示例

Postfix主配置附加内容（main.cf.append）

virtual_alias_maps =
  proxy:pgsql:/config/postfix/pgsql_virtual_alias_maps.cf,
  proxy:pgsql:/config/postfix/pgsql_virtual_alias_domain_maps.cf,
  proxy:pgsql:/config/postfix/pgsql_virtual_alias_domain_catchall_maps.cf,
  regexp:/config/postfix/sympa_rewrite
virtual_minimum_uid = 120
virtual_uid_maps = static:120
virtual_gid_maps = static:120
virtual_mailbox_base = /srv/mail/domains
virtual_mailbox_domains = proxy:pgsql:/config/postfix/pgsql_virtual_domains_maps.cf
virtual_mailbox_limit = 0
virtual_mailbox_maps =
  proxy:pgsql:/config/postfix/pgsql_virtual_mailbox_maps.cf,
  proxy:pgsql:/config/postfix/pgsql_virtual_alias_domain_mailbox_maps.cf,
  regexp:/config/postfix/sympa_transport
virtual_transport = dovecot
dovecot_destination_recipient_limit = 1
relay_domains = proxy:pgsql:/config/postfix/pgsql_relay_domains_maps.cf

Sympa重写规则示例（sympa_rewrite）

/^sympa-request@/	postmaster
/^sympa-owner@/		postmaster
/(.+)-owner@(.+)/	$1+owner@$2

Sympa传输规则示例（sympa_transport）

/^sympa@example\.com$/	 sympadomain:
/^abuse-feedback-report@example\.com$/	 sympabouncedomain:
/^bounce\+.*@example\.com$/	 sympabouncedomain:
/^listmaster@example\.com$/	 sympa:
/^.+(announce|list|info|event|press|talk|news)\+owner@example\.com$/	sympabounce:
/^.+(announce|list|info|event|press|talk|news)(-request|-editor|-subscribe|-unsubscribe)?@example\.com$/	sympa:

Docker部署方案示例

docker run命令示例

bash
docker run -d \
  --name mail \
  -v /path/to/config:/config \
  -v /path/to/maildata:/srv/mail \
  -v postfix-shared:/etc/postfixadmin/shared \
  -v sympa-shared:/etc/sympa/shared \
  --link postgres:postgres \
  --link postfixadmin:postfixadmin \
  --link sympa:sympa \
  docker.xuanyuan.run/tozd/mail

docker-compose配置示例

yaml
version: '3'

services:
  mail:
    image: docker.xuanyuan.run/tozd/mail
    volumes:
      - ./config:/config
      - maildata:/srv/mail
      - postfix-shared:/etc/postfixadmin/shared
      - sympa-shared:/etc/sympa/shared
    depends_on:
      - postgres
      - postfixadmin
      - sympa
    restart: always

  postgres:
    image: docker.xuanyuan.run/tozd/postgresql
    volumes:
      - postgres-data:/var/lib/postgresql
    environment:
      - POSTGRES_PASSWORD=securepassword
    restart: always

  postfixadmin:
    image: docker.xuanyuan.run/tozd/postfixadmin
    volumes:
      - postfix-shared:/etc/postfixadmin/shared
    depends_on:
      - postgres
    restart: always

  sympa:
    image: docker.xuanyuan.run/tozd/sympa
    volumes:
      - sympa-shared:/etc/sympa/shared
    depends_on:
      - postgres
      - mail
    restart: always

volumes:
  maildata:
  postgres-data:
  postfix-shared:
  sympa-shared:

注意事项

1. 首次启动时，若卷为空，镜像会自动初始化必要数据
2. 敏感配置和SSL证书应存储在/config卷中
3. 详细的Postfix与Postfix Admin配置请参考https://github.com/postfixadmin/postfixadmin/blob/master/DOCUMENTS/POSTFIX_CONF.txt
4. /etc/sympa/shared卷需包含sympa_rewrite和sympa_transport文件以配置邮件列表

镜像获取

• Docker Hub: tozd/mail
• GitLab Container Registry: registry.gitlab.com/tozd/docker/mail

GitHub镜像

项目同时提供https://github.com/tozd/docker-mail，方便在GitHub上进行分支开发。