Usage: aria2c [OPTIONS] [URI | MAGNET | TORRENT_FILE | METALINK_FILE]...
Printing all options.
Options:
-v, --version Print the version number and exit.
Tags: #basic
-h, --help[=TAG|KEYWORD] Print usage and exit.
The help messages are classified with tags. A tag
starts with "#". For example, type "--help=#http"
to get the usage for the options tagged with
"#http". If non-tag word is given, print the usage
for the options whose name includes that word.
Possible Values: #basic, #advanced, #http, #https, #ftp, #metalink, #bittorrent, #cookie, #hook, #file, #rpc, #checksum, #experimental, #deprecated, #help, #all
Default: #basic
Tags: #basic, #help
-t, --timeout=SEC Set timeout in seconds.
Possible Values: 1-600
Default: 60
Tags: #http, #ftp
--connect-timeout=SEC Set the connect timeout in seconds to establish
connection to HTTP/FTP/proxy server. After the
connection is established, this option makes no
effect and --timeout option is used instead.
Possible Values: 1-600
Default: 60
Tags: #http, #ftp
-m, --max-tries=N Set number of tries. 0 means unlimited.
Possible Values: 0-*
Default: 5
Tags: #http, #ftp
--auto-save-interval=SEC Save a control file(*.aria2) every SEC seconds.
If 0 is given, a control file is not saved during
download. aria2 saves a control file when it stops
regardless of the value.
Possible Values: 0-600
Default: 60
Tags: #advanced
-l, --log=LOG The file name of the log file. If '-' is
specified, log is written to stdout.
Possible Values: /path/to/file, -
Tags: #basic
-d, --dir=DIR The directory to store the downloaded file.
Possible Values: /path/to/directory
Default: C:\aria2-1.31.0\aria2-1.31.0-win-32bit-build1
Tags: #basic, #file
-o, --out=FILE The file name of the downloaded file. It is
always relative to the directory given in -d
option. When the -Z option is used, this option
will be ignored.
Possible Values: /path/to/file
Tags: #basic, #http, #ftp, #file
-s, --split=N Download a file using N connections. If more
than N URIs are given, first N URIs are used and
remaining URLs are used for backup. If less than
N URIs are given, those URLs are used more than
once so that N connections total are made
simultaneously. The number of connections to the
same host is restricted by the
--max-connection-per-server option. See also the
--min-split-size option.
Possible Values: 1-*
Default: 5
Tags: #basic, #http, #ftp
-D, --daemon[=true|false] Run as daemon. The current working directory will
be changed to "/" and standard input, standard
output and standard error will be redirected to
"/dev/null".
Possible Values: true, false
Default: false
Tags: #advanced
--referer=REFERER Set an http referrrer (Referer). This affects
all http/https downloads. If "*" is given,
the download URI is also used as the referrer.
This may be useful when used together with
the -P option.
Tags: #http
--lowest-speed-limit=SPEED Close connection if download speed is lower than
or equal to this value(bytes per sec).
0 means aria2 does not have a lowest speed limit.
You can append K or M(1K = 1024, 1M = 1024K).
This option does not affect BitTorrent downloads.
Possible Values: 0-*
Default: 0
Tags: #http, #ftp
--piece-length=LENGTH Set a piece length for HTTP/FTP downloads. This
is the boundary when aria2 splits a file. All
splits occur at multiple of this length. This
option will be ignored in BitTorrent downloads.
It will be also ignored if Metalink file
contains piece hashes.
Possible Values: 1048576-1073741824
Default: 1M
Tags: #advanced, #http, #ftp
--max-overall-download-limit=SPEED Set max overall download speed in bytes/sec.
0 means unrestricted.
You can append K or M(1K = 1024, 1M = 1024K).
To limit the download speed per download, use
--max-download-limit option.
Possible Values: 0-*
Default: 0
Tags: #http, #ftp, #bittorrent
--max-download-limit=SPEED Set max download speed per each download in
bytes/sec. 0 means unrestricted.
You can append K or M(1K = 1024, 1M = 1024K).
To limit the overall download speed, use
--max-overall-download-limit option.
Possible Values: 0-*
Default: 0
Tags: #http, #ftp, #bittorrent
--file-allocation=METHOD Specify file allocation method.
'none' doesn't pre-allocate file space. 'prealloc'
pre-allocates file space before download begins.
This may take some time depending on the size of
the file.
If you are using newer file systems such as ext4
(with extents support), btrfs, xfs or NTFS
(MinGW build only), 'falloc' is your best
choice. It allocates large(few GiB) files
almost instantly. Don't use 'falloc' with legacy
file systems such as ext3 and FAT32 because it
takes almost same time as 'prealloc' and it
blocks aria2 entirely until allocation finishes.
'falloc' may not be available if your system
doesn't have posix_fallocate() function.
'trunc' uses ftruncate() system call or
platform-specific counterpart to truncate a file
to a specified length.
Possible Values: none, prealloc, trunc, falloc
Default: prealloc
Tags: #basic, #file
--no-file-allocation-limit=SIZE No file allocation is made for files whose
size is smaller than SIZE.
You can append K or M(1K = 1024, 1M = 1024K).
Possible Values: 0-*
Default: 5M
Tags: #advanced, #file
--allow-overwrite[=true|false] Restart download from scratch if the
corresponding control file doesn't exist. See
also --auto-file-renaming option.
Possible Values: true, false
Default: false
Tags: #advanced, #file
--realtime-chunk-checksum[=true|false] Validate chunk of data by calculating
checksum while downloading a file if chunk
checksums are provided.
Possible Values: true, false
Default: true
Tags: #metalink, #checksum
-V, --check-integrity[=true|false] Check file integrity by validating piece
hashes or a hash of entire file. This option has
effect only in BitTorrent, Metalink downloads
with checksums or HTTP(S)/FTP downloads with
--checksum option. If piece hashes are provided,
this option can detect damaged portions of a file
and re-download them. If a hash of entire file is
provided, hash check is only done when file has
been already download. This is determined by file
length. If hash check fails, file is
re-downloaded from scratch. If both piece hashes
and a hash of entire file are provided, only
piece hashes are used.
Possible Values: true, false
Default: false
Tags: #basic, #metalink, #bittorrent, #file, #checksum
--netrc-path=FILE Specify the path to the netrc file.
Possible Values: /path/to/file
Default: C:/Users/Administrator/.netrc
Tags:
-c, --continue[=true|false] Continue downloading a partially downloaded
file. Use this option to resume a download
started by a web browser or another program
which downloads files sequentially from the
beginning. Currently this option is only
applicable to http(s)/ftp downloads.
Possible Values: true, false
Default: false
Tags: #basic, #http, #ftp
-n, --no-netrc[=true|false] Disables netrc support.
Possible Values: true, false
Default: false
Tags: #http, #ftp
-i, --input-file=FILE Downloads URIs found in FILE. You can specify
multiple URIs for a single entity: separate
URIs on a single line using the TAB character.
Reads input from stdin when '-' is specified.
Additionally, options can be specified after each
line of URI. This optional line must start with
one or more white spaces and have one option per
single line. See INPUT FILE section of man page
for details. See also --deferred-input option.
Possible Values: /path/to/file, -
Tags: #basic
--deferred-input[=true|false] If true is given, aria2 does not read all URIs
and options from file specified by -i option at
startup, but it reads one by one when it needs
later. This may reduce memory usage if input
file contains a lot of URIs to download.
If false is given, aria2 reads all URIs and
options at startup.
Possible Values: true, false
Default: false
Tags: #advanced
-j, --max-concurrent-downloads=N Set maximum number of parallel downloads for
every static (HTTP/FTP) URL, torrent and metalink.
See also --split and --optimize-concurrent-downloads options.
Possible Values: 1-*
Default: 5
Tags: #basic
--optimize-concurrent-downloads[=true|false|A:B] Optimizes the number of
concurrent downloads according to the bandwidth
available. aria2 uses the download speed observed
in the previous downloads to adapt the number of
downloads launched in parallel according to the
rule N = A + B Log10(speed in Mbps). The
coefficients A and B can be customized in the
option arguments with A and B separated by a
colon. The default values (A=5,B=25) lead to
using typically 5 parallel downloads on 1Mbps
networks and above 50 on 100Mbps networks. The
number of parallel downloads remains constrained
under the maximum defined by the
max-concurrent-downloads parameter.
Possible Values: true, false, A:B
Default: false
Tags: #advanced
-Z, --force-sequential[=true|false] Fetch URIs in the command-line sequentially
and download each URI in a separate session, like
the usual command-line download utilities.
Possible Values: true, false
Default: false
Tags: #basic
--auto-file-renaming[=true|false] Rename file name if the same file already
exists. This option works only in http(s)/ftp
download.
The new file name has a dot and a number(1..9999)
appended after the name, but before the file
extension, if any.
Possible Values: true, false
Default: true
Tags: #advanced, #file
-P, --parameterized-uri[=true|false] Enable parameterized URI support.
You can specify set of parts:
http://{sv1,sv2,sv3}/foo.iso
Also you can specify numeric sequences with step
counter:
http://host/image[000-100:2].img
A step counter can be omitted.
If all URIs do not point to the same file, such
as the second example above, -Z option is
required.
Possible Values: true, false
Default: false
Tags: #advanced
--allow-piece-length-change[=true|false] If false is given, aria2 aborts
download when a piece length is different from
one in a control file. If true is given, you can
proceed but some download progress will be lost.
Possible Values: true, false
Default: false
Tags: #advanced
--no-conf[=true|false] Disable loading aria2.conf file.
Possible Values: true, false
Default: false
Tags: #advanced
--conf-path=PATH Change the configuration file path to PATH.
Possible Values: /path/to/file
Default: C:/Users/Administrator/.config/aria2/aria2.conf
Tags: #advanced
--stop=SEC Stop application after SEC seconds has passed.
If 0 is given, this feature is disabled.
Possible Values: 0-2147483647
Default: 0
Tags: #advanced
-q, --quiet[=true|false] Make aria2 quiet(no console output).
Possible Values: true, false
Default: false
Tags: #advanced
--async-dns[=true|false] Enable asynchronous DNS.
Possible Values: true, false
Default: true
Tags: #advanced
--summary-interval=SEC Set interval to output download progress summary.
Setting 0 suppresses the output.
Possible Values: 0-2147483647
Default: 60
Tags: #advanced
--log-level=LEVEL Set log level to output to file specified using
--log option.
Possible Values: debug, info, notice, warn, error
Default: debug
Tags: #advanced
--console-log-level=LEVEL Set log level to output to console.
Possible Values: debug, info, notice, warn, error
Default: notice
Tags: #advanced
--uri-selector=SELECTOR Specify URI selection algorithm.
If 'inorder' is given, URI is tried in the order
appeared in the URI list.
If 'feedback' is given, aria2 uses download speed
observed in the previous downloads and choose
fastest server in the URI list. This also
effectively skips dead mirrors. The observed
download speed is a part of performance profile
of servers mentioned in --server-stat-of and
--server-stat-if options.
If 'adaptive' is given, selects one of the best
mirrors for the first and reserved connections.
For supplementary ones, it returns mirrors which
has not been tested yet, and if each of them has
already been tested, returns mirrors which has to
be tested again. Otherwise, it doesn't select
anymore mirrors. Like 'feedback', it uses a
performance profile of servers.
Possible Values: inorder, feedback, adaptive
Default: feedback
Tags: #http, #ftp
--server-stat-timeout=SEC Specifies timeout in seconds to invalidate
performance profile of the servers since the last
contact to them.
Possible Values: 0-2147483647
Default: 86400
Tags: #http, #ftp
--server-stat-if=FILE Specify the filename to load performance profile
of the servers. The loaded data will be used in
some URI selector such as 'feedback'.
See also --uri-selector option
Possible Values: /path/to/file
Tags: #http, #ftp
--server-stat-of=FILE Specify the filename to which performance profile
of the servers is saved. You can load saved data
using --server-stat-if option.
Possible Values: /path/to/file
Tags: #http, #ftp
-R, --remote-time[=true|false] Retrieve timestamp of the remote file from the
remote HTTP/FTP server and if it is available,
apply it to the local file.
Possible Values: true, false
Default: false
Tags: #http, #ftp
--max-file-not-found=NUM If aria2 receives `file not found' status from the
remote HTTP/FTP servers NUM times without getting
a single byte, then force the download to fail.
Specify 0 to disable this option.
This options is effective only when using
HTTP/FTP servers. The number of retry attempt is
counted toward --max-tries, so it should be
configured too.
Possible Values: 0-*
Default: 0
Tags: #http, #ftp
--event-poll=POLL Specify the method for polling events.
Possible Values: select
Default: select
Tags: #advanced
--enable-rpc[=true|false] Enable JSON-RPC/XML-RPC server.
It is strongly recommended to set secret
authorization token using --rpc-secret option.
See also --rpc-listen-port option.
Possible Values: true, false
Default: false
Tags: #rpc
--rpc-listen-port=PORT Specify a port number for JSON-RPC/XML-RPC server
to listen to.
Possible Values: 1024-65535
Default: 6800
Tags: #rpc
--rpc-user=USER Set JSON-RPC/XML-RPC user. This option will be
deprecated in the future release. Migrate to
--rpc-secret option as soon as possible.
Tags: #rpc, #deprecated
--rpc-passwd=PASSWD Set JSON-RPC/XML-RPC password. This option will
be deprecated in the future release. Migrate to
--rpc-secret option as soon as possible.
Tags: #rpc, #deprecated
--rpc-max-request-size=SIZE Set max size of JSON-RPC/XML-RPC request. If aria2
detects the request is more than SIZE bytes, it
drops connection.
Possible Values: 0-*
Default: 2M
Tags: #rpc
--rpc-listen-all[=true|false] Listen incoming JSON-RPC/XML-RPC requests on all
network interfaces. If false is given, listen only
on local loopback interface.
Possible Values: true, false
Default: false
Tags: #rpc
--rpc-allow-origin-all[=true|false] Add Access-Control-Allow-Origin header
field with value '*' to the RPC response.
Possible Values: true, false
Default: false
Tags: #rpc
--rpc-certificate=FILE Use the certificate in FILE for RPC server.
The certificate must be in PEM format.
Use --rpc-private-key option to specify the
private key. Use --rpc-secure option to enable
encryption.
Possible Values: /path/to/file
Tags: #rpc
--rpc-private-key=FILE Use the private key in FILE for RPC server.
The private key must be decrypted and in PEM
format. Use --rpc-secure option to enable
encryption. See also --rpc-certificate option.
Possible Values: /path/to/file
Tags: #rpc
--rpc-secure[=true|false] RPC transport will be encrypted by SSL/TLS.
The RPC clients must use https scheme to access
the server. For WebSocket client, use wss
scheme. Use --rpc-certificate and
--rpc-private-key options to specify the
server certificate and private key.
Possible Values: true, false
Default: false
Tags: #rpc
--rpc-save-upload-metadata[=true|false] Save the uploaded torrent or
metalink metadata in the directory specified
by --dir option. The filename consists of
SHA-1 hash hex string of metadata plus
extension. For torrent, the extension is
'.torrent'. For metalink, it is '.meta4'.
If false is given to this option, the
downloads added by aria2.addTorrent or
aria2.addMetalink will not be saved by
--save-session option.
Possible Values: true, false
Default: true
Tags: #rpc
--dry-run[=true|false] If true is given, aria2 just checks whether the
remote file is available and doesn't download
data. This option has effect on HTTP/FTP download.
BitTorrent downloads are canceled if true is
specified.
Possible Values: true, false
Default: false
Tags: #http, #ftp
--reuse-uri[=true|false] Reuse already used URIs if no unused URIs are
left.
Possible Values: true, false
Default: true
Tags: #http, #ftp
--on-download-start=COMMAND Set the command to be executed after download
got started. aria2 passes 3 arguments to COMMAND:
GID, the number of files and file path. See Event
Hook in man page for more details.
Possible Values: /path/to/command
Tags: #advanced, #hook
--on-download-pause=COMMAND Set the command to be executed after download
was paused.
See --on-download-start option for the
requirement of COMMAND.
Possible Values: /path/to/command
Tags: #advanced, #hook
--on-download-stop=COMMAND Set the command to be executed after download
stopped. You can override the command to be
executed for particular download result using
--on-download-complete and --on-download-error. If
they are specified, command specified in this
option is not executed.
See --on-download-start option for the
requirement of COMMAND.
Possible Values: /path/to/command
Tags: #advanced, #hook
--on-download-complete=COMMAND Set the command to be executed after download
completed.
See --on-download-start option for the
requirement of COMMAND.
See also --on-download-stop option.
Possible Values: /path/to/command
Tags: #advanced, #hook
--on-download-error=COMMAND Set the command to be executed after download
aborted due to error.
See --on-download-start option for the
requirement of COMMAND.
See also --on-download-stop option.
Possible Values: /path/to/command
Tags: #advanced, #hook
--interface=INTERFACE Bind sockets to given interface. You can specify
interface name, IP address and hostname.
Possible Values: interface, IP address, hostname
Tags: #advanced
--multiple-interface=INTERFACES Comma separated list of interfaces to bind
sockets to. Requests will be splited among the
interfaces to achieve link aggregation. You can
specify interface name, IP address and hostname.
If --interface is used, this option will be
ignored.
Possible Values: interface, IP address, hostname
Tags: #advanced
--disable-ipv6[=true|false] Disable IPv6.
Possible Values: true, false
Default: true
Tags: #advanced
--human-readable[=true|false] Print sizes and speed in human readable format
(e.g., 1.2Ki, 3.4Mi) in the console readout.
Possible Values: true, false
Default: true
Tags: #advanced
--remove-control-file[=true|false] Remove control file before download. Using
with --allow-overwrite=true, download always
starts from scratch. This will be useful for
users behind proxy server which disables resume.
Possible Values: true, false
Default: false
Tags: #advanced
--always-resume[=true|false] Always resume download. If true is given, aria2
always tries to resume download and if resume is
not possible, aborts download. If false is given,
when all given URIs do not support resume or
aria2 encounters N URIs which does not support
resume (N is the value specified using
--max-resume-failure-tries option), aria2
downloads file from scratch.
See --max-resume-failure-tries option.
Possible Values: true, false
Default: true
Tags: #advanced, #http, #ftp
--max-resume-failure-tries=N When used with --always-resume=false, aria2
downloads file from scratch when aria2 detects N
number of URIs that does not support resume. If N
is 0, aria2 downloads file from scratch when all
given URIs do not support resume.
See --always-resume option.
Possible Values: 0-*
Default: 0
Tags: #advanced, #http, #ftp
--save-session=FILE Save error/unfinished downloads to FILE on exit.
You can pass this output file to aria2c with -i
option on restart. Please note that downloads
added by aria2.addTorrent and aria2.addMetalink
RPC method and whose metadata could not be saved
as a file will not be saved. Downloads removed
using aria2.remove and aria2.forceRemove will not
be saved.
Possible Values: /path/to/file
Tags: #advanced
-x, --max-connection-per-server=NUM The maximum number of connections to one
server for each download.
Possible Values: 1-16
Default: 1
Tags: #basic, #http, #ftp
-k, --min-split-size=SIZE aria2 does not split less than 2*SIZE byte range.
For example, let's consider downloading 20MiB
file. If SIZE is 10M, aria2 can split file into 2
range [0-10MiB) and [10MiB-20MiB) and download it
using 2 sources(if --split >= 2, of course).
If SIZE is 15M, since 2*15M > 20MiB, aria2 does
not split file and download it using 1 source.
You can append K or M(1K = 1024, 1M = 1024K).
Possible Values: 1048576-1073741824
Default: 20M
Tags: #basic, #http, #ftp
--conditional-get[=true|false] Download file only when the local file is older
than remote file. Currently, this function has
many limitations. See man page for details.
Possible Values: true, false
Default: false
Tags: #advanced, #http
--enable-async-dns6[=true|false] Enable IPv6 name resolution in asynchronous
DNS resolver. This option will be ignored when
--async-dns=false.
Possible Values: true, false
Tags: #advanced, #deprecated
--max-download-result=NUM Set maximum number of download result kept in
memory. The download results are completed/error/
removed downloads. The download results are stored
in FIFO queue and it can store at most NUM
download results. When queue is full and new
download result is created, oldest download result
is removed from the front of the queue and new one
is pushed to the back. Setting big number in this
option may result high memory consumption after
thousands of downloads. Specifying 0 means no
download result is kept. Note that unfinished
downloads are kept in memory regardless of this
option value. See
--keep-unfinished-download-result option.
Possible Values: 0-*
Default: 1000
Tags: #advanced
--retry-wait=SEC Set the seconds to wait between retries.
With SEC > 0, aria2 will retry download when the
HTTP server returns 503 response.
Possible Values: 0-600
Default: 0
Tags: #http, #ftp
--async-dns-server=IPADDRESS[,...] Comma separated list of DNS server address
used in asynchronous DNS resolver. Usually
asynchronous DNS resolver reads DNS server
addresses from /etc/resolv.conf. When this option
is used, it uses DNS servers specified in this
option instead of ones in /etc/resolv.conf. You
can specify both IPv4 and IPv6 address. This
option is useful when the system does not have
/etc/resolv.conf and user does not have the
permission to create it.
Tags: #advanced
--show-console-readout[=true|false] Show console readout.
Possible Values: true, false
Default: true
Tags: #advanced
--stream-piece-selector=SELECTOR Specify piece selection algorithm
used in HTTP/FTP download. Piece means fixed
length segment which is downloaded in parallel
in segmented download. If 'default' is given,
aria2 selects piece so that it reduces the
number of establishing connection. This is
reasonable default behaviour because
establishing connection is an expensive
operation.
If 'inorder' is given, aria2 selects piece which
has minimum index. Index=0 means first of the
file. This will be useful to view movie while
downloading it. --enable-http-pipelining option
may be useful to reduce reconnection overhead.
Please note that aria2 honors
--min-split-size option, so it will be necessary
to specify a reasonable value to
--min-split-size option.
If 'random' is given, aria2 selects piece
randomly. Like 'inorder', --min-split-size
option is honored.
If 'geom' is given, at the beginning aria2
selects piece which has minimum index like
'inorder', but it exponentially increasingly
keeps space from previously selected piece. This
will reduce the number of establishing connection
and at the same time it will download the
beginning part of the file first. This will be
useful to view movie while downloading it.
Possible Values: default, inorder, random, geom
Default: default
Tags: #http, #ftp
--truncate-console-readout[=true|false] Truncate console readout to fit in
a single line.
Possible Values: true, false
Default: true
Tags: #advanced
--pause[=true|false] Pause download after added. This option is
effective only when --enable-rpc=true is given.
Possible Values: true, false
Default: false
Tags: #advanced, #rpc
--download-result=OPT This option changes the way "Download Results"
is formatted. If OPT is 'default', print GID,
status, average download speed and path/URI. If
multiple files are involved, path/URI of first
requested file is printed and remaining ones are
omitted.
If OPT is 'full', print GID, status, average
download speed, percentage of progress and
path/URI. The percentage of progress and
path/URI are printed for each requested file in
each row.
If OPT is 'hide', "Download Results" is hidden.
Possible Values: default, full, hide
Default: default
Tags: #advanced
--hash-check-only[=true|false] If true is given, after hash check using
--check-integrity option, abort download whether
or not download is complete.
Possible Values: true, false
Default: false
Tags: #advanced, #metalink, #bittorrent, #file, #checksum
--checksum=TYPE=DIGEST Set checksum. TYPE is hash type. The supported
hash type is listed in "Hash Algorithms" in
"aria2c -v". DIGEST is hex digest.
For example, setting sha-1 digest looks like
this:
sha-1=0192ba11326fe2298c8cb4de616f4d4140213838
This option applies only to HTTP(S)/FTP
downloads.
Possible Values: HASH_TYPE=HEX_DIGEST
Tags: #http, #ftp, #checksum
--stop-with-process=PID Stop application when process PID is not running.
This is useful if aria2 process is forked from a
parent process. The parent process can fork aria2
with its own pid and when parent process exits
for some reason, aria2 can detect it and shutdown
itself.
Possible Values: 0-*
Tags: #advanced
--enable-mmap[=true|false] Map files into memory.
Possible Values: true, false
Default: false
Tags: #advanced, #experimental
--force-save[=true|false] Save download with --save-session option even
if the download is completed or removed. This
option also saves control file in that
situations. This may be useful to save
BitTorrent seeding which is recognized as
completed state.
Possible Values: true, false
Default: false
Tags: #advanced
--save-not-found[=true|false] Save download with --save-session option even
if the file was not found on the server. This
option also saves control file in that
situations.
Possible Values: true, false
Default: true
Tags: #advanced
--disk-cache=SIZE Enable disk cache. If SIZE is 0, the disk cache
is disabled. This feature caches the downloaded
data in memory, which grows to at most SIZE
bytes. The cache storage is created for aria2
instance and shared by all downloads. The one
advantage of the disk cache is reduce the disk
I/O because the data are written in larger unit
and it is reordered by the offset of the file.
If hash checking is involved and the data are
cached in memory, we don't need to read them
from the disk.
SIZE can include K or M(1K = 1024, 1M = 1024K).
Possible Values: 0-*
Default: 16M
Tags: #advanced
--gid=GID Set GID manually. aria2 identifies each
download by the ID called GID. The GID must be
hex string of 16 characters, thus [0-9a-zA-Z]
are allowed and leading zeros must not be
stripped. The GID all 0 is reserved and must
not be used. The GID must be unique, otherwise
error is reported and the download is not added.
This option is useful when restoring the
sessions saved using --save-session option. If
this option is not used, new GID is generated
by aria2.
Tags: #advanced
--save-session-interval=SEC Save error/unfinished downloads to a file
specified by --save-session option every SEC
seconds. If 0 is given, file will be saved only
when aria2 exits.
Possible Values: 0-*
Default: 0
Tags: #advanced
--enable-color[=true|false] Enable color output for a terminal.
Possible Values: true, false
Default: true
Tags: #advanced
--rpc-secret=TOKEN Set RPC secret authorization token.
Tags: #rpc
--dscp=DSCP Set DSCP value in outgoing IP packets of
BitTorrent traffic for QoS. This parameter sets
only DSCP bits in TOS field of IP packets,
not the whole field. If you take values
from /usr/include/netinet/ip.h divide them by 4
(otherwise values would be incorrect, e.g. your
CS1 class would turn into CS4). If you take
commonly used values from RFC, network vendors'
documentation, Wikipedia or any other source,
use them as they are.
Possible Values: 0-*
Default: 0
Tags: #advanced
--pause-metadata[=true|false]
Pause downloads created as a result of metadata
download. There are 3 types of metadata
downloads in aria2: (1) downloading .torrent
file. (2) downloading torrent metadata using
magnet link. (3) downloading metalink file.
These metadata downloads will generate downloads
using their metadata. This option pauses these
subsequent downloads. This option is effective
only when --enable-rpc=true is given.
Possible Values: true, false
Default: false
Tags: #advanced, #rpc
--min-tls-version=VERSION Specify minimum SSL/TLS version to enable.
Possible Values: SSLv3, TLSv1, TLSv1.1, TLSv1.2
Default: TLSv1
Tags: #advanced
--socket-recv-buffer-size=SIZE
Set the maximum socket receive buffer in bytes.
Specifying 0 will disable this option. This value
will be set to socket file descriptor using
SO_RCVBUF socket option with setsockopt() call.
Possible Values: 0-16777216
Default: 0
Tags: #advanced
--max-mmap-limit=SIZE Set the maximum file size to enable mmap (see
--enable-mmap option). The file size is
determined by the sum of all files contained in
one download. For example, if a download
contains 5 files, then file size is the total
size of those files. If file size is strictly
greater than the size specified in this option,
mmap will be disabled.
Possible Values: 0-*
Default: 9223372036854775807
Tags: #advanced
--stderr[=true|false] Redirect all console output that would be
otherwise printed in stdout to stderr.
Possible Values: true, false
Default: false
Tags: #advanced
--keep-unfinished-download-result[=true|false]
Keep unfinished download results even if doing
so exceeds --max-download-result. This is useful
if all unfinished downloads must be saved in
session file (see --save-session option). Please
keep in mind that there is no upper bound to the
number of unfinished download result to keep. If
that is undesirable, turn this option off.
Possible Values: true, false
Default: true
Tags: #advanced
--ftp-user=USER Set FTP user. This affects all URLs.
Tags: #basic, #ftp
--ftp-passwd=PASSWD Set FTP password. This affects all URLs.
Tags: #basic, #ftp
--ftp-type=TYPE Set FTP transfer type.
Possible Values: binary, ascii
Default: binary
Tags: #ftp
-p, --ftp-pasv[=true|false] Use the passive mode in FTP. If false is given,
the active mode will be used.
Possible Values: true, false
Default: true
Tags: #ftp
--ftp-reuse-connection[=true|false] Reuse connection in FTP.
Possible Values: true, false
Default: true
Tags: #ftp
--ssh-host-key-md=TYPE=DIGEST
Set checksum for SSH host public key. TYPE is
hash type. The supported hash type is sha-1 or
md5. DIGEST is hex digest. For example:
sha-1=b030503d4de4539dc7885e6f0f5e256704edf4c3
This option can be used to validate server's
public key when SFTP is used. If this option is
not set, which is default, no validation takes
place.
Possible Values: HASH_TYPE=HEX_DIGEST
Tags: #ftp
--http-user=USER Set HTTP user. This affects all URLs.
Tags: #basic, #http
--http-passwd=PASSWD Set HTTP password. This affects all URLs.
Tags: #basic, #http
-U, --user-agent=USER_AGENT Set user agent for http(s) downloads.
Default: aria2/1.31.0
Tags: #http
--load-cookies=FILE Load Cookies from FILE using the Firefox3 format
and Mozilla/Firefox(1.x/2.x)/Netscape format.
Possible Values: /path/to/file
Tags: #basic, #http, #cookie
--save-cookies=FILE Save Cookies to FILE in Mozilla/Firefox(1.x/2.x)/
Netscape format. If FILE already exists, it is
overwritten. Session Cookies are also saved and
their expiry values are treated as 0.
Possible Values: /path/to/file
Tags: #http, #cookie
--enable-http-keep-alive[=true|false] Enable HTTP/1.1 persistent connection.
Possible Values: true, false
Default: true
Tags: #http
--enable-http-pipelining[=true|false] Enable HTTP/1.1 pipelining.
Possible Values: true, false
Default: false
Tags: #http
--header=HEADER Append HEADER to HTTP request header. You can use
this option repeatedly to specify more than one
header:
aria2c --header="X-A: b78" --header="X-B: 9J1"
http://host/file
Tags: #http
--certificate=FILE Use the client certificate in FILE.
The certificate must be in PEM format.
You may use --private-key option to specify the
private key.
Possible Values: /path/to/file
Tags: #http, #https
--private-key=FILE Use the private key in FILE.
The private key must be decrypted and in PEM
format. See also --certificate option.
Possible Values: /path/to/file
Tags: #http, #https
--ca-certificate=FILE Use the certificate authorities in FILE to verify
the peers. The certificate file must be in PEM
format and can contain multiple CA certificates.
Use --check-certificate option to enable
verification.
Possible Values: /path/to/file
Tags: #http, #https
--check-certificate[=true|false] Verify the peer using certificates specified
in --ca-certificate option.
Possible Values: true, false
Default: true
Tags: #http, #https
--use-head[=true|false] Use HEAD method for the first request to the HTTP
server.
Possible Values: true, false
Default: false
Tags: #http
--http-auth-challenge[=true|false] Send HTTP authorization header only when it
is requested by the server. If false is set, then
authorization header is always sent to the server.
There is an exception: if username and password
are embedded in URI, authorization header is
always sent to the server regardless of this
option.
Possible Values: true, false
Default: false
Tags: #http
--http-no-cache[=true|false] Send Cache-Control: no-cache and Pragma: no-cache
header to avoid cached content. If false is
given, these headers are not sent and you can add
Cache-Control header with a directive you like
using --header option.
Possible Values: true, false
Default: false
Tags: #http
--http-accept-gzip[=true|false] Send 'Accept: deflate, gzip' request header
and inflate response if remote server responds
with 'Content-Encoding: gzip' or
'Content-Encoding: deflate'.
Possible Values: true, false
Default: false
Tags: #http
--content-disposition-default-utf8[=true|false] Handle quoted string in
Content-Disposition header as UTF-8 instead of
ISO-8859-1, for example, the filename parameter,
but not the extended version filename*.
Possible Values: true, false
Default: false
Tags: #advanced, #http
--http-proxy=PROXY Use a proxy server for HTTP. To override a
previously defined proxy, use "".
See also the --all-proxy option.
This affects all http downloads.
Possible Values: [http://][USER:PASSWORD@]HOST[:PORT]
Tags: #http
--https-proxy=PROXY Use a proxy server for HTTPS. To override a
previously defined proxy, use "".
See also the --all-proxy option.
This affects all https downloads.
Possible Values: [http://][USER:PASSWORD@]HOST[:PORT]
Tags: #http, #https
--ftp-proxy=PROXY Use a proxy server for FTP. To override a
previously defined proxy, use "".
See also the --all-proxy option.
This affects all ftp downloads.
Possible Values: [http://][USER:PASSWORD@]HOST[:PORT]
Tags: #ftp
--all-proxy=PROXY Use a proxy server for all protocols. To override
a previously defined proxy, use "".
You also can override this setting and specify a
proxy server for a particular protocol using the
--http-proxy, --https-proxy and --ftp-proxy
options.
This affects all downloads.
Possible Values: [http://][USER:PASSWORD@]HOST[:PORT]
Tags: #http, #https, #ftp
--no-proxy=DOMAINS Specify comma separated hostnames, domains or
network address with or without CIDR block where
proxy should not be used.
Possible Values: HOSTNAME,DOMAIN,NETWORK/CIDR
Tags: #http, #https, #ftp
--proxy-method=METHOD Set the method to use in proxy request.
Possible Values: get, tunnel
Default: get
Tags: #http, #ftp
--http-proxy-user=USER Set user for --http-proxy.
Tags: #http
--http-proxy-passwd=PASSWD Set password for --http-proxy.
Tags: #http
--https-proxy-user=USER Set user for --https-proxy.
Tags: #http, #https
--https-proxy-passwd=PASSWD Set password for --https-proxy.
Tags: #http, #https
--ftp-proxy-user=USER Set user for --ftp-proxy.
Tags: #ftp
--ftp-proxy-passwd=PASSWD Set password for --ftp-proxy.
Tags: #ftp
--all-proxy-user=USER Set user for --all-proxy.
Tags: #http, #https, #ftp
--all-proxy-passwd=PASSWD Set password for --all-proxy.
Tags: #http, #https, #ftp
-S, --show-files[=true|false] Print file listing of .torrent, .meta4 and
.metalink file and exit. More detailed
information will be listed in case of torrent
file.
Possible Values: true, false
Default: false
Tags: #basic, #metalink, #bittorrent
--max-overall-upload-limit=SPEED Set max overall upload speed in bytes/sec.
0 means unrestricted.
You can append K or M(1K = 1024, 1M = 1024K).
To limit the upload speed per torrent, use
--max-upload-limit option.
Possible Values: 0-*
Default: 0
Tags: #basic, #bittorrent
-u, --max-upload-limit=SPEED Set max upload speed per each torrent in
bytes/sec. 0 means unrestricted.
You can append K or M(1K = 1024, 1M = 1024K).
To limit the overall upload speed, use
--max-overall-upload-limit option.
Possible Values: 0-*
Default: 0
Tags: #basic, #bittorrent
-T, --torrent-file=TORRENT_FILE The path to the .torrent file.
Possible Values: /path/to/file
Tags: #basic, #bittorrent
--listen-port=PORT... Set TCP port number for BitTorrent downloads.
Multiple ports can be specified by using ',',
for example: "6881,6885". You can also use '-'
to specify a range: "6881-6999". ',' and '-' can
be used together.
Possible Values: 1024-65535
Default: 6881-6999
Tags: #basic, #bittorrent
--follow-torrent=true|false|mem If true or mem is specified, when a file
whose suffix is .torrent or content type is
application/x-bittorrent is downloaded, aria2
parses it as a torrent file and downloads files
mentioned in it.
If mem is specified, a torrent file is not
written to the disk, but is just kept in memory.
If false is specified, the .torrent file is
downloaded to the disk, but is not parsed as a
torrent and its contents are not downloaded.
Possible Values: true, mem, false
Default: true
Tags: #bittorrent
--select-file=INDEX... Set file to download by specifying its index.
You can find the file index using the
--show-files option. Multiple indexes can be
specified by using ',', for example: "3,6".
You can also use '-' to specify a range: "1-5".
',' and '-' can be used together.
When used with the -M option, index may vary
depending on the query(see --metalink-* options).
Possible Values: 1-1048576
Tags: #metalink, #bittorrent
--seed-time=MINUTES Specify seeding time in (fractional) minutes.
Also see the --seed-ratio option.
Possible Values: 0.0-*
Tags: #bittorrent
--seed-ratio=RATIO Specify share ratio. Seed completed torrents
until share ratio reaches RATIO.
You are strongly encouraged to specify equals or
more than 1.0 here. Specify 0.0 if you intend to
do seeding regardless of share ratio.
If --seed-time option is specified along with
this option, seeding ends when at least one of
the conditions is satisfied.
Possible Values: 0.0-*
Default: 1.0
Tags: #bittorrent
--peer-id-prefix=PEER_ID_PREFIX Specify the prefix of peer ID. The peer ID in
BitTorrent is 20 byte length. If more than 20
bytes are specified, only first 20 bytes are
used. If less than 20 bytes are specified, random
byte data are added to make its length 20 bytes.
Default: A2-1-31-0-
Tags: #bittorrent
--enable-peer-exchange[=true|false] Enable Peer Exchange extension.
Possible Values: true, false
Default: true
Tags: #bittorrent
--enable-dht[=true|false] Enable IPv4 DHT functionality. It also enables
UDP tracker support. If a private flag is set
in a torrent, aria2 doesn't use DHT for that
download even if ``true`` is given.
Possible Values: true, false
Default: true
Tags: #basic, #bittorrent
--dht-listen-port=PORT... Set UDP listening port used by DHT(IPv4, IPv6)
and UDP tracker. Multiple ports can be specified
by using ',', for example: "6881,6885". You can
also use '-' to specify a range: "6881-6999".
',' and '-' can be used together.
Possible Values: 1024-65535
Default: 6881-6999
Tags: #basic, #bittorrent
--dht-entry-point=HOST:PORT Set host and port as an entry point to IPv4 DHT
network.
Possible Values: HOST:PORT
Tags: #bittorrent
--dht-file-path=PATH Change the IPv4 DHT routing table file to PATH.
Possible Values: /path/to/file
Default: C:/Users/Administrator/.aria2/dht.dat
Tags: #bittorrent
--enable-dht6[=true|false] Enable IPv6 DHT functionality.
Use --dht-listen-port option to specify port
number to listen on. See also --dht-listen-addr6
option.
Possible Values: true, false
Default: false
Tags: #basic, #bittorrent
--dht-listen-addr6=ADDR Specify address to bind socket for IPv6 DHT.
It should be a global unicast IPv6 address of the
host.
Tags: #basic, #bittorrent
--dht-entry-point6=HOST:PORT Set host and port as an entry point to IPv6 DHT
network.
Possible Values: HOST:PORT
Tags: #bittorrent
--dht-file-path6=PATH Change the IPv6 DHT routing table file to PATH.
Possible Values: /path/to/file
Default: C:/Users/Administrator/.cache/aria2/dht6.dat
Tags: #bittorrent
--bt-min-crypto-level=plain|arc4 Set minimum level of encryption method.
If several encryption methods are provided by a
peer, aria2 chooses the lowest one which satisfies
the given level.
Possible Values: plain, arc4
Default: plain
Tags: #bittorrent
--bt-require-crypto[=true|false] If true is given, aria2 doesn't accept and
establish connection with legacy BitTorrent
handshake. Thus aria2 always uses Obfuscation
handshake.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-request-peer-speed-limit=SPEED If the whole download speed of every
torrent is lower than SPEED, aria2 temporarily
increases the number of peers to try for more
download speed. Configuring this option with your
preferred download speed can increase your
download speed in some cases.
You can append K or M(1K = 1024, 1M = 1024K).
Possible Values: 0-*
Default: 50K
Tags: #bittorrent
--bt-max-open-files=NUM Specify maximum number of files to open in
multi-file BitTorrent/Metalink downloads
globally.
Possible Values: 1-*
Default: 100
Tags: #bittorrent
--bt-seed-unverified[=true|false] Seed previously downloaded files without
verifying piece hashes.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-hash-check-seed[=true|false] If true is given, after hash check using
--check-integrity option and file is complete,
continue to seed file. If you want to check file
and download it only when it is damaged or
incomplete, set this option to false.
This option has effect only on BitTorrent
download.
Possible Values: true, false
Default: true
Tags: #bittorrent, #checksum
--bt-max-peers=NUM Specify the maximum number of peers per torrent.
0 means unlimited.
See also --bt-request-peer-speed-limit option.
Possible Values: 0-*
Default: 55
Tags: #bittorrent
--bt-external-ip=IPADDRESS Specify the external IP address to use in
BitTorrent download and DHT. It may be sent to
BitTorrent tracker. For DHT, this option should
be set to report that local node is downloading
a particular torrent. This is critical to use
DHT in a private network. Although this function
is named 'external', it can accept any kind of IP
addresses.
Possible Values: a numeric IP address
Tags: #bittorrent
-O, --index-out=INDEX=PATH Set file path for file with index=INDEX. You can
find the file index using the --show-files option.
PATH is a relative path to the path specified in
--dir option. You can use this option multiple
times.
Possible Values: INDEX=PATH
Tags: #bittorrent
--bt-tracker-interval=SEC Set the interval in seconds between tracker
requests. This completely overrides interval value
and aria2 just uses this value and ignores the
min interval and interval value in the response of
tracker. If 0 is set, aria2 determines interval
based on the response of tracker and the download
progress.
Possible Values: 0-*
Default: 0
Tags: #bittorrent
--bt-stop-timeout=SEC Stop BitTorrent download if download speed is 0 in
consecutive SEC seconds. If 0 is given, this
feature is disabled.
Possible Values: 0-*
Default: 0
Tags: #bittorrent
--bt-prioritize-piece=head[=SIZE],tail[=SIZE] Try to download first and last
pieces of each file first. This is useful for
previewing files. The argument can contain 2
keywords:head and tail. To include both keywords,
they must be separated by comma. These keywords
can take one parameter, SIZE. For example, if
head=SIZE is specified, pieces in the range of
first SIZE bytes of each file get higher priority.
tail=SIZE means the range of last SIZE bytes of
each file. SIZE can include K or M(1K = 1024, 1M =
1024K). If SIZE is omitted, SIZE=1M is used.
Possible Values: head[=SIZE], tail[=SIZE]
Tags: #bittorrent
--bt-save-metadata[=true|false] Save metadata as .torrent file. This option has
effect only when BitTorrent Magnet URI is used.
The filename is hex encoded info hash with suffix
.torrent. The directory to be saved is the same
directory where download file is saved. If the
same file already exists, metadata is not saved.
See also --bt-metadata-only option.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-metadata-only[=true|false] Download metadata only. The file(s) described
in metadata will not be downloaded. This option
has effect only when BitTorrent Magnet URI is
used. See also --bt-save-metadata option.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-enable-lpd[=true|false] Enable Local Peer Discovery.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-lpd-interface=INTERFACE Use given interface for Local Peer Discovery. If
this option is not specified, the default
interface is chosen. You can specify interface
name and IP address.
Possible Values: interface, IP address
Tags: #bittorrent
--bt-tracker-timeout=SEC Set timeout in seconds.
Possible Values: 1-600
Default: 60
Tags: #bittorrent
--bt-tracker-connect-timeout=SEC Set the connect timeout in seconds to
establish connection to tracker. After the
connection is established, this option makes no
effect and --bt-tracker-timeout option is used
instead.
Possible Values: 1-600
Default: 60
Tags: #bittorrent
--dht-message-timeout=SEC Set timeout in seconds.
Possible Values: 1-60
Default: 10
Tags: #bittorrent
--on-bt-download-complete=COMMAND For BitTorrent, a command specified in
--on-download-complete is called after download
completed and seeding is over. On the other hand,
this option sets the command to be executed after
download completed but before seeding.
See --on-download-start option for the
requirement of COMMAND.
Possible Values: /path/to/command
Tags: #advanced, #hook
--bt-tracker=URI[,...] Comma separated list of additional BitTorrent
tracker's announce URI. These URIs are not
affected by --bt-exclude-tracker option because
they are added after URIs in --bt-exclude-tracker
option are removed.
Possible Values: URI,...
Tags: #bittorrent
--bt-exclude-tracker=URI[,...] Comma separated list of BitTorrent tracker's
announce URI to remove. You can use special value
'*' which matches all URIs, thus removes all
announce URIs. When specifying '*' in shell
command-line, don't forget to escape or quote it.
See also --bt-tracker option.
Possible Values: URI,... or *
Tags: #bittorrent
--bt-remove-unselected-file[=true|false] Removes the unselected files when
download is completed in BitTorrent. To
select files, use --select-file option. If
it is not used, all files are assumed to be
selected. Please use this option with care
because it will actually remove files from
your disk.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-detach-seed-only[=true|false]
Exclude seed only downloads when counting
concurrent active downloads (See -j option).
This means that if -j3 is given and this option
is turned on and 3 downloads are active and one
of those enters seed mode, then it is excluded
from active download count (thus it becomes 2),
and the next download waiting in queue gets
started. But be aware that seeding item is still
recognized as active download in RPC method.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-force-encryption[=true|false]
Requires BitTorrent message payload encryption
with arc4. This is a shorthand of
--bt-require-crypto --bt-min-crypto-level=arc4.
If true is given, deny legacy BitTorrent
handshake and only use Obfuscation handshake and
always encrypt message payload.
Possible Values: true, false
Default: false
Tags: #bittorrent
--bt-enable-hook-after-hash-check[=true|false] Allow hook command invocation
after hash check (see -V option) in BitTorrent
download. By default, when hash check succeeds,
the command given by --on-bt-download-complete
is executed. To disable this action, give false
to this option.
Possible Values: true, false
Default: true
Tags: #bittorrent
-M, --metalink-file=METALINK_FILE The file path to the .meta4 and .metalink
file. Reads input from stdin when '-' is
specified.
Possible Values: /path/to/file, -
Tags: #basic, #metalink
--metalink-version=VERSION The version of the file to download.
Tags: #metalink
--metalink-language=LANGUAGE The language of the file to download.
Tags: #metalink
--metalink-os=OS The operating system of the file to download.
Tags: #metalink
--metalink-location=LOCATION[,...] The location of the preferred server.
A comma-delimited list of locations is
acceptable.
Tags: #metalink
--follow-metalink=true|false|mem If true or mem is specified, when a file
whose suffix is .meta4 or .metalink, or content
type of application/metalink4+xml or
application/metalink+xml is downloaded, aria2
parses it as a metalink file and downloads files
mentioned in it.
If mem is specified, a metalink file is not
written to the disk, but is just kept in memory.
If false is specified, the .metalink file is
downloaded to the disk, but is not parsed as a
metalink file and its contents are not
downloaded.
Possible Values: true, mem, false
Default: true
Tags: #metalink
--metalink-preferred-protocol=PROTO Specify preferred protocol. Specify 'none'
if you don't have any preferred protocol.
Possible Values: http, https, ftp, none
Default: none
Tags: #metalink
--metalink-enable-unique-protocol[=true|false] If true is given and several
protocols are available for a mirror in a metalink
file, aria2 uses one of them.
Use --metalink-preferred-protocol option to
specify the preference of protocol.
Possible Values: true, false
Default: true
Tags: #metalink
--metalink-base-uri=URI Specify base URI to resolve relative URI in
metalink:url and metalink:metaurl element in a
metalink file stored in local disk. If URI points
to a directory, URI must end with '/'.
Tags: #metalink
Refer to man page for more information.
用法:aria2c [选项] [URI | MAGNET | TORRENT_FILE | METALINK_FILE] ...
打印所有选项。
选项:
-v,--version打印版本号并退出。
标签:#basic
-h,--help [= TAG | KEYWORD]打印使用情况并退出。
帮助消息使用标记进行分类。标签
以。。开始 ”#”。例如,键入“--help =#http”
以获取标记的选项的用法
“#http”。如果给出了非标记词,则打印使用
对于其名称包含该单词的选项。
可能的值:#basic,#advanced,#http,#https,#ftp,#metalink,#bittorrent,#cookie,#hook,#file,#rpc,#checksum,#experimental,#deprecated,#help,#all
默认值:#basic
标签:#basic,#help
-t,--timeout = SEC设置超时(以秒为单位)。
可能的值:1-600
默认值:60
标签:#http,#ftp
--connect-timeout = SEC设置建立连接超时(以秒为单位)
连接到HTTP / FTP /代理服务器。之后
连接建立,此选项使no
效果和--timeout选项。
可能的值:1-600
默认值:60
标签:#http,#ftp
-m,--max-attempts = N设置尝试次数。0表示无限。
可能的值:0- *
默认值:5
标签:#http,#ftp
--auto-save-interval = SEC每SEC秒保存一个控制文件(*。aria2)。
如果给定0,则不保存控制文件
下载。aria2在停止时保存控制文件
而不考虑价值。
可能的值:0-600
默认值:60
标签:#advanced
-l,--log = LOG日志文件的文件名。如果“ - ”是
指定,日志写入stdout。
可能的值:/ path / to / file, -
标签:#basic
-d,--dir = DIR存储下载文件的目录。
可能的值:/ path / to / directory
默认值:C:\ aria2-1.31.0 \ aria2-1.31.0-win-32bit-build1
标签:#basic,#file
-o,-out = FILE下载文件的文件名。它是
始终相对于-d中给出的目录
选项。当使用-Z选项时,此选项
将被忽略。
可能的值:/ path / to / file
标签:#basic,#http,#ftp,#file
-s,--split = N使用N个连接下载文件。如果更多
给出N个URI,则使用前N个URI
剩余的URL用于备份。如果小于
给定N个URI,那些URL的使用超过
一次,使得产生N个连接总数
同时。连接数
同一主机受限于
--max-connection-per-server选项。参见
--min-split-size选项。
可能的值:1- *
默认值:5
标签:#basic,#http,#ftp
-D,--daemon [= true | false]作为守护程序运行。当前工作目录将
改为“/”和标准输入,标准
输出和标准错误将被重定向到
“/ dev / null”。
可能的值:true,false
默认值:false
标签:#advanced
--referer = REFERER设置http引用程序(Referer)。这会影响
所有http / https下载。如果给出“*”
下载URI也用作引荐来源网址。
这在与其一起使用时可能是有用的
-P选项。
标签:#http
--lowest-speed-limit = SPEED下载速度低于时关闭连接
或等于此值(字节/秒)。
0表示aria2没有最低速度限制。
您可以追加K或M(1K = 1024,1M = 1024K)。
此选项不影响BitTorrent下载。
可能的值:0- *
默认值:0
标签:#http,#ftp
--piece-length = LENGTH设置HTTP / FTP下载的长度。这个
是aria2拆分文件时的边界。所有
分裂发生在该长度的多个处。这个
选项将被忽略在BitTorrent下载。
如果Metalink文件,也将被忽略
包含散列。
可能的值:1048576-1073741824
默认值:1M
标签:#advanced,#http,#ftp
--max-overall-download-limit = SPEED设置总下载速度(以字节/秒为单位)。
0表示无限制。
您可以追加K或M(1K = 1024,1M = 1024K)。
要限制每次下载的下载速度,请使用
--max-download-limit选项。
可能的值:0- *
默认值:0
标签:#http,#ftp,#bittorrent
--max-download-limit = SPEED设置每次下载的最大下载速度
字节/秒。0表示无限制。
您可以追加K或M(1K = 1024,1M = 1024K)。
要限制总体下载速度,请使用
--max-overall-download-limit选项。
可能的值:0- *
默认值:0
标签:#http,#ftp,#bittorrent
--file-allocation = METHOD指定文件分配方法。
'none'不预分配文件空间。'prealloc'
在下载开始前预分配文件空间。
这可能需要一些时间,具体取决于大小
文件。
如果您使用较新的文件系统,如ext4
(具有盘区支持),btrfs,xfs或NTFS
(仅MinGW构建),'falloc'是你最好的
选择。它分配大(几个GiB)文件
几乎瞬间。不要使用'falloc'与遗产
文件系统,如ext3和FAT32,因为它
几乎与'prealloc'和它的时间相同
完全阻塞aria2,直到分配完成。
'falloc'可能不可用,如果你的系统
没有posix_fallocate()函数。
'trunc'使用ftruncate()系统调用或
平台特定对象截断文件
到指定长度。
可能的值:none,prealloc,trunc,falloc
默认值:prealloc
标签:#basic,#file
--no-file-allocation-limit = SIZE不为文件分配文件
大小小于SIZE。
您可以追加K或M(1K = 1024,1M = 1024K)。
可能的值:0- *
默认值:5M
标签:#advanced,#file
--allow-overwrite [= true | false]如果从头开始重新启动下载
对应的控制文件不存在。看到
也 - 自动文件重命名选项。
可能的值:true,false
默认值:false
标签:#advanced,#file
--realtime-chunk-checksum [= true | false]通过计算验证数据块
如果chunk下载文件,则检查和
提供校验和。
可能的值:true,false
默认值:true
标签:#metalink,#checksum
-V,--check-integrity [= true | false]通过验证片段来检查文件完整性
散列或整个文件的散列。此选项具有
效果只有在BitTorrent,Metalink下载
与校验和或HTTP(S)/ FTP下载
--checksum选项。如果提供散片,
此选项可以检测文件的损坏部分
并重新下载。如果整个文件的哈希
提供,哈希检查只有当文件有
已经下载。这由文件确定
长度。如果散列检查失败,文件是
从头开始重新下载。如果两个片断
并提供整个文件的哈希值
使用散列。
可能的值:true,false
默认值:false
标签:#basic,#metalink,#bittorrent,#file,#checksum
--netrc-path = FILE指定netrc文件的路径。
可能的值:/ path / to / file
默认值:C:/Users/Administrator/.netrc
标签:
-c,--continue [= true | false]继续下载部分下载的内容
文件。使用此选项恢复下载
由Web浏览器或其他程序启动
它从中顺序地下载文件
开始。目前只有这个选项
适用于http(s)/ ftp下载。
可能的值:true,false
默认值:false
标签:#basic,#http,#ftp
-n,--no-netrc [= true | false]禁用netrc支持。
可能的值:true,false
默认值:false
标签:#http,#ftp
-i,--input-file = FILE下载在FILE中找到的URI。您可以指定
单个实体的多个URI:单独
使用TAB字符在一行上的URI。
当指定了' - '时从stdin读取输入。
此外,可以在每个选项之后指定选项
线的URI。此可选行必须以
一个或多个空格,每个有一个选项
单线。请参见手册页的INPUT FILE部分
详情。另请参见--deferred-input选项。
可能的值:/ path / to / file, -
标签:#basic
--deferred-input [= true | false]如果给出true,aria2不会读取所有URI
和-i选项指定的文件中的选项
启动,但它读取一个一个,当它需要
后来。如果输入,这可以减少内存使用
文件包含大量的URI下载。
如果给出false,aria2读取所有URI和
选项。
可能的值:true,false
默认值:false
标签:#advanced
-j,--max-concurrent-downloads = N设置并行下载的最大数量
每个静态(HTTP / FTP)URL,洪流和metalink。
另请参见--split和--optimize-concurrent-downloads选项。
可能的值:1- *
默认值:5
标签:#basic
--optimize-concurrent-downloads [= true | false | A:B]优化数量
根据带宽并发下载
可用。aria2使用观察的下载速度
在以前的下载中适应数量
下载并行推出的
规则N = A + B Log10(以Mbps为单位的速度)。的
系数A和B可以定制在
选项参数,A和B由a分隔
结肠。导致的默认值(A = 5,B = 25)
通常在1Mbps下使用5个并行下载
网络和100Mbps网络上50以上。的
并行下载的数量保持受限
低于最大定义的
max-concurrent-downloads参数。
可能的值:true,false,A:B
默认值:false
标签:#advanced
-Z,--force-sequential [= true | false]按顺序在命令行中获取URI
并在单独的会话中下载每个URI,如
通常的命令行下载实用程序。
可能的值:true,false
默认值:false
标签:#basic
--auto-file-renaming [= true | false]重命名文件名,如果同一个文件已经
存在。此选项仅在http(s)/ ftp中有效
下载。
新文件名有一个点和一个数字(1..9999)
附加在名称后面,但在文件之前
扩展(如果有)。
可能的值:true,false
默认值:true
标签:#advanced,#file
-P,--parameterized-uri [= true | false]启用参数化URI支持。
您可以指定零件集:
http:// {sv1,sv2,sv3} /foo.iso
也可以指定带步骤的数字序列
计数器:
http:// host / image [000-100:2] .img
可以省略步进计数器。
如果所有URI不指向同一个文件,如
作为上面的第二个例子,-Z选项是
需要。
可能的值:true,false
默认值:false
标签:#advanced
--allow-piece-length-change [= true | false]如果给出false,aria2中止
当长度不同时下载
一个在控制文件中。如果给出true,你可以
继续,但有些下载进度会丢失。
可能的值:true,false
默认值:false
标签:#advanced
--no-conf [= true | false]禁用加载aria2.conf文件。
可能的值:true,false
默认值:false
标签:#advanced
--conf-path = PATH将配置文件路径更改为PATH。
可能的值:/ path / to / file
默认值:C:/Users/Administrator/.config/aria2/aria2.conf
标签:#advanced
--stop = SEC SEC秒过后停止应用程序。
如果给定0,则禁用此功能。
可能的值:0-2147483647
默认值:0
标签:#advanced
-q,--quiet [= true | false]使aria2安静(无控制台输出)。
可能的值:true,false
默认值:false
标签:#advanced
--async-dns [= true | false]启用异步DNS。
可能的值:true,false
默认值:true
标签:#advanced
--summary-interval = SEC设置输出下载进度摘要的间隔。
设置0抑制输出。
可能的值:0-2147483647
默认值:60
标签:#advanced
--log-level = LEVEL设置输出到使用指定的文件的日志级别
--log选项。
可能的值:debug,info,notice,warn,error
默认值:debug
标签:#advanced
--console-log-level = LEVEL设置日志级别以输出到控制台。
可能的值:debug,info,notice,warn,error
默认值:通知
标签:#advanced
--uri-selector = SELECTOR指定URI选择算法。
如果给出了“inorder”,则按顺序尝试URI
出现在URI列表中。
如果给出“feedback”,aria2使用下载速度
观察在以前的下载和选择
在URI列表中最快的服务器。这也是
有效地跳过死镜。观察
下载速度是性能配置文件的一部分
的服务器中提到的--server-stat-of和
--server-stat-if选项。
如果给出“adaptive”,选择最好的一个
镜像用于第一个和保留的连接。
对于补充,它返回镜子
尚未测试,并且如果它们中的每一个具有
已经测试,返回镜子必须
再次测试。否则,它不选择
任何镜子。喜欢'反馈',它使用一个
服务器的性能配置文件。
可能的值:inorder,feedback,adaptive
默认值:反馈
标签:#http,#ftp
--server-stat-timeout = SEC指定以秒为单位的超时时间
自上次以来服务器的性能配置文件
联系他们。
可能的值:0-2147483647
默认值:86400
标签:#http,#ftp
--server-stat-if = FILE指定要加载性能概要文件的文件名
的服务器。将使用加载的数据
一些URI选择器如“feedback”。
另请参见--uri-selector选项
可能的值:/ path / to / file
标签:#http,#ftp
--server-stat-of = FILE指定性能配置文件的文件名
的服务器被保存。您可以加载保存的数据
使用--server-stat-if选项。
可能的值:/ path / to / file
标签:#http,#ftp
-R,--remote-time [= true | false]从中获取远程文件的时间戳
远程HTTP / FTP服务器,如果可用,
将其应用于本地文件。
可能的值:true,false
默认值:false
标签:#http,#ftp
--max-file-not-found = NUM如果aria2从中接收到“文件未找到”状态
远程HTTP / FTP服务器NUM次没有获得
单个字节,然后强制下载失败。
指定0以禁用此选项。
此选项仅在使用时有效
HTTP / FTP服务器。重试尝试的次数为
计数到--max尝试,所以应该是
配置太。
可能的值:0- *
默认值:0
标签:#http,#ftp
--event-poll = POLL指定轮询事件的方法。
可能的值:select
默认值:选择
标签:#advanced
--enable-rpc [= true | false]启用JSON-RPC / XML-RPC服务器。
强烈建议设置秘密
授权令牌使用--rpc-secret选项。
另请参见--rpc-listen-port选项。
可能的值:true,false
默认值:false
标签:#rpc
--rpc-listen-port = PORT为JSON-RPC / XML-RPC服务器指定端口号
听。
可能的值:1024-65535
默认值:6800
标签:#rpc
--rpc-user = USER设置JSON-RPC / XML-RPC用户。此选项将是
在将来的版本中已弃用。迁移到
--rpc-secret选项。
标签:#rpc,#deprecated
--rpc-passwd = PASSWD设置JSON-RPC / XML-RPC密码。此选项将
在将来的版本中被弃用。迁移到
--rpc-secret选项。
标签:#rpc,#deprecated
--rpc-max-request-size = SIZE设置JSON-RPC / XML-RPC请求的最大大小。如果aria2
检测到请求超过SIZE个字节,它
drop连接。
可能的值:0- *
默认值:2M
标签:#rpc
--rpc-listen-all [= true | false]监听所有的传入JSON-RPC / XML-RPC请求
网络接口。如果给出false,则仅监听
在本地环回接口。
可能的值:true,false
默认值:false
标签:#rpc
--rpc-allow-origin-all [= true | false]添加Access-Control-Allow-Origin标头
字段,值为'*'到RPC响应。
可能的值:true,false
默认值:false
标签:#rpc
--rpc-certificate = FILE在RPC服务器的FILE中使用证书。
证书必须为PEM格式。
使用--rpc-private-key选项指定
私钥。使用--rpc-secure选项启用
加密。
可能的值:/ path / to / file
标签:#rpc
--rpc-private-key = FILE在RPC服务器的FILE中使用私钥。
私钥必须在PEM中解密
格式。使用--rpc-secure选项启用
加密。另请参见--rpc-certificate选项。
可能的值:/ path / to / file
标签:#rpc
--rpc-secure [= true | false] RPC传输将通过SSL / TLS加密。
RPC客户端必须使用https方案才能访问
服务器。对于WebSocket客户端,使用wss
方案。使用--rpc-certificate和
--rpc-private-key选项指定
服务器证书和私钥。
可能的值:true,false
默认值:false
标签:#rpc
--rpc-save-upload-metadata [= true | false]保存上传的torrent或
metalink元数据在指定的目录中
by -dir选项。文件名由
SHA-1哈希十六进制字符串的元数据加
延期。对于torrent,扩展名是
'。激流'。对于metalink,它是'.meta4'。
如果此选项为false,则
下载由aria2.addTorrent添加或
aria2.addMetalink不会被保存
--save-session选项。
可能的值:true,false
默认值:true
标签:#rpc
--dry-run [= true | false]如果给出true,aria2只是检查
远程文件是可用的,不下载
数据。此选项对HTTP / FTP下载有效。
如果是真的,BitTorrent下载被取消
指定。
可能的值:true,false
默认值:false
标签:#http,#ftp
--reuse-uri [= true | false]如果没有未使用的URI,请重用已经使用的URI
剩下。
可能的值:true,false
默认值:true
标签:#http,#ftp
--on-download-start = COMMAND设置下载后要执行的命令
开始了。aria2将3个参数传递给COMMAND:
GID,文件数和文件路径。请参阅事件
钩子在手册页中了解更多详情。
可能的值:/ path / to / command
标签:#advanced,#hook
--on-download-pause = COMMAND设置下载后执行的命令
已暂停。
请参见--on-download-start选项
要求COMMAND。
可能的值:/ path / to / command
标签:#advanced,#hook
--on-download-stop = COMMAND设置下载后执行的命令
停止。您可以覆盖命令为
执行特定下载结果使用
--on-download-complete和--on-download-error。如果
它们是指定的,命令在此指定
选项不执行。
请参见--on-download-start选项
要求COMMAND。
可能的值:/ path / to / command
标签:#advanced,#hook
--on-download-complete = COMMAND设置下载后执行的命令
完成。
请参见--on-download-start选项
要求COMMAND。
另请参见--on-download-stop选项。
可能的值:/ path / to / command
标签:#advanced,#hook
--on-download-error = COMMAND设置下载后要执行的命令
由于错误而中止。
请参见--on-download-start选项
要求COMMAND。
另请参见--on-download-stop选项。
可能的值:/ path / to / command
标签:#advanced,#hook
--interface = INTERFACE将套接字绑定到给定接口。您可以指定
接口名称,IP地址和主机名。
可能的值:接口,IP地址,主机名
标签:#advanced
--multiple-interface = INTERFACES要绑定的接口的逗号分隔列表
sockets到。请求将分成
接口实现链路聚合。您可以
指定接口名称,IP地址和主机名。
如果使用--interface,则此选项将为
忽略。
可能的值:接口,IP地址,主机名
标签:#advanced
--disable-ipv6 [= true | false]禁用IPv6。
可能的值:true,false
默认值:true
标签:#advanced
--human-readable [= true | false]以人类可读的格式打印尺寸和速度
(例如,1.2Ki,3.4Mi)。
可能的值:true,false
默认值:true
标签:#advanced
--remove-control-file [= true | false]在下载之前删除控制文件。使用
与--allow-overwrite = true,始终下载
从头开始。这将是有用的
代理服务器后面的用户禁用恢复。
可能的值:true,false
默认值:false
标签:#advanced
--always-resume [= true | false]总是恢复下载。如果给出true,aria2
总是试图恢复下载,如果恢复是
不可能,中止下载。如果给出false,
当所有给定的URI不支持恢复或
aria2遇到不支持的N个URI
resume(N是使用指定的值
--max-resume-failure-attempts选项),aria2
从头开始下载文件。
请参见--max-resume-failure-attempts选项。
可能的值:true,false
默认值:true
标签:#advanced,#http,#ftp
--max-resume-failure-attempts = N当与--always-resume = false,aria2一起使用时
当aria2检测到N时从头开始下载文件
不支持恢复的URI数量。如果N
是0,aria2从所有下载文件从头开始
给定的URI不支持resume。
请参见--always-resume选项。
可能的值:0- *
默认值:0
标签:#advanced,#http,#ftp
--save-session = FILE退出时保存错误/未完成的下载到FILE。
您可以将此输出文件传递给带有-i的aria2c
选项。请注意,下载
添加由aria2.addTorrent和aria2.addMetalink
RPC方法,并且无法保存其元数据
作为文件将不会被保存。已移除下载
使用aria2.remove和aria2.forceRemove不会
保存。
可能的值:/ path / to / file
标签:#advanced
-x,--max-connection-per-server = NUM到一个的最大连接数
服务器进行每次下载。
可能的值:1-16
默认值:1
标签:#basic,#http,#ftp
-k,--min-split-size = SIZE aria2不分割小于2 * SIZE字节范围。
例如,让我们考虑下载20MiB
文件。如果SIZE为10M,aria2可以将文件拆分为2
范围[0-10MiB]和[10MiB-20MiB]并下载
使用2个源(如果--split> = 2,当然)。
如果SIZE是15M,因为2 * 15M> 20MiB,aria2
不分割文件,并使用1源下载。
您可以追加K或M(1K = 1024,1M = 1024K)。
可能的值:1048576-1073741824
默认值:20M
标签:#basic,#http,#ftp
--conditional-get [= true | false]只有当本地文件较旧时下载文件
比远程文件。目前,这个函数有
许多限制。有关详细信息,请参阅手册页。
可能的值:true,false
默认值:false
标签:#advanced,#http
--enable-async-dns6 [= true | false]以异步方式启用IPv6名称解析
DNS解析器。此选项将在被忽略
--async-dns = false。
可能的值:true,false
标签:#advanced,#deprecated
--max-download-result = NUM设置保存的最大下载结果数
记忆。下载结果完成/错误/
删除下载。存储下载结果
在FIFO队列中,它最多可以存储NUM个
下载结果。当队列已满和新
创建下载结果,最早的下载结果
从队列的前面和新的删除
被推到后面。在这里设置大数字
选项可能会导致高内存消耗
数以千计的下载。指定0表示没有
下载结果保留。注意未完成
下载内容保存在内存中,无论如何
选项值。看到
--keep-unfinished-download-result选项。
可能的值:0- *
默认值:1000
标签:#advanced
--retry-wait = SEC设置重试之间等待的秒数。
当SEC> 0时,aria2将重试下载
HTTP服务器返回503响应。
可能的值:0-600
默认值:0
标签:#http,#ftp
--async-dns-server = IPADDRESS [,...]以逗号分隔的DNS服务器地址列表
用于异步DNS解析器。通常
异步DNS解析器读取DNS服务器
地址从/etc/resolv.conf。当这个选项
,它使用在此指定的DNS服务器
选项,而不是/etc/resolv.conf中的。您
可以指定IPv4和IPv6地址。这个
选项在系统没有时很有用
/etc/resolv.conf和用户没有
权限创建它。
标签:#advanced
--show-console-readout [= true | false]显示控制台读数。
可能的值:true,false
默认值:true
标签:#advanced
--stream-piece-selector = SELECTOR指定片选择算法
用于HTTP / FTP下载。件意味着固定
长度段被并行下载
在分段下载。如果给出“default”
aria2选择片,以减少
建立连接的数量。这是
合理的默认行为,因为
建立连接是昂贵的
操作。
如果给出“inorder”,aria2选择片段
具有最小指数。索引= 0表示第一个
文件。这将有助于查看电影时
下载它。--enable-http-pipelining选项
可用于减少重新连接开销。
请注意aria2的荣誉
--min-split-size选项,因此它是必要的
以指定一个合理的值
--min-split-size选项。
如果给出了'random',aria2选择片段
随机。像'inorder',--min-split-size
选项被授予。
如果给出“geom”,在开始aria2
选择具有最小索引的片段
'inorder',但它指数级增长
保留与先前选择的片段的空间。这个
将减少建立连接的次数
并在同一时间下载
开始部分文件首先。这会是
用于在下载电影时查看电影。
可能的值:default,inorder,random,geom
默认值:默认值
标签:#http,#ftp
--truncate-console-readout [= true | false]截断控制台读数以适应
单行。
可能的值:true,false
默认值:true
标签:#advanced
--pause [= true | false]添加后暂停下载。此选项为
仅当给出--enable-rpc = true时才有效。
可能的值:true,false
默认值:false
标签:#advanced,#rpc
--download-result = OPT此选项更改“下载结果”的方式,
格式化。如果OPT是'default',打印GID,
状态,平均下载速度和路径/ URI。如果
涉及多个文件,path / URI为第一个
请求的文件被打印,其余的是
省略。
如果OPT为“full”,则打印GID,状态,平均值
下载速度,进度百分比
路径/ URI。进度的百分比
路径/ URI为每个请求的文件打印
每行。
如果OPT为“隐藏”,则“下载结果”将被隐藏。
可能的值:default,full,hide
默认值:默认值
标签:#advanced
--hash-check-only [= true | false]如果为true,则在使用hash检查之后
--check-integrity选项,中止下载是否
或者没有下载完成。
可能的值:true,false
默认值:false
标签:#advanced,#metalink,#bittorrent,#file,#checksum
--checksum = TYPE = DIGEST设置校验和。TYPE是散列类型。支持
哈希类型在“哈希算法”中列出
“aria2c -v”。DIGEST是十六进制摘要。
例如,设置sha-1摘要类似
这个:
sha-1 = 0192ba11326fe2298c8cb4de616f4d4140213838
此选项仅适用于HTTP(S)/ FTP
下载。
可能值:HASH_TYPE = HEX_DIGEST
标签:#http,#ftp,#checksum
--stop-with-process = PID当进程PID未运行时停止应用程序。
如果aria2进程是从a分叉的,这是有用的
父进程。父进程可以fork aria2
具有自己的pid,当父进程退出时
由于某种原因,aria2可以检测它并关闭
本身。
可能的值:0- *
标签:#advanced
--enable-mmap [= true | false]将文件映射到内存。
可能的值:true,false
默认值:false
标签:#advanced,#experimental
--force-save [= true | false]使用--save-session选项甚至保存下载
如果下载完成或删除。这个
选项也保存控制文件
情况。这可能是有用的保存
BitTorrent播种,识别为
完成状态。
可能的值:true,false
默认值:false
标签:#advanced
--save-not-found [= true | false]使用--save-session选项甚至保存下载
如果在服务器上找不到该文件。这个
选项也保存控制文件
情况。
可能的值:true,false
默认值:true
标签:#advanced
--disk-cache = SIZE启用磁盘缓存。如果SIZE为0,表示磁盘缓存
被禁用。此功能缓存下载的
内存中的数据,其增长到最大SIZE
字节。为aria2创建高速缓存存储
实例并由所有下载共享。唯一的那个
优点是磁盘缓存减少了磁盘
I / O,因为数据是以更大的单位写入的
并且它被文件的偏移重新排序。
如果涉及哈希检查和数据
缓存在内存中,我们不需要读它们
从磁盘。
SIZE可以包括K或M(1K = 1024,1M = 1024K)。
可能的值:0- *
默认值:16M
标签:#advanced
--gid = GID手动设置GID。aria2标识每个
由称为GID的ID下载。GID必须是
16个字符的十六进制字符串,因此[0-9a-zA-Z]
是允许的,前导零不能是
剥离。GID全0是保留的,必须是
不使用。GID必须是唯一的,否则
将报告错误,并且不会添加下载。
此选项在还原时很有用
会话使用--save-session选项保存。如果
此选项不使用,则会生成新的GID
通过aria2。
标签:#advanced
--save-session-interval = SEC将错误/未完成的下载保存到文件
由--save-session选项指定每个SEC
秒。如果给定0,文件将仅保存
当aria2退出时。
可能的值:0- *
默认值:0
标签:#advanced
--enable-color [= true | false]为终端启用颜色输出。
可能的值:true,false
默认值:true
标签:#advanced
--rpc-secret = TOKEN设置RPC密钥授权令牌。
标签:#rpc
--dscp = DSCP设置输出IP包中的DSCP值
用于QoS的BitTorrent流量。此参数设置
只有IP数据包的TOS字段中的DSCP位,
不是整个字段。如果你采取价值观
从/usr/include/netinet/ip.h中除以4
(否则值会不正确,例如您的
CS1类将变成CS4)。如果你带
常用值来自RFC,
文档,维基百科或任何其他来源,
使用它们。
可能的值:0- *
默认值:0
标签:#advanced
--pause-metadata [= true | false]
暂停因元数据而创建的下载
下载。有3种类型的元数据
下载aria2:(1)下载.torrent
文件。(2)使用下载洪流元数据
磁链。(3)下载metalink文件。
这些元数据下载将产生下载
使用他们的元数据。此选项暂停这些
后续下载。此选项有效
只有当给出--enable-rpc = true时。
可能的值:true,false
默认值:false
标签:#advanced,#rpc
--min-tls-version = VERSION指定要启用的最低SSL / TLS版本。
可能的值:SSLv3,TLSv1,TLSv1.1,TLSv1.2
默认值:TLSv1
标签:#advanced
--socket-recv-buffer-size = SIZE
以字节为单位设置最大套接字接收缓冲区。
指定0将禁用此选项。这个值
将设置为套接字文件描述符使用
SO_RCVBUF套接字选项与setsockopt()调用。
可能的值:0-16777216
默认值:0
标签:#advanced
--max-mmap-limit = SIZE设置启用mmap的最大文件大小(请参见
--enable-mmap选项)。文件大小为
由包含在中的所有文件的总和确定
一个下载。例如,如果下载
包含5个文件,那么文件大小是总的
这些文件的大小。如果文件大小是严格的
大于此选项中指定的大小,
mmap将被禁用。
可能的值:0- *
默认值:9223372036854775807
标签:#advanced
--stderr [= true | false]重定向将是的所有控制台输出
否则在stdout中打印到stderr。
可能的值:true,false
默认值:false
标签:#advanced
--keep-unfinished-download-result [= true | false]
即使做了,仍保留未完成的下载结果
所以超过--max-download-result。这是有用的
如果所有未完成的下载必须保存
会话文件(请参阅--save-session选项)。请
请记住,没有上限
要保留的未完成下载结果的数量。如果
这是不合需要的,请关闭此选项。
可能的值:true,false
默认值:true
标签:#advanced
--ftp-user = USER设置FTP用户。这会影响所有网址。
标签:#basic,#ftp
--ftp-passwd = PASSWD设置FTP密码。这会影响所有网址。
标签:#basic,#ftp
--ftp-type = TYPE设置FTP传输类型。
可能的值:binary,ascii
默认值:二进制
标签:#ftp
-p,--ftp-pasv [= true | false]在FTP中使用被动模式。如果给出false,
将使用活动模式。
可能的值:true,false
默认值:true
标签:#ftp
--ftp-reuse-connection [= true | false]在FTP中重复使用连接。
可能的值:true,false
默认值:true
标签:#ftp
--ssh-host-key-md = TYPE = DIGEST
设置SSH主机公钥的校验和。TYPE是
哈希类型。支持的哈希类型为sha-1或
md5。DIGEST是十六进制摘要。例如:
sha-1 = b030503d4de4539dc7885e6f0f5e256704edf4c3
此选项可用于验证服务器的
公钥。如果此选项为
未设置,这是默认值,不进行验证
地点。
可能值:HASH_TYPE = HEX_DIGEST
标签:#ftp
--http-user = USER设置HTTP用户。这会影响所有网址。
标签:#basic,#http
--http-passwd = PASSWD设置HTTP密码。这会影响所有网址。
标签:#basic,#http
-U,--user-agent = USER_AGENT设置http下载的用户代理。
默认值:aria2 / 1.31.0
标签:#http
--load-cookies = FILE使用Firefox3格式从FILE加载Cookie
和Mozilla / Firefox(1.x / 2.x)/ Netscape格式。
可能的值:/ path / to / file
标签:#basic,#http,#cookie
--save-cookies = FILE将Cookie保存到Mozilla / Firefox(1.x / 2.x)/
Netscape格式。如果FILE已存在,则为
覆盖。会话Cookie也会保存和
它们的到期值被视为0。
可能的值:/ path / to / file
标签:#http,#cookie
--enable-http-keep-alive [= true | false]启用HTTP / 1.1持久连接。
可能的值:true,false
默认值:true
标签:#http
--enable-http-pipelining [= true | false]启用HTTP / 1.1流水线。
可能的值:true,false
默认值:false
标签:#http
--header = HEADER将HEADER附加到HTTP请求标头。您可以使用
这个选项重复指定多个
标题:
aria2c --header =“XA:b78”--header =“XB:9J1”
http:// host / file
标签:#http
--certificate = FILE在FILE中使用客户端证书。
证书必须为PEM格式。
您可以使用--private-key选项指定
私钥。
可能的值:/ path / to / file
标签:#http,#https
--private-key = FILE在FILE中使用私钥。
私钥必须在PEM中解密
格式。另请参见--certificate选项。
可能的值:/ path / to / file
标签:#http,#https
--ca-certificate = FILE使用FILE中的证书颁发机构进行验证
对等体。证书文件必须在PEM中
格式,并且可以包含多个CA证书。
使用--check-certificate选项启用
验证。
可能的值:/ path / to / file
标签:#http,#https
--check-certificate [= true | false]使用指定的证书验证对等体
在-ca-certificate选项。
可能的值:true,false
默认值:true
标签:#http,#https
--use-head [= true | false]对HTTP的第一个请求使用HEAD方法
服务器。
可能的值:true,false
默认值:false
标签:#http
--http-auth-challenge [= true | false]只有在发送HTTP授权头时才会发送
由服务器请求。如果设置为false,则
授权头总是发送到服务器。
有一个例外:如果用户名和密码
嵌入在URI中,授权头是
总是发送到服务器,不管这是什么
选项。
可能的值:true,false
默认值:false
标签:#http
--http-no-cache [= true | false]发送缓存控制:no-cache和Pragma:no-cache
标题以避免缓存的内容。如果false是
给定,这些头不发送,你可以添加
缓存控制头与你喜欢的指令
使用--header选项。
可能的值:true,false
默认值:false
标签:#http
--http-accept-gzip [= true | false]发送“Accept:deflate,gzip”请求头
如果远程服务器响应,则充气响应
与“Content-Encoding:gzip”或
'Content-Encoding:deflate'。
可能的值:true,false
默认值:false
标签:#http
--content-disposition-default-utf8 [= true | false]处理引用的字符串
Content-Disposition标题为UTF-8而不是
ISO-8859-1,例如,filename参数,
但不是扩展版本文件名*。
可能的值:true,false
默认值:false
标签:#advanced,#http
--http-proxy = PROXY对HTTP使用代理服务器。要覆盖
先前定义的代理,使用“”。
另请参见--all-proxy选项。
这会影响所有http下载。
可能的值:[http://] [USER:PASSWORD @] HOST [:PORT]
标签:#http
--https-proxy = PROXY对HTTPS使用代理服务器。要覆盖
先前定义的代理,使用“”。
另请参见--all-proxy选项。
这会影响所有https下载。
可能的值:[http://] [USER:PASSWORD @] HOST [:PORT]
标签:#http,#https
--ftp-proxy = PROXY对FTP使用代理服务器。要覆盖
先前定义的代理,使用“”。
另请参见--all-proxy选项。
这会影响所有ftp下载。
可能的值:[http://] [USER:PASSWORD @] HOST [:PORT]
标签:#ftp
--all-proxy = PROXY对所有协议使用代理服务器。覆盖
先前定义的代理,使用“”。
您还可以覆盖此设置并指定a
代理服务器为使用的特定协议
--http-proxy,--https-proxy和--ftp-proxy
选项。
这会影响所有下载。
可能的值:[http://] [USER:PASSWORD @] HOST [:PORT]
标签:#http,#https,#ftp
--no-proxy = DOMAINS指定逗号分隔的主机名,域或
网络地址有或没有CIDR块在哪里
代理不应该使用。
可能的值:HOSTNAME,DOMAIN,NETWORK / CIDR
标签:#http,#https,#ftp
--proxy-method = METHOD设置在代理请求中使用的方法。
可能的值:get,tunnel
默认值:get
标签:#http,#ftp
--http-proxy-user = USER为--http-proxy设置用户。
标签:#http
--http-proxy-passwd = PASSWD设置--http-proxy的密码。
标签:#http
--https-proxy-user = USER设置--https-proxy的用户。
标签:#http,#https
--https-proxy-passwd = PASSWD设置--https-proxy的密码。
标签:#http,#https
--ftp-proxy-user = USER为--ftp-proxy设置用户。
标签:#ftp
--ftp-proxy-passwd = PASSWD设置--ftp-proxy的密码。
标签:#ftp
--all-proxy-user = USER为--all-proxy设置用户。
标签:#http,#https,#ftp
--all-proxy-passwd = PASSWD设置--all-proxy的密码。
标签:#http,#https,#ftp
-S,--show-files [= true | false]打印文件列表.torrent,.meta4和
.metalink文件并退出。更详细
信息将列出的情况下的洪流
文件。
可能的值:true,false
默认值:false
标签:#basic,#metalink,#bittorrent
--max-overall-upload-limit = SPEED设置最大总上传速度(以字节/秒为单位)。
0表示无限制。
您可以追加K或M(1K = 1024,1M = 1024K)。
要限制每个torrent的上传速度,请使用
--max-upload-limit选项。
可能的值:0- *
默认值:0
标签:#basic,#bittorrent
-u,--max-upload-limit = SPEED设置每个torrent的最大上传速度
字节/秒。0表示无限制。
您可以追加K或M(1K = 1024,1M = 1024K)。
要限制总体上传速度,请使用
--max-overall-upload-limit选项。
可能的值:0- *
默认值:0
标签:#basic,#bittorrent
-T, - torrent-file = TORRENT_FILE .torrent文件的路径。
可能的值:/ path / to / file
标签:#basic,#bittorrent
--listen-port = PORT ...为BitTorrent下载设置TCP端口号。
可以使用','指定多个端口,
例如:“6881,6885”。你也可以使用' - '
以指定范围:“6881-6999”。','和' - '可以
一起使用。
可能的值:1024-65535
默认值:6881-6999
标签:#basic,#bittorrent
--follow-torrent = true | false | mem如果指定了true或mem,当一个文件
其后缀为.torrent或内容类型为
应用程序/ x-bittorrent下载,aria2
将其解析为torrent文件并下载文件
提到它。
如果指定了mem,则不是torrent文件
写入磁盘,但只是保存在内存中。
如果指定false,则.torrent文件为
下载到磁盘,但不解析为
torrent及其内容没有下载。
可能的值:true,mem,false
默认值:true
标签:#bittorrent
--select-file = INDEX ...通过指定其索引来设置要下载的文件。
您可以使用查找文件索引
--show-files选项。多个索引可以
通过使用','指定,例如:“3,6”。
您也可以使用“ - ”指定范围:“1-5”。
','和' - '可以一起使用。
与-M选项一起使用时,索引可能不同
这取决于查询(参见--metalink- *选项)。
可能的值:1-1048576
标签:#metalink,#bittorrent
--seed-time = MINUTES以(分数)分钟指定播种时间。
另请参见--seed-ratio选项。
可能的值:0.0- *
标签:#bittorrent
--seed-ratio = RATIO指定份额比率。种子完成种子
直至份额达到RATIO。
强烈建议您指定equals或
超过1.0这里。如果您打算指定0.0
无论股份比例如何。
如果同时指定了--seed-time选项
这个选项,播种结束时至少有一个
满足条件。
可能的值:0.0- *
默认值:1.0
标签:#bittorrent
--peer-id-prefix = PEER_ID_PREFIX指定对等体ID的前缀。中的对等ID
BitTorrent是20字节长度。如果超过20
字节,只有前20个字节
用过的。如果指定小于20字节,则为随机
字节数据被添加以使其长度为20字节。
默认值:A2-1-31-0-
标签:#bittorrent
--enable-peer-exchange [= true | false]启用对等交换扩展。
可能的值:true,false
默认值:true
标签:#bittorrent
--enable-dht [= true | false]启用IPv4 DHT功能。它也使能
UDP跟踪器支持。如果设置了专用标志
在洪流中,aria2不使用DHT
下载即使给出了``true``。
可能的值:true,false
默认值:true
标签:#basic,#bittorrent
--dht-listen-port = PORT ...设置DHT使用的UDP侦听端口(IPv4,IPv6)
和UDP跟踪。可以指定多个端口
通过使用',',例如:“6881,6885”。您可以
还可以使用“ - ”指定范围:“6881-6999”。
','和' - '可以一起使用。
可能的值:1024-65535
默认值:6881-6999
标签:#basic,#bittorrent
--dht-entry-point = HOST:PORT将主机和端口设置为IPv4 DHT的入口点
网络。
可能的值:HOST:PORT
标签:#bittorrent
--dht-file-path = PATH将IPv4 DHT路由表文件更改为PATH。
可能的值:/ path / to / file
默认值:C:/Users/Administrator/.aria2/dht.dat
标签:#bittorrent
--enable-dht6 [= true | false]启用IPv6 DHT功能。
使用--dht-listen-port选项指定端口
要听的号码。请参阅--dht-listen-addr6
选项。
可能的值:true,false
默认值:false
标签:#basic,#bittorrent
--dht-listen-addr6 = ADDR指定IPv6 DHT套接字的地址。
它应该是一个全球单播IPv6地址
主办。
标签:#basic,#bittorrent
--dht-entry-point6 = HOST:PORT将主机和端口设置为IPv6 DHT的入口点
网络。
可能的值:HOST:PORT
标签:#bittorrent
--dht-file-path6 = PATH将IPv6 DHT路由表文件更改为PATH。
可能的值:/ path / to / file
默认值:C:/Users/Administrator/.cache/aria2/dht6.dat
标签:#bittorrent
--bt-min-crypto-level = plain | arc4设置加密方法的最低级别。
如果几个加密方法由a提供
peer,aria2选择满足的最低的一个
给定级别。
可能的值:plain,arc4
默认值:plain
标签:#bittorrent
--bt-require-crypto [= true | false]如果给出true,aria2不接受和
建立与传统BitTorrent的连接
握手。因此aria2总是使用混淆
握手。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-request-peer-speed-limit = SPEED如果整个下载速度为每个
torrent暂时低于SPEED,aria2
增加对等体的数量尝试更多
下载速度。用您的配置此选项
首选下载速度可以增加你的
下载速度在某些情况下。
您可以追加K或M(1K = 1024,1M = 1024K)。
可能的值:0- *
默认值:50K
标签:#bittorrent
--bt-max-open-files = NUM指定要打开的最大文件数
多文件BitTorrent / Metalink下载
全球。
可能的值:1- *
默认值:100
标签:#bittorrent
--bt-seed-unverified [= true | false]种子以前下载的文件没有
验证散列。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-hash-check-seed [= true | false]如果给出true,则在使用hash检查之后
--check-integrity选项和文件完成后,
继续种子文件。如果要检查文件
并下载它只有当它被损坏或
incomplete,请将此选项设置为false。
此选项仅对BitTorrent有效
下载。
可能的值:true,false
默认值:true
标签:#bittorrent,#checksum
--bt-max-peers = NUM指定每个torrent的最大对等体数。
0表示无限。
另请参见--bt-request-peer-speed-limit选项。
可能的值:0- *
默认:55
标签:#bittorrent
--bt-external-ip = IPADDRESS指定要使用的外部IP地址
BitTorrent下载和DHT。它可能被发送到
BitTorrent跟踪。对于DHT,这个选项应该
设置为报告本地节点正在下载
一个特定的洪流。这是使用的关键
DHT在私有网络中。虽然这个功能
被命名为“外部”,它可以接受任何种类的IP
地址。
可能的值:数字IP地址
标签:#bittorrent
-O,--index-out = INDEX = PATH设置索引= INDEX的文件的文件路径。您可以
使用--show-files选项查找文件索引。
PATH是指定的路径的相对路径
--dir选项。您可以使用此选项multiple
次。
可能的值:INDEX = PATH
标签:#bittorrent
--bt-tracker-interval = SEC设置跟踪器之间的间隔(以秒为单位)
要求。这完全覆盖间隔值
和aria2只是使用这个值并忽略
min间隔和间隔值在响应中
跟踪器。如果设置为0,aria2确定间隔
基于跟踪器和下载的响应
进展。
可能的值:0- *
默认值:0
标签:#bittorrent
--bt-stop-timeout = SEC如果下载速度为0,则停止BitTorrent下载
连续SEC秒。如果给出0,这
功能被禁用。
可能的值:0- *
默认值:0
标签:#bittorrent
--bt-prioritize-piece = head [= SIZE],tail [= SIZE]尝试首先和最后下载
每个文件的片段。这是有用的
预览文件。参数可以包含2
关键词:头尾。要包含这两个关键字,
它们必须用逗号分隔。这些关键字
可以取一个参数,SIZE。例如,if
head = SIZE,指定的范围内
每个文件的第一个SIZE字节获得更高的优先级。
tail = SIZE表示最后SIZE个字节的范围
每个文件。SIZE可以包括K或M(1K = 1024,1M =
1024K)。如果省略SIZE,则使用SIZE = 1M。
可能的值:head [= SIZE],tail [= SIZE]
标签:#bittorrent
--bt-save-metadata [= true | false]将元数据保存为.torrent文件。此选项具有
效果只有当使用BitTorrent Magnet URI时。
文件名是带有后缀的十六进制编码信息散列
。激流。要保存的目录是相同的
保存下载文件的目录。如果
同一文件已存在,元数据不保存。
另请参见--bt-metadata-only选项。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-metadata-only [= true | false]仅下载元数据。描述的文件
将不会下载元数据。此选项
只有当BitTorrent磁铁URI是有效果
用过的。另请参阅--bt-save-metadata选项。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-enable-lpd [= true | false]启用本地对等体发现。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-lpd-interface = INTERFACE将给定接口用于本地对等体发现。如果
这个选项没有指定,默认
接口。可以指定接口
名称和IP地址。
可能的值:接口,IP地址
标签:#bittorrent
--bt-tracker-timeout = SEC设置超时(以秒为单位)。
可能的值:1-600
默认值:60
标签:#bittorrent
--bt-tracker-connect-timeout = SEC将连接超时设置为秒
建立与跟踪器的连接。之后
连接建立,此选项使no
效果和--bt-tracker-timeout选项
代替。
可能的值:1-600
默认值:60
标签:#bittorrent
--dht-message-timeout = SEC设置超时(以秒为单位)。
可能的值:1-60
默认值:10
标签:#bittorrent
--on-bt-download-complete = COMMAND对于BitTorrent,在中指定的命令
--on-download-complete在下载后调用
完成和播种结束。另一方面,
此选项设置要在其后执行的命令
下载完成,但种子之前。
请参见--on-download-start选项
要求COMMAND。
可能的值:/ path / to / command
标签:#advanced,#hook
--bt-tracker = URI [,...]逗号分隔的额外的BitTorrent列表
跟踪器的公告URI。这些URI不是
受到--bt-exclude-tracker选项的影响,因为
它们在-bt-exclude-tracker中的URI之后添加
选项。
可能的值:URI,...
标签:#bittorrent
--bt-exclude-tracker = URI [,...] BitTorrent跟踪器的逗号分隔列表
宣布要删除的URI。您可以使用特殊值
'*'匹配所有URI,从而删除所有
宣布URI。在shell中指定'*'时
命令行,不要忘记逃跑或引用它。
参见--bt-tracker选项。
可能的值:URI,...或*
标签:#bittorrent
--bt-remove-unselected-file [= true | false]在何时删除未选择的文件
下载完成在BitTorrent。至
选择文件,使用--select-file选项。如果
它不被使用,所有文件都被假定为
选择。请谨慎使用此选项
因为它实际上会从中删除文件
您的磁盘。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-detach-seed-only [= true | false]
排除种子仅在计数时下载
并发活动下载(请参阅-j选项)。
这意味着如果给出-j3和此选项
已打开,3个下载活动,一个
的那些进入种子模式,则其被排除
从活动下载计数(因此它变为2),
并且下一次下载等待在队列中获取
开始。但请注意,播种项目是静止的
在RPC方法中被识别为活动下载。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-force-encryption [= true | false]
需要BitTorrent消息有效载荷加密
与arc4。这是一个简写
--bt-require-crypto --bt-min-crypto-level = arc4。
如果给出true,则拒绝传统BitTorrent
握手和只使用混淆握手和
总是加密消息有效负载。
可能的值:true,false
默认值:false
标签:#bittorrent
--bt-enable-hook-after-hash-check [= true | false]允许挂接命令调用
后的哈希检查(参见-V选项)在BitTorrent
下载。默认情况下,当哈希检查成功时,
命令由--on-bt-download-complete给出
被执行。要禁用此操作,请给出false
到这个选项。
可能的值:true,false
默认值:true
标签:#bittorrent
-M,--metalink-file = METALINK_FILE .meta4和.metalink的文件路径
文件。当' - '是时从stdin读取输入
指定。
可能的值:/ path / to / file, -
标签:#basic,#metalink
--metalink-version = VERSION要下载的文件的版本。
标签:#metalink
--metalink-language = LANGUAGE要下载的文件的语言。
标签:#metalink
--metalink-os = OS要下载的文件的操作系统。
标签:#metalink
--metalink-location = LOCATION [,...]首选服务器的位置。
逗号分隔的位置列表为
可接受。
标签:#metalink
--follow-metalink = true | false | mem如果指定了true或mem,当一个文件
其后缀为.meta4或.metalink或内容
应用程序类型/ metalink4 + xml或
应用程序/ metalink + xml下载,aria2
将其解析为metalink文件并下载文件
提到它。
如果指定了mem,则不是一个metalink文件
写入磁盘,但只是保存在内存中。
如果指定为false,则.metalink文件为
下载到磁盘,但不解析为
metalink文件及其内容不是
下载。
可能的值:true,mem,false
默认值:true
标签:#metalink
--metalink-preferred-protocol = PROTO指定首选协议。指定'none'
如果你没有任何首选协议。
可能的值:http,https,ftp,none
默认值:无
标签:#metalink
--metalink-enable-unique-protocol [= true | false]如果为true,则为true
协议可用于metalink中的镜像
文件,aria2使用其中之一。
使用--metalink-preferred-protocol选项
指定协议的首选项。
可能的值:true,false
默认值:true
标签:#metalink
--metalink-base-uri = URI指定用于解析相对URI的基本URI
metalink:url和metalink:metaurl中的元素
metalink文件存储在本地磁盘中。如果URI指向
到目录,URI必须以“/”结尾。
标签:#metalink
有关详细信息,请参阅手册页。