Docker容器调用主机SMTP服务器连接失败问题求助

已验证可行的操作 #

主机本地直接发送邮件正常：

[HOST]$ echo "Test mail." | mail -s "message" my@mail.com # works

使用--net=host模式启动容器，可通过localhost连接主机SMTP服务：

[HOST]$ sudo docker run --net=host -it python
[python-container] >>> import smtplib
[python-container] >>> s = smtplib.SMTP('localhost')
[python-container] >>> s.sendmail("from@mail.com",["my@mail.com"],"message") # works

不可行的操作及报错 #

默认网络模式下直接使用host.docker.internal，出现域名解析失败：

[HOST]$ sudo docker run -it python
[python-container] >>> import smtplib
[python-container] >>> s = smtplib.SMTP('host.docker.internal')

socket.gaierror: [Errno -2] Name or service not known

添加--add-host映射后，出现连接被拒绝：

[HOST]$ sudo docker run --add-host=host.docker.internal:host-gateway -it python
[python-container] >>> import smtplib
[python-container] >>> s = smtplib.SMTP('host.docker.internal')

ConnectionRefusedError: [Errno 111] Connection refused

系统环境 #

• Rocky Linux 8.7
• Docker 20.10.22

问题原因及解决方法 #

原因 #

主机SMTP服务器默认只监听127.0.0.1（localhost），而host.docker.internal指向的是主机的外部网卡IP，SMTP服务没在这个IP上监听，所以容器连接被拒绝。--net=host模式下容器共享主机网络栈，localhost直接指向主机的回环地址，因此能正常访问。

解决步骤 #

1. 修改SMTP服务监听地址
   以常用的Postfix为例，编辑配置文件/etc/postfix/main.cf，找到inet_interfaces参数，修改为监听所有网卡：

   inet_interfaces = all
   

   也可以指定主机的具体IP（比如192.168.1.100），多个IP用逗号分隔。修改后重启服务：

   sudo systemctl restart postfix
   

   如果用的是Sendmail等其他SMTP服务，对应修改监听地址配置即可。

2. 验证容器连接
   重新用--add-host参数启动容器，尝试发送邮件：

   [HOST]$ sudo docker run --add-host=host.docker.internal:host-gateway -it python
   [python-container] >>> import smtplib
   [python-container] >>> s = smtplib.SMTP('host.docker.internal')
   [python-container] >>> s.sendmail("from@mail.com",["my@mail.com"],"message")
   

3. 防火墙配置（可选）
   如果主机开启了防火墙，需要开放SMTP默认端口（25）：

   sudo firewall-cmd --add-port=25/tcp --permanent
   sudo firewall-cmd --reload
   

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