夸克网盘自动转存项目简介
项目概述
夸克网盘自动转存是一款专注于夸克网盘自动化管理的工具,提供签到、自动转存、文件命名整理、推送提醒以及媒体库刷新等一站式服务。特别适用于需要定期转存更新资源的用户,结合 Alist、rclone 和 Emby,可以实现自动追更和资源管理。
核心功能
1. 分享链接管理
- 支持子目录转存:自动处理分享链接的子目录。
- 跳过失效分享:记录失效的分享链接并自动跳过任务。
- 提取码支持:支持含提取码的分享链接转存。
2. 文件管理
- 自动创建目标目录:目标目录不存在时自动新建。
- 避免重复转存:已转存的文件将被跳过。
- 文件名过滤与整理:支持正则过滤文件名,转存后可按规则整理文件名(支持正则替换)。
- 文件后缀忽略:可选配置忽略文件后缀。
3. 任务管理
- 多任务支持:支持多组任务同时运行。
- 任务截止期限:任务可设置结束日期,超期后不再执行。
- 灵活的时间计划:支持指定任务在特定星期几运行。
4. 媒体库整合
- Emby 媒体库联动:根据任务名自动搜索 Emby 媒体库并刷新。
- 自动追更与整理:结合 Emby 实现媒体资源的追更或整理后自动刷新。
- 模块化扩展:用户可以自定义媒体库的 hook 模块,轻松整合自己的媒体库管理系统。
5. 其它功能
- 每日签到:支持自动签到领取空间奖励。
- 多种推送渠道:任务完成后支持多渠道发送通知提醒。
- 多账号支持:支持多个账号的每日签到,但仅主账号进行资源转存。
部署到飞牛NAS的教程
部署前请参考通用教程
点此查看飞牛NAS部署各种Docker应用通用教程
dockercompose配置文件如下,可根据自己需求修改端口和挂载路径
services:
quark-auto-save: # 服务名称,用于容器
image: cp0204/quark-auto-save:latest # 使用的 Docker 镜像
container_name: quark-auto-save # 为运行中的容器指定的名称
network_mode: bridge # 使用桥接网络模式
ports:
- 5123:5005 # 将宿主机的 5123 端口映射到容器的 5005 端口
restart: unless-stopped # 设置容器在非手动停止时自动重启
environment:
WEBUI_USERNAME: "admin" # Web UI 的用户名
WEBUI_PASSWORD: "admin123" # Web UI 的密码
volumes:
- /vol2/1000/docker2/quark-auto-save/config:/app/config # 将配置文件目录挂载到容器内 /app/config
- /vol2/1000/docker2/quark-auto-save/media:/media # 将媒体文件目录挂载到容器内 /media
在飞牛的docker里创建项目后,使用飞牛ip加端口访问,比如我的是http://192.168.2.146:5123
使用配置文件里面的账号密码admin admin123登录,然后参考官方文档进行配置使用。官方文档 https://github.com/Cp0204/quark-auto-save/wiki
使用技巧集锦
dockercompose配置文件如下,可根据自己需求修改端口和挂载路径
插件(原媒体库模块)主要在执行任务,有新转存时触发完成相应功能,如刷新媒体库、生成 .strm 文件等。
以下是目前已实现的模块,首次成功运行任务后会自动在 quark_config.json 中生成配置参数。
插件配置必要参数后,运行任务时才会生效,不配置则不启用。
你也可以通过环境变量 PLUGIN_FLAGS 来禁用某些插件,如 -alist,-alist_strm,-alist_strm_gen,-aria2,-emby,-plex 。
用于自动刷新 Alist 目录,各配置含义如下:
- url : Alist 访问地址,例如:http://127.0.0.1:5244
- token :Alist 访问令牌,Alist 管理后台-设置-其他-令牌-复制令牌
- storage_id :
- Alist 服务器夸克存储的 ID,Alist 管理后台-存储-夸克驱动-编辑,url 中最后一串数字。
- 同时也支持 /storage_mount_path:/quark_root_dir 方式填写,对应Alist里存储设置的“挂载路径”和“根文件夹ID”的目录,此时直接使用这两项参数(当使用QuarkTV存储时适用)。
用于从 Alist 生成 strm 文件保存到本地,基于 Alist API 实现的轻量版本,alist_strm_gen 与 alist_strm 二选一使用即可,各配置含义如下:
- url : Alist 访问地址,例如:http://127.0.0.1:5244
- token :Alist 访问令牌,Alist 管理后台-设置-其他-令牌-复制令牌
- storage_id :
- Alist 服务器夸克存储的 ID,Alist 管理后台-存储-夸克驱动-编辑,url 中最后一串数字。
- 同时也支持 /storage_mount_path:/quark_root_dir 方式填写,对应Alist里存储设置的“挂载路径”和“根文件夹ID”的目录,此时直接使用这两项参数(当使用QuarkTV存储时适用)。
- strm_save_dir : strm 文件保存路径,如使用 docker 对应 docker 内部路径,默认 /media
- strm_replace_host : strm 文件内链接使用的主机地址,例如:http://example.host ,配合自定义 host 解析在 strm 文件迁移机器时无需重新生成 strm 文件,修改自定义 host 解析地址即可,默认为空时使用 url 配置
用于触发 alist-strm 项目的配置运行,从 Alist 生成 strm 文件,alist_strm_lite 与 alist_strm 二选一即可,各配置含义如下:
- url : alist-strm 访问地址,例如:http://127.0.0.1:5000
- cookie : alist-strm 的访问 cookie ,F12抓取,关键参数:session=ey***
- config_id : alist-strm 的配置 ID ,支持多个,以逗号分隔,如 1,2
用于推送下载任务到 Aria2 下载器,下载链接直接获取夸克的直链,不依赖 Alist,各配置含义如下:
- host_port : Aria2 访问地址,如:172.17.0.1:6800
- secret :Aria2 访问令牌
- dir 下载目录,如 /Downloads ,这个目录是对 Aria2 而言的,宿主机映射到 Aria2 中的目录,本项目容器无需映射。创建任务会下载到夸克网盘文件与下载目录的相对路径,如夸克网盘路径/tv/1.mp4,将下载到 /Downloads/tv/1.mp4
用于自动刷新 Emby 媒体库,各配置含义如下:
- url : emby 访问地址,例如:http://127.0.0.1:8096
- token : emby 的 API 密钥,后台管理 – 高级 – API 密钥 中生成
用于自动刷新 Plex媒体库,各配置含义如下:
- url : Plex 访问地址,例如:http://127.0.0.1:32400
- token : Plex Token,可F12在请求中抓取 X-Plex-Token
- quark_root_path : 夸克根目录相对于 Plex 的路径;假设夸克目录 /media/tv 在 Plex 中对应的路径为 /quark/media/tv ,则填 /quark