LunaTV 配置订阅教程：填好订阅 URL，播放源自动同步
【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议，禁止任何商业化行为，任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV
你刚部署的 LunaTV 只有几个默认播放源，换源得手写 JSON。把别人分享好的 LunaTV 配置订阅地址填进管理后台，源更新后不用再手动改文件，全程约 3 分钟。
快速开始
- 用站长账号登录你的实例，打开管理后台，切到"配置文件"标签页。
- 在"配置订阅"卡片的"订阅URL"输入框里贴入订阅地址，点"拉取配置"。
- 确认下方编辑框出现解码后的 JSON，点"保存"，顺手打开"自动更新"开关。
逐步操作
第一步：用站长账号登录
操作：访问你的实例，用环境变量USERNAME对应的那个账号登录，进入/admin管理后台。
预期反馈：侧边栏能展开菜单，"配置文件"标签页正常加载。
如果不对：提示"权限不足，只有站长可以拉取配置订阅"，说明当前账号不是站长。拉取和保存两个接口都只放行USERNAME那一个账号，换站长账号重试。
第二步：拉取订阅配置
操作：在"订阅URL"输入框贴入地址，点"拉取配置"。💡 地址要求：用浏览器直接打开它，看到的应是Lk3qX...这类字母数字串（Base58 编码后的纯文本，即把配置 JSON 加密式编码成一段短字符串）。
预期反馈：页面弹出"配置拉取成功"，解码后的 JSON 自动回填到下方配置编辑框。
如果不对：提示"拉取配置失败"，通常是 URL 打不开，或对方直接返回了{ "SourceConfig": ... }明文 JSON（没做 Base58 编码）。后一种情况换地址，或让对方重新编码后分享。
第三步：保存并打开自动更新
操作：扫一眼编辑框内容，打开"自动更新"开关，点"保存"。
预期反馈：提示"配置文件保存成功"，卡片右上角"最后更新"时间刷新。整份配置覆盖本地内容，含SourceConfig播放源、CustomCategories自定义分类、LiveConfig直播源等字段，前台搜索和播放立即生效，无需重启。
如果不对：
- 提示"配置文件格式错误，请检查 JSON 语法"：服务端保存前用
JSON.parse校验，拉下来或手改过的 JSON 有语法问题，对照修复再保存。 - 提示"不支持本地存储进行管理员配置"：你的存储类型是
localstorage，保存接口不支持，需换成 Upstash、Redis、KV 等非本地存储后再试。
幕后原理
拉取时，页面请求订阅拉取接口，服务端fetch订阅地址、对返回文本做 Base58 解码，把结果交回前端回填；保存走配置文件管理接口，一次性写入配置内容、订阅地址、自动更新开关和最后检查时间。详见 拉取接口实现 与 保存接口实现。
自动更新由定时任务驱动：触发时检查"地址已填且开关打开"，执行同样的"拉取 → 解码 → 校验 JSON → 覆盖保存"流程，任何一步失败只写日志，不动现有配置。定时频率由部署平台决定，Vercel 下在 vercel.json 配置为每天 01:00 执行一次/api/cron。字段含义可对照 AdminConfig 类型定义。
进阶用法
想把自己整理的源分享给别人？把配置 JSON 编码后放到公网可访问的地址再分享即可，编码逻辑就一行：
const bs58 = require('bs58'); const encoded = bs58.encode(Buffer.from(JSON.stringify(config)));多台实例如何保持同一份配置？同一个地址填到每台实例的"配置订阅"卡片就行。各实例独立保存，没有中心节点。
嫌"每天一次"不够频繁？想立刻刷新，直接对/api/cron发一次 GET 请求即可手动触发一轮刷新（定义在 定时任务实现）。系统开关本身只有"开 / 关"两档，改频率要调整部署平台的定时设置。
避坑清单
| 现象 | 原因 | 处理 |
|---|---|---|
| 拉取提示"拉取配置失败" | 对方返回明文 JSON 或地址失效 | 换地址重试 |
| 提示"权限不足，只有站长可以拉取配置订阅" | 当前账号不是USERNAME指定的站长 | 换站长账号登录 |
| 保存提示"配置文件格式错误" | JSON 语法有错 | 修正后再保存 |
| 保存提示"不支持本地存储进行管理员配置" | 存储类型为localstorage | 换成 Upstash、Redis、KV 等存储 |
| 自动更新开了，"最后更新"却不动 | 定时任务没触发，或拉取、解码、校验静默失败 | 手动拉取一次，验证地址仍有效 |
延伸资源
- 配置文件保存接口：保存时校验了哪些字段、写入了哪些内容。
- 定时任务实现：自动更新的完整逻辑，以及手动触发方式。
- AdminConfig 类型定义：
SourceConfig、CustomCategories、LiveConfig各字段的含义。 - vercel.json：Vercel 环境下定时任务的触发时间配置。
- README：部署方式和环境变量（
USERNAME、NEXT_PUBLIC_STORAGE_TYPE）说明。
【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议，禁止任何商业化行为，任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
