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直接播放原始地址。

网盘帐号负载均衡

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

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

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

开启后主帐号不再生效。

{
  "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。

如果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 。

部署电报搜索服务

下载对应平台的文件解压

第一次直接启动： ./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 #顺序很重要
🈴:/🈴我的阿里分享
5️⃣: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。

我的技术笔记

AList-TvBox使用文档