Last updated on

发一条夸克链接,让飞牛 NAS 自己追番


之前追番是纯手动:别人分享的连载每周更新,我隔几天去夸克看一眼,转存、下载、改名、拖进媒体库。太累了。

想要的就一句话:我发一条夸克分享链接,剩下的 NAS 自己干。完结的直接全下;没完结的先把现有的下了,之后每周自己追,追到完结自己停。文件名按 Infuse 能识别的格式来,下完在微信上跟我说一声。

NAS 是飞牛 fnOS,看片用 Infuse。

怎么拆的

飞牛自带夸克挂载,但那是在线挂载,文件不落盘。我要的是下到自己硬盘上,所以拆成两段:

  • 转存:用现成的 quark-auto-save(Docker)。它盯着分享链接,有新集就转存进我自己的夸克账号。

  • 落盘:这次新写的 quark-tracker,每小时跑一次,把账号里新转存的集下到 NAS,按 SxxExx 去重,用 TMDB 改名,最后推微信和 QQ。

夸克追番自动化 · 数据流 夸克分享链接 别人分享的连载剧 · 持续更新 ① 转存(云端 · 秒级,不占本地) quark-auto-save(Docker) 监控分享 → 把新集转存进你自己的夸克账号 ② 夸克 API 直链 + aria2c 多线程下载 quark-tracker(每小时 cron) 按 SxxExx 去重 → 只下新集 → TMDB 改名 → 微信 / QQ 推送提醒 ③ Infuse 规范命名,自动刮削 NAS 本地库 → Infuse / Plex / Jellyfin 剧名/Season NN/剧名 - SxxExx - 集名.mkv 下载绕开 fnOS 原生挂载(WebDAV 缓存),直接走夸克 API · 全速
图 1 · 整体数据流

发链接这一步交给 agent

NAS 上本来就跑着一个 agent(openclaw),平时帮我用 TMDB 给媒体库改名、发微信和 QQ 消息。这次给它加了个技能,收到夸克链接后干三件事。

先探测分享:里面有几季、几个字幕组、各自更新到第几集。有多个字幕组就自己挑,规则是简繁内封 > 简体 > 繁中,集数多的优先,mkv 优先。

然后查 TMDB。完结没完结这件事,TMDB 比 IMDB 好用,它有结构化的 status、每集播出日期和 next_episode_to_air,直接查就行,不用让 GPT 猜(猜的还容易过期)。

最后分情况:

  • 已完结:全下,下完不留监控任务。

  • 连载中:先下现有的,再加一个监控任务,截止日期设成完结日 + 14 天,到点自己停。

  • 我只要某一集:就下那一集。

平时想加、删、停某部番,直接在 quark-auto-save 的任务页里点:

image.png

飞牛自带的挂载用不了

最开始想省事,直接从飞牛挂载的夸克目录里把文件拷出来。结果刚转存的文件在挂载里看不到。

原因是飞牛的挂载是 rclone 加一层 WebDAV 网关,网关会缓存目录列表;转存走的是夸克官方 API,网关不知道多了文件。

所以干脆不碰挂载,直接调夸克的 download 接口拿签名直链,自己下。

下载只有 100KB/s

链路通了以后开下,速度 0.10 MB/s。一集 1.5GB,要四个多小时。

NAS 上挂着代理,先怀疑的是它。于是拿同一条直链,curl 单线程和 aria2c 16 线程各下一遍:

下载速度对比 · 同一条夸克直链 2026 年 6 月实测 · 同一条直链各下一遍 单线程 curl 96 KB/s ≈ 420× aria2c -x16 ≈ 40 MB/s ( 40,960 KB/s ) 实测一集 1.5 GB:单线程 4+ 小时 → aria2c 37 秒 · 25 集 29GB ≈ 15 分钟 条形为示意,非线性等比
图 2 · 单线程 vs 多线程

curl 96KB/s,aria2c -x16 大约 40MB/s,差了四百多倍。同一条链路跑出来的,所以和代理没关系,是单个连接被限速了,直链 URL 里也带着个 x-oss-traffic-limit 参数。下载器换成 aria2c 之后,那集 1.5GB 的 37 秒下完。

这个结论后来被我自己推翻了一半,放在文末。

查速度的时候顺带抓到一个 bug。夸克的接口偶尔 SSL 握手失败,底层库会把报错直接 print 到 stdout,而我正好用 stdout 传 JSON,于是偶尔解析崩一次。这种偶发的问题放在定时任务里很烦,隔三差五失败一次,还复现不出来。改法是把那段的 stdout 重定向到 stderr,stdout 只走 JSON。

跑一部试试

拿《夏日重现》试的。把链接发给它,让它先说打算怎么弄,再开始:

image.png

25 集 29GB,大概 15 分钟下完,文件名自动改成 夏日重现 - S01E01 - 再见了夏日.mkv 这种,下完微信和 QQ 各推了一条。

接着又发了两部连载的。本地已经有的集它没重下,只加了追更任务和截止日期:

image.png

开源

整理了一下放到 GitHub 上了:

github.com/Fanxiaoyao66/quark-tracker

主要是把对我那个 agent 的依赖去掉,TMDB 改名和通知改成自带、可配置,路径全进配置文件,个人信息清掉。README 中英文都有,里面有一份拿飞牛做例子的教程。协议 AGPL-3.0。

它要和 Cp0204/quark-auto-save 配着用:那边管转存,这边管下载、去重、改名、推送。

后来(2026-11 补)

这套东西跑了快五个月,有几件事和上面写的不一样了,补在这里。

发文第二天全线 403

6 月 16 日开始,夸克的下载直链要带 download 接口下发的一个临时 cookie,只带账号 cookie 一律 403,所有番都下不动。其实接口一直把这个 cookie 跟着响应一起返回,只是我的代码只取了 JSON 那一半,把它扔了。

单连接限速这个说法不全

8 月下载又变慢,重新查了一遍。账号是 SVIP,文件落在正常节点上时,单连接就有 6–30MB/s。慢的是被调度到个别 CDN 节点的文件,每个连接 60KB/s,开 16 线也才 1MB/s。直链的签名和主机名绑定,换个域名直接 403;重新取直链,同一个文件拿到的还是同一个节点。

现在的做法是每集最多下三次,前两次带最低速度限制,低于 2MB/s 就放弃重来,第三次不带,慢也让它下完。只加限速不留最后这一次的话,被钉在慢节点上的文件永远下不下来。

所以标题里的 420 倍是 6 月那一次的实测,不是普遍规律。多线程还是该开,但 6 月那次到底是限速还是正好撞上了慢节点,我现在说不准。

下到一半的文件被当成已下载

判断本地有没有这一集时只排除了 .part,没排除 aria2 的控制文件 .part.aria2。它的文件名里同样带着 S03E08 这样的集号,于是下载一旦中断过,这一集就再也不会被下。

文件夹一改名,整部重下

去重是拿夸克账号里的文件夹名去拼本地路径。本地改了名就对不上,下一个整点又下一份。不光我手动改名会中,TMDB 改名那一步自己把名字改了也会,只是大部分番账号里的名字本来就和 TMDB 的一样,平时不出事。9 月改成按夸克文件的 fid 记台账,同一个文件只下一次。

同一集有两个版本,整轮崩掉

《某科学的超电磁炮T》第 25 集同时有放送版和 Director’s Cut,两个文件解析出同一个集号,排序那一步直接抛 TypeError。之后每小时整轮失败,别的番的新集也跟着不下。现在先按集号分组,撞车的让 agent 挑一个(内容更完整的优先,其次画质),agent 调不通就选体积大的。

8 月 12 日夸克 cookie 失效,整条线一声不吭停了 6 天,直到 18 日收到一条转存失败的推送才发现。10 月 21 日又失效了一次,这次当天就扫码换了新的。

一次整点任务把锁占了 12 个小时

9 月 27 日查出来的。NAS 上的透明代理把夸克的一部分连接走了 IPv6,这些连接卡在握手阶段不返回,而调接口的代码没设超时。于是某一次整点任务一直挂着,把锁占了差不多 12 个小时,后面每小时的任务全被挡在外面。把 NAS 的 IPv6 关了,请求加上超时(连接 8 秒,读取 30 秒)。

fid 台账、同一集多版本、慢节点重试这几项,10 月 13 日一起同步到了开源仓库。

再往上那一层,让 NAS 自己给我推荐番,写在下一篇。