rgv151/docker-mailserver

docker-mailserver镜像说明

镜像概述

docker-mailserver是一个全栈且轻量的邮件服务器镜像，集成SMTP、IMAP核心服务及反垃圾、杀毒等附加功能。镜像采用纯配置文件管理模式，无需SQL数据库，保持简洁可版本化，部署和升级流程高效便捷。

核心功能

• 协议支持：Postfix（SMTP）、Dovecot（IMAP/POP3可选），支持SASL认证与SSL加密
• 安全防护：SpamAssassin（反垃圾邮件）、ClamAV（杀毒自动更新）、Fail2Ban（防暴力破解）、Postgrey（灰名单）
• 认证授权：支持LDAP、本地用户、MySQL等多种认证方式
• 域名验证：Opendkim、Opendmarc，提升邮件送达率
• SSL兼容：支持Let's Encrypt、自定义证书、自签名证书
• 持久化：数据与状态分离存储，支持Docker卷持久化
• 附加功能：Fetchmail（邮件拉取）、Sieve过滤规则、集成测试支持

使用场景

• 小型企业/团队内部邮件系统搭建
• 个人私有邮件服务部署
• 快速搭建邮件测试环境
• 对邮件安全有高需求的场景

配置说明

关键环境变量

部署示例

1. 拉取镜像

bash
docker pull tvial/docker-mailserver:latest

2. 基础docker-compose配置

yaml
version: '2'
services:
  mail:
    image: tvial/docker-mailserver:latest
    hostname: mail
    domainname: domain.com
    container_name: mail
    ports:
      - "25:25"    # SMTP
      - "143:143"  # IMAP
      - "587:587"  # SMTP提交
      - "993:993"  # IMAPS
    volumes:
      - maildata:/var/mail       # 邮件数据
      - mailstate:/var/mail-state # 状态数据
      - ./config/:/tmp/docker-mailserver/ # 配置挂载
    environment:
      - ENABLE_SPAMASSASSIN=1
      - ENABLE_CLAMAV=1
      - ENABLE_FAIL2BAN=1
      - ENABLE_POSTGREY=1
      - ONE_DIR=1
    cap_add:
      - NET_ADMIN # Fail2Ban需要此权限
volumes:
  maildata:
    driver: local
  mailstate:
    driver: local

3. 创建邮件账户

bash
mkdir -p config
touch config/postfix-accounts.cf
docker run --rm \
  -e MAIL_USER=user1@domain.tld \
  -e MAIL_PASS=mypassword \
  -ti tvial/docker-mailserver:latest \
  /bin/sh -c 'echo "$MAIL_USER|$(doveadm pw -s SHA512-CRYPT -u $MAIL_USER -p $MAIL_PASS)"' >> config/postfix-accounts.cf

4. 生成DKIM密钥

bash
docker run --rm \
  -v "$(pwd)/config":/tmp/docker-mailserver \
  -ti tvial/docker-mailserver:latest generate-dkim-config

将config/opendkim/keys/domain.tld/mail.txt内容添加到域名DNS解析。

5. 启动容器

bash
docker-compose up -d mail