企业官网建设流程全解析

简介：本资源为南京邮电大学大数据存储与管理课程实验一的完整报告文档，面向大数据、分布式存储方向的学生及Redis初学者，帮助读者掌握Redis单机与集群环境的搭建流程，并完成一个文章投票网站后端的实战开发。压缩包内仅含1个doc文件，约933KB，内容涵盖实验目的、环境配置、原理说明、详细操作步骤、关键代码与结果分析，结构完整、条理清晰。实验基于Ubuntu 16.04，使用PyCharm与Another Redis Desktop Manager，依次讲解Redis安装、配置文件修改、集群节点创建与校验，以及利用String和Sorted Set实现文章发布、投票与评分排序功能。已有324人学习，适合需要提交实验报告或自学Redis集群与Python客户端操作的读者参考，可快速理解实验流程、复用代码逻辑并借鉴排错思路。

1. 连接被拒、集群报错、插槽占用：Redis 实验里最折腾人的三个坑

做大数据存储实验，Redis 几乎是绕不开的一关。单机装完连不上、集群建到一半报错、插槽莫名其妙被占用——这三个问题我前后踩了不止一遍。尤其是用 Another Redis Desktop Manager 连虚拟机里的 Redis 时，弹出一句RedisClient On Error: Error: connect ECONNREFUSED 127.0.0.1:6379 Config right?，看着像是配置写错了，其实根因往往跟配置无关。这篇文章把 Redis 单机安装、集群搭建、以及基于 Redis 做文章投票后端时最常翻车的几个报错拆开讲，每个都给出可复现的排查路径和修复命令。如果你正在做类似的存储实验，或者第一次搭 Redis 集群被cluster support disabled卡住，下面的内容可以照着走一遍。

2. 单机都连不上：ECONNREFUSED 与绑定地址的排查

2.1 报错现象与第一反应为什么是错的

客户端连接 Redis 时最常见的报错就是connect ECONNREFUSED 127.0.0.1:6379。新手看到这个，第一反应通常是去关 Redis 的保护模式（protected-mode），网上大量帖子也是这么教的。但实际试过就知道，关了保护模式问题依旧。原因在于：ECONNREFUSED 是 TCP 层面的连接拒绝，说明客户端根本没有和 Redis 的监听端口建立连接，而不是连上了被 Redis 拒绝。保护模式影响的是「连上之后能不能执行命令」，跟「能不能连上」是两回事。

那为什么连不上？在虚拟机里跑 Redis、在宿主机上用客户端连，这是实验里最常见的拓扑。Redis 默认配置bind 127.0.0.1，只监听回环地址。虚拟机内部的 127.0.0.1 指向虚拟机自己，宿主机的客户端如果也去连 127.0.0.1，连的是宿主机自己的回环，那里根本没有 Redis 在监听，自然被拒绝。

2.2 定位：先确认 Redis 到底在听哪个地址

排查顺序应该是从服务端往客户端推。第一步，确认 Redis 进程活着并且在监听：

# 查看 redis 进程是否存在 ps -ef | grep redis # 查看 6379 端口被谁监听，以及监听在哪个地址上 ss -tlnp | grep 6379 # 或者用 netstat netstat -tlnp | grep 6379

如果输出里显示的是127.0.0.1:6379，说明只绑定了回环地址，外部连不进来。如果显示0.0.0.0:6379或具体网卡 IP，说明监听范围够。这一步能直接区分「服务没起来」和「服务起来了但绑错地址」两种情况。

第二步，拿到虚拟机的真实 IP：

ifconfig # 或者 ip addr show

记下类似192.168.x.x的地址，这是客户端应该连的目标。

2.3 解决：改绑定地址并放行端口

修改 Redis 配置文件：

sudo vim /etc/redis/redis.conf

找到bind这一行，改成监听所有地址（实验环境图方便，生产环境要谨慎）：

# 原来可能是 bind 127.0.0.1 ::1 # 改为监听所有网卡，实验环境够用 bind 0.0.0.0 # 如果开了保护模式，配合绑定地址一起调整 protected-mode no

改完重启：

/etc/init.d/redis-server restart

然后在客户端里把连接地址从127.0.0.1改成虚拟机的实际 IP，端口保持 6379。这一步是实验小结里明确记录过的：关保护模式没用，换 IP 才连上。

注意：bind 0.0.0.0会让 Redis 对所有网卡开放，实验环境无所谓，但如果机器有公网地址，务必配合防火墙和密码使用，别裸奔。

2.4 参数说明与验证

bind参数决定 Redis 监听哪些网络接口，可以写多个地址，用空格分隔。protected-mode是 Redis 3.2 之后引入的安全兜底：当没有绑定地址、没有设密码时，它会拒绝外部连接。两者配合才能让外部客户端连上。改完配置后，用ss -tlnp | grep 6379再确认一次监听地址变成了0.0.0.0:6379，再用客户端连，基本就能通。如果还不通，检查虚拟机防火墙：

# 查看防火墙状态 sudo ufw status # 实验环境可以直接放行 6379 sudo ufw allow 6379

3. 集群建不起来：cluster support disabled 与插槽占用的处理

3.1 报错一：This instance has cluster support disabled

单机跑通之后，下一步就是搭集群。按实验步骤创建好 6 个节点的配置文件、依次启动，然后执行redis-cli --cluster create ...合成集群，结果报：

(error) ERR This instance has cluster support disabled

这个报错很直白：当前 Redis 实例没有开启集群支持。Redis 默认是单机模式，集群功能是关闭的。很多人复制了/etc/redis/redis.conf到集群目录，但忘了改cluster-enabled这一项，或者改了但前面有#注释没去掉，配置根本没生效。

3.2 解决：逐个节点开启集群模式

每个节点的配置文件都要改，以 6379 为例：

# 开启集群模式，去掉行首的 # 注释 cluster-enabled yes # 集群配置文件，每个节点必须不同，否则会互相覆盖 cluster-config-file nodes-6379.conf # 节点超时时间，毫秒 cluster-node-timeout 15000 # 开启后台运行 daemonize yes # 指定端口，每个节点不同 port 6379 # 日志文件，每个节点不同 logfile /opt/redis/cluster/log/redis_6379.log # 数据目录，每个节点不同 dir /var/lib/redis/6379

六个节点（6379、6380、6381、6389、6390、6391）的配置结构一样，只有port、cluster-config-file、logfile、dir这四项要改成各自对应的值。改完逐个启动：

/usr/bin/redis-server /opt/redis/cluster/redis-6379.conf /usr/bin/redis-server /opt/redis/cluster/redis-6380.conf /usr/bin/redis-server /opt/redis/cluster/redis-6381.conf /usr/bin/redis-server /opt/redis/cluster/redis-6389.conf /usr/bin/redis-server /opt/redis/cluster/redis-6390.conf /usr/bin/redis-server /opt/redis/cluster/redis-6391.conf

启动后确认六个进程都在：

ps -ef | grep redis

这里有个容易忽略的点：cluster-config-file如果六个节点写成同一个文件名，节点启动后会互相覆盖集群状态，导致集群信息混乱。每个节点必须用独立的文件名，通常带上端口号区分。

3.3 报错二：Slot 671 is already busy

集群模式开启后重新执行 create，可能又报：

(error) ERR Slot 671 is already busy

这个报错的意思是：671 这个哈希槽已经被占用了，无法重新分配。根因是之前搭集群失败留下的旧数据和集群配置没清理干净。Redis 集群把数据分成 16384 个槽，每个槽分配给某个主节点。上次创建到一半失败，槽的分配信息残留在节点的集群配置文件里，这次再创建就冲突了。

3.4 解决：清空数据并重置集群状态

需要对每个节点都执行清理。先连上每个节点：

redis-cli -p 6379

在交互界面里执行两条命令：

# 清空当前节点的所有数据 flushall # 重置集群状态，清除槽分配信息 cluster reset

六个节点（6379 到 6391）都要走一遍。如果嫌一个个连麻烦，可以用循环：

for port in 6379 6380 6381 6389 6390 6391; do redis-cli -p $port flushall redis-cli -p $port cluster reset done

清理完再执行集群创建命令：

/usr/bin/redis-cli --cluster create --cluster-replicas 1 \ 127.0.0.1:6379 127.0.0.1:6380 127.0.0.1:6381 \ 127.0.0.1:6389 127.0.0.1:6390 127.0.0.1:6391

--cluster-replicas 1表示每个主节点配一个从节点，六个节点正好三主三从。执行后会提示确认槽分配方案，输入yes即可。创建成功后验证：

redis-cli cluster nodes cluster info

cluster nodes能看到六个节点的角色和槽范围，cluster info里cluster_state:ok说明集群健康。

注意：cluster reset会清掉集群配置，但不会删数据文件。如果之前有持久化数据，建议先确认不需要了再执行，或者用cluster reset hard做更彻底的清理。

3.5 客户端连集群：connection is close 与 cluster is ended

集群建好了，用 Another Redis Desktop Manager 连集群时又可能报stream on error: connection is close和cluster is ended。这是因为客户端连集群的方式和连单机不一样。单机是直连一个地址，集群需要客户端能感知所有节点。实验里验证有效的做法是用 SSH 隧道加集群模式连接：在客户端里选择集群连接类型，配置 SSH 跳板到虚拟机，再指定集群节点地址。这样客户端能通过隧道访问到所有节点，集群拓扑才能正常建立。

4. 投票后端跑不通：rediscluster 库与数据操作的常见问题

4.1 安装 redis-py-cluster 与连接集群

文章投票后端要操作集群，单机的redis库不支持集群模式，需要装redis-py-cluster：

pip install redis-py-cluster

连接集群的代码大致长这样：

from rediscluster import RedisCluster # 集群启动节点列表，客户端会自动发现其他节点 startup_nodes = [ {"host": "127.0.0.1", "port": "6379"}, {"host": "127.0.0.1", "port": "6380"}, {"host": "127.0.0.1", "port": "6381"}, ] # decode_responses=True 让返回结果是字符串而不是字节 rc = RedisCluster(startup_nodes=startup_nodes, decode_responses=True)

startup_nodes只需要给部分节点，客户端会通过cluster slots命令自动发现完整拓扑。decode_responses=True是个实用参数，不加的话读出来的 key 和 value 都是b'xxx'字节串，调试时很别扭。

4.2 发布文章与投票的核心逻辑

实验里的post函数负责发布文章并投初始票：

import time def post(articleData, redis=rc): # article 计数器自增，生成唯一文章 ID articleId = str(redis.incr('article')) article = 'article' + articleId # 用哈希存储文章的各字段 for k, v in articleData.items(): redis.hset(article, k, v) # 记录发布时间，用有序集合按时间排序 post_time = time.time() redis.zadd('time', {article: post_time}) print('即将为自己投初始票!', articleData['poster']) # 发布者给自己投一票 vote(article, articleData['poster'], True) # 计算初始评分 score(article, redis) return article

这里用了三种数据结构：incr生成自增 ID，hset存文章字段，zadd把文章按发布时间放进有序集合。投票和评分函数配合有序集合做排名。集群模式下要注意：同一个 key 必须落在同一个槽，否则跨槽操作会报CROSSSLOT错误。article和article1这种 key 如果没做 hash tag，可能被分到不同节点。实验里数据量小没暴露这个问题，但实际用集群时，相关 key 最好用{tag}形式强制同槽，比如{article1}:votes和{article1}:score。

4.3 数据验证：用客户端看结果

程序跑完后，用 Another Redis Desktop Manager 连上集群，能看到article计数器、article1到articleN的哈希、time有序集合、以及投票相关的集合。实验里还做了分组操作，把文章加入指定 group，再按评分降序输出。验证时重点看：文章哈希的字段是否完整、time有序集合的 score 是否是发布时间戳、投票后评分有没有变化。如果客户端里看不到数据，先确认连的是不是集群模式，单机模式连集群是看不到完整数据的。

5. 避坑与常见问题：那些实验报告里没写全的细节

5.1 改了配置没重启，报错照旧

现象：明明改了redis.conf里的bind或cluster-enabled，重新执行命令还是报同样的错。 原因：Redis 不会热加载配置文件，改完必须重启才生效。而且集群模式下，每个节点都有自己的配置文件，只改一个不够。 解决：改完配置后逐个重启节点，用ps -ef | grep redis确认进程是新的，必要时先kill旧进程再启动。

5.2 集群创建时节点数不够或角色分配失败

现象：--cluster create执行后提示无法分配槽，或者从节点没配上。 原因：--cluster-replicas 1要求主节点数至少为 3，总节点数至少 6。如果只启动了 5 个节点，或者某个节点没起来，创建就会失败。 解决：创建前用ps -ef | grep redis确认六个节点全部在跑，端口分别是 6379、6380、6381、6389、6390、6391，一个都不能少。

5.3 客户端连单机正常，连集群就断

现象：Another Redis Desktop Manager 连单机 6379 没问题，切到集群模式就报connection is close。 原因：集群模式下客户端需要访问所有节点，如果只配了一个节点地址，或者网络不通，拓扑发现就会失败。 解决：确认客户端能访问所有节点端口，用 SSH 隧道方式连接，集群节点列表填全。实验里验证过，SSH 加 cluster 连接能解决这个问题。

5.4 flushall 清了数据但槽还占着

现象：执行了flushall，重新创建集群还是报Slot xxx is already busy。 原因：flushall只清数据，不清集群配置。槽的分配信息存在cluster-config-file指定的文件里，以及节点的内存状态中。 解决：必须配合cluster reset一起用，两个命令都执行完再重建集群。如果还不行，停掉节点，删掉nodes-*.conf文件再重启。

5.5 Python 连集群报 CROSSSLOT

现象：用redis-py-cluster操作多个 key 时报CROSSSLOT Keys in request don't hash to the same slot。 原因：集群把 key 分散到不同槽，涉及多 key 的操作（如sinterstore、zunionstore）要求所有 key 在同一槽。 解决：给相关 key 加相同的 hash tag，比如{article1}:votes和{article1}:score，花括号里的内容相同就会落到同一槽。

6. 快速定位这类问题的排查顺序与验证习惯

Redis 实验里的报错看着五花八门，但排查路径其实可以固定下来。我后来总结了一个从底往上的顺序，基本能覆盖大部分情况。

第一步，确认进程和端口。ps -ef | grep redis看进程在不在，ss -tlnp | grep 6379看监听地址对不对。这一步能排除掉「服务没起来」和「绑错地址」两类问题，ECONNREFUSED 基本在这一步就能定位。

第二步，确认配置生效。改完redis.conf后，用redis-cli config get bind和redis-cli config get cluster-enabled直接查运行时配置，比翻文件靠谱。如果查出来还是旧值，说明没重启或者改错了文件。

第三步，集群问题先清理再重建。遇到cluster support disabled查cluster-enabled，遇到Slot already busy就flushall加cluster reset，六个节点都走一遍。清理完用cluster info确认cluster_state:ok再往下走。

第四步，客户端连接分清单机和集群。单机直连 IP 加端口，集群用集群模式加 SSH 隧道，节点列表填全。连不上时先确认客户端所在网络能访问所有节点端口。

这张表我后来直接贴在实验环境旁边，报错一出来先对号入座，省去大量搜索时间。从那以后我每次搭 Redis 集群，都强制走一遍「进程→端口→配置→清理→重建→验证」的流程，不再跳步。搭环境这种事，跳一步后面就要花三倍时间补。希望帮到你。

本文还有配套的精品资源，点击获取