mirror of https://github.com/aria2/aria2
fixed some bugs
ITriskTI
parent
003aaf4a09
commit
3c5753baf2
|
|
@ -30,7 +30,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
Загрузить URI, найденные в файле FILE. Вы можете указать несколько URI для одного
|
||||
объекта: разделяйте URI в строке, используя символ TAB (табуляция). Когда
|
||||
указано ``-`` , ввод считывается из stdin (стандартный поток ввода). Дополнительные
|
||||
указано ``-``, ввод считывается из stdin (стандартный поток ввода). Дополнительные
|
||||
параметры можно указывать после каждой строки с URI. Эта необязательная строка
|
||||
должна начинаться с одного или нескольких пробелов и содержать один параметр.
|
||||
Смотрите подраздел `Входной файл`_ для детальных пояснений.
|
||||
|
|
@ -38,7 +38,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: -l, --log=<LOG>
|
||||
|
||||
Имя файла для журнала событий. Если указан ``-`` , то журнал событий будет
|
||||
Имя файла для журнала событий. Если указан ``-``, то журнал событий будет
|
||||
записан в stdout (стандартный поток вывода). Если указана пустая
|
||||
строка (""), то журнал событий не будет записан в файл.
|
||||
|
||||
|
|
@ -77,10 +77,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
с ``#``. Например, ``--help=#http`` даст справку по параметрам,
|
||||
помеченным меткой ``#http``. Если задано слово (KEYWORD), не
|
||||
являющееся меткой, то будет выведена справка по параметрам,
|
||||
содержащих это слово. Возможные значения: ``#basic`` , ``#advanced`` ,
|
||||
``#http`` , ``#https`` , ``#ftp`` , ``#metalink`` , ``#bittorrent`` , ``#cookie`` ,
|
||||
``#hook`` , ``#file`` , ``#rpc`` , ``#checksum`` , ``#experimental`` ,
|
||||
``#deprecated`` , ``#help`` , ``#all``.
|
||||
содержащих это слово. Возможные значения: ``#basic``, ``#advanced``,
|
||||
``#http``, ``#https``, ``#ftp``, ``#metalink``, ``#bittorrent``, ``#cookie``,
|
||||
``#hook``, ``#file``, ``#rpc``, ``#checksum``, ``#experimental``,
|
||||
``#deprecated``, ``#help``, ``#all``.
|
||||
По умолчанию: ``#basic``
|
||||
|
||||
Параметры HTTP/FTP
|
||||
|
|
@ -143,7 +143,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --dry-run[=true|false]
|
||||
|
||||
Если задано ``true`` , aria2 только проверяет, является ли удаленный
|
||||
Если задано ``true``, aria2 только проверяет, является ли удаленный
|
||||
файл доступным и не загружает данные. Этот параметр влияет на
|
||||
HTTP/FTP-загрузку. BitTorrent-загрузки отменяются, если указано
|
||||
``true``.
|
||||
|
|
@ -168,7 +168,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
Если aria2 получает статус "file not found" (файл не найден) с
|
||||
удаленных HTTP/FTP-серверов NUM раз без получения, хотя бы одного байта,
|
||||
тогда принудительно отказывается от загрузки. Укажите ``0`` , чтобы
|
||||
тогда принудительно отказывается от загрузки. Укажите ``0``, чтобы
|
||||
отключить этот параметр. Этот параметр действенен только, когда
|
||||
используются HTTP/FTP-серверы.
|
||||
По умолчанию: ``0``
|
||||
|
|
@ -199,9 +199,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. note::
|
||||
|
||||
Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при загрузке, то netrc недоступен на
|
||||
протяжении всей сессии. Вы не сможете получить доступ к netrc, даже если
|
||||
отправите :option:`--no-netrc=false, <-n>` используя
|
||||
Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан
|
||||
как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при
|
||||
загрузке, то netrc недоступен на протяжении всей сессии. Вы не сможете получить
|
||||
доступ к netrc, даже если отправите :option:`--no-netrc=false, <-n>` используя
|
||||
:func:`aria2.changeGlobalOption`.
|
||||
|
||||
.. option:: --no-proxy=<DOMAINS>
|
||||
|
|
@ -237,7 +238,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --proxy-method=<METHOD>
|
||||
|
||||
Задать метод для использования в прокси-запросах. METHOD один
|
||||
из двух: ``get`` или ``tunnel``. HTTPS-загрузки всегда используют ``tunnel`` ,
|
||||
из двух: ``get`` или ``tunnel``. HTTPS-загрузки всегда используют ``tunnel``,
|
||||
не обращая внимания на этот параметр.
|
||||
По умолчанию: ``get``
|
||||
|
||||
|
|
@ -306,10 +307,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
Указать алгоритм выбора блока, который используется в HTTP/FTP-загрузке.
|
||||
Блок - означает сегмент фиксированной длины, который загружается
|
||||
параллельно, в разделенной на части, загрузке. Если задано ``default`` ,
|
||||
параллельно, в разделенной на части, загрузке. Если задано ``default``,
|
||||
то aria2 выберет блок так, чтобы это уменьшило количество установленных
|
||||
подключений. Это разумное поведение по умолчанию, поскольку установка
|
||||
подключения очень затратная операция. Если задано ``inorder`` , то aria2
|
||||
подключения очень затратная операция. Если задано ``inorder``, то aria2
|
||||
выберет блок, который имеет минимальный индекс. Index=0 означает первый
|
||||
из файла. Это будет полезно при просмотре фильма, в то время как он
|
||||
загружается. Параметр
|
||||
|
|
@ -319,8 +320,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
:option:`--min-split-size <-k>`, так что необходимо
|
||||
будет указать разумное значение параметра
|
||||
:option:`--min-split-size <-k>`.
|
||||
Если задано ``geom`` , то aria2 вначале выберет блок с минимальным
|
||||
индексом, как при ``inorder`` , однако она сохранит
|
||||
Если задано ``geom``, то aria2 вначале выберет блок с минимальным
|
||||
индексом, как при ``inorder``, однако она сохранит
|
||||
экспоненциально большую область от ранее выбранного блока.
|
||||
Это уменьшит количество установленных подключений и в то же
|
||||
время это позволит в первую очередь загрузить начало файла.
|
||||
|
|
@ -335,20 +336,20 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --uri-selector=<SELECTOR>
|
||||
|
||||
Указать алгоритм выбора URI. Возможные значения: ``inorder`` , ``feedback``
|
||||
и ``adaptive``. Если задано ``inorder`` , то URI проверяются в порядке
|
||||
представления в списке URI. Если задано ``feedback`` , aria2 использует
|
||||
Указать алгоритм выбора URI. Возможные значения: ``inorder``, ``feedback``
|
||||
и ``adaptive``. Если задано ``inorder``, то URI проверяются в порядке
|
||||
представления в списке URI. Если задано ``feedback``, aria2 использует
|
||||
скорость загрузки, которая наблюдалась в предыдущих загрузках, и выбирает
|
||||
самый быстрый сервер в списке URI. Это также эффективно исключает мертвые
|
||||
зеркала. Наблюдаемая скорость загрузки является частью профиля
|
||||
функционирования сервера, упомянутой в параметрах
|
||||
:option:`--server-stat-of` и
|
||||
:option:`--server-stat-if`. Если задано ``adaptive`` ,
|
||||
:option:`--server-stat-if`. Если задано ``adaptive``,
|
||||
выбирается одно из лучших зеркал для первого и резервного соединений.
|
||||
Дополнительно, возвращаются зеркала, которые пока не были проверены, и,
|
||||
если каждое из них уже проверено, возвращаются зеркала, которые должны
|
||||
быть проверены снова. Иначе зеркала больше не выбираются.
|
||||
Подобно ``feedback`` , используются профиль функционирования сервера.
|
||||
Подобно ``feedback``, используются профиль функционирования сервера.
|
||||
По умолчанию: ``feedback``
|
||||
|
||||
Специфические параметры HTTP
|
||||
|
|
@ -390,7 +391,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --http-auth-challenge[=true|false]
|
||||
|
||||
Отправлять заголовок HTTP-авторизации только тогда, когда он запрошен
|
||||
с сервера. Если задано ``false`` , тогда заголовок авторизации всегда
|
||||
с сервера. Если задано ``false``, тогда заголовок авторизации всегда
|
||||
отправляется на сервер. Существует исключение: если имя пользователя
|
||||
и пароль являются встроенными в URI, то заголовок авторизации всегда
|
||||
отправляется на сервер, независимо от этого параметра.
|
||||
|
|
@ -399,7 +400,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --http-no-cache[=true|false]
|
||||
|
||||
Отправлять заголовок Cache-Control: no-cache и Pragma: no-cache,
|
||||
чтобы избежать кэширования содержимого. Если задано ``false`` , то эти
|
||||
чтобы избежать кэширования содержимого. Если задано ``false``, то эти
|
||||
заголовки не посылаются, и вы можете добавить любую директиву к
|
||||
заголовку Cache-Control с помощью параметра
|
||||
:option:`--header`.
|
||||
|
|
@ -504,7 +505,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: -U, --user-agent=<USER_AGENT>
|
||||
|
||||
Задать клиентское приложение для HTTP(S)-загрузок.
|
||||
По умолчанию: ``aria2/$VERSION`` , $VERSION заменяется на версию пакета.
|
||||
По умолчанию: ``aria2/$VERSION``, $VERSION заменяется на версию пакета.
|
||||
|
||||
Специфические параметры FTP
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
|
@ -524,7 +525,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: -p, --ftp-pasv[=true|false]
|
||||
|
||||
Использовать пассивный режим FTP. Если задано ``false`` ,
|
||||
Использовать пассивный режим FTP. Если задано ``false``,
|
||||
то будет использован активный режим.
|
||||
По умолчанию: ``true``
|
||||
|
||||
|
|
@ -607,7 +608,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --bt-hash-check-seed[=true|false]
|
||||
|
||||
Если задано ``true`` , то после проверки хэша с использованием параметра
|
||||
Если задано ``true``, то после проверки хэша с использованием параметра
|
||||
:option:`--check-integrity <-V>`, и когда файл
|
||||
загружен полностью, продолжается раздача файла. Если вы хотите
|
||||
проверить файл и загрузить его только если он поврежден или не загружен
|
||||
|
|
@ -675,7 +676,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --bt-require-crypto[=true|false]
|
||||
|
||||
Если задано ``true`` , aria2 не принимает и не устанавливает соединение с
|
||||
Если задано ``true``, aria2 не принимает и не устанавливает соединение с
|
||||
унаследованным BitTorrent handshake-сообщением (рукопожатие)
|
||||
(BitTorrent протокол). Таким образом, aria2 всегда использует обфускацию
|
||||
handshake-сообщения.
|
||||
|
|
@ -709,7 +710,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --bt-stop-timeout=<SEC>
|
||||
|
||||
Остановить BitTorrent загрузку, если скорость загрузки равна 0 на
|
||||
протяжении SEC секунд. Если задано ``0`` , то эта возможность не будет
|
||||
протяжении SEC секунд. Если задано ``0``, то эта возможность не будет
|
||||
использоваться.
|
||||
По умолчанию: ``0``
|
||||
|
||||
|
|
@ -735,7 +736,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
Задать интервал в секундах между запросами трекера. Это полностью
|
||||
отменяет значение интервала и aria2 использует только это значение
|
||||
и игнорирует минимальный интервал и значение интервала в ответе
|
||||
трекера. Если задан ``0`` , aria2 определяет интервал, основываясь на
|
||||
трекера. Если задан ``0``, aria2 определяет интервал, основываясь на
|
||||
ответе трекера и прогрессе загрузки.
|
||||
По умолчанию: ``0``
|
||||
|
||||
|
|
@ -809,11 +810,11 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --follow-torrent=true|false|mem
|
||||
|
||||
Если указать ``true`` или ``mem`` , тогда загруженный файл, расширение
|
||||
Если указать ``true`` или ``mem``, тогда загруженный файл, расширение
|
||||
которого - ``.torrent`` или mime-тип - ``application/x-bittorrent``,
|
||||
aria2 анализирует как torrent-файл и загружает файлы, указанные в нем.
|
||||
Если указано ``mem`` , тогда torrent-файл не записывается на диск,
|
||||
а содержится в памяти. Если указано ``false`` , действия, упомянутые
|
||||
Если указано ``mem``, тогда torrent-файл не записывается на диск,
|
||||
а содержится в памяти. Если указано ``false``, действия, упомянутые
|
||||
выше, не совершаются.
|
||||
По умолчанию: ``true``
|
||||
|
||||
|
|
@ -863,13 +864,13 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
то только первые 20 будут использоваться, если будет
|
||||
указано меньше 20, то они будут дополнены случайными
|
||||
данными до 20 байт.
|
||||
По умолчанию: ``aria2/$VERSION`` , $VERSION заменяется на версию пакета.
|
||||
По умолчанию: ``aria2/$VERSION``, $VERSION заменяется на версию пакета.
|
||||
|
||||
.. option:: --seed-ratio=<RATIO>
|
||||
|
||||
Указать рейтинг. Сидировать завершенные торренты, пока рейтинг
|
||||
не станет больше RATIO. Очень рекомендуется указать тут равный
|
||||
или больший ``1.0``. Указать ``0.0`` , если вы планируете сидировать
|
||||
или больший ``1.0``. Указать ``0.0``, если вы планируете сидировать
|
||||
независимо от рейтинга. Если указан параметр
|
||||
:option:`--seed-time` вместе с этим
|
||||
параметром, сидирование закончится тогда, когда хотя бы одно
|
||||
|
|
@ -898,8 +899,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
Если указано ``true`` или ``mem`` и когда загруженный файл имеет расширение
|
||||
``.meta4`` или ``.metalink``, или mime-тип ``application/metalink4+xml``
|
||||
или ``application/metalink+xml``, aria2 считает его metalink-файлом и
|
||||
загружает упомянутые в нем файлы. Если указано ``mem`` , то metalink-файл
|
||||
не сохраняется на диск, а просто хранится в памяти. Если указано ``false`` ,
|
||||
загружает упомянутые в нем файлы. Если указано ``mem``, то metalink-файл
|
||||
не сохраняется на диск, а просто хранится в памяти. Если указано ``false``,
|
||||
то вышеприведенная операция не производится.
|
||||
По умолчанию: ``true``
|
||||
|
||||
|
|
@ -935,13 +936,13 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --metalink-preferred-protocol=<PROTO>
|
||||
|
||||
Указать предпочитаемый протокол. Возможные значения: ``http`` , ``https`` , ``ftp``
|
||||
Указать предпочитаемый протокол. Возможные значения: ``http``, ``https``, ``ftp``
|
||||
и ``none``. Указать ``none`` для отключения этой возможности.
|
||||
По умолчанию: ``none``
|
||||
|
||||
.. option:: --metalink-enable-unique-protocol[=true|false]
|
||||
|
||||
Если задано ``true`` , а в metalink-файле доступно несколько
|
||||
Если задано ``true``, а в metalink-файле доступно несколько
|
||||
протоколов, то aria2 использует один из них. Используйте параметр
|
||||
:option:`--metalink-preferred-protocol`,
|
||||
чтобы указать предпочитаемый протокол.
|
||||
|
|
@ -973,7 +974,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --rpc-listen-all[=true|false]
|
||||
|
||||
Слушать входящие JSON-RPC/XML-RPC-запросы на всех сетевых интерфейсах.
|
||||
Если указано ``false`` , слушать только на локальном петлевом
|
||||
Если указано ``false``, слушать только на локальном петлевом
|
||||
интерфейсе (loopback).
|
||||
По умолчанию: ``false``
|
||||
|
||||
|
|
@ -1009,21 +1010,20 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --allow-piece-length-change[=true|false]
|
||||
|
||||
Если задано ``false`` , aria2 прерывает загрузку, когда длина блока
|
||||
Если задано ``false``, aria2 прерывает загрузку, когда длина блока
|
||||
отлична от той, которая находится в контрольном файле. Если задано
|
||||
``true`` , вы можете продолжать, однако некоторый прогресс загрузки
|
||||
``true``, вы можете продолжать, однако некоторый прогресс загрузки
|
||||
будет потерян.
|
||||
По умолчанию: ``false``
|
||||
|
||||
.. option:: --always-resume[=true|false]
|
||||
|
||||
Всегда возобновлять загрузку. Если задано ``true`` , aria2 всегда пытается
|
||||
Всегда возобновлять загрузку. Если задано ``true``, aria2 всегда пытается
|
||||
возобновить загрузку и если это не возможно, прерывает ее.
|
||||
Если задано ``false`` , тогда для всех заданных URI не поддерживается
|
||||
Если задано ``false``, тогда для всех заданных URI не поддерживается
|
||||
возобновление загрузки, или aria2 столкнется с невозможностью
|
||||
возобновления загрузки URI ``N`` -ое количество раз
|
||||
(значение ``N`` указывается в параметре
|
||||
|
||||
возобновления загрузки URI ``N``-ое количество раз
|
||||
(значение ``N`` указывается в параметре :option:`--max-resume-failure-tries`,
|
||||
то aria2 будет загружать файл с нуля. Смотрите параметр
|
||||
:option:`--max-resume-failure-tries`.
|
||||
По умолчанию: ``true``
|
||||
|
|
@ -1053,7 +1053,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --auto-save-interval=<SEC>
|
||||
|
||||
Сохранять контрольный файл (\*.aria2) каждые SEC секунд.
|
||||
Если задано ``0`` , тогда контрольный файл не сохраняется на
|
||||
Если задано ``0``, тогда контрольный файл не сохраняется на
|
||||
протяжении загрузки. aria2 сохраняет контрольный файл тогда,
|
||||
когда останавливается, не смотря на значение.
|
||||
Возможные значения: от ``0`` до ``600``.
|
||||
|
|
@ -1083,17 +1083,17 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: -D, --daemon[=true|false]
|
||||
|
||||
Запустить как демон (фоновый процесс). Текущий рабочий каталог
|
||||
будет заменен на ``/`` , а стандартный ввод, стандартный вывод,
|
||||
будет заменен на ``/``, а стандартный ввод, стандартный вывод,
|
||||
стандартный вывод ошибок будут перенаправлены на ``/dev/null``.
|
||||
По умолчанию: ``false``
|
||||
|
||||
.. option:: --deferred-input[=true|false]
|
||||
|
||||
Если задано ``true`` , aria2 при запуске не считывает все URI и параметры
|
||||
Если задано ``true``, aria2 при запуске не считывает все URI и параметры
|
||||
из файла, указанного в параметре :option:`--input-file <-i>`, а
|
||||
считывает их позже отдельно, когда это нужно. Это может сократить
|
||||
использование памяти, если во входном файле содержится много URI для
|
||||
загрузки. Если задано ``false`` , aria2 при запуске считывает все URI
|
||||
загрузки. Если задано ``false``, aria2 при запуске считывает все URI
|
||||
и параметры.
|
||||
По умолчанию: ``false``
|
||||
|
||||
|
|
@ -1106,9 +1106,9 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --download-result=<OPT>
|
||||
|
||||
Этот параметр изменяет формат сообщения ``Результаты загрузки``. Если OPT
|
||||
задан как ``default`` , то отображается GID, статус, средняя скорость загрузки и
|
||||
задан как ``default``, то отображается GID, статус, средняя скорость загрузки и
|
||||
путь/URI. Если загружается множество файлов, то отобразиться путь/URI первого
|
||||
запрашиваемого файла, а остальные пропускаются. Если OPT задан как ``full`` ,
|
||||
запрашиваемого файла, а остальные пропускаются. Если OPT задан как ``full``,
|
||||
то отображается GID, статус, средняя скорость загрузки, процент прогресса и
|
||||
путь/URI. Процент прогресса и путь/URI отобразиться для каждого
|
||||
запрашиваемого файла в отдельной строке.
|
||||
|
|
@ -1123,8 +1123,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
.. option:: --event-poll=<POLL>
|
||||
|
||||
Указать метод опроса событий. Возможные значения: ``epoll`` , ``kqueue`` ,
|
||||
``port`` , ``poll`` и ``select``. Каждый метод ``epoll`` , ``kqueue`` , ``port`` и
|
||||
Указать метод опроса событий. Возможные значения: ``epoll``, ``kqueue``,
|
||||
``port``, ``poll`` и ``select``. Каждый метод ``epoll``, ``kqueue``, ``port`` и
|
||||
``poll`` доступен, если система поддерживает его. ``epoll`` доступен в
|
||||
современных дистрибутивах Linux. ``kqueue`` доступен в различных
|
||||
\*BSD-системах, включая Mac OS X. ``port`` доступен в Open Solaris.
|
||||
|
|
@ -1142,17 +1142,17 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
Так как они резервируют место под большие (на несколько Гигабайт) файлы
|
||||
почти мгновенно. Не используйте ``falloc`` вместе с наследными файловыми
|
||||
системами, такими как ext3 и FAT32, потому что это будет продолжаться
|
||||
почти столько же времени, как и ``prealloc`` , а также полностью заблокирует
|
||||
почти столько же времени, как и ``prealloc``, а также полностью заблокирует
|
||||
aria2, пока не закончится резервирование места. ``falloc`` может быть
|
||||
недоступным, если ваша система не содержит функцию :manpage:`posix_fallocate(3)`.
|
||||
Возможные значения: ``none`` , ``prealloc`` , ``falloc``.
|
||||
Возможные значения: ``none``, ``prealloc``, ``falloc``.
|
||||
По умолчанию: ``prealloc``
|
||||
|
||||
.. option:: --hash-check-only[=true|false]
|
||||
|
||||
Если задано ``true`` , то после проверки хэша, используя параметр
|
||||
:option:`--check-integrity <-V>`,
|
||||
загрузка прервётся, в любом случае загрузка завершится.
|
||||
Если задано ``true``, то после проверки хэша, используя параметр
|
||||
:option:`--check-integrity <-V>`, загрузка прервётся, в любом
|
||||
случае загрузка завершится.
|
||||
По умолчанию: ``false``
|
||||
|
||||
.. option:: --human-readable[=true|false]
|
||||
|
|
@ -1172,8 +1172,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
Если интерфейс имеет несколько адресов, то настоятельно рекомендуется
|
||||
указать IP-адрес явно. Смотрите также
|
||||
:option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это параметр не
|
||||
принимает имя интерфейса.
|
||||
:option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это
|
||||
параметр не принимает имя интерфейса.
|
||||
|
||||
.. option:: --max-download-result=<NUM>
|
||||
|
||||
|
|
@ -1191,7 +1191,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
|
||||
Если параметр :option:`--always-resume=false, <--always-resume>` aria2
|
||||
загрузит файл с нуля, при обнаружении ``N`` -го URI, не поддерживающего
|
||||
возобновление. Если ``N`` =``0`` , то aria2 загрузит файл с нуля, когда все
|
||||
возобновление. Если ``N`` =``0``, то aria2 загрузит файл с нуля, когда все
|
||||
URI не поддерживают возобновление. Смотрите параметр
|
||||
:option:`--always-resume`.
|
||||
По умолчанию: ``0``
|
||||
|
|
@ -1199,7 +1199,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --log-level=<LEVEL>
|
||||
|
||||
Задать уровень вывода журнала событий. LEVEL может
|
||||
быть: ``debug`` , ``info`` , ``notice`` , ``warn`` или ``error``.
|
||||
быть: ``debug``, ``info``, ``notice``, ``warn`` или ``error``.
|
||||
По умолчанию: ``debug``
|
||||
|
||||
.. option:: --on-bt-download-complete=<COMMAND>
|
||||
|
|
@ -1348,17 +1348,17 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --save-session=<FILE>
|
||||
|
||||
Сохранять ошибочные/незаконченные загрузки в FILE при выходе. Вы можете
|
||||
передать этот выходной файл aria2c с параметром :option:`--input-file <-i>` при перезапуске. Обратите внимание, что
|
||||
загрузки, добавленные через RPC-методы
|
||||
:func:`aria2.addTorrent`, :func:`aria2.addMetalink`
|
||||
и чьи метаданные не могут быть сохранены как файл, не будут сохраняться.
|
||||
передать этот выходной файл aria2c с параметром :option:`--input-file <-i>` при
|
||||
перезапуске. Обратите внимание, что загрузки, добавленные через RPC-методы
|
||||
:func:`aria2.addTorrent`, :func:`aria2.addMetalink` и чьи метаданные не могут
|
||||
быть сохранены как файл, не будут сохраняться.
|
||||
Загрузки, удаленные с использованием :func:`aria2.remove` и
|
||||
:func:`aria2.forceRemove` не будут сохранены.
|
||||
|
||||
.. option:: --stop=<SEC>
|
||||
|
||||
Останавливать программу после того как пройдет
|
||||
SEC секунд. Если задано ``0`` , эта возможность будет
|
||||
SEC секунд. Если задано ``0``, эта возможность будет
|
||||
отключена.
|
||||
По умолчанию: ``0``
|
||||
|
||||
|
|
@ -1395,18 +1395,18 @@ URI, MAGNET-ССЫЛКА, TORRENT-ФАЙЛ, METALINK-ФАЙЛ
|
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Вы можете перечислить несколько URI в командной строке. Пока вы не указали
|
||||
параметр :option:`--force-sequential <-Z>`, все URI должны указывать
|
||||
на один и тот же файл или загрузка завершиться не удачно.
|
||||
параметр :option:`--force-sequential <-Z>`, все URI должны указывать на один
|
||||
и тот же файл или загрузка завершиться не удачно.
|
||||
|
||||
Вы можете указать произвольное количество BitTorrent Magnet URI. Обратите
|
||||
внимание, что они всегда будут обрабатываться как отдельная
|
||||
загрузка. Поддерживаются оба Info Hash (Информация о хэше), как
|
||||
закодированный 40 шестнадцатеричными символами, так и закодированный 32
|
||||
символами Base32-кодировки. Поддерживаются составные параметры ``tr``. Т.к. в
|
||||
BitTorrent Magnet URI возможно присутствие символа ``&``, то настоятельно
|
||||
рекомендуется всегда заключать URI в одиночные(``'``) или двойные(``"``)
|
||||
кавычки. Так же настоятельно рекомендуется включить DHT, особенно когда
|
||||
параметр ``tr`` не указан. Смотрите
|
||||
символами Base32-кодировки. Поддерживаются составные параметры
|
||||
``tr``. Т.к. в BitTorrent Magnet URI возможно присутствие символа ``&``, то
|
||||
настоятельно рекомендуется всегда заключать URI в одиночные(``'``) или
|
||||
двойные(``"``) кавычки. Так же настоятельно рекомендуется включить DHT,
|
||||
особенно когда параметр ``tr`` не указан. Смотрите
|
||||
http://www.bittorrent.org/beps/bep_0009.html для детальной информации по
|
||||
BitTorrent Magnet URI.
|
||||
|
||||
|
|
@ -1444,12 +1444,12 @@ torrent-файле будет добавлено. Для многофайлов
|
|||
|
||||
aria2 предоставляет параметры, в которых указываются произвольные команды,
|
||||
выполняемые после наступления определенного события. В настоящее время
|
||||
доступны следующие параметры:
|
||||
:option:`--on-bt-download-complete`,
|
||||
:option:`--on-download-pause`,
|
||||
:option:`--on-download-complete`.
|
||||
:option:`--on-download-start`,
|
||||
:option:`--on-download-error`,
|
||||
доступны следующие параметры:
|
||||
:option:`--on-bt-download-complete`,
|
||||
:option:`--on-download-pause`,
|
||||
:option:`--on-download-complete`,
|
||||
:option:`--on-download-start`,
|
||||
:option:`--on-download-error`,
|
||||
:option:`--on-download-stop`.
|
||||
|
||||
aria2 передает 3 аргумента указанной команды, которая выполняется. Это
|
||||
|
|
@ -1458,11 +1458,10 @@ aria2 передает 3 аргумента указанной команды,
|
|||
файлов. Если число файлов больше чем один, то путь к файлу будет для
|
||||
первого. Другими словами, это значение параметра path в первой структуре,
|
||||
определенный параметр которой имеет значение true (истина), в ответе
|
||||
RPC-метода :func:`aria2.getFiles`. Если вы хотите
|
||||
получить все пути к файлам, то рассмотрите использование
|
||||
JSON-RPC/XML-RPC. Обратите внимание, что путь к файлу может меняться в
|
||||
процессе загрузки по HTTP из-за перенаправления или заголовка
|
||||
Content-Disposition.
|
||||
RPC-метода :func:`aria2.getFiles`. Если вы хотите получить все пути к
|
||||
файлам, то рассмотрите использование JSON-RPC/XML-RPC. Обратите внимание,
|
||||
что путь к файлу может меняться в процессе загрузки по HTTP из-за
|
||||
перенаправления или заголовка Content-Disposition.
|
||||
|
||||
Посмотрите пример, как аргументы передаются команде:
|
||||
|
||||
|
|
@ -1639,15 +1638,15 @@ aria2.conf
|
|||
|
||||
По умолчанию, aria2 анализирует ``$HOME/.aria2/aria2.conf`` как
|
||||
конфигурационный файл. Вы можете указать путь к конфигурационному файлу в
|
||||
параметре :option:`--conf-path`. Если вы не хотите
|
||||
использовать конфигурационный файл, используйте параметр
|
||||
:option:`--no-conf`.
|
||||
параметре :option:`--conf-path`. Если вы не хотите использовать
|
||||
конфигурационный файл, используйте параметр :option:`--no-conf`.
|
||||
|
||||
Конфигурационный файл - это текстовый файл, содержащий один параметр в
|
||||
строке. В каждой строке, вы можете указать пары имя-значение в формате:
|
||||
ИМЯ=ЗНАЧЕНИЕ, где имя - это длинный параметр командной строки, без префикса
|
||||
``--``. Вы можете использовать тот же синтаксис, что и для параметра командной
|
||||
строки. Строки начинающиеся с ``#`` рассматриваются как комментарии::
|
||||
``--``. Вы можете использовать тот же синтаксис, что и для параметра
|
||||
командной строки. Строки начинающиеся с ``#`` рассматриваются как
|
||||
комментарии::
|
||||
|
||||
# sample configuration file for aria2c
|
||||
listen-port=60000
|
||||
|
|
@ -1658,18 +1657,18 @@ aria2.conf
|
|||
|
||||
|
||||
dht.dat
|
||||
~~~~~~~~
|
||||
~~~~~~~
|
||||
|
||||
By default, the routing table of IPv4 DHT is saved to the path
|
||||
``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to
|
||||
the path ``$HOME/.aria2/dht6.dat``.
|
||||
``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to the
|
||||
path ``$HOME/.aria2/dht6.dat``.
|
||||
|
||||
Netrc
|
||||
~~~~~
|
||||
|
||||
Поддержка Netrc включена по умолчанию для HTTP(S)/FTP. Для отключения
|
||||
поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл
|
||||
.netrc должен иметь соответствующие права (600).
|
||||
поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл .netrc
|
||||
должен иметь соответствующие права (600).
|
||||
|
||||
Если имя машины (machine) начинается с ``.``, то aria2 выполняет доменное
|
||||
сопоставление вместо точного соответствия. Это расширение aria2. Пример
|
||||
|
|
@ -1681,10 +1680,10 @@ Netrc
|
|||
Домен ``aria2.example.org`` сопоставляется с ``.example.org`` и используется
|
||||
``myid`` и ``mypasswd``.
|
||||
|
||||
Примеры некоторых доменных сопоставлений: домен ``example.net`` не сопоставим
|
||||
с ``.example.org``. Домен ``example.org`` не сопоставим ``.example.org`` из-за
|
||||
предшествующей ``.``. Если вы хотите соответствия ``example.org``, то точно
|
||||
укажите - ``example.org``.
|
||||
Примеры некоторых доменных сопоставлений: домен ``example.net`` не
|
||||
сопоставим с ``.example.org``. Домен ``example.org`` не сопоставим
|
||||
``.example.org`` из-за предшествующей ``.``. Если вы хотите соответствия
|
||||
``example.org``, то точно укажите - ``example.org``.
|
||||
|
||||
Контрольный файл
|
||||
~~~~~~~~~~~~~~~~
|
||||
|
|
@ -1695,8 +1694,8 @@ aria2 использует контрольный файл для отслежи
|
|||
``.aria2``. Например, если file.zip загружаемый файл, тогда контрольный файл
|
||||
будет file.zip.aria2. (Существует исключение для этого именования. При
|
||||
загрузке торрента с множеством файлов, контрольный файл будет в "корневом
|
||||
каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого каталога"
|
||||
- значение ключа "name" в "info" внутри torrent-файла.)
|
||||
каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого
|
||||
каталога" - значение ключа "name" в "info" внутри torrent-файла.)
|
||||
|
||||
Обычно контрольный файл удаляется после завершения загрузки. Если aria2
|
||||
решает, что загрузка не может быть возобновлена (например, когда загружается
|
||||
|
|
@ -1799,7 +1798,8 @@ URI. Эти дополнительные строки должны начина
|
|||
* :option:`max-resume-failure-tries <--max-resume-failure-tries>`
|
||||
* :option:`max-tries <-m>`
|
||||
* :option:`max-upload-limit <-u>`
|
||||
* :option:`metalink-enable-unique-protocol <--metalink-enable-unique-protocol>`
|
||||
* :option:`metalink-enable-unique-protocol
|
||||
<--metalink-enable-unique-protocol>`
|
||||
* :option:`metalink-language <--metalink-language>`
|
||||
* :option:`metalink-location <--metalink-location>`
|
||||
* :option:`metalink-os <--metalink-os>`
|
||||
|
|
@ -1845,15 +1845,13 @@ URI. Эти дополнительные строки должны начина
|
|||
http://foo/bar
|
||||
|
||||
|
||||
Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``,
|
||||
а загрузка происходит с
|
||||
\http://server/file.iso и \http://mirror/file.iso, то ``file.iso`` сохранится
|
||||
как ``/iso_images/file.img``. Файл ``bar`` загрузится с http://foo/bar и
|
||||
сохранится как ``/tmp/bar``.
|
||||
Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``, а загрузка
|
||||
происходит с \http://server/file.iso и \http://mirror/file.iso, то
|
||||
``file.iso`` сохранится как ``/iso_images/file.img``. Файл ``bar``
|
||||
загрузится с http://foo/bar и сохранится как ``/tmp/bar``.
|
||||
|
||||
В некоторых случаях, параметр :option:`out <-o>` не имеет никакого
|
||||
эффекта. Смотрите примечание по ограничениям параметра
|
||||
:option:`--out <-o>`.
|
||||
эффекта. Смотрите примечание по ограничениям параметра :option:`--out <-o>`.
|
||||
|
||||
Профиль функционирования сервера
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
|
@ -1913,17 +1911,18 @@ aria2 обеспечивает JSON-RPC через HTTP и XML-RPC через HT
|
|||
имеют одинаковые функции. aria2 также обеспечивает JSON-RPC через
|
||||
WebSocket. JSON-RPC через WebSocket использует тот же самый метод сигнатур и
|
||||
формат ответа как у JSON-RPC через HTTP, но дополнительно имеет сервер,
|
||||
инициирующий уведомления. Смотрите подробности в разделе
|
||||
`JSON-RPC через WebSocket`_.
|
||||
инициирующий уведомления. Смотрите подробности в разделе `JSON-RPC через
|
||||
WebSocket`_.
|
||||
|
||||
Путь запроса к JSON-RPC-интерфейсу (для через HTTP и через WebSocket) -
|
||||
``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``.
|
||||
|
||||
WebSocket URI для JSON-RPC через WebSocket является ``ws://HOST:PORT/jsonrpc``.
|
||||
WebSocket URI для JSON-RPC через WebSocket является
|
||||
``ws://HOST:PORT/jsonrpc``.
|
||||
|
||||
Реализованный JSON-RPC основан на спецификации
|
||||
JSON-RPC 2.0 <http://jsonrpc.org/specification> и поддерживает HTTP POST и
|
||||
GET (JSONP). Использование WebSocket как транспорта является начальным
|
||||
Реализованный JSON-RPC основан на спецификации JSON-RPC 2.0
|
||||
<http://jsonrpc.org/specification> и поддерживает HTTP POST и GET
|
||||
(JSONP). Использование WebSocket как транспорта является начальным
|
||||
расширением aria2.
|
||||
|
||||
JSON-RPC-интерфейс не поддерживает уведомления в HTTP, но RPC-сервер будет
|
||||
|
|
@ -1961,10 +1960,11 @@ GID
|
|||
указывать на один и тот же файл. Если вы смешивайте другие URI, указывающие
|
||||
на другой файл, то aria2 не сообщит об этом, но и загрузка может неудачно
|
||||
завершаться. Параметр *options* имеет тип структура, элементы которой
|
||||
являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более подробной информации. Если параметр *position* задан
|
||||
как целое число, начиная с 0, то новая загрузка будет вставлена на позицию
|
||||
*position* в очередь ожидания. Если параметр *position* не задан или больше
|
||||
чем размер очереди, то загрузка будет добавлена в конец очереди. Этот метод
|
||||
являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более
|
||||
подробной информации. Если параметр *position* задан как целое число,
|
||||
начиная с 0, то новая загрузка будет вставлена на позицию *position* в
|
||||
очередь ожидания. Если параметр *position* не задан или больше чем размер
|
||||
очереди, то загрузка будет добавлена в конец очереди. Этот метод
|
||||
возвращает GID зарегистрированной загрузки.
|
||||
|
||||
**Пример JSON-RPC**
|
||||
|
|
@ -2294,8 +2294,8 @@ GID
|
|||
|
||||
``errorCode``
|
||||
Последний код ошибки, которая произошла при загрузке. Значение имеет тип
|
||||
строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно только для остановленных/завершенных
|
||||
загрузок.
|
||||
строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно
|
||||
только для остановленных/завершенных загрузок.
|
||||
|
||||
``followedBy``
|
||||
Список с GID, которые сгенерированы в результате запуска этой
|
||||
|
|
@ -2794,7 +2794,9 @@ GID
|
|||
пределами конца очереди, это переместит загрузку в начало или конец очереди
|
||||
соответственно. Ответ имеет целочисленный тип и является целевой позицией.
|
||||
|
||||
Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')`` изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')`` изменит его позицию на 0 (начало очереди).
|
||||
Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')``
|
||||
изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')``
|
||||
изменит его позицию на 0 (начало очереди).
|
||||
|
||||
**Пример JSON-RPC**
|
||||
|
||||
|
|
@ -3325,9 +3327,8 @@ GID
|
|||
Параметры
|
||||
~~~~~~~~~
|
||||
|
||||
Такие же параметры, что доступны для
|
||||
:option:`--input-file <-i>`. Смотрите подраздел `Входной файл`_ для полного
|
||||
списка параметров.
|
||||
Такие же параметры, что доступны для :option:`--input-file <-i>`. Смотрите
|
||||
подраздел `Входной файл`_ для полного списка параметров.
|
||||
|
||||
В структуре, имя элемента - это имя параметра (без ``--``), а значение
|
||||
элемента - аргумент в виде строки.
|
||||
|
|
@ -3355,11 +3356,10 @@ GID
|
|||
</struct>
|
||||
|
||||
|
||||
Параметры :option:`header <--header>` и :option:`index-out <-O>`
|
||||
допускают нескольких определений в
|
||||
командной строке. Поскольку имя должно быть уникальным в структуре
|
||||
(многие реализации библиотеки XML-RPC использует хэш или словарь
|
||||
для структуры), одной строки не достаточно. Для преодоления этой
|
||||
Параметры :option:`header <--header>` и :option:`index-out <-O>` допускают
|
||||
нескольких определений в командной строке. Поскольку имя должно быть
|
||||
уникальным в структуре (многие реализации библиотеки XML-RPC использует хэш
|
||||
или словарь для структуры), одной строки не достаточно. Для преодоления этой
|
||||
ситуации, они могут взять массив в качестве значения, а также строку.
|
||||
|
||||
Пример JSON-RPC
|
||||
|
|
@ -3404,16 +3404,14 @@ JSON-RPC используя HTTP GET
|
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
JSON-RPC-интерфейс также поддерживает запрос через HTTP GET. Схема
|
||||
кодирования в GET параметров основанных на
|
||||
JSON-RPC
|
||||
через HTTP Спецификация [2008-1-15(RC1)]. Кодирование параметров через GET
|
||||
следующие::
|
||||
кодирования в GET параметров основанных на JSON-RPC через HTTP Спецификация
|
||||
[2008-1-15(RC1)]. Кодирование параметров через GET следующие::
|
||||
|
||||
/jsonrpc?method=METHOD_NAME&id=ID¶ms=BASE64_ENCODED_PARAMS
|
||||
|
||||
|
||||
``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть в
|
||||
кодировке UTF-8.
|
||||
``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть
|
||||
в кодировке UTF-8.
|
||||
|
||||
Например, закодированная строка aria2.tellStatus('3') с id='foo' выглядит
|
||||
так::
|
||||
|
|
@ -3435,8 +3433,8 @@ JSON-RPC-интерфейс поддерживает JSONP. Вы можете о
|
|||
|
||||
|
||||
Для пакетного запроса, параметры ``method`` и ``id`` не должны быть
|
||||
указаны. Полный запрос должен быть определен в параметре ``params``. Например,
|
||||
пакетный запрос::
|
||||
указаны. Полный запрос должен быть определен в параметре
|
||||
``params``. Например, пакетный запрос::
|
||||
|
||||
[{'jsonrpc':'2.0', 'id':'qwer', 'method':'aria2.getVersion'},
|
||||
{'jsonrpc':'2.0', 'id':'asdf', 'method':'aria2.tellActive'}]
|
||||
|
|
@ -3522,8 +3520,8 @@ params, является данными, которые переносит эт
|
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Следующий Ruby-скрипт добавляет ``http://localhost/aria2.tar.bz2``, с
|
||||
параметром :option:`--dir=/downloads, <-d>` в aria2c, которая
|
||||
работает на localhost и отображает ответ:
|
||||
параметром :option:`--dir=/downloads, <-d>` в aria2c, которая работает на
|
||||
localhost и отображает ответ:
|
||||
|
||||
.. code-block:: ruby
|
||||
|
||||
|
|
@ -3752,8 +3750,8 @@ params, является данными, которые переносит эт
|
|||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Для указания выходного имени файла в BitTorrent-загрузках, вам нужно узнать
|
||||
индекс файла в torrent-файле, используя параметр
|
||||
:option:`--show-files <-S>`. Например, результат выглядит следующим образом::
|
||||
индекс файла в torrent-файле, используя параметр :option:`--show-files
|
||||
<-S>`. Например, результат выглядит следующим образом::
|
||||
|
||||
idx|path/length
|
||||
===+======================
|
||||
|
|
@ -3831,8 +3829,8 @@ params, является данными, которые переносит эт
|
|||
Добавить и удалить URI трекера
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Удалить все URI анонса трекеров, описанных в file.torrent и
|
||||
взамен использовать ``http://tracker1/announce`` и ``http://tracker2/announce``:
|
||||
Удалить все URI анонса трекеров, описанных в file.torrent и взамен
|
||||
использовать ``http://tracker1/announce`` и ``http://tracker2/announce``:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue