本文将带你一步步搭建一个属于自己的免费影视聚合网站,基于开源项目 KatelyaTV,并使用 Vercel 进行免费部署。
视频教程:
一、项目简介
KatelyaTV 是一款由开发者 @katelya77 开源的,基于Moon tv 二次开发的个人影视聚合项目,采用 Next.js + Vercel 构建,前端简洁、功能齐全,可自由配置资源站 API,实现在线播放、收藏、搜索等功能。
项目特点:
- 🌐 全前端架构:无需后端服务器,Vercel 即可托管。
 - 🔐 支持登录与权限管理(管理员密码或 Upstash 多用户同步)。
 - 📺 多资源站聚合:自由配置多个影视源。
 - 🎨 自适应 UI:完美兼容手机与电脑。
 - 🚀 永久免费:Vercel + Upstash 方案均有免费额度。
 
项目地址:https://github.com/katelya77/KatelyaTV
二、准备工作
在开始部署之前,请准备以下内容:
- GitHub 账号:用于 Fork 仓库。
 - Vercel 账号:可直接使用 GitHub 登录。
 - (可选)Upstash Redis:如果你希望多用户登录、收藏同步。
 - (可选)自定义域名:Vercel 会赠送免费子域名,也可绑定自己的域名。
 
三、部署步骤
1. Fork 仓库
前往项目地址 👉 https://github.com/katelya77/KatelyaTV,点击右上角 Fork。
这会将项目复制到你的 GitHub 账号下。
2. 在 Vercel 上导入项目
- 登录 Vercel
 - 点击 “New Project” → “Import Git Repository”
 - 选择刚才 Fork 的 KatelyaTV 仓库
 
🔧 环境变量说明
1. ADMIN_USER
用途:设置管理员用户名,用于后台登录。
示例:
USERNAME=admin
2. ADMIN_PASSWORD
用途:设置管理员登录密码。
示例:
AUTH_PASSWORD=your password
⚠️ 建议使用复杂密码,避免弱口令。
3. NEXT_PUBLIC_STORAGE_TYPE
用途:指定数据存储方式,可选以下两种:
localstorage:仅在本地浏览器保存数据,不依赖云端。upstash:启用 Upstash 云端数据库,实现数据同步。
示例:
NEXT_PUBLIC_STORAGE_TYPE=upstash
4. UPSTASH_URL
用途:当使用 upstash 存储时,填写 Upstash 提供的数据库 URL。
示例:
UPSTASH_URL=https://example.upstash.io
5. UPSTASH_TOKEN
用途:当使用 upstash 存储时,填写 Upstash 访问令牌,用于授权访问数据库。
示例:
UPSTASH_TOKEN=abcd1234exampletoken
6. NEXT_PUBLIC_ENABLE_REGISTER
用途:控制是否开放用户注册功能。
true:允许用户自行注册。false(或留空):仅管理员可使用系统。
示例:
NEXT_PUBLIC_ENABLE_REGISTER=true
变更vercel项目和地区:改为与你地理较近的,比如亚洲,然后重新部署
四、配置影视资源站 API
因为 KatelyaTV 默认不带内置视频源,你必须自行添加资源站接口,否则首页将为空白。
作者在项目中提供了可直接上传的资源站 API,下载地址:
五、管理后台
当网站成功部署后,在浏览器地址栏输入:
https://你的域名/admin
输入你设置的用户名与密码即可登录后台。
在后台中,你可以:
- 在线修改 config.json 文件;
 - 管理用户注册与登录;
 - 查看收藏与观看记录;
 
所有更改都会自动保存,并触发 Vercel 更新。
六、总结
至此,你已经成功使用 KatelyaTV + Vercel 免费搭建了一个属于自己的影视聚合网站。
整个流程无需服务器,无需备案,只需几分钟即可上线运行。