diff options
| author | ITriskTI <ITriskTI@gmail.com> | 2012-10-17 10:40:11 +0300 |
|---|---|---|
| committer | ITriskTI <ITriskTI@gmail.com> | 2012-10-17 10:40:11 +0300 |
| commit | bc33433e58693de759ae4de5949ea9b1f29ce4c5 (patch) | |
| tree | 979be95307ca062f73e99dfef01e2046ba5b3104 /doc | |
| parent | b48d9082db8e682bc818f06b9201481e53524a36 (diff) | |
Update and fixed some bugs
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual-src/ru/aria2c.rst | 88 |
1 files changed, 69 insertions, 19 deletions
diff --git a/doc/manual-src/ru/aria2c.rst b/doc/manual-src/ru/aria2c.rst index cb574686..ec93c69f 100644 --- a/doc/manual-src/ru/aria2c.rst +++ b/doc/manual-src/ru/aria2c.rst @@ -978,6 +978,13 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 можеÑ Добавить заголовок Access-Control-Allow-Origin со значением ``*`` в RPC-ответе. По умолчанию: ``false`` +.. option:: --rpc-certificate=<FILE> + + Использовать сертификат в FILE для RPC-сервера. Сертификат должен быть + в PEM-формате. Используйте параметр :option:`--rpc-private-key`, + чтобы указать закрытый ключ. Используйте параметр :option:`--rpc-secure` + для включения шифрования. + .. option:: --rpc-listen-all[=true|false] Слушать входящие JSON-RPC/XML-RPC-запросы на всех сетевых интерфейсах. @@ -1002,6 +1009,32 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 можеÑ Задать JSON-RPC/XML-RPC пароль. +.. option:: --rpc-private-key=<FILE> + + Использовать закрытый ключ в FILE для RPC-сервера. Закрытый ключ должен + быть дешифрованным и в PEM-формате. Используйте параметр + :option:`--rpc-secure` для включения шифрования. + Смотрите также параметр :option:`--rpc-certificate`. + +.. option:: --rpc-save-upload-metadata[=true|false] + + Сохранить загруженные метаданные torrent или metalink в каталоге, + заданном параметром :option:`--dir`. Имя файла содержит + шестнадцатеричную строку SHA-1-хэша метаданных плюс расширение. + Для torrent расширение '.torrent'. Для metalink - это '.meta4'. + Если параметр задан как false, то загрузки, добавленные с помощью + :func:`aria2.addTorrent` или :func:`aria2.addMetalink`, не будут + сохраняться при помощи параметра :option:`--save-session`. + По умолчанию: ``false`` + +.. option:: --rpc-secure[=true|false] + + RPC-транспорт будет зашифрован с использованием SSL/TLS. RPC-клиенты должны + использовать https-схему для доступа к серверу. Для WebSocket-клиента, + использовать wss-схему. Используйте параметры :option:`--rpc-certificate` и + :option:`--rpc-private-key` для указания сертификата севера и закрытого + ключа. + .. option:: --rpc-user=<USER> Задать JSON-RPC/XML-RPC пользователя. @@ -1439,8 +1472,8 @@ Metalink-документов, которые хранятся на локаль одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent-рой. Для однофайловых торрентов, URI может быть завершенным, который указывает на ресурс, или же если заканчиваться символом /, тогда name (имя) в -torrent-файле будет добавлено. Для многофайловых торентов, name (имя) и path -(путь) в torrent-файле будут добавлены из URI для каждого файла. +torrent-файле будет добавлено. Для многофайловых торрентов, name (имя) и +path (путь) в torrent-файле будут добавлены из URI для каждого файла. .. note:: @@ -1848,6 +1881,7 @@ URI. Эти дополнительные строки должны начинаÑ * :option:`remove-control-file <--remove-control-file>` * :option:`retry-wait <--retry-wait>` * :option:`reuse-uri <--reuse-uri>` + * :option:`rpc-save-upload-metadata <--rpc-save-upload-metadata>` * :option:`seed-ratio <--seed-ratio>` * :option:`seed-time <--seed-time>` * :option:`select-file <--select-file>` @@ -1943,7 +1977,8 @@ WebSocket`_. ``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``. WebSocket URI для JSON-RPC через WebSocket является -``ws://HOST:PORT/jsonrpc``. +``ws://HOST:PORT/jsonrpc``. Если вы включили SSL/TLS-шифрование, то +используйте ``wss://HOST:PORT/jsonrpc``. Реализованный JSON-RPC основан на спецификации JSON-RPC 2.0 <http://jsonrpc.org/specification> и поддерживает HTTP POST и GET @@ -2038,15 +2073,15 @@ GID - Этот метод добавляет BitTorrent-загрузку путем загрузки .torrent-файла. Если - вы хотите добавить BitTorrent Magnet URI, взамен используйте метод - :func:`aria2.addUri`. Параметр *torrent* имеет тип - base64, с содержанием Base64-кодировки - в .torrent-файле. Параметр *uris* имеет тип массив, элемент которого имеет тип строка и содержит URI. + Этот метод добавляет BitTorrent-загрузку путем загрузки .torrent-файла. + Если вы хотите добавить BitTorrent Magnet URI, взамен используйте метод + :func:`aria2.addUri`. Параметр *torrent* имеет тип base64, с содержанием + Base64-кодировки в .torrent-файле. Параметр *uris* имеет тип массив, + элемент которого имеет тип строка и содержит URI. Параметр *uris* используется для Web-сидирования. Для однофайловых - торрентов, URI может быть завершенным, который указывает на ресурс, или же - если заканчиваться символом /, тогда будет добавлено имя из - torrent-файла. Для многофайловых торентов, имя и путь в торренте будут + торрентов, URI может быть завершенным, который указывает на ресурс, + или же если заканчиваться символом /, тогда будет добавлено имя из + torrent-файла. Для многофайловых торрентов, имя и путь в торренте будут добавлены из URI для каждого файла. Параметр *options* имеет тип структура, элементы которой являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более подробной информации. Если @@ -2054,11 +2089,13 @@ GID будет вставлена на позицию *position* в очередь ожидания. Если параметр *position* не задан или больше чем размер очереди, то загрузка будет добавлена в конец очереди. Этот метод возвращает GID зарегистрированной - загрузки. Загруженные данные сохраняются в файл с именем шестнадцатеричной + загрузки. Если :option:`--rpc-save-upload-metadata` задан как ``true``, + загруженные данные сохраняются в файл с именем шестнадцатеричной строки SHA-1-хэша этих данных плюс ".torrent", в каталог указанный в параметре :option:`--dir <-d>`. Например, имя файла 0a3893293e27ac0490424c06de4d09242215f0a6.torrent. Если этот файл существует, - то он будет перезаписан. Если файл не может быть успешно сохранен, то + то он будет перезаписан. Если файл не может быть успешно сохранен или + :option:`--rpc-save-upload-metadata` задан как ``false``, то загрузки, добавленные этим методом, не сохраняются при помощи параметра :option:`--save-session`. @@ -2107,9 +2144,10 @@ GID строки SHA-1-хэша этих данных плюс ".metalink", в каталог указанный в параметре :option:`--dir <-d>`. Например, имя файла 0a3893293e27ac0490424c06de4d09242215f0a6.metalink. Если этот файл - существует, то он будет перезаписан. Если файл не может быть успешно - сохранен, то загрузки, добавленные этим методом, не сохраняются при помощи - параметра :option:`--save-session`. + существует, то он будет перезаписан. Если файл не может быть успешно сохранен + или :option:`--rpc-save-upload-metadata` задан как ``false``, то + загрузки, добавленные этим методом, не сохраняются при помощи параметра + :option:`--save-session`. **Пример JSON-RPC** @@ -2975,9 +3013,9 @@ GID `Входной файл`_, исключая следующие параметры: :option:`dry-run <--dry-run>`, :option:`metalink-base-uri <--metalink-base-uri>`, - :option:`parameterized-uri <-P>`, :option:`pause <--pause>` и - :option:`piece-length <--piece-length>`. Этот метод возвращает ``"OK"``, в - случае успеха. + :option:`parameterized-uri <-P>`, :option:`pause <--pause>`, :option:`piece-length <--piece-length>` и + :option:`rpc-save-upload-metadata <--rpc-save-upload-metadata>`. + Этот метод возвращает ``"OK"``, в случае успеха. **Пример JSON-RPC** @@ -3952,6 +3990,18 @@ Checksum $ aria2c --ca-certificate=/path/to/ca-certificates.crt --check-certificate https://host/file +RPC +~~~ + +Шифрование RPC-транспорта с использованием SSL/TLS +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Указать файл с сертификатом сервера и файл с закрытым ключом следующим +образом: + +.. code-block:: console + + $ aria2c --enable-rpc --rpc-certificate=/path/to/server.crt --rpc-private-key=/path/to/server.key --rpc-secure И еще больше расширенных возможностей ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
