安装指南

在 Linux、macOS 或 Docker 上安装 Valkey，只需几分钟。

Linux 安装

Ubuntu / Debian

通过官方 APT 仓库安装，可获得最新的稳定版本：

bash复制

curl -fsSL https://valkey.io/install/valkey-8.1.sh | sudo bash
sudo apt install valkey

CentOS / RHEL / Fedora

使用 RPM 包管理器安装：

bash复制

sudo dnf install valkey

从源码编译

如果需要自定义编译选项或安装最新版本：

bash复制

git clone https://github.com/valkey-io/valkey.git
cd valkey
make -j$(nproc)
sudo make install

macOS 安装

推荐使用 Homebrew 安装：

bash复制

brew install valkey

安装完成后启动服务：

bash复制

brew services start valkey

Docker 部署

使用官方 Docker 镜像是最快的部署方式：

bash复制

# 拉取最新稳定版镜像
docker pull valkey/valkey:8.1

# 启动容器（默认端口 6379）
docker run -d --name valkey -p 6379:6379 valkey/valkey:8.1

# 连接测试
docker exec -it valkey valkey-cli ping

数据持久化：生产环境建议挂载数据卷：docker run -v /data/valkey:/data valkey/valkey:8.1

验证安装

安装完成后，运行以下命令确认 Valkey 正常工作：

bash复制

$ valkey-cli ping
PONG

$ valkey-cli INFO server | grep valkey_version
valkey_version:8.1.0

系统服务管理

在 Linux 上，Valkey 安装后会自动注册为 systemd 服务：

bash复制

# 启动
sudo systemctl start valkey

# 设置开机自启
sudo systemctl enable valkey

# 查看状态
sudo systemctl status valkey

内核参数：生产环境建议设置 vm.overcommit_memory=1 和 net.core.somaxconn=1024，以避免数据截断和连接队列溢出。

什么是 Valkey

常用命令