LunaTV3步跑通配置订阅从粘贴地址到自动同步播放源【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV当你第一次打开 LunaTV 管理后台的配置文件模块订阅 URL 输入框是空的右上角写着最后更新: 从未更新。之后每发现一个可用的资源站都要手动下载 JSON、核对格式、再贴回面板。LunaTV 的配置订阅功能就是为这个环节准备的站长把一段 Base58 编码的订阅地址粘进面板实例就能持续拉取最新的播放源配置多个实例之间也能长期保持同一套资源。功能定位配置订阅位于管理后台的配置文件模块面向站长角色。它把下载文件、本地编辑 JSON、再提交的流程替换为服务端直接访问订阅地址、解码 Base58 内容并写入本地配置手动改文件这一步被整体去掉。⚙️ 前置条件已部署并可访问的 LunaTV 实例持有站长账号环境变量 USERNAME存储方式非 localstorageredis / kvrocks / upstash已拿到 Base58 编码的订阅地址 操作主线登录管理后台用站长账号登录实例进入管理后台在左侧菜单切到配置文件模块。页面顶部就是配置订阅卡片包含订阅 URL 输入框、拉取配置按钮和自动更新开关三个元素右上角显示上次同步时间首次使用前显示从未更新。填入订阅地址并拉取配置把拿到的订阅地址粘贴到订阅URL输入框注意地址内容必须是 Base58 编码、解码后为 JSON。点击拉取配置按钮前端请求/api/admin/config_subscription/fetch完成解码成功后弹出配置拉取成功提示解码出的配置内容会回填到下方的编辑器区域。保存配置并开启自动更新打开自动更新开关再点保存。后端会校验 JSON 格式把订阅地址和开关写入ConfigSubscribtion配置返回配置文件更新成功。此后每次 cron 任务执行时系统都会自动重新拉取订阅并刷新最后检查时间逻辑在 src/app/api/cron/route.ts 中。配置解读配置项作用推荐值/说明ConfigSubscribtion.URLBase58 编码的订阅地址必填解码失败时拉取与自动更新都会中断ConfigSubscribtion.AutoUpdate是否由 cron 自动拉取建议 true为 false 时每次都要手动点拉取配置ConfigSubscribtion.LastCheck上次成功同步的时间戳系统自动写入用它判断自动更新是否真的在工作 常见问题现象点拉取配置报请求失败并带 HTTP 状态码。原因是订阅地址 404、502 或链接已失效。先用浏览器直接打开该地址确认可取回一串 Base58 原文再回面板重试。现象拉取成功保存却提示配置文件格式错误请检查 JSON 语法。原因是解码出来的内容不是合法 JSON。让订阅提供方核对编码也可以自己取一份原文用 bs58 解码后确认。现象自动更新开着但最后更新一直不动。原因是/api/cron没有被定时调用或订阅地址、开关有一项为空。手动请求一次 /api/cron看服务日志里是否出现跳过刷新未配置订阅地址或自动更新即可定位。现象点保存直接提示不支持本地存储进行管理员配置。原因是存储方式为 localstorage。把环境变量 NEXT_PUBLIC_STORAGE_TYPE 改为 redis、kvrocks 或 upstash 后重新部署。到这里LunaTV 实例的资源同步就闭环了。接下来可以在浏览器手动请求一次 /api/cron看最后更新是否变化这是验证自动更新真正生效的最直接方式。【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
LunaTV3步跑通配置订阅从粘贴地址到自动同步播放源【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV当你第一次打开 LunaTV 管理后台的配置文件模块订阅 URL 输入框是空的右上角写着最后更新: 从未更新。之后每发现一个可用的资源站都要手动下载 JSON、核对格式、再贴回面板。LunaTV 的配置订阅功能就是为这个环节准备的站长把一段 Base58 编码的订阅地址粘进面板实例就能持续拉取最新的播放源配置多个实例之间也能长期保持同一套资源。功能定位配置订阅位于管理后台的配置文件模块面向站长角色。它把下载文件、本地编辑 JSON、再提交的流程替换为服务端直接访问订阅地址、解码 Base58 内容并写入本地配置手动改文件这一步被整体去掉。⚙️ 前置条件已部署并可访问的 LunaTV 实例持有站长账号环境变量 USERNAME存储方式非 localstorageredis / kvrocks / upstash已拿到 Base58 编码的订阅地址 操作主线登录管理后台用站长账号登录实例进入管理后台在左侧菜单切到配置文件模块。页面顶部就是配置订阅卡片包含订阅 URL 输入框、拉取配置按钮和自动更新开关三个元素右上角显示上次同步时间首次使用前显示从未更新。填入订阅地址并拉取配置把拿到的订阅地址粘贴到订阅URL输入框注意地址内容必须是 Base58 编码、解码后为 JSON。点击拉取配置按钮前端请求/api/admin/config_subscription/fetch完成解码成功后弹出配置拉取成功提示解码出的配置内容会回填到下方的编辑器区域。保存配置并开启自动更新打开自动更新开关再点保存。后端会校验 JSON 格式把订阅地址和开关写入ConfigSubscribtion配置返回配置文件更新成功。此后每次 cron 任务执行时系统都会自动重新拉取订阅并刷新最后检查时间逻辑在 src/app/api/cron/route.ts 中。配置解读配置项作用推荐值/说明ConfigSubscribtion.URLBase58 编码的订阅地址必填解码失败时拉取与自动更新都会中断ConfigSubscribtion.AutoUpdate是否由 cron 自动拉取建议 true为 false 时每次都要手动点拉取配置ConfigSubscribtion.LastCheck上次成功同步的时间戳系统自动写入用它判断自动更新是否真的在工作 常见问题现象点拉取配置报请求失败并带 HTTP 状态码。原因是订阅地址 404、502 或链接已失效。先用浏览器直接打开该地址确认可取回一串 Base58 原文再回面板重试。现象拉取成功保存却提示配置文件格式错误请检查 JSON 语法。原因是解码出来的内容不是合法 JSON。让订阅提供方核对编码也可以自己取一份原文用 bs58 解码后确认。现象自动更新开着但最后更新一直不动。原因是/api/cron没有被定时调用或订阅地址、开关有一项为空。手动请求一次 /api/cron看服务日志里是否出现跳过刷新未配置订阅地址或自动更新即可定位。现象点保存直接提示不支持本地存储进行管理员配置。原因是存储方式为 localstorage。把环境变量 NEXT_PUBLIC_STORAGE_TYPE 改为 redis、kvrocks 或 upstash 后重新部署。到这里LunaTV 实例的资源同步就闭环了。接下来可以在浏览器手动请求一次 /api/cron看最后更新是否变化这是验证自动更新真正生效的最直接方式。【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
