Redis 单机部署：VMware + Ubuntu 22.04.5

1. 部署目标

本文用于在 VMware 中基于 ubuntu-22.04.5-live-server-amd64.iso 部署一台单机 Redis。

这台机器既用于学习 Redis 单机部署，也作为后续主从复制、Sentinel 和 Cluster 的基础节点模板。

最终目标：

• 使用 VMware NAT 网络，和你之前 K8s 学习环境保持一致。
• 先创建一台 Ubuntu 模板机，后续通过克隆生成 Redis 节点。
• Redis 使用独立用户、独立配置目录、独立数据目录和独立日志目录。
• Redis 由 systemd 管理，支持开机自启、重启和日志排查。
• 宿主机可以通过固定 IP 访问虚拟机中的 Redis。
• 能验证 RDB、AOF、慢查询、日志和基础状态。

2. 环境规划

2.1 ISO 版本

本文统一使用：

1

ubuntu-22.04.5-live-server-amd64.iso

不要混用 Rocky Linux、CentOS 或其他 Ubuntu 版本。先把这一套跑通，后面再扩展其他环境。

2.2 VMware 网络规划

本文默认沿用你之前 K8s 虚拟机环境的 VMware NAT 网段：

1
2
3
4

VMware Network: VMnet8 NAT
Subnet: 192.168.88.0/24
Gateway: 192.168.88.2
DNS: 223.5.5.5, 8.8.8.8

需要先在 Windows 宿主机确认：

1
2
3
4
5

VMware Workstation
  -> Edit
  -> Virtual Network Editor
  -> VMnet8
  -> NAT Settings

重点确认：

• Subnet IP 是否是 192.168.88.0
• Subnet mask 是否是 255.255.255.0
• Gateway IP 是否是 192.168.88.2

如果你的 VMware 配置不同，本文所有 192.168.88.x 都要替换成你的实际网段。

2.3 节点规划

建议先做一台模板机，再克隆出 Redis 节点。

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

模板机:
ubuntu-2204-template

单机阶段:
redis-single-1  192.168.88.101

高可用阶段:
redis-ha-1  192.168.88.111
redis-ha-2  192.168.88.112
redis-ha-3  192.168.88.113

Cluster 阶段:
redis-cluster-1  192.168.88.121  6379, 6380
redis-cluster-2  192.168.88.122  6379, 6380
redis-cluster-3  192.168.88.123  6379, 6380

这里按阶段分配不同虚拟机，不复用前面阶段的机器。这样单机、高可用、Cluster 三套环境可以同时保留，后面排查、复盘或重做实验时互不影响。

Cluster 阶段这里写端口，是因为 Redis Cluster 需要的是多个 Redis 实例，不是单纯多台虚拟机。

学习环境为了节省资源，采用：

1

3 台虚拟机 * 每台 2 个 Redis 实例 = 6 个 Redis 实例

展开后是：

1
2
3
4
5
6
7
8
9
10
11

redis-cluster-1  192.168.88.121
  Redis 实例 1: 192.168.88.121:6379
  Redis 实例 2: 192.168.88.121:6380

redis-cluster-2  192.168.88.122
  Redis 实例 3: 192.168.88.122:6379
  Redis 实例 4: 192.168.88.122:6380

redis-cluster-3  192.168.88.123
  Redis 实例 5: 192.168.88.123:6379
  Redis 实例 6: 192.168.88.123:6380

Redis Cluster 最小推荐是 3 主 3 从，也就是 6 个 Redis 实例。生产环境更推荐 6 台机器每台 1 个 Redis 实例；学习环境用 3 台机器每台 2 个 Redis 实例，也能完整练习槽位分配、主从关系、故障转移、扩容缩容和迁槽。

一台虚拟机可以运行多个 Redis 进程，但每个实例必须使用不同端口、不同配置文件、不同数据目录和不同日志文件。例如 redis-cluster-1 上后续会有：

1
2
3
4
5
6
7
8

/etc/redis/redis-6379.conf
/etc/redis/redis-6380.conf

/data/redis/6379
/data/redis/6380

/var/log/redis/redis-6379.log
/var/log/redis/redis-6380.log

单机阶段先只创建：

1
2
3
4

hostname: redis-single-1
ip: 192.168.88.101/24
gateway: 192.168.88.2
redis port: 6379

3. 是否需要模板机

需要。

原因很直接：后面你一定会用到 3 台虚拟机做主从、Sentinel 和 Cluster。如果每次从 ISO 重新安装 Ubuntu，会浪费大量时间，而且容易出现基础环境不一致。

模板机只做 Ubuntu 基础初始化，不安装 Redis。

模板机应该完成：

• 安装 Ubuntu Server 22.04.5。
• 安装 SSH。
• 配置 apt 源和基础工具。
• 设置时区。
• 完成系统更新。
• 关机，作为克隆源。

模板机不应该做：

• 不要设置最终节点主机名，比如 redis-single-1。
• 不要配置最终静态 IP，比如 192.168.88.101。
• 不要安装 Redis。
• 不要创建 Redis 数据目录。
• 不要创建 Redis systemd 服务。

4. 创建 Ubuntu 模板机

4.1 VMware 虚拟机配置

模板机建议配置：

安装 Ubuntu 时建议：

• 勾选安装 OpenSSH server。
• 网络可以先使用 DHCP。
• 用户名可以统一使用你自己的学习用户，例如 redisadmin。
• 磁盘使用默认 LVM 或普通分区都可以，学习环境不强制。

4.2 模板机基础初始化

登录模板机后执行：

1
2
3
4
5

sudo apt update
sudo apt upgrade -y
sudo apt install -y vim curl wget net-tools lsof tar gcc make tcl pkg-config openssh-server ca-certificates gnupg lsb-release libsystemd-dev
sudo systemctl enable --now ssh
sudo timedatectl set-timezone Asia/Shanghai

命令说明：

验证：

1
2
3
4
5

cat /etc/os-release
hostname
ip addr
timedatectl
systemctl status ssh

命令说明：

4.3 清理模板机痕迹

关机前可以清理 apt 缓存：

1
2

sudo apt clean
sudo cloud-init clean 2>/dev/null || true

命令说明：

如果没有安装 cloud-init，第二条命令报错可以忽略。

然后关机：

1

sudo shutdown now

命令说明：

在 VMware 中给这台机器命名为：

1

ubuntu-2204-template

后续通过它克隆 Redis 节点。

5. 克隆 Redis 单机节点

5.1 克隆方式

建议使用 VMware 的完整克隆：

1
2
3
4
5

ubuntu-2204-template
  -> Manage
  -> Clone
  -> Full clone
  -> redis-single-1

学习环境建议使用完整克隆，机器之间互不依赖，后续排查更直观。

5.2 启动克隆机后修改主机名

在 redis-single-1 上执行：

1

sudo hostnamectl set-hostname redis-single-1

命令说明：

重新登录后验证：

1

hostname

命令说明：

5.3 重新生成 machine-id

克隆虚拟机后建议重新生成 machine-id，避免后续多节点实验出现标识重复。

1
2
3
4

sudo rm -f /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id
sudo systemd-machine-id-setup
sudo reboot

命令说明：

重启后验证：

1

cat /etc/machine-id

命令说明：

后面创建高可用阶段和 Cluster 阶段的新虚拟机时，也要分别执行类似操作。

5.4 确认 MAC 地址唯一

VMware 克隆时通常会生成新的 MAC 地址。仍然建议确认：

1

ip link

命令说明：

如果后续多台机器 MAC 地址重复，需要在 VMware 虚拟机设置里重新生成 MAC。

6. 配置静态 IP

Ubuntu Server 22.04 使用 netplan 管理网络。

6.1 查看网卡名

1

ip addr

命令说明：

常见网卡名：

1
2

ens33
ens160

本文示例使用 ens33。如果你的机器不是这个名字，下面配置要替换成实际网卡名。

6.2 备份 netplan 配置

1
2
3

ls /etc/netplan
sudo mkdir -p /root/netplan-backup
sudo cp -a /etc/netplan/*.yaml /root/netplan-backup/

命令说明：

不要把备份文件放在 /etc/netplan 目录下并继续使用 .yaml 后缀。netplan 会读取该目录里的 YAML 文件，旧配置和新配置同时存在时容易造成路由、DNS 或网卡配置冲突。

6.3 修改 netplan

编辑配置：

1

sudo vim /etc/netplan/00-installer-config.yaml

命令说明：

写入：

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

network:
  version: 2
  renderer: networkd
  ethernets:
    ens33:
      dhcp4: false
      addresses:
        - 192.168.88.101/24
      routes:
        - to: default
          via: 192.168.88.2
      nameservers:
        addresses:
          - 223.5.5.5
          - 8.8.8.8

注意：

• addresses 是当前 Redis 节点 IP。
• via 是 VMware NAT 网关，不要随便写成 .1。
• 新版 Ubuntu 推荐使用 routes 配置默认路由，不使用旧的 gateway4。
• YAML 对缩进敏感，必须使用空格。

6.4 应用配置

建议先生成检查：

1

sudo netplan generate

命令说明：

再应用：

1

sudo netplan apply

命令说明：

验证：

1
2
3
4
5

ip addr
ip route
ping -c 3 192.168.88.2
ping -c 3 223.5.5.5
ping -c 3 baidu.com

命令说明：

如果 223.5.5.5 能通但域名不通，通常是 DNS 配置问题。

6.5 配置 hosts

编辑：

1

sudo vim /etc/hosts

命令说明：

写入：

1
2
3
4
5
6
7
8
9
10

127.0.0.1 localhost
192.168.88.101 redis-single-1

192.168.88.111 redis-ha-1
192.168.88.112 redis-ha-2
192.168.88.113 redis-ha-3

192.168.88.121 redis-cluster-1
192.168.88.122 redis-cluster-2
192.168.88.123 redis-cluster-3

单机阶段只用 redis-single-1。后续高可用和 Cluster 阶段使用新的虚拟机，提前规划名称和 IP 是为了避免地址冲突。

验证：

1

ping -c 3 redis-single-1

命令说明：

7. Redis 前置系统配置

这些配置不是为了让 Redis 勉强跑起来，而是为了让你从一开始就按接近生产的方式理解 Redis。

7.1 文件描述符

查看：

1

ulimit -n

命令说明：

Redis 服务最终会通过 systemd 的 LimitNOFILE 单独设置，不需要在 shell 里永久修改。

7.2 overcommit_memory

查看：

1

cat /proc/sys/vm/overcommit_memory

命令说明：

永久设置：

1
2

echo "vm.overcommit_memory = 1" | sudo tee /etc/sysctl.d/99-redis.conf
sudo sysctl -p /etc/sysctl.d/99-redis.conf

命令说明：

原因：Redis 执行 RDB 或 AOF rewrite 时会 fork 子进程，内存分配策略不合适可能导致 fork 失败。

7.3 关闭 Transparent Huge Pages

查看：

1

cat /sys/kernel/mm/transparent_hugepage/enabled

命令说明：

临时关闭：

1

echo never | sudo tee /sys/kernel/mm/transparent_hugepage/enabled

命令说明：

学习阶段可以先临时关闭。后面如果你要模拟生产部署，再把它写入 systemd 或启动脚本。

7.4 TCP backlog 上限

Redis 配置里的 tcp-backlog 会受到 Linux 内核 net.core.somaxconn 上限影响。学习环境可以先查看当前值：

1

sysctl net.core.somaxconn

命令说明：

如果后续要模拟高并发连接，可以再通过 /etc/sysctl.d/99-redis.conf 调整它。单机入门阶段先理解它和 tcp-backlog 的关系即可。

8. 安装 Redis

学习部署建议使用源码安装，这样你能清楚 Redis 的二进制文件、配置文件、数据目录和日志目录分别在哪里。

8.1 下载源码

1
2
3
4
5

cd /usr/local/src
sudo wget https://download.redis.io/releases/redis-7.2.5.tar.gz
sudo tar -zxvf redis-7.2.5.tar.gz
sudo chown -R $(id -u):$(id -g) redis-7.2.5
cd redis-7.2.5

命令说明：

如果下载慢，可以提前在宿主机下载后上传到虚拟机。

8.2 编译安装

编译前先确认依赖已安装。因为本文使用 supervised systemd，Redis 编译时需要 libsystemd-dev 提供 systemd 头文件：

1
2

sudo apt update
sudo apt install -y gcc make tcl pkg-config libsystemd-dev

命令说明：

1
2
3
4
5
6

make USE_SYSTEMD=yes -j2
make test
sudo make install PREFIX=/usr/local/redis
sudo ln -sf /usr/local/redis/bin/redis-server /usr/local/bin/redis-server
sudo ln -sf /usr/local/redis/bin/redis-cli /usr/local/bin/redis-cli
sudo ln -sf /usr/local/redis/bin/redis-benchmark /usr/local/bin/redis-benchmark

命令说明：

如果 make test 在 VMware 中因为延迟敏感测试失败，先看 src/redis-server --version 是否正常；如果正常，可以继续执行 sudo make install PREFIX=/usr/local/redis。

验证：

1
2

/usr/local/redis/bin/redis-server --version
/usr/local/redis/bin/redis-cli --version

命令说明：

安装后的关键文件：

9. 创建 Redis 用户和目录

不要用 root 直接运行 Redis。

如果你安装 Ubuntu 时已经把登录用户名设置成了 redis，不要再创建同名服务用户。建议使用 redis-svc 作为 Redis 服务运行用户。

本文后续统一使用 redis-svc 作为 Redis 服务用户。

先把几个用户角色分清楚：

1
2
3
4
5
6
7
8
9
10

root
  Linux 超级管理员，拥有所有权限。

redis
  你创建 Ubuntu 虚拟机时填写的登录用户。
  它是普通用户，可以通过 sudo 临时执行管理员操作。

redis-svc
  Redis 服务运行用户。
  它不能登录系统，只负责运行 redis-server。

学习环境中的职责划分：

1
2
3
4

编译 Redis：用登录用户 redis
测试 Redis：用登录用户 redis
安装 Redis：用 sudo
运行 Redis 服务：用 redis-svc

生产环境的原则类似，但通常会换成更规范的用户和发布流程：

1
2
3
4

编译 Redis：普通构建用户，例如 build、deploy、cicd
测试 Redis：普通构建用户
安装 Redis：root 权限或自动化发布工具
运行 Redis 服务：专用低权限用户，例如 redis、redis-svc

核心原则：

• 不要用 root 运行 Redis 服务。
• 不要用 root 编译和测试 Redis，避免源码目录出现权限污染。
• 安装阶段需要写入系统目录，所以可以使用 sudo。
• Redis 服务运行用户只应该拥有数据目录、日志目录和运行目录的必要权限。

1
2
3
4
5
6

id -u redis-svc >/dev/null 2>&1 || sudo useradd -r -s /usr/sbin/nologin redis-svc
sudo mkdir -p /etc/redis
sudo mkdir -p /data/redis/6379
sudo mkdir -p /var/log/redis
sudo chown -R redis-svc:redis-svc /data/redis
sudo chown -R redis-svc:redis-svc /var/log/redis

命令说明：

目录说明：

10. 编写 redis.conf

创建配置文件：

1

sudo vim /etc/redis/redis-6379.conf

命令说明：

写入：

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

bind 0.0.0.0
protected-mode yes
port 6379
tcp-backlog 511
timeout 0
tcp-keepalive 300

daemonize no
supervised systemd
pidfile /run/redis/redis-6379.pid
loglevel notice
logfile /var/log/redis/redis-6379.log

databases 16
always-show-logo no

dir /data/redis/6379
dbfilename dump.rdb

save 900 1
save 300 10
save 60 10000
stop-writes-on-bgsave-error yes
rdbcompression yes
rdbchecksum yes

appendonly yes
appendfilename "appendonly.aof"
appenddirname "appendonlydir"
appendfsync everysec
no-appendfsync-on-rewrite no
auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb
aof-use-rdb-preamble yes

maxmemory 512mb
maxmemory-policy allkeys-lru

slowlog-log-slower-than 10000
slowlog-max-len 128

latency-monitor-threshold 100

requirepass Redis@123456

配置说明：

修改权限：

1
2

sudo chown redis-svc:redis-svc /etc/redis/redis-6379.conf
sudo chmod 640 /etc/redis/redis-6379.conf

命令说明：

关键配置说明：

• bind 0.0.0.0：允许宿主机和其他虚拟机访问。
• protected-mode yes：保留保护模式，配合密码使用。
• supervised systemd：交给 systemd 管理。
• appendonly yes：打开 AOF，方便学习持久化。
• maxmemory 512mb：限制 Redis 最大内存，避免吃光虚拟机内存。
• requirepass Redis@123456：学习环境密码，后续生产环境必须换成强密码。

11. 配置 systemd 服务

创建服务文件：

1

sudo vim /etc/systemd/system/redis-6379.service

命令说明：

写入：

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

[Unit]
Description=Redis Server 6379
After=network.target

[Service]
Type=notify
User=redis-svc
Group=redis-svc
RuntimeDirectory=redis
RuntimeDirectoryMode=0755
Environment=REDISCLI_AUTH=Redis@123456
ExecStart=/usr/local/redis/bin/redis-server /etc/redis/redis-6379.conf --supervised systemd --daemonize no
ExecStop=/usr/local/redis/bin/redis-cli --no-auth-warning -p 6379 shutdown
Restart=always
RestartSec=3
LimitNOFILE=100000
PrivateTmp=true
PrivateDevices=true
ProtectHome=true
ProtectSystem=full
ReadWritePaths=/data/redis/6379 /var/log/redis /run/redis

[Install]
WantedBy=multi-user.target

服务配置说明：

加载并启动：

1
2
3

sudo systemctl daemon-reload
sudo systemctl enable redis-6379
sudo systemctl start redis-6379

命令说明：

查看状态：

1

sudo systemctl status redis-6379

命令说明：

如果启动失败：

1
2

sudo journalctl -u redis-6379 -n 100 --no-pager
sudo tail -n 100 /var/log/redis/redis-6379.log

命令说明：

12. 防火墙配置

Ubuntu Server 默认不一定启用 ufw，先查看：

1

sudo ufw status

命令说明：

如果启用了 ufw，放行 Redis 端口：

1
2

sudo ufw allow from 192.168.88.0/24 to any port 6379 proto tcp
sudo ufw reload

命令说明：

学习环境中也可以暂时关闭 ufw，但你要知道生产环境不能这么做：

1

sudo ufw disable

命令说明：

13. 验证 Redis

13.1 本机连接

1

/usr/local/redis/bin/redis-cli -h 127.0.0.1 -p 6379 -a Redis@123456

命令说明：

执行：

1
2
3
4
5
6

ping
set hello redis
get hello
info server
info memory
info persistence

命令说明：

预期：

1
2
3

PONG
OK
"redis"

13.2 宿主机远程连接

在 Windows 宿主机或其他虚拟机上执行：

1

redis-cli -h 192.168.88.101 -p 6379 -a Redis@123456 ping

命令说明：

预期：

1

PONG

如果宿主机没有 redis-cli，可以先在虚拟机内验证端口监听：

1

sudo ss -lntp | grep 6379

命令说明：

也可以在 Windows PowerShell 中简单测试端口：

1

Test-NetConnection 192.168.88.101 -Port 6379

命令说明：

14. 验证持久化

14.1 验证 RDB

1
2
3
4

redis-cli -a Redis@123456 set rdb:test 1
redis-cli -a Redis@123456 bgsave
redis-cli -a Redis@123456 lastsave
ls -lh /data/redis/6379

命令说明：

应该能看到 dump.rdb。

重启 Redis：

1
2

sudo systemctl restart redis-6379
redis-cli -a Redis@123456 get rdb:test

命令说明：

14.2 验证 AOF

1
2
3
4

redis-cli -a Redis@123456 set aof:test 1
redis-cli -a Redis@123456 bgrewriteaof
redis-cli -a Redis@123456 info persistence
ls -lh /data/redis/6379

命令说明：

Redis 7 的 AOF 可能会生成 appendonlydir 目录，这是正常现象。

15. 常用管理命令

服务管理：

1
2
3
4
5
6

sudo systemctl start redis-6379
sudo systemctl stop redis-6379
sudo systemctl restart redis-6379
sudo systemctl status redis-6379
sudo systemctl enable redis-6379
sudo systemctl disable redis-6379

命令说明：

日志查看：

1
2

sudo journalctl -u redis-6379 -f
sudo tail -f /var/log/redis/redis-6379.log

命令说明：

基础状态：

1
2
3
4
5

redis-cli -a Redis@123456 info server
redis-cli -a Redis@123456 info clients
redis-cli -a Redis@123456 info memory
redis-cli -a Redis@123456 info persistence
redis-cli -a Redis@123456 info stats

命令说明：

慢查询：

1
2

redis-cli -a Redis@123456 slowlog get 10
redis-cli -a Redis@123456 slowlog len

命令说明：

延迟：

1
2

redis-cli -a Redis@123456 latency latest
redis-cli -a Redis@123456 latency doctor

命令说明：

16. 建议做的单机实验

16.1 配置变更实验

修改 /etc/redis/redis-6379.conf 中的 maxmemory，然后重启：

1
2

sudo systemctl restart redis-6379
redis-cli -a Redis@123456 config get maxmemory

命令说明：

目的：理解配置文件、启动参数和运行时配置的关系。

16.2 密码验证实验

不带密码执行：

1

redis-cli ping

命令说明：

带密码执行：

1

redis-cli -a Redis@123456 ping

命令说明：

目的：理解 Redis 认证机制。

16.3 数据恢复实验

写入数据后重启：

1
2
3

redis-cli -a Redis@123456 set recover:test ok
sudo systemctl restart redis-6379
redis-cli -a Redis@123456 get recover:test

命令说明：

目的：验证 RDB/AOF 生效。

16.4 慢查询实验

临时调整慢查询阈值：

1
2
3
4

redis-cli -a Redis@123456 config set slowlog-log-slower-than 0
redis-cli -a Redis@123456 set slowlog:test 1
redis-cli -a Redis@123456 slowlog get 5
redis-cli -a Redis@123456 config set slowlog-log-slower-than 10000

命令说明：

目的：知道慢查询日志如何产生和查看。

17. 常见问题

17.1 netplan apply 后网络断了

先回到 VMware 控制台检查：

1
2
3

cat /etc/netplan/00-installer-config.yaml
ip addr
ip route

命令说明：

高频原因：

• 网卡名不是 ens33。
• addresses 不在 VMnet8 网段。
• via 不是 VMware NAT 实际网关。
• YAML 缩进错误。

17.2 宿主机连不上 Redis

按顺序排查：

1
2
3
4
5

ip addr
ping 192.168.88.101
sudo ss -lntp | grep 6379
sudo ufw status
sudo systemctl status redis-6379

命令说明：

常见原因：

• 虚拟机没有接到 VMnet8 NAT。
• 虚拟机 IP 不是 192.168.88.101。
• Redis 只绑定了 127.0.0.1。
• ufw 没放行 6379。
• Redis 密码没带或密码错误。

17.3 Redis 启动失败

优先看：

1
2
3

sudo systemctl status redis-6379
sudo journalctl -u redis-6379 -n 100 --no-pager
sudo tail -n 100 /var/log/redis/redis-6379.log

命令说明：

常见原因：

• 配置文件语法错误。
• 数据目录权限不对。
• 日志目录权限不对。
• 端口被占用。
• supervised 配置和 systemd 服务类型不匹配。

17.4 redis-cli 提示 AUTH 警告

使用 -a 会提示密码暴露风险，这是正常警告。

可以使用环境变量减少命令行暴露：

1
2

export REDISCLI_AUTH='Redis@123456'
redis-cli ping

命令说明：

17.5 make test 出现 Active defrag 失败

如果执行 make test 时出现类似错误：

1
2
3
4

*** [err]: Active defrag - AOF loading in tests/unit/memefficiency.tcl
Expected 66 <= 40
make[1]: *** [Makefile:462: test] Error 1
make: *** [Makefile:6: test] Error 2

这通常不是 Redis 编译失败，而是 Redis 自带测试里的延迟敏感用例在虚拟机中超时。VMware 学习环境 CPU、磁盘 IO、内存分配和宿主机负载都会影响这类测试。

先确认 Redis 二进制是否已经编译出来：

1
2
3

cd /usr/local/src/redis-7.2.5
src/redis-server --version
src/redis-cli --version

命令说明：

如果版本能正常输出，可以继续安装：

1

sudo make install PREFIX=/usr/local/redis

命令说明：

安装后再验证：

1
2

/usr/local/redis/bin/redis-server --version
/usr/local/redis/bin/redis-cli --version

命令说明：

处理原则：

• make 失败：不能继续，说明编译没有通过。
• make test 失败：先看失败原因；如果是虚拟机中的延迟测试失败，学习环境可以继续安装。
• 生产编译或正式交付环境：应该换更稳定的机器重新跑完整测试。

17.6 systemd 启动提示未编译 systemd 支持

如果执行启动命令时出现超时：

1

Job for redis-6379.service failed because a timeout was exceeded.

同时 Redis 日志里出现类似信息：

1

systemd supervision requested, but Redis was compiled without libsystemd support

说明 Redis 实际已经启动了，但 systemd 服务使用了 Type=notify，正在等待 Redis 发送启动完成通知。当前 Redis 编译时没有启用 systemd 支持，所以不会发送通知，最终 systemd 等待超时并终止 Redis。

这个问题通常由下面两处配置共同触发：

1

supervised systemd

1

Type=notify

处理方式是安装 libsystemd-dev 后重新编译：

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

sudo systemctl stop redis-6379
sudo systemctl reset-failed redis-6379
sudo apt update
sudo apt install -y libsystemd-dev
cd /usr/local/src
sudo chown -R $(id -u):$(id -g) redis-7.2.5
cd /usr/local/src/redis-7.2.5
make distclean
make USE_SYSTEMD=yes -j2
sudo make install PREFIX=/usr/local/redis
sudo ln -sf /usr/local/redis/bin/redis-server /usr/local/bin/redis-server
sudo ln -sf /usr/local/redis/bin/redis-cli /usr/local/bin/redis-cli
sudo ln -sf /usr/local/redis/bin/redis-benchmark /usr/local/bin/redis-benchmark
sudo systemctl daemon-reload
sudo systemctl restart redis-6379

命令说明：

如果你确认已经重新编译过，但 systemd 仍然超时，按下面顺序验证到底是哪一个二进制有问题：

1
2
3
4

cd /usr/local/src/redis-7.2.5
ldd src/redis-server | grep systemd || echo "src/redis-server 未链接 libsystemd"
ldd /usr/local/redis/bin/redis-server | grep systemd || echo "/usr/local/redis/bin/redis-server 未链接 libsystemd"
sudo systemctl cat redis-6379

命令说明：

判断方式：

• src/redis-server 没有 libsystemd：说明源码目录没有用 make USE_SYSTEMD=yes 成功编译。
• src/redis-server 有 libsystemd，但 /usr/local/redis/bin/redis-server 没有：说明只编译了源码目录，没有重新 sudo make install PREFIX=/usr/local/redis。
• 两个都有 libsystemd，但仍然超时：检查 sudo systemctl cat redis-6379 里的 ExecStart 是否指向 /usr/local/redis/bin/redis-server。

如果你已经按本文安装过 libsystemd-dev 并使用 make USE_SYSTEMD=yes -j2 编译，正常不会遇到这个问题。

17.7 make 出现 Permission denied

如果编译或测试时出现类似错误：

1
2
3

sh: 1: cannot create foo.c: Permission denied
rm: cannot remove 'redis-server': Permission denied
can't create directory "./tests/tmp/server.xxxxx": permission denied

说明 Redis 源码目录或之前的编译产物属于 root，当前登录用户没有写权限。常见原因是之前执行过 sudo tar、sudo make 或用 root 编译过。

处理方式：

1
2
3
4
5

cd /usr/local/src
sudo chown -R $(id -u):$(id -g) redis-7.2.5
cd redis-7.2.5
make distclean
make USE_SYSTEMD=yes -j2

命令说明：

如果还要重新执行测试：

1

make test

命令说明：

测试通过或确认只是虚拟机延迟测试失败后，再安装：

1

sudo make install PREFIX=/usr/local/redis

命令说明：

原则：

• 源码编译和测试用普通登录用户执行。
• 只有安装到 /usr/local/redis 时才使用 sudo make install。
• 不建议使用 sudo make 或 sudo make test，否则容易留下 root-owned 编译产物。

18. 本阶段完成标准

完成本文后，你应该做到：

1. 能用 Ubuntu 22.04.5 创建模板机。
2. 能从模板机克隆出 redis-single-1。
3. 能给 redis-single-1 配置静态 IP 192.168.88.101/24。
4. 能解释 addresses 和 routes.via 为什么这样配置。
5. 能从源码安装 Redis。
6. 能解释 /etc/redis、/data/redis/6379、/var/log/redis 分别做什么。
7. 能用 systemctl 管理 Redis。
8. 能从宿主机连接虚拟机 Redis。
9. 能验证 RDB 和 AOF 文件生成。
10. 能排查 Redis 启动失败和远程连接失败。

达到这个状态后，再进入主从复制和 Sentinel，会更顺。