Docker基础教程（177）Docker Compose命令基础之查看服务容器端口状态的port命令：端口在“捉迷藏”？Docker Compose port 命令：你的容器端口“雷达”！

引言：从一次“血泪”调试说起

“见鬼了！本地调试，docker-compose up -d 跑得好好的，日志也没报错，怎么我的前端就是访问不了后端的API？！”

相信不少 Docker 玩家都经历过这种绝望。你拍着胸脯保证 Compose 文件配置得没问题，ports 映射白纸黑字写着 "8000:8000"，但浏览器里 localhost:8000 转了半天最后给你个“无法连接”。你开始怀疑人生：是容器没启动？网络坏了？还是代码写错了？

在经过一通焦头烂额的 docker ps、docker inspect、netstat -tulnp 之后，你可能最终会发现，原来是 Compose 分配的宿主机端口根本不是你以为的 8000！尤其是在多项目或多个实例同时运行时，你想要的端口很可能已经被占用，Docker 会“贴心”地、静默地为你分配一个随机的高位端口。

这个时候，你需要的就是一个能直接、准确地告诉你“服务容器的端口到底映射在宿主机哪个端口上”的命令。它不是 ps，不是 inspect，而是今天的主角——docker-compose port。它就像是你部署地图上的一个精准雷达，一键锁定目标，让所有端口无所遁形。

第一章：port 命令是什么？为什么需要它？

1.1 它的角色定位

简单来说，docker-compose port 命令用于查询某个服务容器内部端口所映射到的宿主机端口和地址。

它不负责创建、映射端口（那是 docker-compose.yml 文件中 ports 配置项的工作），它只是一个查询工具。它的核心价值在于“翻译”——将 Compose 服务抽象的端口映射关系，翻译成实实在在能在宿主机上访问的具体地址。

1.2 为什么不用 docker ps 或 docker inspect？

你当然可以用 docker ps 看到 PORTS 列，也可以用 docker inspect <container-id> 在庞大的 JSON 输出中寻找 NetworkSettings.Ports 字段。但这些问题在于：

• 效率低下：你需要手动找到对应容器的ID或名称，再从一大堆信息中筛选。
• 不够精确：docker ps 的输出在端口很多时格式会很乱。
• 缺乏Compose上下