Docker容器内运行Nodemailer出现连接超时问题如何解决

• 首先纠正一个常见操作误区：你之前导出容器25/465/587端口的操作完全无效，该操作是配置容器入站端口映射，当前问题是容器主动对外发起SMTP连接请求，属于出站流量范畴，和入站端口暴露没有关联。

以下是按优先级排序的排查解决步骤：

1. 验证容器基础网络连通性 #

首先进入运行中的容器测试到Gmail SMTP的网络连通性：

# 进入容器
docker exec -it 你的容器名称 /bin/bash
# 测试端口连通性
nc -zv smtp.gmail.com 465

如果执行后提示连接失败，说明是容器网络层面的问题，继续往下排查。

2. 修复Docker DNS解析异常 #

多数场景下该问题由Docker默认网桥DNS配置异常导致，容器无法正常解析smtp.gmail.com域名：

• 单次启动容器时手动指定公共DNS：

docker run -d --dns 8.8.8.8 --dns 8.8.4.4 你的镜像名称

• 如果使用Docker Compose部署，在配置文件中添加DNS规则：

services:
  你的服务名称:
    image: 你的镜像名称
    dns:
      - 8.8.8.8
      - 8.8.4.4

3. 排查出站端口限制 #

• 先在宿主机直接执行nc -zv smtp.gmail.com 465测试，如果宿主机也无法连通，说明是上层网络限制：多数云厂商、家庭ISP会默认封禁25/465/587端口的出站请求来防控垃圾邮件，需要联系服务商申请端口解封，或者换用支持非标准端口的邮件发送服务。
• 检查宿主机防火墙、安全组规则，是否限制了Docker网桥的出站465端口请求，可临时关闭防火墙测试验证。

4. 补充Nodemailer配置优化 #

你当前的SMTP配置可以添加TLS兼容配置，避免证书校验导致的连接问题：

const smtpConfig = {
    host: 'smtp.gmail.com',
    port: 465,
    secure: true,
    auth: {
        user: process.env.USER,
        pass: process.env.PASS
    },
    // 新增TLS配置，测试环境可关闭证书校验，生产环境建议删除该行
    tls: { rejectUnauthorized: false }
};

注意：Gmail要求必须开启账号两步验证，且使用应用专用密码作为配置中的pass参数，不能直接使用账号登录密码。

5. 切换容器网络模式 #

可以尝试使用host网络模式启动容器，直接复用宿主机的网络栈，排除Docker网桥转发规则异常的影响：

docker run -d --network=host 你的镜像名称

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