TVBox仓库服务器怎么自建:群晖/飞牛托管Depot、urls清单与多设备共用(2026)
简介百度/必应/B 站对「tvbox仓库服务器」「群晖tvbox仓库服务器」「tvbox本地仓库如何建」的联想都很密。用户真正想要的往往不是再下一个「神秘仓库 APK」,而是:
我把配置放在家里 NAS(群晖 / 飞牛 / 任意静态 Web)上,电视、盒子、手机填同一个仓库地址,更新只改服务器一次。
这和「客户端多仓切换」(站内已有多仓/新手地图专帖)互补:多仓是 App 里登记多个源;仓库服务器是你自己托管一份 urls 清单。 本帖按 FongMi 配置字典里的 Depot 说明来写,空壳合规,不提供现成侵权接口。
▲ TVBox 仓库服务器:自建 Depot 三层结构(本地渲染)
一、仓库服务器到底是什么
在 FongMi 配置模型里,若 JSON 顶层出现 urls,就会按 Depot(配置仓库) 处理:
· urls:Depot[],登记多项配置;
· 清单不可为空;加载时取 第一项(以及后续在 App 内切换的能力视壳而定);
· 每一项至少有显示名与配置 URL(官方示例形态:{"name":"…","url":"…"})。
示意(合法自建,路径请换成你的):
{
"urls": [
{ "name": "家用主配置", "url": "./vod.json" },
{ "name": "备用配置", "url": "https://nas.example.local/tvbox/vod-backup.json" }
]
}
./vod.json 表示与仓库文件同目录的相对路径——很适合 NAS 静态目录。
二、推荐目录结构(群晖 / 飞牛通用)
在 NAS 共享文件夹例如 /tvbox-public/:
tvbox-public/
depot.json ← 仓库清单(给 App 填的入口)
vod.json ← 点播配置(sites / parses / …)
live.m3u ← 可选直播列表
epg.xml ← 可选节目单
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 坏了。
页:
[1]