Overleaf CE容器与Postfix邮件服务集成问题解析

问题背景

在Ubuntu系统上部署Overleaf CE时，用户遇到邮件服务无法正常工作的情况。具体表现为Overleaf容器内的应用无法通过SMTP协议连接到本地的Postfix邮件服务器，返回"ECONNREFUSED 127.0.0.1:25"错误。

技术原理分析

这个问题本质上是Docker网络隔离特性导致的通信问题。当Overleaf运行在Docker容器中时：

1. 容器拥有独立的网络命名空间
2. 容器内的localhost(127.0.0.1)指向容器自身而非宿主机
3. 默认情况下容器无法直接访问宿主机的服务

解决方案

方案一：修改网络连接方式

将Overleaf容器的网络模式改为host模式：

docker run --network=host sharelatex/sharelatex

这样容器将直接使用宿主机的网络栈，localhost即指向宿主机。

方案二：使用宿主机真实IP

修改Overleaf配置中的SMTP主机地址为宿主机的实际IP而非localhost：

SHARELATEX_EMAIL_SMTP_HOST=宿主机IP

方案三：创建专用Docker网络

1. 创建自定义网络：

docker network create overleaf-net

2. 将Postfix和Overleaf都接入该网络
3. 使用容器名称作为主机地址

安全配置建议

1. 确保Postfix配置允许来自Docker网络的连接
2. 考虑设置SMTP认证
3. 建议启用TLS加密传输
4. 防火墙需要开放相应端口

测试验证方法

1. 进入Overleaf容器：

docker exec -it sharelatex bash

2. 安装telnet工具测试连接：

apt update && apt install -y telnet
telnet 宿主机IP 25

总结