《用 Vercel 免费搭建个人影视站 — KatelyaTV 详细教程》

本文将带你一步步搭建一个属于自己的免费影视聚合网站,基于开源项目 KatelyaTV,并使用 Vercel 进行免费部署。

视频教程:

一、项目简介

KatelyaTV 是一款由开发者 @katelya77 开源的,基于Moon tv 二次开发的个人影视聚合项目,采用 Next.js + Vercel 构建,前端简洁、功能齐全,可自由配置资源站 API,实现在线播放、收藏、搜索等功能。

项目特点:

  • 🌐 全前端架构:无需后端服务器,Vercel 即可托管。
  • 🔐 支持登录与权限管理(管理员密码或 Upstash 多用户同步)。
  • 📺 多资源站聚合:自由配置多个影视源。
  • 🎨 自适应 UI:完美兼容手机与电脑。
  • 🚀 永久免费:Vercel + Upstash 方案均有免费额度。

项目地址:https://github.com/katelya77/KatelyaTV

二、准备工作

在开始部署之前,请准备以下内容:

  1. GitHub 账号:用于 Fork 仓库。
  2. Vercel 账号:可直接使用 GitHub 登录。
  3. (可选)Upstash Redis:如果你希望多用户登录、收藏同步。
  4. (可选)自定义域名:Vercel 会赠送免费子域名,也可绑定自己的域名。

三、部署步骤

1. Fork 仓库

前往项目地址 👉 https://github.com/katelya77/KatelyaTV,点击右上角 Fork
这会将项目复制到你的 GitHub 账号下。

2. 在 Vercel 上导入项目

  1. 登录 Vercel
  2. 点击 “New Project” → “Import Git Repository”
  3. 选择刚才 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,下载地址:

基础版 config_isadult.json

Plus 版(94 个片源)

五、管理后台

当网站成功部署后,在浏览器地址栏输入:

https://你的域名/admin

输入你设置的用户名与密码即可登录后台。

在后台中,你可以:

  • 在线修改 config.json 文件;
  • 管理用户注册与登录;
  • 查看收藏与观看记录;

所有更改都会自动保存,并触发 Vercel 更新。

六、总结

至此,你已经成功使用 KatelyaTV + Vercel 免费搭建了一个属于自己的影视聚合网站。
整个流程无需服务器,无需备案,只需几分钟即可上线运行。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注