YasnaMCP Knowledge Hub

اتصال میکروتیک (RouterOS) به هوش مصنوعی با YasnaMCP

راهنمای کامل اتصال روتر MikroTik به YasnaMCP؛ بدون روشن‌کردن API و بدون بازکردن پورت. دریافت کلید اتصال، اجرای یک فرمان دو خطی، و کارهایی که هوش مصنوعی می‌تواند روی روتر انجام دهد.

میکروتیک را به هوش مصنوعی وصل کنید؛ بدون API و بدون پورت باز

روترهای MikroTik قلب شبکهٔ بیشتر سازمان‌ها هستند، اما تا امروز برای هر کار ساده‌ای باید ترمینال باز می‌کردید. با کانکتور MikroTik در YasnaMCP، خودِ روتر به‌صورت امن به هوش مصنوعی وصل می‌شود و می‌توانید با زبان طبیعی بپرسید «آیا فایروال درست تنظیم شده؟»، «کدام کلاینت‌ها به وای‌فای وصل‌اند؟» یا «قانون مسدودسازی این آدرس را اضافه کن».

RouterOS Device → YasnaMCP MikroTik Edge → YasnaMCP Server → AI Client

نکتهٔ مهم معماری: روی روتر هیچ سرویسی روشن نمی‌شود. نه api، نه www-ssl، نه هیچ پورت شنودکننده‌ای. روتر خودش به سمت YasnaMCP بیرون می‌زند — دقیقاً مثل یک peer وایرگارد. یعنی همان چیزی که برای امنیت شبکه لازم دارید: هیچ در ورودی جدیدی به روتر باز نمی‌شود.

گام ۱ — یک Connector در پنل بسازید و توکنش را اینجا بدهید

روتر شما داخل سازمان خودتان ثبت می‌شود؛ برای همین اول یک Connector در پنل YasnaMCP می‌سازید و توکنش را به این صفحه می‌دهید. سه کار، کمتر از یک دقیقه:

در پنل، Connector بسازید

وارد پنل YasnaMCP شوید (با حساب سازمان خودتان) و به بخش Connectors بروید. یک Connector جدید بسازید و هر نامی که می‌خواهید بگذارید — این نام آزاد است و همان چیزی است که در فهرست کانکتورهای سازمان شما دیده می‌شود.

توکن Connector را کپی کنید

پس از ساخت، یک توکن با پیشوند ymc_ct_ نمایش داده می‌شود. آن را کپی کنید؛ همین توکن، اجازهٔ اتصال روتر به سازمان شماست و در اختیار دیگران گذاشتنش مثل دادن کلید ساختمان است.

نام روتر و توکن را در کارت زیر بگذارید

توکن همان لحظه با سرور YasnaMCP بررسی می‌شود؛ اگر معتبر باشد، فرمان نصب آمادهٔ کپی تحویل داده می‌شود و نام سازمان شما هم تأیید می‌شود. اگر توکن اشتباه یا باطل باشد، همین‌جا پیام می‌گیرید — نه بعد از نصب روی روتر.

RouterOS Connector

کلید اتصال روتر خود را بگیرید

نام سایت یا شعبه را وارد کنید؛ یک کلید یکتا برای همین روتر ساخته میشود و فرمان نصب، آمادهٔ کپی تحویل داده میشود.

آمادهٔ نصب

در WebFig یا WinBox روتر، New Terminal را باز کنید.
هر دو خط زیر را یکجا بچسبانید و Enter بزنید.
پایان کار: پیام YasnaMCP connector installed را میبینید.

این کلید به روتر شما تعلق دارد؛ در اختیار دیگران نگذارید. برای ابطال، تیم YasnaMCP میتواند توکن را باطل کند و روتر با فرمان بعدی از دسترس خارج میشود.

اگر در سازمان شما چند روتر دارید: برای هر روتر یک Connector جدا بسازید و همان مراحل را تکرار کنید. هر روتر، کانکتور مستقل خودش را دارد و می‌توانید هرکدام را جدا محدود یا غیرفعال کنید.

گام ۲ — فرمان را در روتر اجرا کنید

ترمینال RouterOS را باز کنید

در WebFig روی New Terminal بزنید، یا در WinBox پنجرهٔ New Terminal را باز کنید. دسترسی لازم، سطح full administrator است (نصب، اسکریپت و زمان‌بند می‌سازد).

دو خط فرمان را یکجا بچسبانید

فرمانی که در گام ۱ گرفتید، دو خط است: خط اول سه مقدار (آدرس سرویس، شناسهٔ روتر و کلید) را در حافظهٔ موقت روتر می‌گذارد؛ خط دوم نصب‌کننده را از سایت می‌گیرد و اجرا می‌کند. هر دو خط را با هم انتخاب و paste کنید:

:global YasnaEdge "https://humanfree.ir/mt"; :global YasnaDevice "mt-xxxxxxxxxx"; :global YasnaToken "ysm_...";
/tool fetch url=("https://humanfree.ir/mt/install/yasna-mt-install.rsc") dst-path="yasna-mt-install.rsc" check-certificate=yes; :delay 1s; /import file-name="yasna-mt-install.rsc"

مقادیر واقعی را از کارت گام ۱ کپی کنید؛ متن بالا فقط نمونه است. نصب‌کننده در پایان گزارش می‌دهد: شناسهٔ روتر، دسترسی (فقط خواندنی یا کامل) و فهرست عملیات مجاز.

چه چیزی روی روتر ساخته می‌شود؟

سه چیز، و نه بیشتر: یک اسکریپت به نام yasna-mt-agent، یک زمان‌بند (scheduler) با همان نام که هر چند ثانیه یک چرخه اجرا می‌کند، و یک فایل نصب. سطح دسترسی اسکریپت read,write,policy,test,ftp,sensitive است تا کارهای خواندن، اجرا و پشتیبان‌گیری ممکن باشد.

اگر نصب‌کننده گفت «cannot reach …/install/manifest.json»: اول DNS و مسیر خروجی روتر به اینترنت را بررسی کنید، و مهم‌تر از آن ساعت روتر را. گواهی SSL با تاریخ مقایسه می‌شود؛ اگر ساعت روتر عقب باشد، هر اتصال HTTPS شکست می‌خورد. اصلاح سریع: /system ntp client set enabled=yes servers=pool.ntp.org

گام ۳ — تأیید اتصال

تست خودکار

این اسکریپت وضعیت کامل را گزارش می‌دهد: نسخهٔ RouterOS، ساعت، آدرس سرویس، وضعیت زمان‌بند، دسترسی به سرور و آخرین خطوط لاگ کانکتور:

/system script run yasna-mt-selftest

در YasnaMCP چه می‌بینید؟

روتر شما در پنل YasnaMCP به‌عنوان یک Connector مستقل، با نام، مدل برد و نسخهٔ RouterOS دیده می‌شود. اگر کنار نام روتر، وضعیت «آنلاین» بود، همه‌چیز درست است. برای تغییرات هم باید دو اجازه هم‌زمان وجود داشته باشد: اجازهٔ دسترسی در پنل، و دسترسی نوشتن روی خود روتر.

هوش مصنوعی روی روتر چه می‌تواند بکند؟

فهرست زیر بخشی از کارهای واقعی است؛ هر کدام یک پرسش فارسی در چت YasnaMCP می‌شود.

خواندن وضعیت: هویت، منابع (CPU، RAM، دیسک)، سلامت برد، نسخهٔ RouterOS و بسته‌ها، ساعت و NTP
شبکه: فهرست اینترفیس‌ها، شمارنده‌های ترافیک، پل‌ها، VLAN، لینک‌های وایرگارد و همتایان آن
آدرس‌دهی و مسیر: آدرس‌ها، ARP، مسیرها، DNS ایستا
DHCP: سرورها، شبکه‌ها، و لیست اجاره‌ها (Lease)
فایروال: قوانین filter/nat/mangle/raw به‌صورت JSON، و مدیریت Address-list با زمان انقضا
پایش: Ping و Traceroute از خود روتر، Netwatch، صف‌ها، ثبت‌نام کلاینت‌های وای‌فای
نگهداری: گرفتن Export از تنظیمات، ساخت نسخهٔ پشتیبان، بررسی به‌روزرسانی RouterOS، و ری‌استارت کنترل‌شده
هر منوی دیگری: از طریق اجرای مستقیم فرمان RouterOS (mikrotik.cli) — یعنی پوشش کامل، حتی برای منوهایی که بعد از انتشار این کانکتور اضافه شوند

پیش‌نیازها

RouterOS نسخهٔ ۷ (روی نسخهٔ ۶ نصب نمی‌شود؛ کانکتور به قابلیت‌های زمان‌بند و JSON نسخهٔ ۷ نیاز دارد)
ساعت درست روی روتر — با NTP حل می‌شود
دسترسی خروجی HTTPS (پورت ۴۴۳) از روتر به اینترنت؛ اگر از وایرگارد استفاده می‌کنید، همان تونل هم کافی است
دسترسی کامل ادمین روی روتر برای نصب اولیه
یک حساب در پنل YasnaMCP با اجازهٔ ساخت Connector (برای گرفتن توکن)
هیچ پکیج اضافه، هیچ container و هیچ دیسک خارجی لازم نیست — به همین دلیل روی بردهای mipsbe و arm32 هم کار می‌کند

امنیت و کنترل — شفاف و قابل تنظیم

روی روتر هیچ سرویس و هیچ پورت شنودکننده‌ای فعال نمی‌شود؛ فقط ارتباط خروجی به سمت YasnaMCP
هر روتر کلید مستقل دارد؛ نشت یک کلید به معنای دسترسی به بقیهٔ روترها نیست
به‌صورت پیش‌فرض، روتری که از این صفحه ثبت می‌شود فقط خواندنی است؛ تغییر تنظیمات نیازمند اجازهٔ آگاهانه است
فهرست عملیات مجاز در سمت سرور نگه داشته و روی خود روتر هم دوباره بررسی می‌شود
ابطال کلید در هر لحظه ممکن است؛ روتر در اولین تماس بعدی رد می‌شود
هر فراخوانی در پنل، در لاگ سرویس و در لاگ روتر (با topic yasnamcp) ثبت می‌شود

دانلود فایل‌های نصب

نصب معمولاً با همان دو خط انجام می‌شود و نیازی به دانلود دستی نیست. اما اگر می‌خواهید فایل‌ها را نگه دارید یا روی شبکهٔ بدون اینترنت نصب کنید، نسخهٔ فعلی در دسترس است:

yasna-mt-install.rsc — نصب‌کننده و آپدیت‌کننده (همان که دستور fetch می‌گیرد)
yasna-mt-agent.rsc — خود ایجنت، برای نصب دستی
yasna-mt-selftest.rsc — تست و عیب‌یابی
yasna-mt-uninstall.rsc — حذف کامل کانکتور از روتر

پرسش‌های متداول

آیا باید سرویس API میکروتیک را روشن کنم؟

نه. این کانکتور به‌هیچ‌وجه از /ip service api یا REST استفاده نمی‌کند. روتر فقط کلاینت خروجی است.

اگر اینترنت روتر قطع شود چه می‌شود؟

چیزی خراب نمی‌شود. روتر در فواصل چند ثانیه‌ای تلاش می‌کند و پس از وصل شدن، خودش ادامه می‌دهد. در همین فاصله، فراخوانی‌های هوش مصنوعی با پیام «روتر آفلاین است» پاسخ می‌گیرند، نه با خطای مبهم.

چطور دسترسی را باز یا محدود کنم؟

دو لایه دارد: دسترسی در پنل YasnaMCP (اینکه هوش مصنوعی اجازهٔ اجرا داشته باشد) و فهرست عملیات مجاز روی خود روتر. روتری که از این صفحه ثبت می‌شود فقط خواندنی است؛ برای تغییر تنظیمات، تیم YasnaMCP یا ادمین روتر باید سطح دسترسی را آگاهانه باز کند.

چطور کانکتور را حذف کنم؟

اسکریپت yasna-mt-uninstall را اجرا کنید تا زمان‌بند، اسکریپت‌ها و فایل‌های نصب پاک شوند، و بعد کلید را باطل کنید. اگر کلید باطل نشود، هیچ آسیبی متوجه روتر نیست، اما کلید باقی‌مانده یک ریسک است.

آیا روی همهٔ مدل‌های میکروتیک کار می‌کند؟

هر دستگاهی که RouterOS 7 دارد: از hAP و hEX تا CCR و CHR، مستقل از معماری (arm64، arm32، mipsbe، x86).