Listmonk本地邮件服务器配置指南：解决SMTP连接问题

在自托管邮件营销平台Listmonk的部署过程中，许多用户会选择搭配本地邮件服务器（如Postal）构建完整的邮件收发体系。本文将深入探讨这种架构下的SMTP配置要点，特别是当Listmonk与邮件服务器同主机部署时的网络连接问题。

本地SMTP配置基础

当Listmonk与邮件服务器部署在同一VPS时，其SMTP配置与远程连接存在显著差异：

1. 禁用TLS加密：本地回环通信无需传输层加密
2. 特殊主机地址：不应使用公网域名或IP
3. 默认端口：传统SMTP服务使用25端口

典型配置应为：

• 主机：127.0.0.1
• 端口：25
• 认证：邮件服务器创建的用户凭证

Docker环境下的网络隔离问题

在实际部署中，特别是使用Docker容器时，直接使用127.0.0.1往往会导致"connection refused"错误。这是因为：

1. Docker默认创建虚拟网络栈
2. 各容器拥有独立的网络命名空间
3. 127.0.0.1指向容器自身而非宿主机

解决方案

针对Docker环境，可采用以下任一方案：

方案一：使用Docker网关IP

• 查找Docker网桥网关地址（通常为172.17.0.1）
• 在SMTP配置中使用该网关地址
• 需确保邮件服务器监听所有接口

方案二：配置host网络模式

• 启动容器时添加--network host参数
• 容器将共享宿主网络栈
• 此时可使用127.0.0.1访问宿主服务

方案三：创建自定义网络

1. 建立自定义Docker网络

   docker network create listmonk_net
   

2. 将Listmonk和邮件服务器加入同一网络
3. 使用容器名称作为主机地址

安全注意事项

虽然本地通信无需TLS，但仍需注意：

• 限制SMTP服务的监听范围
• 配置适当的防火墙规则
• 使用强密码认证
• 定期更新服务组件

测试与验证

配置完成后，建议通过以下方式验证：

1. 使用telnet测试端口连通性
2. 发送测试邮件并检查日志
3. 监控邮件队列状态

通过正确理解本地网络环境和Docker网络模型，可以高效解决Listmonk与本地邮件服务器的集成问题，构建稳定可靠的邮件营销基础设施。