最后活跃于 2 years ago

修订 d49c75d79989c9ec124783073599ca663d0c7392

aria2.conf 原始文件
1#
2# https://github.com/P3TERX/aria2.conf
3# File name:aria2.conf
4# Description: Awesome Aria2 configuration file
5# Version: 2021.09.15
6#
7# Copyright (c) 2018-2021 P3TERX <https://p3terx.com>
8#
9# This is free software, licensed under the MIT License.
10# See /LICENSE for more information.
11#
12
13## 文件保存设置 ##
14
15# 下载目录。可使用绝对路径或相对路径, 默认: 当前启动位置
16dir=/mnt/share/NASDownload/
17
18# 磁盘缓存, 0 为禁用缓存,默认:16M
19# 磁盘缓存的作用是把下载的数据块临时存储在内存中,然后集中写入硬盘,以减少磁盘 I/O ,提升读写性能,延长硬盘寿命。
20# 建议在有足够的内存空闲情况下适当增加,但不要超过剩余可用内存空间大小。
21# 此项值仅决定上限,实际对内存的占用取决于网速(带宽)和设备性能等其它因素。
22#disk-cache=64M
23
24# 文件预分配方式, 可选:none, prealloc, trunc, falloc, 默认:prealloc
25# 预分配对于机械硬盘可有效降低磁盘碎片、提升磁盘读写性能、延长磁盘寿命。
26# 机械硬盘使用 ext4(具有扩展支持),btrfs,xfs 或 NTFS(仅 MinGW 编译版本)等文件系统建议设置为 falloc
27# 若无法下载,提示 fallocate failed.cause:Operation not supported 则说明不支持,请设置为 none
28# prealloc 分配速度慢, trunc 无实际作用,不推荐使用。
29# 固态硬盘不需要预分配,只建议设置为 none ,否则可能会导致双倍文件大小的数据写入,从而影响寿命。
30#file-allocation=none
31
32# 文件预分配大小限制。小于此选项值大小的文件不预分配空间,单位 K 或 M,默认:5M
33#no-file-allocation-limit=64M
34
35# 断点续传
36continue=true
37
38# 始终尝试断点续传,无法断点续传则终止下载,默认:true
39#always-resume=fals
40
41# 不支持断点续传的 URI 数值,当 always-resume=false 时生效。
42# 达到这个数值从将头开始下载,值为 0 时所有 URI 不支持断点续传时才从头开始下载。
43#max-resume-failure-tries=0
44
45# 获取服务器文件时间,默认:false
46remote-time=true
47
48
49## 进度保存设置 ##
50
51# 从会话文件中读取下载任务
52input-file=/etc/aria2/aria2.session
53
54# 会话文件保存路径
55# Aria2 退出时或指定的时间间隔会保存`错误/未完成`的下载任务到会话文件
56save-session=/etc/aria2/aria2.session
57
58# 任务状态改变后保存会话的间隔时间(秒), 0 为仅在进程正常退出时保存, 默认:0
59# 为了及时保存任务状态、防止任务丢失,此项值只建议设置为 1
60save-session-interval=1
61
62# 自动保存任务进度到控制文件(*.aria2)的间隔时间(秒),0 为仅在进程正常退出时保存,默认:60
63# 此项值也会间接影响从内存中把缓存的数据写入磁盘的频率
64# 想降低磁盘 IOPS (每秒读写次数)则提高间隔时间
65# 想在意外非正常退出时尽量保存更多的下载进度则降低间隔时间
66# 非正常退出:进程崩溃、系统崩溃、SIGKILL 信号、设备断电等
67#auto-save-interval=20
68
69# 强制保存,即使任务已完成也保存信息到会话文件, 默认:false
70# 开启后会在任务完成后保留 .aria2 文件,文件被移除且任务存在的情况下重启后会重新下载。
71# 关闭后已完成的任务列表会在重启后清空。
72force-save=false
73
74
75## 下载连接设置 ##
76
77# 文件未找到重试次数,默认:0 (禁用)
78# 重试时同时会记录重试次数,所以也需要设置 max-tries 这个选项
79max-file-not-found=10
80
81# 最大尝试次数,0 表示无限,默认:5
82max-tries=10
83
84# 重试等待时间(秒), 默认:0 (禁用)
85retry-wait=10
86
87# 连接超时时间(秒)。默认:60
88connect-timeout=30
89
90# 超时时间(秒)。默认:60
91timeout=30
92
93# 最大同时下载任务数, 运行时可修改, 默认:5
94max-concurrent-downloads=8
95
96# 单服务器最大连接线程数, 任务添加时可指定, 默认:1
97# 最大值为 16 (增强版无限制), 且受限于单任务最大连接线程数(split)所设定的值。
98max-connection-per-server=16
99
100# 单任务最大连接线程数, 任务添加时可指定, 默认:5
101split=64
102
103# 文件最小分段大小, 添加时可指定, 取值范围 1M-1024M (增强版最小值为 1K), 默认:20M
104# 比如此项值为 10M, 当文件为 20MB 会分成两段并使用两个来源下载, 文件为 15MB 则只使用一个来源下载。
105# 理论上值越小使用下载分段就越多,所能获得的实际线程数就越大,下载速度就越快,但受限于所下载文件服务器的策略。
106min-split-size=4M
107
108# HTTP/FTP 下载分片大小,所有分割都必须是此项值的倍数,最小值为 1M (增强版为 1K),默认:1M
109#piece-length=1M
110
111# 允许分片大小变化。默认:false
112# false:当分片大小与控制文件中的不同时将会中止下载
113# true:丢失部分下载进度继续下载
114allow-piece-length-change=true
115
116# 最低下载速度限制。当下载速度低于或等于此选项的值时关闭连接(增强版本为重连),此选项与 BT 下载无关。单位 K 或 M ,默认:0 (无限制)
117lowest-speed-limit=0
118
119# 全局最大下载速度限制, 运行时可修改, 默认:0 (无限制)
120max-overall-download-limit=0
121
122# 单任务下载速度限制, 默认:0 (无限制)
123max-download-limit=0
124
125# 禁用 IPv6, 默认:false
126#disable-ipv6=true
127
128# GZip 支持,默认:false
129http-accept-gzip=true
130
131# URI 复用,默认: true
132#reuse-uri=false
133
134# 禁用 netrc 支持,默认:false
135#no-netrc=true
136
137# 允许覆盖,当相关控制文件(.aria2)不存在时从头开始重新下载。默认:false
138#allow-overwrite=false
139
140# 文件自动重命名,此选项仅在 HTTP(S)/FTP 下载中有效。新文件名在名称之后扩展名之前加上一个点和一个数字(1..9999)。默认:true
141auto-file-renaming=false
142
143# 使用 UTF-8 处理 Content-Disposition ,默认:false
144content-disposition-default-utf8=true
145
146# 最低 TLS 版本,可选:TLSv1.1、TLSv1.2、TLSv1.3 默认:TLSv1.2
147#min-tls-version=TLSv1.2
148
149
150## BT/PT 下载设置 ##
151
152# BT 监听端口(TCP), 默认:6881-6999
153# 直通外网的设备,比如 VPS ,务必配置防火墙和安全组策略允许此端口入站
154# 内网环境的设备,比如 NAS ,除了防火墙设置,还需在路由器设置外网端口转发到此端口
155#listen-port=51413
156
157# DHT 网络与 UDP tracker 监听端口(UDP), 默认:6881-6999
158# 因协议不同,可以与 BT 监听端口使用相同的端口,方便配置防火墙和端口转发策略。
159#dht-listen-port=51413
160
161# 启用 IPv4 DHT 功能, PT 下载(私有种子)会自动禁用, 默认:true
162#enable-dht=true
163
164# 启用 IPv6 DHT 功能, PT 下载(私有种子)会自动禁用,默认:false
165# 在没有 IPv6 支持的环境开启可能会导致 DHT 功能异常
166#enable-dht6=false
167
168# 指定 BT 和 DHT 网络中的 IP 地址
169# 使用场景:在家庭宽带没有公网 IP 的情况下可以把 BT 和 DHT 监听端口转发至具有公网 IP 的服务器,在此填写服务器的 IP ,可以提升 BT 下载速率。
170#bt-external-ip=
171
172# IPv4 DHT 文件路径,默认:$HOME/.aria2/dht.dat
173#dht-file-path=/root/.aria2/dht.dat
174
175# IPv6 DHT 文件路径,默认:$HOME/.aria2/dht6.dat
176#dht-file-path6=/root/.aria2/dht6.dat
177
178# IPv4 DHT 网络引导节点
179dht-entry-point=dht.transmissionbt.com:6881
180
181# IPv6 DHT 网络引导节点
182dht-entry-point6=dht.transmissionbt.com:6881
183
184# 本地节点发现, PT 下载(私有种子)会自动禁用 默认:false
185bt-enable-lpd=true
186
187# 指定用于本地节点发现的接口,可能的值:接口,IP地址
188# 如果未指定此选项,则选择默认接口。
189#bt-lpd-interface=
190
191# 启用节点交换, PT 下载(私有种子)会自动禁用, 默认:true
192enable-peer-exchange=true
193
194# BT 下载最大连接数(单任务),运行时可修改。0 为不限制,默认:55
195# 理想情况下连接数越多下载越快,但在实际情况是只有少部分连接到的做种者上传速度快,其余的上传慢或者不上传。
196# 如果不限制,当下载非常热门的种子或任务数非常多时可能会因连接数过多导致进程崩溃或网络阻塞。
197# 进程崩溃:如果设备 CPU 性能一般,连接数过多导致 CPU 占用过高,因资源不足 Aria2 进程会强制被终结。
198# 网络阻塞:在内网环境下,即使下载没有占满带宽也会导致其它设备无法正常上网。因远古低性能路由器的转发性能瓶颈导致。
199bt-max-peers=128
200
201# BT 下载期望速度值(单任务),运行时可修改。单位 K 或 M 。默认:50K
202# BT 下载速度低于此选项值时会临时提高连接数来获得更快的下载速度,不过前提是有更多的做种者可供连接。
203# 实测临时提高连接数没有上限,但不会像不做限制一样无限增加,会根据算法进行合理的动态调节。
204bt-request-peer-speed-limit=10M
205
206# 全局最大上传速度限制, 运行时可修改, 默认:0 (无限制)
207# 设置过低可能影响 BT 下载速度
208#max-overall-upload-limit=2M
209
210# 单任务上传速度限制, 默认:0 (无限制)
211#max-upload-limit=0
212
213# 最小分享率。当种子的分享率达到此选项设置的值时停止做种, 0 为一直做种, 默认:1.0
214# 强烈建议您将此选项设置为大于等于 1.0
215seed-ratio=1.0
216
217# 最小做种时间(分钟)。设置为 0 时将在 BT 任务下载完成后停止做种。
218seed-time=120
219
220# 做种前检查文件哈希, 默认:true
221#bt-hash-check-seed=true
222
223# 继续之前的BT任务时, 无需再次校验, 默认:false
224#bt-seed-unverified=false
225
226# BT tracker 服务器连接超时时间(秒)。默认:60
227# 建立连接后,此选项无效,将使用 bt-tracker-timeout 选项的值
228#bt-tracker-connect-timeout=10
229
230# BT tracker 服务器超时时间(秒)。默认:60
231#bt-tracker-timeout=10
232
233# BT 服务器连接间隔时间(秒)。默认:0 (自动)
234#bt-tracker-interval=0
235
236# BT 下载优先下载文件开头或结尾
237bt-prioritize-piece=head=32M,tail=32M
238
239# 保存通过 WebUI(RPC) 上传的种子文件(.torrent),默认:true
240# 所有涉及种子文件保存的选项都建议开启,不保存种子文件有任务丢失的风险。
241# 通过 RPC 自定义临时下载目录可能不会保存种子文件。
242rpc-save-upload-metadata=true
243
244# 下载种子文件(.torrent)自动开始下载, 默认:true,可选:false|mem
245# true:保存种子文件
246# false:仅下载种子文件
247# mem:将种子保存在内存中
248#follow-torrent=
249
250# 种子文件下载完后暂停任务,默认:false
251# 在开启 follow-torrent 选项后下载种子文件或磁力会自动开始下载任务进行下载,而同时开启当此选项后会建立相关任务并暂停。
252pause-metadata=true
253
254# 保存磁力链接元数据为种子文件(.torrent), 默认:false
255bt-save-metadata=true
256
257# 加载已保存的元数据文件(.torrent),默认:false
258bt-load-saved-metadata=true
259
260# 删除 BT 下载任务中未选择文件,默认:false
261bt-remove-unselected-file=true
262
263# BT强制加密, 默认: false
264# 启用后将拒绝旧的 BT 握手协议并仅使用混淆握手及加密。可以解决部分运营商对 BT 下载的封锁,且有一定的防版权投诉与迅雷吸血效果。
265# 此选项相当于后面两个选项(bt-require-crypto=true, bt-min-crypto-level=arc4)的快捷开启方式,但不会修改这两个选项的值。
266bt-force-encryption=true
267
268# BT加密需求,默认:false
269# 启用后拒绝与旧的 BitTorrent 握手协议(\19BitTorrent protocol)建立连接,始终使用混淆处理握手。
270#bt-require-crypto=true
271
272# BT最低加密等级,可选:plain(明文),arc4(加密),默认:plain
273#bt-min-crypto-level=arc4
274
275# 分离仅做种任务,默认:false
276# 从正在下载的任务中排除已经下载完成且正在做种的任务,并开始等待列表中的下一个任务。
277bt-detach-seed-only=true
278
279
280## 客户端伪装 ##
281
282# 自定义 User Agent
283user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36
284
285# BT 客户端伪装
286# PT 下载需要保持 user-agent 和 peer-agent 两个参数一致
287# 部分 PT 站对 Aria2 有特殊封禁机制,客户端伪装不一定有效,且有封禁账号的风险。
288#user-agent=Deluge 1.3.15
289peer-agent=Deluge 1.3.15
290peer-id-prefix=-DE13F0-
291
292
293## 执行额外命令 ##
294
295# 下载停止后执行的命令
296# 从 正在下载 到 删除、错误、完成 时触发。暂停被标记为未开始下载,故与此项无关。
297#on-download-stop=/root/.aria2/delete.sh
298
299# 下载完成后执行的命令
300# 此项未定义则执行 下载停止后执行的命令 (on-download-stop)
301#on-download-complete=/root/.aria2/clean.sh
302
303# 下载错误后执行的命令
304# 此项未定义则执行 下载停止后执行的命令 (on-download-stop)
305#on-download-error=
306
307# 下载暂停后执行的命令
308#on-download-pause=
309
310# 下载开始后执行的命令
311#on-download-start=
312
313# BT 下载完成后执行的命令
314#on-bt-download-complete=
315
316
317## RPC 设置 ##
318
319# 启用 JSON-RPC/XML-RPC 服务器, 默认:false
320enable-rpc=true
321
322# 接受所有远程请求, 默认:false
323rpc-allow-origin-all=true
324
325# 允许外部访问, 默认:false
326rpc-listen-all=true
327
328# RPC 监听端口, 默认:6800
329#rpc-listen-port=6800
330
331# RPC 密钥
332#rpc-secret=NASDownload
333
334# RPC 最大请求大小
335#rpc-max-request-size=10M
336
337# RPC 服务 SSL/TLS 加密, 默认:false
338# 启用加密后必须使用 https 或者 wss 协议连接
339# 不推荐开启,建议使用 web server 反向代理,比如 Nginx、Caddy ,灵活性更强。
340#rpc-secure=true
341
342# 在 RPC 服务中启用 SSL/TLS 加密时的证书文件(.pem/.crt)
343#rpc-certificate=/etc/aria2/CA.crt
344
345# 在 RPC 服务中启用 SSL/TLS 加密时的私钥文件(.key)
346#rpc-private-key=/etc/aria2/CA.key
347
348# 事件轮询方式, 可选:epoll, kqueue, port, poll, select, 不同系统默认值不同
349#event-poll=select
350
351
352## 高级选项 ##
353
354# 启用异步 DNS 功能。默认:true
355#async-dns=true
356
357# 指定异步 DNS 服务器列表,未指定则从 /etc/resolv.conf 中读取。
358#async-dns-server=119.29.29.29,223.5.5.5,8.8.8.8,1.1.1.1
359
360# 指定单个网络接口,可能的值:接口,IP地址,主机名
361# 如果接口具有多个 IP 地址,则建议指定 IP 地址。
362# 已知指定网络接口会影响依赖本地 RPC 的连接的功能场景,即通过 localhost 和 127.0.0.1 无法与 Aria2 服务端进行讯通。
363#interface=
364
365# 指定多个网络接口,多个值之间使用逗号(,)分隔。
366# 使用 interface 选项时会忽略此项。
367#multiple-interface=
368
369
370## 日志设置 ##
371
372# 日志文件保存路径,忽略或设置为空为不保存,默认:不保存
373#log=/etc/aria2/aria2.log
374
375# 日志级别,可选 debug, info, notice, warn, error 。默认:debug
376#log-level=warn
377
378# 控制台日志级别,可选 debug, info, notice, warn, error ,默认:notice
379#console-log-level=notice
380
381# 安静模式,禁止在控制台输出日志,默认:false
382#quiet=false
383
384# 下载进度摘要输出间隔时间(秒),0 为禁止输出。默认:60
385#summary-interval=0
386
387
388## 增强扩展设置(非官方) ##
389
390# 仅适用于 myfreeer/aria2-build-msys2 (Windows) 和 P3TERX/Aria2-Pro-Core (GNU/Linux) 项目所构建的增强版本
391
392# 在服务器返回 HTTP 400 Bad Request 时重试,仅当 retry-wait > 0 时有效,默认 false
393#retry-on-400=true
394
395# 在服务器返回 HTTP 403 Forbidden 时重试,仅当 retry-wait > 0 时有效,默认 false
396#retry-on-403=true
397
398# 在服务器返回 HTTP 406 Not Acceptable 时重试,仅当 retry-wait > 0 时有效,默认 false
399#retry-on-406=true
400
401# 在服务器返回未知状态码时重试,仅当 retry-wait > 0 时有效,默认 false
402#retry-on-unknown=true
403
404# 是否发送 Want-Digest HTTP 标头。默认:false (不发送)
405# 部分网站会把此标头作为特征来检测和屏蔽 Aria2
406#http-want-digest=false
407
408
409## BitTorrent trackers ##
410#bt-tracker=
411