4.9 KiB

Raw Blame History

🚀 KatelyaTV 快速开始指南

欢迎使用 KatelyaTV！本指南将帮助您在几分钟内完成部署和配置。

📋 前置要求

Docker (推荐) 或 Node.js 18+
现代浏览器 (Chrome 90+, Firefox 88+, Safari 14+)
稳定的网络连接

🐳 Docker 部署 (推荐)

1. 快速启动

# 拉取最新镜像
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. 停止服务

# 停止容器
docker stop katelyatv

# 删除容器
docker rm katelyatv

🌐 云平台部署

Vercel 部署

Fork 项目
- 点击 GitHub 仓库右上角的 "Fork" 按钮
- 等待 Fork 完成
部署到 Vercel
- 访问 Vercel
- 点击 "New Project"
- 选择 Fork 后的仓库
- 设置环境变量 PASSWORD=your_password
- 点击 "Deploy"
访问应用
- 部署完成后，Vercel 会提供一个域名
- 访问该域名，输入密码即可使用

Cloudflare Pages 部署

Fork 项目
- 同上
部署到 Cloudflare Pages
- 访问 Cloudflare Dashboard
- 进入 "Workers & Pages"
- 点击 "Create application" → "Pages"
- 选择 "Connect to Git"
- 选择 Fork 后的仓库
- 构建命令：pnpm run pages:build
- 构建输出目录：.vercel/output/static
- 环境变量：PASSWORD=your_password
访问应用
- 部署完成后访问提供的域名

⚙️ 基础配置

环境变量

创建 .env.local 文件：

# 复制示例文件
cp .env.example .env.local

# 编辑配置
nano .env.local

必需配置：

PASSWORD=your_secure_password

推荐配置：

SITE_NAME=我的影视站
NEXT_PUBLIC_STORAGE_TYPE=localstorage
NEXT_PUBLIC_SEARCH_MAX_PAGE=10

自定义资源站点

编辑 config.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 存储：

# 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 文件：

:root {
  --primary-color: #3b82f6;
  --secondary-color: #1e40af;
  --background-color: #ffffff;
  --text-color: #1f2937;
}

.dark {
  --background-color: #111827;
  --text-color: #f9fafb;
}

添加新资源站点

在 config.json 中添加：

{
  "api_site": {
    "newsite": {
      "api": "https://newsite.com/api.php/provide/vod",
      "name": "新站点名称"
    }
  }
}

🚨 常见问题

Q: 无法访问应用

A: 检查端口是否被占用，防火墙设置，或尝试其他端口。

Q: 搜索无结果

A: 检查网络连接，资源站点是否可用，或尝试其他关键词。

Q: 视频无法播放

A: 检查视频源是否有效，浏览器是否支持相关格式。

Q: 数据丢失

A: 如果使用 localStorage，数据存储在浏览器中，清除缓存会丢失数据。

📱 移动端使用

支持响应式设计
可安装为 PWA 应用
触摸友好的操作界面

🔒 安全建议

设置强密码：使用复杂密码保护访问
限制访问：不要公开分享访问链接
定期更新：保持应用版本最新
监控日志：关注异常访问记录

📞 获取帮助

📖 完整文档
🐛 问题反馈：在仓库 Issues 页面提交
💬 功能讨论：在 Discussions 页面参与
📝 更新日志

🎉 开始使用

现在您已经完成了基础配置，可以开始享受 KatelyaTV 带来的影视体验了！

重要提醒：

本项目仅供学习和个人使用
请遵守当地法律法规
不要用于商业用途或公开服务

如有任何问题，欢迎在 GitHub 上提出 Issue 或参与讨论！

4.9 KiB Raw Blame History Unescape Escape