KatelyaTV/.env.example

# MoonTV 环境变量配置示例
# 复制此文件为 .env.local 并根据需要修改

# =============================================================================
# 基础配置
# =============================================================================

# 站点访问密码（必填）
# 用于保护站点访问，防止公开访问
PASSWORD=your_secure_password_here

# 站点名称
# 在页面标题和界面中显示的名称
SITE_NAME=MoonTV

# 站点公告
# 显示在页面顶部的公告信息
ANNOUNCEMENT=本网站仅提供影视信息搜索服务，所有内容均来自第三方网站。本站不存储任何视频资源，不对任何内容的准确性、合法性、完整性负责。

# =============================================================================
# 存储配置
# =============================================================================

# 存储类型
# 可选值: localstorage, redis, d1, upstash
# localstorage: 本地存储，单用户，数据不持久化
# redis: Redis 数据库，多用户，数据持久化
# d1: Cloudflare D1 数据库，多用户，数据持久化
# upstash: Upstash Redis，多用户，数据持久化
NEXT_PUBLIC_STORAGE_TYPE=localstorage

# =============================================================================
# Redis 配置 (当 NEXT_PUBLIC_STORAGE_TYPE=redis 时使用)
# =============================================================================

# Redis 连接 URL
# 格式: redis://username:password@host:port/database
# 示例: redis://localhost:6379/0
REDIS_URL=redis://localhost:6379/0

# Redis 密码 (如果 Redis 需要认证)
# REDIS_PASSWORD=your_redis_password

# Redis 数据库编号 (可选，默认为 0)
# REDIS_DB=0

# =============================================================================
# Upstash Redis 配置 (当 NEXT_PUBLIC_STORAGE_TYPE=upstash 时使用)
# =============================================================================

# Upstash Redis 连接 URL
# 从 Upstash 控制台获取
UPSTASH_URL=https://your-instance.upstash.io

# Upstash Redis 访问令牌
# 从 Upstash 控制台获取
UPSTASH_TOKEN=your_upstash_token

# =============================================================================
# Cloudflare D1 配置 (当 NEXT_PUBLIC_STORAGE_TYPE=d1 时使用)
# =============================================================================

# D1 数据库绑定名称
# 在 Cloudflare Pages 中配置的绑定名称
# 通常为 "DB"

# =============================================================================
# 用户管理配置
# =============================================================================

# 管理员用户名 (当使用非 localstorage 存储时)
# 用于创建第一个管理员账户
USERNAME=admin

# 是否开放用户注册
# 可选值: true, false
# 仅在非 localstorage 部署时生效
NEXT_PUBLIC_ENABLE_REGISTER=false

# =============================================================================
# 搜索配置
# =============================================================================

# 搜索接口可拉取的最大页数
# 范围: 1-50
# 建议值: 5-10
NEXT_PUBLIC_SEARCH_MAX_PAGE=5

# =============================================================================
# 代理配置
# =============================================================================

# 默认的浏览器端图片代理
# 用于解决图片跨域问题
# 示例: https://images.weserv.nl/
NEXT_PUBLIC_IMAGE_PROXY=

# 默认的浏览器端豆瓣数据代理
# 用于解决豆瓣 API 跨域问题
# 示例: https://api.allorigins.win/raw?url=
NEXT_PUBLIC_DOUBAN_PROXY=

# =============================================================================
# 开发环境配置
# =============================================================================

# 开发环境标识
# 可选值: development, production, test
NODE_ENV=development

# 调试模式
# 可选值: true, false
DEBUG=false

# 日志级别
# 可选值: error, warn, info, debug
LOG_LEVEL=info

# =============================================================================
# 性能配置
# =============================================================================

# 接口缓存时间 (秒)
# 建议值: 3600-7200 (1-2小时)
CACHE_TIME=7200

# 最大并发请求数
# 建议值: 5-10
MAX_CONCURRENT_REQUESTS=5

# =============================================================================
# 安全配置
# =============================================================================

# 会话超时时间 (毫秒)
# 建议值: 3600000-86400000 (1小时-24小时)
SESSION_TIMEOUT=3600000

# 最大登录尝试次数
# 建议值: 3-5
MAX_LOGIN_ATTEMPTS=3

# 登录锁定时间 (毫秒)
# 建议值: 900000-3600000 (15分钟-1小时)
LOGIN_LOCKOUT_TIME=900000

# =============================================================================
# 第三方服务配置
# =============================================================================

# 豆瓣 API 配置
# 如果需要使用豆瓣官方 API
# DOUBAN_API_KEY=your_douban_api_key
# DOUBAN_API_SECRET=your_douban_api_secret

# 图片存储服务配置
# 如果需要使用云存储服务
# IMAGE_STORAGE_PROVIDER=aws_s3
# AWS_ACCESS_KEY_ID=your_aws_access_key
# AWS_SECRET_ACCESS_KEY=your_aws_secret_key
# AWS_REGION=us-east-1
# AWS_S3_BUCKET=your_bucket_name

# =============================================================================
# 监控和分析配置
# =============================================================================

# 是否启用性能监控
# 可选值: true, false
ENABLE_MONITORING=false

# 是否启用错误追踪
# 可选值: true, false
ENABLE_ERROR_TRACKING=false

# 是否启用用户行为分析
# 可选值: true, false
ENABLE_ANALYTICS=false

# =============================================================================
# 部署环境特定配置
# =============================================================================

# Vercel 部署配置
# VERCEL_URL=your-vercel-url.vercel.app

# Cloudflare Pages 部署配置
# CF_PAGES_URL=your-project.pages.dev

# Docker 部署配置
# DOCKER_IMAGE_TAG=latest
# DOCKER_CONTAINER_NAME=moontv

# =============================================================================
# 注意事项
# =============================================================================

# 1. 请根据实际部署环境修改相应的配置
# 2. 敏感信息（如密码、密钥）请使用环境变量或密钥管理服务
# 3. 生产环境请设置强密码和适当的访问控制
# 4. 定期更新依赖包以修复安全漏洞
# 5. 监控应用性能和错误日志
# 6. 备份重要数据

# =============================================================================
# 配置验证
# =============================================================================

# 启动应用前请确保以下配置正确：
# - PASSWORD 已设置（必填）
# - 如果使用 Redis，REDIS_URL 已正确配置
# - 如果使用 Upstash，UPSTASH_URL 和 UPSTASH_TOKEN 已配置
# - 如果使用 D1，已在 Cloudflare Pages 中配置绑定
# - 其他可选配置根据实际需求设置