Bitnami on Liangweidong's blog

Redis Docker 实战：6.x/8.x、持久化、bitnami 镜像与生产配置

Wed, 15 Dec 2021 00:00:00 +0800

Redis 6.0 引入了多线程 I/O、ACL 权限、SSL 加密；8.x（2024）改进了 RDB 加载速度、模块化。生产环境的 Redis 在 Docker 里跑有几个常见问题：持久化怎么配、密码怎么改、主从怎么搭、要不要关 RDB。这篇文章把 Redis 6.0 到 8.6 的官方镜像和 bitnami 镜像的部署、配置、调优一次性收齐。

阅读对象：日常用 Redis 做缓存/分布式锁/排行榜/限流，要在容器里跑单实例或主从，关注内存、持久化、ACL 的同学。 覆盖范围：官方 redis:6.0/8.6 镜像启动；bitnami/redis 镜像（推荐生产用）；redis.conf 关键配置；RDB / AOF / 混合持久化关闭；主从复制（docker run + 配置文件）；客户端连接与排错。

一、Redis 在 Docker 里的几个关键决策

决策	选项	适用
镜像	官方 `redis` / `bitnami/redis`	官方更轻，bitnami 多 healthcheck + 非 root
持久化	RDB（默认）/ AOF / 混合 / 全关	缓存场景：关；持久场景：开
网络模式	host / bridge	性能优先 host，安全优先 bridge
部署形态	单机 / 主从 / Sentinel / Cluster	单机演示，主从高可用，Cluster 大数据量
内存淘汰	noeviction / allkeys-lru 等	写多：noeviction；缓存：allkeys-lru

二、官方 redis 镜像

2.1 拉取与启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 拉镜像
docker pull redis:6.0.3-alpine3.11
docker pull redis:8.6.3-alpine3.23

# 启动（host 网络，性能好）
docker run -d --name redis \
 --net=host \
 --restart=always \
 redis:8.6.3-alpine3.23 \
 redis-server /usr/local/etc/redis/redis.conf

alpine 镜像比 debian 镜像小 100MB+，但 musl libc 的 redis-benchmark 等工具有兼容性问题，生产一般用 debian 镜像。

2.2 创建宿主机目录

1
2


mkdir /home/docker/redis/{conf,data,logs} -p
cd /home/docker/redis

2.3 准备 redis.conf

1
2
3
4
5
6
7
8
9


# 下载官方模板
wget https://raw.githubusercontent.com/redis/redis/8.6/redis.conf \
 -O /home/docker/redis/conf/redis.conf

# 改几个关键参数
sed -i 's/logfile ""/logfile "access.log"/' /home/docker/redis/conf/redis.conf
sed -i 's/# requirepass foobared/requirepass {{REDACTED}}/' /home/docker/redis/conf/redis.conf
sed -i 's/appendonly no/appendonly yes/' /home/docker/redis/conf/redis.conf
sed -i 's/bind 127.0.0.1/bind 0.0.0.0/' /home/docker/redis/conf/redis.conf

2.4 启动（挂载配置 + 数据）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


docker run \
 -p 6379:6379 \
 -v /home/docker/redis/data:/data \
 -v /home/docker/redis/conf/redis.conf:/etc/redis/redis.conf \
 --net mynetwork --ip 172.18.0.5 \
 --privileged=true \
 --name redis \
 --restart=always \
 -d redis:6.0.3-alpine3.11 \
 redis-server /etc/redis/redis.conf

2.5 客户端连接

1
2
3
4
5
6


# 容器内
docker exec -it redis /bin/sh
redis-cli -h 127.0.0.1 -p 6379 -a {{REDACTED}}

# 宿主机直接连
docker run -it --link redis:redis --rm redis redis-cli -h redis -p 6379

2.6 docker-compose 模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


version: "3"
services:
 redis:
 container_name: redis
 image: <your-public-ip>:13001/base/redis:6.0.3-alpine3.11
 network_mode: "host"
 command: redis-server /etc/redis/redis.conf
 restart: always
 volumes:
 - /home/docker/redis/data:/data:rw
 - /home/docker/redis/conf/redis.conf:/etc/redis/redis.conf
 - /home/docker/redis/logs:/logs
 privileged: true
 environment:
 - TZ=Asia/Shanghai
 - LANG=en_US.UTF-8

三、bitnami/redis 镜像（生产推荐）

bitnami/redis 的优势：非 root 进程、Tini init、healthcheck、Redis 风格环境变量（REDIS_PASSWORD 等都大写）、自带 Sentinel 模板。

3.1 启动

1
2
3
4
5
6
7


docker pull bitnami/redis:6.2.14-debian-12-r21

docker run -d \
 --name redis \
 -p 6379:6379 \
 -e REDIS_PASSWORD={{REDACTED}} \
 bitnami/redis:6.2.14-debian-12-r21

环境变量 REDIS_PASSWORD：自动生成 requirepass。比直接改 conf 文件方便。

四、持久化策略

4.1 三种持久化机制

机制	默认	特点	适用
RDB（快照）	开启	周期性 dump，体积小，恢复快	接受分钟级数据丢失
AOF（追加日志）	关闭	每条写命令追加日志，最多丢 1 秒数据	不能丢数据
混合持久化	7.0+ 默认	RDB + AOF 结合	大多数生产场景

4.2 关闭持久化（纯缓存场景）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# redis.conf
# 1. 关闭 RDB 自动快照
save ""

# 2. 关闭 AOF 增量持久化
appendonly no

# 3. 关闭混合持久化（7.0+）
rdb-aof-use-rdb-preamble no

# 4. 主从同步后立刻删除 RDB 临时文件
rdb-del-sync-files yes

重启服务后生效。这种配置相当于"纯缓存"，重启 = 数据全清，只用于缓存场景。

4.3 推荐生产配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 1. 开启 AOF（默认关）
appendonly yes
appendfsync everysec # 每秒刷盘，最多丢 1 秒

# 2. RDB 兜底
save 3600 1 # 1 小时至少 1 个 key 变化
save 300 100 # 5 分钟至少 100 个 key 变化
save 60 10000 # 1 分钟至少 10000 个 key 变化

# 3. 7.0+ 混合持久化
rdb-aof-use-rdb-preamble yes

五、主从复制

5.1 启动 master

1
2
3
4
5
6
7


docker run -d --name redis-master \
 -p 6379:6379 \
 -v /home/docker/redis/data:/data \
 -v /home/docker/redis/conf/redis.conf:/etc/redis/redis.conf \
 --restart=always \
 redis:6.0.3-alpine3.11 \
 redis-server /etc/redis/redis.conf

5.2 启动 slave

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


# 1. 查 master 内部 IP
docker inspect redis-master | grep IPAddress
# "IPAddress": "172.18.0.X"

# 2. 准备 slave 配置文件（追加）
cat << 'EOF' >> /home/docker/redis-slave/conf/redis.conf
replicaof 172.18.0.X 6379
masterauth {{REDACTED}}
replica-read-only yes
EOF

# 3. 启动 slave
docker run -d --name redis-slave \
 -p 6380:6379 \
 -v /home/docker/redis-slave/data:/data \
 -v /home/docker/redis-slave/conf/redis.conf:/etc/redis/redis.conf \
 --restart=always \
 redis:6.0.3-alpine3.11 \
 redis-server /etc/redis/redis.conf

从 Redis 5.0 开始，slaveof 改名为 replicaof，但旧名仍然兼容。

5.3 验证复制

1
2
3
4
5
6


# master 写入
docker exec -it redis-master redis-cli -a {{REDACTED}} set test_key hello

# slave 读取
docker exec -it redis-slave redis-cli -a {{REDACTED}} get test_key
# "hello"

六、常见排错

6.1 连接被拒

1
2
3
4
5
6
7
8


# 1. 看容器是否在跑
docker ps | grep redis

# 2. 看日志
docker logs redis

# 3. 看网络
docker network inspect bridge | grep redis

6.2 密码忘了

1
2
3
4
5
6
7


# 1. 进容器，关掉 requirepass
docker exec -it redis bash
redis-cli
CONFIG SET requirepass ""

# 2. 改 conf 文件持久化
echo "requirepass <new_password>" >> /home/docker/redis/conf/redis.conf

6.3 内存满

1
2
3
4
5


# 看使用情况
redis-cli info memory | grep used_memory_human

# 触发淘汰
CONFIG SET maxmemory-policy allkeys-lru

七、Redis 6.x/7.x/8.x 关键差异

版本	关键特性	适合
6.0	ACL、多线程 I/O、SSL	主流稳定
6.2	细粒度命令权限	多租户
7.0	混合持久化、Redis Functions、sharded pub/sub	新功能
7.2	改进 listpack、SCAN 性能	性能敏感
8.0	异步 I/O、模块化	新项目首选
8.6	进一步优化 RDB 加载	大 key 场景

八、扩展阅读

Redis 官方镜像：hub.docker.com/_/redis
bitnami/redis：hub.docker.com/r/bitnami/redis
Redis 配置文件详解：redis.io/docs/manual/config
Redis 持久化文档：redis.io/docs/management/persistence
Redis Sentinel 文档：redis.io/docs/management/sentinel

MySQL Docker 实战：从 5.6 到 8.0 的全版本最佳实践

Mon, 15 Jun 2020 00:00:00 +0800

MySQL 5.6 / 5.7 / 8.0 三个版本在 Docker 里的差异比想象大：5.6 默认字符集 latin1、5.7 引入 caching_sha2_password、8.0 默认认证插件改了 native_password。配置文件模板、备份恢复命令、参数调优是日常最常碰到的三件事。这篇文章把 MySQL 在 Docker 里的实战（5.6/5.7/8.0、官方镜像 / bitnami 镜像、配置 / 备份 / 调优）一次性收齐。

阅读对象：日常用 MySQL 跑业务、需要在 Docker 里搭开发库、关心字符集和大小写敏感性、被 “Lost connection” / “group by” 报过错的后端 / DBA 同学。 覆盖范围：MySQL 5.6/5.7/8.0 官方镜像启动；bitnami/mysql:8.0 镜像（生产推荐）；my.cnf 模板（utf8mb4 / lower_case_table_names=1 / 慢日志）；备份/恢复/导入导出；only_full_group_by 解决；Lost connection 调优。

一、为什么要在 Docker 里跑 MySQL

场景	价值
CI/CD 测试库	每个 Pipeline 干净环境，跑完即弃
多版本并存	5.6 旧系统 + 8.0 新系统一台机器
快速 demo	一行 `docker run` 拉起完整 MySQL
跨平台开发	Mac/Win/Linux 容器化一致
生产	仍建议用云 RDS 或独立机器，Docker 化适合测试 / 演示

生产建议：核心业务用云厂商 RDS（高可用 / 备份 / 监控内置）。Docker 跑 MySQL 用于演示、CI、个人开发。

二、官方镜像启动

2.1 5.6 启动

1
2
3
4
5
6
7


docker run -d -p 3306:3306 --name mysql56 \
 -e MYSQL_ROOT_PASSWORD={{REDACTED}} \
 --restart=always \
 -v /etc/localtime:/etc/localtime:ro \
 --net mynetwork --ip 172.18.0.2 \
 --privileged=true \
 mysql:5.6.30

2.2 5.7 启动

1
2
3
4
5
6
7


docker run -d --name mysql57 \
 --restart=always \
 -p 3308:3306 \
 -e MYSQL_ROOT_PASSWORD=x5 \
 -v /home/old-<your-org>/mysql5.7/conf:/etc/mysql/conf.d \
 -v /home/old-<your-org>/mysql5.7/data:/var/lib/mysql \
 mysql:5.7.43

2.3 8.0 启动（推荐生产用 bitnami）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


docker run -d \
 --name mysql \
 --restart=always \
 --privileged=true \
 -p 3309:3306 \
 -e MYSQL_ROOT_PASSWORD={{REDACTED}} \
 -e TZ=Asia/Shanghai \
 -v /data/docker/mysql/db:/var/lib/mysql \
 -v /data/docker/mysql/conf:/etc/mysql/conf.d \
 mysql:8.0.23 \
 --default-authentication-plugin=mysql_native_password \
 --lower-case-table-names=1

Why --default-authentication-plugin=mysql_native_password？ MySQL 8.0 默认用 caching_sha2_password，老版本客户端（包括 Java 老驱动）连不上。显式指定 native_password 兼容性好。 Why --lower-case-table-names=1？ Linux 默认 0（区分大小写），Windows 默认 1。开发环境跨平台会踩坑，统一设 1 更省事（注意：该参数不能在已有数据上改，需要初始就设）。

2.4 docker-compose 模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


version: "3"
services:
 mysql:
 image: <your-public-ip>:13001/base/mysql:8.0.23
 container_name: mysql
 command: --default-authentication-plugin=mysql_native_password --lower-case-table-names=1
 restart: always
 environment:
 MYSQL_ROOT_PASSWORD: {{REDACTED}}
 TZ: Asia/Shanghai
 ports:
 - '3306:3306'
 security_opt:
 - seccomp:unconfined
 volumes:
 - "/data/mysql/db:/var/lib/mysql"
 - "/data/mysql/conf:/etc/mysql/conf.d"
 healthcheck:
 test: ["CMD", "mysqladmin", "ping", "-uroot", "-p{{REDACTED}}"]
 interval: 5s
 timeout: 10s
 retries: 10

三、bitnami/mysql 镜像（生产推荐）

bitnami/mysql 镜像比官方多了：非 root 进程运行、healthcheck、Tini init、健康检查脚本、Redis 风格的环境变量（MYSQL_ROOT_PASSWORD 等都大写）。生产环境推荐用。

3.1 拉取与重打 tag

1
2
3
4


docker pull bitnami/mysql:8.0.39-debian-12-r2
docker tag bitnami/mysql:8.0.39-debian-12-r2 \
 internal.example.com:13001/base/bitnami/mysql:8.0.39-debian-12-r2
docker push internal.example.com:13001/base/bitnami/mysql:8.0.39-debian-12-r2

3.2 my_custom.cnf（utf8mb4 + 大连接数）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


[client]
default-character-set=utf8mb4
[mysql]
default-character-set=utf8mb4
[mysqld]
skip-name-resolve
port = 3307
lower_case_table_names = 1
character-set-server = utf8mb4
secure-file-priv = NULL
default-time-zone = '+08:00'
sql_mode = STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
group_concat_max_len = 4294967295
max_connections = 10000
max_user_connections = 5000
mysqlx_max_connections = 200
interactive_timeout = 28800
wait_timeout = 28800
thread_cache_size = 100
max_allowed_packet = 1G
net_buffer_length = 1M
log_bin_trust_function_creators = 1
binlog_rows_query_log_events = 1
slow_query_log = 1
long_query_time = 3
slow_query_log_file = slow.log

3.3 启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


docker run -d \
 --net=host \
 --name mysql8 \
 --restart=always \
 -e MYSQL_ROOT_PASSWORD={{REDACTED}} \
 -e MYSQL_AUTHENTICATION_PLUGIN=mysql_native_password \
 -v /home/docker/mysql8/data:/bitnami/mysql/data \
 -e TZ=Asia/Shanghai \
 -v /home/docker/mysql8/conf/my_custom.cnf:/opt/bitnami/mysql/conf/my_custom.cnf:ro \
 internal.example.com:13001/base/bitnami/mysql:8.0.39-debian-12-r2

关键差异：bitnami 镜像的 datadir 是 /bitnami/mysql/data，不是官方的 /var/lib/mysql。备份恢复命令的路径要对应调整。

3.4 bitnami 容器的 mysql 命令路径

1
2
3
4
5


docker exec -it -u root mysql8 bash

# bitnami 路径
/opt/bitnami/mysql/bin/mysql
/opt/bitnami/mysql/bin/mysqldump

四、备份、恢复、导入

4.1 备份

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 官方镜像
docker exec mysql /usr/bin/mysqldump \
 -u root -p{{REDACTED}} \
 --single-transaction --quick \
 safety_manhole_cover > /data/mysql/bak/safety_manhole_cover.sql

# bitnami 镜像
docker exec mysql8 /opt/bitnami/mysql/bin/mysqldump \
 -u root -p{{REDACTED}} \
 --single-transaction --quick \
 hxl_industry_iot_dev > /home/iot.sql

--single-transaction：InnoDB 的事务一致快照，不影响业务。 --quick：逐行取数据，避免大表 dump 时 OOM。

4.2 恢复（先建库再导入）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 1. 建库
cat << 'EOF' | docker exec -i mysql /usr/bin/mysql -u root --password={{REDACTED}}
DROP DATABASE IF EXISTS `safety_manhole_cover`;
CREATE DATABASE `safety_manhole_cover` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
EOF

# 2. 导入
cat /data/mysql/bak/safety_manhole_cover.sql | \
 docker exec -i mysql /usr/bin/mysql \
 -u root --password={{REDACTED}} \
 safety_manhole_cover

4.3 备份脚本（保留 7 天）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


cat << 'EOF' > /data/mysql/bak.sh
#!/bin/bash
set -e
DATE=$(date +%Y%m%d%H%M%S)
BACK_DATA=iot-${DATE}.sql
BAK_PATH=/data/mysql/bak
mkdir -p ${BAK_PATH}
docker exec mysql /usr/bin/mysqldump \
 -u root -p{{REDACTED}} \
 --single-transaction --quick \
 hxl_chemistry_park_iot > ${BAK_PATH}/$BACK_DATA
find ${BAK_PATH} -name "*.sql" -mtime +7 -print0 | xargs -0 rm -rf
EOF
chmod +x /data/mysql/bak.sh

小坑：Windows 编辑的 .sh 脚本传到 Linux 报 /bin/bash^M: bad interpreter。vim 改文件类型：set ff=unix。

4.4 K8s 中备份

1
2
3


kubectl exec -i "$(kubectl get pods -n <ns> | grep mysql | awk '{print $1}')" \
 -n <ns> -- bash -c \
 "/usr/bin/mysqldump -u root -p'password' <db_name>" > backup.sql

五、常见调优

5.1 解决 `only_full_group_by` 报错

报错信息：

1
2


which is not functionally dependent on columns in GROUP BY clause;
this is incompatible with sql_mode=only_full_group_by

临时解决（重启失效）：

1
2


SELECT @@sql_mode;
SET GLOBAL sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';

永久解决：在 my.cnf 的 [mysqld] 下加：

1

sql_mode = STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

5.2 解决 `Lost connection to MySQL server during query`

通常是大表 dump / 慢查询超过 net_read_timeout：

1
2
3
4


show global variables like '%timeout%';

set global net_read_timeout = 120;
set global net_write_timeout = 900;

5.3 大小写不敏感

1
2
3


show global variables like '%lower_case%';
-- 0: 大小写敏感（Linux 默认）
-- 1: 大小写不敏感（Windows 默认）

在 my.cnf 加：

1

lower_case_table_names = 1

重要：该参数只能在初始化时设，已有数据后改会导致表找不到。

5.4 用户自定义函数 UDF

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


# 1. 查询插件地址
docker exec -it mysql /bin/bash
mysql -uroot -p
show variables like 'plugin_dir';
-- /usr/lib/mysql/plugin

# 2. 复制 UDF 文件
docker cp ~/libHttpClient.so mysql:/usr/lib/mysql/plugin

# 3. 创建函数
create function http_get RETURNS string soname 'libHttpClient.so';
create function http_post RETURNS string soname 'libHttpClient.so';

# 4. 重启容器生效
docker restart mysql

六、MySQL 5.6 / 5.7 / 8.0 选型速查

维度	5.6	5.7	8.0
发布时间	2013	2015	2018
默认字符集	latin1	utf8mb4	utf8mb4
默认认证	mysql_native_password	mysql_native_password	caching_sha2_password
JSON 支持	弱（需用 TEXT）	原生 JSON 类型	强（JSON_TABLE 函数）
窗口函数	无	无	有
通用表表达式 (CTE)	无	无	有
推荐场景	遗留系统	中间状态（推荐升级到 8.0）	新项目默认
Docker 官方支持	是	是	是

经验法则：

新项目：MySQL 8.0（JSON、窗口函数、CTE 都要）
老系统：先看能不能升级到 8.0；不能的话 5.7（5.6 已 EOL）
测试/演示：用 bitnami/mysql:8.0，省事

七、扩展阅读

MySQL 官方镜像：hub.docker.com/_/mysql
bitnami/mysql：hub.docker.com/r/bitnami/mysql
MySQL 8.0 Release Notes：dev.mysql.com
mysqldump 文档：dev.mysql.com/doc