快捷導(dǎo)航

docker-compose安裝redis集群教程

更新時間：2025年08月19日 10:59:33 作者：下一個明天_tgm

本文介紹了使用Docker Compose部署Redis集群的步驟：編寫配置文件設(shè)置端口和密碼,創(chuàng)建數(shù)據(jù)卷目錄,啟動容器并檢查狀態(tài),若集群創(chuàng)建失敗,需手動進入容器執(zhí)行redis-cli命令,處理密碼認(rèn)證及數(shù)據(jù)清空問題以完成集群配置

docker-compose安裝redis集群

1、安裝docker-compose命令

此處略過

2、編寫docker-compose.yml文件

version: '2.2'

services:
  redis-node1:
    image: redis:5.0
    ## --cluster-announce-ip 你的公網(wǎng)IP 這部分參數(shù) 

    command: redis-server --port 7000 --requirepass lingco --cluster-enabled yes --cluster-config-file /data/nodes.conf --appendonly yes --bind 0.0.0.0  --cluster-announce-ip 192.168.1.10
    ports:
      - "7000:7000"
      - "17000:17000"
    volumes:
      - ./data/node1:/data
    networks:
      - redis-cluster

  redis-node2:
    image: redis:5.0
    command: redis-server --port 7001 --requirepass lingco --cluster-enabled yes --cluster-config-file /data/nodes.conf --appendonly yes --bind 0.0.0.0 --cluster-announce-ip 192.168.1.10
    ports:
      - "7001:7001"
      - "17001:17001"
    volumes:
      - ./data/node2:/data
    networks:
      - redis-cluster

  redis-node3:
    image: redis:5.0
    command: redis-server --port 7002 --requirepass lingco --cluster-enabled yes --cluster-config-file /data/nodes.conf --appendonly yes --bind 0.0.0.0 --cluster-announce-ip 192.168.1.10
    ports:
      - "7002:7002"
      - "17002:17002"
    volumes:
      - ./data/node3:/data
    networks:
      - redis-cluster

  redis-node4:
    image: redis:5.0
    command: redis-server --port 7003 --requirepass lingco --cluster-enabled yes --cluster-config-file /data/nodes.conf --appendonly yes --bind 0.0.0.0 --cluster-announce-ip 192.168.1.10
    ports:
      - "7003:7003"
      - "17003:17003"
    volumes:
      - ./data/node4:/data
    networks:
      - redis-cluster

  redis-node5:
    image: redis:5.0
    command: redis-server --port 7004 --requirepass lingco --cluster-enabled yes --cluster-config-file /data/nodes.conf --appendonly yes --bind 0.0.0.0 --cluster-announce-ip 192.168.1.10
    ports:
      - "7004:7004"
      - "17004:17004"
    volumes:
      - ./data/node5:/data
    networks:
      - redis-cluster

  redis-node6:
    image: redis:5.0
    command: redis-server --port 7005 --requirepass lingco --cluster-enabled yes --cluster-config-file /data/nodes.conf --appendonly yes --bind 0.0.0.0 --cluster-announce-ip 192.168.1.10
    ports:
      - "7005:7005"
      - "17005:17005"
    volumes:
      - ./data/node6:/data
    networks:
      - redis-cluster
  redis-init:
    image: redis:5.0
    command: >
      sh -c "redis-server --port 7000 --cluster-enabled yes --cluster-config-file /data/nodes.conf --appendonly yes --bind $$(hostname -i)
      && sleep 5
      && redis-cli --cluster create redis-node1:7000 redis-node2:7001 redis-node3:7002 redis-node4:7003 redis-node5:7004 redis-node6:7005 --cluster-replicas 1"
    depends_on:
      - redis-node1
    networks:
      - redis-cluster
      
  redis-node7:
    image: redis:5.0
    command: redis-server --port 7006 --appendonly yes --bind 0.0.0.0 --cluster-announce-ip 192.168.1.10 --cluster-announce-port 7006 --cluster-announce-bus-port 17006
    ports:
      - "7006:7006"
      - "17006:17006"
    volumes:
      - ./data/node7:/data

networks:
  redis-cluster:

備注：端口7000-7005為集群，密碼統(tǒng)一為 lingco，7006為單節(jié)點無密碼；在同路徑下創(chuàng)建 volumes配置的文件夾。

3、執(zhí)行docker compose命令

在docker-compose.yml目錄中執(zhí)行命令 docker-compose up -d，如果需要在其它目錄執(zhí)行，則需要指定配置文件yml的路徑。

4、查看執(zhí)行結(jié)果

5、創(chuàng)建集群

如果docker-compose.yml中command未執(zhí)行成功或是集群未創(chuàng)建，則需要手動執(zhí)行，如下：

步驟1、通過命令找到redis集群中的一臺，執(zhí)行：docker ps -a 命令，找到docker容器id
步驟2、執(zhí)行bash命令：docker exec -it 2b93cf1f4c4f bash，進入控制臺
步驟3、執(zhí)行創(chuàng)建集群：

redis-cli --cluster create 192.168.1.10:7000 192.168.1.10:7001 192.168.1.10:7002 192.168.1.10:7003 192.168.1.10:7004 192.168.1.10:7005 --cluster-replicas 1 -a lingco

備注：如果集群設(shè)置有密碼，則需要 -a 密碼(lingco)，需要確認(rèn) 輸入 yes

集群創(chuàng)建成功，可以通過redis管理工具連接

6、問題排查

采用docker compose安裝redis集群，端口正常啟動，無法連接

測試連接可以使用，使用庫號無法連接，出現(xiàn)如上問題可能是集群未創(chuàng)建成功，需要手動執(zhí)行創(chuàng)建集群

通過上面 5 中的步驟1，步驟2，步驟3，來執(zhí)行。

如果執(zhí)行 “步驟3” 時出現(xiàn)提示：

“[ERR] Node xxx is not empty. Either the node already knows other nodes (check with CLUSTER NODES) or contains some key in database 0.”

則需要清空集群中所有節(jié)點的數(shù)據(jù) data，重新執(zhí)行命令進行集群創(chuàng)建。

如果執(zhí)行 “步驟3” 時出現(xiàn)提示：

“[ERR] Node 192.168.1.10:7001 NOAUTH Authentication required.”

則需要在命令中增加 -a參數(shù)來指定密碼，

如：

redis-cli --cluster create 192.168.1.10:7000 192.168.1.10:7001 192.168.1.10:7002 192.168.1.10:7003 192.168.1.10:7004 192.168.1.10:7005 --cluster-replicas 1 -a lingco