diff --git a/QUICKSTART.md b/QUICKSTART.md deleted file mode 100644 index 30ae7e4..0000000 --- a/QUICKSTART.md +++ /dev/null @@ -1,249 +0,0 @@ -# 🚀 KatelyaTV 快速开始指南 - -欢迎使用 KatelyaTV！本指南将帮助您在几分钟内完成部署和配置。 - -## 📋 前置要求 - -- **Docker** (推荐) 或 **Node.js 18+** -- 现代浏览器 (Chrome 90+, Firefox 88+, Safari 14+) -- 稳定的网络连接 - -## 🐳 Docker 部署 (推荐) - -### 1. 快速启动 - -```bash -# 拉取最新镜像 -docker pull ghcr.io/katelya77/katelyatv:latest - -# 启动容器 -docker run -d \ - --name katelyatv \ - -p 3000:3000 \ - --env PASSWORD=your_password \ - --restart unless-stopped \ - ghcr.io/katelya77/katelyatv:latest -``` - -### 2. 访问应用 - -打开浏览器访问 `http://localhost:3000`，输入密码 `your_password` 即可使用。 - -### 3. 停止服务 - -```bash -# 停止容器 -docker stop katelyatv - -# 删除容器 -docker rm katelyatv -``` - -## 🌐 云平台部署 - -### Vercel 部署 - -1. **Fork 项目** - - 点击 GitHub 仓库右上角的 "Fork" 按钮 - - 等待 Fork 完成 - -2. **部署到 Vercel** - - 访问 [Vercel](https://vercel.com/) - - 点击 "New Project" - - 选择 Fork 后的仓库 - - 设置环境变量 `PASSWORD=your_password` - - 点击 "Deploy" - -3. **访问应用** - - 部署完成后，Vercel 会提供一个域名 - - 访问该域名，输入密码即可使用 - -### Cloudflare Pages 部署 - -1. **Fork 项目** - - 同上 - -2. **部署到 Cloudflare Pages** - - 访问 [Cloudflare Dashboard](https://dash.cloudflare.com/) - - 进入 "Workers & Pages" - - 点击 "Create application" → "Pages" - - 选择 "Connect to Git" - - 选择 Fork 后的仓库 - - 构建命令：`pnpm run pages:build` - - 构建输出目录：`.vercel/output/static` - - 环境变量：`PASSWORD=your_password` - -3. **访问应用** - - 部署完成后访问提供的域名 - -## ⚙️ 基础配置 - -### 环境变量 - -创建 `.env.local` 文件： - -```bash -# 复制示例文件 -cp .env.example .env.local - -# 编辑配置 -nano .env.local -``` - -**必需配置：** - -```bash -PASSWORD=your_secure_password -``` - -**推荐配置：** - -```bash -SITE_NAME=我的影视站 -NEXT_PUBLIC_STORAGE_TYPE=localstorage -NEXT_PUBLIC_SEARCH_MAX_PAGE=10 -``` - -### 自定义资源站点 - -编辑 `config.json` 文件： - -```json -{ - "cache_time": 7200, - "api_site": { - "dyttzy": { - "api": "http://caiji.dyttzyapi.com/api.php/provide/vod", - "name": "电影天堂资源", - "detail": "http://caiji.dyttzyapi.com" - } - } -} -``` - -## 🎯 核心功能使用 - -### 1. 搜索影视 - -- 在首页搜索框输入影视名称 -- 支持中文、英文、拼音搜索 -- 结果来自多个资源站点 - -### 2. 观看视频 - -- 点击搜索结果进入详情页 -- 选择播放源和剧集 -- 支持进度记录和断点续播 - -### 3. 收藏管理 - -- 点击心形图标收藏影视 -- 在"我的收藏"中查看 -- 支持多设备同步 - -### 4. 观看历史 - -- 自动记录观看进度 -- 在"继续观看"中查看 -- 支持从上次位置继续 - -## 🔧 高级配置 - -### 多用户支持 - -如需支持多用户，请配置 Redis 或 D1 存储： - -```bash -# Redis 配置 -NEXT_PUBLIC_STORAGE_TYPE=redis -REDIS_URL=redis://localhost:6379/0 - -# 或 D1 配置 (Cloudflare Pages) -NEXT_PUBLIC_STORAGE_TYPE=d1 -# 在 Cloudflare Pages 中绑定 D1 数据库 -``` - -### 自定义主题 - -修改 `src/styles/globals.css` 文件： - -```css -:root { - --primary-color: #3b82f6; - --secondary-color: #1e40af; - --background-color: #ffffff; - --text-color: #1f2937; -} - -.dark { - --background-color: #111827; - --text-color: #f9fafb; -} -``` - -### 添加新资源站点 - -在 `config.json` 中添加： - -```json -{ - "api_site": { - "newsite": { - "api": "https://newsite.com/api.php/provide/vod", - "name": "新站点名称" - } - } -} -``` - -## 🚨 常见问题 - -### Q: 无法访问应用 - -**A:** 检查端口是否被占用，防火墙设置，或尝试其他端口。 - -### Q: 搜索无结果 - -**A:** 检查网络连接，资源站点是否可用，或尝试其他关键词。 - -### Q: 视频无法播放 - -**A:** 检查视频源是否有效，浏览器是否支持相关格式。 - -### Q: 数据丢失 - -**A:** 如果使用 localStorage，数据存储在浏览器中，清除缓存会丢失数据。 - -## 📱 移动端使用 - -- 支持响应式设计 -- 可安装为 PWA 应用 -- 触摸友好的操作界面 - -## 🔒 安全建议 - -1. **设置强密码**：使用复杂密码保护访问 -2. **限制访问**：不要公开分享访问链接 -3. **定期更新**：保持应用版本最新 -4. **监控日志**：关注异常访问记录 - -## 📞 获取帮助 - -- 📖 [完整文档](README.md) -- 🐛 问题反馈：在仓库 Issues 页面提交 -- 💬 功能讨论：在 Discussions 页面参与 -- 📝 [更新日志](CHANGELOG.md) - -## 🎉 开始使用 - -现在您已经完成了基础配置，可以开始享受 KatelyaTV 带来的影视体验了！ - -**重要提醒：** - -- 本项目仅供学习和个人使用 -- 请遵守当地法律法规 -- 不要用于商业用途或公开服务 - ---- - -如有任何问题，欢迎在 GitHub 上提出 Issue 或参与讨论！