Linux 平台 Redis Insight 安装卸载与常见问题

一、前言

Redis Insight 是 Redis 官方推出的一款功能强大的可视化管理工具，它能够帮助开发人员和运维人员更直观、高效地管理 Redis 数据库，支持数据查看、编辑、查询优化、性能监控等多种功能。本文档将详细介绍在 Linux 平台上安装 Redis Insight 的完整方案，适用于主流的 Linux 发行版（如 Ubuntu、CentOS、Debian 等）。

二、环境准备

在开始安装 Redis Insight 之前，需确保 Linux 系统满足以下基础环境要求，以保证工具能够正常运行：

2.1 系统配置要求

操作系统：64 位 Linux 发行版（推荐 Ubuntu 18.04 及以上、CentOS 7 及以上、Debian 10 及以上）；
CPU：至少 1 核（推荐 2 核及以上，用于保证工具运行流畅）；
内存：至少 2GB（推荐 4GB 及以上，避免因内存不足导致工具卡顿或崩溃）；
磁盘空间：至少 1GB 空闲空间（用于存储安装文件和工具运行产生的数据）；
网络：确保系统能够连接互联网（用于下载安装包或依赖组件）。

2.2 依赖组件检查与安装

Redis Insight 运行依赖部分基础系统组件，需提前检查并安装：

检查 curl 工具：curl 用于下载 Redis Insight 安装包，执行以下命令检查是否已安装：

|----------------|
| curl --version |

若提示 "command not found"，则需安装 curl：

Ubuntu/Debian 系统：

|-----------------------------------------------|
| sudo apt update && sudo apt install -y curl |

CentOS 系统：

|--------------------------|
| sudo yum install -y curl |

检查 libatomic 组件：部分 Linux 系统（如 CentOS 7）可能缺少 libatomic，Redis Insight 运行时会依赖该组件，执行以下命令检查：

|--------------------------------------|
| ls /usr/lib64/libatomic.so.1 # 64位系统 |

若文件不存在，需安装 libatomic：

Ubuntu/Debian 系统：

|--------------------------------|
| sudo apt install -y libatomic1 |

CentOS 系统：

|-------------------------------|
| sudo yum install -y libatomic |

检查 Redis 服务（可选）：若需通过 Redis Insight 管理本地 Redis 服务，需确保 Redis 服务已安装并正常运行；若仅管理远程 Redis 服务，则无需在本地安装 Redis。

三、安装方式

Redis Insight 在 Linux 平台提供两种主流安装方式：deb/rpm 包安装（适用于对应发行版） 和tar.gz 压缩包安装（通用型），可根据自身 Linux 发行版选择合适的方式。

3.1 deb 包安装（适用于 Ubuntu、Debian 等 deb 系系统）

3.1.1 下载 deb 安装包

访问 Redis 官方下载页面（https://redis.io /docs /ui/i nsigh t/ins tall/）获取最新版 Redis Insight 的 deb 包下载链接，或直接通过 curl 命令下载（以最新版 1.14.0 为例，实际版本号可根据官网更新调整）：

|---------------------------------------------------------------------------------------|
| curl -O https://download.redis.io/redis-insight/1.14.0/redis-insight_1.14.0_amd64.deb |

3.1.2 安装 deb 包

使用 dpkg 命令安装下载的 deb 包，若出现依赖缺失问题，可通过 apt 命令修复：

|------------------------------------------------------------------------------------------------|
| # 安装deb包 sudo dpkg -i redis-insight_1.14.0_amd64.deb # 若提示依赖缺失，执行以下命令修复 sudo apt -f install -y |

3.1.3 验证安装

安装完成后，执行以下命令检查 Redis Insight 是否成功安装：

|-------------------------|
| redis-insight --version |

若输出类似 "Redis Insight 1.14.0" 的版本信息，则说明安装成功。

3.2 rpm 包安装（适用于 CentOS、RHEL 等 rpm 系系统）

3.2.1 下载 rpm 安装包

通过 curl 命令下载最新版 Redis Insight 的 rpm 包（以 1.14.0 为例）：

|------------------------------------------------------------------------------------------|
| curl -O https://download.redis.io/redis-insight/1.14.0/redis-insight-1.14.0-1.x86_64.rpm |

3.2.2 安装 rpm 包

使用 rpm 命令安装 rpm 包，若出现依赖缺失，可通过 yum 命令修复：

|---------------------------------------------------------------------------------------------------------------|
| # 安装rpm包 sudo rpm -ivh redis-insight-1.14.0-1.x86_64.rpm # 若提示依赖缺失，执行以下命令修复 sudo yum install -y --skip-broken |

3.2.3 验证安装

执行以下命令检查安装结果：

|-------------------------|
| redis-insight --version |

输出版本信息即表示安装成功。

3.3 tar.gz 压缩包安装（通用型，适用于所有 Linux 发行版）

3.3.1 下载 tar.gz 压缩包

通过 curl 命令下载最新版 Redis Insight 的 tar.gz 压缩包（以 1.14.0 为例）：

|-------------------------------------------------------------------------------------------------|
| curl -O https://download.redis.io/redis-insight/1.14.0/redis-insight-linux-x86_64-1.14.0.tar.gz |

3.3.2 解压压缩包

选择合适的安装目录（如/opt），将压缩包解压到该目录：

|--------------------------------------------------------------------------------------------------------------------------------------------|
| # 创建安装目录（若不存在） sudo mkdir -p /opt/redis-insight # 解压压缩包到安装目录 sudo tar -zxvf redis-insight-linux-x86_64-1.14.0.tar.gz -C /opt/redis-insight |

3.3.3 配置环境变量（可选）

为了方便在任意目录下执行 Redis Insight 命令，可将其可执行文件路径添加到系统环境变量中：

|-------------------------------------------------------------------------------------------------------------------------------------------------|
| # 编辑/etc/profile文件，添加环境变量 sudo vi /etc/profile # 在文件末尾添加以下内容（路径需与实际解压路径一致） export PATH=$PATH:/opt/redis-insight # 使环境变量立即生效 source /etc/profile |

3.3.4 验证安装

执行以下命令检查是否安装成功：

|-------------------------------------------------------------------------------------------------------------|
| # 若已配置环境变量，直接执行 redis-insight --version # 若未配置环境变量，执行解压目录下的可执行文件 /opt/redis-insight/redis-insight --version |

输出版本信息即表示安装成功。

四、启动 Redis Insight

4.1 命令行启动（临时启动）

直接在命令行中执行以下命令启动 Redis Insight：

|----------------------------------------------------------------------------------|
| # 若已配置环境变量 redis-insight # 若未配置环境变量（tar.gz安装方式） /opt/redis-insight/redis-insight |

启动成功后，命令行将输出类似以下信息，提示 Redis Insight 已在本地 8001 端口运行：

|---------------------------------------------------|
| Redis Insight is running at http://localhost:8001 |

4.2 后台启动（长期运行）

若需 Redis Insight 在后台持续运行，可使用nohup命令或创建系统服务：

4.2.1 使用 nohup 命令后台启动

|-------------------------------------------------------------------------------------------------------------------------------|
| # 后台启动并将日志输出到redis-insight.log文件 nohup redis-insight > redis-insight.log 2>&1 & # 查看进程是否启动成功 ps -ef | grep redis-insight |

若输出包含redis-insight的进程信息，则说明后台启动成功。

4.2.2 创建系统服务（推荐，适用于生产环境）

以 CentOS 7 为例，创建系统服务实现 Redis Insight 开机自启：

创建服务文件/etc/systemd/system/redis-insight.service：

|---------------------------------------------------|
| sudo vi /etc/systemd/system/redis-insight.service |

添加以下内容（根据实际安装路径调整ExecStart路径）：

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit] Description=Redis Insight - Redis Visual Management Tool After=network.target [Service] Type=simple User=root # 可根据实际需求修改运行用户 ExecStart=/opt/redis-insight/redis-insight # tar.gz安装路径，若为deb/rpm安装，路径通常为/usr/bin/redis-insight Restart=always # 服务异常退出时自动重启 RestartSec=5 # 重启间隔时间（秒） [Install] WantedBy=multi-user.target |

重新加载系统服务配置：

|------------------------------|
| sudo systemctl daemon-reload |

启动服务并设置开机自启：

|-------------------------------------------------------------------------------------------------------------------------------------|
| # 启动服务 sudo systemctl start redis-insight # 设置开机自启 sudo systemctl enable redis-insight # 查看服务状态 sudo systemctl status redis-insight |

若服务状态显示 "active (running)"，则说明服务启动成功且已配置开机自启。

五、访问与使用 Redis Insight

5.1 本地访问

在 Linux 系统本地打开浏览器，输入http://localhost:8001，即可进入 Redis Insight 登录页面。首次访问时，需同意用户协议并设置密码（用于保护 Redis Insight 管理界面，建议设置强密码）。

5.2 远程访问（可选）

若需从其他设备（如 Windows 电脑）访问 Linux 服务器上的 Redis Insight，需完成以下配置：

开放 Linux 服务器 8001 端口 ：
- Ubuntu/Debian 系统（使用 ufw 防火墙）：

|-----------------------------------------|
| sudo ufw allow 8001/tcp sudo ufw reload |

- CentOS 系统（使用 firewalld 防火墙）：

|--------------------------------------------------------------------------------------------|
| sudo firewall-cmd --zone=public --add-port=8001/tcp --permanent sudo firewall-cmd --reload |

远程设备访问 ：在远程设备的浏览器中输入http://[Linux服务器IP地址]:8001，即可访问 Redis Insight 界面。

5.3 连接 Redis 数据库

在 Redis Insight 主界面点击 "Add Redis Database"；
填写 Redis 连接信息：
- Host ：Redis 服务器 IP 地址（本地 Redis 填localhost或127.0.0.1，远程 Redis 填对应服务器 IP）；
- Port：Redis 服务端口（默认 6379）；
- Name：连接名称（自定义，如 "Local Redis"）；
- 若 Redis 配置了密码认证，需在 "Authentication" 部分填写密码；
- 若 Redis 启用了 SSL/TLS 加密，需在 "SSL" 部分开启对应配置。

点击 "Test Connection" 测试连接是否成功，成功后点击 "Add" 完成连接。

连接成功后，即可在 Redis Insight 界面中查看 Redis 数据库的键值对、执行命令、监控性能等操作。

六、常见问题与解决方法

6.1 启动时提示 "端口被占用"

问题现象 ：执行redis-insight启动时，提示 "Error: listen EADDRINUSE: address already in use :::8001"。

解决方法：

查找占用 8001 端口的进程：

|-----------------------------|
| netstat -tulpn | grep 8001 |

杀死占用端口的进程（若为无用进程）：

|-----------------------|
| sudo kill -9 [进程ID] |

或修改 Redis Insight 的默认端口，启动时指定端口：

|----------------------------------------|
| redis-insight --port 8002 # 使用8002端口启动 |

6.2 安装 deb 包时提示 "依赖关系问题 - 仍未被配置"

问题现象 ：执行sudo dpkg -i redis-insight_*.deb时，提示依赖缺失且无法通过apt -f install修复。

解决方法：

更新 apt 软件源：

|-----------------|
| sudo apt update |

手动安装缺失的依赖（根据提示的缺失依赖名称，如libgconf-2-4）：

|----------------------------------|
| sudo apt install -y libgconf-2-4 |

重新安装 deb 包：

|-----------------------------------|
| sudo dpkg -i redis-insight_*.deb |

6.3 远程访问时无法打开 Redis Insight 界面

问题现象 ：远程设备输入http://[Linux服务器IP]:8001后，提示 "无法访问此网站"。

解决方法：

检查 Linux 服务器 8001 端口是否开放：

|-------------------------------------------------------------------------------------------------------------|
| # Ubuntu/Debian sudo ufw status | grep 8001 # CentOS sudo firewall-cmd --zone=public --query-port=8001/tcp |

若未开放，按 "5.2 远程访问" 中的步骤开放端口。

检查 Redis Insight 服务是否正常运行：

|-------------------------------------------------------------------------------------|
| # 系统服务方式 sudo systemctl status redis-insight # nohup方式 ps -ef | grep redis-insight |

若服务未运行，重启服务

|------------------------------------------------------------------------------------------------------------|
| # 系统服务方式 sudo systemctl restart redis-insight # nohup方式 nohup redis-insight > redis-insight.log 2>&1 & |

检查 Linux 服务器 IP 地址是否正确，可通过ifconfig或ip addr命令查看服务器正确 IP。

6.4 连接 Redis 时提示 "认证失败"

问题现象：在 Redis Insight 中填写密码后，测试连接提示 "Authentication failed"。

解决方法：

确认 Redis 服务是否启用了密码认证：

|-----------------------------------------------------|
| # 本地连接Redis redis-cli # 执行auth命令测试密码 auth [填写的密码] |

若提示 "OK"，则密码正确；若提示 "ERR invalid password"，则密码错误。

若密码错误，需在 Redis 配置文件（redis.conf）中查看或修改密码：

|------------------------------------------------------------------------------------------------------------------------------------------|
| # 编辑Redis配置文件（路径可能为/etc/redis/redis.conf或/usr/local/redis/redis.conf） sudo vi /etc/redis/redis.conf # 查找requirepass配置项，确认密码 /requirepass |

若 Redis 未启用密码认证，需在 Redis Insight 连接配置中取消 "Authentication" 勾选，或在 Redis 配置文件中启用密码认证后重启 Redis 服务。

七、卸载 Redis Insight

若需卸载 Redis Insight，可根据安装方式选择对应的卸载方法：

7.1 deb 包安装方式卸载（Ubuntu/Debian）

|-------------------------------------------------------------------------------------------------------------------------------|
| # 卸载Redis Insight sudo apt remove -y redis-insight # 清理残留文件（可选） sudo apt purge -y redis-insight sudo rm -rf ~/.redis-insight |

7.2 rpm 包安装方式卸载（CentOS/RHEL）

|----------------------------------------------------------------------------------------|
| # 卸载Redis Insight sudo rpm -e redis-insight # 清理残留文件（可选） sudo rm -rf ~/.redis-insight |

7.3 tar.gz 压缩包安装方式卸载

|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| # 删除安装目录 sudo rm -rf /opt/redis-insight # 清理环境变量（若已配置） sudo vi /etc/profile # 删除添加的export PATH=$PATH:/opt/redis-insight语句 source /etc/profile # 清理残留文件（可选） sudo rm -rf ~/.redis-insight |

八、总结

本文档详细介绍了 Linux 平台上 Redis Insight 的环境准备、三种安装方式（deb、rpm、tar.gz）、启动方法（临时启动、后台启动、系统服务）、访问与使用、常见问题解决及卸载步骤。通过本方案，可快速完成 Redis Insight 的安装与配置，实现对 Redis 数据库的可视化管理。建议根据自身 Linux 发行版选择合适的安装方式，并在生产环境中通过系统服务实现 Redis Insight 的长期稳定运行。