Docker容器部署UDP服务器后，主机UDP客户端端口绑定报错解决

问题根源 #

1. 端口占用：docker run时使用-p 8001:8001/udp会让主机的8001 UDP端口被Docker端口映射服务占用，导致主机客户端绑定该端口失败。
2. 目标地址错误：容器内的127.0.0.1是容器自身的回环地址，服务器发送的消息无法到达主机。

修复步骤 #

1. 修改服务器代码（server.py） #

将发送目标地址从容器内部回环改为主机的可访问地址：

• Windows/macOS的Docker Desktop环境，直接用host.docker.internal；
• Linux Docker环境，后续运行容器时需添加参数，代码中同样用host.docker.internal；
• 也可直接填写主机的局域网IP（如192.168.1.100）。

修改后的server.py：

import socket
from time import sleep

write_socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)

# 替换为你的主机IP或host.docker.internal
target_host = "host.docker.internal"
while True:
    write_socket.sendto("Hello!".encode("utf-8"), (target_host, 8001))
    sleep(0.1)

2. 调整Docker运行命令 #

服务器是主动发送UDP包，无需端口映射（映射反而会占用主机端口）。Linux环境需额外添加参数让容器解析host.docker.internal：

Windows/macOS Docker Desktop：

docker build . -t pyserver
docker run -it --rm pyserver python ./server.py

Linux Docker：

docker build . -t pyserver
docker run -it --rm --add-host=host.docker.internal:host-gateway pyserver python ./server.py

3. 运行主机客户端 #

直接在主机执行客户端命令即可，此时8001端口未被占用，客户端能正常绑定并接收消息：

python3 client.py

额外说明 #

如果不想修改服务器代码中的目标地址，也可修改客户端监听端口（如改为8002），同时将服务器发送目标端口改为8002，运行容器时使用-p 8002:8002/udp。不过这种方式没必要，因为服务器主动发送场景下不需要端口映射。

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