aria2-next

项目概述

Aria2 Next 是经典下载引擎 aria2 的活跃维护分支，延续了它强大的多协议下载能力。它保留 HTTP、HTTPS、SFTP、Metalink、BitTorrent、RPC 与 libaria2 支持，升级到现代构建框架，系统性修复了大量历史问题，并首次加入 ED2K 协议。引擎既能作为命令行工具直接使用，也能通过 JSON-RPC 或 libaria2 被其他程序嵌入调用。

老牌下载引擎的现代化续作，协议更全、依赖更新、问题更少

主要功能

• 多协议下载：支持 HTTP、HTTPS、SFTP、Metalink、BitTorrent 与 ED2K
• 原生媒体下载：解析 HLS 与 MPEG-DASH，支持直播录制并输出 MP4 或 Matroska
• ED2K 支持：包含服务器与 Kad 发现、搜索、分享、上传队列与协议混淆
• JSON-RPC 服务：提供远程控制接口，方便前端与自动化脚本调用
• 容器镜像：官方发布 Linux x86_64 与 ARM64 的 Docker 镜像
• 断点续传：使用 SQLite 保存会话与校验过的续传状态
• 高级控制：覆盖磁盘队列、连接调度、文件优先级与 Web 种子等选项

适用人群

• NAS 与下载机用户
• 需要多协议下载的开发人员
• 搭建 RPC 下载服务的运维人员
• 使用 aria2 前端的进阶用户

快速上手

直接使用

1. 打开 Releases 页面，下载对应平台的可执行文件
2. Linux、macOS 与 Android 若丢失执行权限，执行 chmod +x ./aria2-next-<version>-<platform>
3. 执行 aria2-next https://example.com/file.iso 下载文件
4. 执行 aria2-next <ed2k-file-link> 下载 ED2K 链接
5. 执行 aria2-next --enable-rpc --rpc-listen-port=6800 启动 RPC 服务
6. 用 Docker 运行官方镜像，命令见下

docker run -d --name aria2-next -p 6800:6800 -v ./downloads:/downloads -v ./state:/var/lib/aria2-next ghcr.io/aninsomniacy/aria2-next:latest

从源码构建

1. 配置工程：cmake --preset default
2. 构建：cmake --build --preset default
3. 运行测试：ctest --preset default
4. 确认版本：build/default/aria2-next --version

cmake --preset default
cmake --build --preset default
ctest --preset default

核心优势

• 协议齐全：一个二进制覆盖 HTTP、BT、ED2K 与媒体流下载
• 依赖现代：使用 libcurl 8 与 libtorrent 2.1，适配新平台
• 容器友好：官方镜像开箱可用，支持 PUID 与 PGID 权限映射
• 接口兼容：沿用 aria2 的命令行、配置格式与 RPC 约定
• 持续修复：长期积累的上游问题已被系统修复

系统要求

注意事项

• Linux 发布版二进制需要 glibc 2.35 或更新版本
• 旧版 aria2 的任务状态与 .aria2 控制文件不会被导入
• 在可信网络之外暴露 RPC 前应设置 --rpc-secret 令牌
• 容器运行需提供 PUID 与 PGID 环境变量
• 请让会话与任务状态保存在 --state-dir 指定的目录