Docker Redis 本地能 Ping 通但 6379 端口连不上?排查记录与解决

这是一篇为您定制的 CSDN 风格博文。您可以直接复制到 CSDN 编辑器中发布。


🐛 Docker Redis 本地能 Ping 通但 6379 端口连不上?排查记录与解决

摘要 :在 Linux 服务器上部署 Redis Docker 容器,本地连接正常,但远程主机 telnet 端口不通。经过层层排查,最终发现是 Linux 内核参数 net.ipv4.ip_forward 被关闭导致的。本文记录了完整的排查思路与解决方案。

🔴 问题现象

环境信息:

  • 宿主机 IP :192.168.105.222 (CentOS)
  • Redis 版本 :redis:7.4.6 (Docker)
  • 端口映射 :0.0.0.0:6379->6379/tcp

故障表现:

在宿主机本地使用 redis-cli 连接一切正常,但在远程 Windows 机器上测试:

  1. Ping 正常(网络层通畅)
  2. Telnet 失败(TCP 连接拒绝/超时)
powershell 复制代码
PS C:\Users\User> ping 192.168.105.222
来自 192.168.105.222 的回复:字节=32 时间=1ms TTL=64

PS C:\Users\User> telnet 192.168.105.222 6379
正在连接192.168.105.222...无法打开到主机的连接。 在端口 6379: 连接失败

🔍 排查过程

第一步:检查 Redis 配置(排除法)

最常见的原因是 Redis 开启了保护模式或设置了密码。

bash 复制代码
$ docker exec redis redis-cli CONFIG GET protected-mode
1) "protected-mode"
2) "no"  ✅ 已关闭

$ docker exec redis redis-cli CONFIG GET requirepass
1) "requirepass"
2) ""    ✅ 无密码

结论:Redis 配置没有问题。

第二步:检查 Docker 端口映射

确认 Docker 是否真的在监听外部端口。

bash 复制代码
$ docker ps --format "table {{.Names}}\t{{.Ports}}"
NAMES    PORTS
redis    0.0.0.0:6379->6379/tcp, :::6379->6379/tcp

$ ss -tlnp | grep 6379
LISTEN 0 1024 *:6379 *:* users:(("docker-proxy",pid=44615,fd=4))

结论 :端口映射正常,docker-proxy 正在监听 0.0.0.0。

第三步:检查防火墙与 iptables

bash 复制代码
$ systemctl status firewalld
Active: inactive (dead)  ✅ 防火墙已关闭

$ iptables -L -n | grep 6379
ACCEPT tcp -- 0.0.0.0/0 172.17.0.3 tcp dpt:6379 ✅ 规则存在

结论:防火墙未拦截,NAT 规则已生成。

第四步:检查 IP Forwarding(🔥 锁定元凶)

Docker 容器网络依赖宿主机的 IP 转发 功能。如果该功能被禁用,宿主机将无法将数据包从物理网卡转发到 Docker 网桥。

bash 复制代码
$ sysctl net.ipv4.ip_forward
net.ipv4.ip_forward = 0  ❌ 发现异常!

分析 :

虽然 iptables 允许了流量,但 Linux 内核层面的 IP 转发开关是关闭的 (0)。这意味着当外部请求到达宿主机网卡后,内核拒绝将其转发给 Docker 容器,导致连接在 TCP 层直接被丢弃。


🛠️ 解决方案

方法一:临时修复(立即生效,重启失效)

bash 复制代码
sudo sysctl -w net.ipv4.ip_forward=1

方法二:永久修复(推荐,写入配置)

编辑 /etc/sysctl.conf,添加或修改以下参数:

bash 复制代码
echo 'net.ipv4.ip_forward = 1' >> /etc/sysctl.conf
sudo sysctl -p

✅ 验证结果

再次执行检查,确认参数已变为 1:

bash 复制代码
$ sysctl net.ipv4.ip_forward
net.ipv4.ip_forward = 1

此时远程机器再次尝试连接:

powershell 复制代码
PS C:\Users\User> telnet 192.168.105.222 6379
Connected to 192.168.105.222.  (连接成功!)

💡 原理分析:为什么需要 ip_forward?

Docker 默认使用 bridge 网络模式,这是一种 NAT(网络地址转换)模式:

复制代码
[远程客户端] -> (宿主机 IP:6379) -> [docker-proxy] -> (iptables NAT) -> [容器 IP:6379]
  1. 接收包:数据包到达宿主机的物理网卡(eth0)。
  2. 路由判断:内核发现目标 IP 是容器 IP(172.17.0.x),需要将包发送到 docker0 网桥。
  3. 转发检查 :因为是从一个接口进,另一个接口出,这属于**转发(Forwarding)**行为。
    • 如果 net.ipv4.ip_forward = 0:内核直接丢弃包 ❌
    • 如果 net.ipv4.ip_forward = 1:内核允许包通过,交由 iptables 处理 ✅

📝 总结

遇到 "本地能通,远程不通" 的 Docker 端口问题时,除了检查防火墙和端口映射,千万别忽略内核参数 net.ipv4.ip_forward。

特别是有些系统安全加固脚本或最小化安装的系统,默认会关闭此参数,导致 Docker 网络功能受损。


如果你觉得这篇博文对你有帮助,欢迎点赞 👍 收藏 ⭐ 支持一下!

相关推荐
戊本菌14 小时前
进程(三)runqueue 与 Linux 的 O(1) 调度
linux·运维·服务器
光电笑映16 小时前
TCP 为什么可靠?从三次握手、滑动窗口到拥塞控制全面拆解(下)
linux·网络·网络协议·tcp
yz_aiks17 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
Flynn Liang19 小时前
大模型成本优化:基于 Redis 的可验证语义缓存架构
人工智能·redis·缓存·架构·ai agent·智能体
hi_ro_a20 小时前
Ext系列⽂件系统详解
linux·服务器·操作系统
SA-D21 小时前
Redis 架构要点:性能、持久化、缓存故障与分布式锁的边界
redis·缓存·架构
苜蓿muxu1 天前
缓存三大问题:穿透、击穿、雪崩
数据库·redis
你住过的屋檐1 天前
【SeaweedFS】Linux上搭建SeaweedFS文件存储服务完整教程
linux·运维·服务器
少司府1 天前
嵌入式外设篇(三)GPIO·三:MCU系统结构、总线与统一编制
linux·python·stm32·单片机·嵌入式硬件·mcu·嵌入式软件
不积跬步无以至千里mmbb261 天前
Rust三大核心:Trait Crate Mod详解
linux·rust