| 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-ссылка может быть:
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>¶
Получить и отобразить значение параметра.
Возможные значения поля <параметр>:
Help [ <command> ]¶
Вывести короткую справку. Если вызвана без параметров, выводит список возможных команд. Если вызвана с параметром <команда>, показывает справку по данной команде.
Pause <hash> | <number>¶
Ставит на паузу скачивание, указанное в <хэшу> или <номеру>. Чтобы определить значения, воспользуйтесь командой show.
Priority <priority> <hash> | <number>¶
Указывает приоритет скачивания, указанного в <хэшу> или <номеру>.
Возможные значения <приоритета>:
Progress [<id>]¶
Показывает ход выполнения текущего поиска. Может принимать <id> поиска (как выводится командой search); без идентификатора показывает последний начатый поиск.
Quit¶
Синоним команды exit.
Reload <what>¶
Обновляет указанный объект.
Возможные значения поля <параметр>:
- Переподгрузить список публикуемых файлов.
- IPFilter
- Обновляет таблицы IP-фильтра.
Reset¶
Сбросить журнал.
Results [<id>]¶
Показывает результаты поиска. Может принимать <id> поиска (как выводится командой search); без идентификатора показывает последний начатый поиск. В демоне одновременно может храниться несколько поисков, каждый из которых доступен по своему идентификатору.
Resume <hash> | <number>¶
Возобновляет скачивание, указанное в <хэшу> или <номеру>. Чтобы определить значения, воспользуйтесь командой show.
Search <type> [<filters>] <keyword>¶
Выполняет поиск по указанному <ключевому слову>. Для этого обязательно указать тип поиска и ключевое слово. Пример: 'search kad amule' выполняет поиск Kad по запросу 'amule'. Выводит идентификатор поиска; передайте его командам results или progress, чтобы обратиться к этому поиску. Одновременно может выполняться несколько поисков, каждый со своим идентификатором.
Возможные типы поиска:
Необязательные фильтры можно размещать до, после или вперемешку с ключевыми словами поиска:
- --type <Audio|Video|Image|Doc|Pro|Arc|Iso>
- Ограничить результаты указанным типом файла.
- --extension <ext> (alias: --ext)
- Ограничить результаты конкретным расширением файла (например, iso, mp3).
- --avail <N> (alias: --availability)
- Минимальное количество источников, которое должен иметь результат.
- --min-size <N[KMG]>
- Наименьший размер файла для возврата. Суффиксы используют двоичные множители (K = 1024, M = K×1024, G = M×1024); без суффикса — байты.
- --max-size <N[KMG]>
- Наибольший размер файла для возврата. Те же суффиксы, что и для --min-size.
Пример: 'search global linux iso --type Iso --min-size 100M' возвращает результаты для 'linux iso' типа Iso размером не менее 100 МиБ.
Set <what>¶
Задает указанный параметр.
Возможные значения поля <параметр>:
Show <what>¶
Выводит очередь отдачи/скачивания, список серверов или опубликованных файлов.
Возможные значения поля <параметр>:
Shutdown¶
Завершает работу ядра (amule/amuled). Так же завершает работу amulecmd, т.к. он бесполезен без работающего ядра.
Statistics [ <number> ]¶
Выводит дерево статистики.
В качестве аргумента этой команды можно передать необязательное <число> в диапазоне 0–255, которое указывает, сколько элементов поддерева версий клиентов следует показать. Передача 0 или пропуск аргумента означает «без ограничений».
Пример: 'statistics 5' покажет только 5 самых популярных версий для каждого типа клиента.
Status¶
Показывает состояние подключения, текущую скорость скачивания и т.д.
ЗАМЕЧАНИЯ¶
Пути¶
Для всех опций, в которых указывается <путь>, если путь не содержит каталога (т.е. только имя самого файла), то предполагается, что файл находится в каталоге конфигурации, ~/.aMule.
Языки¶
Параметр <язык> для опции -l имеет следующую форму: язык[_ЯЗЫК][.кодировка][@модификатор], где язык является основным языком, ЯЗЫК - диалект/территория, кодировка - используемая кодировка символов и модификатор позволяет пользователю использовать определенный вариант локализации в данной категории.
К примеру, все следующие строчки являются приемлемыми:
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).
СМ. ТАКЖЕ¶
АВТОРЫ¶
Автор страницы помощи: Vollstrecker <amule@vollstreckernet.de>, перевод: Radist Morse <radist.morse@gmail.com>
| October 2026 | aMuleCmd v3.1.0 |