LunaTV 播放源配置完全指南3 步完成配置订阅从零到自动更新【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV新部署的 LunaTV 打开首页是一片空白——没片、没剧、没直播。这篇带你把 LunaTV 的配置订阅功能走通从粘贴订阅链接拉取播放源到开启自动更新。照做一遍10 分钟内站点有片可看配置还能自己保鲜。 准备工作动手前先核对这 4 项开始前把下面 4 项逐一过一遍能避开后面 80% 的报错。存储类型不是 localstorage。NEXT_PUBLIC_STORAGE_TYPE需为kvrocks、redis或upstash之一。怎么确认在管理后台随便保存一次配置若弹出不支持本地存储进行管理员配置说明还在 localstorage。登录的是站长账号。即部署时USERNAME环境变量设定的那个账号。怎么确认登录后管理后台能看到配置文件相关入口该入口只对站长展示。手上有一个订阅链接。访问后返回 Base58 编码内容的 URL。怎么确认浏览器直接打开该地址看到的应该是一长串字母而不是 JSON 明文。能进管理后台。怎么确认页面里能看到配置订阅这张卡片。⚡ 最小路径3 步完成订阅配置第 1 步贴链接一键拉取。打开管理后台找到配置订阅区域前端组件在 src/app/admin/page.tsx。把订阅地址贴进订阅URL输入框点下方绿色的拉取配置按钮。后端会替你访问该地址、解码 Base58 并返回配置明文。成功标志提示配置拉取成功页面下方的配置文件文本框自动填入一段完整 JSON卡片右上角的最后更新变成当前时间。第 2 步内容扫一眼。别急着保存。花十秒钟看两点api_site列表不为空JSON 首尾括号成对。这里展示的是解码后的明文缺什么一目了然。成功标志文本框内容通读下来字段齐全、没有截断。第 3 步保存生效。点保存。后端落库前会再跑一次JSON.parse校验保存接口在 src/app/api/admin/config_file/route.ts。成功标志提示配置文件保存成功打开播放页右侧换源面板出现多个可选播放源首页不再空白。只想快速体验的话可以跳过第 1 步直接在文本框里手写 JSON 再保存两种方式走的是同一个保存接口。 配置字典拿到 JSON 先看这 4 个字段无论订阅拉取还是手动填写最后都落到一份 JSON 上。核心字段记住 4 个就够字段含义注意点cache_time接口缓存时长秒默认 7200越大对资源站的请求越省api_site影视源列表以站点 key 为键每站含apiJSON API 地址、name显示名、detail可选详情页根 URLcustom_category自定义分类靠typemovie/tvquery定位会在影视页生成对应的筛选入口lives直播源列表以直播源 key 为键每项含name、urlm3u 地址ua与epg可选最小可用示例{ cache_time: 7200, api_site: { demo: { api: http://example.com/api.php/provide/vod, name: 示例资源 } } }人话解释这是最薄的一份配置一个播放源就能让首页有片可看。还有两句话要说清。其一api_site里的api必须符合苹果 CMS V10 标准接口格式否则资源站查不出数据key 建议只用小写字母和数字特殊字符容易在解析时翻车。其二lives和custom_category都是可选字段配了直播源直播页才有频道配了自定义分类影视页才多出筛选入口。 进阶玩法自动更新怎么开手动源怎么共存玩法一自动更新。配置订阅卡片底部有一个自动更新开关。打开后定时任务src/app/api/cron/route.ts会周期性访问订阅地址拉内容 → Base58 解码 → 校验 JSON → 写回配置文件并刷新最后检查时间。适合播放源地址三天两头换的站点或者多人协作维护配置的场景——站长改一次订阅文件所有实例跟着变。生效的联动条件有三个缺一不可① 订阅 URL 已填写② 自动更新开关为开③ 以上状态已点过保存落库开关状态不会自动上报。缺任何一条定时任务只会打印跳过刷新然后跳过。不放心自动变更的话替代做法是保持开关关闭需要时手动点拉取每次变更都经人工确认。玩法二双源合并。从配置文件引入的源会被标记from: config手动添加的标记from: custom合并逻辑在 src/lib/config.ts 里两者共存、互不覆盖。适合订阅打底 自留几个私有源的站长想让订阅成为唯一标准就干脆别手动加源。 排错指南5 个高频报错对号入座按报错原文找小节三段式现象 → 原因 → 解法。报错①权限不足只有站长可以拉取配置订阅现象点拉取配置后弹出该 401 提示。原因当前登录账号与USERNAME环境变量不一致。拉取和保存两个接口都只对站长开放校验逻辑在 src/app/api/admin/config_subscription/fetch/route.ts普通管理员账号也不行。解法换回部署时设置的站长账号重新登录。报错②不支持本地存储进行管理员配置现象点保存时出现 400 提示。原因NEXT_PUBLIC_STORAGE_TYPE仍是默认的localstorage管理配置拒绝写入浏览器本地存储。解法把存储类型换成kvrocks、redis或upstash重启服务。报错③拉取配置失败现象前端只提示笼统的拉取失败服务器日志里有 Base58 解码失败 告警。原因订阅地址返回的不是合法 Base58 内容。最常见是站长上传了原始 JSON 忘了编码或托管服务对文件做了二次处理补换行、转码。解法直接打开订阅地址确认返回的是编码后的字符串用 Base58 工具本地重新编码后再上传。报错④配置文件格式错误请检查 JSON 语法现象拉取成功但保存环节报错。原因解码没问题内容却不是合法 JSON——多半是多写逗号、少括号或混进了注释JSON 不支持注释。解法把内容贴进任意 JSON 校验工具修好再重新编码上传。报错⑤请输入订阅URL 或 配置文件内容不能为空现象前端校验提示请求根本没发出去。原因URL 输入框是空的或配置文件文本框为空、内容被截断。解法把地址填完整保存前确认文本框内容完整无截断。️ 边界与收尾分享订阅链接前要知道的 4 件事权限收口拉取、保存接口都校验登录身份且要求与USERNAME一致普通用户拿到后台地址也改不了配置。双重校验前端解码后即提示格式错误后端保存时再跑一次JSON.parse两道关卡挡住脏数据入库。协议边界项目采用 CC BY-NC-SA 协议禁止任何商业化使用衍生项目必须保留本项目地址并以相同协议开源。分享风险订阅链接背后是你站点的完整配置结构别把它和站点地址一起发到社交平台泄露等于亮出家底。用一条链路串起全文JSON 配置文件 → Base58 编码 → 托管成订阅链接 → 后台拉取解码 → 双重校验保存 →可选定时自动更新动手前两条建议先备份把当前配置文件文本框内容复制一份存好切换新订阅后发现源缺失可以立即还原。先实测新配置生效后真放一部电影、一条直播确认源可用再通知用户。字段细节与环境变量说明以项目 README 及官方文档为准。【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
