Docker-Mailserver中继映射配置问题解析

问题背景

在使用Docker-Mailserver(v13.3.1)配置邮件中继时，用户遇到了中继映射未生效的问题。具体表现为：虽然通过setup.sh脚本正确添加了中继域名和认证信息，但实际发送邮件时系统并未使用配置的中继服务器，而是继续使用本地SMTP服务。

技术分析

中继配置机制

Docker-Mailserver通过Postfix实现邮件中继功能，主要涉及两个关键配置文件：

1. postfix-relaymap.cf - 存储域名与中继服务器的映射关系
2. postfix-sasl-password.cf - 存储中继服务器的认证信息

问题根源

在v13.3.1版本中，系统存在一个关键限制：必须设置RELAY_HOST环境变量才能使中继映射生效。这是代码实现上的一个设计缺陷，导致即使正确配置了中继映射，如果没有设置RELAY_HOST，系统仍会默认使用本地SMTP服务。

临时解决方案

1. 设置RELAY_HOST环境变量为空白值(" ")可以强制启用中继映射功能
2. 但这种方法会导致所有外发邮件都尝试通过中继服务器发送，可能引起其他邮件发送失败

版本演进

该问题在项目的edge版本(即将发布的v14)中已得到改进：

• 移除了对RELAY_HOST的强制依赖
• 实现了更灵活的中继映射机制
• 允许仅对特定域使用中继，而其他邮件仍走正常投递路径

最佳实践建议

对于需要使用邮件中继功能的用户：

1. 如可能，建议升级到v14或更高版本
2. 在v13.x版本中：
   • 明确理解RELAY_HOST参数的影响
   • 如需仅对特定域使用中继，需要额外配置Postfix策略
   • 仔细测试各种邮件发送场景

技术原理延伸

邮件中继工作的核心在于Postfix的transport_maps机制。当配置正确时：

1. Postfix会先检查transport_maps(中继映射)
2. 匹配的邮件会被路由到指定中继服务器
3. 使用smtp_sasl_password_maps提供的认证信息登录
4. 未匹配的邮件走默认投递路径

理解这一机制有助于更灵活地配置复杂的邮件路由策略。