小雅Alist怎么接到TVBox/FongMi：Alist-TVBox密码、配置地址与常见失败排查（2026）

redpear

简介

搜索联想里，「小雅alist」「小雅alist还能用吗」「alist tvbox」「alist tvbox密码」「小雅alist tvbox」出现频率很高。有人在飞牛/群晖上部署后不知道怎么填到播放器；有人登录一直提示密码错误；还有人昨天还能扫，今天「不能用了」。

本文只讲 自建或你有权访问的 Alist / 小雅类网盘列表服务，如何合规接到 TVBox 系客户端（以 FongMi 为对照），以及密码、地址、证书类故障怎么排查。本站不提供任何网盘资源、分享链接破解或第三方「小雅地址大全」。 「小雅」是社区部署方案之一，可用性随作者与上游维护变化，请以你自己的服务器状态为准。


▲ 小雅 Alist / Alist-TVBox 接入思路示意（本地整理）

一、先分清三个名字

· Alist：开源的网盘/存储聚合列表服务，通常有 Web 管理后台与 API。
· 小雅 Alist：社区在 Alist 之上的一套部署/资源组织方案（常提到 Docker、全家桶、与 Emby 的区别等）。
· Alist-TVBox：把 Alist 能力桥接到 TVBox 系配置/站点的项目或集成方式（具体仓库与版本请自行核验作者页）。

对播放器来说，你最终需要的是：一个可访问的服务地址 + 合法凭证（用户名/密码或 token）+ 客户端里能识别的站点/配置写法。

二、接入前的检查清单

· 服务器时间正确，HTTPS 证书未过期（电视/手机系统时间也要准）。
· 浏览器能打开 Alist 管理页或列表页（同一网络下先用手机浏览器测）。
· 你记得 管理员密码 或已创建专用只读用户（不要把管理员密码写进公开配置）。
· 防火墙/端口映射：家庭外网访问需要你自己配置，本站不教穿透灰产手法；仅内网使用更简单安全。
· 存储驱动（本机目录、已授权的网盘开放平台等）在 Alist 后台已挂载成功。

三、接到 FongMi / TVBox 的通用思路

不同集成方式细节不同，但排查顺序一样：

· 确认服务可达：电视与 Alist 同一局域网时，用电视浏览器或手机访问 http(s)://IP:端口。
· 确认账号：在 Alist 后台重置测试用户密码，用浏览器登录成功后再填客户端。
· 确认站点类型：配置里的站点 api/ext 必须匹配你使用的桥接方式；乱贴别人的 JSON 很容易「密码对了也进不去」。
· 权限最小化：给播放器用的账号只开需要的路径，避免管理员权限暴露在客厅设备上。
· 改完重启拉取：在客户端保存配置后重新加载；必要时清缓存（非清数据）。


▲ FongMi 配置字典页实拍：站点与直播等字段以官方文档为准

四、密码相关：最常见的五类报错

1. 密码错误 / 登录失败
· 确认没有全角字符、首尾空格。
· 区分 Alist 登录密码 与 某站点/分组的内容密码（不是一回事）。
· 后台「密码错误次数过多」时先等待解禁或在服务器端解锁。

2. 默认密码是什么？
以你部署时的文档为准；很多人改过初始密码却忘了。正确做法是 在服务器上按官方文档重置，而不是满网搜「万能密码」。

3. Token / 会话过期
部分桥接用 token。过期后需重新生成并更新客户端配置中的对应字段。

4. 能打开 Web，客户端却失败
常见于：电视走了不同 DNS、HTTPS 证书不被安卓信任、或配置里写了外网域名但家庭宽带禁止回环。

5. 「小雅不能用了」
多为上游源、Cookie/刷新令牌失效或项目停止维护。应检查你自己的挂载与日志，而不是反复换来路不明的「新地址」。

五、和「仓库自建」教程的关系

若你的目标是「家里多台设备共用一份配置」，可以把 Alist 地址写进自建 Depot/配置托管（群晖、飞牛、NAS 静态文件等）。站内已有「仓库服务器自建」专题，讲的是 配置分发；本文讲的是 网盘列表服务本身的账号与连通性。两者可以组合，但不要混为一谈。

六、安全与合规

· 不要把管理员密码发到公开群或写进可被任何人下载的配置。
· 不要传播或请求盗版资源索引；Alist 只是工具，用途必须合法。
· 公网暴露 Alist 时务必强密码、HTTPS，并限制管理路径。
· 本站拒绝协助绕过他人站点的访问控制。

七、常见问题

1. 小雅和 Alist 是不是同一个软件？
小雅方案通常建立在 Alist（或同类）之上，但安装脚本、目录结构、默认源配置可能不同。以你实际部署的文档为准。

2. 必须用 Docker 吗？
不是。Docker 只是常见部署方式；二进制/其他环境也可以，关键是服务稳定、地址可达。

3. 飞牛/群晖哪个更好？
看你现有设备和运维习惯。播放器侧只关心「地址 + 凭证 + 延迟」。

4. 能否只用电视、不配电脑？
可以，但首次部署和排错几乎总需要一台能看日志的浏览器设备。

5. 密码忘了还能从 TVBox 里看回明文吗？
不要指望客户端帮你「找回」服务器密码。去服务器重置。

若你同时维护多台电视，建议在 Alist 侧为「客厅设备」单独建只读用户，避免所有设备共用管理员会话。

排错时一次只改一个变量：先密码、再地址、再客户端缓存，避免同时更换导致无法复现。

总结

小雅 / Alist / Alist-TVBox 热度高，但核心只有三句话：服务先在浏览器里登得上，再交给播放器；密码重置走服务器官方方式；配置只使用你有权访问的存储。 把「地址不可达、密码错误、证书/时间、权限不足」分开排查，比盲目更换来路不明的配置有效得多。