Skip to content

Latest commit

 

History

History
170 lines (116 loc) · 5.19 KB

KVROCKS.md

File metadata and controls

170 lines (116 loc) · 5.19 KB

Kvrocks 存储方案

🌟 什么是 Kvrocks？

Kvrocks 是一个分布式键值数据库，兼容 Redis 协议，基于 RocksDB 存储引擎。它提供了比 Redis 更高的数据可靠性和更好的成本效益。

🆚 与 Redis 对比

特性 Redis Kvrocks
数据持久性 内存 + AOF/RDB 备份 磁盘原生存储
数据丢失 可能丢失最后几秒数据 几乎零数据丢失风险
内存使用 全部数据在内存 仅缓存热数据
存储成本 受内存限制，成本较高 磁盘存储，成本低
扩展性 受内存限制 可处理更大数据集
协议兼容 Redis 协议 完全兼容 Redis 协议
性能 极高（纯内存） 高性能（接近 Redis）

🎯 适用场景

✅ 推荐使用 Kvrocks

  • 🏢 生产环境：需要高可靠性的生产部署
  • 💾 数据重要：用户播放记录、收藏等重要数据不能丢失
  • 💰 成本敏感：希望降低内存成本，使用便宜的磁盘存储
  • 📈 长期使用：计划长期运行，数据量可能持续增长

❌ 不建议使用 Kvrocks

  • 🏃 极速性能：需要微秒级响应时间的高频交易场景
  • 🔥 纯缓存：数据可以随时丢失的纯缓存场景
  • 📱 轻量部署：资源非常有限的设备（如低配置树莓派）

🚀 部署优势

1. 数据安全

  • 零配置持久化：无需配置 AOF 或 RDB，数据自动持久化到磁盘
  • 断电保护：即使突然断电，已提交的数据也不会丢失
  • 原子操作：基于 RocksDB 的事务保证数据一致性

2. 资源优化

  • 内存友好：只需要 Redis 1/10 的内存
  • 磁盘高效：智能压缩，节省存储空间
  • CPU 友好：后台压缩和合并，不影响前台性能

3. 运维简单

  • 免维护：无需定期备份，数据自动持久化

🔧 快速部署

无密码部署（开发环境）

# 1. 设置环境变量
cp .env.kvrocks.example .env
# 编辑 .env，不设置 KVROCKS_PASSWORD

# 2. 启动服务
docker-compose -f docker-compose.kvrocks.yml up -d

密码认证部署（生产环境）

# 1. 设置环境变量
cp .env.kvrocks.example .env
# 编辑 .env，设置 KVROCKS_PASSWORD=your_secure_password

# 2. 启动服务
docker-compose -f docker-compose.kvrocks.auth.yml up -d

📖 详细部署指南：请参考 KVROCKS_DEPLOYMENT.md

  • 监控简单：提供标准 Redis 监控接口
  • 迁移容易：完全兼容 Redis 客户端和工具

⚡ 性能表现

在 KatelyaTV 的实际使用场景中：

  • 读取性能：接近 Redis，毫秒级响应
  • 写入性能：略低于 Redis，但仍然很快
  • 内存使用：仅为 Redis 的 10-20%
  • 磁盘空间：数据压缩后占用更少空间

🔧 配置建议

硬件要求

  • CPU：2 核心即可满足大部分需求
  • 内存：512MB - 1GB 即可（Redis 需要 4-8GB）
  • 磁盘：建议使用 SSD，至少 10GB 空间
  • 网络：标准网络即可

系统配置

# 推荐的系统参数
echo 'vm.swappiness = 1' >> /etc/sysctl.conf
echo 'vm.overcommit_memory = 1' >> /etc/sysctl.conf
sysctl -p

📊 实际案例

用户反馈

"使用 Kvrocks 后，再也不用担心重启服务器丢失观看记录了！" - 某用户

"内存占用降低了 80%，服务器成本大幅下降。" - 某管理员

数据对比

  • Redis 方案：8GB 内存，每月 $40
  • Kvrocks 方案：1GB 内存 + 20GB SSD，每月 $15
  • 成本节省：约 60% 的基础设施成本

🛠️ 迁移指南

从 Redis 迁移到 Kvrocks

  1. 停止应用：docker compose down
  2. 备份数据：docker compose exec redis redis-cli BGSAVE
  3. 导出数据：docker compose exec redis redis-cli --rdb /data/dump.rdb
  4. 启动 Kvrocks：docker compose -f docker-compose.kvrocks.yml up -d
  5. 导入数据：使用 Redis 工具导入备份数据
  6. 验证数据：检查数据完整性
  7. 切换应用：修改环境变量，重启应用

回滚方案

如果需要回滚到 Redis：

  1. 从 Kvrocks 导出数据
  2. 启动 Redis 服务
  3. 导入数据到 Redis
  4. 修改环境变量
  5. 重启应用

💡 最佳实践

1. 监控建议

# 监控 Kvrocks 状态
docker compose exec kvrocks redis-cli info stats
docker compose exec kvrocks redis-cli info memory
docker compose exec kvrocks redis-cli info persistence

2. 备份策略

# 每日自动备份
0 2 * * * docker run --rm -v kvrocks_data:/data -v /backup:/backup alpine tar czf /backup/kvrocks-$(date +%Y%m%d).tar.gz /data

3. 性能调优

  • 定期检查磁盘使用率
  • 监控压缩率和延迟
  • 根据负载调整缓存策略

总结：Kvrocks 是 Redis 的完美替代方案，特别适合 KatelyaTV 这种需要高可靠性数据存储的应用场景。它在保持 Redis 兼容性的同时，提供了更好的数据安全性和更低的运营成本。