Docker Mailserver 项目教程

项目的目录结构及介绍

docker-mailserver/
├── .github/
├── config/
├── docker-compose.yml
├── Dockerfile
├── README.md
├── setup.sh
└── target/

• .github/: 包含 GitHub 相关的配置文件，如 CI/CD 配置。
• config/: 用于存放项目的配置文件。
• docker-compose.yml: Docker Compose 配置文件，用于定义和运行多容器 Docker 应用程序。
• Dockerfile: 用于构建 Docker 镜像的文件。
• README.md: 项目的主文档，包含项目的介绍、使用方法等。
• setup.sh: 项目的启动脚本，用于初始化和配置邮件服务器。
• target/: 包含编译和构建的输出文件。

项目的启动文件介绍

setup.sh

setup.sh 是 Docker Mailserver 项目的主要启动脚本。它负责初始化和配置邮件服务器。以下是该脚本的主要功能：

• 初始化配置: 设置基本的邮件服务器配置。
• 用户管理: 添加、删除和管理邮件用户。
• 域名管理: 添加、删除和管理邮件域名。
• 安全设置: 配置 SSL/TLS 和安全相关的设置。

使用方法：

./setup.sh [选项]

常用选项：

• -h: 显示帮助信息。
• -i: 初始化配置。
• -u [用户名]: 添加或删除用户。
• -d [域名]: 添加或删除域名。

项目的配置文件介绍

docker-compose.yml

docker-compose.yml 文件定义了 Docker Compose 服务，包括邮件服务器的配置。以下是一个示例：

version: '3.8'

services:
  mailserver:
    image: docker.io/mailserver/docker-mailserver:latest
    container_name: mailserver
    hostname: mail
    domainname: example.com
    env_file: .env
    ports:
      - "25:25"
      - "143:143"
      - "587:587"
      - "993:993"
    volumes:
      - maildata:/var/mail
      - mailstate:/var/mail-state
      - maillogs:/var/log/mail
      - ./config/:/tmp/docker-mailserver/
    environment:
      - ENABLE_SPAMASSASSIN=1
      - ENABLE_CLAMAV=1
      - ENABLE_FAIL2BAN=1
      - ENABLE_POSTGREY=1
      - ONE_DIR=1
      - DMS_DEBUG=0
    cap_add:
      - NET_ADMIN
    restart: always

volumes:
  maildata:
  mailstate:
  maillogs:

.env

.env 文件包含环境变量，用于配置 Docker Mailserver。以下是一些常用的环境变量：

# 基本配置
ENABLE_SPAMASSASSIN=1
ENABLE_CLAMAV=1
ENABLE_FAIL2BAN=1
ENABLE_POSTGREY=1
ONE_DIR=1
DMS_DEBUG=0

# 邮件域名
OVERRIDE_HOSTNAME=mail.example.com

# SSL/TLS 配置
SSL_TYPE=letsencrypt

config/

config/ 目录包含自定义配置文件，这些文件会覆盖默认配置。以下是一些常用的配置文件：

• dovecot.cf: Dovecot 配置文件。
• postfix-main.cf: Postfix 主配置文件。
• spamassassin.cf: SpamAssassin 配置文件。

使用方法：

cp config/dovecot.cf /tmp/docker-mailserver/dovecot.cf

通过这些配置文件，可以自定义邮件服务器的各种设置。