Docker环境下GitLab通过docker-mailserver发件失败求助

核心问题定位 #

从Net::OpenTimeout错误可以明确：GitLab容器无法在超时时间内连接到邮件服务器的SMTP 587端口，这是网络层面的连通性问题，而非SMTP认证或配置逻辑错误（若为认证问题会抛出针对性报错）。

排查与修复步骤 #

1. 检查Docker网络连通性 #

• 确认GitLab与docker-mailserver容器是否在同一自定义Docker网络：

  # 查看两个容器所属网络
  docker inspect gitlab-container-name | grep Networks
  docker inspect mailserver-container-name | grep Networks
  

  若不在同一网络，将GitLab容器加入邮件服务器所在网络：

  docker network connect mailserver-network-name gitlab-container-name
  

• 在GitLab容器内部直接测试连通性：

  # 进入GitLab容器
  docker exec -it gitlab-container-name bash
  # 用telnet测试587端口连通性
  telnet mail.example.com 587
  # 或用nc测试（更简洁）
  nc -zv mail.example.com 587
  

  若连接失败，优先解决网络互通问题。

2. 修正SMTP配置冲突 #

你的gitlab.rb中同时启用smtp_tls = true和smtp_enable_starttls_auto = true，存在模式冲突：

• 587端口默认使用STARTTLS模式（先建立明文连接，再升级为TLS），而smtp_tls = true会强制使用直接TLS加密（对应端口465）。
• 修改配置：

  gitlab_rails['smtp_tls'] = false    # 改为false，适配587端口的STARTTLS模式
  

  修改后执行gitlab-ctl reconfigure使配置生效。

3. 验证DNS解析正确性 #

在GitLab容器内部测试mail.example.com的解析结果：

docker exec -it gitlab-container-name nslookup mail.example.com

若解析结果不是docker-mailserver容器的内部IP，需：

• 确保两个容器在同一网络，Docker会自动解析容器自定义域名/名称；
• 或手动在GitLab容器的hosts文件中添加邮件服务器的IP映射。

4. 检查邮件服务器端口监听状态 #

确认docker-mailserver的587端口已正确监听：

# 查看容器内部端口监听
docker exec -it mailserver-container-name netstat -tulpn | grep 587
# 查看容器端口映射情况
docker port mailserver-container-name

确保587端口在内部网络可访问，或已正确映射到宿主机。

5. 重新测试邮件发送 #

配置修正后，进入gitlab-rails控制台重新测试：

gitlab-rails console
Notify.test_email('admin@example.com', '测试邮件', '测试内容').deliver_now

内容的提问来源于stack exchange，提问作者Neji Soltani