eqalpha/keydb

KeyDB Docker镜像文档

快速参考

• KeyDB文档和学习中心
• KeyDB社区论坛
• 查看Dockerfiles副本
• https://github.com/JohnSully/KeyDB/issues
• KeyDB官网
• https://github.com/EQ-Alpha/KeyDB
• 订阅KeyDB邮件列表
• 多主模式helm chart

标签说明

• x86_64_vx.x.x：基于指定版本发布的x86 Ubuntu 18.04构建
• arm64_vx.x.x：基于指定版本发布的Arm Ubuntu 18.04构建
• latest：清单标签，将拉取ubuntu18.04 x86_64_vx.x.x或ubuntu18.04 arm64_vx.x.x镜像
• alpine：当前为实验性镜像，KeyDB仍需进一步优化以完全支持Alpine构建
• unstable：KeyDB不稳定分支的nightly构建，仅适用于ubuntu18.04 x86_64_vx.x.x

什么是KeyDB？

KeyDB是Redis的高性能替代品，专注于多线程、内存效率和高吞吐量。除多线程外，KeyDB还具备多主配置、子键过期和定时任务等功能。如需大数据集FLASH存储、非阻塞查询或更高性能等附加功能，请查看KeyDB Cloud或KeyDB Enterprise。

兼容性

KeyDB保持与Redis协议、模块和脚本的完全兼容性，包括脚本和事务的原子性保证。由于KeyDB与Redis开发保持同步，KeyDB是Redis功能的超集，可作为现有Redis部署的无缝替代品。

在相同硬件上，KeyDB可实现比Redis显著更高的吞吐量。Active-Replication简化了热备故障转移，允许轻松在副本上分配写入，并使用简单的基于TCP的负载均衡/故障转移。KeyDB的更高性能使您能在更少硬件上完成更多工作，从而降低运营成本和复杂性。

下图比较了多个KeyDB和Redis设置，包括最新的Redis6 io-threads选项和TLS基准测试。

查看完整基准测试结果和设置信息：[***]

如何使用此镜像

如需复习Docker命令，可查看Docker文档此处

启动KeyDB实例

docker run --name some-keydb -d eqalpha/keydb

也可直接运行docker run eqalpha/keydb。上述命令指定了容器名称并以"分离"模式（后台运行）启动。

启动时向KeyDB传递配置参数

docker run --name some-keydb -d eqalpha/keydb keydb-server /etc/keydb/keydb.conf --server-threads 4 --requirepass password 

确保指定要修改参数的程序（keydb-server）。然后使用--参数名 值格式指定启动容器时要修改的配置参数。 完整配置选项可查看此处

绑定端口

如需将容器绑定到节点/机器以允许外部访问，传递参数-p 6379:6379

使用自定义配置文件

$ docker run -v /path-to-config-file/keydb.conf:/etc/keydb/keydb.conf --name mykeydb -d eqalpha/keydb

使用自定义配置文件时，需注释掉"bind 127.0.0.1"，将"protected-mode"从yes改为no。

可从https://github.com/EQ-Alpha/KeyDB%E8%8E%B7%E5%8F%96%E9%BB%98%E8%AE%A4%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%89%AF%E6%9C%AC%E5%B9%B6%E6%8C%89%E9%9C%80%E4%BF%AE%E6%94%B9%E3%80%82

符号链接

应用户要求实现Redis兼容性，我们包含了redis-cli和redis.conf的符号链接，分别链接到keydb-cli和keydb.conf。

使用持久化存储启动

$ docker run --name some-keydb -d eqalpha/keydb keydb-server /etc/keydb/keydb.conf --appendonly yes

这将启用每秒数据保存。有关AOF的更多配置选项，可进一步修改持久化选项。 如果启用持久化，数据将存储在VOLUME /data中，可与--volumes-from some-volume-container或-v /docker/host/dir:/data配合使用（参见Docker卷文档）。

从应用程序连接

$ docker run --name some-app --link some-keydb:eqalpha/keydb -d application-that-uses-keydb

或通过keydb-cli连接（也兼容redis-cli）

可通过docker inspect --format '{{ .NetworkSettings.IPAddress }}' mycontainername获取容器IP，然后运行：

docker run -it --rm eqalpha/keydb keydb-cli -h <上述IP地址> -p 6379

或者通过链接连接：

$ docker run -it --link some-keydb:eqalpha/keydb --rm eqalpha/keydb keydb-cli -h keydb -p 6379

KeyDB与Redis不同的特定配置选项

server-threads N              # 服务器线程数
server-thread-affinity [true/false]  # 服务器线程亲和性
scratch-file-path /tmp/       # 临时文件路径
multi-master yes              # 多主模式启用
active-replica yes            # 主动副本启用

Nightly构建

如果您希望跟上KeyDB的最新动态并在正式发布前体验开发中的功能，可拉取unstable标签。这将获取最新版本（每天东部时间4点自动更新）。这些标签仅适用于x86-64（amd-64）。

拉取最新镜像：docker pull eqalpha/keydb:unstable

关注我们

要及时了解KeyDB的产品、功能和发布更新，请通过以下渠道关注我们：

• 邮件
• LinkedIn

• https://github.com/EQ-Alpha/KeyDB

• 社区论坛