ติดตั้ง Redis Cluster บน VPS แบบ Horizontal Sharding

ติดตั้ง Redis Cluster บน VPS (Horizontal Sharding)

พฤศจิกายน 2026 · อ่าน 10 นาที

Redis Cluster คือโหมดที่ Redis แจกจ่ายข้อมูลข้าม node หลายตัวโดยอัตโนมัติ ต่างจาก Redis Sentinel ที่ทำ HA สำหรับ node เดียว Cluster ทำ horizontal sharding แบ่งข้อมูลเป็น 16,384 hash slot กระจายไปยัง master node แต่ละตัว ทำให้รองรับข้อมูลขนาดใหญ่ที่ RAM ของ server เดียวรองรับไม่ไหว

โครงสร้างขั้นต่ำของ Redis Cluster คือ 3 master + 3 replica (6 node) เพื่อให้ทำ failover ได้หาก master ตัวใดตัวหนึ่งล่ม replica จะรับหน้าที่แทนอัตโนมัติ บทความนี้สอนตั้ง 6-node cluster ทั้งหมดบน VPS เครื่องเดียวโดยใช้ port ต่างกัน ซึ่งเหมาะสำหรับทดสอบหรือ development และอธิบายแนวทางขยายเป็น multi-server ด้วย

ก่อนเริ่ม ตรวจสอบว่า VPS มี RAM อย่างน้อย 2 GB (สำหรับ 6 node ทดสอบ), Redis เวอร์ชัน 5+ ติดตั้งแล้ว และ firewall อนุญาต port 7000–7005 กับ 17000–17005 (cluster bus port)

ติดตั้ง Redis

# Ubuntu/Debian
sudo apt update && sudo apt install -y redis-server

# ตรวจเวอร์ชัน (ต้องการ >= 5.0)
redis-server --version

# ปิด default service ก่อน — Cluster ใช้ config ของตัวเอง
sudo systemctl disable --now redis-server

สร้างโฟลเดอร์และ Config 6 Node

for port in 7000 7001 7002 7003 7004 7005; do
  sudo mkdir -p /etc/redis/cluster/${port}
  sudo tee /etc/redis/cluster/${port}/redis.conf > /dev/null <<EOF
port ${port}
bind 127.0.0.1
daemonize yes
logfile /var/log/redis/cluster-${port}.log
dir /var/lib/redis/cluster/${port}
cluster-enabled yes
cluster-config-file /etc/redis/cluster/${port}/nodes.conf
cluster-node-timeout 5000
appendonly yes
appendfilename "appendonly.aof"
EOF
  sudo mkdir -p /var/lib/redis/cluster/${port}
  sudo chown -R redis:redis /var/lib/redis/cluster/
done

sudo mkdir -p /var/log/redis
sudo chown redis:redis /var/log/redis

เริ่มต้น Redis Node ทั้ง 6 ตัว

for port in 7000 7001 7002 7003 7004 7005; do
  redis-server /etc/redis/cluster/${port}/redis.conf
  echo "Started Redis on port ${port}"
done

# ตรวจว่าทุก process ทำงาน
ps aux | grep redis-server | grep -v grep

สร้าง Cluster ด้วย redis-cli

# --cluster-replicas 1 หมายถึง replica 1 ตัวต่อ master 1 ตัว
# 3 master + 3 replica = 6 node
redis-cli --cluster create \
  127.0.0.1:7000 127.0.0.1:7001 127.0.0.1:7002 \
  127.0.0.1:7003 127.0.0.1:7004 127.0.0.1:7005 \
  --cluster-replicas 1 --cluster-yes
Multi-server: สำหรับ production แทนที่ 127.0.0.1 ด้วย IP จริงของแต่ละ server เช่น 192.168.1.10:7000 192.168.1.11:7000 192.168.1.12:7000 ... และต้องเปิด port 7000 + 17000 ระหว่าง server ใน firewall

เปิด Firewall สำหรับ Cluster Port

# UFW (ถ้าใช้ multi-server ให้ระบุ IP แทน any)
for port in 7000 7001 7002 7003 7004 7005; do
  sudo ufw allow ${port}/tcp
  sudo ufw allow $((port + 10000))/tcp   # cluster bus
done
sudo ufw reload

ทดสอบเขียน-อ่านข้ามหลาย Node

# เชื่อมต่อพร้อม -c (cluster mode)
redis-cli -c -p 7000

# ทดสอบเขียน — Redis จะ redirect ไปยัง slot ที่ถูกต้องอัตโนมัติ
SET user:1 "alice"
SET user:2 "bob"
SET session:abc "data"
GET user:1
GET session:abc

ตรวจสอบว่า Redis Cluster ทำงานถูกต้อง

# 1. ดูสถานะ cluster โดยรวม
redis-cli -p 7000 cluster info

# 2. ดู node ทั้งหมดพร้อมบทบาท
redis-cli -p 7000 cluster nodes

# 3. ตรวจว่า hash slot กระจายแล้ว
redis-cli --cluster check 127.0.0.1:7000

# 4. นับ key ทั้งหมดในทุก node
for port in 7000 7001 7002 7003 7004 7005; do
  echo -n "Port ${port}: "
  redis-cli -p ${port} dbsize
done

# 5. ทดสอบ failover จำลอง (debug)
redis-cli -p 7000 debug sleep 30 &
sleep 2
redis-cli -p 7000 cluster info | grep cluster_state
เคล็ดลับ: ผลลัพธ์ cluster_state:ok และ cluster_slots_assigned:16384 หมายความว่า Cluster พร้อมใช้งาน ถ้า slots assigned น้อยกว่า 16,384 มีบาง node ที่ยังไม่ได้รับ slot

แก้ปัญหาที่พบบ่อย

ERR This instance has cluster support disabled

Redis เริ่มต้นด้วย config ปกติที่ไม่ได้เปิด cluster mode ทำให้คำสั่ง cluster ใช้ไม่ได้

# ตรวจว่า config มี cluster-enabled yes
grep "cluster-enabled" /etc/redis/cluster/7000/redis.conf

# ถ้าไม่มี ให้เพิ่มแล้ว restart
echo "cluster-enabled yes" | sudo tee -a /etc/redis/cluster/7000/redis.conf
redis-cli -p 7000 shutdown nosave
redis-server /etc/redis/cluster/7000/redis.conf

CLUSTERDOWN Hash slot not served

เกิดเมื่อ master node ล่มและ replica ยังไม่ได้รับการ promote หรือ slot บางส่วนไม่มี master

# ตรวจ node ที่ fail
redis-cli -p 7000 cluster nodes | grep fail

# บังคับ failover จาก replica ที่ต้องการ promote
redis-cli -p 7003 cluster failover force

# หรือ fix slot ที่กำพร้า (ไม่มี master)
redis-cli --cluster fix 127.0.0.1:7000

MOVED error เมื่อใช้ client ไม่รองรับ cluster

Client ที่ไม่รู้จัก cluster protocol จะได้รับ MOVED redirect และ error ถ้าไม่ follow

# ใช้ redis-cli พร้อม -c เพื่อ follow redirect อัตโนมัติ
redis-cli -c -p 7000 SET mykey "value"

# สำหรับ Python ต้องใช้ redis-py-cluster หรือ redis[hiredis]
pip install "redis[hiredis]"
# แล้วใช้ RedisCluster แทน Redis ใน code
# from redis.cluster import RedisCluster

Node ไม่สามารถ join cluster ได้ — NOAUTH หรือ connection refused

มักเกิดจาก firewall บล็อก cluster bus port (port + 10000) หรือ bind address ไม่ตรงกัน

# ตรวจ port เปิด
ss -tlnp | grep redis

# ตรวจว่า cluster bus port ไม่ถูก block
telnet 127.0.0.1 17000

# ตรวจ cluster bus ใน config
grep "cluster-announce" /etc/redis/cluster/7000/redis.conf
# ถ้าใช้ multi-server ต้องเพิ่ม:
# cluster-announce-ip 1.2.3.4
# cluster-announce-port 7000
# cluster-announce-bus-port 17000

Too many keys in one slot — hotspot problem

ถ้า key ทั้งหมดมี pattern เดียวกัน Redis จะ hash ไปที่ slot เดียว ทำให้ load ไม่กระจาย

# ดู slot ที่มี key มากที่สุด
redis-cli -p 7000 --cluster rebalance 127.0.0.1:7000

# ใช้ hash tag เพื่อควบคุม slot: {user}:1 กับ {user}:2 ไปที่ slot เดียวกัน
# ถ้าต้องการกระจาย ให้ใช้ key โดยไม่มี {} เพื่อให้แต่ละ key กระจายต่างกัน
redis-cli -c -p 7000 SET "user:1:name" "alice"
redis-cli -c -p 7000 SET "user:2:name" "bob"

คำถามที่พบบ่อย

Redis Cluster ต่างจาก Redis Sentinel อย่างไร?

Sentinel ทำ High Availability สำหรับ node เดียว — monitor, failover และ notify เมื่อ master ล่ม แต่ข้อมูลทั้งหมดยังอยู่ใน node เดียว Cluster ทำ horizontal sharding แจกข้อมูลข้ามหลาย master node พร้อมมี HA ในตัวอยู่แล้ว ใช้ Sentinel เมื่อต้องการ HA ราคาถูก ใช้ Cluster เมื่อข้อมูลใหญ่กว่า RAM เครื่องเดียว

ต้องการ node ขั้นต่ำกี่ตัว?

ขั้นต่ำ 3 master (ไม่มี replica) แต่การ production ควรใช้ 3 master + 3 replica (6 node) เพื่อให้ทำ failover ได้ ถ้า master ล่มและไม่มี replica cluster จะไม่สามารถให้บริการ slot นั้นได้จนกว่าจะแก้มือ

Client ภาษาอื่นรองรับ Redis Cluster ได้ไหม?

ใช่ — client หลักๆ รองรับ cluster protocol แล้ว: Python ใช้ redis-py (v4+) กับ RedisCluster, Node.js ใช้ ioredis, Go ใช้ go-redis, Java ใช้ Lettuce หรือ Jedis ตรวจสอบว่า client มี cluster mode ก่อนใช้งาน เพราะบาง client ต้องการ package เสริม