夜雨聆风学习资料网

ARTICLE · 1123170

不用另装 Aria2:三步让下载软件直连飞牛下载中心

不用另装 Aria2:三步让下载软件直连飞牛下载中心

飞牛的「下载中心」,应该是我在 NAS 上用得最多的功能:磁力、BT、HTTP 直链都收,任务统一管理,文件直接落进存储池。

但它有个说不上是缺点的限制——只服务飞牛自己。

外面那些下载软件,还有一堆只让你填 host / port / secret 的小工具,认的都是 Aria2 的协议。想让它们把任务交给飞牛下载中心?接不进来,一个都不行。

理论上有个笨办法:在 NAS 上另装一套 Aria2,装好了再把目录、端口、密钥一一配上。可行,但这就变成了「为一个翻译问题,请一个新住户进门」——下载引擎从一个变成两个,下载记录从此两套,而且 Aria2 本身的安装配置也不算省心。

我最后选了另一条路:写了个飞牛原生应用「下载中心接入Aria2」(包名 aria2bridge),让它替下载中心学会说 Aria2 的话。

翻译层在链路中的位置:一边说 Aria2,一边说飞牛

一、它做的事:一个翻译层

原理一句话就能说清:这个应用在 NAS 本机监听 6800 端口——和 Aria2 官方默认端口一模一样——对外表现成一个标准的 Aria2 JSON-RPC 服务。

下载软件那边以为自己在连 Aria2,实际上请求被逐条翻译成飞牛下载中心的接口调用:添加任务翻译过去,查询进度再翻译回来。所以不只是任务推得进去,速度、进度、暂停 / 继续 / 删除,两边都是双向同步的——你在飞牛网页端暂停一个任务,软件里看到的状态也会跟着变。

不碰私有端口。桥接走的是飞牛自己的官方接口通道,不逆向引擎、不改系统行为。

登录态自愈。会话失效会自动用配置里的账号重登,不用手动重启应用。

零依赖。纯 Python 标准库实现,不用装任何 pip 包。

二、安装:三步

第 1 步,导入 fpk。应用中心 → 手动安装 → 上传 aria2bridge.fpk,会提示「未经验证应用」,确认继续即可。没装过 Python 3.12 环境的机器,飞牛会连带装上,不用管。

第 2 步,填安装向导。四个字段:飞牛账号、密码、监听端口(默认 6800,不用改)、Aria2 密钥(有默认值,建议改成自己的)。

安装向导:账号、密码、监听端口与 Aria2 密钥

有一个必须提前说的坑:接入用的账号不能开两步验证,开了会登录失败。账号密码只保存在 NAS 本机的应用配置目录里,除了登录飞牛自己的接口,不往任何地方发送。

第 3 步,打开状态页自检。装完桌面会多一个图标,点开是应用状态页,点一下「自检」,看三行结果:login(登录态)、task_query(任务接口)、default_save_dir(默认保存目录)。三行都正常,桥接就通了。

状态页:接入参数一键复制,自检三关一次看全

三、接入:四个参数填进下载软件

状态页第一张卡片就是接入参数,每行带「复制」按钮:

· 主机:NAS 的局域网 IP· 端口:6800· 密钥:向导里设置的那个· RPC 地址:http://<NAS-IP>:6800/jsonrpc

不管哪款软件,配置项都绕不开这几个:host 填 NAS 局域网 IP,port 填 6800,secret 填你的密钥,保存路径留空即可——留空的任务会统一落到下载中心自己的默认目录。各家界面叫法不一,有的填一条 RPC 地址加密钥就够,本质是同一组参数。

配好之后可以立刻验证:在软件里添加一个下载任务,切到飞牛网页端,它会出现在下载中心的任务列表里;在下载中心暂停它,软件里的状态同步变「已暂停」。这一来一回都通,就彻底成了。

一推一回,双向都通才算接好了(示意图)

四、边界,提前讲清

不支持 ed2k。上游接口只认 http / https / ftp / sftp / 磁力,ed2k 会被直接拒绝。

只翻译协议,不改策略。做种比例、限速、连接数这些仍然由下载中心自己管。

目前只有 x86 包。Intel / AMD 机型可用,ARM 机型暂时没有。

状态页不带鉴权。局域网里能打开 6800 的人就能看到密钥——所以别把这个端口映射到公网,密钥也别用默认值。

写在最后

这个包没打算做成通用下载器,它只干一件事:让飞牛下载中心被外面那些软件用起来。装完在软件里点一下下载、切到飞牛网页看任务在跑,这件事就算成了。

版本 1.0.9,x86 安装包约 3.36 MB。包内是明文 Python,没有混淆,把 fpk 当压缩包解开就能读源码——不放心的话,先看代码再装。

◆ ◆ ◆

下载(夸克网盘):pan.quark.cn/s/9ac24706ef83

你的 NAS 上还有哪个功能被「只服务自己」锁着?评论区聊聊。

相关学习资料