ARTICLE · 1123170
不用另装 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 上还有哪个功能被「只服务自己」锁着?评论区聊聊。