5 分钟快速开始
用 Docker、包管理器或一键云实例，5 分钟跑起一个 Valkey
目标：本地或云上跑起一个 Valkey，用
valkey-cli连上、写一个 key、读出来。三条路径任选其一。
路径一：Docker（最快）
官方镜像是 valkey/valkey，容器内同时带 valkey-server 和 valkey-cli，默认端口 6379。
拉起一个带持久化的实例
docker run --name myvalkey -d \
-p 6379:6379 \
-v valkey-data:/data \
valkey/valkey:9.1 \
valkey-server --save 60 1 --appendonly yes--save 60 1：每 60 秒若有至少 1 个写入就做一次 RDB 快照；--appendonly yes：开启 AOF，断电也不丢最近写入；- 数据目录在容器内的
/data，挂到了命名卷valkey-data。
连上去敲两条命令
docker exec -it myvalkey valkey-cli127.0.0.1:6379> SET hello "valkey"
OK
127.0.0.1:6379> GET hello
"valkey"
127.0.0.1:6379> INFO server
# Server
redis_version:7.2.4 # ← 注意：为兼容客户端，这里仍报 7.2.4
valkey_version:9.1.0 # ← 真正的引擎版本看这一行
server_name:valkey别被 redis_version:7.2.4 吓到——这是 Valkey 为了让老客户端的版本探测逻辑不报错而故意保留的字段。真实版本看 valkey_version 和 server_name。
路径二：包管理器（裸机 / VM）
sudo apt update
sudo apt install valkey
# 想保留 redis-server / redis-cli 这两个命令名（兼容老脚本）：
sudo apt install valkey-redis-compat
sudo systemctl enable --now valkey-server
valkey-cli ping # → PONGsudo dnf install valkey
# 注意 RPM 系的兼容包名词序不一样：
sudo dnf install valkey-compat-redis
sudo systemctl enable --now valkey
valkey-cli ping# SLES 15 SP7+：因为同名包冲突，需要 --force-resolution
sudo zypper install --force-resolution valkey-compat-redis
# 配置文件仍在 /etc/redis/valkey.conf，二进制软链到 /usr/sbin/redis-server
sudo systemctl enable --now valkey
valkey-cli ping迁移后 INFO 会同时报 redis_version:7.2.4 和 valkey_version:7.2.5，redis-cli 是 valkey-cli 的软链——老脚本不用改。
sudo pacman -S valkey
sudo systemctl enable --now valkeyArch 的包名直接就是 valkey，干净没有兼容层。
brew install valkey
brew services start valkey
valkey-cli ping
# 配置文件在 $(brew --prefix)/etc/valkey.confgit clone https://github.com/valkey-io/valkey.git && cd valkey
git checkout 9.1.0
make BUILD_TLS=yes # 需要 libssl-dev
sudo make install # 装到 /usr/local/bin
valkey-server --version依赖（jemalloc / lua / hiredis / linenoise）都内置在 deps/，只需要 GNU Make + C 编译器。想让 systemd 的 notify 正常工作，先装 libsystemd-dev。
兼容包名各发行版不一样：valkey-redis-compat（apt）、valkey-compat-redis（dnf）、valkey-compat（apk）。它把 redis-server、redis-cli 等做成指向 valkey-* 的软链接，方便不改老脚本。基础包不含 redis-* 命令名。
路径三：一键云实例（不想碰运维）
如果你只是想要一个能用的 endpoint：
| 厂商 | 入口 | 起步价 |
|---|---|---|
| Aiven for Valkey | 免费层，1 GB、单节点、免信用卡 | $0 |
| AWS ElastiCache Serverless | 一分钟开好，自动扩缩 | ~$6/月（100 MB 起） |
| DigitalOcean Managed Caching | 单节点 1 GiB | $15/月 |
| GCP Memorystore for Valkey | 1–250 节点集群 | 按节点计费 |