| mqttui(1) | General Commands Manual | mqttui(1) |
نام (NAME)
mqttui - رابط کاربری متنی برای اشتراک و انتشار پیام‌های MQTT
خلاصه دستور (SYNOPSIS)
mqttui [--qos] [--payload-size-limit] [-b|--broker] [-u|--username] [--password] [-i|--client-id] [--ca-cert] [--client-cert] [--client-private-key] [--insecure] [-h|--help] [-V|--version] [موضوع] [زیردستورها]
توضیحات (DESCRIPTION)
اشتراک در موضوعات (Topics) پروتکل MQTT یا انتشار سریع داده‌ها از طریق ترمینال.
گزینه‌ها (OPTIONS)
- --qos <LEVEL> [پیش‌فرض: 2]
- حداکثر سطح
کیفیت
خدمات (`QoS`)
برای
اشتراک‌ها
و انتشار
پیام.
سطح پایین‌تر کیفیت خدمات میان ناشر و مشترک، توسط کارگزار (Broker) به مشترک تحویل داده می‌شود. بنابراین اشتراک با سطح 0 هرگز پیام‌های با سطح 1 یا 2 را دریافت نمی‌کند. انتشار پیام با سطح 2 هنگام اشتراک با سطح 1، به‌صورت سطح 1 تحویل گرفته می‌شود.
- 0: حداکثر یک‌بار (fire and forget)
- 1: حداقل یک‌بار (تحویل تاییدشده همراه با احتمال تکرار)
- 2: دقیقاً یک‌بار (تحویل تضمین‌شده بدون تکرار)
- --payload-size-limit <PAYLOAD_SIZE_LIMIT> [پیش‌فرض: 8000]
- کوتاه‌سازی
و برش حجم
داده‌های
بار مفید (Payload)
ذخیره‌شده
به اندازه
مشخص‌شده.
بارهای مفید بزرگ‌تر از این مقدار بریده شده و از نظر قالب‌هایی مانند JSON یا MessagePack بررسی نمی‌شوند. تنها بخش ابتدایی آن‌ها تا سقف بایت تعیین‌شده قابل‌مشاهده خواهد بود. افزایش این مقدار ممکن است به‌ویژه در طول زمان منجر به مصرف حافظه بیشتر شود.
- -h, --help
- نمایش راهنما (مشاهده خلاصه با '-h')
- -V, --version
- نمایش نسخه
- [موضوع] [پیش‌فرض: #]
- موضوع (Topic) مورد نظر برای پایش و رصد
اتصال به کارگزار (MQTT CONNECTION)
- -b, --broker <URL> [پیش‌فرض: mqtt://localhost]
- نشانی
اینترنتی (URL)
نحوه اتصال
به کارگزار
MQTT.
مثال‌ها: `mqtt://localhost` `mqtt://localhost:1883` `mqtts://localhost` `mqtts://localhost:8883` `ws://localhost/path` `ws://localhost:9001/path` `wss://localhost/path` `wss://localhost:9001/path`
- -u, --username <STRING>
- نام کاربری
برای
دسترسی به
کارگزار MQTT.
در صورت عدم ارائه، دسترسی ناشناس (Anonymous) استفاده می‌شود.
- --password <STRING>
- گذرواژه
برای
دسترسی به
کارگزار MQTT.
استفاده از اتصال امن TLS به کارگزار را مد نظر داشته باشید؛ در غیر این صورت گذرواژه به‌صورت متن ساده (Plaintext) منتقل خواهد شد.
ارسال گذرواژه از طریق خط فرمان ناامن است زیرا گذرواژه از تاریخچه دستورات قابل‌خواندن خواهد بود! توصیه می‌شود آن را از طریق متغیر محیطی منتقل کنید.
- -i, --client-id <STRING>
- مشخص کردن شناسه کلاینت (Client ID) برای اتصال
- --ca-cert <FILEPATH>
- مسیر فایل PEM
گواهی
صادرکننده
مورد
اعتماد (CA)
برای
اعتبارسنجی
کارگزار.
گواهی CA باید از نوع گواهی X.509 v3 باشد، زیرا rustls از گواهی‌های نسخه v1 با امنیت کمتر پشتیبانی نمی‌کند. ببینید: https://github.com/rustls/rustls/issues/2364
- --client-cert <FILEPATH>
- مسیر فایل
گواهی
کلاینت TLS.
همراه با --client-private-key برای فعال‌سازی احراز هویت کلاینت در TLS استفاده می‌شود. فایل باید گواهی X.509 با کدگذاری DER و سریال‌شده در قالب PEM باشد.
- --client-private-key <FILEPATH>
- مسیر فایل
کلید خصوصی
کلاینت TLS.
همراه با --client-cert برای فعال‌سازی احراز هویت کلاینت در TLS استفاده می‌شود. فایل باید ساختار ASN.1 با کدگذاری DER در قالب PKCS#8 و سریال‌شده در قالب PEM باشد.
- --insecure
- اجازه به اتصالات TLS ناامن
زیردستورها (SUBCOMMANDS)
- mqttui-clean-retained(1)
- پاک‌سازی پیام‌های نگه‌داشته‌شده (Retained) از کارگزار
- mqttui-log(1)
- ثبت وقایع و مقادیر موضوعات مشترک‌شده در خروجی استاندارد (stdout)
- mqttui-read-one(1)
- انتظار برای دریافت اولین پیام روی موضوع(های) مشخص‌شده و بازگرداندن داده بار مفید آن به خروجی استاندارد
- mqttui-publish(1)
- انتشار سریع یک مقدار
نسخه (VERSION)
v0.24.0
| mqttui 0.24.0 |