Docker部署服务端口无法访问的排查与解决方法
更新时间：2025年11月09日 15:04:41 作者：Knight_AL
在使用 Docker 部署 Grafana 的过程中,我遇到了一个比较常见的问题：容器已经启动成功,宿主机本地能访问 Grafana 的 3000 端口,但在局域网中却无法访问,本文就为大家详细介绍了排查与解决方法,需要的朋友可以参考下
引言
在使用 Docker 部署 Grafana 的过程中，我遇到了一个比较常见的问题：容器已经启动成功，宿主机本地能访问 Grafana 的 3000 端口，但在局域网中却无法访问。
问题复现
启动命令如下：
docker run -d \ --name=grafana \ -p 3000:3000 \ --restart always \ grafana/grafana:9.5.21
在宿主机上 访问：
curl http://127.0.0.1:3000/login
可以正常返回 HTML 页面。
在局域网其他机器浏览器访问：
http://192.168.121.140:3000
却始终打不开。
当我使用 --network host 启动时，外部访问就完全正常。
初步排查
确认容器端口映射
docker ps | grep grafana
输出：
0.0.0.0:3000->3000/tcp
映射配置没问题。
确认进程监听端口
ss -tulnp | grep 3000
显示 docker-proxy 正常监听：
防火墙与 SELinux
- firewalld 已关闭
- SELinux 处于 Permissive 状态
→ 并不是防护策略阻拦。
根因分析
查阅资料后发现，问题可能出在 内核 IP 转发功能未开启。
当使用 -p 进行端口映射时，Docker 需要依赖内核的转发功能（NAT 表规则）来把外部请求转发到容器内部。如果 net.ipv4.ip_forward 关闭，即使映射正常，也无法从外部访问。
解决方案
检查 IP 转发状态
sysctl net.ipv4.ip_forward
如果输出是 0，说明转发被关闭。
开启 IP 转发
编辑配置文件：
vi /etc/sysctl.conf
添加或修改：
net.ipv4.ip_forward=1
让配置生效：
sysctl -p
重启 Docker 服务
systemctl restart docker
重新启动容器
docker restart grafana
验证结果
此时在局域网其他机器上 访问：
http://192.168.121.140:3000
Grafana 登录页面可以正常打开。
总结
- 使用
--network host时，容器直接占用宿主机端口，不依赖内核转发，因此外部访问正常。 - 使用
-p端口映射时，必须依赖内核的 IP 转发功能。如果未开启，就会出现“本地能访问，外部打不开”的情况。 - 最终解决方法就是：开启 net.ipv4.ip_forward 并重启 Docker。
到此这篇关于Docker部署服务端口无法访问的排查与解决方法的文章就介绍到这了,更多相关Docker部署服务端口无法访问内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要给大家介绍了关于利用docker如何快速搭建几个常用的第三方服务的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2018-07-07
这篇文章主要介绍了Docker搭建es和kibana的详细过程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧2023-11-11
这篇文章主要为大家详细介绍了8个你可能不知道的Docker知识，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-06-06
Dockerfile是一个创建镜像所有命令的文本文件, 包含了一条条指令和说明, 只需要在Dockerfile上添加或者修改指令, 就可生成 docker 镜像,本文给大家介绍dockerfile介绍与使用小结,感兴趣的朋友一起看看吧2023-11-11
本篇文章主要介绍了不使用sudo 执行Docker命令的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2018-04-04
在实际项目中,我们需要一套完善的镜像构建与缓存优化方案,以提升构建速度,降低带宽与存储成本,保证构建稳定性,下面我们就来看看具体实现方法吧2025-07-07
本文主要介绍了Docker安装Jenkins,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧2023-12-12
这篇文章主要介绍了解决Mac下 docker 无法 ping 通宿主机的问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-11-11
这篇文章主要介绍了如何使用Docker搭建pypi私有仓库,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-11-11
这篇文章主要介绍了IDEA 部署 Docker 到 WSL2的过程详解，本地环境Windows10+WSL2(Ubuntu)，具体操作过程跟随小编一起看看吧2021-07-07
最新评论