AList-TvBox 小雅 TVBox 是开源影视聚合项目，一键脚本部署 AList 整合 TVBox 客户端方案。内置 TV 接口加速不限速，支持百度/夸克/UC/115/123/天翼/移动/迅雷 8 大网盘，4K 流畅播放不占第三方流量，自带影视资源订阅。
🎤 引言
NAS 玩家 / 影音爱好者大概都经历过这种困境：
- 网盘资源丰富（百度/夸克/UC/115...），但不能直接在大屏电视看
- AList 装好了，但不会配 TVBox 客户端
- TVBox 协议搞清楚了，但没有好的资源源（天天追更源失效）
- 小雅 TVBox 想用，但不知道 AList 怎么对接
AList-TvBox（俗称"小雅 TVBox"）——国内 NAS 圈最火的开源影视聚合方案——把上面这些坑一锅端：
「一键部署 AList + TVBox 整合方案，8 大网盘支持，TV 接口加速 4K 流畅播放」
它做的事情很直接：把 AList（网盘聚合工具）和 TVBox（电视盒子客户端协议）完美缝合，再加上一套"小雅"自带的影视资源订阅，让你家里的 NAS 变身家庭影院。
最香的是内置 TV 接口加速——绕开网盘限速、不占第三方流量，4K 蓝光直接流畅播放。
⭐ 核心功能
🚀 一键脚本部署
整个部署极简——一行命令搞定：
# 一键安装 AList + TVBox 整合
bash -c "$(curl -fsSL http://d.har01d.cn/alist-tvbox.sh)"安装完后自动配置：
- AList 服务（端口 5244）
- TVBox 资源订阅
- 默认账号密码
- 定时更新任务（cron 每天自动更新资源）
vs 手动配 AList + TVBox：省 4-6 小时。
☁️ 8 大网盘支持
AList-TvBox 整合了国内最常用的 8 大网盘：
| 网盘 | 支持 |
|---|---|
| 百度网盘 | ✅（最常用） |
| 夸克网盘 | ✅（不限速推荐） |
| UC 网盘 | ✅ |
| 115 网盘 | ✅（会员加速） |
| 123 网盘 | ✅ |
| 天翼云盘 | ✅ |
| 移动云盘 | ✅ |
| 迅雷云盘 | ✅ |
统一在一个 AList 后台管理——添加一次，所有 TVBox 客户端都能用。
⚡ TV 接口加速（核心卖点）
这是小雅 TVBox 的杀手锏——绕开网盘限速：
- 百度网盘非会员用官方限速 ~100KB/s
- 用小雅 TV 接口加速后：10-50MB/s（看小雅资源）
- 4K 蓝光原盘（50GB+）流畅拖动不缓冲
- 不占第三方流量——不走网盘官方接口
技术原理：使用小雅维护的"小雅资源"作为中转，本质上是把网盘资源预先转存到小雅的 OSS/CDN，播放时直接拉小雅 CDN，绕开网盘官方限速。
🎬 自带影视资源订阅
小雅 TVBox 自带一套影视资源（小雅资源），包括：
- 热门电影（4K 蓝光原盘 / REMUX / WEB-DL）
- 热门电视剧（HBO / Netflix / 国产剧）
- 动漫（每周更新）
- 纪录片（BBC / NHK / 国家地理）
- 综艺（热门综艺）
- 儿童内容（动画、儿歌）
资源订阅通过配置文件管理，cron 每天自动更新——你看到的内容永远是最新的。
📱 多端 TVBox 客户端支持
AList-TvBox 兼容所有 TVBox 协议的客户端：
- Android TV 盒子（当贝 / 小米 / 天猫魔盒 / 各种外贸盒子）
- Android 手机/平板
- Windows（TVBox Windows 客户端）
- macOS（TVBox Mac 客户端）
- Apple TV（通过当贝市场装 TVBox）
- iOS（需越狱或 TestFlight）
一份配置，多端使用。
🔄 自动更新机制
安装脚本会自动添加 cron 任务：
# 每天凌晨 2 点自动更新资源
0 2 * * * /opt/alist-tvbox.sh update -y
# 每天凌晨 2 点自动重启 AList
0 2 * * * /opt/alist-tvbox.sh restart资源失效 / 新资源加入，全自动——你不用管。
🛠️ 完整生态
- AList 后台（管理网盘、分享链接）
- TVBox 客户端（大屏播放）
- 小雅资源订阅（影视内容）
- TV 接口加速（不限速播放）
- Docker 部署（更稳）
- Web UI 管理（可视化）
📥 安装与使用
🐧 系统要求
- 操作系统: Linux（推荐 Ubuntu 22.04 / Debian 11+ / 飞牛 fnOS / 群晖 DSM / 威联通）
- 架构: x86_64 / ARM64（Apple Silicon 不支持）
- 内存: 最低 1GB，推荐 2GB+
- 存储: 10GB+（缓存）
- 网络: 100Mbps+（4K 流畅）
🚀 方案 1：一键脚本（推荐）
bash -c "$(curl -fsSL http://d.har01d.cn/alist-tvbox.sh)"按提示输入：
- AList 端口（默认 5244）
- AList 管理员账号密码
- 是否启用 TVBox 资源订阅
5-10 分钟装完。
🐳 方案 2：Docker 部署
# 拉取 AList 镜像
docker run -d \
--name alist \
--restart always \
-p 5244:5244 \
-v /opt/alist/data:/opt/alist/data \
xhofe/alist:latest
# 拉取 TVBox 接口镜像（如果有官方 Docker）
# 然后配置资源订阅🖥️ 方案 3：群晖 / 威联通 NAS
通过 NAS 的 Container Manager（原 Docker）部署：
- 镜像：
xhofe/alist:latest - 端口：5244
- 目录映射：/opt/alist/data → NAS 上的持久化目录
📱 装 TVBox 客户端
Android TV / 盒子
- 在盒子上装「当贝市场」或「TVBox 安卓客户端」
- 打开 TVBox → 设置 → 配置地址 → 填入小雅资源订阅地址
- 默认就有内容，登录你自己的 AList 看网盘内容
Windows / Mac
- 下载 TVBox 桌面版
- 设置 → 配置地址
- 填入小雅资源订阅
⚙️ 首次使用流程
1. 浏览器打开 http://NAS_IP:5244 → AList 后台
2. 登录 → 「存储」→ 「添加存储」→ 选百度网盘/夸克等
3. 扫码登录网盘账号
4. 添加成功后，你的网盘内容会出现在 AList 文件列表
5. 在 TVBox 客户端填入 AList 地址 + 资源订阅
6. 完成！开始追剧🎯 适用场景
✅ 强烈推荐
- NAS 用户（群晖 / 威联通 / 飞牛 fnOS / unRAID）— 家庭影院必装
- 电视盒子用户（当贝 / 小米盒子 / 外贸盒子）— 不限速看 4K
- 租房党 — 没有大屏电视？用 Windows/Mac 客户端也行
- 追剧党 — 热门剧/电影/动漫第一时间更新
- 网盘深度用户 — 百度/夸克/UC/115 内容统一管理
- 想省钱 — 不用买视频会员，开源方案够用
- 有公网 IP / 内网穿透 — 远程访问
❌ 不太适合
- 没有 Linux 基础 — 部署需要命令行
- 正版观念极强 — 这是聚合方案，资源版权敏感
- NAS 配置太弱（< 1GB 内存）— AList 会卡
- 网盘账号都没 — 看不到自家网盘内容
- 移动端是主设备 — 移动端 TVBox 体验不如原生视频 App
🔍 对比/替代方案
vs 手动 AList + TVBox 配置
| 维度 | AList-TvBox | 手动配置 |
|---|---|---|
| 部署时间 | 5-10 分钟 | 4-6 小时 |
| 资源订阅 | ✅ 内置小雅 | ❌ 手动找源 |
| TV 加速 | ✅ 内置 | ❌ 不会搞 |
| 自动更新 | ✅ cron | ❌ 手动 |
| 8 网盘支持 | ✅ 一键 | ⚠️ 一个个加 |
| 学习曲线 | 低 | 高 |
结论：99% 用户选 AList-TvBox，土豪技术宅可以手动搞。
vs Jellyfin / Emby / Plex（媒体库管理）
| 维度 | AList-TvBox | Jellyfin / Emby / Plex |
|---|---|---|
| 核心定位 | 网盘影视聚合 | 本地媒体库管理 |
| 资源来源 | 网盘（在线） | 本地 NAS 存储 |
| 部署难度 | 低（脚本） | 中（要刮削） |
| 资源版权 | ⚠️ 第三方聚合 | ✅ 自己的内容 |
| 4K 播放 | ✅ 流畅 | ✅ 流畅 |
| 自动更新 | ✅ | ❌ |
| 硬件转码 | ❌ | ✅ |
结论：要"在线网盘影视"选 AList-TvBox；要"本地 NAS 媒体库"选 Jellyfin。两者不冲突，可并存。
vs Kodi / Infuse
| 维度 | AList-TvBox | Kodi / Infuse |
|---|---|---|
| 协议 | TVBox 协议 | 原生播放器 |
| 资源源 | 小雅订阅 | SMB/NFS/WebDAV |
| 部署难度 | 中 | 低 |
| 美观度 | 中 | 高（Infuse） |
| 流媒体整合 | ✅ | ⚠️ 需插件 |
| 4K 播放 | ✅ 流畅 | ✅ 流畅 |
结论：要"一站式网盘聚合"选 AList-TvBox；要"本地播放器"选 Kodi/Infuse。
vs 影牛魔盒 / 小蜜蜂等闭源盒子
| 维度 | AList-TvBox | 闭源盒子 |
|---|---|---|
| 价格 | 免费 + 开源 | ¥200-500 |
| 资源稳定性 | 经常变（聚合源特性） | 较稳定（资源方控制） |
| 可定制性 | ✅ 完全 | ❌ 闭源 |
| 隐私 | ✅ 自托管 | ⚠️ 上传用户数据 |
| 内容风险 | 看具体源 | 看具体盒子 |
结论：要"自由 + 隐私"选 AList-TvBox；要"省心 + 稳定"选闭源盒子。
⚠️ 注意事项
⚖️ 版权风险
重要：
- AList-TvBox 本身只提供工具（不提供资源）
- 影视内容来自第三方网盘分享（小雅资源）
- 资源版权取决于网盘分享者——本项目不存储任何内容
- 个人学习/测试用 OK，公开传播/商业用途 = 违法
建议：
- 只在家用 NAS 部署
- 不开公网分享
- 不传播盗版资源链接
- 支持正版（爱奇艺/腾讯视频/Netflix 等）
🐛 网盘接口频繁变更
国内网盘（尤其百度/夸克）经常改 API：
- AList 升级要跟上（一般 1-2 周内修复）
- 临时用不了 = 等 AList 更新
- 小雅资源接口也会临时失效（不是 100% 可用）
建议：
- 关注 AList 官方 GitHub 更新动态
- 加入社区群（QQ/Telegram）了解最新状态
- 备用 1-2 个网盘账号
🔧 部署需要一定 Linux 基础
虽然有"一键脚本"，但：
- 防火墙 / 端口开放要懂
- 反向代理 / 域名绑定要会
- cron / systemd 故障排查
- 内网穿透（frp / tailscale）— 如果要远程访问
没接触过 Linux 的同学建议先学一下基础。
🛡️ 性能调优
4K 流畅需要：
- NAS: 至少 Intel J4125 / N5105 / 等同性能
- 网络: 千兆有线（Wi-Fi 6 勉强）
- 播放端: 支持硬解的盒子（4K HDR + 杜比）
- 不同时跑太多任务（AList + Jellyfin + Docker + 转码 = 卡）
🐛 已知问题
按社区反馈：
- 夸克网盘 偶尔限速（开会员可解）
- 115 网盘 需要登录态（掉线需重连）
- 小雅资源 部分失效时只能等更新
- 某些地区 ISP 屏蔽小雅接口（用代理）
- Apple TV 装 TVBox 较麻烦（需美区账号装 TestFlight）
✅ 总结
AList-TvBox（小雅 TVBox）是国内 NAS 圈"影视聚合"赛道的标杆——它把 AList + TVBox + 小雅资源完美缝合，让普通用户也能用上"4K 蓝光不限速"的私人影院。
核心优势：
- ✅ 一键脚本部署（5-10 分钟搞定）
- ✅ 8 大网盘聚合管理
- ✅ TV 接口加速（不限速 4K）
- ✅ 小雅资源订阅（每日自动更新）
- ✅ 多端 TVBox 客户端支持
- ✅ Docker / 群晖 / 威联通全覆盖
核心劣势：
- ❌ 网盘接口频繁变（要跟 AList 更新）
- ❌ 资源版权敏感（自用 OK，传播违法）
- ❌ 需要一定 Linux 基础
- ❌ 资源稳定性受第三方源影响
推荐指数：⭐⭐⭐⭐（4/5）
推荐人群：NAS 玩家、电视盒子用户、追剧党、网盘深度用户、想给家庭打造私人影院的人。
不推荐人群：完全没 Linux 基础、只信任官方视频 App、正版观念极强、商业/公开传播场景。
结论：如果你有 NAS / 想折腾影音 / 不想开多个视频会员——AList-TvBox 是当前最值得用的开源方案。国内 NAS 圈"人手一个小雅"不是传说，是真的好用。先用飞牛/群晖虚拟机跑一周，确认喜欢再上主力。
仓库地址：github.com/power721/alist-tvbox
AList 官方：github.com/AlistGo/alist