redis://localhost:6379 连接说明与本地安装
看到 redis://localhost:6379 或 redis localhost 时如何连接？本文说明 URI、redis-cli、Docker 启动与 Connection refused 排查。
日志或配置里的 redis://localhost:6379、redis localhost、REDIS_URL=redis://localhost:6379，表示应用要连本机 Redis（默认端口 6379）。这是连接串，不是用浏览器打开的网页。
连接串速查
| 用途 | URI / 配置 |
|---|---|
| 默认（无密码） | redis://localhost:6379 |
| 指定库号（DB 0–15） | redis://localhost:6379/0 |
| 带密码 | redis://:password@localhost:6379/0 |
| 环境变量 | REDIS_URL=redis://localhost:6379 |
| 分拆配置 | host=localhost，port=6379 |
其它写法：redis_url=redis://localhost:6379、redis url localhost。
端口说明见 localhost 端口速查 §6379。
用客户端验证
redis-cli
redis-cli -u redis://localhost:6379 ping
# 应返回 PONG
redis-cli
SET user:1 "Alice"
GET user:1
KEYS *在应用中
// ioredis 示例
const Redis = require('ioredis');
const redis = new Redis(process.env.REDIS_URL || 'redis://localhost:6379');| 场景 | 说明 |
|---|---|
| API 缓存 | 减轻数据库压力 |
| Session | Express connect-redis、Next.js 适配器 |
| 队列 | Bull / BullMQ（NestJS 常用） |
| 限流 | 滑动窗口计数 |
安装与启动
macOS：
brew install redis
brew services start redis
redis-cli pingUbuntu：
sudo apt install redis-server
sudo systemctl start redis-serverDocker：
docker run -d --name redis -p 6379:6379 redis:7Docker Compose：
services:
redis:
image: redis:7
ports:
- '6379:6379'应用侧：REDIS_URL=redis://localhost:6379（Compose 同网络内主机名用服务名 redis）。
常见报错
Error: connect ECONNREFUSED 127.0.0.1:6379
Redis 未启动，或端口不是 6379。用 redis-cli ping / lsof -i :6379 确认。
NOAUTH Authentication required
服务器开了 requirepass，URI 需带密码：redis://:你的密码@localhost:6379。
Docker 映射冲突
本机已有 Redis 时改映射：-p 6380:6379，应用改为 redis://localhost:6380。
勿把无密码 Redis 绑到 0.0.0.0 并暴露公网
本地保持 bind 127.0.0.1 即可。
端口冲突见 port-conflicts；文档库见 MongoDB。
小结
redis://localhost:6379 = 本机默认 Redis。先 redis-cli ping 通，再写入 REDIS_URL 或框架配置。