最新文档查看下面的链接：

https://github.com/power721/alist-tvbox/blob/master/doc/README_zh.md

AList-TvBox
AList代理，支持xiaoya版AList界面管理。

简明教程
准备工作：安装Docker
安装AList-TvBox：
sudo bash -c “$(curl -fsSL http://d.har01d.cn/alist-tvbox.sh)”
 
打开管理界面：http://your-ip:4567/#/accounts
获取并填写阿里token、开放token
将订阅地址http://your-ip:4567/sub/0 输入到TvBox配置
功能
管理界面
海报墙
多个AList、Emby、Jellyfin站点
多个网盘账号
支持百度、夸克、UC、115、123、天翼、移动、迅雷网盘
支持百度、夸克、UC、115、123、天翼、移动、迅雷分享
自动刷新阿里Token
自定义TvBox配置
安全订阅配置
TvBox配置聚合
支持BiliBili
管理AList服务
小雅配置文件管理
构建索引
在线日志
安装
一键安装
不需要再安装小雅版Docker。

如果找不到bash就替换为sh。

如果找不到sudo，就用root账号登录，去掉sudo后运行。

sudo bash -c “$(curl -fsSL http://d.har01d.cn/alist-tvbox.sh)”
 
OpenWrt去掉sudo，或者已经是root账号：

bash -c “$(curl -fsSL http://d.har01d.cn/alist-tvbox.sh)”
 
如果没有安装curl:

wget http://d.har01d.cn/alist-tvbox.sh; sudo bash ./alist-tvbox.sh
 
小雅集成版
内置了小雅的阿里分享和115分享资源。

小雅集成版host网络模式
使用host网络模式运行

使用的端口：

4567 – 管理应用

5678 – nginx

5233 – httpd

5234 – AList

纯净版
没有内置分享数据、可以直接访问AList管理界面。

纯净版（Python运行环境） 小雅版（Python运行环境）
添加了Python3、pip、telethon运行环境。

NAS
对于群辉等NAS系统，请挂载Docker的/data目录到群辉文件系统，否则数据不会保留。

创建容器

目录映射

端口映射

环境变量

定时更新
使用root用户创建corntab定时任务

wget http://d.har01d.cn/alist-tvbox.sh -O /opt/alist-tvbox.sh
chmod a+x /opt/alist-tvbox.sh
crontab -l | { cat; echo “0 2 * * * /opt/alist-tvbox.sh update -y”; } | crontab –
 
每天凌晨2点检查更新并重启应用。

定时重启
使用root用户创建crontab定时任务

每天凌晨2点重启应用：

wget http://d.har01d.cn/alist-tvbox.sh -O /opt/alist-tvbox.sh
chmod a+x /opt/alist-tvbox.sh
crontab -l | { cat; echo “0 2 * * * /opt/alist-tvbox.sh restart”; } | crontab –
 
每天凌晨2点检查更新：

wget http://d.har01d.cn/alist-tvbox.sh -O /opt/alist-tvbox.sh
chmod a+x /opt/alist-tvbox.sh
crontab -l | { cat; echo “0 2 * * * /opt/alist-tvbox.sh update -y”; } | crontab –
 
自动更新
使用docker镜像watchtower实现自动更新。

docker run -d \
–name watchtower \
–restart always \
-e TZ=Asia/Shanghai \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower \
–cleanup \
-s “0 0 3 * * *” \
xiaoya-tvbox
 
防火墙
需要开放管理端口4567和Nginx端口5344（host网络模式是5678）。

如果修改了默认端口，自行替换。

海报展示
浏览目录

搜索界面

播放界面

管理
打开管理网页：http://your-ip:4567/

默认用户名：admin 密码：admin

点击右上角菜单，进入用户界面修改用户名和密码。

站点

默认添加了站点：http://localhost，如果AList配置有域名，自行修改地址。否则保持http://localhost！

为什么是http://localhost？ 因为小雅用80端口代理了容器内的AList 5244端口。 管理程序运行在同一个容器内，能够直接访问80端口。

访问AList，请加端口，http://your-ip:5344/ 。使用Docker映射的端口，默认是5344.

自己可以添加三方站点，功能与xiaoya的套娃类似。会自动识别版本，如果不能正确识别，请手动配置版本。

选择TvBox第二个站源，观看三方站点内容。或者在我的套娃观看。

如果AList开启了强制登录，会自动填写认证token。

Emby站点
在Emby页面添加Emby站点url和帐号。

在TvBox选择第五个站源观看。

账号

第一次启动会自动读取/data/mytoken.txt,/data/myopentoken.txt里面的内容，以后这些文件不再生效。 自动创建转存文件夹，不需要再填写转存文件夹ID。

修改主账号后不需要重启AList服务。

网盘帐号
网盘帐号在帐号页面添加。

夸克网盘Cookie获取方式： https://alist.nn.ci/zh/guide/drivers/quark.html

UC网盘Cookie获取方式： https://alist.nn.ci/zh/guide/drivers/uc.html

115网盘Cookie获取方式： https://alist.nn.ci/zh/guide/drivers/115.html

网盘分享在资源页面添加。

115网盘开启本地代理后才能使用webdav播放。

加速代理
有些网盘资源需要发送HTTP请求头或者Cookie才能播放。如果播放器支持（如影视），直接返回播放地址和HTTP请求头。

如果播放器不支持（如网页播放器），需要使用AList代理访问。网页播放强制使用代理播放。

AList代理具有多线程加速。也可以在网盘帐号开启加速代理，使影视播放加速。

阿里需要HTTP请求头。
夸克、UC需要Cookie。
115需要Cookie。
其它网盘使用302直接播放原始地址。

网盘帐号负载均衡
在高级配置开启网盘帐号负载均衡。

如果添加了多个同一类型的网盘帐号，观看分享会轮流使用网盘帐号获取播放地址。

阿里帐号如果同时存在会员帐号和非会员帐号，只会使用会员帐号。

开启后主帐号不再生效。

订阅
tvbox/my.json和juhe.json不能在TvBox直接使用，请使用订阅地址！

添加订阅支持多个URL，用逗号隔开。定制部分基本和TvBox的配置json一致，添加了站点白名单sites-whitelist和黑名单blacklist。

定制属于高级功能，不懂TvBox配置格式不要轻易改动。

站点key是必须的，其它字段可选。对于lives，rules，parses，doh类型，name字段是必须的。

站点名称可以加前缀，通过订阅URL前面加前缀，使用@分割。比如：饭@http://饭太硬.top/tv,菜@https://tv.菜妮丝.top

替换功能：

在配置页面->高级设置里面找到阿里Token地址，然后在订阅-定制里面自替换token。

{
“sites”: [
{
“key”: “玩偶哥哥”,
“name”: “玩偶哥哥┃4K弹幕”,
“type”: 3,
“api”: “csp_WoGG”,
“searchable”: 1,
“quickSearch”: 1,
“changeable”: 0,
“ext”: “http://127.0.0.1:9978/file/tvfan/token.txt+4k|auto|fhd$$$https://www.wogg.xyz/$$$弹”,
“jar”: “https://fs-im-kefu.7moor-fs1.com/29397395/4d2c3f00-7d4c-11e5-af15-41bf63ae4ea0/1708249660012/fan.txt;md5;87d5916b7bb5c8acacac5490e802828e”
}
],
“lives”: [
{
“name”: “范明明•ipv6”,
“type”: 0,
“url”: “https://github.moeyy.xyz/https://raw.githubusercontent.com/fanmingming/live/main/tv/m3u/ipv6.m3u”,
“playerType”: 1,
“epg”: “http://epg.112114.xyz/?ch={name}&date={date}”,
“logo”: “https://epg.112114.xyz/logo/{name}.png”
}
],
“blacklist”: {
“sites”: [
“说明1”,
“说明2”,
“说明3”,
“说明4”,
“公告”,
“ext_live_protocol”,
“cc”,
“豆豆”
],
“parses”: [
“聚合”
]
}
}
 

PG订阅
在订阅页面，查看当前PG包版本和远程版本。

如果本地版本与远程版本不同，点击同步文件按钮。

自定义PG包，下载最新的PG包放在/etc/xiaoya/pg.zip，点击同步文件按钮。

自定义PG配置，在文件页面新建文件/data/tokenm.json。 填写自定义内容，比如：

{
“pan115_delete_code” : “123456”,
“tgsearch_api_url” : “ATV_ADDRESS/tgs”
}
 
订阅页面登陆电报后，配置PG电报搜索URL。

电报搜索API： http://IP:4567/tgs, ATV_ADDRESS/tgs

自定义115分享资源： 在/etc/xiaoya/pg/lib目录新建文件115share.txt。

复制原文件内容，添加新的分享，点击同步文件按钮。

其它分享类似，在压缩包/etc/xiaoya/pg.zip查看分享文件。

真心订阅
在订阅页面，查看当前真心包版本和远程版本。

如果本地版本与远程版本不同，点击同步文件按钮。

自定义真心包，下载最新的真心包放在/etc/xiaoya/zx.zip，点击同步文件按钮。

默认的TG搜索url是”http://IP:9999″

自定义真心配置，在文件页面新建文件/data/zx.json。 填写自定义内容，比如：

{
“proxy” : “http://192.168.0.2:1072”
}
 
订阅定制：

{
“sites”: [
{
“key”: “TgYunPan|服务器”,
“ext”: {
“siteUrl”: “http://192.168.0.2:9999”,
“channelUsername”: “kuakeyun,Quark_Movies,Quark_Share_Channel”,
“commonConfig”: “ATV_ADDRESS/zx/config?token=TOKEN”
}
}
]
}
 
自定义多仓订阅
在文件页面新建文件，目录：/www/tvbox/repo，名称：订阅id.json，比如：1.json。 内容留空(返回全部订阅)或者自定义内容：

{
“urls”: [
{
“url”: “ATV_ADDRESS/sub/TOKEN/1”,
“name”: “内置小雅搜索源”
},
{
“url”: “https://tv.菜妮丝.top”,
“name”: “菜妮丝”
}
]
}
 
资源
第一次启动会自动读取/data/alishare_list.txt文件里面的分享内容，并保存到数据库，以后这个文件就不再生效。

可以在界面批量导入文件里面的分享内容，批量删除分享。

添加资源如果路径以/开头就会创建在根目录下。否则在/我的阿里分享/下面。

系统会添加一些默认阿里分享资源，不能彻底删除。 

海报墙模式
 

添加一个小雅站点并打开搜索功能。

可以自定义类别。在文件管理界面，添加一个文件/data/category.txt，内容是要显示的小雅目录。

可以自定义名称，冒号后面是自定义的名字。 在分类下面可以加子目录作为筛选条件，用两个空格开始。

每日更新
电视剧/国产剧
电视剧/美剧
美剧（已刮削）:美剧
示例文件

BiliBili
拖动行可以改变顺序，需要点击保存按钮才能生效。

打开、关闭显示开关后，需要点击保存按钮才能生效。

登录后才能使用，TvBox第三个站源。

或者使用已有的cookie登录。

打开上报播放记录，B站才能看到播放记录。

添加搜索关键词作为一级分类：

添加频道作为一级分类：

YouTube
已经停用！！！

服务端代理，需要消耗服务器流量！

订阅定制可以屏蔽：

{
“blacklist”: {
“sites”: [“csp_Youtube”]
}
}
 
自定义分类（搜索关键词或者频道），新建文件/data/youtube.txt

电影
动漫
纪录片
英语
美食
@yuge
@laogao:老高
 
配置

开启安全订阅，在订阅URL、点播API、播放API加上Token，防止被别人扫描。

强制登录AList后，连接webdav需要使用下面的用户名和密码。

如果打开了挂载我的云盘功能，每次启动会消耗两次开放token请求。 如果使用AList官方认证URL，60分钟内只能请求10次，超过后需要等待60分钟后才能操作。

可以换IP绕开限制。或者更换开放token的认证URL。配置页面->高级设置 选择一个认证URL。

https://api.xhofe.top/alist/ali_open/token
https://api.nn.ci/alist/ali_open/token
如果nginx配置了SSL，需要在高级设置中打开订阅域名支持HTTPS开关。

索引
对于阿里云盘资源，建议使用文件数量少的路径，并限速，防止被封号。

索引文件
路径开头加上-：表示此路径屏蔽搜索和刮削。

路径开头加上+：表示此路径屏蔽刮削，允许搜索。

下载索引文件修改后再上传。

索引与刮削
在电影数据列表页面对索引文件进行刮削，根据路径提取电影名称。如果无法正确识别名称，需要手动刮削。

索引文件修改： 路径#名称#豆瓣ID

比如：

修正名称后刮削： /电影/中国/F 封神：朝歌风云 [2023][4K]动作 战争 奇幻 古装[正式版]#封神第一部：朝歌风云

提供豆瓣ID刮削： /电影/中国/F 封神：朝歌风云 [2023][4K]动作 战争 奇幻 古装[正式版]##10604086

TMDB刮削
申请TMDB账号，https://www.themoviedb.org/
申请TMDB API key，https://developer.themoviedb.org/docs/getting-started
配置页面 -> 高级设置 -> TMDB API Key -> 填写你的 API Key
创建索引
TMDB电影数据列表，使用索引文件进行刮削
失败的路径保存在 /etc/xiaoya/atv/tmdb_paths.txt
使用内置的API Key会限速，建议申请自己的API key。

GitHub代理
需要通过GitHub下载分享数据和索引数据。

创建文件/etc/xiaoya/github_proxy.txt， 内容为GitHub代理地址，注意以/结尾。

比如https://gh-proxy.net/

别名
把一些路径合并成一个路径。

WebDAV
默认用户名：guest 密码：alist_tvbox

开启强制登录AList后，使用在管理界面配置的用户名和密码。

4567端口代理了webdav请求。

电报搜索
不登陆默认使用网页搜索公开频道资源。

在订阅页面登陆电报或者配置远程搜索，可以搜索更多频道。 在播放页面配置频道列表。

如果在订阅页面不能登陆电报，在播放页面配置远程搜索地址 http://IP:7856 。

部署电报搜索服务
下载对应平台的文件解压
https://har01d.org/tgs-amd64.zip
https://har01d.org/tgs-arm64.zip
https://har01d.org/tgs-armv7.zip
第一次直接启动： ./tgs-amd64
输入手机号和验证码，需要加国际区号86
然后使用nohup后台运行： nohup ./tgs-amd64 &
环境变量TGS_PORT，设置端口，默认为7856
猫影视
不再提供支持！

自定义猫影视配置
在应用目录（默认/etc/xiaoya）创建cat文件夹(/etc/xiaoya/cat)。

放入自己的js文件和my.json（格式和config_open.json一样），在订阅页面点击同步文件按钮，应用会合并配置。

放入自己的config_open.json文件，将会覆盖内置的配置。

/etc/xiaoya/cat/my.json文件示例（/etc/xiaoya/cat/kkys_open.js、/etc/xiaoya/cat/kkys2_open.js）：

示例文件

{
“video”: {
“sites”: [
{
“key”: “kkys”,
“name”: ” 快看1″,
“type”: 3,
“api”: “/cat/kkys_open.js”
},
{
“key”: “kkys2”,
“name”: ” 快看2″,
“type”: 3,
“api”: “/cat/kkys_open2.js”
}
]
}
}
 
自定义路径label
在文件界面新建一个文件/data/label.txt

:/电影 #匹配以/电影 开头的路径
:/电视剧
:/动漫
:/综艺
:/纪录片
:/音乐
:/有声书
:/整理中
:/每日更新/PikPak #顺序很重要
:/每日更新
:/教育
:/曲艺
:/体育
:/我的阿里分享/Tacit0924 #顺序很重要
:/我的阿里分享
:115 #路径包含115
:PikPak
:阿里云盘
:夸克网盘
:我的套娃
 
使用MySql数据库
独立服务版编辑配置文件/opt/atv/config/application-production.yaml

Docker版在数据目录创建config目录，创建文件application-production.yaml， 比如/etc/xiaoya/config/application-production.yaml。

application-production.yaml文件内容示例：

spring:
datasource:
jdbc-url: jdbc:mysql://localhost:3306/alist_tvbox?allowPublicKeyRetrieval=true&useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8
username: username
password: password
driver-class-name: com.mysql.cj.jdbc.Driver
jpa:
database-platform: org.hibernate.dialect.MySQL8Dialect
hibernate:
ddl-auto: update
show-sql: false
 
独立服务版编辑配置文件/opt/atv/alist/data/config.json Docker版挂载/opt/alist/data/config.json

AList配置参考alist-mysql.json

h2数据备份与恢复
每天6点自动备份数据库，保存在/etc/xiaoya/backup/目录。

如何恢复？

将保存的备份文件复制到/etc/xiaoya/database.zip
删除文件/etc/xiaoya/atv.mv.db和/etc/xiaoya/atv.trace.db
重启docker容器或者重新运行安装脚本
静态文件
将自己的文件test.json放在/www/tvbox/目录，可以通过 http://IP:4567/tvbox/test.json 访问。

http://IP:4567/tvbox/ -> /www/tvbox/

http://IP:4567/files/ -> /www/files/

http://IP:4567/cat/ -> /www/cat/

http://IP:4567/pg/ -> /www/pg/

http://IP:4567/zx/ -> /www/zx/

其它
不再生效的文件可以保留，以后删除数据库后可以恢复。

guestpass.txt和guestlogin.txt第一次启动时加载，以后不再生效，请在界面配置。

show_my_ali.txt第一次启动时加载，以后不再生效，请在界面配置是否加载阿里云盘。

docker_address.txt不再生效，使用订阅链接会自动识别。

alist_list.txt第一次启动时加载，以后不再生效，请在界面添加站点。

proxy.txt、tv.txt、my.json、iptv.m3u还是生效的，可以在文件页面编辑。

本项目不会使用alist.min.js。

常见问题
AList出现错误 failed get objs: failed to list objs: driver not init

在管理界面->资源页面->失败资源 查看具体原因

AList出现错误 failed link: failed get link: The resource drive has exceeded the limit. File size exceeded drive capacity

阿里网盘空间满了，清理一下文件。

AList出现错误 failed link: failed get link: No permission to access resource File

token失效，重启应用。AList日志检查阿里token账号昵称和开放token账号昵称是否一致。

管理界面没有账号页面，刷新一下网页。

夸克分享需要在帐号页面添加夸克网盘cookie。

UC分享需要在帐号页面添加UC网盘cookie。

阿里转存115有文件大小限制，并且115必须有对应文件存在。115需要会员。115删除码在115应用设置。

迅雷云盘，用户名 +86后面要加一个空格，比如+86 12345678900 在资源页面 -> 失败资源 -> 点击 重新加载。 多试几次，状态列出现链接后，打开链接验证。然后再次点击重新加载。

纯净版可以进AList后台管理页面。管理员用户名是atv，密码在高级设置里面查看。

重置用户名和密码。创建文件/etc/xiaoya/atv/cmd.sql，写入下面的内容。重启应用，恢复默认的admin密码。

UPDATE users SET username=’admin’, password=’$2a$10$90MH0QCl098tffOA3ZBDwu0pm24xsVyJeQ41Tvj7N5bXspaqg8b2m’ WHERE id=1;
 
网盘添加了文件，在AList看不到。因为AList有缓存，默认30分钟。等待缓存过期，或者重启AList。