本教程全程使用官方源,无第三方镜像,步骤简单易懂,重点解决「重启数据丢失」「权限异常」问题,新手可直接复制命令操作,无需额外配置。
一、前置准备(必做)
确保你的电脑已安装 Docker(Windows 需开启 WSL2,Mac/Linux 直接使用终端),Docker 服务正常运行(可通过「启动 Docker Desktop」确认)。
二、核心实操步骤(全程复制命令,无需修改)
步骤1:清理残留,避免冲突
打开终端(Windows 用 WSL 终端,Mac/Linux 直接打开终端),输入以下命令,清理之前的异常容器和残留文件:
# 停止并删除所有 Redis 相关容器(强制删除,避免冲突)
docker rm -f redis
# 清理本地残留的异常数据目录(若有)
rm -rf ~/redis/data
# 重新创建干净的数据目录,避免权限问题
mkdir -p ~/redis/data
步骤2:拉取官方镜像(确保无第三方干扰)
输入以下命令,拉取官方稳定版 Redis 镜像(版本 6.2,兼容性最强,新手首选):
docker pull redis:6.2
提示:若显示「已存在」,说明之前已拉取,无需重复操作,直接进入下一步。
步骤3:启动 Redis 容器(核心步骤,数据不丢失关键)
复制以下完整命令,直接粘贴到终端执行(无需修改,密码可后续调整):
docker run -d \
--name redis \
-p 6379:6379 \
-v ~/redis/data:/data \
--restart=always \
redis:6.2 \
redis-server --appendonly yes --requirepass 123456
说明:密码为 123456,若想修改密码,直接替换命令中的「123456」即可(如改为自己的密码)。
步骤4:验证容器正常运行
输入以下命令,确认容器和服务正常(复制粘贴即可):
# 查看容器状态
docker ps | grep redis
# 验证数据写入(确保数据落地)
docker exec -it redis redis-cli -a 123456 set test 123
# 查看是否写入成功
docker exec -it redis redis-cli -a 123456 get test
若返回「123」,说明容器和数据正常;若提示「容器未启动」,执行以下命令重启容器:
docker restart redis
三、关键验证(确保数据不丢失)
步骤1:重启电脑(模拟日常使用场景)
电脑重启后,无需手动启动容器,Docker 会自动启动 Redis(因为配置了 --restart=always)。
步骤2:验证数据是否存在
# 直接查看数据,无需进入容器
docker exec -it redis redis-cli -a 123456 get test
若返回「123」,说明数据已永久保存,重启后不丢失,配置全部生效!
四、新手必看注意事项(避坑重点)
- 不要修改任何启动命令,尤其是「-v ~/redis/data:/data」,这是数据持久化的核心,删除会导致数据丢失。
- 无需额外添加「--user」相关配置,避免权限冲突(之前的 999 权限问题已通过重新创建目录解决)。
- 若执行命令报错「容器未启动」,只需执行「docker restart redis」,等待 10 秒再重试即可。
五、总结
按照以上步骤操作,即可实现:开机自动启动 Redis、数据永久保存、无权限异常,完全满足新手使用需求,无需额外操作,复制命令就能搞定。