aria2配置文件是下载器的“总控制台”，通过编辑它才能管理多线程数、速度限制和BT做种行为；不同系统的默认路径不一样，写错或没加载都会让你改了个寂寞。
aria2配置文件放在哪里？基础语法要掌握
各操作系统的默认查找路径
aria2启动时按顺序搜索这些位置：
- Linux：
$HOME/.aria2/aria2.conf，系统级配置在/etc/aria2.conf - macOS：
$HOME/.aria2/aria2.conf - Windows：
%APPDATA%aria2aria2.conf，具体在C:Users你的用户名AppDataRoamingaria2aria2.conf
如果你不确定当前加载了哪个文件,直接用命令指定路径最稳：
aria2c --conf-path=/etc/aria2/aria2.conf
加上 --no-conf 可跳过所有配置文件,查看默认参数跑起来的样子。
语法规则只有三条
- 每行一条参数，格式是
参数=值，max-concurrent-downloads=5 - 开头是注释，多写注释方便以后自己看懂
- 参数值不需要引号，开关类型用
true或false
改完配置文件，必须重启 aria2 进程，或者发送 SIGHUP 信号，命令行操作就是 kill -1 <aria2的PID>，不改就不生效,这是新手最常踩的坑。
aria2配置文件常用参数怎么选才算合理
提升下载速度的组合
下载慢，多数时候是单文件连接数不够,推荐这样配：
max-concurrent-downloads=5
max-connection-per-server=16
split=16
min-split-size=1Msplit 是把文件拆成几块同时拉取的数，max-connection-per-server 是每台服务器的连接上限，两者取最小值生效，HTTP 下载场景下，split=16 是比较均衡的做法,再高反而容易被服务器拒绝连接。
控制磁盘占用与文件分配
file-allocation=falloc 可以预分配磁盘空间，减少写入碎片，ext4 文件系统支持 falloc，Windows 的 NTFS 改用 trunc 更兼容。continue=true 打开断点续传,遇到临时中断不用从头再来。
速度限制的两种写法
- 全局总限速：
max-overall-download-limit=100M，设0表示不限 - 单任务限速：
max-download-limit=50M，同样以0表示不限制
做种时设置 max-upload-limit=50K，能防止上行占用把网页浏览拖垮，业内专家指出，上传限速对整体下载稳定性的影响非常有限，不必迷信“宽带上行满了下载就慢”。
会话保持与断电恢复
save-session=/etc/aria2/aria2.session
input-file=/etc/aria2/aria2.session
save-session-interval=60这三行的作用是：每隔60秒把未完成任务写入会话文件，下次启动时通过 input-file 自动载入，断电、手动退出、机器重启,任务都能接上。
一份能直接用的aria2配置文件示例
完整配置块
## 基础设置
dir=/root/downloads
continue=true
max-concurrent-downloads=5
## 连接设置
max-connection-per-server=16
split=16
min-split-size=1M
## 速度限制
max-overall-download-limit=0
max-upload-limit=50K
## 会话保存
save-session=/root/aria2.session
input-file=/root/aria2.session
save-session-interval=60
## BT设置
enable-dht=true
enable-dht6=true
enable-peer-exchange=true
seed-ratio=0
seed-time=0
## 其他
file-allocation=falloc
disk-cache=16M典型项的取舍逻辑
dir注意目录必须存在，aria2不会自动创建disk-cache=16M是内存缓存，小内存设备可以砍到4Mseed-ratio=0配合seed-time=0，表示不限做种比例和时间，适合保种用户- 不下载BT时，
enable-dht等参数开不开都行
针对网络环境优化aria2.conf，解决下载速度慢的问题
家用宽带场景：适度并发更稳
家用下行带宽普遍充足，可以放宽并发，行业共识认为，超过 max-concurrent-downloads=8 时，多数下载源的服务器会主动限流，速度快不了多少，CPU占用反而明显上涨,推荐：
max-concurrent-downloads=8
max-connection-per-server=16如果你仍觉得下载速度慢，先查 min-split-size，这个值设太大，小于该值的小文件就不会分段，线程再多也没用，把 min-split-size 从 16M 改成 1M,小文件也能跑满多线程。
路由器或低配设备场景：瘦身优先
OpenWrt 路由器、树莓派这类设备上，内存和CPU都紧张,配置要主动降级：
max-concurrent-downloads=2
max-connection-per-server=8
file-allocation=none
disk-cache=4Mfile-allocation=none 避免预分配时的卡顿，disk-cache 调小能腾出内存给系统。
BT和PT做种场景：按规则调整
PT站通常要求禁用DHT和PEX,否则会被判定为非法客户端：
enable-dht=false
enable-dht6=false
enable-peer-exchange=false
bt-enable-lpd=false
bt-tracker=具体Tracker地址公网BT下载则要反过来，保持 enable-dht=true，否则无法发现额外节点，BT速度主要由做种人数決定，配置文件改不出种子健康度,这个认知要有。
aria2配置文件常见错误自查清单
启动时报错“Unknown option”
参数名拼写错误，或者版本太低不支持新选项，先运行 aria2c --help=#all，对照当前版本支持的参数列表,再逐行检查配置文件。
修改了配置但没有变化
这一条有多个可能性：
- 进程没重启，配置文件不会热更新
- 命令行里用
--conf-path指定了别的文件，当前进程读取的根本不是这个 - 同一个参数在命令行和配置文件都出现时，命令行优先
验证方法是启动时观察日志里的 Loaded configuration 一行,它会显示实际加载的配置路径。
下载任务报“找不到目录”
dir= 指定的目录不存在，aria2不会自动创建，先手动 mkdir -p /root/downloads,再启动下载。
Windows系统下中文乱码
配置文件保存编码必须选 UTF-8，用记事本另存为时在编码下拉框选 UTF-8，不要用 ANSI,乱码会导致路径或文件名参数解析失败。
关于aria2配置文件的高频问答
问：怎么在aria2配置文件里修改默认下载目录？
答：找到 dir= 这一行，改成绝对路径。dir=/data/downloads，Windows 建议使用正斜杠：dir=C:/Downloads,避免反斜杠在某些参数里被当场转义符。
问：为什么改了 aria2.conf 后总是不生效？
答：先确认进程有没有重启，执行 pkill aria2c 后，再用 aria2c --conf-path=/你的路径/aria2.conf 启动，看启动日志中 Loaded configuration 是否指向该文件，如果同时用了 RPC 模式，还要确认 RPC 服务是否需要额外开启 --rpc-save-upload-metadata=false 这类参数，文件改了但进程不重启,配置永远停留在旧状态。
问：aria2 配置如何实现开机自启？
答：Linux 下写 systemd 服务，在 /etc/systemd/system/aria2.service 中把 ExecStart 设为 /usr/bin/aria2c --conf-path=/etc/aria2/aria2.conf，加上 Restart=always，systemctl enable aria2，Windows 用 NSSM 把 aria2c 注册成服务，macOS 使用 LaunchAgent plist 文件传入 --conf-path 参数。
配置文件这东西，只要路径正确、语法没错、进程重启后生效，基本就稳定了，真正折腾的时间都花在调试参数数值上，多试几次,心里就有了自己的模板。