KiviDB 发布：Rust 编写的 Redis 兼容内存数据库与向量缓存

KiviDB 是一个用 Rust 编写的快速、多线程的 Redis® 和 Valkey 替代品。它使用 Redis 协议（RESP2 和 RESP3），因此现有的 Redis 客户端、redis-cli 和库无需修改即可使用，并且内置全文搜索和向量搜索。它在分片的内存键值设计上运行每个核心，并持久化到快照和可选的仅追加文件。

在相同的 32 核上，KiviDB 每秒可处理 2100 万次流水线 GET：约为 Redis 8 的 9 倍，Dragonfly 的 2.3 倍，且 p99 延迟不到 Dragonfly 的一半（基准测试）。

docker run -d -p 6380:6380 kividb/kividb
redis-cli -p 6380 PING        # PONG

KiviDB 监听 6380，而不是 Redis 的 6379，因此两者可以并行运行；将客户端指向该端口，或传入 --port 6379。

• 协议：Redis 兼容的命令接口（支持的命令见 COMMANDS.md）
• 搜索和向量：Redis Stack 风格的 FT.* 命令，用于全文、标签、数值和向量（FLAT / HNSW）搜索
• Lua 脚本：可选的 Cargo 特性。EVAL、SCRIPT、FUNCTION、FCALL 及相关命令在启用 --features lua 的构建中可用（见 脚本命令（Lua））
• TLS：可选的 Cargo 特性（--features tls）
• 默认监听地址：0.0.0.0:6380，并启用 保护模式
• 许可证：GNU Affero 通用公共许可证 v3（AGPL-3.0-only），开源；使用 KiviDB 不会使你的应用程序受 AGPL 约束；见 许可证

仓库：github.com/kividbio/kividb · 网站：kividb.io

对比

截至 2026 年 10 月。有内容过时或错误？请 提交 issue。

性能

吞吐量、延迟、向量搜索和向量摄入。点击查看全分辨率视频。

以下所有数据均来自 2026 年 10 月在 AWS Graviton3 裸金属上的一次会话：服务器位于 c7gn.metal（64 vCPU），限制在 32 核，负载生成器位于同一放置组中的第二台 c7gn.metal。每个引擎在服务器上单独运行，一个接一个。

键值

通过 kivi-benchmark 的 run-matrix.sh 运行 memtier_benchmark：1000 万个键，100 字节值，每个场景 30 秒，两轮平均值；300 个连接流水线，1200 个无流水线。

ops/s

向量搜索

redis/vector-db-benchmark 在 glove-25-angular（118 万向量，25 维）上：HNSW，M=16，EF_CONSTRUCTION=256，100 个客户端以 64 为批次上传，然后在 ef 64、128、256 和 512 下查询。

• 方法与脚本：kivi-benchmark
• 最近一次自动化运行：benchmarks/LATEST.md

结果取决于运行环境。请将已发布的数字视为一次受控采集，而非保证值，并请在你自己的硬件和工作负载上进行测量。

向量搜索（Redis Stack 风格的 FT.*）

KiviDB 实现了兼容 Redis Stack 的搜索与向量命令，因此现有客户端和教程基本可以原样使用。可将它们用于哈希字段上的全文检索（BM25）、标签 / 数值以及向量 ANN（FLAT 或 HNSW）。

快速开始

1. 创建索引：在具有指定前缀的键上创建索引，至少声明一个 VECTOR 字段（HNSW 或 FLAT），以及可选的 TEXT / TAG / NUMERIC 字段：

redis-cli -p 6380 FT.CREATE idx ON HASH PREFIX 1 doc: SCHEMA \
  vec VECTOR HNSW 10 TYPE FLOAT32 DIM 128 DISTANCE\_METRIC COSINE M 16 EF\_CONSTRUCTION 128

1. 存储向量：以原始 FLOAT32 小端字节形式存入哈希字段（DIM × 4 字节），这与 Redis Stack 及 redis-py / numpy blob 的约定相同。请使用客户端支持二进制安全的 HSET（tests/e2e/ 下的集成测试中有示例）。

2. 使用 KNN 查询（Dialect 2），将查询向量作为命名二进制参数传入：

redis-cli -p 6380 FT.SEARCH idx '\*=>\[KNN 10 @vec $q\]' PARAMS 2 q <blob\> DIALECT 2

完整的命令接口、过滤器、混合搜索和边界情况见 COMMANDS.md（搜索 FT.CREATE、FT.SEARCH、FT.HYBRID 等）。

持久化与重启

• 原生快照（dump.kdb）会存储键、索引模式，并且当你在索引已填充的情况下执行 SAVE / BGSAVE 时，还会存储每个向量字段的 HNSW 图，因此重启后的搜索质量与关机前所拥有的图一致。
• 在启动时重建搜索索引期间，大多数命令会返回 LOADING，直到重建完成；PING、INFO 及其他少数命令仍可正常工作。
• 在大量摄取数据后，请运行 SAVE（或安排 BGSAVE），以便下次启动时从磁盘重新加载图，而不是从哈希重建。

构建

KiviDB 有四种变体，在构建时通过 Cargo features 选择：

在没有 Lua 的构建中，脚本命令会返回错误。没有 TLS 的构建在指定 --tls-port 时会拒绝启动，而不是以明文提供服务。

从源码构建

需要 stable Rust 工具链（rust-toolchain.toml 会选择带 rustfmt 和 clippy 的 stable）。该 crate 使用 2024 edition；其检查所依据的最旧工具链是 Rust 1.89，即 Dockerfile 构建所用的版本。

git clone https://github.com/kividbio/kividb.git
cd kividb

cargo build --release                      # default variant
cargo build --release --features lua       # with Lua scripting
cargo build --release --features tls       # with TLS
cargo build --release --features lua,tls   # full

./target/release/kividb

在 Linux 上，当内核允许时服务器使用 io_uring，否则回退到 Tokio（--io-model auto，默认）。

要自行构建 Docker 镜像，docker build -t kividb . 会构建默认变体；docker build --build-arg KIVIDB_FEATURES=lua,tls -t kividb:full . 会构建另一个变体。

运行 KiviDB

./target/release/kividb                    # listens on 0.0.0.0:6380
redis-cli -p 6380 PING

任何 Redis 客户端均可使用；将其指向端口 6380。

保护模式

保护模式默认开启，与 Redis 一致。开启时，如果未设置绑定地址（配置文件中为 --bind 或 bind）且 default 用户没有密码，则只有同一台机器上的客户端（回环地址）可以连接。其他任何客户端都会收到一个 -DENIED 错误，其中说明了可选项，随后连接被断开。

要接受来自其他机器的客户端，请执行以下操作之一：

• 设置密码：--requirepass <password>，或 ACL SETUSER default ><password>；
• 设置绑定地址：--bind <address>；
• 关闭保护模式：在配置文件中设置 --protected-mode no、protected-mode no，或从本地客户端执行 CONFIG SET protected-mode no。

如果你关闭了保护模式或绑定到公网地址，请确保在没有密码的情况下无法从互联网访问该服务器。

Docker

镜像发布到 Docker Hub 和 GitHub Container Registry，两处的标签相同：

docker pull kividb/kividb:latest
# or
docker pull ghcr.io/kividbio/kividb:latest

latest 以及诸如 v1.1.0 的版本标签是默认变体；v1.1.0-lua、v1.1.0-tls 和 v1.1.0-full 是其他变体。镜像为 amd64 和 arm64 构建。

docker run -p 6380:6380 kividb/kividb

容器通过其网络访问，永远不会通过回环地址访问，因此镜像的默认命令是 --protected-mode no。你传入的参数会替换该默认值，这会使保护模式重新开启。当你传入自己的标志时，请设置密码（推荐）或自行添加 --protected-mode no：

docker run -p 6380:6380 ghcr.io/kividbio/kividb \
  --requirepass "change-me" \
  --databases 8 \
  --loglevel debug

使用 AOF 持久化（挂载一个卷，使数据在重启后仍然存在；服务器在 /home/kividb 中以用户 kividb 运行）：

docker run -p 6380:6380 \
  -v $(pwd)/data:/home/kividb \
  ghcr.io/kividbio/kividb --aof --requirepass "change-me"

使用 --aof 时，每次写入都会追加到 appendonly.aof，并在启动时重放该文件，因此崩溃最多只会丢失大约最后 1 秒的写入（fsync 间隔），而不是自上次快照以来的所有数据。当存在 AOF 时，它就是事实来源，不会加载快照；原因见 docs/PERSISTENCE.md。

**容器中的 io_uring：**Docker 的默认 seccomp 配置文件在近期版本中会阻止 io_uring，KiviDB 随后会回退到 Tokio。要在 Linux 主机上允许它，请使用 --security-opt seccomp=unconfined 运行（在生产环境中使用前，请先了解这允许了什么）。

发布二进制文件

Linux（x86_64、aarch64）和 macOS（Apple silicon、Intel）的发布二进制文件发布在 GitHub Releases 上。下面的 latest/download 链接始终指向最新版本；将 latest/download 替换为 download/v1.1.0 可固定某个版本。

# Linux x86\_64
curl -LO https://github.com/kividbio/kividb/releases/latest/download/kividb-linux-x86\_64.tar.gz
tar xzf kividb-linux-x86\_64.tar.gz
./kividb

# Linux aarch64 (an ARMv8.1 CPU or newer: Graviton2 and later, Ampere; not a Raspberry Pi 4)
curl -LO https://github.com/kividbio/kividb/releases/latest/download/kividb-linux-aarch64.tar.gz

# macOS, Apple silicon / Intel
curl -LO https://github.com/kividbio/kividb/releases/latest/download/kividb-darwin-aarch64.tar.gz
curl -LO https://github.com/kividbio/kividb/releases/latest/download/kividb-darwin-x86\_64.tar.gz

除默认变体外，每个变体的名称都包含在文件名中：kividb-lua-linux-x86_64.tar.gz、kividb-tls-…、kividb-full-…。默认变体还为 Linux 打包为 kividb_amd64.deb / kividb_arm64.deb 和 kividb.x86_64.rpm / kividb.aarch64.rpm，使用 nfpm 从 packaging/nfpm.yaml 构建。一个 SHA256SUMS.txt 文件列出了发布中每个文件的校验和。

curl -LO https://github.com/kividbio/kividb/releases/latest/download/kividb\_amd64.deb && sudo dpkg -i kividb\_amd64.deb
curl -LO https://github.com/kividbio/kividb/releases/latest/download/kividb.x86\_64.rpm && sudo rpm -i kividb.x86\_64.rpm

配置

KiviDB 通过命令行标志或 Redis 风格的配置文件（每行一条指令，例如 port 6380 或 appendonly yes）进行配置。如果存在，则从 /etc/kividb/kividb.conf 读取该文件；--configfile <path> 指定另一个文件。命令行上给出的标志优先于文件中的相同设置。运行 kividb --help 可获取完整列表。

TLS

TLS 客户端在单独的端口 --tls-port 上连接；明文流量仍走 --port。

cargo build --release --features tls
./target/release/kividb --port 6380 --tls-port 6381 --tls-cert-file cert.pem --tls-key-file key.pem
redis-cli --tls -p 6381 --cacert ca.pem   # ca.pem: the CA that signed cert.pem

**客户端证书（双向 TLS）。**使用 --tls-ca-cert-file ca.pem 时，客户端必须提供由该 CA 签名的 证书；其他客户端会在握手期间被拒绝。 --tls-auth-clients optional 接受不带证书的客户端，但仍会拒绝 无效证书，而 --tls-auth-clients no 不会要求提供证书。使用 redis-cli 时： redis-cli --tls -p 6381 --cacert ca.pem --cert client.pem --key client.key。

**客户端在 TLS 端口上必须使用 TLS。**对该端口的明文连接（例如不带 --tls 的 redis-cli -p 6381） 会握手失败，服务器会记录 [TLS] handshake failed。对于 memtier_benchmark，请添加 --tls（对于自签名证书，还需添加 --tls-skip-verify）。

日志与错误

日志输出到标准错误，或输出到 --logfile。docs/LOGGING.md 描述了日志；docs/ERRORS.md 解释了警告、错误和错误 回复，以及针对每种情况应如何处理。

启动时更新检查

KiviDB 的发布构建在启动时会向 https://github.com/kividbio/kividb/releases/latest 发出 一次 HTTPS 请求，该页面与你要查找 最新发布版本时打开的页面相同。GitHub 会以重定向到该发布版本的标签作为响应；如果该版本比 正在运行的构建更新，KiviDB 会在启动 横幅之前打印一条带链接的简短提示。除请求本身外不会发送任何内容，请求带有 kividb/<version> 的 User-Agent： 不包含主机名、配置、密钥、数据或标识符。GitHub 会看到请求的源 IP 地址，就像任何 Web 服务器一样。

启动时最多等待 1.5 秒以获取回复；失败仅以调试级别记录， 绝不会影响客户端。只接受回复中符合版本格式的标签，不会打印 回复中的其他任何内容。

以下任意一项都会将其关闭：

• 命令行中的 --update-check no；
• 配置文件中的 update-check no；
• 环境变量中的 KIVIDB_NO_UPDATE_CHECK=1。

调试构建也绝不会执行该检查，设置了 CI 环境变量时同样不会。 --update-check-url 可将其指向另一个 https:// 地址，例如封闭网络内的镜像。 docs/UPDATE_CHECK.md 中有详细信息。

贡献

欢迎贡献。请参阅 CONTRIBUTING.md 了解如何构建、测试 和提交更改。贡献需依据 贡献者许可协议 接受，你需在首次拉取请求时签署该协议。

请遵守 行为准则。变更日志 列出了每个版本的更改内容。

安全

请不要在公开 issue 中报告安全漏洞。请参阅 SECURITY.md 了解如何私下报告。

许可证

Copyright (c) 2026 KIVIDB PRIVATE LIMITED。

KiviDB 是开源软件，依据 GNU Affero 通用公共许可证第 3 版（AGPL-3.0-only）授权，该许可证 已获 OSI 批准。你可以依据其条款使用、修改和再分发。请参阅 NOTICE。

使用 KiviDB 不会使你的应用受到 AGPL 约束。通过网络、经由任意 Redis 客户端与 KiviDB 通信的应用是一个独立的程序：你可以在任何产品中（无论开源还是闭源、商业与否）将未经修改的 KiviDB 作为数据库运行，而无需对你的应用代码承担任何义务。AGPL 在 GPL 之外只多要求一件事：如果你修改了 KiviDB 本身，并让他人通过网络使用你修改后的版本（例如作为托管服务），你必须向他们提供你所修改的 KiviDB 的源代码。

**商业许可。**KIVIDB PRIVATE LIMITED 拥有 KiviDB 的版权，并同时以商业许可的方式提供它，面向无法使用 AGPL 软件、或希望修改或嵌入 KiviDB 而不公开其改动的组织。请致信 support@kividb.io。

**我们的承诺。**我们以 AGPLv3 发布的每一个 KiviDB 版本都将持续以 AGPLv3 提供。贡献者许可协议让我们能够在其之外同时提供商业许可；它并不是用来收回开源版本的手段。

常见问题

• **我可以将 KiviDB 用作我的闭源或商业应用的数据库吗？**可以。你的应用通过网络连接 KiviDB；它并非 KiviDB 的衍生作品，AGPL 对其不施加任何义务。
• **我可以将 KiviDB 作为服务提供给我自己的用户或客户吗？**可以。如果你运行的是未经修改的版本，你无需发布任何内容。如果你修改了 KiviDB 并通过网络提供该修改后的版本，你必须向该服务的用户提供其源代码。
• **客户端库或我的配置算作修改吗？**不算。Redis 客户端、配置文件，以及你发送给 KiviDB 的脚本和函数都不属于 KiviDB 的一部分。
• **我的组织不允许使用 AGPL 软件。**商业许可正是为此而设：support@kividb.io。

商标

Redis® 是 Redis Ltd. 的注册商标。其中的一切权利均归 Redis Ltd. 所有。KiviDB 的任何使用仅出于指称目的，并不表示 Redis 与 KiviDB 之间存在任何赞助、认可或关联关系。KiviDB 与 Redis Ltd. 无关联。文中提及的其他名称均为其各自所有者的商标。