summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorITriskTI <ITriskTI@gmail.com>2012-10-17 10:40:11 +0300
committerITriskTI <ITriskTI@gmail.com>2012-10-17 10:40:11 +0300
commitbc33433e58693de759ae4de5949ea9b1f29ce4c5 (patch)
tree979be95307ca062f73e99dfef01e2046ba5b3104 /doc
parentb48d9082db8e682bc818f06b9201481e53524a36 (diff)
Update and fixed some bugs
Diffstat (limited to 'doc')
-rw-r--r--doc/manual-src/ru/aria2c.rst88
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
И еще больше расширенных возможностей
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~