Aria2 Next 是基于 aria2 分支创建的开源项目,旨在解决原版开发停滞、依赖陈旧及遗留 Bug 等问题。该项目在保持原有命令行、配置文件和 JSON-RPC 兼容性的同时,对底层进行了现代化重构:HTTP/HTTPS 迁移至 libcurl(支持 HTTP/2 多路复用),BitTorrent 升级至 libtorrent-rasterbar 2.1,并移除了 FTP 等旧协议栈。
核心新增能力包括原生 ED2K/eMule 支持、原生 HLS (.m3u8) 与 DASH (.mpd) 流媒体下载(支持直播录制与清晰度选择)。项目目前活跃更新中(v2.8.2 发布于 2026-09-24),提供独立二进制文件与 Docker 镜像,RPC 默认端口仍为 6800,可无缝对接 AriaNg 等现有前端。
核心改进与新增能力
🆕 原生协议支持
| 协议 | 能力说明 |
|---|---|
| ED2K/eMule | 原生支持电驴链接,集成服务器/Kad 发现、对等传输、搜索、共享、上传队列、协议混淆及持久身份;通过标准 CLI/RPC 操作 |
| HLS (.m3u8) | 原生解析播放列表,支持表示选择、直播录制、暂停续传;直接输出 MP4/Matroska 无需转码 |
| DASH (.mpd) | 同上,支持自适应码率与分段合并 |
🔧 底层架构重构
- HTTP/HTTPS/SFTP/Metalink:全面切换至 libcurl 8.21 + nghttp2
- 事件驱动多套接字 API、HTTP/2 多路复用、共享 TLS 会话
- 范围感知 SQLite 恢复状态,自适应验证字节范围
- 智能重试:429/503 按代递减并发,进度恢复后自动回升;403 不降低并发预算
- 重定向目标缓存与刷新机制,避免重复签名请求
- BitTorrent:升级至 libtorrent-rasterbar 2.1
- 完整支持 Magnet、DHT (v4/v6)、PEX、uTP、BT v1/v2、传输加密
- 磁力下载 GID 生命周期统一管理,
pause-metadata=true下安全替换句柄 - 会话持久化含 DHT 路由、快速恢复数据、tracker 层级压缩
- 私有种子与全局 tracker 注入隔离
- 移除项:FTP 协议栈、自定义流协议栈、相邻
.aria2控制文件
🔄 兼容性契约
| 接口 | 状态 |
|---|---|
| 可执行文件 | aria2-next(独立二进制) |
| CLI / 配置 | 维护 aria2 选项格式,退役选项自动映射或警告 |
| JSON-RPC | 兼容 aria2 方法 + 原生扩展;默认端口 6800 |
| libaria2 | 公共头文件保留,选项规范化兼容 |
| 会话文件 | 不导入遗留 .aria2 控制文件;使用新格式 |
⚠️ 注意:Linux 二进制需 glibc ≥2.35(Ubuntu 22.04+ 基线);未知选项报错,已知退役选项给出警告。
快速上手指南
命令行基础
# 普通 HTTP 下载
aria2-next https://example.com/file.iso
# ED2K 链接下载
aria2-next '<ed2k://|file|...|h=...|/'
# 启动 RPC 服务(兼容 AriaNg)
aria2-next --enable-rpc --rpc-listen-all=false --rpc-listen-port=6800
# 查看版本与功能
aria2-next --version
aria2-next --help=#ed2k
Docker 部署
docker run --rm \
-e PUID="$(id -u)" \
-e PGID="$(id -g)" \
ghcr.io/aninsomniacy/aria2-next:latest --version
NAS/服务器用户可直接挂载卷并映射 6800 端口用于 RPC 管理。
技术亮点详解
- 流媒体进度真实化:HLS/DASH 使用呈现时长(presentation duration)而非虚构文件大小报告进度
- HTTP 工作器智能调度:有界工作器集合跨地址族负载均衡;快工作器协助未完成范围,不干扰其他传输路径
- BT 元数据安全切换:磁力暂停状态下保留完整文件列表与选择状态,提交 select-file 后原子替换为带优先级的 libtorrent 句柄,杜绝陈旧分块污染
- 运行时诊断增强:JSON-RPC 实时暴露对等发现、tracker 状态、磁盘队列、协议开销及聚合性能警告
- 自动文件名解码:流任务 URL basename 仅解码一次,显式
--out保持字面量
适用场景
✅ 推荐使用:
- 需要下载 .m3u8/.mpd 流媒体且不想依赖 ffmpeg 封装
- 访问老旧 ED2K 资源并希望统一下载工具链
- 现有 aria2 脚本/AriaNg 前端用户寻求无痛升级
- 高并发 HTTP 下载场景(HTTP/2 多路复用 + 智能重试)
- BT v2 / 混合协议环境
⚠️ 注意事项:
- 非向后兼容会话:无法读取旧版
.aria2控制文件,迁移需重新添加任务 - FTP 已移除:依赖 FTP 的用户需保留原版 aria2 或改用 curl/wget
- glibc 要求:CentOS 7/Ubuntu 18.04 等老系统无法运行官方二进制
- ED2K 网络现状:虽协议支持完整,但公网 Kad/服务器节点稀少,实际速度取决于资源热度
- 流媒体 DRM:不支持加密 HLS/DASH(如 Widevine),仅限开放流










