查看: 302|回复: 0

TVBox仓库服务器怎么自建:群晖/飞牛托管Depot、urls清单与多设备共用(2026)

[复制链接]

298

主题

5

回帖

1150

积分

管理员

积分
1150
发表于 2026-10-13 10:25:57 | 显示全部楼层 |阅读模式
简介

百度/必应/B 站对「tvbox仓库服务器」「群晖tvbox仓库服务器」「tvbox本地仓库如何建」的联想都很密。用户真正想要的往往不是再下一个「神秘仓库 APK」,而是:

我把配置放在家里 NAS(群晖 / 飞牛 / 任意静态 Web)上,电视、盒子、手机填同一个仓库地址,更新只改服务器一次。

这和「客户端多仓切换」(站内已有多仓/新手地图专帖)互补:多仓是 App 里登记多个源;仓库服务器是你自己托管一份 urls 清单。 本帖按 FongMi 配置字典里的 Depot 说明来写,空壳合规,不提供现成侵权接口。

depot-nas.png
▲ TVBox 仓库服务器:自建 Depot 三层结构(本地渲染)

一、仓库服务器到底是什么

在 FongMi 配置模型里,若 JSON 顶层出现 urls,就会按 Depot(配置仓库) 处理:

· urls:Depot[],登记多项配置;
· 清单不可为空;加载时取 第一项(以及后续在 App 内切换的能力视壳而定);
· 每一项至少有显示名与配置 URL(官方示例形态:{"name":"…","url":"…"})。

示意(合法自建,路径请换成你的):
  1. {
  2.   "urls": [
  3.     { "name": "家用主配置", "url": "./vod.json" },
  4.     { "name": "备用配置", "url": "https://nas.example.local/tvbox/vod-backup.json" }
  5.   ]
  6. }
复制代码

./vod.json 表示与仓库文件同目录的相对路径——很适合 NAS 静态目录。

二、推荐目录结构(群晖 / 飞牛通用)

在 NAS 共享文件夹例如 /tvbox-public/:
  1. tvbox-public/
  2.   depot.json          ← 仓库清单(给 App 填的入口)
  3.   vod.json            ← 点播配置(sites / parses / …)
  4.   live.m3u            ← 可选直播列表
  5.   epg.xml             ← 可选节目单
  6.   jars/               ← 可选自有 spider(合法自建)
复制代码

Web 服务映射成:

· https://nas.lan/tvbox/depot.json
· https://nas.lan/tvbox/vod.json

App 只填 depot.json 的完整 URL。不要填文件夹路径,不要填 Samba \\nas\share。

三、群晖实操要点

· File Station 建目录,上传 depot.json / vod.json;
· 用 Web Station、Synology Drive 分享 或反向代理,让目录可通过 HTTP/HTTPS 访问;
· 权限:匿名只读或独立账号只读即可,不要把可写管理口暴露到公网;
· 证书:局域网可用 HTTP;若路由器访客隔离,电视可能访问不到 NAS——先用手机浏览器打开同一 URL 验证;
· 防火墙放行 Web 端口;勿把 DSM 管理端口当仓库口。

飞牛 / 其它 Linux NAS:Nginx/Caddy 指到静态目录即可,原理相同。必应联想里的「飞牛」「群晖」都是同一类需求。

四、vod.json 里放什么(合规模板意识)

点播配置需要 sites 等字段(详见 影视TV 配置字典)。合规做法:

· 只放 你有权使用 的站源、本地媒体库、自建爬虫;
· 不要在公开帖/群分享「全网影视接口」;
· spider、壁纸、DoH、Proxy、Hosts、Rules 均可按需加,但错误的 Hosts/代理会导致「仓库能开、内容全挂」。

直播若要做,可在配置中加 lives,或独立 Live 配置;EPG 专帖见今日 EPG 教程,本帖不展开。

五、多台设备怎么用

· 电视 FongMi:设置 → 配置地址 → 粘贴 …/depot.json;
· 手机版同一 URL,收藏/历史可再走局域网同步(已有收藏迁移帖);
· 更新:只改 NAS 上的 vod.json,各端「刷新配置」;
· 回滚:保留 vod-backup.json 并在 urls 里留第二项。

六、常见失败排查

· 现象:配置拉取失败|可能原因:URL 404、HTTPS 证书、访客隔离|处理:手机浏览器先打开
· 现象:提示仓库/清单错误|可能原因:urls 空、JSON 坏掉|处理:校验 JSON;保证至少一项
· 现象:只能看到仓名无内容|可能原因:子配置 url 错、相对路径错|处理:把 ./vod.json 改成绝对 URL 对比
· 现象:外网能开家里不能|可能原因:DNS/Hosts 写死公网域名|处理:内网用局域网域名或 IP
· 现象:安全告警|可能原因:仓库暴露公网且无鉴权|处理:改 VPN/Tailscale/零信任,勿裸奔
七、和「多仓」「订阅」的边界

· 多仓导入教程:在 App 内管理多个远程配置;
· 本帖:你自己当「仓库服务器」;
· 不要把「仓库服务器」理解成必须购买某商业面板;静态 JSON 就够用;
· 拒绝来路不明的「一键仓库 APK」。

八、FAQ

Q1:一定要群晖吗?  
A:否。任何能提供静态 HTTP 的设备都行,包括小主机、路由器 U 盘、云函数(注意合规与泄露)。

Q2:depot 和普通配置有何区别?  
A:普通配置顶层直接是 sites;仓库顶层是 urls 列表。

Q3:可以只内网、不上云吗?  
A:可以,而且更安全。出门用 VPN 回连即可。

Q4:要不要挂解析接口?  
A:parses 可选。无合法解析需求就留空,少一层故障面。

Q5:和 alist/小雅方案?  
A:本站日常合规跳过该类灰产整合教程;自建媒体库请走正版/自有资源方案。

Q6:FongMi 版本有要求吗?  
A:建议使用仍在维护的正式版(当前 5.7.x),旧壳对 Depot/相对路径支持可能不一致。

总结

「TVBox仓库服务器」= 自建可访问的 Depot(urls)+ 背后的合法 Vod/Live 文件。群晖/飞牛只是托管载体。把清单、点播、直播分层放好,多设备共用一个 URL,更新一次全屋生效——这比追网上飘忽的「最新仓库地址」更长久、也更干净。

九、从零搭一份最小仓库(示意)

假设 NAS 局域网地址为 192.168.1.50,Web 根目录映射 /tvbox/:

· 编写 vod.json:至少包含空的或自有的 sites 数组,通过 JSON 校验器;
· 编写 depot.json,urls 第一项指向 http://192.168.1.50/tvbox/vod.json(初学阶段先用绝对 URL,排错更直观);
· 电脑浏览器打开两个 URL,确认不是 401/404;
· 电视 FongMi 粘贴 depot 地址,观察是否出现仓库名称;
· 再改为相对路径 ./vod.json,确认同目录解析仍然成功;
· 最后再考虑 HTTPS、域名与远程访问。

安全上,仓库服务器只读即可。若必须公网,优先 Tailscale / WireGuard,而不是把 DSM 5000 端口暴露出去。日志里若出现频繁扫描,说明你已被探路——立刻收紧。

维护节奏建议:配置变更写进 NAS 的版本文件夹(vod-2026-10-13.json),urls 里保留「上一次可用」作为第二项,出问题一键切回。家庭成员只需要知道一个入口地址,不必每人收藏五花八门的网盘分享链。

更新仓库后,建议在一台「试验机」先刷新配置,确认站点列表与播放抽样正常,再通知全屋其它设备刷新。这样可以把误删 sites、JSON 少写逗号等低级错误限制在单机。若使用 CDN 或公网域名,记得处理缓存:更新了 NAS 源文件,CDN 仍吐旧 depot 时,电视会表现为「怎么改都不生效」——此时应带版本号的文件名或短缓存头,而不是怀疑 App 坏了。
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

相关侵权、举报、投诉及建议等,请发 E-mail:zl@nlaw.org

Powered by Discuz! X5.0 © 2001-2026 Discuz! Team.

在本版发帖返回顶部