适用于 Linux/Windows/macOS 系统(确保已安装 Docker 环境)
1. 安装 Docker
如果尚未安装 Docker,请先完成以下步骤:
Linux (Ubuntu/Debian 示例):
sudo apt update
sudo apt install docker.io
sudo systemctl enable --now docker
- Windows/macOS:
访问 Docker 官网 下载安装包并运行。
验证安装:
docker --version
2. 拉取 Redis 镜像
从 Docker Hub 获取官方 Redis 镜像(推荐指定版本号):
docker pull redis:7.0.12 # 可替换为其他版本(如 6.2, latest)
3. 运行 Redis 容器
基础命令(无密码、默认配置):
docker run -d \
--name my-redis \
-p 6379:6379 \
redis:7.0.12
完整命令(推荐配置):
docker run -d \
--name my-redis \
-p 6379:6379 \
-v /host/data:/data \
-v /host/redis.conf:/usr/local/etc/redis/redis.conf \
--restart unless-stopped \
redis:7.0.12 \
redis-server /usr/local/etc/redis/redis.conf --appendonly yes --requirepass yourpassword
参数说明:
- -d:后台运行容器
- --name:自定义容器名称
- -p 6379:6379:映射宿主机 6379 端口到容器
- -v /host/data:/data:持久化数据存储(防止容器删除后数据丢失)
- -v /host/redis.conf:/usr/local/etc/redis/redis.conf:挂载自定义配置文件
- --restart unless-stopped:容器自动重启策略
- --requirepass:设置 Redis 访问密码(替换 yourpassword)
- --appendonly yes:启用 AOF 持久化
4. 验证 Redis 运行
检查容器状态:
docker ps | grep my-redis
查看日志:
docker logs my-redis
通过 redis-cli 连接测试:
docker exec -it my-redis redis-cli
# 输入密码验证
127.0.0.1:6379> AUTH yourpassword
OK
# 测试写入/读取数据
127.0.0.1:6379> SET test "Hello Docker Redis"
OK
127.0.0.1:6379> GET test
"Hello Docker Redis"
5. 自定义配置文件(可选)
从官网下载 Redis 配置文件模板:
wget https://raw.githubusercontent.com/redis/redis/7.0.12/redis.conf -O /host/redis.conf
修改关键配置项:
bind 0.0.0.0 # 允许远程连接
requirepass yourpassword # 密码
maxmemory 2gb # 最大内存限制
appendonly yes # 启用持久化
重启容器应用配置:
docker restart my-redis
6. 常用管理命令
停止/启动容器:
docker stop my-redis
docker start my-redis
进入容器终端:
docker exec -it my-redis /bin/bash
删除容器:
docker rm -f my-redis
注意事项
- 生产环境安全建议:
- 使用强密码并定期更换
- 限制访问 IP(通过防火墙或 Redis 配置)
- 启用 TLS 加密通信(如需外网访问)