Scroll to navigation

AMULECMD(1) утилиты aMule AMULECMD(1)

ИМЯ

amulecmd - консольная программа для управления aMule

ОБЗОР

amulecmd [-h <хост>] [-p <порт>] [-P <пароль>] [-f <путь>] [-q] [-v] [-l <язык>] { [-w] | [-c <команда>] } [--space-separated]

amulecmd [--create-config-from=<путь>]

amulecmd [--version]

amulecmd [--help]

ОПИСАНИЕ

amulecmd консольный клиент для управления программой aMule.

[ -h <хост>, --host=<хост> ]
Адрес компьютера на котором работает aMule (по умолчанию: 127.0.0.1). <Хост> может быть IP-адресом или DNS-именем
[ -p <порт>, --port=<порт> ]
Порт, который использует aMule для внешних соединений. Указывается в Настройках->Удалённое управление (по умолчанию: 4712)
[ -P <пароль>, --password=<пароль> ]
Пароль для внешних соединений.
[ -f <путь>, --config-file=<путь> ]
Использовать указанный файл конфигурации. По умолчанию используется ~/.aMule/remote.conf
[ -q, --quiet ]
Не печетать ничего в стандартный вывод.
[ -v, --verbose ]
Детально — также выводить отладочную информацию.
[ -l <язык>, --locale=<язык> ]
Задаёт локаль программы (язык). См. секцию ЗАМЕЧАНИЯ для подробностей по параметру <язык>.
[ -w, --write-config ]
Записать параметр командной строки в файл конфигурации и выйти
[ -c <команда>, --command=<команда> ]
Выполнить <команду> как если бы она была введена в консоль amulecmd и выйти.
[ --create-config-from=<путь> ]
Создать файл конфигурации на основе файла указанного в <пути> и выйти. Указанный файл должен быть валидным файлом конфигурации aMule.
[ --disable-ec-encryption ]
Не шифровать соединение внешнего подключения. Шифрование согласовывается автоматически, когда удалённый aMule его поддерживает, и включено по умолчанию для любого назначения, локального или удалённого. Его отключение делает всё после входа в систему читаемым и изменяемым для любого, кто может наблюдать за соединением.
[ --force-zlib ]
Принудительно использовать сжатие ZLIB для соединения внешнего подключения независимо от локальности вызванного IP-адреса. Полезно, когда серверная сторона доступна через VPN-туннель, который разрешается в локальный IP-адрес, и эвристика в противном случае пропустила бы сжатие.
[ --space-separated ]
Разделять поля команд списка пробелами, как в более старых версиях, вместо символов табуляции. Имена клиентов и файлов могут содержать пробелы, поэтому стандартный разделитель — табуляция — позволяет скриптам верно разбивать строки на поля; используйте эту опцию только для скриптов, написанных под старый формат вывода.
[ --version ]
Выводит информацию о версии.
[ --help ]
Выводит короткую помощь по использованию.

КОМАНДЫ

Все команды чувствительны к регистру.

Add <eD2k-link> | <magnet-link>

Добавляет eD2k-ссылку или magnet-ссылку в ядро.

Добавляемая eD2k-ссылка может быть:

  • файловая ссылка (ed2k://|file|...), она будет добавлена в очередь скачивания;
  • серверная ссылка (ed2k://|server|...), она будет добавлена в список серверов;
  • ссылка на список серверов, в этом случае все серверы из списка будут добавлены в список серверов.

Magnet-ссылка должна содержать eD2k-хэш и размер файла.

Cancel <hash> | <number>

Отменяет скачивание, указанное в <хэшу> или <номеру>. Чтобы определить значения, воспользуйтесь командой show.

Connect [ kad | ed2k | <ip|name> ]

Подключиться к сети.

Это подсоединит ко всем сетям, включенным в настройках.

С помощью дополнительного параметра можно указать сеть к которой будет произведено подключение. При указании адреса сервера в виде IP:Порт (где IP может быть либо цифровым представлением IPv4 либо DNS-именем) aMule подключится только к этому серверу.

Disconnect [ ed2k | kad ]

Отсоединяет от всех сетей, или только от указанной сети.

Download <number>

Начать скачивание файла.

Необходимо указать <номер> файла из последнего поиска. Пример: 'download 12' начнёт скачивание файла под номером 12 из предыдущего поиска.

Exit

Отключится от amule/amuled и выйти из amulecmd.

Get <what>

Получить и отобразить значение параметра.

Возможные значения поля <параметр>:

Получить ограничения скорости передачи.
Вывести настройки IP-фильтра.

Help [ <command> ]

Вывести короткую справку. Если вызвана без параметров, выводит список возможных команд. Если вызвана с параметром <команда>, показывает справку по данной команде.

Pause <hash> | <number>

Ставит на паузу скачивание, указанное в <хэшу> или <номеру>. Чтобы определить значения, воспользуйтесь командой show.

Priority <priority> <hash> | <number>

Указывает приоритет скачивания, указанного в <хэшу> или <номеру>.

Возможные значения <приоритета>:

Автоматический приоритет.
Высокий приоритет.
Низкий приоритет.
Обычный приоритет.

Progress [<id>]

Показывает ход выполнения текущего поиска. Может принимать <id> поиска (как выводится командой search); без идентификатора показывает последний начатый поиск.

Quit

Синоним команды exit.

Reload <what>

Обновляет указанный объект.

Возможные значения поля <параметр>:

Переподгрузить список публикуемых файлов.
Обновляет таблицы IP-фильтра.

Reset

Сбросить журнал.

Results [<id>]

Показывает результаты поиска. Может принимать <id> поиска (как выводится командой search); без идентификатора показывает последний начатый поиск. В демоне одновременно может храниться несколько поисков, каждый из которых доступен по своему идентификатору.

Resume <hash> | <number>

Возобновляет скачивание, указанное в <хэшу> или <номеру>. Чтобы определить значения, воспользуйтесь командой show.

Search <type> [<filters>] <keyword>

Выполняет поиск по указанному <ключевому слову>. Для этого обязательно указать тип поиска и ключевое слово. Пример: 'search kad amule' выполняет поиск Kad по запросу 'amule'. Выводит идентификатор поиска; передайте его командам results или progress, чтобы обратиться к этому поиску. Одновременно может выполняться несколько поисков, каждый со своим идентификатором.

Возможные типы поиска:

Глобальный поиск.
Поиск по сети kademlia.
Локальный поиск.

Необязательные фильтры можно размещать до, после или вперемешку с ключевыми словами поиска:

Ограничить результаты указанным типом файла.
Ограничить результаты конкретным расширением файла (например, iso, mp3).
Минимальное количество источников, которое должен иметь результат.
Наименьший размер файла для возврата. Суффиксы используют двоичные множители (K = 1024, M = K×1024, G = M×1024); без суффикса — байты.
Наибольший размер файла для возврата. Те же суффиксы, что и для --min-size.

Пример: 'search global linux iso --type Iso --min-size 100M' возвращает результаты для 'linux iso' типа Iso размером не менее 100 МиБ.

Set <what>

Задает указанный параметр.

Возможные значения поля <параметр>:

Задаёт ограничения скорости передачи.
Задаёт параметры IP-фильтра.

Show <what>

Выводит очередь отдачи/скачивания, список серверов или опубликованных файлов.

Возможные значения поля <параметр>:

Показать очередь загрузки.
Показать журнал.
Показать список серверов.
Показать список публикуемых файлов.
Показать очередь отдачи.

Shutdown

Завершает работу ядра (amule/amuled). Так же завершает работу amulecmd, т.к. он бесполезен без работающего ядра.

Statistics [ <number> ]

Выводит дерево статистики.

В качестве аргумента этой команды можно передать необязательное <число> в диапазоне 0–255, которое указывает, сколько элементов поддерева версий клиентов следует показать. Передача 0 или пропуск аргумента означает «без ограничений».

Пример: 'statistics 5' покажет только 5 самых популярных версий для каждого типа клиента.

Status

Показывает состояние подключения, текущую скорость скачивания и т.д.

ЗАМЕЧАНИЯ

Пути

Для всех опций, в которых указывается <путь>, если путь не содержит каталога (т.е. только имя самого файла), то предполагается, что файл находится в каталоге конфигурации, ~/.aMule.

Языки

Параметр <язык> для опции -l имеет следующую форму: язык[_ЯЗЫК][.кодировка][@модификатор], где язык является основным языком, ЯЗЫК - диалект/территория, кодировка - используемая кодировка символов и модификатор позволяет пользователю использовать определенный вариант локализации в данной категории.

К примеру, все следующие строчки являются приемлемыми:

de
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro

Хотя все приведенный строки будут приняты, поля кодировка и модификатор пока не используются.

К дополнению к приведенному формату, можно просто указать английское имя языка. Так, -l russian тоже приемлемо и равносильно -l ru_RU.

Когда язык не указан ни в качестве опции ни в файле конфигурации, используется системный.

ФАЙЛЫ

~/.aMule/remote.conf

ПРИМЕРЫ

Как правило, в первый раз amulecmd запускается так:

amulecmd -h имя_хоста -p EC_порт -P EC_пароль -w

или

amulecmd --create-config-from=/home/username/.aMule/amule.conf

Это сохранит параметры в $HOME/.aMule/remote.conf, и в дальнейшем надо будет только набрать:

amulecmd

Конечно, вы не обязаны следовать этим рекомендациям.

СООБЩЕНИЕ ОБ ОШИБКАХ

Пожалуйста, сообщайте об ошибках либо на нашем форуме (https://github.com/amule-org/amule/discussions), либо в багтрекере (https://github.com/amule-org/amule/issues). Пожалуйста, не сообщайте об ошбках по электронной почте, по нашим спискам рассылки, или напрямую участникам.

АВТОРСКИЕ ПРАВА

aMule и все прилагающиеся инструменты распространяются под Стандартной общественной лицензией GNU (GNU GPL).

СМ. ТАКЖЕ

amule(1), amuled(1)

АВТОРЫ

Автор страницы помощи: Vollstrecker <amule@vollstreckernet.de>, перевод: Radist Morse <radist.morse@gmail.com>

October 2026 aMuleCmd v3.1.0