Docker 创建或启动容器时出现 port is already allocated、Ports are not available，意味着 Docker 无法占用指定的主机端口。冲突发生在主机端口这一侧，不等于容器内部服务端口已经被占用。
正确处理方式是先找出端口的现有所有者，再决定停止旧服务、修改新容器映射，还是把端口只绑定到本地地址。不要看到报错就重启 Docker 或结束未知进程。
先分清主机端口和容器端口
下面的参数把主机 8080 映射到容器 80：
docker run -d --name web -p 8080:80 nginx报错中的冲突通常是主机 8080 已被占用。多个容器可以各自监听内部 80，但不能在相同协议、相同主机地址上同时绑定同一个主机端口。
如果 Compose 配置为：
services:
web:
ports:
- "8080:80"也应从左侧的 8080 开始检查。不要为了避开错误随意改容器内部端口，否则可能同时破坏镜像原有的监听配置和健康检查。
查找占用端口的容器
Docker 可以按已发布端口过滤运行中的容器：
docker ps --filter publish=8080 \
--format 'table {{.ID}}\t{{.Names}}\t{{.Ports}}'
docker compose ps还可以检查全部容器，确认是否有旧项目残留：
docker ps -a --format 'table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}'如果发现占用者，先确认它属于哪个 Compose 项目、是否仍承载业务，再决定操作。停止和删除容器是两件事；没有确认用途前，不要直接执行 docker rm -f。
排除宿主机上的非Docker进程
Docker 列表没有结果时，检查 TCP 和 UDP 监听者：
sudo ss -ltnp '( sport = :8080 )'
sudo ss -lunp '( sport = :8080 )'也可以查看端口对应的进程和服务：
sudo lsof -nP -iTCP:8080 -sTCP:LISTEN
sudo systemctl status nginx apache2 --no-pager端口可能由 Nginx、面板、旧的容器代理或独立应用占用。先通过 PID、命令行和 systemd 单元确认身份，再按服务自己的停止流程处理。强制 kill -9 可能导致进程被守护程序重新拉起，也可能造成未写完的数据丢失。
安全释放端口或修改映射
如果旧容器已经废弃，可先正常停止：
docker stop old-web如果两个服务都要保留，把新服务映射到其他主机端口：
docker run -d --name web2 -p 127.0.0.1:8081:80 nginxCompose 可改为：
services:
web:
ports:
- "127.0.0.1:8081:80"未指定主机地址时，Docker 通常会把发布端口绑定到所有主机地址，使其可能被外部访问。如果只供本机反向代理使用，应明确绑定 127.0.0.1，不要仅为解决冲突而扩大公网暴露。
更换云服务器时，可先在 萤光云 或 LightNode 的测试实例验证映射、反向代理和防火墙规则，再切换生产流量。
重建容器并完成端口验收
修改 Compose 文件后重建服务：
docker compose up -d
docker compose ps核对容器实际发布的端口：
docker inspect --format '{{json .NetworkSettings.Ports}}' web
sudo ss -ltnp '( sport = :8081 )'
curl -I http://127.0.0.1:8081/如果需要公网访问，还要检查云防火墙、安全组和宿主机防火墙；如果只绑定到 127.0.0.1，外部不可直连是预期结果。验收标准是容器持续运行、监听地址符合设计、健康请求成功，并且没有意外开放到所有网卡。
FAQ
TCP和UDP可以使用相同的端口号吗？
可以，它们是不同协议的端口空间。但 Docker 映射时仍应明确 /tcp 或 /udp，并分别检查监听和防火墙规则。
Dockerfile里的EXPOSE会直接占用主机端口吗？
不会。EXPOSE 主要用于声明容器预期端口；真正发布到主机通常由 -p、--publish-all 或 Compose 的 ports 完成。
重启Docker能解决端口冲突吗？
如果端口确实被另一个合法服务占用，重启不会消除配置冲突，还会中断其他容器。只有确认是守护进程异常且已评估影响时才考虑重启。
温馨提示
端口冲突的处理重点不是尽快释放，而是确认谁在监听以及新映射应该暴露到哪里。 生产环境变更前请记录原映射、反向代理和防火墙规则，并预留回滚端口，避免修复启动错误后又引入公网暴露风险。
