Docker-Mailserver 基础安装与配置教程

Docker-Mailserver 基础安装与配置教程

docker-mailserver Production-ready fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.) running inside a container. 项目地址: https://gitcode.com/gh_mirrors/do/docker-mailserver

前言

Docker-Mailserver 是一个基于 Docker 的完整邮件服务器解决方案，它集成了 Postfix、Dovecot、Rspamd、ClamAV 等多个开源组件，让用户能够快速部署一个功能完善的邮件服务器。本文将详细介绍 Docker-Mailserver 的基础安装配置过程。

基础环境准备

在开始之前，请确保您已经具备以下条件：

1. 已安装 Docker 和 Docker Compose
2. 拥有一个域名并能够管理其 DNS 记录
3. 服务器已开放必要的邮件端口（25、465、587、993）

基础配置示例

以下是一个最小化的 Docker Compose 配置文件示例，包含了邮件服务器运行所需的基本配置：

services:
  mailserver:
    image: docker.io/mailserver/docker-mailserver:latest
    container_name: mailserver
    hostname: mail.example.com  # 替换为您的邮件服务器完整域名
    ports:
      - "25:25"    # SMTP
      - "465:465"  # SMTPS
      - "587:587"  # Submission
      - "993:993"  # IMAPS
    volumes:
      - ./mail-data:/var/mail
      - ./mail-state:/var/mail-state
      - ./mail-logs:/var/log/mail
      - ./config:/tmp/docker-mailserver
      - /etc/localtime:/etc/localtime:ro
    environment:
      - ENABLE_RSPAMD=1      # 启用反垃圾邮件
      - ENABLE_CLAMAV=1      # 启用病毒扫描
      - ENABLE_FAIL2BAN=1    # 启用防暴力攻击
    cap_add:
      - NET_ADMIN  # Fail2Ban 所需权限
    restart: always

配置说明

1. hostname：必须设置为您的邮件服务器完整域名（FQDN），且应与您的 MX 记录一致
2. volumes：
   • mail-data：存储用户邮件
   • mail-state：存储服务器状态信息
   • mail-logs：存储日志文件
   • config：存放配置文件
3. 环境变量：
   • ENABLE_RSPAMD：启用反垃圾邮件功能
   • ENABLE_CLAMAV：启用病毒扫描功能
   • ENABLE_FAIL2BAN：启用防暴力攻击功能

LDAP 集成配置（可选）

如果需要与 LDAP 目录服务集成，可以使用以下配置示例：

environment:
  - ACCOUNT_PROVISIONER=LDAP
  - LDAP_SERVER_HOST=ldap.example.com
  - LDAP_SEARCH_BASE=ou=users,dc=example,dc=com
  - LDAP_BIND_DN=cn=admin,dc=example,dc=com
  - LDAP_BIND_PW=your_ldap_password
  - ENABLE_SASLAUTHD=1
  - SASLAUTHD_MECHANISMS=ldap

作为本地邮件中继使用

如果您只需要将 Docker-Mailserver 作为本地邮件中继使用（不存储邮件），可以采用以下简化配置：

environment:
  - PERMIT_DOCKER=network  # 允许同一Docker网络中的容器使用
  - SPOOF_PROTECTION=0     # 禁用发件人欺骗保护（根据需求调整）
  - SSL_TYPE=letsencrypt   # 使用Let's Encrypt证书

关键配置步骤

1. DNS 记录配置：

   • 添加 MX 记录指向您的邮件服务器
   • 添加 SPF 记录（如：v=spf1 mx -all）
   • 添加 DKIM 记录（通过 setup config dkim 生成）

2. SSL 证书：

   • 推荐使用 Let's Encrypt 获取免费证书
   • 设置 SSL_TYPE=letsencrypt 自动获取

3. 用户和别名管理：

   # 添加用户
   docker exec mailserver setup email add user@example.com password
   
   # 添加别名
   docker exec mailserver setup alias add user@example.com external@gmail.com
   

安全建议

1. 定期更新容器镜像以获取安全补丁
2. 启用 Fail2Ban 防止暴力攻击
3. 配置适当的防火墙规则
4. 考虑启用 SPOOF_PROTECTION 防止发件人欺骗

常见问题排查

1. 邮件发送失败：

   • 检查 DNS MX 记录是否正确
   • 验证端口是否开放
   • 检查 SPF/DKIM/DMARC 记录配置

2. 无法接收邮件：

   • 检查容器日志（docker logs mailserver）
   • 验证邮件存储卷权限

3. 性能问题：

   • 对于高负载环境，考虑调整 Rspamd 和 ClamAV 配置
   • 监控系统资源使用情况

结语

通过本文介绍的基础配置，您应该能够成功部署一个功能完善的 Docker-Mailserver。根据实际需求，您还可以进一步探索高级配置选项，如邮件过滤规则、自动回复、Webmail 集成等功能。记得在生产环境部署前进行全面测试，并确保做好数据备份工作。

docker-mailserver Production-ready fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.) running inside a container. 项目地址: https://gitcode.com/gh_mirrors/do/docker-mailserver