Docker-Mailserver 附件大小限制配置指南

问题背景

在使用 Docker-Mailserver 邮件服务器时，用户经常遇到附件大小限制的问题。虽然通过环境变量设置了较大的附件限制（如 102400000 字节），但在实际使用中（如通过 Gmail 客户端）仍然会遇到 10.2MB 的限制提示。

技术原理

邮件服务器的附件大小限制主要由 Postfix 的 message_size_limit 参数控制。这个参数决定了服务器能够接收的邮件总大小（包括附件）。默认情况下，Docker-Mailserver 设置为 10.24MB。

正确配置方法

1. 环境变量设置

在 docker-compose.yml 中，应正确设置以下环境变量：

environment:
  POSTFIX_MESSAGE_SIZE_LIMIT: 102400000  # 约100MB
  CLAMAV_MESSAGE_SIZE_LIMIT: 150M       # 防病毒扫描限制

2. 容器重启注意事项

修改配置后，必须使用以下命令确保配置生效：

docker compose up --force-recreate

简单的重启可能不会加载新配置，这是许多用户遇到问题的常见原因。

测试验证方法

1. 创建测试文件

truncate --size 20MB /tmp/test-file.txt

2. 使用 swaks 工具测试

swaks --port 25 --from [e-mail] --to [e-mail] --attach @/tmp/test-file.txt

成功发送不会有输出，失败则会显示错误信息。

技术细节说明

1. Base64 编码影响：邮件附件使用 Base64 编码会增加约30%的大小。因此100MB的限制实际对应约75MB的原始文件。

2. 多组件协调：除了 Postfix，还需要确保 ClamAV 等组件的限制也相应提高，避免成为瓶颈。

3. 客户端缓存问题：某些邮件客户端可能会缓存服务器能力信息，导致修改后仍显示旧限制。清除客户端缓存或等待缓存过期可解决。

最佳实践建议

1. 设置合理的附件大小限制，考虑服务器存储和带宽资源。

2. 对于大附件，建议使用云存储链接替代直接发送。

3. 定期测试附件限制是否按预期工作。

4. 记录配置变更，便于问题排查。

通过以上方法和注意事项，可以确保 Docker-Mailserver 的附件大小限制按预期工作，满足业务需求。