sa-token-go/examples/redis-example/README_zh.md

Redis 存储示例

English | 中文说明

本示例演示如何使用 Redis 作为 Sa-Token-Go 的存储后端。

前置要求

• Redis 服务器运行在 localhost:6379（或设置 REDIS_ADDR 环境变量）
• Go 1.21 或更高版本

安装 Redis

macOS

brew install redis
brew services start redis

Linux (Ubuntu/Debian)

sudo apt-get install redis-server
sudo systemctl start redis

Docker

docker run -d -p 6379:6379 redis:7-alpine

运行示例

# 无密码
go run main.go

# 带密码
REDIS_PASSWORD=your-password go run main.go

# 自定义 Redis 地址
REDIS_ADDR=redis.example.com:6379 go run main.go

演示的核心功能

1. ✅ Redis 连接 - 使用 go-redis 连接 Redis
2. ✅ 认证功能 - 使用 Redis 存储进行登录/登出
3. ✅ 权限管理 - 在 Redis 中存储权限
4. ✅ 角色管理 - 在 Redis 中存储角色
5. ✅ Session 管理 - 持久化的 Session 数据
6. ✅ 数据持久化 - 数据在应用重启后仍然存在

环境变量

变量	说明	默认值
REDIS_ADDR	Redis 服务器地址	localhost:6379
REDIS_PASSWORD	Redis 密码	（空）
REDIS_DB	Redis 数据库编号	0

在 Redis 中查看数据

# 连接到 Redis CLI
redis-cli

# 列出所有 Sa-Token 键
KEYS satoken:*

# 查看 Token 信息
GET satoken:login:token:{your-token}

# 查看 Session 数据
GET satoken:session:1000

# 查看权限
SMEMBERS satoken:permission:1000

# 查看角色
SMEMBERS satoken:role:1000

生产环境部署

查看 Redis 存储指南 了解：

• 连接池配置
• 高可用（哨兵模式）
• 集群模式
• TLS/SSL 支持
• Docker/Kubernetes 部署

相关文档

• Redis 存储指南
• 快速开始
• 认证指南