.aria2 文件是什么?
结构、断点续传与恢复
aria2 控制文件完全指南:它是什么、为什么出现在下载文件旁边、多连接续传的原理、磁盘上的二进制布局,以及如何精确恢复未完成的下载 — 附浏览器内检查器。
最后核对 2026-09 · aria2 v1.37.0
.aria2 文件是 aria2 在未完成下载旁写入的小型二进制控制文件(例如 ubuntu.iso 旁边的 ubuntu.iso.aria2)。它记录哪些分片已校验并存在于磁盘上,使 aria2 能开启多条并行连接,并在崩溃、重启或断网后从精确的字节位置继续。达到 100% 且通过完整性校验后,aria2 会自动删除它。
它是什么 — 以及不是什么
它是…
- 一个未完成下载的二进制进度/控制文件
- 可以安全保留 – 正是它让续传成为可能
- 与去掉扩展名的同名真实文件成对出现
- aria2 重启时会自动重建
它不是…
- 你下载的文件(它没有可打开的内容)
- 可以修复或转换的损坏媒体/文档文件
- 可转换为 MP4/ZIP 的东西 – 你应当完成下载
- 本身就是病毒 – 但请参阅下方安全提示
命名规则
控制文件就是在目标名后追加 .aria2:
movie.mkv.aria2 → 目标 movie.mkv
big-archive.zip.aria2 → 目标 big-archive.zip
控制文件实际做什么
仅几 KB 的元数据,承担三个作用。
按分片而非字节
aria2 把每个文件切成固定大小的分片并维护位图:位 1 = 该分片已验证并存在,0 = 尚缺。这让最多 16 条并行连接也不会损坏文件。
精确、无损的续传
断电、崩溃或 Wi-Fi 断开后,aria2 重新读取位图,只补下缺失分片 – 绝不从 0% 重来。
自动清理
当所有分片齐全且校验通过,aria2 会删除 .aria2 文件,只留下完成的文件。
在线 .aria2 文件头检查器
在浏览器本地检查 .aria2 控制文件 — 查看目标大小、分片大小以及已校验的分片数。不会上传任何数据,文件不会离开你的设备。
将 .aria2 控制文件拖到此处检查
或点击从本地磁盘选择
这是针对常见控制文件(版本 1)布局的尽力读取器。请勿改动原文件;检查器只读取副本。
底层:二进制布局
aria2 技术说明中记载的控制文件结构(版本 1,大端序)。H = 10 + InfoHash 长度,即 HTTP/FTP 下载为 10,BitTorrent 为 30。上方检查器读取的正是这些字段。
| 字节偏移 | 类型 | 字段 | 含义 |
|---|---|---|---|
| 0x00–0x01 | uint16 | version | 格式版本。aria2 写入的是版本 1。 |
| 0x02–0x05 | uint32 | extension | 扩展标志。最低位为 1 时,aria2 会检查保存的 InfoHash 是否与当前下载一致。 |
| 0x06–0x09 | uint32 | info hash length | 其后 InfoHash 的长度:BitTorrent 为 20,HTTP/FTP 为 0。 |
| 0x0A…H−1 | bytes | info hash | SHA-1 BitTorrent InfoHash(HTTP/FTP 下载没有此字段)。 |
| H…H+3 | uint32 | piece length | 每个分片的大小(例如 1048576 = 1 MiB)。 |
| H+4…H+11 | uint64 | total length | 目标文件的总字节数。 |
| H+12…H+19 | uint64 | upload length | 已上传的字节数(BitTorrent)。 |
| H+20…H+23 | uint32 | bitfield length | 位图(bitfield)的字节长度。 |
| H+24… | bitfield | piece bitfield | 每个分片 1 位:1 = 已完整写入磁盘,0 = 缺失。 |
| 位图之后 | records | in-flight pieces | 部分下载的分片数量,以及每个分片的索引、长度和以 16 KiB 块为单位的位图。 |
你无需手动编辑此文件。它的存在只是为了让 aria2 管理未完成的下载。
下载恢复实战手册
六个真实场景与确切命令。无论哪种情况,都要把未完成的目标文件与其 .aria2 文件放在一起。
A. 正常中断(断电或断网)
把 ubuntu.iso 与 ubuntu.iso.aria2 留在同一目录,只需加上 -c(continue):
B. 签名下载 URL 已过期
云盘主机(Google Drive、1Fichier 等)使用短时效签名链接。只要大小与分片布局一致,aria2 就能用全新的 URL 续传:
- 在浏览器中获取同一文件的新 URL。
- 确保部分文件与其
.aria2文件共享相同的目标名(例如target.zip+target.zip.aria2)。 - 运行
aria2c -c -o "target.zip" "新URL"。
aria2 会重新接上已有位图并继续。若服务器无法提供缺失的字节范围,它会重新开始 – 这是预期行为,不是缺陷。
C. 怀疑磁盘损坏 — 校验每个分片
下载剩余部分之前,让 aria2 重新检查磁盘上已有的数据:
D. 在 GUI 中续传(Motrix、AriaNg、Aria2App)
GUI 前端做的是同一件事:打开应用,重新添加同一个下载(相同 URL 与输出名),它会从已有分片继续。或者配置 --save-session/--input-file 后重启 aria2,它会自动续传。见 GUI 列表或使用在线 WebUI。
E. 把部分下载移到另一台机器
- 将部分目标文件与
.aria2文件两者以相同名称一起复制。 - 在新机器上运行相同命令(带
-c)或加载会话。 - aria2 校验已有分片并继续。
F. BitTorrent / 磁力链接
种子也使用同一控制文件(file.torrent.aria2,或由 info hash 派生的名称)。在做种已完成种子期间,.aria2 文件会保留 – 这是正常的。达到 seed-ratio/seed-time 或移除任务后,aria2 会删除它。
删除 .aria2 文件安全吗?
| 你的目标 | 删除 .aria2? | 结果 |
|---|---|---|
| 完成/继续下载 | 否 | 删除会迫使 aria2 从 0% 重新开始。 |
| 取消并丢弃部分文件 | 是 | 删除两个文件;下载被放弃。 |
| 下载已 100% 完成 | 不必 | aria2 会自动删除(做种期间除外)。 |
| 播放器提示文件损坏 | 否 | 文件未完成 – 应续传而非删除。 |
安全规则
- 切勿把一个
.aria2文件用于另一个文件 — 其位图不匹配,可能导致结果损坏。 - 不要只重命名目标文件而不重命名控制文件(反之亦然)– 两者必须同名。
- 对来自不可信来源的
.aria2文件,请像对待任何未知下载一样谨慎:它是元数据,但你无法像对自己获取的文件那样核实其来源。
.aria2 与其他未完成文件格式
为什么分片级位图比线性临时流更适合续传。
| 下载器 | 临时文件 | 多连接 | 续传粒度 |
|---|---|---|---|
| aria2 | .aria2 |
支持(每主机最多 16) | 精确到分片 |
| Chrome / Edge | .crdownload |
不支持(单流) | 仅线性偏移 |
| Firefox | .part |
不支持(单流) | 仅线性偏移 |
| Internet Download Manager | IDM_*.tmp |
支持(最多 32) | 专有重组 |
故障排查
100% 后 .aria2 文件没有被删除
通常是因为 BitTorrent 仍在做种(aria2 做种期间会保留控制文件),或完整性校验未通过。停止做种或移除任务后 aria2 会清理它。若数据尚未封存,对目标运行 aria2c -c --check-integrity=true。
每次下载都从 0% 重新开始
控制文件缺失、放错目录、被重命名,或与目标不匹配。把 file.ext 与 file.ext.aria2 放在一起并用 -c 运行。确保每次的输出名(-o)一致。
打开部分文件时提示“文件损坏”
它只是未完成。.aria2 文件存在意味着 aria2 还没有写完所有分片。续传即可;完成后文件有效,控制文件会消失。
我看到很多 .aria2 文件
每个未完成的下载都有自己的控制文件;一个种子可能留下多个。完成或取消每个任务即可清理;不要删除你还打算续传的控制文件。
常见问题
为什么我的视频或 zip 下载显示为 .aria2?
并没有。你的真实文件(如 movie.mp4)就在控制文件 movie.mp4.aria2 旁边。在 .aria2 仍存在时打开 .mp4,播放器会提示“损坏”,因为部分分片尚未写入。
能把 .aria2 文件转换为 MP4 或 ZIP 吗?
不能。.aria2 文件不包含媒体/文档数据,只有进度元数据。用 aria2、Motrix、AriaNg 或 WebUI 完成下载;之后真正的 .mp4/.zip 就完整了,控制文件会被删除。
如果我不小心删除了 .aria2 文件呢?
aria2 丢失了已校验分片的地图,下次将从 0% 开始。若部分数据完好,有时可用 --check-integrity=true 抢救,否则只能重新下载。
能打开或编辑 .aria2 文件吗?
它是二进制而非文本。你无需打开它;可用上方检查器读取关键字段,或交给 aria2 管理。
aria2 把控制文件写在哪里?
在下载目录(--dir)中、目标文件旁边。只重命名或移动其中一个会破坏续传。
做种期间会保留 .aria2 文件吗?
会。种子做种期间,aria2 保留控制文件以跟踪和校验分片。做种结束或移除任务后会被删除。
相关资源
- 选项参考 —
continue、check-integrity、auto-file-renaming等 - 故障排查 — 更广泛的 aria2 错误与具体修复
- 在线 WebUI — 在浏览器中续传与管理下载
- aria2 工具 — WebUI、Tracker 列表与配置生成器
- 完整 aria2 文档