LunaTV 配置订阅教程：填入一个 URL，播放源自动同步
【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议，禁止任何商业化行为，任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV
播放源从此不用手动改了。LunaTV 的配置订阅功能只多一个输入框：把别人分享的订阅 URL 粘进去，点两下，整套播放源配置就同步到了你的实例。读完本文，你能独立完成第一次配置订阅：拉取、保存，并确认它真的生效。
📖 一句话理解 LunaTV 配置订阅
把它想成订报纸。你不用自己找报童，只要给 LunaTV 一个固定地址（订阅 URL），它就去取最新一期的内容。其他站长维护好播放源配置后，把配置文件做 Base58 编码、挂到一个可公开访问的网址上，这个网址就可以被订阅。订阅成功后，你的播放源就和对方保持同步，对方更新、你这边跟着更新。
✅ 动手前的检查
- 用站长账号登录（即环境变量
USERNAME对应的那个账号）。"配置文件"页签和配置订阅入口只对站长显示，普通用户账号看不到。 - 存储方式不能是 localstorage。管理端配置依赖 redis、kvrocks 或 upstash 这类持久存储。
- 手里有一个订阅 URL。用浏览器打开它，看到的应该是一长串字母数字（Base58 编码文本），而不是明文 JSON。
- 顺手备份当前配置：进"配置文件"页签，把编辑框里的内容复制存一份，拉取失败时还能改回去。
🚀 跑通第一次配置订阅
- 用站长账号打开管理后台（
/admin），点击顶部的"配置文件"页签。会出现"配置订阅"卡片，包含订阅 URL 输入框、"拉取配置"按钮、自动更新开关，卡片右上角显示"最后更新"时间。 - 把订阅 URL 粘进输入框。
- 点"拉取配置"。预期看到"配置拉取成功"的提示，下方配置文件编辑框自动填入一份 JSON，"最后更新"变成当前时间。
- 扫一眼编辑框内容没有明显异常，点右下角"保存"。预期看到"配置文件保存成功"。
到这里，最小闭环就走完了：URL 进，配置出，落库完成。整个过程大约 3 次点击。
🔍 确认配置订阅生效
给你两个判据，自己验证：
- 回管理后台看"最后更新"：手动拉取保存后，它应显示刚才的时间戳；开启自动更新后，隔一段时间再看它是否被定时任务刷新过。
- 实际播放验证：在搜索框搜一部片子，进详情页看"换源"列表，应能看到新拉来的源；随便放第一集，能出声就算通过。
🛠️ 用得不顺手时看这里
提示"权限不足，只有站长可以拉取配置订阅"原因：当前登录的不是站长账号。解法：退出，改用USERNAME对应的站长账号登录再试。
"拉取配置失败"或"Base58 解码失败"原因：URL 不可访问，或链接返回的不是 Base58 编码文本。解法：用浏览器直接打开该 URL，确认能访问且返回一长串字母数字；如果返回的是明文 JSON，说明对方没按规范编码，需要联系对方换一个地址。
保存时报"不支持本地存储进行管理员配置"原因：NEXT_PUBLIC_STORAGE_TYPE设成了 localstorage。解法：改用 redis、kvrocks 或 upstash 存储，重新部署后再操作。
自动更新开着，但"最后更新"一直是旧时间原因：自动更新依赖平台侧的定时任务触发，没配置 cron 时不会跑。解法：先用"拉取配置"手动同步；在 Vercel 等平台部署时，按文档配置好定时触发器，再依赖自动更新。
➕ 可选：再进一步
自建订阅源（可选）：把自己实例的配置文件整体做 Base58 编码，放到任意可公开访问的 HTTP 地址，这个地址就能分享给其他站长订阅。字段说明见 README 的配置文件与订阅章节。注意界面目前只支持单个订阅 URL，一次订阅一个地址。
了解自动更新怎么跑（可选）：定时任务每次会刷新订阅配置和直播源，实现见 自动更新定时任务；手动拉取时的 Base58 解码逻辑在 配置订阅拉取接口。
配置订阅把"找源、改配置、验证"三件事压缩成"粘贴、拉取、保存"。想继续往下，可以看 README 的配置文件说明 了解api_site、custom_category每个字段的作用，让播放源自动更新的同时，把分类也调得更顺手。
【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议，禁止任何商业化行为，任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
