Redis 连接异常怎么查？AI Agent 检查端口、密码、绑定地址和日志

部署 AI Agent 或 n8n 这类自动化工作流时，Redis 连接超时或拒绝访问是最高频的报错之一。很多开发者在主机选反馈，明明 `systemctl` 显示 Redis 服务正在运行，但 Agent 就是一直报错。这通常不是 Redis 坏了，而是端口、绑定地址或认证配置没对齐。别急着重装系统，按下面步骤排查，90% 的问题能定位到。

Redis 连接异常排查思路

遇到连接问题，先确认是“连不上”还是“连上了被拒绝”。这两种情况对应的配置完全不同。我们要依次检查端口、绑定地址、密码和日志。

#### 检查端口与防火墙状态

Redis 默认监听 6379 端口。如果 Agent 和 Redis 在同一台 VPS，通常走内网，问题不大；如果跨机器或通过 Docker 容器隔离，端口状态就很关键。

先看 Redis 到底监听在哪个地址上：

netstat -tlnp | grep redis
ss -tlnp | grep redis

如果输出是 `127.0.0.1:6379`，说明只接受本机访问；如果是 `0.0.0.0:6379` 或 `:::6379`，则接受外部访问。如果什么都没输出，服务可能没起来。

接着看防火墙有没有拦住。如果是云服务器，还得去控制台安全组放行 6379（不推荐公网直接放行，后面细说）。

sudo ufw status

sudo firewall-cmd –list-ports

如果本地能连，远程连不上，多半是防火墙或安全组的问题。

#### 修改绑定地址解决拒绝访问

很多 AI Agent 部署在 Docker 容器里，而 Redis 直接装在宿主机。这时候容器内访问宿主机的 `127.0.0.1` 是行不通的，容器里的 localhost 指的是它自己。

打开 Redis 配置文件（通常在 `/etc/redis/redis.conf` 或 `/etc/redis.conf`），找到 `bind` 这一行：

bind 127.0.0.1

bind 0.0.0.0

改完记得重启服务：

sudo systemctl restart redis

注意：如果你在 Docker 里跑 Redis，想让它被外部容器访问，记得在 `docker run` 时用 `-p 6379:6379` 映射端口，或者在 Docker Compose 里配置 `ports`。

#### 密码配置与权限校验

为了安全，生产环境必须开密码。AI Agent 连接时报 `NOAUTH Authentication required`，就是密码没配对。

检查配置文件中的 `requirepass`：

requirepass your_strong_password_here

重启后，测试一下密码对不对：

redis-cli -h 127.0.0.1 -p 6379 -a your_strong_password_here ping

如果不想在命令行明文显示密码，可以先交互进入再 `AUTH your_password`。

AI Agent 部署中的常见坑

在 Docker 部署 Claude Code、Hermes Agent 或 n8n 时，网络层级会引入额外的复杂性。这时候“连接异常”往往是网络模型搞错了。

#### Docker 网络隔离问题

如果 Agent 和 Redis 都在 Docker 里，最稳妥的办法是把它们放在同一个 Docker Network 中。

docker network create agent-net

docker run -d –name redis –network agent-net redis:latest

docker run -d –name my-agent –network agent-net agent-image

在 Agent 的配置里，Host 地址直接填 `redis`（容器名），而不是 `localhost` 或 `127.0.0.1`。Docker 内置 DNS 会把容器名解析成对应的 IP。

如果 Redis 在宿主机，Agent 在容器里，Linux 下一般用 `host.docker.internal`（需额外启动参数支持）或者直接用宿主机的局域网 IP（如 `172.17.0.1`，具体看 `docker0` 网卡）。

#### 日志分析定位报错

命令行测试没问题，但 Agent 还是连不上？这时候必须看日志。Redis 的日志路径一般在 `/var/log/redis/` 下，或者通过 systemd 查看：

sudo journalctl -u redis -f

关注几个关键词：
* `bind`: Address already in use（端口被占）。
* `Warning`: Could not create server TCP listening socket（权限不足或配置错误）。
* `Connection accepted`: 后面跟着 `Client closed connection`，可能是连接后没发认证包就被踢了。

如果是 Docker 容器，直接看容器日志：

docker logs redis

老鸟叮嘱

1.绝对不要把 Redis 端口（6379）直接裸露在公网。一旦开了 `bind 0.0.0.0` 又没设强密码，或者密码太简单，几秒钟就会被挖矿脚本扫描到，服务器 CPU 会被跑满。必须用防火墙限制来源 IP，或者通过 SSH 隧道访问。
2.不要用 root 跑 Redis。虽然安装方便，但安全风险极大。
3.Docker 里不要用 localhost。这是新手最容易踩的坑，容器内的 localhost 和宿主机不是一回事。
4.配置保护模式。Redis 3.2 后默认开启 `protected-mode`，如果没设密码且没绑定特定 IP，外部会连不上。不要为了省事直接关掉它，正确做法是配置好密码和绑定。

FAQ

Q1：Agent 报错 `Connection refused`，但是 `telnet ip 6379` 能通，为什么？
A：能通说明网络没问题。通常是 Redis 配置了 `requirepass`，但 Agent 配置里没填密码，或者密码填错了。检查一下 Agent 的环境变量或配置文件。

Q2：Redis 在宿主机，Docker 容器里的 Agent 怎么连？
A：不要用 `127.0.0.1`。推荐使用宿主机的网关 IP，通常是 `172.17.0.1`（Bridge 模式下），或者在 Docker 启动参数中加 `–add-host=host.docker.internal:host-gateway`，然后连接 `host.docker.internal`。

Q3：修改了 `redis.conf` 为什么不生效？
A：修改完配置文件必须重启服务：`sudo systemctl restart redis`。如果是 Docker，必须重建容器，因为 Docker 镜像里的配置文件通常是只读的，需要挂载配置文件进去。

Q4：生产环境 AI Agent 连接 Redis 延迟很高怎么办？
A：首先确认 Agent 和 Redis 是否在同一机房或同一内网。跨公网连接 Redis 延迟和不稳定性都很大。其次检查 Redis 是否开启了持久化（RDB/AOF），如果内存不足频繁刷盘，会导致阻塞。

Q5：怎么确认 Redis 是否被入侵？
A：看 `info clients` 连接数是否异常暴增，看 `slowlog` 是否有奇怪的 keys 命令。最直接的是看 CPU 占用，`top` 命令里如果 redis 进程 CPU 飙升到 100% 且业务量很小，大概率是被拿去挖矿了。

排查 Redis 连接异常本质上是排查网络、权限和配置的匹配问题。只要理清 Agent 和 Redis 的网络位置关系，无论是裸机部署还是 Docker 容器化，都能快速定位症结。