Docker端口映射报bind: address already in use换端口仍报错求助

1. 优先检查IPv6端口占用情况 #

报错日志明确显示是IPv6地址[::]的端口绑定失败，默认netstat命令可能只查询IPv4端口，使用如下命令全量查询端口占用：

# 同时查询IPv4/IPv6端口占用
sudo ss -tulpn 'sport = :9999'
# 或者用netstat全量查询
sudo netstat -tulpn | grep :9999

如果查询到占用进程，直接结束对应进程即可。 #

2. 清理Docker残留iptables规则 #

Docker异常退出后会残留nat表端口映射规则，会出现逻辑上端口被占用但系统层查询不到的情况，按如下步骤清理：

1. 停止Docker相关服务：

sudo systemctl stop docker
sudo systemctl stop docker.socket

2. 清理iptables残留规则：

sudo iptables -t nat -F
sudo iptables -t nat -X
sudo iptables -F
sudo iptables -X

3. 重启Docker恢复默认规则：

sudo systemctl start docker

重启完成后重新测试端口映射功能。 #

3. 关闭Docker userland proxy验证 #

Docker 19.03版本的userland proxy偶发bug会导致端口绑定异常，可临时禁用验证：

1. 编辑Docker配置文件/etc/docker/daemon.json（不存在则新建），添加如下配置：

{
  "userland-proxy": false
}

2. 重启Docker生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

禁用userland proxy不会影响正常端口转发功能，反而会提升转发性能。 #

4. 检查宿主机端口范围限制 #

如果所有端口都提示被占用，检查系统动态端口分配范围是否覆盖了你要使用的端口：

cat /proc/sys/net/ipv4/ip_local_port_range

如果映射的端口在输出的区间内，可选择区间外的端口（推荐10000~60000区间外的端口），或者手动调整系统动态端口范围。 #

5. 检查安全模块拦截 #

Ubuntu 18.04默认的ufw防火墙、AppArmor模块可能会拦截Docker的端口绑定操作，可临时关闭验证：

• 临时关闭ufw防火墙：

sudo ufw disable

• 临时卸载AppArmor的Docker规则：

sudo aa-teardown docker

测试恢复正常后，调整对应安全规则放行Docker的端口绑定权限即可。 #

6. 重建Docker默认网桥 #

Docker0网桥配置异常也会导致端口绑定失败，可按如下步骤重建：

sudo systemctl stop docker
sudo ip link set dev docker0 down
sudo brctl delbr docker0
sudo systemctl start docker

Docker启动时会自动重建默认网桥，完成后重新测试端口映射。

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