katelya
227 lines
4.6 KiB
Markdown
227 lines
4.6 KiB
Markdown
# 🚀 部署兼容性说明
|
||
|
||
## 跳过片头片尾功能部署兼容性
|
||
|
||
我们的跳过片头片尾功能已经完全兼容各种部署方式，具体如下：
|
||
|
||
## 📋 功能概述
|
||
|
||
- ✅ **自动跳过片头片尾** - 智能检测并跳过重复内容
|
||
- ✅ **手动配置跳过段** - 用户可自定义跳过时间段
|
||
- ✅ **多剧集支持** - 每个剧集独立配置
|
||
- ✅ **多存储后端** - 支持 LocalStorage、Redis、D1、Upstash
|
||
|
||
## 🌐 部署方式兼容性
|
||
|
||
### 1. Cloudflare Pages ✅
|
||
|
||
**Runtime**: Edge Runtime
|
||
**配置要求**: 所有 API 路由必须使用 `export const runtime = 'edge';`
|
||
|
||
```typescript
|
||
// ✅ 已正确配置
|
||
export const runtime = 'edge';
|
||
```
|
||
|
||
**特性支持**:
|
||
|
||
- ✅ 跳过配置 API (`/api/skip-configs`)
|
||
- ✅ 所有存储后端（D1、Redis、Upstash）
|
||
- ✅ 自动缓存优化
|
||
|
||
### 2. Docker 部署 ✅
|
||
|
||
**Runtime**: Node.js Runtime (自动转换)
|
||
**自动转换**: Dockerfile 会自动将 Edge Runtime 转换为 Node.js Runtime
|
||
|
||
```dockerfile
|
||
# Dockerfile 中的自动转换逻辑
|
||
RUN find ./src -type f -name "route.ts" -print0 \
|
||
| xargs -0 sed -i "s/export const runtime = 'edge';/export const runtime = 'nodejs';/g"
|
||
```
|
||
|
||
**特性支持**:
|
||
|
||
- ✅ 跳过配置 API
|
||
- ✅ 所有存储后端
|
||
- ✅ 环境变量配置
|
||
- ✅ 健康检查
|
||
|
||
### 3. Vercel 部署 ✅
|
||
|
||
**Runtime**: Edge Runtime / Node.js Runtime (自动检测)
|
||
**配置**: 无需特殊配置，自动适配
|
||
|
||
**特性支持**:
|
||
|
||
- ✅ 跳过配置 API
|
||
- ✅ 所有存储后端
|
||
- ✅ Serverless 函数优化
|
||
|
||
### 4. 其他部署方式 ✅
|
||
|
||
**Runtime**: Node.js Runtime
|
||
**要求**: Node.js 18+ 环境
|
||
|
||
**支持的部署方式**:
|
||
|
||
- ✅ 传统服务器部署
|
||
- ✅ PM2 进程管理
|
||
- ✅ Nginx 反向代理
|
||
- ✅ Kubernetes
|
||
- ✅ Railway、Render 等云平台
|
||
|
||
## 🗄️ 存储后端支持
|
||
|
||
### LocalStorage (默认)
|
||
|
||
```bash
|
||
# 无需额外配置，适用于单机部署
|
||
NEXT_PUBLIC_STORAGE_TYPE=localstorage
|
||
```
|
||
|
||
### Redis
|
||
|
||
```bash
|
||
# 高性能缓存存储
|
||
NEXT_PUBLIC_STORAGE_TYPE=redis
|
||
REDIS_URL=redis://localhost:6379
|
||
```
|
||
|
||
### Cloudflare D1
|
||
|
||
```bash
|
||
# Cloudflare 原生数据库
|
||
NEXT_PUBLIC_STORAGE_TYPE=d1
|
||
```
|
||
|
||
### Upstash Redis
|
||
|
||
```bash
|
||
# 无服务器 Redis
|
||
NEXT_PUBLIC_STORAGE_TYPE=upstash
|
||
UPSTASH_REDIS_REST_URL=https://xxx.upstash.io
|
||
UPSTASH_REDIS_REST_TOKEN=xxx
|
||
```
|
||
|
||
## 🔧 环境变量配置
|
||
|
||
### 核心配置
|
||
|
||
```bash
|
||
# 存储类型 (必需)
|
||
NEXT_PUBLIC_STORAGE_TYPE=localstorage|redis|d1|upstash
|
||
|
||
# Docker 环境标识 (Docker 部署时自动设置)
|
||
DOCKER_ENV=true
|
||
```
|
||
|
||
### 存储特定配置
|
||
|
||
```bash
|
||
# Redis
|
||
REDIS_URL=redis://localhost:6379
|
||
REDIS_PASSWORD=optional
|
||
|
||
# Upstash
|
||
UPSTASH_REDIS_REST_URL=https://xxx.upstash.io
|
||
UPSTASH_REDIS_REST_TOKEN=xxx
|
||
|
||
# D1 (Cloudflare 自动注入)
|
||
# 无需手动配置
|
||
```
|
||
|
||
## 🚀 快速部署指南
|
||
|
||
### Cloudflare Pages
|
||
|
||
1. 连接 GitHub 仓库
|
||
2. 设置构建命令: `npm run build`
|
||
3. 设置输出目录: `.next`
|
||
4. 配置环境变量 (可选)
|
||
|
||
### Docker
|
||
|
||
```bash
|
||
# 构建镜像
|
||
docker build -t katelyatv .
|
||
|
||
# 运行容器
|
||
docker run -p 3000:3000 \
|
||
-e NEXT_PUBLIC_STORAGE_TYPE=localstorage \
|
||
katelyatv
|
||
```
|
||
|
||
### Vercel
|
||
|
||
```bash
|
||
# 一键部署
|
||
npx vercel
|
||
|
||
# 或使用 Vercel CLI
|
||
vercel --prod
|
||
```
|
||
|
||
## 🧪 兼容性测试
|
||
|
||
运行兼容性测试脚本：
|
||
|
||
```bash
|
||
# 测试所有部署方式的兼容性
|
||
node scripts/test-docker-compatibility.js
|
||
```
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **Edge Runtime 限制**: 在 Cloudflare Pages 上，所有 API 路由必须使用 Edge Runtime
|
||
2. **存储选择**: 根据部署环境选择合适的存储后端
|
||
3. **环境变量**: 确保在生产环境中正确配置存储相关环境变量
|
||
4. **缓存策略**: LocalStorage 仅适用于单机部署，集群部署请使用 Redis
|
||
|
||
## 📊 性能建议
|
||
|
||
### 小型部署 (< 1000 用户)
|
||
|
||
- **推荐**: LocalStorage
|
||
- **优点**: 零配置，性能良好
|
||
- **缺点**: 仅支持单机
|
||
|
||
### 中型部署 (1000-10000 用户)
|
||
|
||
- **推荐**: Redis
|
||
- **优点**: 高性能，支持集群
|
||
- **缺点**: 需要 Redis 服务器
|
||
|
||
### 大型部署 (> 10000 用户)
|
||
|
||
- **推荐**: Cloudflare D1 + Redis 缓存
|
||
- **优点**: 高可用，全球分布
|
||
- **缺点**: 依赖 Cloudflare
|
||
|
||
## 🆘 故障排除
|
||
|
||
### 常见问题
|
||
|
||
1. **API 路由 404**
|
||
|
||
- 检查 Edge Runtime 配置
|
||
- 确认部署环境支持
|
||
|
||
2. **跳过配置保存失败**
|
||
|
||
- 检查存储后端配置
|
||
- 验证环境变量设置
|
||
|
||
3. **Docker 构建失败**
|
||
|
||
- 确认 Node.js 版本 ≥ 18
|
||
- 检查 pnpm 安装
|
||
|
||
4. **Cloudflare Pages 部署失败**
|
||
- 确认所有 API 路由有 Edge Runtime 配置
|
||
- 检查构建命令和输出目录
|
||
|
||
---
|
||
|
||
🎉 **恭喜！** 您的跳过片头片尾功能已完全兼容所有主流部署方式！
|