aria2 中文文档 下载 App

配置文件放哪里:默认路径与 --conf-path 指定

查找顺序

aria2 启动时自动找配置文件,按官方手册的规则:

  1. 先看旧路径:$HOME/.aria2/aria2.conf(Windows 下即用户主目录的 .aria2 文件夹);
  2. 旧路径不存在,再看 XDG 路径:$XDG_CONFIG_HOME/aria2/aria2.conf。

找到哪个用哪个;都找不到就全默认参数启动,不会报错。

文件格式

纯文本,一行一条,格式为 参数名=值——参数名就是命令行长参数去掉 -- 的形式,# 开头是注释:

# 每行一个参数
dir=D:\Downloads
continue=true
max-connection-per-server=16

三种干预方式

方式命令效果
指定路径aria2c --conf-path=我的配置.conf用指定文件替代默认
禁用配置aria2c --no-conf完全忽略配置文件
默认aria2c按上面顺序自动找

调试参数冲突时,--no-conf 一下还原到纯命令行环境最干净。

建议的文件权限

配置里可能存密钥、代理账号等敏感信息。官方建议收紧文件权限(如 chmod 600 aria2.conf),避免同机其他用户读到;Windows 下把文件放在个人用户目录内也可减少暴露面。

${HOME} 展开

配置文件不走 shell,环境变量不会自动展开;但 aria2 对一批文件类参数主动展开 ${HOME},包括 dir、out、input-file、save-session、load-cookies、log、dht-file-path 等。写配置时用它引用主目录,换机器不用改路径。

下一步

拿一份逐行注释的现成模板:配置模板;搞清命令行与配置谁覆盖谁:参数优先级。