Docker非host网络下不映射端口使用宿主机25端口方案

你遇到的端口冲突本质是配置逻辑错误：端口映射（-p参数）的作用是把宿主机端口的入站流量转发到容器内部，供外部访问容器里的服务，一个宿主机端口同一时间只能绑定一个转发目标。但你的场景是容器作为客户端主动向外连接宿主机25端口发邮件，属于容器的出站流量，根本不需要做任何25端口的映射，之前的报错完全是多余的端口绑定配置导致的。

1. 提前创建指定的自定义桥接网络 #

如果还没创建目标自定义网络，执行以下命令创建，把your-custom-net替换成你实际需要的网络名即可：

docker network create your-custom-net

2. 配置宿主机SMTP服务监听地址 #

你宿主机上运行的SMTP服务（比如Postfix、Exim等MTA）不能只绑定127.0.0.1，需要允许Docker网桥网段的访问：

• 方案1：直接监听0.0.0.0:25，同时配置防火墙规则，仅允许Docker自定义网段访问25端口，禁止公网IP访问，避免被利用发送垃圾邮件。
• 方案2：仅监听自定义Docker网桥对应的网关IP，执行以下命令可以查询该网关地址：

  docker network inspect your-custom-net | grep Gateway
  

  输出的IPv4地址就是容器访问宿主机的地址，通常为172.xx.0.1格式。
  如果你的Docker版本为20.10及以上，可以直接使用内置域名host.docker.internal访问宿主机，不需要手动查询网关IP，兼容性更好。

3. 启动容器（不要加25端口映射） #

启动两个业务容器时，完全不要添加-p 25:25这类25端口的映射参数，仅指定容器接入你提前创建的自定义网络即可，两个容器启动不会有任何端口冲突，示例命令：

# 启动第一个发邮件容器
docker run -d --name mail-sender-1 --network your-custom-net your-app-image
# 启动第二个发邮件容器，无端口冲突
docker run -d --name mail-sender-2 --network your-custom-net your-app-image

如果使用host.docker.internal域名解析失败，可以在启动命令中追加参数手动指定hosts映射：--add-host=host.docker.internal:host-gateway，不需要手动查询网关IP。

4. 配置容器内Nodemailer连接参数 #

容器内的Nodemailer不要连接127.0.0.1的25端口，需要指向宿主机的访问地址，示例配置代码：

const nodemailer = require('nodemailer');

// 初始化邮件传输实例
const transporter = nodemailer.createTransport({
  host: 'host.docker.internal', // 也可以替换为之前查询到的自定义网桥网关IP
  port: 25,
  secure: false, // 25端口默认不启用TLS，根据你的宿主机SMTP服务实际配置调整
  // 若宿主机SMTP需要认证则保留auth配置，不需要可删除
  auth: {
    user: 'your-smtp-account',
    pass: 'your-smtp-password'
  }
});

// 调用发信逻辑
transporter.sendMail({
  from: 'sender@your-domain.com',
  to: 'receiver@target-domain.com',
  subject: 'Test Mail From Docker Container',
  text: 'This is a test email sent without port mapping'
}, (err, info) => {
  if (err) return console.error('Send mail failed:', err);
  console.log('Mail sent successfully:', info.messageId);
});

• 绝对不要为了方便直接使用host网络模式，不符合你的要求同时会扩大容器的网络权限，带来不必要的安全风险。
• 宿主机25端口必须做好访问控制，仅放通Docker自定义网段的访问权限，避免被公网扫描到成为开放邮件中继。
• 两个容器的出站连接是相互独立的，不会存在端口抢占问题，哪怕同时启动几十个同网段容器发邮件都不需要额外配置端口映射。

内容的提问来源于stack exchange，提问作者Robin-Whg