清理旧 Redis Cluster停止所有原生 redis-server 进程pkill redis-server ps aux | grep redis-server # 确认无残留查找删除集群标识文件[rootserver1 ~]# find / -name nodes-*.conf 2/dev/null [rootserver1 ~]# find / -name nodes-*.conf -delete 2/dev/nullCodis 底层依赖单机模式 Redis如果残留 Redis Cluster 集群配置文件、开启cluster-enabled yes后续启动codis-server会直接冲突报错哪怕你还没编译 Codis。 提前清理能避免编译完成后部署阶段反复排错。安装 并配置Go 1.7.3Codis3.2 兼容 Go1.7~1.9优先选用 go1.7.3 linux/amd64下载安装# 下载go1.7.3 linux64安装包 wget https://dl.google.com/go/go1.7.3.linux-amd64.tar.gz # 解压到/usr/local官方标准路径 tar -zxvf go1.7.3.linux-amd64.tar.gz -C /usr/local配置环境变量GOROOT GOPATH编辑全局环境变量vi /etc/profile在文件末尾追加下面内容# Go1.8 配置 export GOROOT/usr/local/go # 自定义GOPATH工作目录可自行修改路径 export GOPATH/home/codis/gopath export PATH$PATH:$GOROOT/bin:$GOPATH/bin生效配置source /etc/profile验证安装go version # 正确输出go version go1.8.3 linux/amd64 # 查看GOPATH go env GOPATH # 输出/home/codis/gopathCodis 源码编译# 创建规范GOPATH目录 mkdir -p $GOPATH/src/github.com/CodisLabs cd $GOPATH/src/github.com/CodisLabs # 拉取源码 git clone https://github.com/CodisLabs/codis.git -b release3.2 cd codis # 安装编译依赖 yum install gcc make -y 之前实验装过 # 启动编译 make系统没有安装 git 工具无法克隆 Codis 源码安装gityum install git -y重新拉取源码编译成功后直接通过 make 进行编译会看到如下输出$ cd $GOPATH/src/github.com/CodisLabs/codis $ make make -j -C extern/redis-3.2.8/ ... ... go build -i -o bin/codis-dashboard ./cmd/dashboard go build -i -o bin/codis-proxy ./cmd/proxy go build -i -o bin/codis-admin ./cmd/admin go build -i -o bin/codis-fe ./cmd/fe[rootserver1 codis]# ls -ln bin/[rootserver1 codis]# cat bin/version全部二进制文件编译成功所有核心程序codis-dashboard/codis-proxy/codis-fe/codis-server全部生成并且具备执行权限。构建codis集群启动codis-dashboard使用 脚本启动 dashboard并查看 dashboard 日志确认启动是否有异常。codis-dashboard-admin.sh[rootserver1 codis]# ./admin/codis-dashboard-admin.sh start[rootserver1 codis]# tail -100 ./log/codis-dashboard.log.2026-08-03 (这里的日期填自己的日期)dashboard启动成功dashboard 监听 18080 端口集群元数据文件系统 /tmp/codis 正常创建。启动codis-proxy使用 脚本启动 codis-proxy并查看 proxy 日志确认启动是否有异常。codis-proxy-admin.sh[rootserver1 codis]# ./admin/codis-proxy-admin.sh start[rootserver1 codis]# tail -100 ./log/codis-proxy.log.2026-08-04这里03变04是因为我凌晨做的实验所以日志时间发生了改变从8月3号变成了8月4号以自己的日期为准日志内容解读大量fill slot xxx, backend.addr , locked falseCodis 一共有 1024 个槽位slot 0~1023当前还没有给 proxy 分配后端 codis-server所以槽位暂无关联节点属于正常现象。后续在 Web 面板添加 Redis 分片后槽位会自动分配。set sentinels []实验单机模式没有启用哨兵为空数组无需处理。启动codis-server使用 脚本启动 codis-server并查看 redis 日志确认启动是否有异常。codis-server-admin.sh[rootserver1 codis]# ./admin/codis-server-admin.sh start[rootserver1 codis]# tail -100 /tmp/redis_6379.logredis.conf 配置中 pidfile、logfile 默认保存在 目录若启动失败请检查当前用户是否有该目录的读写权限。/tmp底层 Redis 服务正常监听 6379 端口作为 Codis 分片节点就绪。启动codis-fe使用 脚本启动 codis-fe并查看 fe 日志确认启动是否有异常。codis-fe-admin.sh[rootserver1 codis]# ./admin/codis-fe-admin.sh start[rootserver1 codis]# tail -100 ./log/codis-fe.log.2026-08-04代表 Web 管理服务监听 9090 端口允许任意地址访问。当前 Codis 全部组件运行状态汇总grep -E 正则推荐ss -lnp | grep -E codis-proxy|codis-dashboard|codis-fe|codis-server组件端口作用状态codis-dashboard18080集群元数据管理✅运行codis-fe9090Web 可视化管理页面✅运行codis-proxy19000Redis 客户端接入代理✅运行codis-server6379底层 Redis 分片节点✅运行Codis-fe Web 页面浏览器打开http://192.168.239.132:9090选中集群名称示例codis-demoProxy 栏可看到我们已经启动的 Proxy新建 Group槽位分组Codis 所有 slot 槽位会分配到各个 Group一个 Group 对应一组主从 Redis (codis-server)在New Group右侧输入框填写组编号示例输入1点击绿色New Group按钮创建编号为 1 的分组向分组添加 codis-server 节点在Add Server行填入 codis-server 地址127.0.0.1:6379末尾to输入框填写目标 Group 编号1点击橙色Add Server将 Redis 节点加入 Group1节点同步生效添加完成后页面表格出现节点点击SYNC按钮同步集群配置到 codis-dashboard。通过初始化slot新增的集群 slot 状态是 offline因此我们需要对它进行初始化将 1024 个 slot 分配到各个 group而初始化最快的方法可通过 fe 提供的 按钮来做如下图所示点击此按钮我们即快速完成了一个集群的搭建。
清理旧 Redis Cluster停止所有原生 redis-server 进程pkill redis-server ps aux | grep redis-server # 确认无残留查找删除集群标识文件[rootserver1 ~]# find / -name nodes-*.conf 2/dev/null [rootserver1 ~]# find / -name nodes-*.conf -delete 2/dev/nullCodis 底层依赖单机模式 Redis如果残留 Redis Cluster 集群配置文件、开启cluster-enabled yes后续启动codis-server会直接冲突报错哪怕你还没编译 Codis。 提前清理能避免编译完成后部署阶段反复排错。安装 并配置Go 1.7.3Codis3.2 兼容 Go1.7~1.9优先选用 go1.7.3 linux/amd64下载安装# 下载go1.7.3 linux64安装包 wget https://dl.google.com/go/go1.7.3.linux-amd64.tar.gz # 解压到/usr/local官方标准路径 tar -zxvf go1.7.3.linux-amd64.tar.gz -C /usr/local配置环境变量GOROOT GOPATH编辑全局环境变量vi /etc/profile在文件末尾追加下面内容# Go1.8 配置 export GOROOT/usr/local/go # 自定义GOPATH工作目录可自行修改路径 export GOPATH/home/codis/gopath export PATH$PATH:$GOROOT/bin:$GOPATH/bin生效配置source /etc/profile验证安装go version # 正确输出go version go1.8.3 linux/amd64 # 查看GOPATH go env GOPATH # 输出/home/codis/gopathCodis 源码编译# 创建规范GOPATH目录 mkdir -p $GOPATH/src/github.com/CodisLabs cd $GOPATH/src/github.com/CodisLabs # 拉取源码 git clone https://github.com/CodisLabs/codis.git -b release3.2 cd codis # 安装编译依赖 yum install gcc make -y 之前实验装过 # 启动编译 make系统没有安装 git 工具无法克隆 Codis 源码安装gityum install git -y重新拉取源码编译成功后直接通过 make 进行编译会看到如下输出$ cd $GOPATH/src/github.com/CodisLabs/codis $ make make -j -C extern/redis-3.2.8/ ... ... go build -i -o bin/codis-dashboard ./cmd/dashboard go build -i -o bin/codis-proxy ./cmd/proxy go build -i -o bin/codis-admin ./cmd/admin go build -i -o bin/codis-fe ./cmd/fe[rootserver1 codis]# ls -ln bin/[rootserver1 codis]# cat bin/version全部二进制文件编译成功所有核心程序codis-dashboard/codis-proxy/codis-fe/codis-server全部生成并且具备执行权限。构建codis集群启动codis-dashboard使用 脚本启动 dashboard并查看 dashboard 日志确认启动是否有异常。codis-dashboard-admin.sh[rootserver1 codis]# ./admin/codis-dashboard-admin.sh start[rootserver1 codis]# tail -100 ./log/codis-dashboard.log.2026-08-03 (这里的日期填自己的日期)dashboard启动成功dashboard 监听 18080 端口集群元数据文件系统 /tmp/codis 正常创建。启动codis-proxy使用 脚本启动 codis-proxy并查看 proxy 日志确认启动是否有异常。codis-proxy-admin.sh[rootserver1 codis]# ./admin/codis-proxy-admin.sh start[rootserver1 codis]# tail -100 ./log/codis-proxy.log.2026-08-04这里03变04是因为我凌晨做的实验所以日志时间发生了改变从8月3号变成了8月4号以自己的日期为准日志内容解读大量fill slot xxx, backend.addr , locked falseCodis 一共有 1024 个槽位slot 0~1023当前还没有给 proxy 分配后端 codis-server所以槽位暂无关联节点属于正常现象。后续在 Web 面板添加 Redis 分片后槽位会自动分配。set sentinels []实验单机模式没有启用哨兵为空数组无需处理。启动codis-server使用 脚本启动 codis-server并查看 redis 日志确认启动是否有异常。codis-server-admin.sh[rootserver1 codis]# ./admin/codis-server-admin.sh start[rootserver1 codis]# tail -100 /tmp/redis_6379.logredis.conf 配置中 pidfile、logfile 默认保存在 目录若启动失败请检查当前用户是否有该目录的读写权限。/tmp底层 Redis 服务正常监听 6379 端口作为 Codis 分片节点就绪。启动codis-fe使用 脚本启动 codis-fe并查看 fe 日志确认启动是否有异常。codis-fe-admin.sh[rootserver1 codis]# ./admin/codis-fe-admin.sh start[rootserver1 codis]# tail -100 ./log/codis-fe.log.2026-08-04代表 Web 管理服务监听 9090 端口允许任意地址访问。当前 Codis 全部组件运行状态汇总grep -E 正则推荐ss -lnp | grep -E codis-proxy|codis-dashboard|codis-fe|codis-server组件端口作用状态codis-dashboard18080集群元数据管理✅运行codis-fe9090Web 可视化管理页面✅运行codis-proxy19000Redis 客户端接入代理✅运行codis-server6379底层 Redis 分片节点✅运行Codis-fe Web 页面浏览器打开http://192.168.239.132:9090选中集群名称示例codis-demoProxy 栏可看到我们已经启动的 Proxy新建 Group槽位分组Codis 所有 slot 槽位会分配到各个 Group一个 Group 对应一组主从 Redis (codis-server)在New Group右侧输入框填写组编号示例输入1点击绿色New Group按钮创建编号为 1 的分组向分组添加 codis-server 节点在Add Server行填入 codis-server 地址127.0.0.1:6379末尾to输入框填写目标 Group 编号1点击橙色Add Server将 Redis 节点加入 Group1节点同步生效添加完成后页面表格出现节点点击SYNC按钮同步集群配置到 codis-dashboard。通过初始化slot新增的集群 slot 状态是 offline因此我们需要对它进行初始化将 1024 个 slot 分配到各个 group而初始化最快的方法可通过 fe 提供的 按钮来做如下图所示点击此按钮我们即快速完成了一个集群的搭建。
