使用二进制安装 · 0.2.0

开始之前

使用 Linux 6.1+、可用的 io_uring 和兼容 Ubuntu 24.04 的 glibc。Linux 服务端二进制不能直接在 macOS 或 Windows 上执行，请使用 Linux 虚拟机或 Docker。Minimal 使用内核 TCP/io_uring。Standard 另含可选 SPDK/DPDK，要求 x86-64-v2 或 ARMv8-A + CRC32 及 NUMA/UUID 运行库。

1. 选择并下载软件包

发布包Linux 机器的 CPU 架构

Minimal 是最简单的入门选择，使用内核 TCP 和 io_uring 存储，不包含 SPDK / DPDK。

安装客户端和运行依赖（Ubuntu 24.04）

sudo apt-get update &&
sudo apt-get install -y ca-certificates curl redis-tools

下载、校验并进入软件包目录

在 Bash 终端中执行。校验失败时，后续命令不会执行。如果已从下载页解压此包，只需进入下方目录。

curl -fLO --retry 3 https://github.com/eloqdata/lavik/releases/download/v0.2.0/lavik-v0.2.0-linux-x86_64-minimal.tar.gz &&
curl -fLO --retry 3 https://github.com/eloqdata/lavik/releases/download/v0.2.0/lavik-v0.2.0-linux-x86_64-minimal.tar.gz.sha256 &&
sha256sum -c lavik-v0.2.0-linux-x86_64-minimal.tar.gz.sha256 &&
tar -xzf lavik-v0.2.0-linux-x86_64-minimal.tar.gz &&
cd lavik-v0.2.0-linux-x86_64-minimal &&
./lavik --version

当前目录应为: lavik-v0.2.0-linux-x86_64-minimal

版本输出应为 lavik 0.2.0。保持这个终端位于该目录，继续下面的启动步骤。

2. 启动并连接

在解压目录的 Bash 中执行以下命令。保持此终端运行，在另一个终端执行 redis-cli。Minimal 和 Standard 均可运行此文件式示例。回环监听和 /tmp 目录适用于临时本地评估。

#!/usr/bin/env bash
# A private throwaway file: never point this example at an existing database.
set -euo pipefail
if [ ! -x ./lavik ]; then
  echo "Run this from the extracted Lavik package directory (the folder containing ./lavik)." >&2
  exit 1
fi
mkdir -p /tmp/lavik-example
if [ ! -e /tmp/lavik-example/data ]; then
  fallocate -l 512M /tmp/lavik-example/data
fi
./lavik --bind 127.0.0.1 --port 6379 --metrics-port 0 \
  --network kernel --storage uring \
  --threads 2 --no-pin-workers --registered-buffer-mb-per-worker 64 \
  --shutdown-checkpoint --data-file /tmp/lavik-example/data \
  --log-dir /tmp/lavik-example/logs

redis-cli -h 127.0.0.1 -p 6379 PING
# PONG
redis-cli -h 127.0.0.1 -p 6379 SET greeting 'hello from Lavik'
# OK
redis-cli -h 127.0.0.1 -p 6379 GET greeting
# hello from Lavik

3. 停止并重启

按 Ctrl-C 停止，然后从同一目录重新执行启动代码。脚本保留现有数据文件。需要保留的数据应使用持久目录。解压不会把目录加入 PATH；./lavik 执行当前目录的程序。systemd 服务是可选项，APT 指南提供了相应服务。

从软件包安装并使用 systemd →

使用 Standard 的 SPDK

安装 Standard 不会自动切换存储后端。选择 --storage=spdk 及 spdk://PCI_BDF/NSID 路径前，需准备专用空 NVMe 命名空间、IOMMU/VFIO、hugepages 和锁定内存限额。网络仍可使用内核 TCP。文件式示例不衡量 NVMe/SPDK 性能。

0.2.0 请使用 v0.2.0 源码检出中的 SPDK 辅助脚本（提交 2908f86f2770e9c6e8acc6585b3bedb4b44d1cd5）。上游说明保留了旧 Beta 示例：将源码版本替换为 v0.2.0，并将 LAVIK_BINARY 设为 /opt/lavik-v0.2.0-linux-x86_64/lavik，或你解压的 0.2.0 Standard 可执行文件的实际绝对路径。保留说明中的专用设备核验、大页设置与 io_uring 要求。

本版本的 SPDK 配置 →