aria2 配置文件是 aria2 下载器的行为控制中心，把路径、RPC 密钥、并发数、磁盘缓存和 BT 做种参数写对，就能让下载速度和稳定性上一个台阶。 很多人下载完 aria2 后直接双击运行，结果 RPC 连不上、速度上不去、磁盘频繁读写，问题往往不在网络，而在配置文件没按场景调整，下面从路径、参数、优先级到安全维护，一步步拆开。
aria2 配置文件怎么用？先搞懂加载顺序和路径
配置文件长什么样
aria2 的配置文件通常是纯文本，每行一个参数，格式为 参数名=值，注释以 开头，默认情况下，aria2 会尝试读取 $HOME/.aria2/aria2.conf（Linux/macOS）或 %USERPROFILE%.aria2aria2.conf（Windows），也可以启动时用 --conf-path 指定，示例：
dir=/downloads
continue=true
max-concurrent-downloads=5
split=16
min-split-size=10M常用核心参数：
dir：下载目录continue：断点续传max-concurrent-downloads：同时下载任务数split：单任务连接数min-split-size：分片最小大小max-connection-per-server：每服务器最大连接disk-cache：磁盘缓存，减少 I/Orpc-secret：RPC 密钥，安全关键
加载顺序与命令行优先级
行业共识认为,aria2 的参数来源有优先级：命令行参数 > 配置文件 > 默认值，也就是说，如果你在命令行写了 --max-concurrent-downloads=10，配置文件里的同名项不会生效，这个规则能帮你排查“改了配置没反应”的问题，操作路径：启动时加 --conf-path=/path/to/aria2.conf，再用 aria2c --conf-path=... --max-concurrent-downloads=10 测试，如果速度变化，说明命令行覆盖成功。
实操：创建并启动
Linux/macOS：
mkdir -p ~/.aria2
nano ~/.aria2/aria2.conf
aria2c --conf-path=~/.aria2/aria2.confWindows：
- 新建文件夹
%USERPROFILE%.aria2 - 新建
aria2.conf
- 在 PowerShell 运行
aria2c --conf-path="$env:USERPROFILE.aria2aria2.conf"
Windows 下 aria2 配置文件路径在哪？不同启动方式拆解
Windows 用户常问路径，其实取决于启动方式，下面分场景。
手动命令行启动
默认会找 %USERPROFILE%.aria2aria2.conf，如果不存在，就用内置默认值，你可以用 aria2c --conf-path=D:aria2aria2.conf 显式指定，注意路径不要有中文和空格，或者用引号包住。
作为服务或开机自启
用 NSSM、WinSW 等工具把 aria2 注册为服务时，启动参数里的 --conf-path 必须写绝对路径。
aria2c --conf-path=D:aria2aria2.conf服务账户如果是 LocalSystem，%USERPROFILE% 会变成系统目录，导致读不到你的配置文件，建议用固定路径，D:aria2aria2.conf。
配合 AriaNg 等前端
AriaNg 本身不读 aria2 配置文件，它通过 RPC 连接 aria2，所以你要在 aria2.conf 里设置：
enable-rpc=true
rpc-listen-all=true
rpc-secret=你的密钥
rpc-listen-port=6800然后在 AriaNg 设置里填入 http://127.0.0.1:6800/jsonrpc 和密钥，如果连接失败，先检查防火墙和 rpc-listen-all。
aria2 配置文件与命令行参数哪个优先？对比规则与冲突案例
很多人同时用配置文件和命令行,结果参数打架，这里直接给结论。
优先级规则
- 命令行参数优先级最高。
- 指定的配置文件。
- 默认值。
- 如果配置文件里写了
rpc-secret=abc，命令行又写了--rpc-secret=xyz，最终生效的是xyz。
常见冲突案例
配置文件写了 max-concurrent-downloads=5，但启动脚本里加了 --max-concurrent-downloads=20，实际同时下载 20 个，解决：删掉命令行里的同名参数，或统一到配置文件。
配置文件路径写错,aria2 静默使用默认值，表现为“怎么改都没用”，解决：启动时加
--log-level=debug，看日志里读的是哪个路径。
调试方法
- 启动时加
--log-level=debug，日志会显示读取了哪个配置文件。 - 用
ps aux | grep aria2c或 Windows 任务管理器查看完整命令行。 - 临时把配置文件改名,对比行为差异。
BT 下载场景：aria2 配置文件优化要点
BT 下载和 HTTP 下载的配置重点不同，BT 更吃连接数、DHT 和磁盘。
做种与 DHT 参数
enable-dht=true
enable-dht6=true
bt-enable-lpd=true
bt-max-peers=64
seed-time=0
seed-ratio=1.0seed-time=0 表示下载完不做种，适合只下不传的场景。seed-ratio=1.0 表示分享率达到 1.0 后停止做种，如果不想限制，可以设为 0。
磁盘缓存与文件分配
BT 下载随机写入多，磁盘容易成为瓶颈，设置：
disk-cache=64M
file-allocation=fallocfalloc 在 Linux ext4 和 Windows NTFS 上较快，能预分配空间，减少碎片，如果文件系统不支持，用 trunc 或 none。disk-cache 根据内存调整，一般 32M 到 128M，业内专家指出，磁盘缓存能明显减少小文件随机读写。
限速与连接数
max-overall-download-limit=0
max-overall-upload-limit=1M
max-concurrent-downloads=3
max-connection-per-server=16
split=16
min-split-size=10Mmax-overall-upload-limit 限制上传，避免影响其他网络活动，如果宽带有限，下载限速设为实际带宽的 80% 左右，多数情况下，留出两成带宽给其他设备。
aria2 配置文件要钱吗？免费开源工具的成本真相
aria2 是开源软件，配置文件本身不收费，你不需要购买任何授权，真正可能产生费用的是：
- 服务器或 VPS：如果你把 aria2 跑在云服务器上，需要付服务器租金。
- 离线下载服务：某些网盘或盒子收费，但那是服务费，不是 aria2 配置费。
- 电费与硬件：本地长期开机做种会产生电费。
aria2 配置文件要钱吗”这个问题，答案是：配置文件免费，成本取决于你把它跑在哪，据开源中国社区资料，aria2 采用 GPL 许可证，可自由使用和修改。
2026 年 aria2 配置文件维护与安全建议
RPC 密钥必须改
默认没有密钥,局域网内任何人连上 6800 端口都能控制下载，设置 rpc-secret=一串随机字符，启动后所有 RPC 调用都要带 token，不要用 123456 这类弱密钥。
日志与版本
log=/var/log/aria2.log
log-level=notice定期看日志,能发现 Tracker 超时、磁盘写满、RPC 拒绝等问题，aria2 更新较慢，但新版本会修安全问题，可以从发行版仓库或 GitHub Releases 获取。
备份与迁移
配置文件很小,直接复制 aria2.conf 和 aria2.session。aria2.session 保存未完成任务，迁移时一起带走，启动参数加 --save-session 和 --input-file 实现断点恢复。
把 aria2 配置文件当成一张“下载策略清单”，路径、RPC、并发、缓存、BT 参数各司其职，改完记得用命令行验证优先级，再配合前端测试，核心结论：配置文件不追求参数最多，而是匹配你的网络、磁盘和使用场景；先保证路径和 RPC 正确，再逐项调优，才能稳定跑满带宽。
aria2 配置文件常见问题解答
aria2 配置文件修改后需要重启吗？
需要,aria2 只在启动时读取配置文件，修改后重启 aria2c 进程，或者通过 RPC 的 aria2.changeGlobalOption 动态改部分参数，重启是最稳妥的方式。
aria2 配置文件和 AriaNg 设置冲突怎么办？
AriaNg 是通过 RPC 发送指令，它不直接改配置文件，AriaNg 里设了全局速度限制，而配置文件也有 max-overall-download-limit，以 RPC 动态设置为准，重启后回到配置文件的值，要永久生效，改配置文件。
Windows 下 aria2 配置文件路径可以放在 D 盘吗？
可以,用 --conf-path=D:aria2aria2.conf 指定即可，服务模式启动时，建议用绝对路径，并确保运行账户有读取权限，路径中避免中文和空格，能减少编码问题。