pozetroninc/keydb

KeyDB 镜像文档

镜像概述

本镜像提供原始未修改的KeyDB数据库服务，其标签版本格式严格遵循KeyDB官方GitHub仓库（https://github.com/EQ-Alpha/KeyDB%EF%BC%89%E4%BD%BF%E7%94%A8%E7%9A%84%E7%89%88%E6%9C%AC%E5%91%BD%E5%90%8D%E8%A7%84%E8%8C%83%E3%80%82KeyDB%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8ERedis%E7%9A%84%E9%AB%98%E6%80%A7%E8%83%BD%E9%94%AE%E5%80%BC%E6%95%B0%E6%8D%AE%E5%BA%93%EF%BC%8C%E5%85%BC%E5%AE%B9Redis%E5%8D%8F%E8%AE%AE%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%BA%BF%E7%A8%8B%E5%A4%84%E7%90%86%EF%BC%8C%E5%8F%AF%E4%BD%9C%E4%B8%BARedis%E7%9A%84%E6%9B%BF%E4%BB%A3%E5%93%81%E4%BB%A5%E6%8F%90%E5%8D%87%E5%90%9E%E5%90%90%E9%87%8F%E5%92%8C%E6%80%A7%E8%83%BD%E3%80%82

核心功能与特性

• 原始版本保证：镜像内容为官方KeyDB的原始构建，未进行额外修改，确保功能与官方版本完全一致
• 版本标签同步：镜像标签格式与KeyDB GitHub仓库的版本标签保持一致（如v6.3.4、v6.2.1等），便于版本追踪和管理
• Redis协议兼容：完全兼容Redis客户端协议，可无缝替换现有Redis部署，无需修改应用代码
• 高性能架构：支持多线程处理模型，相比单线程的Redis具有更高的并发处理能力和吞吐量
• 完整功能集：包含KeyDB官方所有核心功能，如数据持久化（RDB/AOF）、集群支持、发布/订阅、Lua脚本等

使用场景

• 开发环境：作为Redis兼容数据库用于应用开发和测试，确保与生产环境一致性
• 生产环境：需要高性能键值存储的服务，如缓存系统、会话存储、实时数据分析等
• Redis迁移：计划从Redis迁移至KeyDB的场景，可先通过此镜像进行兼容性验证
• 版本控制：需要严格遵循KeyDB官方版本迭代的部署场景

使用方法与配置说明

基本运行

使用以下命令启动KeyDB容器，默认配置下将监听6379端口：

bash
docker run -d --name keydb -p 6379:6379 eqalpha/keydb:latest

指定版本

根据KeyDB GitHub仓库的版本标签选择特定版本，例如使用v6.3.4版本：

bash
docker run -d --name keydb -p 6379:6379 eqalpha/keydb:v6.3.4

数据持久化

通过挂载卷实现数据持久化，将容器内的/data目录映射到宿主机目录：

bash
docker run -d --name keydb \
  -p 6379:6379 \
  -v /path/on/host:/data \
  eqalpha/keydb:latest

自定义配置

通过挂载自定义配置文件覆盖默认配置：

bash
docker run -d --name keydb \
  -p 6379:6379 \
  -v /path/on/host/keydb.conf:/etc/keydb/keydb.conf \
  eqalpha/keydb:latest keydb-server /etc/keydb/keydb.conf

Docker Compose 示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  keydb:
    image: eqalpha/keydb:latest
    container_name: keydb
    ports:
      - "6379:6379"
    volumes:
      - keydb_data:/data
      - ./keydb.conf:/etc/keydb/keydb.conf
    restart: unless-stopped
    command: keydb-server /etc/keydb/keydb.conf

volumes:
  keydb_data:

启动服务：

bash
docker-compose up -d

环境变量

目前官方镜像未提供特定环境变量配置，所有配置需通过配置文件或命令行参数实现。常见配置参数可参考KeyDB官方文档（[***]