用 Docker 部署一个可持久化的 Redis 服务

一、为什么用 Docker 跑 Redis？#

在本地或服务器上部署 Redis，大致有两条路：

• 直接在系统里安装（apt install redis-server 等）
• 用 Docker 拉一个 Redis 容器跑起来

我更倾向于用 Docker，原因跟 MySQL 那篇类似：

• 环境干净：不用在系统里装常驻服务，删容器就干净。
• 版本可控：镜像标签里写明版本，比如 redis:7-alpine。
• 迁移容易：换机器只要装好 Docker，再跑一遍命令就能起来。

下面从零开始，一步步做到：

1. 用 Docker 跑起一个 Redis 容器
2. 给 Redis 加上密码和基础配置
3. 开启数据持久化（重启/重建容器不丢数据）
4. 用 docker-compose 管理 Redis（以及未来的应用）

二、准备：拉取 Redis 镜像#

前提是 Docker 已安装（参考前一篇 MySQL 文章中的安装步骤），然后直接拉镜像：

1
docker pull redis:7-alpine

查看本地镜像：

1
docker images

看到类似 redis 7-alpine ... 就说明拉取成功。

三、第一次运行 Redis 容器（最小示例）#

先用一个最简单的命令把 Redis 跑起来：

1
docker run --name my-redis \
2
  -p 6379:6379 \
3
  -d redis:7-alpine

参数含义简单回顾：

• --name my-redis：给容器取名，后续好操作。
• -p 6379:6379：把宿主机 6379 映射到容器 6379。
• -d：后台运行。
• redis:7-alpine：使用刚才拉的 Redis 7 精简版镜像。

检查容器状态：

1
docker ps

能看到 my-redis 处于 Up 状态就说明服务已启动。

这个最小版本方便测试，但存在两个问题：

1. 默认没有密码保护（不适合对外暴露）。
2. 默认数据不做额外持久化设计，删容器很容易把数据带走。

下面逐步补上这些部分。

四、给 Redis 配置密码与基础参数#

Redis 的常见生产习惯是：

• 打开 requirepass，给实例加一个访问密码。
• 合理设置 appendonly 等参数，提高数据安全性。

在 Docker 里，有两种常用方式：

• 启动命令里追加配置
• 映射自定义配置文件

这里先用命令行参数的方式，便于快速上手。

1
docker stop my-redis
2
docker rm my-redis
3

4
docker run --name my-redis \
5
  -p 6379:6379 \
6
  -d redis:7-alpine \
7
  redis-server --appendonly yes --requirepass "your_redis_password"

这里最后一行相当于执行：

• 启动 redis-server
• 打开 AOF 持久化：appendonly yes
• 设置访问密码：requirepass your_redis_password

后续客户端连接时需要带上密码，否则会被拒绝。

五、开启持久化并挂载数据目录#

Redis 的数据持久化本身有 RDB、AOF 等多种机制，本文用的是 AOF（上一步已经开启）。
下一步要做的是：把容器里的数据目录挂载到宿主机，防止容器删掉时数据跟着消失。

Redis 默认把数据放在 /data 目录，我们可以创建一个宿主机目录映射过去。

1
mkdir -p ~/docker-data/redis

1
mkdir C:\docker-data\redis

1
docker stop my-redis
2
docker rm my-redis
3

4
docker run --name my-redis \
5
  -p 6379:6379 \
6
  -v ~/docker-data/redis:/data \
7
  -d redis:7-alpine \
8
  redis-server --appendonly yes --requirepass "your_redis_password"

六、简单连通性测试#

1
docker exec -it my-redis sh

1
redis-cli
2
AUTH your_redis_password
3
SET hello "docker-redis"
4
GET hello

1
exit
2
exit

1
npm install ioredis

1
import Redis from "ioredis";
2

3
const redis = new Redis({
4
  host: "127.0.0.1",
5
  port: 6379,
6
  password: "your_redis_password",
7
});
8

9
async function test() {
10
  await redis.set("hello", "docker-redis");
11
  const value = await redis.get("hello");
12
  console.log("value:", value);
13
  await redis.quit();
14
}
15

16
test().catch(console.error);

七、用 docker-compose 管理 Redis#

当项目里不止 Redis 一个服务时，推荐用 docker-compose 把配置写进一个文件里统一管理。

在项目根目录（或单独的部署目录）创建 docker-compose.yml：

1
version: "3.9"
2

3
services:
4
  redis:
5
    image: redis:7-alpine
6
    container_name: my-redis
7
    restart: always
8
    ports:
9
      - "6379:6379"
10
    volumes:
11
      - ./redis-data:/data
12
    command:
13
      - redis-server
14
      - --appendonly
15
      - "yes"
16
      - --requirepass
17
      - "your_redis_password"

这里做的几件事：

• 把运行参数从 docker run 转成 YAML，更易读也好同步。
• 加了 restart: always，机器/服务重启后自动拉起。
• 用 ./redis-data 做数据卷，数据跟着项目目录走。

在 docker-compose.yml 所在目录执行：

1
docker compose up -d

查看状态：

1
docker compose ps

停止服务：

1
docker compose down

默认 down 不会删除卷里的数据（除非加 -v）。

1
  app:
2
    build: .
3
    container_name: my-app
4
    depends_on:
5
      - redis
6
    environment:
7
      REDIS_HOST: redis
8
      REDIS_PORT: 6379
9
      REDIS_PASSWORD: your_redis_password
10
    ports:
11
      - "8080:8080"

1
docker compose up -d

八、几个常见坑#

1
ports:
2
  - "6380:6379"

1
sudo chown -R youruser:youruser /home/youruser/docker-data/redis

1
REDIS_PASSWORD=your_redis_password

1
command:
2
  - redis-server
3
  - --appendonly
4
  - "yes"
5
  - --requirepass
6
  - "${REDIS_PASSWORD}"

九、简单回顾：从 0 到 可用#

本文的核心步骤可以压缩成几行：

1. 拉镜像：docker pull redis:7-alpine。
2. 用 docker run 跑起一个带密码、开启 AOF 的 Redis 容器。
3. 挂载 /data 到宿主机目录，实现数据持久化。
4. 用 redis-cli 或客户端库测试 AUTH、SET、GET 是否正常。
5. 把配置写进 docker-compose.yml，加上 restart: always 和数据卷映射，方便一键启动。
6. 视情况把应用也写进 compose，用服务名作为 REDIS_HOST。

目的仍然是留下一套自己顺手、可靠的 Redis 部署流程，方便以后再需要一个 Redis 实例时，少查几篇博客、少踩几次同样的坑。