Docker容器中部署Python TCP服务器遇端口分配失败问题求助

先从最常见的原因逐一排查：

• 检查服务器代码的绑定地址
  打开你的server.py，确认绑定的IP是0.0.0.0而不是127.0.0.1或者某个特定IP。示例正确的绑定代码：

  import socket
  
  server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
  server_socket.bind(('0.0.0.0', 5511))  # 必须绑定0.0.0.0才能让外部访问
  server_socket.listen(5)
  

  容器内的127.0.0.1是自身回环地址，外部无法访问；如果代码绑定了宿主机的特定IP，容器内不存在该IP，直接会导致端口分配失败。

• 检查容器内端口是否被占用
  运行容器进入交互模式，手动查看端口占用情况：

  docker run -it --rm --entrypoint bash 你的镜像名称
  

  进入容器后先安装工具再查端口：

  apt update && apt install -y net-tools
  netstat -tulpn | grep 5511
  

  如果输出显示有其他进程占用5511端口，要么停止该进程，要么修改服务器代码更换端口。

• 检查容器运行命令的网络模式
  如果你用了--network=host参数，容器会共享宿主机的网络栈。此时如果宿主机上已有进程占用5511端口（比如本地运行的服务器没关闭），容器就无法绑定该端口。解决办法：

  1. 关闭宿主机上的服务器进程，再重新启动容器；
  2. 改用Docker默认的bridge网络，加上端口映射命令：

     docker run -p 5511:5511 你的镜像名称
     

• 极端情况：端口权限问题
  虽然5511是1024以上的非特权端口，理论上无需root权限，但如果代码有特殊权限要求，可以尝试以root用户运行容器：

  docker run --user root -p 5511:5511 你的镜像名称
  

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