Skip to main content
Upstash 是一项完全托管的 Redis 数据库服务。它兼容 Redis® API,因此你可以使用 Bun 原生的 Redis 客户端进行连接。
所有 Upstash Redis 数据库默认启用 TLS。

1

创建一个新项目

使用 bun init 创建一个新项目:
terminal
2

创建一个 Upstash Redis 数据库

访问 Upstash 控制台 并创建一个新的 Redis 数据库。完成快速入门指南后,你会看到数据库页面及其连接信息。数据库页面会显示两种连接方式:HTTP 和 TLS。对于 Bun 的 Redis 客户端,你需要使用 TLS 连接信息;URL 以 rediss:// 开头。
Upstash Redis 数据库页面
3

使用 Bun 的 Redis 客户端进行连接

.env 文件中使用 Redis 终端节点(而不是 REST URL)设置 REDIS_URL 环境变量:
.env
Bun 的 Redis 客户端默认从 REDIS_URL 读取连接信息:
index.ts
或者,使用 RedisClient 创建自定义客户端:
index.ts
4

使用 Redis 客户端

使用 Redis 客户端读取和写入 Upstash 数据库中的键:
index.ts
Redis 客户端会自动处理连接。对于基本操作,你无需手动连接或断开连接。