容器与云原生 / 系统课时

排查端口无法访问

排查端口无法访问

本课解决“容器显示正在运行,但浏览器或客户端无法访问服务”的问题。你将沿着应用监听、容器端口、端口映射、宿主机访问和外部防火墙逐层验证,避免只凭端口号猜测原因。

学习目标

  • 区分容器端口、宿主机端口和应用监听地址
  • 使用由内到外的顺序定位网络中断位置
  • 修复端口未映射、仅监听本地回环和防火墙拦截问题

先画清访问链路

访问 http://宿主机地址:18080 时,请求链路是:客户端到宿主机 18080,Docker 再转发到容器端口,例如 8000,最后由容器内应用接收。

-p 18080:8000 只建立转发规则,不会自动让应用监听 8000。如果应用没有启动、监听了其他端口,或只绑定容器内的 127.0.0.1,外部请求仍会失败。

建立一个可验证的正确示例

下面启动一个静态 HTTP 服务,容器内监听 0.0.0.0:8000,宿主机发布为 18080:

bash
docker rm -f port-demo 2>/dev/null || true
docker run -d \
  --name port-demo \
  -p 18080:8000 \
  python:3.12-alpine \
  sh -c 'mkdir -p /site && printf "port-ok\n" > /site/index.html && cd /site && python -m http.server 8000 --bind 0.0.0.0'

sleep 2
docker ps --filter name=port-demo
docker port port-demo
docker exec port-demo wget -qO- http://127.0.0.1:8000
curl -fsS http://127.0.0.1:18080

预期输出

text
CONTAINER ID   IMAGE                 COMMAND                  STATUS         PORTS                     NAMES
<ID>           python:3.12-alpine    "sh -c 'mkdir ...'"     Up <TIME>      0.0.0.0:18080->8000/tcp   port-demo
8000/tcp -> 0.0.0.0:18080
port-ok
port-ok

<ID> 和 <TIME> 为动态值。容器内请求与宿主机请求都成功,说明应用监听和 Docker 端口转发均正常。

按由内到外的顺序定位

第一步,在容器内请求服务。若容器内也失败,问题通常在应用进程、监听端口或应用配置,应先查看 docker logs <容器名>。

第二步,执行 docker port <容器名> 或查看 docker ps 的 PORTS 列。若没有映射,需重新创建容器并添加 -p;已经运行的容器不能直接补加端口映射。

第三步,从宿主机访问 127.0.0.1:<宿主机端口>。若容器内成功而宿主机失败,重点检查应用是否绑定 0.0.0.0、端口映射是否对应,以及宿主机端口是否被其他进程占用。

第四步,从其他机器访问宿主机地址。若本机成功而远程失败,问题通常位于系统防火墙、云安全组、路由或入口代理。可用以下命令检查关键状态:

bash
docker logs --tail 50 port-demo
docker inspect port-demo --format '{{json .NetworkSettings.Ports}}'
curl -fsS http://127.0.0.1:18080
sudo ufw status

预期结果

text
日志中出现对 / 的成功请求;
端口信息包含 "8000/tcp":[{"HostIp":"0.0.0.0","HostPort":"18080"}];
curl 输出 port-ok;
UFW 输出 Status: inactive,或显示 18080/tcp 已允许。

不同系统的防火墙工具可能是 ufw、firewalld 或云平台安全组,实际输出会不同。

重点检查监听地址

应用监听 127.0.0.1 时,只接受容器自身回环请求;Docker 转发到的是容器网卡地址,因此外部无法连接。容器化服务通常应监听 0.0.0.0,再通过端口映射和防火墙控制暴露范围。

以 Python 服务为例,错误与正确写法分别是:

bash
python -m http.server 8000 --bind 127.0.0.1
python -m http.server 8000 --bind 0.0.0.0

预期结果

text
第一条仅允许容器内部通过 127.0.0.1 访问;
第二条监听容器全部 IPv4 网卡,可通过已配置的 Docker 端口映射访问。

不要把“监听全部网卡”理解为必须向公网开放。是否能被外部访问,还取决于 -p 绑定地址、宿主机防火墙、云安全组和上游代理。

检查端口冲突与协议误判

创建容器时若出现 port is already allocated,说明宿主机端口已被占用。应更换宿主机端口或停止冲突进程,不能通过修改容器内端口绕过宿主机冲突。

还要确认协议一致:HTTP 服务不能直接用 HTTPS 访问,UDP 服务必须使用 UDP 映射,例如 -p 5353:5353/udp。反向代理场景还需检查代理上游是否填写了容器可达地址,而不是错误地指向代理容器自己的 127.0.0.1。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查端口无法访问

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通