Detail adjustment and annotation improvement.

aria2.conf

@@ -7,22 +7,18 @@
 # Blog: https://p3terx.com
 #=====================================
 
-## '#'开头为注释内容, 选项都有相应的注释说明, 根据需要修改 ##
-## 被注释的选项使用的是默认值, 建议在需要使用时再取消注释  ##
-
 ## 日志相关设置 ##
 
 # 日志文件保存路径，忽略或设置为空为不保存，默认不保存。
-#log=aria2.log
+#log=
 # 日志级别，可选 debug, info, notice, warn, error 。默认 debug
 #log-level=warn
-
 # Aria2 一键安装管理脚本 与 Aria2 Pro 使用以下选项设置日志。
 # 控制台日志级别，可选 debug, info, notice, warn, error 。默认 notice
 # 建议设置为 warn ，此项仅输出警告和错误，可大幅减少日志产生并有利于排错。
 console-log-level=warn
 # 安静模式，禁止在控制台输出日志，默认：false
-#quiet=true
+quiet=false
 
 ## RPC相关设置 ##
 
@@ -36,11 +32,11 @@ rpc-listen-all=true
 #event-poll=select
 # RPC监听端口, 端口被占用时可以修改, 默认:6800
 rpc-listen-port=6800
-# 设置的RPC授权令牌, v1.18.4新增功能, 取代 --rpc-user 和 --rpc-passwd 选项
+# 设置 RPC 授权密钥
 rpc-secret=P3TERX
-# 是否启用 RPC 服务的 SSL/TLS 加密,
-# 启用加密后 RPC 服务需要使用 https 或者 wss 协议连接
-#rpc-secure=true
+# 是否启用 RPC 服务的 SSL/TLS 加密
+# 启用加密后 RPC 服务必须使用 https 或者 wss 协议连接
+#rpc-secure=false
 # 在 RPC 服务中启用 SSL/TLS 加密时的证书文件(.pem/.crt)
 #rpc-certificate=/config/xxx.pem
 # 在 RPC 服务中启用 SSL/TLS 加密时的私钥文件(.key)
@@ -50,14 +46,15 @@ rpc-secret=P3TERX
 
 # 文件的保存路径(可使用绝对路径或相对路径), 默认: 当前启动位置
 dir=/root/Download
-# 启用磁盘缓存, 0为禁用缓存, 需1.16以上版本, 默认:16M
-# VPS 默认即可。本地路由器或 NAS 建议在有足够的内存空闲情况下设置为适当的大小，以减少磁盘 I/O 延长硬盘寿命。
-#disk-cache=32M
-# 文件预分配方式,, 默认:prealloc
+# 启用磁盘缓存, 0为禁用缓存，默认:16M
+# 本地路由器或 NAS 建议在有足够的内存空闲情况下设置为适当的大小，以减少磁盘 I/O 延长硬盘寿命。
+disk-cache=64M
+# 文件预分配方式，none 为禁用，默认:prealloc
+# 此选项针对机械硬盘，固态硬盘建议设置为 none
 # 预分配所需时间: none < falloc ? trunc < prealloc
-# falloc和trunc则需要文件系统和内核支持，falloc 能有效降低磁盘碎片与内存占用
-# NTFS(MinGW构建)、EXT4 建议使用 falloc, EXT3 建议 trunc, MAC 下需要注释此项。
-# 若无法下载，提示 fallocate failed.cause：Operation not supported ，请设置为 none 
+# falloc 和 trunc 则需要文件系统和内核支持，falloc 能有效降低磁盘碎片与内存占用，trunc 实际作用不大，不建议使用。
+# NTFS(MinGW构建)、EXT4(with extents support)、btrfs、xfs 等较新的文件系统建议使用 falloc
+# 若无法下载，提示 fallocate failed.cause：Operation not supported 说明不支持，请设置为 none 或 prealloc
 file-allocation=falloc
 # 断点续传
 continue=true
@@ -85,13 +82,9 @@ min-split-size=4M
 # 单个任务最大线程数, 添加时可指定, 默认:5
 split=16
 # 整体下载速度限制, 运行时可修改, 默认:0
-#max-overall-download-limit=0
+max-overall-download-limit=0
 # 单个任务下载速度限制, 默认:0
-#max-download-limit=0
-# 整体上传速度限制, 运行时可修改, 默认:0
-max-overall-upload-limit=1M
-# 单个任务上传速度限制, 默认:0
-#max-upload-limit=1000
+max-download-limit=0
 # 禁用IPv6, 默认:false
 disable-ipv6=true
 # 支持GZip，默认:false
@@ -100,29 +93,37 @@ http-accept-gzip=true
 reuse-uri=false
 # 禁用 netrc 支持，默认:flase
 no-netrc=true
+# 允许覆盖，当相关控制文件不存在时从头开始重新下载。默认:flase
+allow-overwrite=false
+# 文件自动重命名，此选项仅在HTTP（S）/ FTP下载中有效。新文件名在名称之后扩展名之前加上一个点和一个数字（1..9999）。默认:true
+auto-file-renaming=true
+# 最低 TLS 版本，可选 TLSv1.1、TLSv1.2、TLSv1.3 默认:TLSv1.2
+#min-tls-version=TLSv1.2
 
 ## 进度保存相关 ##
 
 # 从会话文件中读取下载任务
 input-file=/root/.aria2/aria2.session
 # 在Aria2退出时保存`错误/未完成`的下载任务到会话文件
 save-session=/root/.aria2/aria2.session
-# 定时保存会话, 0为退出时才保存, 需1.16.1以上版本, 默认:0
+# 定时保存会话时间（秒）, 0为退出时才保存, 需1.16.1以上版本, 默认:0
 save-session-interval=1
-# 自动保存任务进度，0为退出时才保存，默认：60
+# 自动保存任务进度时间（秒），0为退出时才保存，默认：60
 auto-save-interval=1
 # 强制保存会话, 即使任务已经完成, 默认:false
-# 较新的版本开启后会在任务完成后依然保留.aria2文件
-#force-save=true
+# 开启后会在任务完成后依然保留 .aria2 文件，文件被移除且任务存在的情况下重启后会重新下载。
+# 关闭后已完成的任务列表会在重启后清空。
+# PT 下载持续做种需求建议开启，防止意外重启后列表被清空。
+force-save=false
 
 ## BT/PT下载相关 ##
 
 # 当下载的是一个种子(以.torrent结尾)时, 自动开始BT任务, 默认:true，可选：false|mem
-#follow-torrent=true
-# BT监听端口（TCP）, 默认:6881-6999
+follow-torrent=true
+# BT监听端口(TCP), 默认:6881-6999
 listen-port=51413
-# 单个种子最大连接数，0为不限制，默认:55
-bt-max-peers=0
+# DHT网络监听端口(UDP), 默认:6881-6999
+dht-listen-port=6881-6999
 # DHT（IPv4）文件
 dht-file-path=/root/.aria2/dht.dat
 # DHT（IPv6）文件
@@ -132,36 +133,49 @@ enable-dht=true
 # 打开IPv6 DHT功能, PT需要禁用
 # 在没有 IPv6 的环境中不建议开启，否则会导致 DHT 功能异常。
 enable-dht6=false
-# DHT网络监听端口（UDP）, 默认:6881-6999
-dht-listen-port=6881-6999
 # 本地节点查找, PT需要禁用, 默认:false
 bt-enable-lpd=true
 # 种子交换, PT需要禁用, 默认:true
 enable-peer-exchange=true
+# 单个种子最大连接数，0为不限制，默认:55
+bt-max-peers=0
 # 期望下载速度，Aria2会临时提高连接数以提高下载速度，单位K或M。默认:50K
 bt-request-peer-speed-limit=10M
+# 全局最大上传速度限制, 运行时可修改, 默认:0
+max-overall-upload-limit=5M
+# 单个任务上传速度限制, 默认:0
+max-upload-limit=0
 # 当种子的分享率达到这个数时, 自动停止做种, 0为一直做种, 默认:1.0
 seed-ratio=1.0
 # 最小做种时间（分钟）。此选项设置为0时，将在BT任务下载完成后不进行做种。
 seed-time=0
-# BT校验相关, 默认:true
-#bt-hash-check-seed=true
+# 做种前检查文件哈希, 默认:true
+bt-hash-check-seed=true
 # 继续之前的BT任务时, 无需再次校验, 默认:false
-#bt-seed-unverified=true
+bt-seed-unverified=false
 # 保存磁力链接元数据为种子文件(.torrent文件), 默认:false
 bt-save-metadata=true
 # 加载已保存的元数据文件，默认:false
 bt-load-saved-metadata=true
 # 删除未选择文件，默认:false
 bt-remove-unselected-file=true
 # 保存上传的种子，默认:true
-#rpc-save-upload-metadata=false
+rpc-save-upload-metadata=true
+# BT强制加密, 默认: false
+# 启用后将拒绝旧的 BT 握手协议并仅使用混淆握手及加密，理论上可以防版权投诉与迅雷吸血。
+# 此选项相当于后面两个选项(bt-require-crypto=true, bt-min-crypto-level=arc4)的快捷开启方式，但不会修改这两个选项的值。
+bt-force-encryption=true
+# BT加密需求，默认：false
+# 启用后拒绝与旧的 BitTorrent 握手协议(\19BitTorrent protocol)建立连接，始终使用混淆处理握手。
+bt-require-crypto=true
+# BT最低加密等级，可选：plain（明文），arc4（加密），默认：plain
+bt-min-crypto-level=arc4
 # 客户端伪装
 user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.117 Safari/537.36
 # PT需要保持 user-agent 和 peer-agent 两个参数一致。即注释上面这行，然后取消注释下面的相关选项。
-#user-agent=qBittorrent/4.2.1
-peer-agent=qBittorrent/4.2.1
-peer-id-prefix=-qB4210-
+#user-agent=qBittorrent/4.2.2
+peer-agent=qBittorrent/4.2.2
+peer-id-prefix=-qB4220-
 #----------------------------------
 #user-agent=Transmission 2.94
 #peer-agent=Transmission 2.94
@@ -179,33 +193,18 @@ peer-id-prefix=-qB4210-
 #peer-agent=μTorrent Mac 1.8.7
 #peer-id-prefix=-UM1870-
 
-## BT加密设置（抗版权、防吸血） ##
-
-# BT强制加密, 默认: false
-# 启用后将拒绝旧的 BT 握手协议并仅使用混淆握手及加密，理论上可以防版权投诉与迅雷吸血。
-# 此选项相当于后面两个选项(bt-require-crypto=true, bt-min-crypto-level=arc4)的快捷开启方式，但不会修改这两个选项的值。
-bt-force-encryption=true
-# BT加密需求，默认：false
-# 启用后拒绝与旧的BitTorrent握手协议(\19BitTorrent protocol)建立连接，始终使用混淆处理握手。
-#bt-require-crypto=true
-# BT最低加密等级，可选：plain（明文），arc4（加密），默认：plain
-#bt-min-crypto-level=arc4
-
 ## 执行额外命令 ##
 
-# 下载停止后执行的命令（下载停止包含下载错误和下载完成这两个状态，如果没有单独设置，则执行此项命令。）
-# 删除文件及.aria2后缀名文件
+# 下载停止后执行的命令
 on-download-stop=/root/.aria2/delete.sh
-# 下载错误后执行的命令（下载停止包含下载错误这个状态，如果没被设置或被注释，则执行下载停止后执行的命令。）
-#on-download-error=
-# 下载完成后执行的命令（下载停止包含下载完成这个状态，如果没被设置或被注释，则执行下载停止后执行的命令。）
-# 删除.aria2后缀名文件
+# 下载完成后执行的命令
+# 此项未定义则执行下载停止后执行的命令（on-download-stop）
 on-download-complete=/root/.aria2/delete.aria2.sh
-# 调用 rclone 上传(move)到网盘
-#on-download-complete=/root/.aria2/autoupload.sh
+# 下载错误后执行的命令
+# 此项未定义则执行下载停止后执行的命令（on-download-stop）
+#on-download-error=
 # 下载暂停后执行的命令
-# 显示下载任务信息
-#on-download-pause=/root/.aria2/info.sh
+#on-download-pause=
 # 下载开始后执行的命令
 #on-download-start=