AMULECMD(1) aMule utilities AMULECMD(1)

amulecmd - کلاینت خط فرمانی برای کنترل aMule

amulecmd [-h <host>] [-p <port>] [-P <password>] [-f <path>] [-q] [-v] [-l <lang>] { [-w] | [-c <command>] }

amulecmd [--create-config-from=<path>]

amulecmd [--version]

amulecmd [--help]

amulecmd یک کلاینت مبتنی بر کنسول برای کنترل aMule است.

[ -h <host>, --host=<host> ]
میزبانی که aMule روی آن در حال اجرا است (پیش‌فرض: 127.0.0.1). <host> ممکن است یک نشانی IP یا یک نام DNS باشد.
[ -p <port>, --port=<port> ]
درگاه aMule برای اتصالات خارجی (External Connections)، همان‌طور که در Preferences->Remote Controls تنظیم شده است (پیش‌فرض: 4712).
[ -P <password>, --password=<password> ]
گذرواژه اتصالات خارجی (External Connections).
[ -f <path>, --config-file=<path> ]
استفاده از فایل پیکربندی داده‌شده. فایل پیکربندی پیش‌فرض ~/.aMule/remote.conf است.
[ -q, --quiet ]
عدم چاپ هرگونه خروجی در stdout.
[ -v, --verbose ]
حالت پرگویی - پیام‌های اشکال‌زدایی نیز نمایش داده شوند.
[ -l <lang>, --locale=<lang> ]
تنظیم زبان و محلی‌سازی برنامه (locale). برای توضیحات پارامتر <lang> بخش NOTES را ببینید.
[ -w, --write-config ]
نوشتن گزینه‌های خط فرمان در فایل پیکربندی و خروج.
[ -c <command>, --command=<command> ]
اجرای <command> به گونه‌ای که گویی در اعلان amulecmd وارد شده است و سپس خروج.
[ --create-config-from=<path> ]
ایجاد فایل پیکربندی بر پایه <path> (که باید به یک فایل پیکربندی معتبر aMule اشاره کند) و سپس خروج.
[ --force-zlib ]
اجبار به فشرده‌سازی ZLIB روی پیوند اتصال خارجی بدون در نظر گرفتن محلی بودن IP مقصد. زمانی مفید است که سمت سرور از طریق یک تونل VPN در دسترس باشد که به یک IP شبکه محلی (LAN) نگاشت می‌شود و در غیر این صورت الگوریتم اکتشافی از فشرده‌سازی صرف‌نظر می‌کرد.
[ --version ]
نمایش شماره نسخه فعلی.
[ --help ]
چاپ یک توضیح کوتاه درباره نحوه استفاده.

تمام دستورات نسبت به بزرگی و کوچکی حروف حساس نیستند (case insensitive).

افزودن یک پیوند eD2k یا یک پیوند magnet به هسته.

پیوند eD2k ارائه‌شده برای افزودن می‌تواند یکی از موارد زیر باشد:

  • یک پیوند فایل (ed2k://|file|...)، که به صف بارگیری افزوده خواهد شد؛
  • یک پیوند سرور (ed2k://|server|...)، که به فهرست سرورها افزوده خواهد شد؛
  • یک پیوند فهرست سرور، که در این صورت تمام سرورهای موجود در آن به فهرست سرورها افزوده خواهند شد.

پیوند magnet باید شامل هش eD2k و طول فایل باشد.

لغو بارگیری مشخص‌شده توسط <hash> یا <number>. برای دریافت مقدار از دستور show استفاده کنید.

اتصال به شبکه.

این دستور به تمامی شبکه‌هایی که در Preferences فعال شده‌اند متصل می‌شود.

با استفاده از پارامتر اختیاری می‌توانید شبکه مورد نظر برای اتصال را مشخص کنید. با ارائه نشانی سرور در قالب IP:Port (که در آن IP یک نشانی IPv4 دهدهی نقطه‌دار یا یک نام DNS قابل حل است)، aMule فقط به همان سرور متصل خواهد شد.

قطع اتصال از تمام شبکه‌هایی که به آن‌ها متصل هستید، یا فقط قطع اتصال از شبکه مشخص‌شده.

شروع بارگیری یک فایل.

باید <number> یک فایل از آخرین جستجو داده شود. مثال: `download 12` بارگیری فایل شماره ۱۲ از جستجوی پیشین را آغاز می‌کند.

قطع اتصال از amule/amuled و خروج از amulecmd.

دریافت و نمایش مقدار یک تنظیم (preference).

مقادیر موجود برای <what>:

دریافت محدودیت‌های پهنای باند.
دریافت تنظیمات IPFilter.

چاپ یک توضیح کوتاه درباره نحوه استفاده. اگر بدون پارامتر فراخوانی شود، فهرستی از دستورات موجود را نمایش می‌دهد. اگر با <command> فراخوانی شود، توضیح کوتاهی درباره دستور ارائه‌شده نمایش می‌دهد.

متوقف کردن موقت (Pause) بارگیری مشخص‌شده توسط <hash> یا <number>. برای دریافت مقدار از دستور show استفاده کنید.

تنظیم اولویت بارگیری مشخص‌شده توسط <hash> یا <number>.

مقادیر موجود برای <priority>:

اولویت خودکار.
اولویت بالا.
اولویت پایین.
اولویت عادی.

نمایش میزان پیشرفت جستجوی در حال انجام.

مترادفی برای دستور exit.

بارگذاری مجدد یک شیء مشخص.

مقادیر موجود برای <what>:

بارگذاری مجدد فهرست فایل‌های هم‌رسانی‌شده.
بارگذاری مجدد جدول‌های فیلتر IP.

بازنشانی گزارش (log).

نمایش نتایج آخرین جستجو.

از سرگیری بارگیری مشخص‌شده توسط <hash> یا <number>. برای دریافت مقدار از دستور show استفاده کنید.

انجام جستجو برای <keyword> داده‌شده. مشخص کردن نوع جستجو و کلیدواژه برای این کار الزامی است. مثال: `search kad amule` یک جستجوی kad برای `amule` انجام می‌دهد.

انواع جستجوی موجود:

انجام جستجوی سراسری (Global).
انجام جستجو روی شبکه کادملیا (Kademlia).
انجام جستجوی محلی (Local).

فیلترهای اختیاری را می‌توان قبل، بعد یا در میان کلیدواژه(های) جستجو قرار داد:

محدود کردن نتایج به نوع فایل داده‌شده.
محدود کردن نتایج به یک پسوند فایل مشخص (مانند iso، mp3).
حداقل تعداد منابعی (sources) که یک نتیجه باید گزارش کند.
کوچک‌ترین اندازه فایل برای بازگرداندن. پسوندها از ضرایب دودویی استفاده می‌کنند (K = 1024، M = K×1024، G = M×1024)؛ نبود پسوند به معنای بایت است.
بزرگ‌ترین اندازه فایل برای بازگرداندن. همان پسوندهای --min-size.

مثال: `search global linux iso --type Iso --min-size 100M` نتایجی را برای “linux iso” با نوع فایل Iso و با اندازه حداقل 100 مبی‌بایت (MiB) برمی‌گرداند.

تنظیم مقدار یک گزینه در تنظیمات.

مقادیر موجود برای <what>:

تنظیم محدودیت‌های پهنای باند.
تنظیم اولویت‌ها و پیکربندی IPFilter.

نمایش صف بارگذاری/بارگیری، فهرست سرورها یا فهرست فایل‌های هم‌رسانی‌شده.

مقادیر موجود برای <what>:

نمایش صف بارگیری (دانلود).
نمایش گزارش (log).
نمایش فهرست سرورها.
نمایش فهرست فایل‌های هم‌رسانی‌شده.
نمایش صف بارگذاری (آپلود).

خاموش کردن هسته در حال اجرای راه دور (amule/amuled). این کار کلاینت متنی را نیز خواهد بست، زیرا بدون هسته در حال اجرا بلااستفاده است.

نمایش درخت آمار.

مقدار اختیاری <number> در بازه 0-255 می‌تواند به عنوان آرگومان به این دستور داده شود، که مشخص می‌کند چه تعداد از مدخل‌های زیردرخت نسخه کلاینت باید نمایش داده شوند. ارسال 0 یا حذف آن به معنای «نامحدود» است.

مثال: `statistics 5` فقط ۵ نسخه برتر برای هر نوع کلاینت را نمایش می‌دهد.

نمایش وضعیت اتصال، سرعت‌های فعلی بارگذاری/بارگیری و غیره.

برای تمامی گزینه‌هایی که مقدار <path> دریافت می‌کنند، اگر path شامل هیچ بخش پوشه‌ای نباشد (یعنی فقط یک نام فایل ساده باشد)، در این صورت فرض می‌شود که در پوشه پیکربندی aMule یعنی ~/.aMule قرار دارد.

پارامتر <lang> برای گزینه -l ساختاری به شکل زیر دارد: lang[_LANG][.encoding][@modifier] که در آن lang زبان اصلی، LANG زیرزبان/منطقه جغرافیایی، encoding مجموعه نویسه (character set) مورد استفاده و modifier به کاربر امکان می‌دهد نمونه خاصی از داده‌های محلی‌سازی را در یک دسته‌بندی منفرد انتخاب کند.

برای مثال، رشته‌های زیر معتبر هستند:

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

اگرچه تمامی رشته‌های بالا به عنوان تعاریف معتبر زبان پذیرفته می‌شوند، encoding و modifier هنوز استفاده نمی‌شوند.

علاوه بر ساختار بالا، می‌توانید نام‌های کامل زبان‌ها را به زبان انگلیسی نیز مشخص کنید - بنابراین -l german نیز معتبر بوده و برابر با -l de_DE است.

هنگامی که هیچ محلی‌سازی‌ای (locale) تعریف نشده باشد، چه در خط فرمان و چه در فایل پیکربندی، زبان پیش‌فرض سیستم استفاده خواهد شد.

~/.aMule/remote.conf

به‌طور معمول amulecmd برای بار اول به این صورت اجرا می‌شود:

amulecmd -h hostname -p ECport -P ECpassword -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 General Public License) توزیع می‌شوند.

amule(1), amuled(1)

این صفحه راهنما توسط Vollstrecker <amule@vollstreckernet.de> نوشته شده است.

August 2026 aMuleCmd vGIT