Redis 从安装到运行：完整指南及 “Failed listening on port 6379 (tcp)” 错误解决方法

在现代后端系统中，Redis 常被用作高速缓存、消息代理或键值型数据库，广泛服务于大规模 Web 应用。由于 Redis 采用内存存储架构，因此可以实现极快的数据访问速度，这也使它成为许多现代系统架构中的核心组件之一。

然而，对于初学者来说，在安装和启动 Redis 的过程中有时会遇到一些常见问题。其中最典型的错误之一是 “Failed listening on port 6379 (tcp), aborting”，该错误表示 Redis 无法监听其默认端口 6379。

本文将详细介绍 Redis 的安装、启动、运行检测以及如何解决端口 6379 相关错误。

什么是 Redis，以及为什么它被广泛使用

Redis 是一种 内存数据结构存储（in-memory data store）。这意味着数据存储在 RAM 中，而不是传统的硬盘数据库。因此 Redis 的数据读写速度非常快，通常只需要微秒级时间。

Redis 支持多种数据结构，例如：

• String
• List
• Set
• Sorted Set
• Hash
• Stream

因此 Redis 可以应用于许多场景，例如：

• Web 应用缓存
• 用户会话存储
• 后台任务队列
• 实时数据分析
• 发布/订阅消息系统

Redis 默认使用的网络端口是 6379，大多数应用程序也是通过该端口连接 Redis。

第一部分：在 Linux（Ubuntu）上安装 Redis

目前大多数服务器运行 Linux 系统，尤其是 Ubuntu 或 Debian。在这些系统中安装 Redis 非常简单。

步骤一：更新系统

在安装 Redis 之前，建议先更新系统软件包列表：

sudo apt update
sudo apt upgrade

更新系统可以避免依赖冲突，并确保安装最新的软件包版本。

步骤二：安装 Redis

使用以下命令安装 Redis：

sudo apt install redis-server

安装完成后，Redis 会被注册为一个 系统服务（system service）。

步骤三：检查 Redis 状态

安装完成后，可以检查 Redis 是否正在运行：

sudo systemctl status redis

如果 Redis 正常运行，你会看到类似以下状态：

active (running)

第二部分：启动和管理 Redis

Redis 可以通过 Linux 的服务管理系统进行控制。

启动 Redis

sudo systemctl start redis

停止 Redis

sudo systemctl stop redis

重启 Redis

sudo systemctl restart redis

设置 Redis 开机自动启动

sudo systemctl enable redis

这样服务器重启后 Redis 会自动运行。

第三部分：测试 Redis 是否正常运行

Redis 提供了命令行工具用于测试连接。

运行：

redis-cli

然后输入：

ping

如果 Redis 运行正常，将返回：

PONG

这表示 Redis 服务器正在正常接受连接。

第四部分：Redis 启动时的常见错误

Redis 启动时经常会遇到如下错误：

Failed listening on port 6379 (tcp), aborting

该错误表示 Redis 无法绑定端口 6379。

常见原因包括：

• 6379 端口已被其他程序占用
• 已经有另一个 Redis 实例在运行
• Redis 配置错误
• Docker 容器或其他服务占用了该端口

第五部分：检查 6379 端口是否被占用

首先需要检查哪个进程正在使用该端口。

运行：

sudo lsof -i :6379

或者：

netstat -tulpn | grep 6379

如果端口被占用，系统会显示相关进程的 PID。

例如：

redis-server 1234 root TCP *:6379 (LISTEN)

第六部分：停止占用端口的进程

如果发现 Redis 已经在运行，可以先停止它：

sudo systemctl stop redis

如果是其他程序占用了端口，可以使用：

sudo kill -9 PID

将 PID 替换为实际的进程 ID。

之后重新启动 Redis：

sudo systemctl start redis

第七部分：修改 Redis 端口

在某些环境中，6379 端口可能被其他服务占用，此时可以修改 Redis 的端口。

打开配置文件：

/etc/redis/redis.conf

找到：

port 6379

修改为例如：

port 6380

然后重新启动 Redis：

sudo systemctl restart redis

第八部分：检查 bind 配置

如果 bind 配置不正确，也可能导致 Redis 无法启动。

在配置文件中找到：

bind 127.0.0.1

该配置表示 Redis 只监听本地地址。

如果需要允许外部访问，可以改为：

bind 0.0.0.0

但这样会将 Redis 暴露到网络上，因此需要配合安全措施。

第九部分：修复后验证 Redis

修复问题后，再次检查 Redis 是否正常运行：

redis-cli ping

如果返回：

PONG

则说明 Redis 已经正常运行。

总结

Redis 是现代后端系统中非常重要的基础组件之一。虽然安装和基本使用较为简单，但由于端口冲突或配置问题，仍可能出现 “Failed listening on port 6379 (tcp)” 这样的错误。

通过检查端口占用情况、管理系统服务以及正确修改配置文件，大多数问题都可以快速解决。

在大型系统中，Redis 通常还会结合复制（replication）、集群（cluster）和 Sentinel 等机制，以提高系统的可用性和扩展能力，使其成为现代基础设施中不可或缺的一部分。