在 Ubuntu 20.04 上离线安装和配置 Redis

下面是从零开始配置 Redis 的完整步骤，包括从安装 Redis 到离线安装 Redis 包的步骤。本文将覆盖如何从下载 Redis 安装包、手动安装 Redis、创建所需目录、配置 Redis、以及如何配置 Redis 为系统服务，确保服务可以在启动时自动运行。

步骤 1: 准备环境并安装 Redis

1. 更新系统软件包：
   打开终端，确保系统是最新的：

   sudo apt update
   sudo apt upgrade -y
   

2. 安装 Redis 依赖包：
   在某些情况下，Redis 需要一些开发工具和依赖包来进行编译：

   sudo apt install build-essential tcl -y
   

3. 下载 Redis 安装包：
   如果你希望离线安装 Redis，可以从 Redis 的官网下载源代码包，或使用下面的命令：

   wget http://download.redis.io/redis-stable.tar.gz
   

4. 解压并进入 Redis 目录：
   下载完成后，解压 Redis 源代码包：

   tar xzvf redis-stable.tar.gz
   cd redis-stable
   

5. 编译 Redis：
   进入解压后的 Redis 目录后，执行以下命令进行编译：

   make
   

   编译完成后，可以通过执行以下命令运行测试：

   make test
   

6. 安装 Redis：
   编译成功后，可以安装 Redis 到系统路径：

   sudo make install
   

步骤 2: 创建必要的目录

Redis 默认安装时会使用一些特定的目录（如日志目录、PID 文件目录等）。如果这些目录不存在，您需要手动创建它们。

1. 创建 Redis 日志目录：
   Redis 日志文件将保存在 /var/log/redis 目录下。如果目录不存在，使用以下命令创建：

   sudo mkdir -p /var/log/redis
   sudo chown redis:redis /var/log/redis
   

2. 创建 Redis 数据目录：
   Redis 默认的数据文件保存在 /var/lib/redis 目录下。如果目录不存在，创建它并赋予适当的权限：

   sudo mkdir -p /var/lib/redis
   sudo chown redis:redis /var/lib/redis
   

3. 创建 Redis PID 文件目录：
   Redis 会生成一个 PID 文件，通常位于 /var/run/redis，确保此目录存在：

   sudo mkdir -p /var/run/redis
   sudo chown redis:redis /var/run/redis
   

步骤 3: 配置 Redis

Redis 配置文件位于 /etc/redis/redis.conf，如果该文件不存在，可以从 Redis 源代码目录复制一份。

1. 创建 Redis 配置文件：
   复制默认的配置文件到 /etc/redis/redis.conf：

   sudo cp redis.conf /etc/redis/redis.conf
   

2. 修改配置文件：
   使用 Vim 编辑 /etc/redis/redis.conf 配置文件：

   sudo vim /etc/redis/redis.conf
   

3. 修改以下配置项：

   • 允许外部访问：
     如果您希望允许外部客户端访问 Redis，请修改 bind 配置项：

     bind 0.0.0.0  # 允许所有 IP 地址访问
     

     默认情况下，bind 配置项为 127.0.0.1，这会限制只能从本地连接 Redis。如果不需要外部访问，可以保留默认设置。

   • 禁用保护模式：
     只有在外部访问时才需要禁用保护模式：

     protected-mode no  # 禁用保护模式
     

   • 设置 Redis 密码：
     设置一个强密码来增强安全性：

     requirepass 123456 # 请确保设置一个强密码
     

   • 启用日志文件：
     设置 Redis 日志文件的路径，确保日志文件目录 /var/log/redis 已经存在：

     logfile /var/log/redis/redis-server.log
     

   • 禁用后台运行：
     如果使用 systemd 管理 Redis，设置为 no，不使用后台运行模式：

     daemonize no
     

4. 保存并退出 Vim：
   按 Esc 键，输入 :wq 然后按回车。

步骤 4: 配置 Systemd 服务

1. 创建 Redis Systemd 服务文件：
   使用 Vim 编辑 /etc/systemd/system/redis.service 文件：

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

2. 添加以下服务配置：

   [Unit]
   Description=Redis In-Memory Data Store
   After=network.target[Service]
   ExecStart=/usr/local/bin/redis-server /etc/redis/redis.conf --requirepass "123456"
   ExecStop=/usr/local/bin/redis-cli -a "123456" shutdown
   Restart=always
   TimeoutStopSec=300
   User=redis
   Group=redis[Install]
   WantedBy=multi-user.target
   

3. 保存并退出 Vim：
   按 Esc 键，输入 :wq 然后按回车。

步骤 5: 启动和管理 Redis 服务

1. 重新加载 Systemd 配置：
   每当您修改或添加服务文件时，都需要重新加载 Systemd 配置：

   sudo systemctl daemon-reload
   

2. 启动 Redis 服务：
   启动 Redis 服务：

   sudo systemctl start redis
   

3. 设置 Redis 开机自启：
   确保 Redis 服务在系统启动时自动启动：

   sudo systemctl enable redis
   

4. 检查 Redis 服务状态：
   查看 Redis 服务是否正在运行：

   sudo systemctl status redis
   

步骤 6: 测试 Redis 连接

1. 测试 Redis 连接：
   使用 redis-cli 工具测试与 Redis 的连接。由于我们设置了密码，使用 -a 参数提供密码：

   redis-cli -a 123456 ping
   

   如果 Redis 配置正确，您会收到 PONG 响应，表示连接成功。

步骤 7: 排查问题

1. 查看 Redis 服务日志：
   如果 Redis 无法正常启动，您可以查看 Redis 服务日志来了解详细错误信息：

   sudo journalctl -u redis
   

2. 查看 Redis 错误日志：
   Redis 会将错误日志记录到 /var/log/redis/redis-server.log 文件中，您可以查看该文件以获取更多信息：

   sudo cat /var/log/redis/redis-server.log