mirror of https://github.com/aria2/aria2
fixed some bugs
ITriskTI
parent
003aaf4a09
commit
3c5753baf2
|
|
@ -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>
|
||||
|
|
@ -1022,8 +1023,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
Если задано ``false``, тогда для всех заданных URI не поддерживается
|
||||
возобновление загрузки, или aria2 столкнется с невозможностью
|
||||
возобновления загрузки URI ``N``-ое количество раз
|
||||
(значение ``N`` указывается в параметре
|
||||
|
||||
(значение ``N`` указывается в параметре :option:`--max-resume-failure-tries`,
|
||||
то aria2 будет загружать файл с нуля. Смотрите параметр
|
||||
:option:`--max-resume-failure-tries`.
|
||||
По умолчанию: ``true``
|
||||
|
|
@ -1151,8 +1151,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
|
|||
.. option:: --hash-check-only[=true|false]
|
||||
|
||||
Если задано ``true``, то после проверки хэша, используя параметр
|
||||
:option:`--check-integrity <-V>`,
|
||||
загрузка прервётся, в любом случае загрузка завершится.
|
||||
: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>
|
||||
|
||||
|
|
@ -1348,10 +1348,10 @@ 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` не будут сохранены.
|
||||
|
||||
|
|
@ -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.
|
||||
|
||||
|
|
@ -1447,7 +1447,7 @@ aria2 предоставляет параметры, в которых указ
|
|||
доступны следующие параметры:
|
||||
:option:`--on-bt-download-complete`,
|
||||
:option:`--on-download-pause`,
|
||||
:option:`--on-download-complete`.
|
||||
:option:`--on-download-complete`,
|
||||
:option:`--on-download-start`,
|
||||
:option:`--on-download-error`,
|
||||
:option:`--on-download-stop`.
|
||||
|
|
@ -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