Delete QUICKSTART.md
Katelya
GitHub
parent
dfc6098913
commit
1134b3a9ad
249
QUICKSTART.md
249
QUICKSTART.md
|
|
@ -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 或参与讨论！
|
||||
Loading…
Reference in New Issue