Docker容器内Node应用无法连接本地Redis Stack Server

核心原因 #

Docker容器内的localhost指向容器自身的环回接口，而非宿主机。所以容器内应用尝试连接127.0.0.1:6379时，实际是在容器内部寻找Redis服务，自然会连接失败。

解决方案 #

1. 确保Redis允许外部访问 #

默认Redis Stack Server可能仅绑定127.0.0.1，只允许宿主机本地访问。需要修改启动参数，让Redis绑定所有网卡：

redis-stack-server --bind 0.0.0.0

2. 替换容器内的Redis连接地址 #

根据你的操作系统，选择对应的宿主机地址：

情况1：Windows/macOS

Docker官方提供了特殊域名host.docker.internal，可以直接映射到宿主机。修改Dockerfile中的环境变量：

FROM node:18

# 替换为宿主机的Redis地址
ENV REDIS_URL="redis://host.docker.internal:6379"
ENV NODE_PORT=3000

COPY app.js .

EXPOSE 3000
CMD [ "node", "app.js" ]

情况2：Linux

Linux下可以使用宿主机的局域网IP地址（比如192.168.1.100，根据你的实际网络配置修改），或者直接让容器共享宿主机网络：

• 方式一：修改REDIS_URL为宿主机IP

  ENV REDIS_URL="redis://192.168.1.100:6379"
  

• 方式二：使用host网络模式运行容器（无需端口映射）

  docker run --network host my-app
  

  此方式下容器直接使用宿主机网络，localhost就指向宿主机，无需修改REDIS_URL。

3. 修正Redis客户端配置 #

你的代码中createClient()没有传入连接地址，默认使用localhost:6379，需要改为读取环境变量的REDIS_URL：

export const redisC = async () => {
    // 从环境变量获取Redis连接地址
    const client : RedisClientType = createClient({ url: process.env.REDIS_URL });
    client.on('error', (err) => console.error('Redis Client Error', err));
    await client.connect();
    return client;
}

export let redisClient : RedisClientType;
redisC().then((response) => {
    redisClient = response
}).catch(error => console.error(error))

4. 重新构建并运行容器 #

docker build . -t my-app
docker run -p 3000:3000 my-app

完成以上步骤后，容器内的应用就能正常连接到宿主机上的Redis Stack Server了。

内容的提问来源于stack exchange，提问作者Gleb Galkin