.env.example

# ==========================================
# 日志配置 / Logging Configuration
# ==========================================
# 日志级别: DEBUG, INFO, WARNING, ERROR, CRITICAL
LOG_LEVEL=ERROR

# ==========================================
# 存储后端配置 / Storage Backend Configuration
# ==========================================
# 是否使用 Redis（true/false）
# true: 优先尝试连接 Redis
# false: 直接使用内存 KV 存储（纯 relay 模式）
USE_REDIS=true

# Redis 连接失败时是否自动降级到内存 KV（true/false）
# true: Redis 连接失败时自动使用内存 KV 存储
# false: Redis 连接失败时直接报错退出
FALLBACK_TO_MEMORY=true

# ==========================================
# Redis 连接配置 / Redis Connection Configuration
# ==========================================
# 方法1: 使用完整的 Redis 连接字符串（优先级高）
# REDIS_CONN=redis://default:password@localhost:6379/0

# 方法2: 使用单个参数配置（如果 REDIS_CONN 未设置）
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_DB=0
REDIS_PASSWORD=

# ==========================================
# 推送服务配置 / Push Server Configuration
# ==========================================
# 推送服务器地址（可选）
PUSH_SERVER_URL=

# ==========================================
# 会话和安全配置 / Session & Security Configuration
# ==========================================
# 会话密钥（用于 JWT 令牌生成和验证）
# 如未设置，将自动生成随机值
SESSION_SECRET=your-secret-key-here

# ==========================================
# 构建和部署信息 / Build & Deployment Info
# ==========================================
# Git 提交 ID（用于版本标识）
COMMIT_ID=

# 构建时间戳
BUILD_AT=

# ==========================================
# 开发调试配置 / Debug Configuration
# ==========================================
# 调试模式: true 启用调试（允许所有 CORS，跳过某些检查）
#          false 生产模式（严格的 CORS 规则和安全检查）
DEBUG=false

# ==========================================
# 使用示例 / Usage Examples
# ==========================================
#
# 1. 完整 Redis 模式（推荐生产环境）
#    USE_REDIS=true
#    FALLBACK_TO_MEMORY=true
#    REDIS_HOST=redis.example.com
#    REDIS_PORT=6379
#    REDIS_PASSWORD=your-password
#
# 2. 纯内存模式（无 Redis，本地开发）
#    USE_REDIS=false
#    # 数据存储在内存中，应用重启后丢失
#
# 3. Redis 优先 + 自动降级（推荐）
#    USE_REDIS=true
#    FALLBACK_TO_MEMORY=true
#    # 如果 Redis 连接失败，自动使用内存存储
#