اتصال اولین دستگاه به بروکر MQTT در ۵ قدم

در mqttcloud.ir ثبت‌نام کنید. پلن رایگان به‌صورت خودکار فعال می‌شود و یک اکانت MQTT و حداکثر دو دستگاه در اختیارتان می‌گذارد؛ برای شروع کافی است.

در داشبورد به صفحه «بروکر MQTT» بروید و یک اکانت MQTT بسازید. اکانت MQTT همان نام کاربری و رمز عبوری است که دستگاه‌ها با آن به بروکر وصل می‌شوند (جدا از ایمیل و رمز ورود به سایت).

• نام کاربری: ۳ تا ۳۲ کاراکتر شامل حروف انگلیسی، عدد، - یا _؛ این نام بین همه کاربران یکتاست و به حروف کوچک تبدیل می‌شود.
• رمز عبور: حداقل ۶ کاراکتر؛ بهتر است طولانی و تصادفی باشد.

رمز عبور به‌صورت رمزنگاری‌شده ذخیره می‌شود و دوباره نمایش داده نمی‌شود؛ همان لحظه آن را جایی امن نگه دارید. اگر فراموشش کردید، می‌توانید از داشبورد رمز جدید تعیین کنید.

زیر همان اکانت یک دستگاه اضافه کنید. شناسه دستگاه (Client ID) نامی است که دستگاه هنگام اتصال اعلام می‌کند؛ ۱ تا ۶۴ کاراکتر از حروف انگلیسی، عدد، - یا _، مثلاً device-01.

این قدم مهم است: بروکر فقط دستگاه‌هایی را می‌پذیرد که شناسه‌شان زیر همان اکانت ثبت شده باشد. اگر دستگاه با شناسه دیگری وصل شود، حتی با نام کاربری و رمز درست، اتصال رد می‌شود.

اطلاعات اتصال:

• آدرس: mqtt.mqttcloud.ir
• پورت 8883: MQTT روی TLS (پیشنهادی)
• پورت 1883: بدون رمزنگاری؛ فقط برای آزمایش
• WebSocket برای مرورگر: wss://mqtt.mqttcloud.ir/mqtt

سریع‌ترین راه آزمایش، ابزار mosquitto در خط فرمان است. در یک ترمینال مشترک شوید (به‌جای alice نام کاربری خودتان را بگذارید):

mosquitto_sub -h mqtt.mqttcloud.ir -p 8883 --capath /etc/ssl/certs \
  -i device-01 -u alice -P 'YOUR_PASSWORD' -t 'alice/#' -v

برای انتشار پیام از ترمینال دوم به شناسه دستگاه دوم نیاز دارید، چون دو اتصال هم‌زمان نمی‌توانند یک Client ID داشته باشند. دستگاه device-02 را هم ثبت کنید و بعد:

mosquitto_pub -h mqtt.mqttcloud.ir -p 8883 --capath /etc/ssl/certs \
  -i device-02 -u alice -P 'YOUR_PASSWORD' -t 'alice/test' -m 'hello'

گواهی TLS بروکر از Let's Encrypt است، پس در لینوکس همان مجموعه گواهی‌های سیستم (/etc/ssl/certs) برای تأیید آن کافی است.

• در صفحه «بروکر MQTT» دستگاه‌های متصل با وضعیت آنلاین نمایش داده می‌شوند.
• صفحه «فعالیت» زمان اتصال و قطع هر دستگاه را نشان می‌دهد (تا ۳۰ روز).
• صفحه «پیام‌ها» آخرین پیام‌های منتشرشده و محتوای آن‌ها را نشان می‌دهد (تا ۷ روز) که برای عیب‌یابی بسیار کاربردی است.

حالا آماده‌اید دستگاه واقعی را وصل کنید: راهنمای اتصال ESP32 و راهنمای پایتون و Node.js را ببینید.