跳转到主要内容

aria2.conf 配置文件生成器

为你的 aria2 快速创建高性能配置文件。自由调整连接参数、测速限额、一键拉取高可用 BT Tracker 节点、开启 WebUI RPC 远程控制并即刻导出 aria2.conf 文件。

快速预设配置:

基础与存储路径设置

连接数与带宽限制

5
16
10
不限速
不限速

RPC 远程控制 (适用于 AriaNg / Web 控制台)

BitTorrent 调优与公共 Tracker 同步

1.0
60s
自动拉取最新公共 BT Tracker 节点
一键将经过验证的活跃 BitTorrent Tracker 列表注入到配置文件中,最大化 Peers 节点发现率。
aria2.conf (实时预览)

每个选项的作用

生成的每个键都与一个 aria2c 参数一一对应。以下是最常改动的。

生成的键、默认值与作用
键默认作用
dir(当前目录)保存完成文件的目录。
max-concurrent-downloads5同时运行的下载数量。
max-connection-per-server1每主机套接字数(最多 16)。最大的提速杠杆。
split5将文件分为 N 个分片并行下载。
file-allocationprealloc空间预留方式:none、prealloc、trunc、falloc。
max-overall-download-limit0(不限)限制总下载速度(如 5M)。
max-overall-upload-limit0(不限)限制总上传速度。
enable-rpc / rpc-secret关闭启动 JSON-RPC 服务器并用令牌保护。
daemonfalse后台(无界面)运行。
seed-ratio1.0达到该上传/下载比后停止做种(0 = 永久)。
save-session / input-file—持久化队列,重启后续传。
bt-tracker—用于 BitTorrent 的逗号分隔公共 Tracker。

完整列表见选项参考或官方手册。

该选哪个预设?

极速 / 千兆

16 连接与分片、falloc。适合高速线路与 SSD 追求最大吞吐。

NAS 与家庭服务器

守护进程 + RPC 开启、prealloc。适合 NAS 或家庭服务器的安全常驻基线。

精简 CLI

无守护进程、无 RPC、连接适中。适合笔记本上的临时下载。

私有 Tracker (PT)

seed-ratio 0(永久做种)及私有站点期望的设置。如站点要求请禁用 DHT/PEX。

用你的配置运行 aria2

aria2 会自动从默认位置读取 aria2.conf,或从你用 --conf-path 指定的路径读取。

# 仅需一次:创建会话文件(缺少该文件时 aria2 无法启动)
mkdir -p ~/.aria2 && touch ~/.aria2/aria2.session

# 保存文件后运行(默认读取 ~/.aria2/aria2.conf)
aria2c

# 或指定具体文件
aria2c --conf-path=/opt/aria2/aria2.conf

# 若配置中已启用,使用守护进程(后台)模式
aria2c --conf-path=/opt/aria2/aria2.conf --daemon=true

之后即可通过在线 WebUI或 AriaNg 管理该 RPC 守护进程。

故障排查

aria2 提示“option 'x' is not recognized”

你的 aria2 版本较旧,或键名拼写有误。请在选项参考中核对名称并更新 aria2。

使用此配置后 WebUI 无法连接

确认存在 enable-rpc=true、非空 rpc-secret 以及用于局域网的 rpc-listen-all=true,然后重启 aria2。

重启后下载从 0 开始

加入 save-session、input-file、save-session-interval,并保持 continue=true。会话文件需放在持久目录中。

该用哪种 file-allocation 模式?

现代 Linux/macOS 用 falloc,不支持时用 trunc,闪存用 none,最大兼容性用 prealloc。见速度指南。