📝 注册账户

步骤
1. 访问 https://upstash.com
2. 点击 "Start Free" 或 "Sign Up"
3. 使用 GitHub、Google 或邮箱注册
4. 验证邮箱

免费层：256MB 数据 + 500K 请求/月，无需信用卡。

🔴 创建 Redis 数据库

步骤
1. 进入 Dashboard
2. 点击 "Create Database"
3. 选择 "Redis"
4. 选择区域（建议选择最近的）
5. 命名数据库
6. 点击 "Create"

创建后获取 UPSTASH_REDIS_REST_URL 和 UPSTASH_REDIS_REST_TOKEN。

📦 安装 SDK

JavaScript/TypeScript

bash
npm install @upstash/redis
# 或
bun add @upstash/redis

Python

bash
pip install upstash-redis

Go

bash
go get github.com/upstash/upstash-redis-go

💻 基本操作

JavaScript 示例

javascript
import { Redis } from '@upstash/redis'

const redis = new Redis({
  url: process.env.UPSTASH_REDIS_REST_URL,
  token: process.env.UPSTASH_REDIS_REST_TOKEN,
})

// 设置值
await redis.set('name', 'Upstash')

// 获取值
const name = await redis.get('name')
console.log(name) // "Upstash"

// 设置过期时间（秒）
await redis.setex('session', 3600, 'user123')

// 删除
await redis.del('name')

// 自增
await redis.incr('counter')

// 列表操作
await redis.lpush('list', 'a', 'b', 'c')
const list = await redis.lrange('list', 0, -1)

// 哈希操作
await redis.hset('user:1', { name: 'John', age: 30 })
const user = await redis.hgetall('user:1')

Python 示例

python
from upstash_redis import Redis

redis = Redis(
    url="UPSTASH_REDIS_REST_URL",
    token="UPSTASH_REDIS_REST_TOKEN"
)

# 设置值
redis.set("name", "Upstash")

# 获取值
name = redis.get("name")
print(name)  # "Upstash"

🌍 环境变量

.env
UPSTASH_REDIS_REST_URL=https://xxx.upstash.io
UPSTASH_REDIS_REST_TOKEN=your-token

# Vector
UPSTASH_VECTOR_REST_URL=https://xxx.upstash.io
UPSTASH_VECTOR_REST_TOKEN=your-token

# QStash
QSTASH_URL=https://qstash.upstash.io
QSTASH_TOKEN=your-token

✅ 验证连接

javascript
// 测试连接
const result = await redis.ping()
console.log(result) // "PONG"

// 查看信息
const info = await redis.dbsize()
console.log(`数据库有 ${info} 个键`)