softonic/twemproxy

twemproxy（nut***er）镜像说明

镜像概述

twemproxy（别名nuter）是开发的快速轻量级代理工具，支持memcached和redis协议。它通过减少后端缓存服务器的连接数量，结合请求流水线与数据分片能力，帮助用户实现分布式缓存架构的水平扩展，提升系统吞吐量与稳定性。

核心功能

• 快速轻量，资源占用低，适合高并发场景
• 维护与后端服务器的持久连接，降低连接建立开销
• 限制后端缓存服务器的连接数，避免资源耗尽
• 支持请求和响应的流水线处理，减少网络往返延迟
• 同时管理多个服务器池，支持多缓存实例代理
• 自动在多服务器间分片数据，实现负载均衡
• 兼容完整的memcached ASCII和redis协议
• 通过YAML文件灵活配置服务器池参数
• 支持多种哈希模式（如一致性哈希ketama、modula等）
• 可配置故障节点自动剔除与重试机制
• 通过监控端口暴露统计信息，便于观测系统状态
• 跨平台支持Linux、BSD、OS X等操作系统

使用场景

• 分布式memcached/redis集群，需要降低后端服务器连接压力
• 缓存服务需水平扩展，提升整体吞吐量
• 统一管理多个缓存实例，简化客户端连接配置
• 需要通过流水线处理优化缓存请求延迟
• 希望实现缓存节点故障自动容错的场景

配置说明

twemproxy通过YAML配置文件管理服务器池，关键参数如下：

• listen：监听地址端口（如127.0.0.1:22121）或Unix套接字路径
• hash：哈希函数（可选fnv1a_64、md5、crc32等）
• distribution：键分布模式（可选ketama、modula、random）
• auto_eject_hosts：是否自动剔除连续故障的节点（默认false）
• servers：后端服务器列表（格式ip:port:weight）

示例配置（nut***er.yml）：

yaml
alpha:
  listen: 127.0.0.1:22121
  hash: fnv1a_64
  distribution: ketama
  auto_eject_hosts: true
  redis: true
  server_retry_timeout: 2000
  server_failure_limit: 1
  servers:
   - 127.0.0.1:6379:1

Docker部署示例

1. 准备配置文件nutcracker.yml（参考上述示例）
2. 运行容器：

bash
docker run -d \
  -p 22121:22121 \
  -v $(pwd)/nutcracker.yml:/etc/nutcracker.yml \
  softonic/twemproxy \
  nutcracker -c /etc/nutcracker.yml

3. 验证服务：通过客户端连接127.0.0.1:22121访问代理的redis/memcached服务

观测与维护

• 监控端口默认22222，可通过curl http://localhost:22222获取统计信息
• 通过-v参数调整日志级别，-o指定日志文件
• 发送SIGHUP信号可重新加载配置文件，SIGTTIN/SIGTTOU调整日志级别