Valkey安装使用教程:Redis完美替代方案

Valkey 完全兼容 Redis 协议,所以所有 Redis 客户端、用法、配置都能直接用,几乎不用改代码!
Valkey 主打低延迟、高并发、实时性,适配 Redis 的核心使用场景,尤其适合对响应速度要求高的业务:

  1. 会话缓存:存储用户登录态、会话信息,减轻主数据库压力,提升访问速度;
  2. 高速缓存:缓存热点数据(如电商商品信息、资讯内容),解决数据库性能瓶颈;
  3. 消息队列:基于 Pub/Sub 或 Stream 实现轻量级消息队列,适配通知推送、日志收集等场景;
  4. 实时数据处理:支持电商实时库存更新、直播弹幕计数、社交平台点赞 / 关注数统计等高频写操作;
  5. 分布式锁:利用原子操作实现分布式系统中的资源锁,解决并发竞争问题。

1. 安装 Valkey(1 分钟)

Ubuntu/Debian

1
sudo apt install valkey

或用 Docker(最简单)

1
docker run -d -p 6379:6379 valkey/valkey

启动后默认端口:6379
和 Redis 一模一样。

2. 项目中连接 Valkey

因为 Valkey = Redis 兼容版,所以你直接用 Redis 客户端 就能连!

Python 示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import redis

# 连接 Valkey(和连接 Redis 完全一样)
r = redis.Redis(host='localhost', port=6379, db=0)

# 存值
r.set('name', 'hello valkey')

# 取值
print(r.get('name'))  # b'hello valkey'

Java(Jedis)示例

1
2
3
Jedis jedis = new Jedis("localhost", 6379);
jedis.set("key", "val");
String value = jedis.get("key");

Go 示例

1
2
3
4
client := redis.NewClient(&redis.Options{
    Addr: "localhost:6379",
})
client.Set(context.Background(), "key", "val", 0)

3. 常用操作(和 Redis 完全一样)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
# 命令行连接
valkey-cli

# 存
set name tom

# 取
get name

# 设过期
set user:100 abc ex 60

# 列表
lpush list a b c
lrange list 0 -1

4. 生产环境常用配置

创建 /etc/valkey/valkey.conf 加入:

1
2
3
4
5
bind 0.0.0.0
port 6379
requirepass 你的密码
daemonize yes
appendonly yes  # 持久化

重启:

1
sudo systemctl restart valkey

Valkey 就是开源版 Redis,用法、命令、客户端全部通用,你就当 Redis 用就行!

docker-compose.yml部署 Valkey 配置

docker-compose.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
services:
  valkey:
    image: valkey/valkey:latest
    container_name: valkey
    restart: always
    ports:
      - "6379:6379"
    volumes:
      - ./valkey-data:/data  # 数据持久化
    command: valkey-server --requirepass 123456 --appendonly yes
    environment:
      - TZ=Asia/Shanghai

说明

  • 端口:6379(和 Redis 一样)
  • 密码:123456(自己改)
  • 数据持久化:宿主机 ./valkey-data,删容器数据不丢
  • AOF 持久化:开启,数据更安全

启动命令

1
docker compose up -d

查看日志

1
docker compose logs -f valkey

连接测试

1
docker exec -it valkey valkey-cli -a 123456

然后输入:

1
2
set name valkey
get name

能正常读写 = 部署成功 ✅

项目里怎么连?

和连接 Redis 完全一样

  • host: localhost
  • port: 6379
  • password: 123456
  • db: 0
原文链接: https://www.17you.com/programming/valkey-redis-alternative-docker-installation/ 已复制!
编程和技术

寻找技术支持帮助和技术合伙人一起搞事。

请点击联系我


相关内容