Postfix Docker镜像文档

1. 镜像概述与主要用途

本镜像是基于Postfix邮件服务器的Docker镜像，旨在提供轻量级、易于部署的邮件服务。由于Postfix依赖syslog守护进程进行日志输出，镜像集成了Supervisord进程管理工具，用于协同管理Postfix主进程与rsyslog日志服务，确保服务稳定运行及日志正常记录。主要用途为快速部署SMTP服务，适用于需要简易邮件发送能力的场景。

2. 核心功能与特性

• 进程协同管理：通过Supervisord统一管理Postfix和rsyslog进程，确保两者协同启动与运行监控。
• 日志支持：内置rsyslog服务，满足Postfix对syslog的依赖，保障日志正常输出。
• 轻量级部署：基于Docker容器化设计，启动快速，资源占用低，无需复杂环境配置。
• 标准SMTP端口：默认暴露25端口（SMTP标准端口），支持灵活的端口映射。

3. 使用场景与适用范围

• 开发测试环境：用于验证应用程序邮件发送功能，快速搭建测试用邮件服务器。
• 轻量级邮件转发：作为内部网络的简易邮件转发节点，处理基础邮件路由需求。
• 临时邮件服务：适用于生命周期较短、无需复杂配置的临时邮件服务场景。

4. 使用方法与配置说明

4.1 基本运行命令

通过以下命令启动Postfix容器，将主机的***端口映射到容器的25端口（SMTP端口）：

bash
docker run --rm --name postfix -p ***:25 chatwork/postfix

参数说明：

• --rm：容器退出后自动删除，避免残留容器文件。
• --name postfix：指定容器名称为postfix，便于管理。
• -p ***:25：将主机的***端口映射到容器内的25端口（Postfix默认SMTP端口）。
• chatwork/postfix：镜像名称。

4.2 启动日志验证

容器启动后，将输出类似以下日志，表明Postfix和rsyslog进程正常运行：

2018-11-07 09:21:36,518 INFO Set uid to user 0 succeeded
2018-11-07 09:21:36,520 INFO supervisord started with pid 13
2018-11-07 09:21:37,522 INFO spawned: 'rsyslog' with pid 15
2018-11-07 09:21:37,524 INFO spawned: 'master' with pid 16
2018-11-07T09:21:37.660367+00:00 1a6c8af85c6f postfix/postfix-script[81]: starting the Postfix mail system
2018-11-07T09:21:37.663653+00:00 1a6c8af85c6f postfix/master[82]: daemon started -- version 3.3.0, configuration /etc/postfix
2018-11-07 09:21:38,665 INFO success: rsyslog entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
2018-11-07 09:21:38,665 INFO success: master entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)

4.3 服务连接测试

通过curl或telnet工具测试Postfix服务是否正常监听端口：

bash
curl telnet://localhost:***

若服务正常，将返回Postfix的SMTP欢迎信息：

220 fdb0484594ab.localdomain ESMTP Postfix

4.4 配置说明

• 默认配置：镜像使用Postfix默认配置（配置文件路径/etc/postfix），无需额外设置即可运行基础SMTP服务。
• 自定义配置：如需修改配置，可通过Docker volumes挂载自定义配置文件到容器的/etc/postfix目录，例如：

  bash
  docker run --rm --name postfix -p ***:25 -v /host/postfix/config:/etc/postfix chatwork/postfix
  

5. 相关组件说明

• Supervisord：进程管理工具，用于协调Postfix和rsyslog进程的启动与监控。官网：[***]
• rsyslog：系统日志服务，满足Postfix对日志输出的依赖。官网：[***]
• Postfix：高性能邮件传输代理（MTA），负责邮件的接收与转发。官网：[***]