Docker Desktop安装Redis并挂载配置文件方式

2026-03-28 07:48:02发布 2次浏览

详情描述

1. 创建目录结构

# 创建 Redis 配置和数据目录
mkdir -p ~/docker/redis/conf
mkdir -p ~/docker/redis/data

2. 下载或创建 Redis 配置文件

方式一：下载官方默认配置

# 下载 Redis 官方配置文件
cd ~/docker/redis/conf
wget https://raw.githubusercontent.com/redis/redis/7.0/redis.conf
# 或者手动创建配置文件

方式二：创建自定义配置文件 (推荐)

创建 ~/docker/redis/conf/redis.conf 文件：

# 基本配置
bind 127.0.0.1
port 6379
daemonize no
pidfile /var/run/redis_6379.pid
loglevel notice
logfile ""

# 数据持久化
save 900 1
save 300 10
save 60 10000
stop-writes-on-bgsave-error yes
rdbcompression yes
rdbchecksum yes
dbfilename dump.rdb
dir /data

# 内存设置
maxmemory 512mb
maxmemory-policy allkeys-lru

# 安全设置
requirepass yourpassword  # 设置密码（可选）

# 其他设置
appendonly yes
appendfilename "appendonly.aof"
appendfsync everysec
no-appendfsync-on-rewrite no
auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb

3. 使用 Docker 运行 Redis

方式一：使用命令行

# 运行 Redis 容器
docker run -d \
  --name redis \
  -p 6379:6379 \
  -v ~/docker/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf \
  -v ~/docker/redis/data:/data \
  --restart unless-stopped \
  redis:alpine \
  redis-server /usr/local/etc/redis/redis.conf

方式二：使用 Docker Compose（推荐）

创建 ~/docker/redis/docker-compose.yml：

version: '3.8'

services:
  redis:
    image: redis:7.0-alpine
    container_name: redis
    restart: unless-stopped
    ports:
      - "6379:6379"
    volumes:
      - ./conf/redis.conf:/usr/local/etc/redis/redis.conf
      - ./data:/data
    command: redis-server /usr/local/etc/redis/redis.conf
    environment:
      - TZ=Asia/Shanghai
    networks:
      - redis-network

networks:
  redis-network:
    driver: bridge

启动服务：

cd ~/docker/redis
docker-compose up -d

4. 验证安装

# 查看容器状态
docker ps | grep redis

# 测试连接（如果设置了密码）
docker exec -it redis redis-cli -a yourpassword ping

# 或者进入容器内部
docker exec -it redis redis-cli

# 查看日志
docker logs redis

5. 常用命令

# 启动/停止/重启
docker-compose up -d
docker-compose down
docker-compose restart redis

# 进入 Redis CLI
docker exec -it redis redis-cli

# 查看配置文件是否生效
docker exec redis cat /usr/local/etc/redis/redis.conf | grep requirepass

# 备份数据
docker cp redis:/data/dump.rdb ./backup/

6. 配置文件权限问题处理

如果遇到配置文件权限问题：

# 修改配置文件权限
chmod 644 ~/docker/redis/conf/redis.conf

# 或者在 docker-compose.yml 中添加用户映射
user: "1000:1000"  # 使用当前用户的 UID:GID

7. Windows/macOS 路径说明

Windows 用户：

# 使用 Windows 路径格式
volumes:
  - C:/docker/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf

macOS 用户：

确保 Docker Desktop 的文件共享设置中包含挂载的目录。

注意事项

配置文件编码：确保配置文件使用 UTF-8 编码 行尾符：在 Windows 上编辑时注意换行符，建议使用 VS Code 或 Notepad++ 容器重启：配置文件修改后需要重启容器生效 数据持久化：挂载的 data 目录确保容器删除后数据不丢失 密码设置：生产环境建议设置密码，开发环境可暂时关闭

这样配置后，你的 Redis 服务就具备了：

自定义配置管理
数据持久化存储
自动重启机制
方便的管理方式