twemproxy 是 Twitter 开源的一个轻量级缓存代理层，内部命令行程序名为 nutcracker。部署与分片配置参见 _docs/nutcracker/tutorial.md，本文聚焦部署后的验证与常见检查手段。

1 检查配置文件语法

# -t 表示仅测试配置语法 nutcracker -t -c /etc/nutcracker/nutcracker.yml # 不指定 -c 时，nutcracker 会去默认路径 /etc/nutcracker 下找配置

2 检查程序监听的端口

netstat -nltp | grep nutcracker # tcp 0 0 127.0.0.1:2411 0.0.0.0:* LISTEN 103/nutcracker # tcp 0 0 0.0.0.0:22222 0.0.0.0:* LISTEN 103/nutcracker

通常会有两个监听：

• 业务监听地址（如 127.0.0.1:2411）：客户端连接使用。
• 监控端口（默认 22222）：输出 stats 信息。

3 用 redis-cli 连接代理

twemproxy 对客户端透明，可以直接像连接一台普通 Redis 一样连接代理：

redis-cli -p 2411 set key1 value1 redis-cli -p 2411 get key1 OK "value1"

4 日常检查建议

1. 每次修改配置后用 nutcracker -t 校验再 restart，避免配置错误导致全局不可用。
2. 分布走一致性哈希（ketama）时，key 会落在固定的后端节点上，可通过监控端口看到各后端连接数。
3. 若 auto_eject_hosts 开启，后端连续失败会被临时剔除，观察监控端口 stats 可确认节点摘除/恢复。