如何设置PHPStorm以适配Docker环境连接Redis实例？
- 内容介绍
- 文章标签
- 相关推荐
本文共计1051个文字，预计阅读时间需要5分钟。
PHPStorm 无法直接连接 Docker 中的 Redis 实例，它只能通过数据库工具窗口连接到 Redis 数据源。这种连接需要提供宿主机网络可达的地址，而不能直接使用容器名或内部 IP。
例如，使用 redis_server 这种方式定义的 docker-compose 中的服务名，在 PHPStorm 的数据源配置中是无效的；你需要将其映射到宿主机可访问的端口，并确保 Redis 配置允许外部连接（默认情况下只监听 127.0.0.1）。
为什么 PHPStorm 连不上 docker-compose 里的 redis_server？
常见错误现象：Connection refused、Could not connect to Redis at redis_server:6379、IDE 显示 “Test connection failed”。
根本原因不是 PHPStorm 配置错，而是：
- Redis 容器默认只监听
127.0.0.1:6379（即仅限容器内部 loopback），不接受来自宿主机的连接； - PHPStorm 运行在宿主机上，它尝试连接的是你填在数据源里的 host 地址（比如
localhost或127.0.0.1），而不是容器网络； - 即使你把 host 填成
redis_server，PHPStorm 也无法解析该域名（它不走 Docker 的 DNS）。
本文共计1051个文字，预计阅读时间需要5分钟。
PHPStorm 无法直接连接 Docker 中的 Redis 实例，它只能通过数据库工具窗口连接到 Redis 数据源。这种连接需要提供宿主机网络可达的地址，而不能直接使用容器名或内部 IP。
例如，使用 redis_server 这种方式定义的 docker-compose 中的服务名，在 PHPStorm 的数据源配置中是无效的；你需要将其映射到宿主机可访问的端口，并确保 Redis 配置允许外部连接（默认情况下只监听 127.0.0.1）。
为什么 PHPStorm 连不上 docker-compose 里的 redis_server？
常见错误现象：Connection refused、Could not connect to Redis at redis_server:6379、IDE 显示 “Test connection failed”。
根本原因不是 PHPStorm 配置错，而是：
- Redis 容器默认只监听
127.0.0.1:6379（即仅限容器内部 loopback），不接受来自宿主机的连接； - PHPStorm 运行在宿主机上，它尝试连接的是你填在数据源里的 host 地址（比如
localhost或127.0.0.1），而不是容器网络； - 即使你把 host 填成
redis_server，PHPStorm 也无法解析该域名（它不走 Docker 的 DNS）。