مستندات

SAMM مستندات

راهنمای جامع اپراتور — از اولین نصب تا عملیات روزانه.

25 موضوع 8 بخش نصب با یک دستور
نصب سریع

در عرض چند دقیقه و تنها با یک دستور، آنلاین شوید.

یک خط کد را روی یک سرور Ubuntu یا Debian تازه نصب‌شده — یا در PowerShell در Windows — اجرا کنید تا نصب‌کننده، آخرین نسخه را دریافت کرده و کل SAMM stack را برای شما راه‌اندازی کند.

راهنمای کامل نصب را مطالعه کنید
Ubuntu / Debian — اجرا به‌عنوان root
curl -fsSL https://samm.securytik.com/install.sh | sudo bash
Windows — در PowerShell به‌صورت administrator اجرا کنید
irm https://samm.securytik.com/install-windows.ps1 | iex
لیست پخش دوره ویدئویی آموزش SAMM از نصب تا عملیات روزانه — دوره ویدئویی کامل یک لیست پخش رایگان و گام‌به‌گام در YouTube که مراحل نصب SAMM و نحوه بهره‌برداری روزانه از آن را آموزش می‌دهد — همان مباحثی که در این دفترچه راهنما آمده است، در قالب ویدیو. مشاهده در YouTube

راهنمای شروع به‌کار

نمای کلی معماری &

SAMM — SecuryTik Active Mikrotik Manager — یک پلتفرم جامع مدیریت ISP برای شبکه‌های MikroTik PPPoE & Hotspot است. تنها با یک نصب‌کننده، یک سرور Linux خام به یک سیستم کامل AAA، صورت‌حساب و مدیریت مشترکین تبدیل می‌شود.

SAMM برای چه کسانی است

SAMM برای ISPهای بی‌سیم، اپراتورهای فیبر و ارائه‌دهندگان Hotspot که از MikroTik RouterOS استفاده می‌کنند، طراحی شده است. اگر مشترکین خود را از طریق PPPoE، Hotspot یا IPoE/DHCP احراز هویت می‌کنید و نیاز به اعمال محدودیت‌های سرعت، سقف مصرف داده، تاریخ انقضا و صورت‌حساب دارید — SAMM تمام این موارد را در یک صفحه مدیریت می‌کند.

مشترکین IPoE/DHCP از طریق circuit-id در DHCP Option 82 (پورت دسترسی فیزیکی — روش حرفه‌ای ISP) یا MAC دستگاه شناسایی می‌شوند و radius-password در DHCP server صرفاً همان RADIUS shared secret روتر است، بنابراین نیازی به پیکربندی اضافی نیست.

IPv6 dual-stack یک گزینه اختیاری است: هر مشترک می‌تواند در کنار IPv4، دسترسی به IPv6 داشته باشد. این قابلیت را در ویزارد روتر فعال کرده و طول پیشوند واگذارشده (DHCPv6-PD) — به‌صورت پیش‌فرض /56، یا هر مقداری از /48 تا /64 — و بلوک‌های IPv6 جهت تخصیص را انتخاب کنید. در هر Access-Accept، سیستم SAMM یک pool از IPv6های WAN به‌همراه یک پیشوند مسیریابی‌شده را به LAN مشترک واگذار می‌کند؛ به‌گونه‌ای که روتر مشتری (در حالت route) آن را به /64های کوچک‌تر تقسیم کرده و SLAAC را برای دستگاه‌های خود اجرا می‌کند — این مدل استاندارد واگذاری پیشوند ISP است. این قابلیت با PPPoE، Hotspot و IPoE سازگار است و برای مشتریان تجاری، می‌توان یک پیشوند IPv6 استاتیک را برای هر مشترک تثبیت کرد.

نحوه عملکرد

SAMM مسیر hot را نزدیک به database نگه می‌دارد. FreeRADIUS هر بسته authentication و accounting را مدیریت می‌کند؛ در هر Interim-Update مربوط به accounting، توابع PostgreSQL را به‌طور مستقیم فراخوانی می‌کند تا میزان مصرف را تجمیع و محدودیت‌ها را ارزیابی کند — در حالی که مشترکین آنلاین هستند، هیچ round-trip مربوط به Python وجود ندارد.

چهار سطح اجرا از طریق یک پایگاه داده واحد با یکدیگر تعامل دارند:

  • FreeRADIUS (unlang + rlm_sql) — authenticates every packet; on each Interim-Update it accumulates bytes/uptime and evaluates limits inside Postgres.
  • samm-radius — runs time-driven sweeps (expiry, daily reset, speed windows) and is the only process that sends Change-of-Authorization packets.
  • samm-worker — pings routers and syncs MikroTik device metadata over the API.
  • samm-api — the admin & customer portals; admin actions are queued to the database and applied by samm-radius, never sent as CoAs directly.

پنج سرویس

سرویسنقش
samm-apiپورتال مدیر + پورتال خودسرویس مشتری + REST API
samm-radiusتخلیه Outbox مربوط به CoA؛ اجرای بررسی‌های انقضا / بازنشانی روزانه / بازه زمانی سرعت
samm-workerارسال Ping به روترها؛ همگام‌سازی متادیتای دستگاه MikroTik از طریق API
samm-notificationاعلان‌های email & Telegram را از طریق یک صف با نرخ محدود (throttled) ارسال می‌کند
samm-telegramاجرای ربات تعاملی self-service در Telegram

قابلیت‌های SAMM

هسته AAA

احراز هویت PPPoE & Hotspot، اعمال محدودیت سرعت به‌ازای هر کاربر، CoA هیبرید.

پلن‌ها & محدودیت‌ها

سطوح سرعت به‌علاوه چهار محدودیت مستقل و بازه‌های زمانی زمان‌بندی‌شده برای سرعت.

مشترکین

کاربران PPPoE، Hotspot و IPoE/DHCP به‌علاوه کارت‌های ووچر Hotspot پیش‌پرداخت با PDFهای قابل چاپ.

صورت‌حساب

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

سرویس خودکار (Self-service)

یک پورتال وب مشتری و یک ربات Telegram برای مشاهده میزان مصرف، صورت‌حساب‌ها و تیکت‌ها.

عملیات

لیست زنده MikroTik، مدیران مبتنی بر نقش، پشتیبان‌گیری & بازیابی، ابزارهای دسته‌جمعی.

سیستم

داخلی WireGuard VPN، Cloudflare تونل، هشت زبان، UI با موضوع.

اعلان‌ها

هشدارهای تمدید، انقضا، سهمیه و رسید از طریق email و Telegram.

باقی این راهنما، دستورالعملی برای هر یک از این بخش‌ها است. از منوی سمت چپ استفاده کنید یا با Installation شروع کنید.

راهنمای شروع به‌کار

تازه‌ها

SAMM به‌طور خودکار به‌روزرسانی می‌شود، بنابراین هر نسخه نصب‌شده در به‌روزرسانی بعدی این قابلیت‌ها را دریافت می‌کند. هر خط به صفحه‌ای پیوند داده شده است که نحوه استفاده از آن را توضیح می‌دهد.

6.0

  • طرح کارت‌ها: کارت چاپی Hotspot را خودتان طراحی کنید (اندازه، پس‌زمینه، لوگوی شما و یک کد QR که کارت را با یک اسکن وارد می‌کند)، یا از ده طرح آماده شروع کنید. هر گروه یک طرح برای چاپ و یکی برای چاپ سریع با چاپگر حرارتی (80 یا 58 mm) دارد. کارت‌های Hotspot
  • یک کارت اضافه کنید یا فهرستی وارد کنید: + Card کارتی با نام کاربری، رمز عبور و نامی که انتخاب می‌کنید اضافه می‌کند؛ Import فهرست CSV یا Excel را با پیش‌نمایش وارد می‌کند. کارت‌های Hotspot
  • زمان و داده باقی‌مانده روی روتر: صفحه وضعیت Hotspot مقدار باقی‌مانده کارت را نشان می‌دهد و روتر با تمام شدن آن جلسه را پایان می‌دهد. کارت‌های Hotspot
  • یک IP pool برای هر کاربر (مثلاً یک pool برای CGNAT)، انتخاب‌شده از poolهای روترهای شما. CGNAT و IP poolها
  • همه منطقه‌های زمانی جهان، با خاورمیانه در ابتدای فهرست.
  • بررسی عمیق: روترهای MikroTik BNG و مدت اجرا را انتخاب کنید، سپس گزارشی با امتیاز و کارهای اول را به زبان خودتان بخوانید، به‌صورت صفحه یا PDF. فقط روتر را می‌خواند. بررسی عمیق
  • SCOOP AI: دستیاری در پایین هر صفحه. با کلمات خودتان درباره کاربران، پلن‌ها، فاکتورها و روترها بپرسید؛ پول، حذف‌ها و تغییرات روتر منتظر Approve شما می‌مانند. SCOOP AI
  • Queue های کاربری سریع‌تر: وقتی کاربری دانلود می‌کند، تماس‌ها و بازی‌ها را روان نگه می‌دارد. ویزارد روتر می‌تواند آن را تنظیم کند و Health یک اصلاح با یک کلیک پیشنهاد می‌دهد.
  • داشبورد برای هر نقش: انتخاب کنید که یک نقش داشبورد را ببیند یا نه. نقشی که آن را ندارد، روی اولین صفحهٔ مجازش باز می‌شود.
  • Sham Cash: در اتصال غیررسمی، کاربری که کدش را فراموش کرده می‌تواند پرداخت را با شمارهٔ حواله و نشانی خودش تأیید کند.

5.12

  • نگهداری داده و Lookup: نشست‌ها را برای مدتی که قانون می‌خواهد (به‌طور پیش‌فرض دو سال) نگه دارید، حتی برای کاربران حذف‌شده، و پیدا کنید کدام مشترک در یک زمان مشخص آدرس عمومی و پورت داشته است. هر جستجو به شماره پرونده نیاز دارد و در گزارش Lookup ثبت می‌شود؛ یک فایل رمزنگاری‌شدهٔ روزانه می‌تواند به NAS شما ارسال شود. نگهداری داده & Lookup
  • CGNAT و مجموعه‌های IP: آدرس‌های عمومی را با یک بلوک پورت برای هر کاربر میان کاربران به اشتراک بگذارید، یا اجازه دهید SAMM خودش آدرس هر کاربر را، برای هر روتر و طرح، تخصیص دهد. CGNAT & مجموعه‌های IP
  • Cisco، Huawei، Nokia و ZTE به‌عنوان NAS، با سرعت، قطعی اتصال، صفحه آماده راه‌اندازی، Data Log و CGNAT روی Cisco. روترهای سایر برندها
  • FTTH: OLTهای V-SOL، Huawei، ZTE و Nokia، هر ONU با سیگنالش، ONUهای متصل به کاربران، و قفل خط مشترک. FTTH & OLTs
  • صفحه دستگاه برای همه برندها: CPU، حافظه، دما، مدت روشن بودن و نمودارها برای OLTها و سایر روترها، مانند MikroTik؛ فرم روتر، ورود درست را برای هر نوع می‌خواهد. روترهای سایر برندها
  • VPN از طریق SAMM برای هر روتر: Through SAMM یا Through Router؛ پرداخت‌های Sham Cash هرگز از VPN عبور نمی‌کنند. VPN از طریق SAMM
  • استفادهٔ کاربر: کارت دورهٔ انتخاب‌شده (مجموع، نشست‌ها، زمان آنلاین) و نواری با طرح، وضعیت، انقضا، آدرس و MAC؛ ربات Telegram دستورهایش را به زبان کاربر فهرست می‌کند. کاربران
  • ما سرور شما را راه‌اندازی می‌کنیم: یک سرور آماده SAMM با دامنهٔ .com اختصاصی خود را از داشبورد سفارش دهید. راه‌اندازی سرور شما

5.11

  • صندوق‌دار: صفحه صندوق زیر حسابداری. کاربر را هنگام تایپ با نام، شماره موبایل یا بخشی از نام کاربری پیدا کنید، سپس وجه را دریافت کنید، تمدید کنید، سهمیه اضافه کنید یا کیف پول را نقدی شارژ کنید. مجوز جداگانه با چهار گزینه دارد، سود و گزارش‌ها را نشان نمی‌دهد و فقط کاربران شعبه صندوق‌دار را پیدا می‌کند. حسابداری، مدیران، شعبه‌ها و نقش‌ها
  • سررسید فاکتور به انتخاب شما: «سررسید فاکتور پس از (روز)» در تنظیمات حسابداری. با 0 فاکتور همان لحظه صدور سررسید می‌شود و تمدید خودکار در روز پایان بسته، پس مهلت از تاریخ پایان شمرده می‌شود. حسابداری
  • جبران تغییر به بسته ارزان‌تر: با انتقال کاربر به بسته ارزان‌تر، بخش استفاده‌نشده دوره به کیف پول یا نقدی بازگردانده می‌شود و مبلغ پیش از ذخیره نمایش داده می‌شود. تغییر بسته در منوی ردیف فهرست کاربران هم هست. کاربران
  • تمدید خودکار از کیف پول پرداخت می‌شود و کیف پول کاربر بدهکار پیش از تعلیق حساب بدهی را تسویه می‌کند. حسابداری
  • اعلان‌ها بر اساس کانال: کانال‌های مجاز هر اعلان را انتخاب کنید، روی همه بفرستید و متن جداگانه پیامک با شمارنده زنده نویسه بنویسید. اعلان‌ها
  • VPN از طریق SAMM بدون تونل برای روترهای هم‌شبکه با SAMM، و مدیریت کنترل والدین و VPN کاربر از پنل مدیریت. VPN از طریق SAMM
  • سهمیه پورت که درست صفر می‌شود: Reset quota شمارش را از صفر شروع می‌کند و پورت را بی‌درنگ برمی‌گرداند، در هر زمان، با نمایش مصرف از آخرین صفر کردن. مدیریت MikroTik
  • فهرست وب‌سایت‌ها و برنامه‌ها برای هر روتر: هر روتر نشان می‌دهد فهرستش به‌روز است یا نه، با دکمه اعمال و یافته‌ها در صفحه سلامت؛ مقادیر پایش هر 5 ثانیه به‌روز می‌شوند. مدیریت MikroTik

5.9

  • ارائه‌دهندگان VPN خارجی: حساب NordVPN، Mullvad، IVPN یا AirVPN را در یک مرحله اضافه کنید، تعداد سرورها و کشور را انتخاب کنید، یا فایل‌ها را از هر ارائه‌دهنده‌ای مانند ProtonVPN بارگذاری کنید. هر کاربر روی یک اتصال می‌ماند، اتصال‌ها بار را بر اساس وزن تقسیم می‌کنند و اگر یکی از آن‌ها از کار بیفتد، کاربرانش از طریق خط خود SAMM به اینترنت دسترسی دارند. VPN از طریق SAMM
  • سهمیه اضافی به‌عنوان افزونه: حجم اینترنت بیشتری بفروشید بدون تغییر بسته یا تاریخ انقضای کاربر، به‌صورت بسته یا قیمت به ازای هر GB، در پنل یا در پورتال کاربر. افزونه‌ها
  • سکتورهای بی‌سیم: هر رادیوی کاربر با سکتوری که روی آن است، مدت زمانی که در آن بوده و هر جابه‌جایی‌اش، که یک سال نگهداری می‌شود؛ سوئیچ‌های پشت سکتورهای شما با کاربرانِ هرکدام؛ و در صفحه کاربر، زنجیره سکتور › رادیو › سوئیچ › کاربر با سیگنال، برد و کیفیت. شبکه
  • یک کاربر را رصد کنید به مدت 24، 48 یا 72 ساعت: زمان آنلاین بودن، سرعت، سیگنال، سکتور و هر قطع اتصال همراه با علت آن، سپس گزارشی قابل چاپ با نمودار و یک یافته کوتاه. کاربران
  • نقشه شبکه روی OpenStreetMap: روترها، سکتورها و کاربرانتان را در محل واقعی‌شان، کنار دیاگرام شبکه قرار دهید. شبکه
  • به‌روزرسانی فهرست برنامه‌ها: SAMM هر روز فهرست برنامه‌های SecuryTik را بررسی می‌کند؛ «اطلاع‌رسانی»، «اعمال خودکار» یا «خاموش» را انتخاب کنید و فهرست قبلی را با یک کلیک برگردانید. مدیر MikroTik
  • تاریخ‌های «از» و «تا» در هر جستجویی که تاریخ دارد، فیلترهای کنترل والدین و VPN در فهرست کاربران، و باز کردن همان صفحه در چند پنجره، به تعداد صفحه‌نمایش‌هایتان. کاربران، داشبورد
  • انتقال از ADV Radius: کاربران و بسته‌ها را از فایل پشتیبان آن منتقل کنید، همراه با رمز عبور، تاریخ انقضا، آدرس‌های ثابت و محدودیت‌های بسته. ابزارها

5.8

  • VPN خارجی: کاربران VPN به‌جای خط SAMM از طریق NordVPN (با توکن دسترسی) یا فایل‌های WireGuard هر ارائه‌دهنده‌ای خارج می‌شوند، حتی وقتی SAMM آدرس عمومی ندارد. VPN از طریق SAMM
  • VPN از طریق SAMM: کاربرانی که انتخاب می‌کنید همه ترافیک خود، یا فقط برنامه‌هایی را که خودشان انتخاب می‌کنند، به‌جای خط محلی‌شان از سرور SAMM شما خارج می‌کنند. آن را برای هر کاربر فعال کنید یا به‌عنوان افزونه بفروشید؛ کاربران آن را در پورتال کاربر روشن می‌کنند. VPN از طریق SAMM
  • SAMM روی دو صفحه‌نمایش: هر صفحه، یا یک بلوک از داشبورد را در پنجره‌ای جداگانه باز کنید و روی مانیتور دوم نگه دارید. داشبورد
  • کنترل والدین به‌عنوان افزونه: کنترل والدین را مانند هر افزونه دیگری برای یک مدت مشخص بفروشید. افزونه‌ها
  • بهینه‌ساز Wi-Fi: نمای زنده طیف فرکانسی هر رادیو، شبکه‌های شناسایی‌شده و میزان اشغال هر کانال، به همراه برنامه‌ریز کانالی که خلوت‌ترین کانال و بهترین پهنای باند را پیشنهاد می‌دهد و می‌تواند رادیوها را در شب به‌طور خودکار جابه‌جا کند. شبکه
  • دستگاه‌های Ubiquiti: نقاط دسترسی UniFi و رادیوهای airOS را به‌عنوان دستگاه‌های تحت نظارت اضافه کنید. رادیوهای UniFi کلاینت‌ها، شبکه‌های همسایه و طیف فرکانسی خود را نمایش می‌دهند و بهینه‌ساز (optimizer) آن‌ها را واقعاً به کانال و پهنای باند بهتری منتقل می‌کند. مدیریت دستگاه‌های MikroTik
  • سه مانیتور برای هر روتر در هر پلن: اکسس‌پوینت‌ها و رادیوهایی که فقط نظارت می‌کنید، دیگر از سهمیه روتر شما کم نمی‌کنند. مدیریت دستگاه‌های MikroTik
  • وارد کردن کاربرانی که در حال حاضر در روتر تعریف شده‌اند (PPP، Hotspot و User Manager، RouterOS 6 و 7) به‌همراه رمزهای عبور، پلن‌ها، محدودیت‌ها، نام‌ها، شماره تلفن‌ها و تاریخ‌های انقضا، در پس‌زمینه. MikroTik manager
  • بازگرداندن تمدید: حذف فاکتور یک تمدید می‌تواند تاریخ انقضای کاربر را به حالت قبل بازگرداند، عملیات Renew Plan از نوار بالا قابل لغو است و لیست Invoices مجموع تمام مواردی که فیلتر نمایش می‌دهد را نشان می‌دهد. لغو & تاییدها
  • پشتیبان‌گیری در Google Drive شخصی شما. Google Drive را در Backup & Restore با یک کد کوتاه متصل کنید؛ پس از آن، هر پشتیبان‌گیری خودکار در پوشه‌ای به نام SAMM Backups در Drive شما کپی می‌شود و هر نسخه برای بازیابی، قابل بازگردانی است. Tools
  • زمان تمدید ثابت در یک پلن: هر تاریخ انقضا روی زمانی که شما انتخاب می‌کنید قرار می‌گیرد و به سمت بالا گرد می‌شود تا کاربر هرگز بازه‌ای کمتر از دوره مربوطه دریافت نکند. Plans
  • لیست آدرس به‌ازای هر پلن: روتر آدرس هر کاربر را به لیستی با نام مشابه پلن آن‌ها اضافه می‌کند تا بتوانید در قوانین فایروال، queue و مسیریابی خود از آن استفاده کنید. Plans
  • حالت جمع‌آوری Self Service: مهمانان نام و شماره موبایل خود را وارد کرده و بدون نیاز به رمز عبور، بلافاصله آنلاین می‌شوند؛ هر ورود برای خروجی گرفتن ذخیره می‌شود. Self Service
  • نمودار کیفیت اتصال واضح‌تر همراه با محورها، خطوط دانلود و آپلود، نمایش جزئیات هنگام نگه داشتن نشانگر موس و میزان داده‌های مصرف‌شده، به‌علاوه امکان جستجوی ایمیل در بخش Users و جستجوی هر پورت در Data Log. Users، Data Log

5.7

  • شعبه‌ها مالک دستگاه‌های خود هستند. هر روتر و اکسس پوینت متعلق به یک شعبه یا دفتر مرکزی است؛ کارکنان شعبه دستگاه‌های خود را مدیریت کرده و تنها موارد سطح بالاتر از خود را مشاهده می‌کنند، و یک تنظیم به کاربران اجازه می‌دهد تنها از طریق روترهای شعبه خود وارد شوند. مدیران، شعبه‌ها & نقش‌ها
  • محدودیت‌های زمانی نقش. سقف تعداد دوره‌ها یا روزهای آتی را که یک نقش می‌تواند اعطا کند تعیین کنید، کاربران جدید را با یک زمان ثابت (به‌عنوان مثال 2 ساعت) فعال کنید و قابلیت افزودن روز را از وارد کردن تاریخ انقضا تفکیک کنید. مدیران، شعبه‌ها & نقش‌ها
  • SSTP VPN در کنار WireGuard و L2TP/IPsec، برای چندین روتر پشت یک آدرس public یکسان. VPN
  • RouterOS 6 در همه جا کاربرد دارد: ویزارد، Auto-Complete، تحویل پیکربندی، عملیات دسته‌جمعی، Websites & Apps، QoS و لینک‌های VPN. RouterOS 6
  • کنترل والدین در پورتال کاربر: مسدود کردن دسته‌بندی‌ها، اپلیکیشن‌ها و وب‌سایت‌ها، به‌صورت همیشگی یا بر اساس تقویم هفتگی. کنترل والدین
  • امتیازات & پاداش برای تمدیدها و دوستان دعوت‌شده، که برای سرعت بیشتر یا روزهای رایگان هزینه می‌شوند. امتیازات & پاداش
  • برند شما در پنل مدیر، پورتال کاربر و صفحات ورود، با لوگویی که در مرورگر برش می‌دهید. Branding
  • تغییر زبان‌ها، قابلیت مشاهده پلن در پورتال، حالت قالب SMS و نصب تک‌خطی SAMM روی یک روتر MikroTik. زبان‌ها، پلن‌ها، کانتینر MikroTik

5.6

  • ارسال پیکربندی: هر تغییر ارسالی به روترهای شما به‌تفکیک هر روتر ردیابی می‌شود، پس از اتصال مجدد به روترهای آفلاین می‌رسد و به‌طور خودکار برای ارسال مجدد تلاش می‌کند. ارسال پیکربندی
  • داشبوردی که در حدود یک ثانیه باز می‌شود و نوار کناری‌ای که هنگام تغییر صفحات ثابت می‌ماند.

5.5

  • جست‌وجوی Data Log برای تمامی کاربران: چه کسی در هر بازه زمانی به یک آدرس، پورت، پروتکل یا اپلیکیشن دسترسی داشته است. Data Log
  • دسترسی‌های دقیق در بخش ویرایش (حذف کاربران، تمدید، تغییر پلن، پرداخت صورت‌حساب‌ها، اجرای اسکریپت‌های روتر...) و پیش‌نمایش تاریخ انقضای جدید پیش از تمدید. نقش‌ها

5.4

  • امور مالی بر اساس شعبه: هر فاکتور، پرداخت، هزینه و حساب نقدی به یک شعبه تعلق دارد؛ این قابلیت شامل انتخاب‌گر شعبه، تحویل‌های نقدی و گزارش شعبه‌ها است. حسابداری & صورت‌حساب

5.3

  • Sham Cash، یک درگاه پرداخت واحد برای تمامی روش‌های پرداخت، یک Pay page عمومی و Renew online برای 1 تا 12 دوره. پرداخت‌های آنلاین
  • تخفیف‌های صورت‌حساب، افزودنی‌های دارای اپلیکیشن‌های رایگان، گزارش Activations، تغییر نام کاربری و پیش‌پرداخت‌های تمدید. Add-ons

5.2

  • Dynamic Speed Booster، مدیریت دستگاه‌ها روی چندین روتر به‌طور هم‌زمان، افزونه‌ها، لیست قیمت‌ها به‌ازای هر شعبه، فایل‌های کاربر، فیلدهای سفارشی، صفحه Traffic و پاک‌کننده History. Speed Booster، مدیریت دستگاه‌ها

راهنمای شروع به‌کار

نصب

SAMM تمام موارد مورد نیاز — FreeRADIUS، PostgreSQL، nginx، WireGuard، cloudflared و پنج سرویس SAMM — را در یک مرحله نصب می‌کند. نصب‌کننده idempotent است: اجرای مجدد آن، نسخه نصب‌شده را در جای خود به‌روزرسانی می‌کند و هرگز تنظیمات شما را بازنویسی نکرده یا رمز عبور دیتابیس شما را مجدداً تولید نمی‌کند.

راهنمای نصب

همه مراحل همراه با تصویر: Windows (از جمله فعال‌سازی Virtualization در BIOS)، Ubuntu، روتر MikroTik، سرور آماده، لایسنس (پرداخت، اتصال، تمدید)، اتصال روترها از طریق VPN و قابلیت‌های اضافی.

SAMM در هر محیطی اجرا می‌شود — مسیر نصبی را که با شبکه شما سازگار است انتخاب کنید:

پیش‌نیازها

  • یک سرور خام (Fresh): Ubuntu 22.04 / 24.04 / 26.04 LTS یا Debian 12 / 13. فقط Linux نسخه Server — نسخه‌های desktop پشتیبانی نمی‌شوند.
  • دسترسی Root / sudo و اتصال به اینترنت.
  • systemd و میزبان‌ ای که امکان نصب محلی PostgreSQL روی آن وجود داشته باشد (یکی برای شما آماده شده است).

نصب

گزینه A — نصب با یک دستور

در سرور، دستور زیر را اجرا کنید:

curl -fsSL https://samm.securytik.com/install.sh | sudo bash

این اسکریپت bootstrap آخرین بسته انتشار SAMM را از GitHub دانلود و استخراج کرده و نصب‌کننده کامل را به‌طور خودکار اجرا می‌کند. این فرآیند در عرض چند دقیقه انجام می‌شود.

اگر github.com در کشور شما مسدود است، به‌جای آن از mirror میزبانی‌شده توسط Cloudflare استفاده کنید — نصب‌کننده یکسان است و هیچ فایلی از GitHub دریافت نمی‌شود. (دستور استاندارد بالا همچنین مسدود بودن GitHub را تشخیص داده و به‌طور خودکار به این mirror سوئیچ می‌کند.)

curl -fsSL https://dl.securytik.com/install.sh | sudo bash

در هر صورت، پس از اتمام نصب، پورتال admin را باز کرده و با این اعتبارنامه‌ها وارد شوید:

آدرس URL ورودhttp://<your-server>/admin · نام کاربریadmin · رمز عبورadmin

رمز عبور مدیر را بلافاصله پس از اولین ورود تغییر دهید.

نصب

گزینه B — نصب روی Windows (Hyper-V)

SAMM روی Windows در ماشین مجازی Ubuntu 24.04 روی Hyper-V کوچک و مجزای خود اجرا می‌شود که توسط یک نصب‌کننده ایجاد و مدیریت شده است. این VM با IP address اختصاصی خود به شبکه شما می‌پیوندد، بنابراین روترهای MikroTik شما به‌طور مستقیم به SAMM دسترسی دارند — RADIUS آدرس واقعی هر روتر را می‌بیند و CoA disconnects به‌درستی عمل می‌کند — دقیقاً مانند یک سرور Linux.

PowerShell را به‌عنوان مدیر (administrator) باز کنید — نه Command Prompt (cmd): روی دکمه Start راست‌کلیک کرده، Terminal (Admin) یا Windows PowerShell (Admin) را انتخاب کنید و Yes را بزنید. سپس اجرا کنید:

irm https://samm.securytik.com/install-windows.ps1 | iex

اگر samm.securytik.com از این PC در دسترس نباشد، به‌جای آن از mirror میزبانی‌شده در Cloudflare استفاده کنید — این همان نصب‌کننده است. (خودِ نصب‌کننده نیز در صورت شکست در دانلود، به‌طور خودکار به mirror سوئیچ می‌کند.)

irm https://dl.securytik.com/install-windows.ps1 | iex

در هر صورت، پس از اتمام نصب، پورتال admin را باز کرده و با این اعتبارنامه‌ها وارد شوید:

آدرس URL ورودhttp://<SAMM IP>/admin · نام کاربریadmin · رمز عبورadmin
ورود به OS (SSH)samm / samm · Root (console)root / samm

همان مقادیر پیش‌فرض SAMM Server ISO اعمال شده است. پس از اولین ورود، تمامی آن‌ها را تغییر دهید. میان‌بر SAMM Info روی دسکتاپ، این مقادیر را به‌همراه IP address مربوط به SAMM و نحوه دسترسی به VM از طریق SSH مجدداً نمایش می‌دهد.

مواردی که درخواست می‌کند

  1. کدام شبکه SAMM باید به آن متصل شود، زمانی که PC بیش از یک آداپتور متصل دارد. برای انتخاب گزینه پیشنهادی (اتصال سیمی پیش از Wi-Fi) کلید Enter را فشار دهید.
  2. آدرس IP مربوط به SAMM در آن شبکه. یک آدرس آزاد پیشنهاد می‌شود؛ برای پذیرش آن Enter را فشار دهید، آدرس دیگری را تایپ کنید یا dhcp را وارد کنید.

اگر Hyper-V غیرفعال باشد، نصب‌کننده آن را فعال کرده و یک بار درخواست ری‌استارت Windows می‌کند؛ پس از ورود مجدد شما، فرآیند به‌طور خودکار ادامه می‌یابد. باقی مراحل — Multipass، network bridge، VM و خود SAMM — همراه با یک نوار پیشرفت، 10 تا 20 دقیقه زمان می‌برد.

نیازمندی‌ها

  • Windows 10 / 11 Pro, Enterprise یا Education، یا Windows Server 2019 و نسخه‌های جدیدتر (64-bit). Windows Home فاقد Hyper-V است.
  • مجازی‌سازی سخت‌افزاری در BIOS/UEFI فعال باشد (Intel VT-x یا AMD-V). نصب‌کننده این مورد را بررسی می‌کند و در صورت غیرفعال بودن، با پیامی واضح متوقف می‌شود — به فعال‌سازی مجازی‌سازی مراجعه کنید.
  • حداقل 8 GB حافظه، به‌طوری که 4 GB آن برای VM مربوط به SAMM آزاد باشد (حداقل مقدار مورد نیاز 3 GB است؛ سایر ماشین‌های مجازی مانند VMware و VirtualBox از این مقدار کسر می‌شوند) و 40 GB فضای خالی دیسک.
  • استفاده از کابل شبکه> شدیداً توصیه می‌شود. بسیاری از درایورهای Wi-Fi نمی‌توانند یک ماشین مجازی را روی شبکه bridge کنند و در این صورت، هیچ دستگاهی به‌جز خود PC نمی‌تواند به SAMM دسترسی داشته باشد.

پس از نصب

  • پنل مدیر را در http://<SAMM IP>/admin/login باز کنید (میان‌بر SAMM Admin روی دسکتاپ موجود است)، با admin / admin وارد شوید و بلافاصله رمز عبور را تغییر دهید.
  • تنظیمات RADIUS روتر MikroTik خود را به IP مربوط به SAMM (UDP 1812/1813) متصل کنید — Router Wizard در پنل این کار را برای شما انجام می‌دهد.
  • SAMM همراه با Windows و پیش از ورود هر کاربری اجرا می‌شود و PC به‌گونه‌ای تنظیم شده است که هرگز به حالت sleep نرود. در لپ‌تاپ، شارژر را متصل نگه دارید و تنظیمات بستن درب لپ‌تاپ را روی "Do nothing" قرار دهید.
  • برای حذف آن: همان دستور را با -Uninstall اجرا کنید، یا & ([scriptblock]::Create((irm https://samm.securytik.com/install-windows.ps1))) -Uninstall.

نصب

Virtualization را در BIOS/UEFI فعال کنید

SAMM در Windows در یک ماشین مجازی Hyper-V اجرا می‌شود که به قابلیت مجازی‌سازی پردازنده نیاز دارد: Intel Virtualization Technology (VT-x) برای Intel، یا AMD-V — که معمولاً SVM Mode نامیده می‌شود — برای AMD. در بیشتر PCها این قابلیت به‌صورت پیش‌فرض فعال است، اما در برخی از آن‌ها غیرفعال است. هر برند این گزینه را در منوی متفاوتی قرار داده است؛ بنابراین در اینجا مراحل کلی و محل معمول قرارگیری آن آورده شده است.

ابتدا بررسی کنید که آیا در حال حاضر فعال است یا خیر

Task Manager را باز کنید (Ctrl+Shift+Esc) ← Performance ← CPU. در زیر نمودار، عبارت Virtualization: Enabled به معنای فعال بودن این قابلیت است. (اگر Hyper-V از قبل فعال باشد، Windows ممکن است به‌جای آن، پیامی مبنی بر شناسایی یک hypervisor نمایش دهد — این مورد نیز به معنای فعال بودن آن است.)

مراحل کلی

  1. تغییرات خود را ذخیره کرده و PC را restart کنید.
  2. تنظیمات BIOS/UEFI را باز کنید: به‌محض روشن شدن صفحه نمایش، کلید setup را به‌طور مکرر فشار دهید (به جدول مراجعه کنید). در Windows 10/11 همچنین می‌توانید به مسیر Settings → System → Recovery → Advanced startup → Restart now و سپس Troubleshoot → Advanced options → UEFI Firmware Settings → Restart بروید.
  3. در منوی Advanced، Advanced CPU، Processor، Chipset، Security یا Virtualization به‌دنبال Intel Virtualization Technology، Intel VT-x، SVM Mode یا AMD-V بگردید و آن را روی Enabled قرار دهید. (Intel VT-d / AMD IOMMU مورد نیاز نیست.)
  4. ذخیره و خروج (معمولاً F10)، اجازه دهید Windows بالا بیاید و سپس مجدداً نصب‌کننده SAMM را اجرا کنید.

محل معمول قرارگیری

برندکلید Setupمحل معمول
DellF2پشتیبانی مجازی‌سازی → مجازی‌سازی / فعال‌سازی فناوری مجازی‌سازی اینتل
HPF10 (یا Esc، سپس F10)Advanced (یا Security / System Configuration) → Virtualization Technology (VTx)
LenovoF1 / F2 (یا دکمه Novo)Security (ThinkPad) یا Configuration → Intel Virtualization Technology / AMD SVM Technology
ASUSF2 / Delحالت پیشرفته (F7) ← Advanced ← CPU Configuration ← Intel Virtualization Technology یا SVM Mode
AcerF2Advanced (یا Main) → Intel Virtualization Technology
MSIDelOC → CPU Features → Intel Virtualization Tech یا SVM Mode
GigabyteDelTweaker (یا Advanced) → Advanced CPU Settings → Intel Virtualization Technology یا SVM Mode
سرورها (Dell iDRAC, HPE, Supermicro)F2 / F9 / Delتنظیمات Processor ← Virtualization Technology — اغلب از قبل فعال است
یک ماشین مجازی درون یک ماشین مجازی دیگر (مثلاً اجرای Windows در VMware، Proxmox یا Hyper-V) نیازمند فعال‌سازی nested virtualization در هایپروایزر بیرونی است؛ برای مثال، در تنظیمات CPU در VMware، در حالی که VM خاموش است، گزینه "Virtualize Intel VT-x/EPT" را فعال کنید.

نصب

گزینه C — نصب دستی از طریق یک release bundle

آخرین نسخه samm-<version>.tar.gz را از صفحه GitHub Releases دانلود کنید، سپس در سرور:

tar -xzf samm-<version>.tar.gz
cd samm-<version>
sudo bash install.sh

همچنین می‌توانید از یک zip که روی دستگاهی دیگر تولید شده استقرار دهید — نصب‌کننده منبع را با rsync به داخل /opt/samm منتقل می‌کند:

mkdir -p /opt/samm && unzip samm.zip -d /tmp/samm-bundle
sudo bash /tmp/samm-bundle/samm/install.sh

یا مخزن را در مسیر /opt/samm کلون کرده و دستور sudo bash /opt/samm/install.sh را اجرا کنید.

در هر صورت، پس از اتمام نصب، پورتال admin را باز کرده و با این اعتبارنامه‌ها وارد شوید:

آدرس URL ورودhttp://<your-server>/admin · نام کاربریadmin · رمز عبورadmin

رمز عبور مدیر را بلافاصله پس از اولین ورود تغییر دهید.

نصب

گزینه D — نصب با Docker Compose

اگر ترجیح می‌دهید SAMM را به‌صورت container اجرا کنید — همان محصول، اما با بسته‌بندی متفاوت — از توزیع Docker Compose در github.com/mhdhaidarah/samm-docker استفاده کنید. در هر host که Docker نصب باشد:

curl -fsSL https://github.com/mhdhaidarah/samm-docker/releases/latest/download/install.sh | sudo bash

این دستور در صورت نبود Docker آن را نصب می‌کند، یک فایل docker-compose.yml را به‌همراه یک رمز عبور تصادفی و قوی برای پایگاه داده در مسیر /opt/samm-docker/ قرار می‌دهد و stack را اجرا می‌کند. image mhdhaidarah/samm از همان بسته کامپایل‌شده‌ای ساخته شده است که در نصب bare-OS استفاده می‌شود و به‌طور ساختاری closed source است.

Multi-arch — تگ یکسانی برای linux/amd64 و linux/arm64 منتشر می‌شود و نسخه مناسب به‌طور خودکار از روی تگ انتخاب می‌گردد: docker pull روی هر Docker host (سرور Intel/AMD، ARM یا Mac با Apple-silicon) و MikroTik RouterOS 7.23+ روی خود روتر. یک فایل برای تمامی پلتفرم‌ها.

در میزبان‌هایی که انتقال خروجی curl به bash (piping) مجاز نیست (سیستم‌های محدودشده، سیاست‌های سخت‌گیرانه egress)، می‌توانید فایل compose آماده برای اجرا را به‌طور مستقیم دریافت کنید:

git clone https://github.com/mhdhaidarah/samm-docker.git
cd samm-docker
# optional: edit docker-compose.yml and replace change-me-strong-random-string
docker compose up -d

برخی از قابلیت‌ها هنوز در نسخه Docker موجود نیستند (محدودیت لایسنس مرحله‌بندی شده، بارگذاری مجدد پویا FreeRADIUS). صفحات مدیر داخلی WireGuard و Cloudflare Tunnel به‌طور عمدی در نسخه Docker پنهان شده‌اند؛ زیرا این صفحات سرویس‌های systemd در سطح میزبان را مدیریت می‌کنند که از داخل container قابل دسترسی نیستند. اگر به این قابلیت‌های داخلی نیاز دارید، گزینه A یا C را انتخاب کنید، یا cloudflared / wg-quick را مستقیماً روی میزبان Docker در کنار SAMM اجرا کنید. برای مشاهده تمامی نکات نسخه v1 و مسیر نصب دستی، به README نسخه Docker مراجعه کنید.

در Windows (Docker Desktop) — فقط جهت ارزیابی

برای محیط عملیاتی توصیه نمی‌شود. حالت‌های sleep / hibernate / lid-close در Windows باعث توقف containerها می‌شوند؛ boot-restart تنها هنگام شروع WSL اجرا می‌شود (نه هنگام بوت Windows)؛ و cron به‌روزرسانی خودکار روزانه فقط زمانی اجرا می‌شود که WSL فعال باشد. از این روش برای ارزیابی / دمو استفاده کنید و سپس محیط عملیاتی را روی یک Linux VM (مانند Hyper-V، Proxmox، ESXi) یا یک دستگاه فیزیکی کوچک (مثلاً NUC با Ubuntu Server) مستقر کنید.

Docker Desktop را برای Windows نصب کنید (تا در اولین اجرا، backend مربوط به WSL2 را پیکربندی کند). سپس از طریق PowerShell — بدون نیاز به ترمینال WSL — بسته compose را دریافت کرده و stack را اجرا کنید:

mkdir C:\samm-docker
cd C:\samm-docker
curl.exe -fLO https://github.com/mhdhaidarah/samm-docker/releases/latest/download/docker-compose.yml
# optional: notepad docker-compose.yml — replace change-me-strong-random-string with your own password
docker compose pull
docker compose up -d

بوت شدن stack را در Docker Desktop → Containers مشاهده کنید — گروه samm به 8 سرویس گسترش می‌یابد. زمانی که وضعیت همه آن‌ها سبز شد، پورتال مدیر را باز کرده و با این اعتبارنامه‌ها وارد شوید:

آدرس URL ورودhttp://localhost:8000/admin · نام کاربریadmin · رمز عبورadmin

رمز عبور مدیر را بلافاصله پس از اولین ورود تغییر دهید.

اگر یک MikroTik NAS واقعی برای RADIUS به این میزبان Windows درخواست بفرستد (hit کند)، پورت‌های UDP 1812 + 1813 را در Windows Firewall مجاز کنید:

New-NetFirewallRule -DisplayName "SAMM RADIUS" -Direction Inbound -Protocol UDP -LocalPort 1812,1813 -Action Allow

تخریب: docker compose down -v از دایرکتوری نصب (سوییچ -v volume مربوط به postgres و کلید Fernet را پاک می‌کند — اگر داده‌ای اضافه کرده‌اید، ابتدا از آن‌ها نسخه پشتیبان تهیه کنید).

نصب

گزینه E — نصب روی یک روتر MikroTik (RouterOS 7.23+)

همان SAMM، بدون نیاز به Linux box. اگر دستگاه MikroTik شما از بسته container پشتیبانی می‌کند و یک USB drive یا microSD به آن متصل است، می‌توانید کل پشته (stack) را مستقیماً روی روتر اجرا کنید — با همان docker-compose.yml که در سایر محیط‌ها استفاده می‌شود. RouterOS 7.23+ معماری CPU مناسب را به‌طور خودکار از تگ‌های multi-arch image دریافت می‌کند، بنابراین نیازی به دانلود هیچ مورد خاصی برای روتر نیست.

پشتیبانی‌شده: تمامی روترهای MikroTik با قابلیت container — RB5009, hAP ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009 و موارد مشابه (arm64)، به‌علاوه x86 RouterOS و CHR (amd64). پشتیبانی‌نشده: دستگاه‌های armv7 / mipsbe / smips / tile / ppc (hEX, RB750 و مدل‌های قدیمی‌تر RB) — به دلیل عدم پشتیبانی از container یا کمبود RAM/CPU برای stack مربوط به SAMM. RouterOS نسخه 7.23 یا جدیدتر مورد نیاز است (نسخه‌های قدیمی‌تر قادر به انتخاب architecture از یک multi-arch tag نیستند).

روش سریع: یک خط چسبانده‌شده

ترمینال روتر را باز کنید (WinBox → ترمینال جدید، یا SSH) و این خط یک‌خطه را جای‌گذاری نمایید:

/tool fetch url="https://samm.securytik.com/install-routeros.rsc" dst-path=samm-install.rsc; /import samm-install.rsc

این ابزار نسخه RouterOS، CPU و حافظه روتر را بررسی می‌کند، بسته container را نصب می‌کند، حالت container را فعال می‌کند، یک دیسک ext4 با حداقل ظرفیت 30 GB می‌یابد، SAMM را با یک رمز عبور تصادفی و قوی برای پایگاه داده دانلود می‌کند، آن را اجرا کرده و منتظر پاسخ پنل می‌ماند. هرگاه از شما خواسته شد (پس از ری‌بوت، پس از قطع و وصل برق، یا پس از آماده‌سازی دیسک)، همان خط را دوباره جای‌گذاری کنید: هر مرحله بررسی می‌کند که چه مواردی قبلاً انجام شده و ادامه می‌دهد. این ابزار هرگز دیسک را به‌طور خودکار فرمت نمی‌کند و به هیچ‌یک از موارد در حال اجرا دست نمی‌زند.

ترجیح می‌دهید این کار را به‌صورت دستی انجام دهید؟ مراحل زیر را دنبال کنید.

1. آماده‌سازی روتر

بسته container را نصب کنید (از extra_packages.zip در mikrotik.com/download — فایل container-*.npk متناظر را از طریق Files آپلود کرده و سپس دستگاه را ری‌بوت کنید). سپس حالت container را فعال کنید (یک‌بار — این حالت تنها پس از یک hard power cycle فعال می‌شود و نه با soft reboot):

/system device-mode update container=yes
# HARD reboot the router (unplug the power) — a soft /system reboot
# will NOT activate the container feature

2. فرمت و مونت کردن دیسک (ext4)

یک درایو USB یا microSD متصل کنید (حداقل 8 GB توصیه می‌شود — مجموع حجم Postgres و لایه‌های image زیاد است). در روتر:

/disk print
# note the disk slot, e.g. "usb1-part1" or "disk1"
/disk format usb1-part1 file-system=ext4 label=samm

پس از فرمت کردن، بررسی کنید که دیسک mount شده و قابلیت نوشتن داشته باشد:

/disk print detail
# look for "type=ext4" and a mount point like "/usb1-part1"

سپس در روتر مشخص کنید که تصاویر از کجا دانلود شوند (Docker Hub) و در کجا استخراج گردند — بدون این تنظیمات، هر container در SAMM با خطای "download/extract error: no registry url set" مواجه می‌شود:

/container config set registry-url=https://registry-1.docker.io tmpdir=samm/tmp layer-dir=samm/layers
# "samm" = your disk's Mount Point (System > Disks > the disk > Mount Point)
# if layer-dir is refused on your RouterOS version, keep only tmpdir
/ip dns set servers=8.8.8.8,1.1.1.1
:put "ok"
پیغام "no registry url set" یا "not enough disk space to download layer" را مشاهده می‌کنید؟ خطوط بالا را اجرا کنید — پوشه دانلود باید روی دیسک USB/microSD (نقطه mount آن) باشد، نه در حافظه داخلی و محدود روتر. سپس در App → samm تیک Enabled را بردارید، اعمال کنید، دوباره آن را تیک بزنید و اعمال کنید: روتر هر بخش از SAMM را مجدداً دانلود و آن را اجرا می‌کند.

3. فایل compose را کپی کنید

یک فایل برای هر پلتفرم. change-me-strong-random-string (رمز عبور Postgres — در تمام موارد از یک مقدار قوی یکسان استفاده کنید) و change-me-random-token را جایگزین کنید. سپس در WebFig/WinBox به مسیر Container → Apps → + New → YAML رفته، متن را جای‌گذاری کنید، دیسک ext4 مرحله 2 را به‌عنوان storage انتخاب کرده و submit کنید. RouterOS 7.23+ معماری CPU مناسب را به‌طور خودکار از image tags دریافت می‌کند.

در وضعیت "waiting for reverse proxy" متوقف شده‌اید؟ در RouterOS 7.23+، تیک Use HTTPS را در کادر Apps بردارید و مجدداً deploy کنید؛ این گزینه پروکسی web-UI برنامه را کنترل می‌کند و ارتباطی به نحوه دریافت images ندارد.
docker-compose.yml
name: samm

services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U samm -d samm"]
      interval: 10s
      timeout: 5s
      retries: 12

  samm-api:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["api"]
    environment:
      SAMM_ROLE: api
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_HOST: 0.0.0.0
      SAMM_API_PORT: 8000
      SAMM_API_WORKERS: 2
      WA_BRIDGE_URL: http://wa-bridge:8787
      WA_BRIDGE_TOKEN: change-me-random-token
      SAMM_SCOOP_URL: http://samm-scoop:4097
    depends_on:
      postgres:
        condition: service_healthy
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:8000/health >/dev/null || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 30
      start_period: 1800s
    ports:
      - "8000:8000"
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm
      - sammlocales:/opt/samm/app/locales

  samm-scoop:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["scoop"]
    environment:
      SAMM_ROLE: scoop  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_URL: http://samm-api:8000
    depends_on:
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - scoopengine:/opt/samm/runtime/scoop
      - scoophome:/var/lib/samm-scoop

  samm-radius:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["radius"]
    environment:
      SAMM_ROLE: radius  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-worker:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["worker"]
    environment:
      SAMM_ROLE: worker  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    cap_add:
      - NET_RAW
    sysctls:
      - net.ipv4.ping_group_range=0 2147483647
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-notification:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["notification"]
    environment:
      SAMM_ROLE: notification  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      WA_BRIDGE_URL: http://wa-bridge:8787
      WA_BRIDGE_TOKEN: change-me-random-token
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-telegram:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["telegram"]
    environment:
      SAMM_ROLE: telegram  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  wa-bridge:
    image: mhdhaidarah/samm:wa-bridge-latest
    restart: unless-stopped
    environment:
      WA_BRIDGE_TOKEN: change-me-random-token
      TZ: UTC
    depends_on:
      - samm-api
    volumes:
      - wabridge_auth:/data/auth      # multi-device session — persists the QR link

  freeradius:
    image: mhdhaidarah/samm:freeradius-latest
    restart: unless-stopped
    environment:
      POSTGRES_HOST: postgres
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    ports:
      - "1812:1812/udp"
      - "1813:1813/udp"

volumes:
  pgdata: {}
  etcsamm: {}
  sammvar: {}
  sammlogs: {}
  sammlocales: {}
  wabridge_auth: {}      # WhatsApp bridge multi-device session
  scoopengine: {}        # SCOOP AI engine (OpenCode) and the previous one, for rollback
  scoophome: {}          # SCOOP AI's saved AI logins and conversations

4. تأیید و اتصال MikroTik به SAMM

پس از اجرای کانتینرهای SAMM، پورتال admin را در یک مرورگر باز کرده و با این اعتبارنامه‌ها وارد شوید:

آدرس URL ورودhttp://<router-ip>:8000/admin · نام کاربریadmin · رمز عبورadmin

رمز عبور مدیر را فوراً تغییر دهید. RADIUS auth + accounting روی پورت‌های UDP 1812 + 1813 در خود روتر باز هستند، بنابراین RADIUS client در MikroTik می‌تواند با shared secret تنظیم‌شده در System → RADIUS، به 127.0.0.1 اشاره کند.

مسیر استقرار آزمایشی. قابلیت container در RouterOS سبک‌تر از Docker Compose است — DNS نام-سرویس، ترتیب وابستگی‌ها (depends_on) و بازراه‌اندازی‌های زنده (live restarts) رفتار متفاوتی دارند. اگر stack روی سخت‌افزار شما دچار اختلال شد، به اجرای Docker روی یک دستگاه کوچک Linux (مانند NUC، Pi 4 یا Linux VM) در کنار MikroTik بازگردید. همان فایل compose در آنجا با تمامی مفاهیم Compose کار می‌کند.

تداوم اجرای SAMM پس از reboot یا crash

RouterOS کانتینرهای اپلیکیشن را بدون auto-start ایجاد می‌کند. پس از نصب، این مورد را یک‌بار اجرا کنید: هر کانتینر SAMM هم‌زمان با روتر اجرا شده و در صورت توقف، مجدداً راه‌اندازی می‌شود و یک watchdog کوچک، هر کانتینر متوقف‌شده را هر دقیقه اجرا می‌کند.

/container set [find where name~"^app-samm"] start-on-boot=yes restart-policy=always
/system scheduler remove [find name=samm-watchdog]
/system scheduler add name=samm-watchdog start-time=startup interval=1m on-event=":foreach c in=[/container find where name~\"^app-samm\" and stopped] do={/container start \$c}"
:put "ok"

5. به‌روزرسانی — پشتیبان‌گیری و بازیابی دستی

به‌روزرسانی یک اپلیکیشن container در MikroTik باعث حذف پایگاه داده شما می‌شود. RouterOS نمی‌تواند نسخه یک اپلیکیشن نصب‌شده را به‌صورت درجا تغییر دهد — تنها راه، حذف اپلیکیشن و افزودن مجدد آن است و حذف اپلیکیشن، تمام داده‌های ذخیره‌شده توسط آن، از جمله پایگاه داده SAMM را پاک می‌کند. پیش از حذف اپلیکیشن، یک نسخه پشتیبان تهیه کرده و آن را در کامپیوتر خود دانلود کنید. نسخه پشتیبانی که روی روتر باقی بماند، همراه با سایر موارد حذف می‌شود.

برای انتقال نصب MikroTik container به نسخه‌ای جدید:

  1. در SAMM به Tools → Backup بروید، یک نسخه پشتیبان ایجاد کنید و فایل را در کامپیوتر خود دانلود کنید.
  2. در روتر، اپلیکیشن را حذف کرده و مجدداً آن را با نسخه جدید اضافه کنید.
  3. SAMM جدید را باز کنید، به Tools → Backup بروید و فایلی را که دانلود کرده‌اید، بازیابی (restore) کنید.

این مورد فقط برای container MikroTik صدق می‌کند. در Docker (در Linux، Windows یا یک Linux VM) به‌روزرسانی با اجرای docker compose pull و سپس docker compose up -d انجام می‌شود و داده‌های شما دست‌نخورده باقی می‌مانند؛ زیرا volumeها خارج از containerها قرار دارند و حفظ می‌شوند.

نصب

گزینه F — SAMM Server ISO (نصب appliance)

SAMM Server ISO هر دستگاه خالی یا VM را به یک سرور SAMM آماده تبدیل می‌کند: آن را بوت کنید، در تنها صفحه‌ای که نشان می‌دهد DHCP یا IP ثابت را انتخاب کنید، تأیید کنید و بقیه را به آن بسپارید. Ubuntu Server 24.04 LTS (minimized) را نصب می‌کند، نام دستگاه را samm-server می‌گذارد و سپس در اولین بوت SAMM را مستقیماً از خود ISO، با اینترنت یا بدون آن، نصب می‌کند؛ به‌محض آنلاین شدن سرور، یک بار خود را به آخرین نسخه به‌روزرسانی می‌کند. کنسول یک صفحه بوت SAMM و یک بنر ورود با IP سرور، آدرس پنل مدیریت و اطلاعات ورود پیش‌فرض نشان می‌دهد، و فرمان samm-tools با یک کلید به ابزارهای نگهداری دسترسی می‌دهد (بررسی سلامت، پشتیبان‌گیری/بازیابی پایگاه داده، بازنشانی رمز عبور مدیر).

ISO دیسک اول دستگاه را پاک می‌کند. فقط روی سخت‌افزار یا VM اختصاص‌یافته به SAMM بوت کنید. اینترنت لازم نیست: SAMM روی ISO است و در یک شبکه بسته کار می‌کند.

آن را روی یک USB stick (با Rufus، balenaEtcher یا dd) رایت کنید یا به یک VM متصل نمایید، سیستم را بوت کرده و به سؤال مربوط به شبکه پاسخ دهید. اطلاعات ورود پیش‌فرض پس از نصب — پنل: admin / admin، OS: samm / samm یا root / samm — همه آن‌ها را تغییر دهید.

دانلود ISO سرور SAMM 2.5 GB

SHA-2560aa7c06bea4aba8ce7f632aacf243639ac7f78359cc0aa72005d88735930e9be

نصب

مرجع نصب‌کننده

گزینه‌های غیرتعاملی

تمام پرسش‌ها را می‌توان با متغیرهای محیطی پیش‌پاسخ داد تا نصب‌کننده به‌صورت unattended اجرا شود:

متغیرتأثیر
DB_PASSبه جای رمز عبور تولیدشده به‌صورت خودکار، از این رمز عبور database استفاده کنید (فقط برای اولین نصب)
CF_TOKENکانکتور Cloudflare Tunnel را با این توکن Zero Trust نصب کنید
SAMM_HTTP_PORTتعیین اجباری پورت listen در nginx (از اعلان شناسایی پورت-80 صرف‌نظر می‌کند)
SAMM_VERBOSE1 خروجی خام دستور را به‌جای نوار پیشرفت استریم می‌کند
NO_COLOR1 خروجی رنگی را غیرفعال می‌کند
DB_PASS='strong_pw'   sudo bash /opt/samm/install.sh
CF_TOKEN='eyJ...'     sudo bash /opt/samm/install.sh
SAMM_HTTP_PORT=8080   sudo bash /opt/samm/install.sh

آنچه نصب‌کننده پیکربندی می‌کند

نصب‌کننده به‌صورت یک نمایشگر پیشرفت رنگی و زنده اجرا می‌شود — شامل یک نوار درصد و یک چک‌لیست برای هر فاز. خروجی خام هر فاز در /var/log/samm-install.log ثبت می‌شود؛ در صورت بروز خطا، 30 خط آخر چاپ می‌گردد.

جزءجزئیات
FreeRADIUS 3پیکربندی‌شده با بک‌اِند PostgreSQL و کلاینت‌های NAS پویا؛ اعتبارسنجی‌شده با freeradius -CX
PostgreSQLپایگاه داده، schema و تمامی مهاجرت‌های SQL اعمال شدند — هر فایل مهاجرت idempotent است
Python venvتمام وابستگی‌ها از روی requirements.txt ساخته و کاتالوگ‌های ترجمه کامپایل شدند. اگر Python توزیع با باندل کامپایل‌شده مطابقت نداشته باشد، نصب‌کننده به‌طور خودکار یک مفسر standalone منطبق را در /opt/samm/runtime دریافت می‌کند
nginxReverse proxy به‌صورت افزایشی اضافه می‌شود — سایت‌های موجود هرگز حذف نمی‌شوند. در صورت خالی بودن از پورت 80 استفاده می‌کند؛ در غیر این صورت، پورت جایگزینی درخواست می‌کند
5 servicessamm-api، samm-radius، samm-worker، samm-notification، samm-telegram — همگی به‌عنوان systemd units فعال شده‌اند
WireGuardبسته‌ها نصب شده‌اند؛ بعداً از مسیر System → VPN پیکربندی کنید.
cloudflaredBinary همیشه نصب می‌شود؛ توکن تونل در هنگام نصب اختیاری است و یا بعداً از مسیر System → Cloudflare Tunnel اضافه می‌شود.

تمامی اعتبارنامه‌ها — رمز عبور database و کلیدهای امضای session — در اولین نصب به‌طور خودکار تولید می‌شوند.

اعلان‌های تعاملی

هرگونه اعلان در ابتدا، پیش از شروع نصب نمایش داده می‌شود:

  • Cloudflare token — یک توکن Zero Trust connector را برای انتشار آنلاین SAMM بدون باز کردن پورت‌ها جای‌گذاری کنید، یا برای نادیده گرفتن و پیکربندی در آینده، Enter را فشار دهید.
  • پورت HTTP — اگر پورت 80 در حال استفاده باشد، نصب‌کننده آن سایت‌ها را بدون تغییر رها کرده و پورت جایگزینی (پیش‌فرض 8080) درخواست می‌کند.

خلاصه نصب

پس از پایان کار نصب‌کننده، خلاصه‌ای شامل URL مدیر، اطلاعات ورود پیش‌فرض، پورت HTTP انتخاب‌شده، اطلاعات احراز هویت پایگاه داده و مسیرهای فایل config چاپ می‌شود:

============================================================
  SAMM is installed and running.
  Admin portal  : http://localhost/admin/login
  Default login : admin / admin   <- CHANGE AFTER FIRST LOGIN
  Config files  : /etc/samm/samm.yaml  /etc/samm/api.env
============================================================

به‌روزرسانی

برای به‌روزرسانی، سورس جدید را دریافت کرده و نصب‌کننده را مجدداً اجرا کنید:

git -C /opt/samm pull        # or unpack a newer release bundle
sudo bash /opt/samm/install.sh

اجرای مجدد، منبع را دوباره همگام‌سازی می‌کند، venv را ارتقا می‌دهد، تمامی مهاجرت‌ها را مجدداً اعمال می‌کند، تنظیمات FreeRADIUS و nginx را بارگذاری کرده و هر سرویس را مجدداً راه‌اندازی می‌کند. فایل‌های تنظیمات و پورت HTTP انتخاب‌شده در اولین نصب حفظ می‌شوند.

نکته SAMM می‌تواند خود را به‌روزرسانی کند — به Licensing & updates مراجعه کنید. به‌روزرسانی‌های خودکار را فعال کنید یا آن‌ها را در صورت نیاز از مسیر System → License اعمال کنید.
DB ایزوله و راه دور & SAMM تنها شامل SAMM است — FreeRADIUS، PostgreSQL، nginx و سایر موارد در زمان نصب از مخازن apt بالادستی دریافت می‌شوند، بنابراین در نصب‌های air-gapped، این بسته‌ها باید از پیش آماده (pre-stage) شوند. برای استفاده از PostgreSQL راه دور، پس از نصب، DSN را در /etc/samm/samm.yaml تنظیم کنید.

راهنمای شروع به‌کار

گام‌های نخست

پنج مرحله کوتاه، یک نصب تازه را به نقطه‌ای می‌رساند که مشترکان بتوانند متصل شده و صورت‌حساب آن‌ها صادر شود.

1 · اولین ورود

  1. http://<your-server>/admin/ را باز کنید (اگر پورت HTTP در خلاصه نصب 80 نیست، از پورت ذکرشده استفاده کنید) یا URL تونل Cloudflare خود را باز کنید.
  2. با نام کاربری admin و رمز عبور admin وارد شوید.
  3. رمز عبور را فوراً از مسیر System → Admins یا از منوی پروفایل در نوار بالا تغییر دهید.

2 · اولین روتر خود را اضافه کنید

  1. به مسیر MikroTik → NAS بروید و روی Add Router کلیک کنید.
  2. IP روتر، یک shortname و یک RADIUS shared secret را وارد کنید. برای دستگاه‌های MikroTik، در صورت تمایل می‌توانید جهت همگام‌سازی لحظه‌ای دستگاه، اطلاعات API را اضافه کنید.
  3. در MikroTik، یک RADIUS server تعریف کنید که به میزبان SAMM (پورت‌های 1812/1813) اشاره کند و از همان shared secret استفاده نماید، سپس RADIUS را برای PPP / Hotspot فعال کنید.

نیازی به ری‌استارت FreeRADIUS نیست — SAMM کلاینت‌های NAS را به‌صورت پویا از دیتابیس شناسایی می‌کند. برای مشاهده روند کامل به Routers (NAS) مراجعه کنید، یا اجازه دهید ویزارد تنظیمات پیکربندی MikroTik را برای شما انجام دهد.

3 · ایجاد پلن

یک پلن سرعت، محدودیت‌ها و قیمتی را که ارائه می‌دهید تعریف می‌کند. به کاربران ← پلن‌ها ← پلن جدید بروید. مرجع کامل فیلدها: پلن‌ها & محدودیت‌ها.

4 · افزودن مشترک

به مسیر Users → New customer بروید، اطلاعات ورود را وارد کرده و یک پلن انتخاب کنید. کاربر می‌تواند بلافاصله متصل شود. برای دسترسی prepaid hotspot، به‌جای آن voucher cards ایجاد کنید.

5 · لایسنس خود را فعال کنید

یک نصب تازه در حالت unregistered و در پایین‌ترین سطح اجرا می‌شود. برای رفع محدودیت‌ها، مسیر System → License را باز کرده و لایسنس را فعال کنید — به Licensing & tiers مراجعه کنید.

روال روزمره افزودن روترها → ایجاد پلن‌ها → افزودن مشترکان یا کارت‌ها → تماشای داشبورد → ثبت پرداخت‌ها در حسابداری.

راهنمای شروع به‌کار

مهاجرت از سیستمی دیگر

از سیستم صورت‌حساب RADIUS دیگری استفاده می‌کنید؟ SAMM داده‌های آن را می‌خواند و پلن‌ها و مشترکین شما را بازسازی می‌کند تا نیازی به وارد کردن مجدد اطلاعات نباشد. مشترکین رمز عبور سرویس و تاریخ انقضای فعلی خود را حفظ می‌کنند، به این معنی که دقیقاً مانند قبل به اتصال خود ادامه می‌دهند.

به مسیر Tools → Export / Import بروید و سیستم قدیمی خود را در بخش Migrate from another system انتخاب کنید. این بخش نیز مانند سایر ابزارهای Tools، فقط برای superadmin است.

چه مواردی آپلود شوند

سیستم قدیمیفایلمنبع دریافت
SAS4 / Radius Manager .sql یا .sql.gz یک نسخه پشتیبان MySQL از پایگاه داده قدیمی
Super Speed Radius .sql یا .sql.gz یک نسخه پشتیبان MySQL از پایگاه داده قدیمی
Pro Radius .xlsx یا .csv لیست مشترکین صادرشده‌ی آن — آن سیستم هیچ امکان خروجی گرفتن برای پشتیبان را ارائه نمی‌دهد

پشتیبان‌های Database اغلب چندین گیگابایت هستند؛ این موضوع مشکلی ندارد، فایل را به‌صورت عادی آپلود کنید. پشتیبان‌های فشرده‌شده نیازی به استخراج اولیه ندارند.

نحوه عملکرد

  1. فایل را آپلود کنید. هنوز چیزی نوشته نشده است.
  2. پیش‌نمایش را بررسی کنید. این بخش لیست پلن‌ها و مشترکانی که ایجاد خواهند شد را نمایش می‌دهد، در مورد هر موردی که باید نادیده گرفته یا اصلاح شود هشدار می‌دهد و پیش از نهایی کردن، مجموع آن‌ها را با لایسنس شما تطبیق می‌دهد.
  3. تعیین کنید که برای نام‌های کاربری موجود در SAMM چه اتفاقی بیفتد — آن‌ها را نادیده گرفته و رکورد SAMM را حفظ کنید، یا نام و اطلاعات تماس آن را از سیستم قدیمی به‌روزرسانی کنید.
  4. Import. هر ردیف به‌طور مستقل نوشته می‌شود، بنابراین یک ردیف نامعتبر هرگز باعث بازگشت (roll back) سایر ردیف‌ها نمی‌شود.

موارد دریافتی

  • پلن‌ها — نام، سرعت‌ها، قیمت، مدت‌زمان و سهمیه ترافیک در جایی که سیستم قدیمی آن‌ها را ثبت می‌کند.
  • Subscribers — نام کاربری، رمز عبور سرویس، نام، جزئیات تماس، تاریخ انقضا، پلن، IP استاتیک و MAC.
  • مشترکانی که در سیستم قدیمی غیرفعال بوده‌اند، غیرفعال باقی می‌مانند.

صورت‌حساب‌ها، فاکتورها، کارت‌های پیش‌پرداخت، تیکت‌ها، حسابداری و لاگ‌های admin به‌طور عمدی وارد نمی‌شوند — این موارد متعلق به مدل داده‌ای سیستم قدیمی هستند و به‌ندرت به‌طور دقیق مطابقت دارند.

مقادیری که با ستون خود مطابقت ندارند

پایگاه‌های دادهٔ واقعی نامرتب‌اند: نشانی‌ای که در کادر ایمیل تایپ شده، یادداشتی در فیلد موبایل، شماره تلفنی که با صفحه‌کلید عربی نوشته شده. SAMM هر مقدار را در برابر آنچه ستونش باید نگه دارد بررسی می‌کند. هر چه جا نیفتد بیرون از آن فیلد می‌ماند و به‌جای آن در یادداشت‌های مدیریتی مشترک ذخیره می‌شود، با برچسب منشأ آن — بنابراین چیزی از دست نمی‌رود و هیچ فیلدی آلوده نمی‌شود. پیش‌نمایش به شما می‌گوید چند مقدار تحت تأثیر قرار گرفته است.

Pro Radius جزئیات

Pro Radius مشترکین را صادر می‌کند اما پلن‌ها را خیر؛ بنابراین SAMM پلن‌ها را بر اساس سطح سرویس هر مشترک استخراج کرده و سرعت را از نام آن می‌گیرد (سرویسی با نام "4MBPS" به یک پلن 4 Mbps تبدیل می‌شود). سه مورد در آن فایل وجود ندارند و روی مقادیر پیش‌فرض منطقی تنظیم شده‌اند که باید بعداً آن‌ها را بررسی کنید:

  • Duration — روی 1 ماه تنظیم شود. تاریخ انقضای واقعی هر مشترک بدون تغییر وارد می‌شود، بنابراین این تنظیمات فقط بر تمدیدهای آتی تأثیر می‌گذارد.
  • سرعت آپلود — به‌گونه‌ای تنظیم کنید که با نرخ دانلود مطابقت داشته باشد.
  • Price — روی 0 تنظیم کنید.
بررسی پلن‌ها پیش از صدور صورت‌حساب پس از import کردن Pro Radius، بخش Plans را باز کرده و قیمت و دوره زمانی واقعی را برای هر یک تنظیم کنید. تا زمانی که این کار را انجام ندهید، هزینه این پلن‌ها صفر محاسبه می‌شود.

نکات کاربردی

  • می‌توانید این عملیات را با اطمینان بیش از یک بار اجرا کنید. وارد کردن مجدد همان فایل، به‌جای ایجاد موارد تکراری، از کاربرانی که پیش‌تر ثبت شده‌اند صرف‌نظر می‌کند.
  • لایسنس شما همچنان معتبر است. اگر تعداد مشترکین موجود در فایل بیشتر از حد مجاز سطح (tier) شما باشد، این موضوع در پیش‌نمایش ذکر شده و تعداد مورد پذیرش اعلام می‌شود — در این حالت می‌توانید لایسنس خود را ارتقا دهید یا بخشی از لیست را وارد کنید.
  • اگر در حال وارد کردن داده‌ها به نصبی هستید که پیش از این دارای داده‌های واقعی است، ابتدا یک نسخه پشتیبان تهیه کنید

پلن‌های مشترکین &

پلن‌ها & محدودیت‌ها

یک پلن تعریف سرویسی است که به مشترکین تخصیص می‌یابد و سرعت، محدودیت‌ها و قیمت را تعیین می‌کند. پیش از افزودن کاربران، پلن‌ها را ایجاد کنید.

یک نصب تازه به‌صورت پیش‌فرض شامل 9 پلن آماده‌به‌کار است — هشت سطح سرعت ماهانه به‌علاوه یک پلن محدودکننده "Expired" — تا بتوانید بلافاصله فروش را آغاز کنید یا پلن‌های خودتان را بسازید. فرآیند Seeding فقط در اولین نصب اجرا می‌شود و هرگز پلن‌هایی را که افزوده‌اید بازنویسی نمی‌کند.

ایجاد پلن

  1. به مسیر Users → Plans بروید.
  2. روی پلن جدید کلیک کنید.
  3. فرم را پر کرده و روی ذخیره پلن کلیک کنید.

هر محدودیت یک کلید دوحالته است — فقط مواردی را که نیاز دارید فعال کنید. همان پنجره، یک پلن موجود را ویرایش می‌کند (منوی ⋮ ردیف → Edit را باز کنید).

فیلدهای پلن

فیلدمعنا
نامنام منحصر‌به‌فرد پلن، به‌طور مثال Home-50M
قیمتدر صورت استفاده از صورت‌حساب، هزینه به‌ازای هر دوره صورت‌حساب محاسبه می‌شود
سرعت دانلود / آپلودمثلاً 50M، 512K، 1G — به‌عنوان rate limit در MikroTik اعمال می‌گردد
نشست‌های هم‌زمانتعداد دستگاه‌هایی که می‌توانند به‌طور هم‌زمان در این پلن آنلاین باشند. به‌صورت پیش‌فرض 1 — تا زمانی که اتصال اول برقرار است، ورود دوم رد می‌شود. برای حالت نامحدود 0 را تنظیم کنید. نشست‌هایی که گزارش‌دهی آن‌ها متوقف شده است نادیده گرفته می‌شوند، بنابراین قطع شدن اتصال هرگز باعث مسدود شدن دسترسی مشترک نمی‌شود
محدودیت: تاریخ انقضااشتراک در بازه زمانی مشخصی پس از فعال‌سازی (روز/ماه/ساعت/دقیقه) به پایان می‌رسد
محدودیت: سهمیهسقف کلی داده (ترکیبی، فقط دانلود یا فقط آپلود) برای کل اشتراک
محدودیت: Uptimeسقفی برای مجموع زمان اتصال — مجموع مدت‌زمان تمامی نشست‌ها
محدودیت: مصرف روزانهسقف مصرف داده‌ای که هر روز در زمان تنظیم‌شده برای daily-reset بازنشانی می‌شود
پنجره نامحدودافزودن سریع یک speed window — ویرایشگر کامل در صفحه Speed Windows پلن قرار دارد
IP poolنام اختیاری RADIUS Framed-Pool برای تخصیص آدرس
تمدید خودکاربه جای تغییر پلن یا قطع اتصال، در زمان انقضا دوره جدیدی را آغاز کنید

چهار محدودیت

هر محدودیت مستقل و اختیاری است. هنگامی که چندین محدودیت تنظیم شده باشند، SAMM آن‌ها را با ترتیبی ثابت — expiration → quota → uptime → daily — بررسی می‌کند و اولین موردی که به پایان برسد، تعیین‌کننده اقدام است.

محدود کردنردیابی‌هادر هنگام اتمام
تاریخ انقضازمان تقویمی از لحظه‌ی فعال‌سازیتغییر به پلن دیگر یا قطع اتصال
سهمیهمجموع بایت‌های مصرف‌شدهتغییر به پلن دیگر یا قطع اتصال
مدت زمان فعال بودنمجموع ثانیه‌های نشستتغییر به پلن دیگر یا قطع اتصال
روزانهتعداد بایت‌ها از زمان آخرین بازنشانی روزانهمحدود کردن سرعت (Throttle) — بر اساس سرعت‌های واردشده یا از طریق یک پلن کندتر — تا بازنشانی روزانه بعدی

برای هر محدودیت، اتفاقی که پس از اتمام حجم رخ می‌دهد را تعیین کنید: یک پلن بعدی را برای انتقال مشترک انتخاب کنید یا آن را روی — disconnect — قرار دهید. محدودیت روزانه به‌جای قطع اتصال، سرعت را محدود (throttle) می‌کند: به‌صورت پیش‌فرض، سرعت‌های محدودشده را مستقیماً وارد می‌کنید (فیلدهای download / upload)، یا یک پلن "next" کندتر را انتخاب می‌کنید؛ در هر دو حالت، مشترک در بازنشانی روزانه بعدی به‌طور خودکار به پلن اصلی باز می‌گردد.

بازه های سرعت

یک speed window سرعت پایه پلن را در ساعات مشخصی بازنویسی می‌کند — برای مثال، یک بازه زمانی با سرعت نامحدود پس از نیمه‌شب. برای باز کردن ویرایشگر Speed Windows روی ردیف یک پلن کلیک کنید؛ این ویرایشگر امکان کنترل بر اساس روزهای هفته را فراهم کرده و از بازه‌های زمانی که از نیمه‌شب عبور می‌کنند پشتیبانی می‌کند. در صورت تطابق چندین بازه، بازه‌ای با highest-speed اولویت دارد.

توجه مشترکانی که سرعت آن‌ها محدود شده یا سهمیه آن‌ها به پایان رسیده است، از بازه‌های زمانی افزایش سرعت مستثنی می‌شوند — SAMM هرگز در حالی که محدودیتی اعمال شده است، سرعت را افزایش نمی‌دهد.

دو مفهوم از میزان استفاده

SAMM میزان استفاده را در دو جایگاه مجزا نگه می‌دارد و هرگز آن‌ها را با یکدیگر ترکیب نمی‌کند:

  • شمارنده‌های قابل بازنشانی — وضعیت هر محدودیت. توسط بازنشانی مدیر و بازنشانی روزانه صفر می‌شود.
  • شمارنده‌های صورت‌حساب — مجموع‌های کل مادام‌العمر و غیرقابل بازنشانی. این مقادیر هرگز صفر نمی‌شوند تا دقت گزارش‌ها و فاکتورها حفظ شود.

مدیریت پلن‌ها

لیست پلن‌ها سرعت، تعداد مشترکین، محدودیت‌های فعال و بازه‌های زمانی سرعت هر پلن را نمایش می‌دهد. از منوی ⋮ هر ردیف می‌توانید پلن را ویرایش کنید، بازه‌های زمانی سرعت آن را باز کنید، آن را فعال/غیرفعال کنید، به مشترکین آن بروید یا آن را حذف کنید (تنها در صورتی که مشترکی نداشته باشد). ویرایش تمدید خودکار، امکان اعمال تغییرات برای تمامی مشترکین فعلی را فراهم می‌کند.

Duplicate یک پلن را دقیقاً — شامل سرعت‌ها، محدودیت‌ها، بازه‌های زمانی سرعت و قیمت — با نامی جدید کپی می‌کند؛ این روش بسیار سریع‌تر از بازسازی دستی یک تعرفه برای تغییر تنها یک عدد است. اگر نامی که وارد می‌کنید قبلاً استفاده شده باشد، از اولین عدد آزاد بعدی استفاده می‌شود.

کاربران کدام پلن‌ها را مشاهده می‌کنند

کلید Users can see this plan در هر پلن (و همچنین به‌عنوان یک عملیات دسته‌جمعی در لیست Plans) تعیین می‌کند که کاربران کدام پلن‌ها را در پورتال خود مشاهده و انتخاب کنند. این گزینه برای هر پلن در ابتدا غیرفعال است، بنابراین تا زمانی که انتخابی نکنید چیزی نمایش داده نمی‌شود؛ کاربر همیشه پلن خود را مشاهده می‌کند.

پلن‌های مشترکین &

مشترکین

یک subscriber (مشتری / کاربر) یک حساب PPPoE یا Hotspot است که از طریق SAMM احراز هویت می‌شود. به هر subscriber دقیقاً یک پلن اختصاص داده می‌شود.

ایجاد مشترک

  1. به Users بروید و روی New customer کلیک کنید.
  2. فرم را تکمیل و ذخیره کنید — مشترک می‌تواند بلافاصله متصل شود.
فیلدمعنا
نام کاربری *نام کاربری PPPoE / Hotspot — باید یکتا باشد
رمز عبور *رمز عبور ورود (ذخیره شده برای احراز هویت RADIUS با پروتکل‌های PAP/CHAP)
نام / نام خانوادگینام مشترک
تلفن همراه / ایمیل / آدرساطلاعات تماس — برای اعلان‌ها و صورت‌حساب‌ها استفاده می‌شود
پلن *پلن سرویس برای تخصیص
جایگزینی تاریخ انقضاتاریخ انقضای دستی اختیاری به‌جای تاریخ محاسبه‌شده‌ی پلن
تمدید خودکارتمدید خودکار دوره پلن در زمان انقضا

ایجاد چندین مشترک به‌طور هم‌زمان

New batch users مجموعه‌ای از حساب‌های کاربری شماره‌گذاری‌شده را در یک مرحله ایجاد می‌کند — روشی معمول برای تحویل دسته‌ای از اطلاعات ورود به یک استقرار روستایی، هتل یا نمایندگی فروش. تعداد، شماره شروع و تعداد ارقام برای تکمیل (مثلاً 3 برای 001، 002، …) را انتخاب کنید؛ سایر موارد — پلن، تاریخ انقضا، تمدید خودکار — یک‌بار تعیین شده و برای همه آن‌ها اعمال می‌شود. همه این حساب‌ها یک رمز عبور مشترک دارند.

گزینه invoice choice برای هر کاربر در دسته به‌طور جداگانه اعمال می‌شود؛ بنابراین، اجرای عملیات برای 50 کاربر یا منجر به صدور 50 فاکتور می‌شود یا هیچ، و مبلغ کل پیش از تایید نهایی نمایش داده می‌شود.

لیست مشترکین

صفحه Users فهرستی از تمامی مشترکین را به‌همراه یک نقطه وضعیت برای مشاهده سریع، پلن اختصاص‌یافته و مقدار باقی‌مانده از هر محدودیت نمایش می‌دهد — میزان مصرف روزانه با یک نوار پیشرفت، سهمیه باقی‌مانده، uptime باقی‌مانده و روزهای باقی‌مانده. فیلتر بر اساس وضعیت (All / Active / Suspended / Expired / Online) یا جست‌وجو بر اساس username، نام یا شماره موبایل امکان‌پذیر است.

نشان تغییر پلن یک نشان واحد، پلن مشترک است. دو نشان که با یک فلش به هم متصل شده‌اند به این معناست که مشترک به سقف بازدید روزانه خود رسیده و به‌طور موقت روی یک پلن throttle قرار گرفته است — در بازنشانی روزانه بعدی، پلن آن‌ها به حالت اصلی باز می‌گردد.

مدیریت مشترک

برای هر اقدام مربوط به هر مشترک، روی ردیف مورد نظر راست‌کلیک کنید یا از منوی ⋮ استفاده کنید:

عملیاتعملکرد
مشاهده / ویرایشصفحه جزئیات را باز کنید، یا اطلاعات تماس، رمز عبور و تاریخ انقضا را ویرایش کنید
فعال / غیرفعالتعلیق حساب — مشترکین آنلاین قطع می‌شوند
تمدید پلنمدت‌زمان پلن را به زمان باقی‌مانده اضافه می‌کند؛ اگر پلن دارای قیمت باشد، یک فاکتور صادر می‌کند. گزینه Plan به کاربر منقضی‌شده اجازه می‌دهد در همان مرحله با پلنی متفاوت بازگردد — برای تمدید مشابه قبل، آن را روی "Keep the current plan" باقی بگذارید
بازنشانی Uptime / Quota / Dailyصفر کردن شمارنده محدودیت انتخاب‌شده
نحوه استفادهنمودارهای مصرف و تاریخچه نشست‌ها را باز کنید
حذفحذف مشترک و تمامی تاریخچه او — ابتدا نشست‌های فعال قطع می‌شوند
نحوه اعمال اقدامات بازنشانی‌ها، تغییرات پلن و تمدیدها در یک لاگ حسابرسی قرار گرفته و توسط tick samm-radius — معمولاً طی چند ثانیه — اعمال می‌شوند. اگر مشترک آنلاین باشد، SAMM یک refresh زنده نیز ارسال می‌کند. به CoA & live changes مراجعه کنید.

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

نمای Usage

اکشن Usage صفحه جزئیات ترافیک یک مشترک را به‌همراه انتخاب‌گر بازه زمانی 7d / 14d / 30d / 90d باز می‌کند. این صفحه سه مقدار اصلی را گزارش می‌دهد — ترافیک امروز (به تفکیک آپلود/دانلود و دقایق آنلاین)، ترافیک این ماه و مجموع زمان آنلاین در ماه. در پایین آن‌ها، یک نمودار ترافیک روزانه برای آپلود در مقابل دانلود و جدول کامل تاریخچه نشست‌ها قرار دارد: زمان شروع و پایان، مدت‌زمان، بایت‌های دانلود و آپلود، NAS و علت پایان هر نشست.

عملیات دسته‌جمعی

برای تغییر مالک، تاریخ انقضا، وضعیت یا تمدید خودکار برای چندین مشترک به‌طور هم‌زمان — یا حذف دسته‌جمعی آن‌ها — از ابزارهای Bulk Changes و Bulk Delete استفاده کنید. برای ایجاد انبوه مشترکین از طریق یک صفحه گسترده، از Export / Import استفاده کنید.

محدود کردن یک مشترک به روترهای خاص

وقتی تنظیم ورود شعبه فعال باشد، کاربر از طریق روترهای شعبه خود، شعبه‌های بالاتر و دفتر مرکزی وارد می‌شود (به Admins, branches & roles مراجعه کنید). از طریق فرم ویرایش می‌توانید دسترسی کاربر (یا یک گروه کامل از کارت‌ها) را به روترهای خاصی محدود کنید: در صورت عدم انتخاب هیچ موردی، روترهای شعبه اعمال می‌شوند؛ در صورت انتخاب یک یا چند مورد، ورود تنها از طریق آن روترها پذیرفته می‌شود که این محدودیت در RADIUS اعمال می‌گردد. تغییر این مجموعه، هر نشست فعال روی روترهایی که دیگر مجاز نیستند را قطع می‌کند.

تغییر نام کاربری، تمدید به‌همراه پیش‌نمایش

تغییر نام کاربر از صفحه مربوط به او (دکمه Username در کنار Edit) یا منوی لیست Users، پس از تایپ نام کاربری فعلی جهت تأیید، امکان‌پذیر است. نشست‌ها، میزان مصرف و لاگ‌ها به نام جدید منتقل می‌شوند، نشست فعال قطع می‌شود تا روتر ورود قبلی را فراموش کند و نام کاربری جدید به کاربر اطلاع داده می‌شود، مگر اینکه تیک آن کادر را بردارید. هنگام تمدید یا تغییر پلن، انتخاب کنید که دوره جدید از تاریخ انقضا ادامه یابد یا از امروز شروع شود، و پیش از ذخیره، تاریخ انقضای جدید را مشاهده و تنظیم کنید. تمدید همچنین می‌تواند شامل پیش‌پرداخت باشد.

لینک Wireless

برای مشترکی که به یک access point از MikroTik متصل است، صفحه کاربر می‌تواند اطلاعات رادیو را به‌طور مستقیم نمایش دهد: سیگنال (همراه با توصیفی ساده از کیفیت آن)، سرعت در هر جهت، CCQ و uptime. تنها رادیوهای MikroTik قابل شناسایی هستند.

فایل‌های کاربر & فیلدهای سفارشی

آپلود کارت‌های شناسایی، پاسپورت‌ها، قراردادها و عکس‌ها برای کاربر از صفحه جزئیات او؛ پیش‌نمایش فایل‌ها بدون نیاز به دانلود، با قابلیت نمایش به مشترک در پورتال شخصی او در بخش Files. Custom fields — که یک‌بار در Settings تعریف می‌شوند — امکان افزودن داده‌های اضافی به کاربران، فایل‌ها، پلن‌ها، گروه‌های کارت، تیکت‌ها و add-onها را فراهم می‌کنند.

پلن‌های مشترکین &

کارت‌های Hotspot

برای دسترسی پیش‌پرداخت Hotspot، به‌جای تعریف تک‌تک مشترکین، مجموعه‌ای از voucher cards ایجاد کنید. هر کارت شامل یک جفت نام کاربری/رمز عبور با سرعت و محدودیت‌های اختصاصی است که می‌توان آن‌ها را در تعداد هزارتایی تولید و برای توزیع چاپ کرد.

ایجاد گروه کارت

  1. به مسیر Users → Hotspot Cards بروید و روی New group کلیک کنید.
  2. فرم زیر را پر کرده و روی Create group کلیک کنید — SAMM اعتبارنامه‌ی هر کارت را به‌طور خودکار تولید می‌کند.
بخشفیلدها
شناسهنام منحصر‌به‌فرد گروه، توضیحات، پیشوند اختیاری نام کاربری، تعداد کارت‌هایی که باید ایجاد شوند (تا 10,000 عدد)
اطلاعات احراز هویتفرمت نام کاربری و رمز عبور (اعداد / حروف / alphanumeric) و طول آن‌ها
محدودیت سرعتسرعت دانلود و آپلود — 256k، 6M، 1G؛ 0 = نامحدود
محدود کردن انتقالنامحدود، سقف ترکیبی، یا سقف‌های مجزای دانلود/آپلود (MB / GB / TB)
محدودیت‌های زمانیسقف Uptime، انقضا پس از اولین ورود، و تاریخ انقضای گروه "valid until"

expiration از اولین ورود هر کارت محاسبه می‌شود، در حالی که valid until یک تاریخ انقضای قطعی است — کارت‌ها پس از این تاریخ، فارغ از اینکه فعال شده باشند یا خیر، قابل استفاده نخواهند بود.

مدیریت گروه

منوی ⋮ یک گروه را باز کنید تا تمام کارت‌ها را به‌طور هم‌زمان فعال یا غیرفعال کنید، تاریخ انقضای گروه را تمدید کنید، کارت‌های بیشتری به این گروه اضافه کنید یا جزئیات آن را ویرایش کنید. کارت‌های تک‌گانه را می‌توان از صفحه جزئیات کارت، بازنشانی (سهمیه، مدت‌زمان فعال یا تاریخ انقضا) یا غیرفعال کرد.

Duplicate group هر تنظیم را دقیقاً کپی کرده و همان تعداد کارت را با کدهای جدید ایجاد می‌کند — هر کد کارت تنها می‌تواند متعلق به یک کارت باشد، بنابراین یک کپی، یک چاپ جدید است و نه کلونی از نسخه قدیمی. این سریع‌ترین راه برای سفارش مجدد یک دسته ووچر است که به اتمام رسیده است.

یک کارت اضافه کنید یا فهرستی وارد کنید

+ Card، در فهرست کارت‌ها و صفحه گروه، یک کارت با نام کاربری، رمز عبور و نام اختیاری که می‌نویسید، به گروهی که از فهرست جستجو انتخاب می‌کنید اضافه می‌کند. در صفحه گروه، Import cards یک فایل CSV یا Excel (نام کاربری، رمز عبور و نام اختیاری) وارد می‌کند؛ پیش از ذخیره می‌بینید چه چیزی اضافه و چه چیزی رد می‌شود.

طرح‌های کارت

Hotspot Cards → Card designs را باز کنید تا کارت چاپی را طراحی کنید: اندازه، تصویر پس‌زمینه، لوگوی شما و جای نام کاربری، رمز عبور، قیمت، اعتبار و کد QR. کد QR کارت را با یک اسکن در Hotspot وارد می‌کند. ده طرح آماده برای شروع هست؛ آن‌ها را مثل طرح‌های خودتان ویرایش، کپی یا حذف کنید.

یک طرح یا برگه A4 از کارت‌ها (Export) است یا یک رسید حرارتی 80 یا 58 mm برای چاپ سریع. هر گروه طرح خودش را برای هر کدام دارد؛ گروهی که طرح ندارد کارت داخلی را چاپ می‌کند و چاپ سریع از رسید آماده Thermal Pro استفاده می‌کند.

وضعیت‌های کارت

وضعیتمعنا
استفاده‌نشدهایجاد شده اما هرگز وارد نشده است
فعالدر حال استفاده، در محدوده مجاز
تمام شدیک محدودیت (سهمیه، مدت‌زمان فعال یا تاریخ انقضا) به پایان رسیده است
غیرفعالبه‌صورت دستی غیرفعال شده

چاپ ردیابی &

یک گروه را باز کنید تا کارت‌های آن را مشاهده کنید، آن‌ها را برای توزیع به‌صورت PDF چاپ کنید (چیدمان چاپ از لوگوی ISP شما در تنظیمات استفاده می‌کند) و میزان مصرف هر کارت را بررسی کنید. ترافیک کارت‌ها همچنین در Reports در زبانه Cards نمایش داده می‌شود و هر گروه نمای حسابداری مخصوص به خود را دارد.

به روتر گفته می‌شود چه مقدار از هر کارت باقی مانده است، پس صفحه وضعیت Hotspot زمان و داده باقی‌مانده را نشان می‌دهد و روتر با تمام شدن کارت جلسه را پایان می‌دهد.

پلن‌های مشترکین &

سرویس خودکار — مهمانان به‌طور مستقل ثبت‌نام می‌کنند

دقیقاً برعکس ووچر: هیچ‌کس چیزی چاپ نمی‌کند و هیچ‌کس پشت میز منتظر نمی‌ماند. بازدیدکننده به hotspot شما متصل می‌شود، در صفحه ورود روی Register کلیک می‌کند، نام و شماره موبایل خود را تایپ می‌کند و SAMM یک کد تأیید را از طریق SMS، WhatsApp یا ایمیل برای او ارسال می‌کند. کاربر کد را در همان صفحه وارد کرده و آنلاین می‌شود — و شما یک رکورد نام‌دار و قابل استخراج از تمام کسانی که از شبکه مهمان استفاده کرده‌اند، خواهید داشت.

مکان‌های رایج: رستوران‌ها و کافه‌ها، هتل‌ها و مهمان‌پذیرها، نمایشگاه‌ها و بازارهای تجاری، کنفرانس‌ها، مراکز خرید، کلینیک‌ها و اتاق‌های انتظار، باشگاه‌های ورزشی، فضاهای کاری مشترک، سالن‌های زیبایی، سالن‌های انتظار فرودگاه، استادیوم‌ها، پردیس‌ها، کتابخانه‌ها، نمایشگاه‌های خودرو، تالارهای عروسی، تفرجگاه‌ها و کمپ‌ها.

روشن کردن

  1. ابتدا یک کانال ارسال تنظیم کنید. Notification Center → SMS یا WhatsApp را فعال کرده و یک پیام آزمایشی برای خود ارسال کنید. تا زمانی که یکی از کانال‌ها فعال نشود، هیچ قابلیت دیگری کار نخواهد کرد.
  2. Self Service → Settings: گزینه Allow guests to register themselves را فعال کنید، کانال‌های مورد نظر را انتخاب نمایید و مدت‌زمان اعتبار رمز عبور و زمان انتظار مهمان برای درخواست رمز جدید را تنظیم کنید.
  3. بخش Passcodes come from را در گروه کارت Self Service بدون تغییر باقی بگذارید، مگر اینکه دلیل خاصی برای تغییر آن داشته باشید — این گروه سرعت و تعداد دستگاه‌هایی که می‌توانند از یک passcode مشترک استفاده کنند را تعیین می‌کند.
  4. زبانه Register را برای هر طرح ورود (login design) که استفاده می‌کنید فعال کنید — در ادامه ببینید. این مرحله‌ای است که کاربران معمولاً فراموش می‌کنند.

صفحه ورود — مرحله‌ای که کاربران نادیده می‌گیرند

زبانه Register دارای طراحی مجزا برای هر ورود است و به‌صورت پیش‌فرض غیرفعال است. مسیر MikroTik Manager → the router → Login Page را باز کنید، طراحی مورد استفاده خود را ویرایش کرده و گزینه Allow Self Service را علامت بزنید. شما می‌توانید هر جمله‌ای را که کاربر مهمان در همان صفحه می‌بیند تغییر دهید — برچسب زبانه Register، خط مقدمه، برچسب دو فیلد، دکمه و پنج پاسخ («رمز عبور شما در راه است»، «شما قبلاً یک حساب دارید»، «لطفاً بعداً دوباره تلاش کنید»، «ما نتوانستیم آن را ارسال کنیم»، «ثبت‌نام در دسترس نیست»).

سپس Push را فشار دهید — و پس از هر به‌روزرسانی SAMM، مجدداً آن را فشار دهید. صفحات ورود Hotspot روی حافظه flash خود روتر قرار دارند، نه روی SAMM. به‌روزرسانی SAMM باعث ارسال مجدد آن‌ها نمی‌شود، بنابراین روتر به ارائه صفحه قدیمی خود — بدون زبانه Register — ادامه می‌دهد تا زمانی که شما دوباره آن‌ها را ارسال کنید. SAMM در زبانه Login Page زمانی که یک روتر صفحاتی قدیمی‌تر از نسخه نصب‌شده شما را ارائه می‌دهد، به شما هشدار می‌دهد و صفحه Self Service نام هر روتر را که نمی‌تواند این زبانه را نمایش دهد ذکر کرده و امکان اصلاح همه آن‌ها را به‌طور هم‌زمان فراهم می‌کند.

قوانین جلوگیری از سوءاستفاده

  • برای هر شماره، تنها یک رمز عبور فعال. درخواست مجدد در حالی که یک کد هنوز معتبر است، به‌جای ارسال کد جدید، به کاربر اعلام می‌کند که پیام‌های خود را بررسی کند.
  • سپس یک دوره انتظار را تعیین می‌کنید تا پیش از آن، آن شماره بتواند درخواست جدیدی ثبت کند.
  • اعتبار از لحظه ارسال رمز عبور محاسبه می‌شود، نه از اولین ورود — بنابراین کدی که یک هفته بدون استفاده مانده باشد، دیگر کار نمی‌کند.
  • سقف روزانه‌ای که توسط لایسنس شما تعیین شده است (به پایین مراجعه کنید). پس از اتمام این سقف، از مهمانان خواسته می‌شود بعداً دوباره تلاش کنند و رمزهای عبور صادرشده همچنان فعال می‌مانند.
  • هر تلاش بر اساس MAC address دستگاه به همان صورتی که روتر گزارش کرده است ثبت می‌شود — چیزی که یک کاربر مهمان نمی‌تواند آن را از طریق مرورگر خود جعل کند.

لایسنس

سرویس Self Service بر اساس جدا از پلن شما لایسنس شده است که تعداد رمزهای عبور صادر شده در روز توسط هر نصب را تعیین می‌کند و در تاریخ خود به‌طور خودکار تمدید می‌شود — بنابراین می‌توانید از پلن Free به همراه یک افزونه پولی، یا از پلن Unlimited بدون هیچ افزونه‌ای استفاده کنید. هر نصب 10 مورد در روز به‌صورت رایگان دریافت می‌کند؛ Light این مقدار را به 50، Heavy به 200 افزایش می‌دهد و Max محدودیت را حذف می‌کند. به قیمت‌گذاری مراجعه کنید.

صفحه Self Service مقدار استفاده شده / مجاز برای امروز را نمایش می‌دهد و در صورت اتمام سهمیه، به‌طور واضح اطلاع‌رسانی می‌کند. از طریق داشبورد خود در securytik.com خرید یا تمدید کنید، و یا از مسیر System → License درخواست دهید تا توسط مدیر SecuryTik تأیید شود. رمز عبوری که ارسال نشود، از سهمیه شما کسر نمی‌شود.

پلن‌های مشترکین &

افزونه‌ها & ووچرها

افزونه (add-on) قابلیت اضافه‌ای است که کاربر برای تعداد روزهای مشخصی، علاوه بر پلن خود خریداری می‌کند: speed boost، unmetered days یا night boost برای ساعات انتخابی. آن‌ها را در مسیر Users → Add-ons ایجاد کنید.

  • یک add-on را از صفحه کاربر بفروشید، به کاربران اجازه دهید آن را از پورتال کاربر یا ربات Telegram خریداری کنند (پرداخت از طریق wallet)، یا voucher codes یک‌بار مصرف چاپ کنید تا کاربران آن‌ها را در پورتال یا ربات فعال کنند.
  • برنامه‌های رایگان: گزینه Unmetered را فعال کرده و برنامه‌ها را بر اساس دسته‌بندی انتخاب کنید؛ در این حالت، تنها ترافیک این برنامه‌ها در سهمیه کاربر محاسبه نمی‌شود. اگر تمامی برنامه‌ها را غیرفعال بگذارید، کل ترافیک Unmetered خواهد بود. این قابلیت به Data Log نیاز دارد.
  • کنترل والدین و VPN: یک افزونه می‌تواند کنترل والدین یا VPN از طریق SAMM را در طول مدت خود روشن کند؛ هر دو در پایان آن خودبه‌خود خاموش می‌شوند. مدت را با یک مقدار و یک واحد (روز، هفته یا ماه تقویمی) تعیین کنید.
  • کاربران افزودنی‌های فعال و تاریخ‌های پایان آن‌ها را در صفحه پلن‌های خود مشاهده می‌کنند. هزینه افزودنی اعطا شده به کاربرِ یک نماینده، مانند تمدید، از نماینده دریافت می‌شود.
  • هر شعبه می‌تواند قیمت‌های افزونه اختصاصی خود را در Accounting → Price Lists داشته باشد.

تخفیفات صورت‌حساب

درصد یا مبلغ ثابتی را به‌عنوان تخفیف برای یک فاکتور باز، همراه با دلیل، از طریق فاکتور مربوطه یا فاکتورهای کاربر اعمال کنید. یک تخفیف دائمی می‌تواند در تمدیدهای بعدی کاربر تکرار شود. هر نقش دارای حداکثر میزان تخفیفی است که می‌تواند اعطا کند.

پلن‌های مشترکین &

امتیازات & پاداش

به کاربران وفادار پاداش دهید و به آن‌ها اجازه دهید دوستان خود را دعوت کنند. امتیازها غیرفعال هستند تا زمانی که آن‌ها را در مسیر Users → Points & rewards فعال کنید.

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

امتیازها بر اساس فاکتورهای پرداخت‌شده و هر کدام تنها یک‌بار محاسبه می‌شوند. در صورت لغو فاکتور، امتیازات مربوط به آن بازپس گرفته می‌شوند. همچنین می‌توانید امتیازها را به‌صورت دستی اضافه یا کسر کنید و موجودی‌های برتر و درخواست‌های عضویت را در همان صفحه مشاهده نمایید.

پلن‌های مشترکین &

کنترل والدین

خانواده‌ها خط خود را از طریق پورتال کاربر محافظت می‌کنند. این قابلیت برای هر کاربر غیرفعال است تا زمانی که شما آن را فعال کنید: Parental control را در فرم افزودن یا ویرایش کاربر (دقیقاً بعد از Allow Password Change)، یا برای چندین کاربر به‌طور هم‌زمان از طریق عملیات دسته‌جمعی در لیست Users فعال کنید.

موارد قابل مسدودسازی توسط کاربر

  • دسته‌بندی‌ها: محتوای بزرگسالان، مواد مخدر، قمار، دوست‌یابی، خشونت و نفرت، و سرویس‌های proxy یا VPN که برای دور زدن فیلتر استفاده می‌شوند. مسدود کردن محتوای بزرگسالان، SafeSearch را نیز در موتورهای جستجوی بزرگ و YouTube فعال می‌کند.
  • اپلیکیشن‌ها و وب‌سایت‌ها از همان کاتالوگ Websites & Apps که با لوگوهای رسمی خود نمایش داده می‌شوند.
  • زمان: همیشه، یا بر اساس تقویم هفتگی (به‌عنوان مثال شب‌های مدرسه بعد از 22:00).
چراغ‌های روتر SAMM برای هر کاربر قوانین مجزا نمی‌نویسد. هر روتر چند قانون مشترک دریافت می‌کند و کاربران با شروع و پایان زمان‌بندی‌هایشان، در این قوانین قرار گرفته یا از آن‌ها خارج می‌شوند تا بار روتر حتی با وجود خانواده‌های زیاد، پایین بماند. برای مسدودسازی اپلیکیشن‌ها، روتر باید توسط SAMM (دسترسی API) مدیریت‌شده باشد.

پلن‌های مشترکین &

VPN از طریق SAMM

کاربرانی که انتخاب می‌کنید ترافیک خود را به‌جای خط اینترنت خود روتر از سرور SAMM شما خارج می‌کنند. این ترافیک از تونلی می‌گذرد که هر روتر از قبل با SAMM دارد (WireGuard، L2TP/IPsec یا SSTP، نگاه کنید به VPN)، پس چیزی روی گوشی یا رایانه کاربر نصب نمی‌شود.

اجازه دادن

  • برای هر کاربر: گزینه VPN از طریق SAMM را در فرم افزودن یا ویرایش کاربر روشن کنید، یا برای چند کاربر به‌طور همزمان از اقدامات گروهی فهرست کاربران.
  • به‌عنوان افزونه: در کاربران → افزونه‌ها، VPN را در یک افزونه روشن کنید و آن را برای چند روز، هفته یا ماه بفروشید. در طول مدت افزونه فعال است و پس از آن خودبه‌خود خاموش می‌شود.

آنچه کاربر انتخاب می‌کند

کاربران مجاز یک صفحه VPN در پورتال کاربر با سه گزینه دارند:

  • خاموش — هیچ چیزی از VPN عبور نمی‌کند.
  • همه ترافیک — همه برنامه‌ها و وب‌سایت‌ها از VPN عبور می‌کنند و DNS کاربر هم از آن عبور می‌کند.
  • برنامه‌های انتخابی — فقط برنامه‌ها و وب‌سایت‌هایی که کاربر از همان فهرست وب‌سایت‌ها و اپلیکیشن‌ها انتخاب می‌کند؛ بقیه روی خط محلی می‌ماند.
اگر تونل قطع شود کاربران هرگز به‌خاطر VPN اینترنت خود را از دست نمی‌دهند: اگر روتر نتواند به SAMM برسد، ترافیک آنها تا برگشتن تونل به خط خود روتر برمی‌گردد. آدرس‌های محلی (LAN شما و محدوده‌های CGNAT) هرگز از VPN عبور نمی‌کنند. روی RouterOS 6 و 7 کار می‌کند؛ روتر باید توسط SAMM مدیریت شود.

VPN خارجی: خروج از طریق ارائه‌دهندهٔ دیگر

در System → VPN → External VPN SAMM می‌تواند کاربران VPN را به‌جای خط خودش از طریق یک VPN تجاری خارج کند، بنابراین VPN حتی وقتی SAMM در شبکهٔ محلی شما بدون آدرس عمومی است هم کار می‌کند.

  • NordVPN: یک توکن دسترسی از حساب NordVPN خود جای‌گذاری کنید و تعداد سرورهای باز را انتخاب کنید (تا 10 برای هر حساب). SAMM کلید را می‌گیرد و سرورها را خودش انتخاب می‌کند.
  • هر ارائه‌دهندهٔ دیگر (ProtonVPN، Mullvad، Surfshark، سرور خودتان): فایل‌های WireGuard .conf آن را بارگذاری کنید، یک اتصال برای هر فایل. خطوط اسکریپت در فایل نادیده گرفته می‌شوند و هرگز اجرا نمی‌شوند.
  • اتصال‌ها هر اتصال را زنده نشان می‌دهد: وضعیت، آخرین دست‌دادن، ترافیک و کاربران. هر کاربر روی یک اتصال (همان آدرس خروجی) می‌ماند؛ وزن کاربران را بین اتصال‌ها تقسیم می‌کند.
  • اگر یک اتصال از کار بیفتد، کاربرانش تا برگشتن آن از خط SAMM خارج می‌شوند؛ حذف یا خاموش کردن یک اتصال کاربرانش را به اتصال‌های دیگر منتقل می‌کند.
SAMM به یک آدرس عمومی نیاز دارد VPN فقط وقتی مفید است که سرور SAMM شما از جایی متفاوت با کاربران به اینترنت وصل شود، مثلاً سروری در یک دیتاسنتر. اگر SAMM پشت NAT در همان شبکه باشد، ترافیک از همان خط خارج می‌شود؛ به همین دلیل فرم کاربر و فرم افزونه یک هشدار نشان می‌دهند، مگر اینکه یک اتصال VPN خارجی کار کند.

راهنمای شروع به‌کار

راه‌اندازی سرور شما

سرور ندارید؟ ما برایتان راه‌اندازی می‌کنیم. آن را از داشبورد SAMM سفارش می‌دهید، پرداخت می‌کنید و یک سرور آماده SAMM روی دامنهٔ .com اختصاصی خود، با نام خودتان، دریافت می‌کنید. چیزی برای نصب وجود ندارد.

آنچه دریافت می‌کنید

  • یک سرور ابری و یک دامنه .com، در سه اندازه: 6 هسته، 12 GB RAM و 200 GB SSD سالانه 100 دلار؛ 8 هسته، 24 GB RAM و 300 GB SSD با 200 دلار؛ 12 هسته، 48 GB RAM و 400 GB SSD با 300 دلار. اندازه را در گام اول انتخاب می‌کنید.
  • HTTPS روی دامنهٔ شما؛ آدرس خود سرور هرگز منتشر نمی‌شود.
  • SAMM نصب‌شده و با نام شرکت شما برندسازی‌شده، با ترخیص شما متصل و در اولین ورود فعال.
  • یک ایمیل با آدرس پنل شما (https://your-domain/admin) و یک رمز عبور قوی مدیر.

سفارش دهید

  1. وارد samm.securytik.com شوید و Dashboard → Get a server را باز کنید.
  2. یک نام برای سرور و تعداد کاربران انتخاب کنید، سپس دامنهٔ .com خود را جستجو کنید یا یکی از پیشنهادها را انتخاب کنید.
  3. با هر روش پرداختی که در صفحهٔ پرداخت نشان داده می‌شود پرداخت کنید. سفارش دو ساعت منتظر پرداخت می‌ماند؛ پس از آن لغو می‌شود و باید سفارش جدیدی ثبت کنید.
  4. پس از پرداخت همه‌چیز خودکار است. وقتی سرور آماده شد، ایمیلی با آدرس و ورود شما دریافت می‌کنید.

دسترسی SSH

از Dashboard → Servers می‌توانید ورود SSH خود را با رمز عبور، کلیدهای عمومی، یا هر دو بسازید. راهنمای گام‌به‌گام SSH برای Termius، Windows، Ubuntu و macOS در همان صفحه است.

تمدید حداقل یک روز پیش از پایان سال تمدید کنید؛ تمدید هفت روز قبل باز می‌شود. اگر سرور تمدید نشود، سرور، دامنه و داده‌های روی آن پایان می‌یابد. نسخه‌های پشتیبان خودتان را هم نگه دارید.

پلن‌های مشترکین &

CGNAT & مجموعه‌های IP

هر دو زیر Plans قرار دارند، کنار مجموعه‌های آدرس خود روتر.

CGNAT Pools

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

  1. Plans → CGNAT Pools را باز کنید و یک مجموعه اضافه کنید: آدرس‌های عمومی، تعداد کاربرانی که یک آدرس را به اشتراک می‌گذارند، و تعداد پورت‌های هر کاربر.
  2. خط ظرفیت نشان می‌دهد پیش از ذخیره، چند کاربر جا می‌شوند.
  3. آن را به روتر بفرستید. SAMM قوانین NAT را می‌نویسد و تاریخچهٔ اینکه کدام کاربر کدام آدرس و پورت‌ها را داشته نگه می‌دارد؛ Lookup همین تاریخچه را می‌خواند.

مجموعه‌های IP

با یک مجموعهٔ IP، SAMM آدرس هر کاربر را خودش برای او تخصیص می‌دهد، به‌ازای هر روتر و طرح، پس روتر به مجموعهٔ آدرس خاص خود نیاز ندارد. آدرس با پایان نشست آزاد می‌شود. وقتی مجموعه پر باشد، مجموعهٔ خود روتر جای آن را می‌گیرد.

عملیات روزانه

نگهداری داده & Lookup

بسیاری از کشورها از ISP می‌خواهند سوابق اتصال را نگه دارد و بگوید کدام مشترک در یک زمان مشخص از یک آدرس استفاده کرده است. نگهداری داده هر دو کار را انجام می‌دهد. تا زمانی که آن را روشن نکنید خاموش است.

روشنش کنید

  1. System → Settings → Data retention را باز کنید و آن را روشن کنید.
  2. مدت نگهداری نشست‌ها را تعیین کنید (به‌طور پیش‌فرض دو سال). نشست‌ها حتی برای کاربرانی که حذف می‌کنید، در این مدت نگه داشته می‌شوند.
  3. اختیاری: یک فایل رمزنگاری‌شدهٔ روزانه از طریق SFTP، SMB یا NFS به NAS خود بفرستید. آن را با gpg --decrypt باز کنید.

Lookup: چه کسی از این آدرس استفاده کرد؟

  1. Overview → Data Log → Data retention را باز کنید.
  2. آدرس عمومی، پورت و زمان را از درخواستی که دریافت کرده‌اید وارد کنید.
  3. یک شماره پرونده وارد کنید (SAMM پیشنهاد می‌دهد CASE-1، CASE-2…). نتیجه کاربر، آدرس MAC، روتر و نشست را نشان می‌دهد؛ می‌توان در آن جستجو کرد و آن را صادر کرد.
گزارش Lookup هر جستجو در گزارش Lookup ثبت می‌شود، همراه با اینکه چه کسی، چه زمانی و با چه شماره پرونده‌ای، و قابل ویرایش نیست. با CGNAT، Lookup از بلوک‌های پورت مجموعه‌های CGNAT شما استفاده می‌کند.

شبکه & روترها

روترهای سایر برندها

علاوه بر MikroTik، SAMM با روترهای Cisco، Huawei، Nokia و ZTE به‌عنوان NAS (BNG) کار می‌کند.

  • روتر را اضافه کنید زیر Devices → Manager و نوع آن را انتخاب کنید. فرم ورود درست را می‌خواهد: API برای MikroTik، و SSH برای سایر برندها.
  • صفحهٔ راه‌اندازی: SAMM خطوط پیکربندی آن روتر را تولید می‌کند، آماده برای چسباندن.
  • سرعت و قطعی اتصال از خصوصیات RADIUS مخصوص هر برند استفاده می‌کنند، تا تغییرات طرح به روتر برسد.
  • Data Log از سوابق ترافیک خود روتر (NetFlow یا IPFIX).
  • CGNAT روی Cisco: SAMM قوانین را از طریق SSH می‌فرستد و Lookup مانند MikroTik کار می‌کند. روترهای Cisco می‌توانند از طریق L2TP هم به SAMM متصل شوند.
  • صفحهٔ دستگاه: CPU، حافظه، دما، مدت روشن بودن و نمودارها، مانند MikroTik.

شبکه & روترها

FTTH & OLTs

SAMM از طریق SSH، OLTهای V-SOL، Huawei (SmartAX)، ZTE (C300 و C320) و Nokia (ISAM) را می‌خواند.

  • صفحهٔ FTTH زیر Devices → FTTH: فهرست OLTها با فیلتر، ستون‌ها و خروجی گرفتن، مانند Wireless.
  • هر ONU با سیگنال نوریِ خودش، و ONUهایی که منتظر افزوده شدن هستند.
  • ONUهای متصل به کاربرانشان به‌صورت خودکار.
  • قفل خط مشترک: SAMM خطی را که هر کاربر از آن متصل می‌شود یاد می‌گیرد و می‌تواند ورود او را به همان خط نگه دارد.
  • صفحهٔ دستگاه OLT: CPU، حافظه، دما، مدت روشن بودن و نمودارها.

شبکه & روترها

روترها (NAS)

یک NAS (Network Access Server) روتر است که مشترکین را از طریق RADIUS در SAMM احراز هویت می‌کند. هر روتر که ترافیک مشترکین را منتقل می‌کند، به یک رکورد NAS نیاز دارد.

افزودن روتر

  1. به مسیر MikroTik → NAS بروید و روی Add Router کلیک کنید.
  2. فیلدهای زیر را پر کرده و ذخیره کنید.
فیلدمعنا
IP / hostname دستگاه NASآدرس روتر، آن‌گونه که برای میزبان SAMM نمایش داده می‌شود
نام کوتاهیک برچسب کاربرپسند که در سراسر UI نمایش داده می‌شود
نوعmikrotik قابلیت همگام‌سازی زنده دستگاه و ارسال تنظیمات (config push) را فعال می‌کند؛ سایر انواع تنها از RADIUS پشتیبانی می‌کنند
رمز عبوررمز مشترک RADIUS — باید دقیقاً با روتر مطابقت داشته باشد، در غیر این صورت احراز هویت شکست می‌خورد
پورت CoAپورت UDP که SAMM بسته‌های Change-of-Authorization را به آن ارسال می‌کند (پیش‌فرض MikroTik 3799)
پورت / کاربر / رمز عبور APIاعتبارنامه‌های MikroTik API که SAMM برای خواندن اطلاعات دستگاه و اعمال تنظیمات از آن‌ها استفاده می‌کند
نیازی به ری‌استارت نیست SAMM کلاینت‌های NAS را به‌صورت پویا از دیتابیس شناسایی می‌کند — افزودن یا حذف یک روتر هرگز نیازی به ری‌استارت FreeRADIUS ندارد.

لیست NAS

تمام روترها در یک جدول نمایش داده می‌شوند — ID، NAS IP / hostname، shortname، نوع، یک secret ماسک‌شده (برای مشاهده روی سلول کلیک کنید)، پورت‌های CoA و API، و نتیجه ping لحظه‌ای به‌همراه زمان رفت‌وبرگشت. کادر جستجو امکان فیلتر بر اساس IP، shortname یا توضیحات را فراهم می‌کند.

منوی ⋮ در هر ردیف شامل عملیات مربوط به هر روتر است — مشاهده دستگاه و به‌روزرسانی اطلاعات (فقط MikroTik)، ویرایش، ارسال تنظیمات RADIUS (فقط MikroTik) و حذف. باز کردن ردیفی از نوع mikrotik مستقیماً به صفحه دستگاه آن هدایت می‌کند.

شناسایی همسایگان

برای اسکن شبکه به‌منظور یافتن دستگاه‌های MikroTik (از طریق پروتکل neighbor-discovery شرکت MikroTik) و افزودن آن‌ها به‌عنوان رکوردهای NAS بدون تایپ دستی هر آدرس، روی Discover neighbors کلیک کنید. یک روتر شناسایی‌شده می‌تواند از طریق IP یا به‌صورت Auto-added اضافه شود؛ این قابلیت یک بوت‌استرپ تک‌کلیکی است که یک کاربر مدیریتی SAMM روی روتر ایجاد می‌کند، یک IP مدیریتی را اعمال کرده و bridge پیش‌فرض کارخانه را پاک می‌کند.

قابلیت Auto-add برای روترهای جدید است راه‌اندازی تک‌کلیکی برای دستگاه‌های نو (یا ری‌ست شده) در نظر گرفته شده است — در روترهایی که پیش‌تر پیکربندی شده‌اند، این عمل می‌تواند تنظیمات موجود را بازنویسی کرده یا آن‌ها را مختل کند.

اعمال تنظیمات RADIUS روی روتر

برای رکوردهای MikroTik NAS، منوی ⋮ در هر ردیف گزینه Push RADIUS config را ارائه می‌دهد — SAMM به‌جای آنکه تنظیمات را به‌صورت دستی وارد کنید، روتر را از طریق API برای شما پیکربندی می‌کند. شما IP سرور SAMM (که باید از طریق روتر قابل دسترسی باشد) و پورت‌های auth، accounting و CoA را تأیید می‌کنید؛ سپس SAMM یک ورودی RADIUS را در روتر ایجاد یا جایگزین می‌کند:

تنظیماتمقدار
توضیحاتSAMM — برچسبی که SAMM برای یافتن و به‌روزرسانی این ورودی در آینده از آن استفاده می‌کند
سرویسhotspot, ppp
آدرس / رمز عبورمیزبان SAMM، با shared secret مربوط به این رکورد NAS
زمان انتظار3000 ms
CoA ورودیتأیید شد، روی پورت CoA که تأیید کردید

پنجره پس از پایان push، لاگ نتایج را نمایش می‌دهد.

پیکربندی سمت MikroTik

اگر در عوض روتر را به‌صورت دستی پیکربندی کنید:

  • یک سرور RADIUS اضافه کنید که به میزبان SAMM اشاره کند، با همان shared secret، و برای PPP / Hotspot فعال شود.
  • از پورت auth 1812 و پورت accounting 1813 استفاده کنید.
  • پذیرش CoA ورودی روی پورت 3799.
  • بازه زمانی Interim-Update حسابداری را روی حدود 5 minutes (پیش‌فرض ویزارد SAMM) تنظیم کنید — این مقدار تعیین می‌کند که SAMM هر چند وقت یک‌بار میزان مصرف را جمع‌آوری و محدودیت‌ها را ارزیابی کند؛ بازه‌های کوتاه‌تر، تأخیر در اعمال محدودیت را کاهش می‌دهند اما ترافیک حسابداری بیشتری ایجاد می‌کنند.

دستگاه‌های فقط برای نظارت

روتری که به‌عنوان monitor اضافه شده است، در فهرست MikroTik ظاهر شده و ping و sync می‌شود، اما هیچ نقش RADIUS ندارد — بنابراین نمی‌تواند مشترکین را احراز هویت کند. از این قابلیت برای نظارت بر روترهایی که NAS مشترکین نیستند استفاده کنید.

پشتیبان SAMM

اگر SAMM پاسخگو نباشد، روترهای انتخابی شما کاربران را به‌طور مستقل وارد سیستم می‌کنند — از طریق یک نسخه غیرفعال از هر کاربر فعال که SAMM روی آن‌ها همگام‌سازی کرده است. هنگامی که SAMM مجدداً در دسترس قرار گیرد، همه از طریق آن متصل می‌شوند. این قابلیت به‌صورت پیش‌فرض خاموش است؛ آن را برای هر روتر از مسیر Settings → Advanced فعال کنید.

پشتیبان پس از تأخیری که تنظیم کرده‌اید یا به‌صورت دستی فعال می‌شود و روتر آن را از طریق Telegram گزارش می‌دهد. یک جدول وضعیت، حالت همگام‌سازی هر روتر، تعداد کاربرانی که همگام‌سازی آن‌ها ناموفق بوده و دلیل آن را نمایش می‌دهد و روترهایی را که نسخه پشتیبان آن‌ها قدیمی شده یا نمی‌توانند به آدرس health در SAMM دسترسی داشته باشند، علامت‌گذاری می‌کند.

شبکه & روترها

مدیریت دستگاه‌های MikroTik

وقتی یک روتر دارای اعتبارنامه‌های API باشد، SAMM آن را به‌طور مستقیم از طریق MikroTik API مدیریت می‌کند — بدون نیاز به WinBox یا SSH. بخش MikroTik فهرستی زنده از تمامی روترها است و هر دستگاه صفحه‌ای با جزئیات و پانزده زبانه باز می‌کند که از طریق مرورگر شما، تقریباً تمام بخش‌های RouterOS را پیکربندی می‌کند.

مانیتور MikroTik

MikroTik → Monitor برای هر روتر یک کارت را به‌صورت شبکه‌ای نمایش می‌دهد. هر کارت — که توسط samm-worker به‌روزرسانی شده و هر 30 ثانیه به‌صورت زنده بازجویی (poll) می‌شود — وضعیت دسترسی (نقطه)، نسخه RouterOS، بار CPU و تعداد هسته‌ها، میزان مصرف حافظه، تعداد نشست‌های فعال، uptime و زمان آخرین نمونه‌برداری را گزارش می‌کند.

یک کارت یا با NAS برچسب می‌خورد (روتری که مشترکان را نیز از طریق RADIUS احراز هویت می‌کند) یا با monitor (دستگاهی که فقط برای پایش اضافه شده است). Add MikroTik یک دستگاه جدید ثبت می‌کند؛ Refresh now یک پرس‌وجوی فوری را اجبار می‌کند. کارت‌های فقط پایش یک منوی راست‌کلیک دارند — Open، Edit، Refresh Info، Delete.

دستگاه‌های Ubiquiti

هنگام افزودن یک مانیتور، نوع آن را انتخاب می‌کنید: MikroTik، Ubiquiti airOS یا Ubiquiti UniFi access point. دسترسی به دستگاه‌های Ubiquiti از طریق SSH و با اطلاعات ورود خود دستگاه انجام می‌شود؛ صفحه Probe آنچه را که دستگاه گزارش می‌کند نمایش می‌دهد. یک UniFi access point در صفحات Wireless برای هر رادیو در یک ردیف نمایش داده می‌شود — شامل کانال، پهنای باند و SSIDs، کلاینت‌های متصل به همراه سیگنال، نویز و نرخ انتقال، و شبکه‌های همسایه‌ای که شناسایی می‌کند — و در بهینه‌ساز Wi-Fi و برنامه‌ریز کانال مشارکت می‌کند.

هر پلن اجازه استفاده از سه مانیتور برای هر روتر را می‌دهد (پلنی با روترهای نامحدود، مانیتورهای نامحدود دارد)، بنابراین نظارت بر access pointهای شما هرگز از سهمیه روتر شما کم نمی‌کند.

کاربران تعریف‌شده در روتر

SAMM اطلاعات ورود PPP، کاربران Hotspot و کاربران User Manager را که در روتر (RouterOS 6 و 7) ذخیره شده‌اند، شناسایی کرده و در صفحه روتر فهرست می‌کند. پیش از هر اقدامی، هر ردیف مواردی را که SAMM ایجاد خواهد کرد نمایش می‌دهد: username، password، name، mobile، پلن (که در صورت ایجاد توسط SAMM با علامت new مشخص می‌شود)، تاریخ انقضا، limits، MAC و IP. نام‌ها، شماره تلفن‌ها و تاریخ‌های پایان که در کامنت‌های روتر به زبان عربی یا انگلیسی نوشته شده‌اند نیز خوانده می‌شوند. کاربران مورد نظر را علامت زده و وارد کنید: این فرآیند در پس‌زمینه اجرا شده و با ورود هر کاربر، فهرست Users پر می‌شود.

صفحه دستگاه — پانزده زبانه

هر دستگاه را برای دسترسی به صفحه مدیریت کامل آن باز کنید. زبانه‌ها در چهار گروه قرار دارند.

پایش

زبانهآنچه نمایش داده می‌شود
نمای کلیاطلاعات دستگاه، اطلاعات سیستم و نمودارهای تاریخچه عملکرد (CPU، حافظه و نشست‌ها در طول زمان)
اینترفیس‌هاهر اینترفیس به‌همراه وضعیت لحظه‌ای آن و تاریخچه ترافیک هر اینترفیس
وب‌سایت‌ها & اپلیکیشن‌هاسه نمای فرعی: Monitor (وب‌سایت‌ها و & اپلیکیشن‌های مشاهده‌شده در روتر به‌همراه تاریخچه ترافیک)، QoS (اولویت‌بندی بر اساس اپلیکیشن، در ادامه)، و App Filter (مسدودسازی محتوا بر پایه DNS از کاتالوگ)

مدیریت دستگاه‌ها

زبانه Manager → General صفحه تنظیمات عمومی دستگاه است: Identity (نام روتر)، Time (ساعت، منطقه زمانی و NTP) و Tools (reboot، ping و سایر عملیات تک‌کلیکی روتر).

پیکربندی شبکه

زبانهآنچه پیکربندی می‌کنید
BridgeBridgeهای LAN ایجاد کنید و تعیین کنید که کدام اینترفیس‌های فیزیکی (پورت‌ها) به هر یک اختصاص یابند
VLANافزودن و مدیریت اینترفیس‌های VLAN
IPسه زبانه فرعی — Static (آدرس‌های static و dynamic)، DHCP client (دریافت آدرس از upstream)، DHCP server (تخصیص آدرس‌ها، همراه با جدول اختصاص لحظه‌ای)
DNSسرورهای DNS و حافظه پنهان (فیلتر محتوای اپلیکیشن/سایت در بخش Websites & Apps قرار دارد)
WiFi / CAPsMANاینترفیس‌های Wi-Fi به همراه پیکربندی‌ها و پروفایل‌های امنیتی آن‌ها؛ و کنترلر CAPsMAN — پیکربندی‌ها، قوانین provisioning و CAPهای راه دور

سرویس‌ها & نگهداری

زبانهآنچه پیکربندی می‌کنید
PPPoEسرورهای PPPoE، پروفایل‌های PPP، IP poolها و بازه interim-update حسابداری RADIUS
Hotspotسرورهای Hotspot، پروفایل‌های Hotspot و پروفایل‌های کاربر، DHCP/IP pools و صفحه ورود Captive Portal
اینترنتاتصالات WAN — WANهای مدیریت‌شده توسط SAMM و مسیرهای پیش‌فرض؛ هر WAN موجود غیر SAMM به‌صورت فقط‌خواندنی نمایش داده می‌شود
فایروالقوانین فیلتر، تحلیل امنیت روتر، اتصال‌ها & اهداف، ماژول‌های امنیتی و پشتیبان‌های فایروال — Auto-Security پیش از اعمال تغییرات، از فایروال snapshot می‌گیرد و می‌تواند یک بازگشت خودکار زمان‌بندی‌شده را فعال کند تا اگر مجموعه‌ای از قوانین باعث قطع دسترسی شما شود، به‌طور خودکار بازگردانده شود
به‌روزرسانیبه‌روزرسانی‌های RouterOS — انتخاب کانال به‌روزرسانی، بررسی و اعمال، و بازبینی بسته‌های نصب‌شده
ویزاردراهنمای گام‌به‌گام پیکربندی اولیه، در ادامه

بازه زمانی interim-update در PPPoE

در زبانه PPPoE، گزینه Interim update تعیین می‌کند که روتر هر چند وقت یک‌بار بسته‌های Interim-Update مربوط به RADIUS accounting را به SAMM ارسال کند. SAMM از این بسته‌ها برای تجمیع شمارنده‌های بایت و uptime و ارزیابی سهمیه و محدودیت‌های روزانه و uptime استفاده می‌کند — بدون آن‌ها، اعمال محدودیت‌ها و شمارنده‌های نشست‌های فعال متوقف می‌شوند. مقدار توصیه‌شده 5m است.

صفحه ورود Hotspot

از زبانه Hotspot می‌توانید صفحه ورود captive-portal را مدیریت کنید: صفحات پیش‌فرض MikroTik را حفظ کنید، یکی از قالب‌های داخلی را اعمال کنید، یا یکی از طرح‌های ذخیره‌شده خود را به کار ببرید. SAMM شامل یک ویرایشگر بصری طراحی و گالری قالب‌ها است — صفحه ورود را سفارشی‌سازی کرده و آن را مستقیماً روی hotspot روتر اعمال کنید.

QoS آگاه از Application

نمای QoS (یک زیرزبانه از Websites & Apps) اپلیکیشن‌ها و سایت‌هایی را که SAMM پیش‌تر روی روتر شناسایی کرده است، به یک پلن اولویت‌بندی دانلود تبدیل می‌کند. هر اپلیکیشن را از مجموعه به یکی از هشت priority slots بکشید — در زمان ترافیک بالا، ابتدا slot 1 و در نهایت slot 8 سرویس‌دهی می‌شوند؛ اپلیکیشن‌هایی که در مجموعه باقی بمانند، shape نمی‌شوند. در صورت نیاز، سرعت دانلود هر اپلیکیشن را محدود کنید (به‌عنوان مثال 10M) و یک سقف دانلود کلی برای رقابت اولویت‌ها تعیین کنید. گزینه Auto-distribute by category همه موارد را با یک کلیک مرتب می‌کند — ابتدا پیام‌رسان‌ها، سپس سرویس‌های AI، سپس فروشگاه‌ها و سایر موارد در ادامه قرار می‌گیرند.

هنگام ارسال، SAMM جایگاه‌ها را در یک queue tree MikroTik (با برچسب SAMM:qos، parent=global) به همراه قواعد فایروال packet-mark متناظر، از بالاترین اولویت به بعد کامپایل می‌کند. این بر پایه همان کاتالوگ Websites & App filter ساخته شده که مانیتورینگ را نیرو می‌دهد، بنابراین فقط برنامه‌هایی که واقعاً روی روتر دیده شده‌اند ظاهر می‌شوند — و حذف SAMM QoS هر شیء SAMM:qos را از روتر پاک می‌کند و شمارنده‌های شما را دست‌نخورده باقی می‌گذارد.

ویزارد راه‌اندازی

زبانه Wizard همه موارد را در 10 مرحله کوتاه جمع‌آوری کرده و در پایان، پیکربندی کامل را به‌صورت یک‌جا به روتر ارسال می‌کند. تا زمانی که در مرحله بررسی نهایی تأیید نکنید، هیچ موردی ارسال نمی‌شود.

  1. خوش‌آمدگویی و شناسایی (Welcome & detect) — SAMM روتر را بررسی کرده و مواردی را که پیش‌تر پیکربندی شده‌اند نمایش می‌دهد تا بتوانید در هنگام push از ارسال آن‌ها صرف‌نظر کنید.
  2. Bridge interface — نام bridge مربوط به LAN را تعیین کنید.
  3. Bridge ports — انتخاب کنید کدام اینترفیس‌های فیزیکی به bridge اضافه شوند.
  4. DNS — تنظیم resolverهای upstream (پیش‌فرض‌های تک‌کلیکی برای Google، Cloudflare، Quad9 و موارد دیگر)، اندازه cache و در صورت نیاز، یک فیلتر محتوای DNS.
  5. NTP — تعیین منبع ساعت روتر (کلاینت NTP و در صورت تمایل، ارائه زمان به LAN).
  6. Internet — افزودن یک یا چند WAN uplink (Static / DHCP / PPPoE).
  7. RADIUS to SAMM — روتر را برای احراز هویت، حسابداری و CoA به میزبان SAMM خود ارجاع دهید.
  8. Services — انتخاب کنید که ویزارد یک سرور PPPoE، یک سرور Hotspot یا یک سرویس IPoE / DHCP ایجاد کند و در صورت نیاز IPv6 dual-stack را فعال کنید (اختیاری، به‌صورت پیش‌فرض خاموش است): طول پیشوند واگذارشده (DHCPv6-PD) و بلوک‌های IPv6 را انتخاب کنید تا ویزارد poolها را ساخته و آن‌ها را به پروفایل PPP متصل کند.
  9. PPPoE / جزئیات Hotspot & Firewall — poolها، پروفایل‌ها، زمان‌های lease، قوانین NAT در & firewall و یک Expired pool & internet block اختیاری که مشترکین منقضی‌شده را به‌جای اتصال قطع‌شده، به صفحه «اشتراک منقضی شده» SAMM هدایت می‌کند.
  10. بررسی & push — لیست دقیق دستوراتی که ارسال خواهند شد را مشاهده کنید و سپس همه آن‌ها را به روتر push کنید.
سرعت هر کاربر از RADIUS دریافت می‌شود ویزارد یک پروفایل واحد PPPoE / hotspot ایجاد می‌کند و پروفایل‌های مجزا برای هر سطح (tier) را اعمال نمی‌کند. سرعت هر مشترک توسط SAMM در پاسخ RADIUS هنگام ورود (login) ارسال می‌شود، بنابراین تغییر پلن هرگز نیازی به ویرایش روتر ندارد.

شبکه & روترها

بررسی عمیق

وقتی شبکه کند به نظر می‌رسد، بررسی عمیق کاری را می‌کند که یک مهندس می‌کند: مدتی یک روتر را می‌پاید، هر چه می‌تواند می‌خواند و به شما می‌گوید چه چیزی اشکال دارد و اول چه کاری کنید. فقط می‌خواند: هرگز چیزی روی روتر عوض نمی‌کند و هر اصلاحی با تصمیم خود شماست.

شروع بررسی

  1. Devices → Network Health را باز کنید و بررسی عمیق را بزنید، یا روی یک روتر در صفحه راست‌کلیک کنید.
  2. روترهایی را که می‌خواهید بررسی شوند روشن کنید. همه کلیدها خاموش شروع می‌شوند. فقط MikroTik BNG هایی که ورود ذخیره‌شده دارند فهرست می‌شوند.
  3. مدت را انتخاب کنید: 15 دقیقه، 30 دقیقه، 1 ساعت یا 2 ساعت. اجرای طولانی‌تر قابل‌اعتمادتر است؛ آن را در ساعت شلوغی اجرا کنید.
  4. شروع بررسی را بزنید. در پس‌زمینه اجرا می‌شود، پس می‌توانید صفحه را ببندید. برای هر روتر یک بررسی اجرا می‌شود، حداکثر دو تا هم‌زمان.

گزارش‌ها، کنار دکمه، هر بررسی را با پیشرفت، نتیجه و امتیازش فهرست می‌کند. می‌توانید یکی را زودتر متوقف کنید و آنچه تا آن لحظه سنجیده شده را نگه دارید.

چه چیزهایی را بررسی می‌کند

  • خطوط اینترنت: افت و تأخیر تا اینترنت و روی هر خط، جهش‌ها، و اینکه بسته‌های بزرگ رد می‌شوند یا نه.
  • تجربهٔ کاربر: پیام‌های آزمایشی به نمونه‌ای متغیر از کاربران آنلاین، و مدت زمان پاسخ‌ها.
  • Queue های کاربری و سرعت: اینکه کاربران وقتی پلنشان پر است داده از دست می‌دهند یا نه، آپلود و دانلود، و قواعدی که می‌توانند محدودیت سرعت را دور بزنند.
  • شبکهٔ دسترسی و منفذها: هر سمت دسترسی، برج‌ها و دستگاه‌های پشت روتر، خطای منفذ، قطعی، سرعت و سیگنال فیبر.
  • توازن بار: اینکه خطوط ترافیک را چگونه تقسیم می‌کنند، و اینکه قواعد توازن کامل‌اند و خط مرده را تشخیص می‌دهند یا نه.
  • سلامت روتر: بار پردازنده و هر هسته، حافظه، دما، راه‌اندازی مجدد، فریمور و گزارش روتر.
  • ورود و RADIUS: پاسخ به‌موقع، ورودهای ردشده، نشست‌هایی که زودتر تمام می‌شوند، و تنظیمات اندازهٔ بسته.
  • امنیت: اینکه روتر از اینترنت بسته است یا نه، ترتیب فایروال، حفاظت‌ها، سرویس‌های اضافی و ورودهای ناموفق.
  • مسیریابی: نشست‌های BGP، همسایه‌های OSPF و مسیرهای مرده.

همهٔ بررسی‌های Network Health گنجانده شده‌اند. بررسی‌ای که خوانده نشده از گزارش کنار گذاشته می‌شود و هرگز خوب حساب نمی‌شود.

گزارش

با یک امتیاز از 100 و حکمی به زبان ساده شروع می‌شود، سپس کارنامه‌ای برای هر بخش و فهرستی از کارهای لازم، مهم‌ترین اول. زیر آن جزئیات و عددها می‌آیند. زبان پنل شما را دنبال می‌کند، و Export PDF آن را با لوگوی SAMM و «Prepared by SAMM» در هر صفحه ذخیره می‌کند.

بررسی سبک است و وقتی پردازندهٔ روتر خیلی مشغول است، پینگ گرفتن از کاربران را متوقف می‌کند. اگر روتر همچنان overload بماند، زودتر تمام می‌شود و این را می‌گوید.

سیستم

SCOOP AI

SCOOP AI دستیاری در پایین هر صفحهٔ مدیریت است. با کلمات و زبان خودتان درباره کاربران، پلن‌ها، کارت‌ها، فاکتورها، پرداخت‌ها و روترها بپرسید و در چند ثانیه پاسخ ساده بگیرید. خودش نصب و روشن می‌شود.

اتصال یک هوش مصنوعی

در Settings → SCOOP AI، Google Gemini (کلید رایگان)، ChatGPT (ورود، بدون کلید)، Claude، OpenAI، OpenRouter یا DeepSeek را وصل کنید. چند ورود ذخیره‌شده نگه دارید و بینشان جابه‌جا شوید، مدلی انتخاب کنید یا روی Automatic بگذارید. کلیدی که خود هوش مصنوعی رد می‌کند هنگام ذخیره متوقف می‌شود، و یک صفحهٔ راهنما نشان می‌دهد که کلید هر هوش مصنوعی را چطور بگیرید.

چه چیزی آن را امن نگه می‌دارد

  • با دسترسی‌های هر مدیر کار می‌کند: مدیر فقط چیزی را می‌بیند و تغییر می‌دهد که نقشش اجازه می‌دهد.
  • پول، حذف‌ها و تغییرات روتر تا وقتی Approve را نزنید نگه داشته می‌شوند.
  • هر تغییر روتر یک بازگشت روی خود روتر نگه می‌دارد و هرگز به پیوند SAMM با روتر دست نمی‌زند.
  • گزارش SCOOP AI هر پرسش، پاسخ و تأیید هر مدیر را نگه می‌دارد.

از آن چه می‌توانید بخواهید

  • به پرسش‌ها دربارهٔ داده‌هایتان، به زبان خودتان پاسخ دهد.
  • اینترنت را بر اساس درصد بین خطوطتان توزیع کند، برنامه‌های انتخابی یا VPN را از یک خط انتخابی بفرستد، و DNS سریع‌تر تنظیم کند.
  • هر دوشنبه گزارش برایتان بفرستد، یا در ساعتی مشخص یادآوری کند.

دسترسی‌ها یک بلوک SCOOP AI دارند: استفاده، دیدن گزارش، تغییر تنظیمات. هر مدیر می‌تواند آن را برای خودش از منوی ربات یا از Profile خود پنهان کند.

شبکه & روترها

نقشه شبکه، وضعیت سلامت، Data Log & کیفیت اتصال

نقشه شبکه

Devices → Network Map بر اساس گزارش هر روتر از همسایگانش ترسیم می‌شود و نیازی به نگهداری دستی نمودار نیست. لایه‌ها را برای مشاهده پورت‌ها، IP addresses، زیرشبکه‌ها و CPU تغییر دهید یا مسیر هر دستگاه به اینترنت را نمایش دهید. گره‌ها را در جای مناسب بکشید و چیدمان را ذخیره کنید؛ Discover now مجدداً همسایگان را شناسایی می‌کند.

سلامت شبکه

Devices → Network Health تمامی روترها را به ترتیب وخامت وضعیت فهرست می‌کند: سالم، دارای هشدار، پاسخ‌دهنده اما دارای نقص، یا غیرقابل دسترس. هر مورد شناسایی‌شده، مشکل را به زبان ساده بیان می‌کند — غیرفعال بودن CoA، عدم تطابق RADIUS secret، عدم همگام‌سازی ساعت، یا باز ماندن Telnet یا FTP. این بررسی‌ها صرفاً اطلاعات روتر را می‌خوانند. در نمای Diagnose یک روتر، موارد رایج دارای قابلیت رفع مشکل با یک کلیک هستند که ابتدا پیش‌نمایشی را نشان داده و قابل بازگشت است. موارد شناسایی‌شده باز، در Alert Center هشدار ایجاد می‌کنند.

برای نگاه طولانی‌تر به یک MikroTik BNG، با گزارش کامل، از بررسی عمیق استفاده کنید.

هر دو صفحه در یک بخش قرار دارند: Settings → Advanced → Network Health. زمانی که این گزینه خاموش است، SAMM با روترها ارتباط برقرار نمی‌کند. هنگامی که روشن است، می‌توانید تعیین کنید که هر روتر هر چند وقت یک‌بار بررسی شود، در هر مرحله وضعیت چند روتر خوانده شود (نصب‌های سنگین در چندین مرحله توزیع می‌شوند) و اینکه آیا همسایه‌ها برای نقشه شناسایی شوند یا خیر.

روتری که برای مدت طولانی قطع بوده است را می‌توان متوقف (paused) کرد تا زمانی که دوباره پاسخ دهد، از ارسال هشدارها بازدارد.

بهینه‌ساز Wi-Fi

Devices → Wireless → Wi-Fi optimizer برای هر رادیو، یک نمای طیفی از باندی که در آن فعالیت می‌کند (سیگنال بر حسب dBm در فرکانس‌های مختلف، شبکه‌های شناسایی‌شده و نقاط تداخل آن‌ها)، لیستی از آن شبکه‌ها و یک نمودار کانال که وضعیت هر کانال را Quiet، Busy یا Crowded مشخص می‌کند، نمایش می‌دهد. Survey now کل باند را به‌صورت تک‌تک برای هر رادیو بررسی می‌کند تا در سایتی با چندین سکتور، تمام کلاینت‌ها به‌طور هم‌زمان قطع نشوند؛ این دکمه پیش از شروع، هزینه عملیات را به شما اعلام می‌کند. Live sweep آخرین، بیشینه و میانگین خوانش‌ها را در حین مشاهده، رسم می‌کند.

channel planner خلوت‌ترین کانال و بهترین پهنای کانال را برای هر رادیو پیشنهاد می‌کند. برای هر رادیو، به‌طور مجزا برای کانال و پهنای آن، گزینه Off، Suggest یا Auto را انتخاب کنید، یا اجازه دهید از شبکه خود پیروی کند؛ می‌توانید چندین رادیو را به‌طور هم‌زمان از لیست Wireless تنظیم کنید. در حالت Auto، SAMM رادیوها را در ساعت 04:00، یکی‌یکی جابه‌جا کرده و هر رادیو را مجدداً در کانال جدیدش بررسی می‌کند. Apply رادیو را همین حالا جابه‌جا می‌کند و Undo آن را به حالت قبل برمی‌گرداند. این قابلیت روی رادیوهای MikroTik (بسته‌های wifi و wireless، CAPsMAN) و اکسس‌پوینت‌های Ubiquiti UniFi کار می‌کند.

لاگ داده‌ها

یک کاربر را باز کرده و Data Log را انتخاب کنید تا مسیر ترافیک آن‌ها را مشاهده کنید: مقاصد برتر بر اساس host و app — مانند YouTube، Facebook، WhatsApp — به همراه میزان آپلود، دانلود و connections، یا یک timeline. SAMM خروجی flow خود روتر (IPFIX) را می‌خواند و در صورت عدم دسترسی، به جدول connection آن رجوع می‌کند و نام اپلیکیشن‌ها را از همان کاتالوگی که App Filter استفاده می‌کند، استخراج می‌کند. SAMM هرگز در مسیر ترافیک قرار نمی‌گیرد.

  • برای فعال‌سازی، گزینه Record user Data Log را در مسیر Settings → Advanced → Data Log فعال کنید.
  • جزئیات ساعتی برای چند روز نگهداری شده و سپس به یک ردیف به‌ازای هر سایت در هر روز فشرده می‌شود — یعنی حدود یک بیست‌وچهارم حجم اولیه. صفحه و خروجی هر دو حالت را می‌خوانند، بنابراین هیچ داده‌ای از دید خارج نمی‌شود.
  • Destinations per hour پرکاربردترین مقصد‌های هر کاربر را در هر ساعت نگه می‌دارد و آدرس‌های تک‌بار و کم‌تکرار را حذف می‌کند؛ 0 همه موارد را نگه می‌دارد.
  • Retention تعیین می‌کند که ردیف‌ها چه مدت پیش از حذف در فرآیند پاک‌سازی شبانه، نگهداری شوند.
  • پشتیبان‌گیری با گزینه Skip usage باعث حذف Data Log می‌شود تا حجم فایل پشتیبان کم باقی بماند.
غیرفعال است تا زمانی که آن را فعال کنید یک superadmin قابلیت Data Log را در تنظیمات فعال کرده و مدت‌زمان نگهداری آن را تعیین می‌کند. اعداد نمایش‌داده‌شده تقریبی هستند؛ برای صورت‌حساب همیشه از RADIUS accounting استفاده می‌شود.

کیفیت اتصال

در حالی که کاربر آنلاین است، SAMM می‌تواند هر چند دقیقه یک‌بار میانگین سرعت آن‌ها را بر اساس داده‌های accounting دریافتی ثبت کرده و تأخیر و اتلاف (delay and loss) را با یک تست کوتاه از روتر آن‌ها اندازه‌گیری کند. صفحه کاربر یک کارت کیفیت اتصال (Connection quality) شامل آخرین ارقام، تاریخچه سرعت در مقایسه با پلن و یک دکمه تست کن (Test now) را نمایش می‌دهد؛ لیست کاربران دارای یک ستون اختیاری است و خروجی (export) می‌تواند شامل این ارقام باشد. تاریخچه برای دو روز نگهداری می‌شود.

غیرفعال است تا زمانی که آن را فعال کنید آن را در Settings → Advanced → Connection Quality فعال کنید؛ در اینجا همچنین تعیین می‌کنید که کاربران هر چند وقت یک‌بار نمونه‌برداری شوند و هر روتر در هر دور چند کاربر را آزمایش کند (ابتدا کاربرانی که مدت بیشتری از آخرین اندازه‌گیری آن‌ها گذشته است). این قابلیت به‌گونه‌ای سبک طراحی شده است: سنجش سرعت ترافیکی برای روتر ایجاد نمی‌کند و بار آزمایش روی هر روتر محدود شده است. دستگاهی که آزمایش را مسدود کند، حتی در صورت سلامت خط، هیچ پاسخی نمی‌دهد. Test now حتی در زمانی که این قابلیت غیرفعال است نیز کار می‌کند.

شبکه & روترها

CoA & تغییرات لحظه‌ای

CoA (Change-of-Authorization) روشی است که SAMM از طریق آن نشست یک مشترک را در حالی که آنلاین است تغییر می‌دهد — برای افزایش یا کاهش سرعت، یا قطع اتصال کاربر — بدون اینکه منتظر اتصال مجدد آن‌ها بماند.

نحوه اعمال تغییرات برای مشترک فعال

SAMM هرگز تغییرات روتر را مستقیماً با کلیک روی یک دکمه اعمال نمی‌کند. هر اقدام مدیر از یک مسیر امن پیروی می‌کند:

اقدام مدیر → لاگ حسابرسی → samm-radius tick → صندوق خروجی CoA → روتر
  1. این عملیات به‌عنوان یک دستور در صف (queued command)، در audit log ثبت می‌شود.
  2. سرویس samm-radius در تیک بعدی خود صف را تخلیه کرده، تغییرات را اعمال می‌کند و — در صورتی که مشترک آنلاین باشد — یک CoA را در صف قرار می‌دهد.
  3. صندوق خروجی CoA تخلیه شده و بسته به روتر ارسال می‌شود.

رویدادهای زمان‌محور — انقضا، مرزهای بازه سرعت، بازنشانی‌های روزانه — به یک outbox واحد ارسال می‌شوند. حد بالای تأخیر، یک tick از samm-radius است (به‌صورت پیش‌فرض 30 s؛ برای اعمال دقیق‌تر، آن را در تنظیمات کاهش دهید).

CoA هیبرید

SAMM ابتدا یک CoA-Update ارسال می‌کند تا نشست را در همان حالت تغییر دهد. اگر روتر پس از تعداد دفعات تلاش تنظیم‌شده آن را رد کند، SAMM به‌طور خودکار به Disconnect-Request روی می‌آورد — مشترک مجدداً متصل شده و تنظیمات جدید را دریافت می‌کند. این استراتژی هیبرید در نسخه‌های مختلف فریم‌ور MikroTik کار می‌کند.

صفحه CoA Outbox

Users → CoA Outbox نمای لحظه‌ای (live view) آن صف است. samm-radius تنها فرستنده است — پنل مدیر هرگز CoA را به‌طور مستقیم ارسال نمی‌کند — و در هر تیک، صف را تخلیه می‌کند. این صفحه هر 30 ثانیه به‌طور خودکار به‌روزرسانی می‌شود.

شش شمارنده در بالای صفحه قرار دارند — Pending, Sent, NACK (retrying), Done, Failed و Total. جدول را بر اساس وضعیت، عملیات (update یا disconnect) فیلتر کنید یا بر اساس نام کاربری، NAS IP یا دلیل جست‌وجو کنید.

وضعیتمعنا
در انتظاردر صف قرار گرفت، در انتظار تیک بعدی samm-radius
ارسال شدارسال‌شده (گذرا — ارسال و نتیجه آن در یک tick ثبت می‌شوند، بنابراین ردیف‌ها به‌ندرت در این وضعیت باقی می‌مانند)
nackروتر درخواست CoA-Update را رد کرد — SAMM مجدداً تلاش می‌کند و در صورت عدم موفقیت، به قطع اتصال (disconnect) روی می‌آورد
انجام شدبا موفقیت اعمال شد
ناموفقپس از رسیدن به حد مجاز تلاش مجدد متوقف شد — برای مشاهده آخرین خطا، نشانگر را روی نشان (badge) نگه دارید

هر ردیف کاربر، روتر، عملیات، تعداد تلاش‌ها، دلیل و زمان‌های ایجاد و ارسال را نشان می‌دهد. عملیات‌های هر ردیف به شما اجازه می‌دهد یک بسته ناموفق یا nack شده را تلاش مجدد (Retry) کنید، بسته‌ای که هنوز در جریان است را لغو (Cancel) کنید، یا ویژگی‌ها (Attributes) را برای بررسی دقیق RADIUS attributes موجود در بسته باز کنید. نشان (badge) کنار صفحه تعداد ردیف‌های در انتظار را نمایش می‌دهد و داشبورد شکست‌های 24 ساعت اخیر را ردیابی می‌کند. در یک سیستم سالم، این صف تقریباً خالی می‌ماند.

پاک‌کننده sessionهای منقضی‌شده

اگر یک روتر کرش کند یا اتصال خود را از دست بدهد، بسته‌های Accounting-Stop آن ممکن است گم شوند — و در بسیاری از سیستم‌ها، آن مشترکین برای همیشه «آنلاین» باقی می‌مانند. SAMM نشست‌هایی را که ارسال Interim-Updates را متوقف کرده‌اند رصد کرده و آن‌ها را به‌طور خودکار می‌بندد (علت خاتمه Reaped-Stale)، تا لیست نشست‌های فعال، تعداد استفاده‌های هم‌زمان و ارقام مصرف دقیق باقی بمانند. این مهلت زمانی همان تنظیم stale_session_timeout_seconds است (پیش‌فرض 900 s = 15 دقیقه؛ برای غیرفعال‌سازی روی 0 تنظیم کنید) و به‌صورت لحظه‌ای اعمال می‌شود — نیازی به ری‌استارت نیست.

عملیات روزانه

داشبورد & نشست‌های زنده

دو صفحه زیر Overview نقطه‌ی شروع هر شیفت هستند — داشبورد برای بررسی سلامت کل سیستم و Live Sessions برای مشاهده دقیق افرادی که در حال حاضر متصل هستند.

دو صفحه‌نمایش: باز کردن در پنجره جدید

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

داشبورد

Overview → Dashboard صفحه اصلی اپراتور است. یک انتخاب‌گر بازه زمانی در بالا — Today, 7d, 14d, 30d, 90d — بازه زمانی نمودار روند و مقادیر محدود به تاریخ را تعیین می‌کند.

شش کاشی KPI

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

تایلنمایشباز می‌شود
هم‌اکنون آنلاینمشترکانی که در حال حاضر دارای یک session فعال RADIUS هستندکاربران فیلترشده بر روی Online
مشترکین فعالحساب‌های فعال، به همراه تعداد کل مشترکین در پایینکاربران فیلترشده بر روی Active
منقضی‌شدهمشترکانی که اشتراک آن‌ها به پایان رسیده و هیچ پلن بعدی برای آن‌ها تعیین نشده استکاربران فیلترشده بر روی Expired
تیکت‌های بازتیکت‌های پشتیبانی حل‌نشده (به‌استثنای موارد done & closed)کاربران ← تیکت‌های پشتیبانی
روترهاتعداد کل رکوردهای NAS، به‌علاوه تعداد مواردی که در حال حاضر غیرقابل دسترس هستندمانیتور MikroTik
صورت‌حساب‌های پرداخت‌نشدهفاکتورهایی که همچنان نیازمند پیگیری پرداخت هستندفاکتورهای فیلترشده بر روی Unpaid

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

یک نمودار خطی از snapshotهای روزانه، سه سری داده را در بازه زمانی انتخاب‌شده رسم می‌کند — کاربران active، sessionهای online و کاربران expired — تا رشد و churn در یک نگاه قابل مشاهده باشند.

سلامت Pipeline

این پنل قلب تپنده موتور اعمال قوانین است. در یک سیستم سالم، صف‌ها روی عدد 0 یا نزدیک به آن قرار دارند؛ بالا ماندن این عدد نشان‌دهنده متوقف شدن یک سرویس یا رد شدن تغییرات توسط روتر است.

متریکمفهوم آن چیست
samm-radius صفCoAهای در انتظار برای تیک بعدی — باید طی چند ثانیه پاک شوند
خطای CoA (24h)در یک سیستم سالم مقدار صفر است؛ مقدار غیرصفر به این معنی است که یک روتر درخواست‌های CoA را رد می‌کند
لاگ حسابرسی در انتظارعملیات‌های صف‌بندی‌شده مدیر که هنوز توسط samm-radius اعمال نشده‌اند
محدودسازی نشست‌هامشترکانی که در حال حاضر به‌دلیل یک محدودیت با سرعت کاهش‌یافته در دسترس هستند — این مورد مورد انتظار است و خطا محسوب نمی‌شود
تصویر لحظه‌ای نشست‌هاتعداد نشست‌های فعال — باید با Online now مطابقت داشته باشد
پلن‌های فعالحجم کاتالوگ پلن شما
مسیر اعمال عملیات مدیر در samm.audit_log صف‌بندی می‌شوند؛ tick مربوط به samm-radius آن‌ها را تخلیه کرده و CoAs را به samm.coa_outbox ارسال می‌کند. مسیر کامل در CoA & live changes آمده است.

جداول فعالیت‌های اخیر

چهار جدول در زیر نمودار، نمایی پویا از اتفاقات اخیر را ارائه می‌دهند که هر یک دارای لینک View all برای دسترسی به صفحه کامل مربوطه هستند:

  • صندوق خروجی اخیر CoA — عملیات، کاربر، وضعیت (done / pending / nack / failed)، تعداد تلاش‌ها، دلیل و زمان.
  • آخرین اقدامات مدیر — اقدام، هدف، اجراکننده، وضعیت اعمال و زمان.
  • مشترکین اخیر — جدیدترین حساب‌ها به‌همراه وضعیت و زمان آخرین احراز هویت.
  • Routers — هر NAS به‌همراه یک نقطه وضعیت سلامت در حالت reachable / unreachable / no-data.

نشست‌های فعال

Overview → Live Sessions لیستی از تمام مشترکانی را نمایش می‌دهد که روترها در حال حاضر از طریق RADIUS accounting به‌عنوان آنلاین گزارش کرده‌اند. این صفحه هر 30 ثانیه به‌طور خودکار به‌روزرسانی می‌شود؛ دکمه Refresh برای به‌روزرسانی دستی در هدر قرار دارد.

فیلتر کردن لیست

  • جستجو — با نام کاربری، Framed IP یا NAS IP مطابقت دارد و هم‌زمان با تایپ، نتایج را به‌روزرسانی می‌کند.
  • Router — محدود کردن لیست به نشست‌های یک NAS واحد.
  • Only throttled — فقط نمایش مشترکانی که به دلیل اعمال محدودیت، با سرعت کاهش‌یافته در حال استفاده هستند.
  • در هر صفحه — 20، 50، 100 یا 200 ردیف.

توضیحات هر ردیف

ستونمعنا
کاربرنام کاربری — پیوند به صفحه جزئیات مشترک
Framed IPآدرسی که روتر به این نشست اختصاص داده است
روترنام کوتاه NAS و آدرس IP آن
پلنپلن فعلی مشترک
سرعت مؤثرسرعتی که در حال حاضر روی روتر اعمال شده است — سرعت پلن که توسط هر speed window فعال تعدیل شده است. نشان throttled به این معناست که یک محدودیت، سرعت مشترک را در سطح پایین‌تری نگه داشته است.
قطع / متصلشمارنده‌های لحظه‌ای بایت برای session
آنلاینمدت‌زمان فعال بودن نشست
شروع شدههنگام شروع نشست

قطع اتصال نشست

دکمه Disconnect در هر ردیف، پس از نمایش اعلان تأیید، یک CoA-Disconnect را برای همان نشست خاص (با دلیل admin_manual) در صف قرار می‌دهد. مشترک بلافاصله قطع می‌شود؛ اگر حساب کاربری آن‌ها همچنان فعال باشد، می‌توانند مجدداً متصل شوند. بسته را در CoA Outbox ردیابی کنید.

عملیات روزانه

گزارشات & تحلیل‌ها

Overview → Reports نمای تحلیل‌ها است — روندهای مشترکین، ترافیک در طول زمان و پرمصرف‌ترین کاربران و کارت‌های شبکه شما.

انتخاب محدوده

هر نمودار در این صفحه به یک بازه زمانی وابسته است. یک گزینه پیش‌فرض — 7d, 14d, 30d, 90d — را انتخاب کنید یا تاریخ‌های دقیق start و end را تایپ کرده و روی Apply کلیک کنید. هنگام اجرای پرس‌وجوهای طولانی‌مدت مانند 90d، یک لایه Loading روی صفحه نمایش داده می‌شود.

روندهای نشست مشترک &

یک نمودار خطی با سه سری در بازه زمانی انتخاب‌شده: مشترکین Active، نشست‌های Online و مشترکین Expired. از این نمودار برای شناسایی رشد، ریزش و ساعات شلوغ شبکه خود استفاده کنید.

ترافیک روزانه

نمودار میله‌ای انباشته از بایت‌های آپلود و دانلود در هر روز. نگه داشتن نشانگر روی یک روز، مقادیر آپلود و دانلود به‌همراه total کلی را در پایین تولتیپ نمایش می‌دهد.

10 لیست برتر

چهار جدول اکانت‌هایی با بیشترین ترافیک را نمایش می‌دهند که هر یک بر اساس حجم بر حسب GB رتبه‌بندی شده‌اند:

لیسترتبه‌ها
10 دانلود برتر امروزبزرگ‌ترین دانلود از زمان آخرین بازنشانی روزانه
10 مورد برتر آپلود امروزبیشترین میزان آپلود از زمان آخرین بازنشانی روزانه
10 دانلود برتر ماهبیشترین میزان دانلود در ماه جاری تقویم
10 مورد برتر آپلود ماهانهبیشترین میزان آپلود در ماه جاری تقویمی

ترافیک بر اساس موجودیت

جدولی صفحه‌بندی‌شده و قابل جست‌وجو از ترافیک هر حساب کاربری. دو زبانه محتوای نمایش‌داده‌شده در لیست را تغییر می‌دهند:

  • کاربران — هر مشترک به همراه نام، پلن، میزان آپلود/دانلود امروز بر حسب MB و میزان آپلود/دانلود این ماه بر حسب GB.
  • کارت‌ها — هر کارت hotspot به‌همراه گروه، وضعیت و تفکیک ترافیک امروز / ماه مشابه.

کادر search هنگام تایپ، جدول را فیلتر می‌کند؛ انتخاب‌گر per-page امکان نمایش 20 تا 200 ردیف را فراهم می‌کند. هر ردیف به صفحه جزئیات آن مشترک یا کارت لینک است.

خروجی گرفتن Reports یک نمای تحلیلی روی صفحه است. برای دسترسی به ردیف‌های خام جهت پردازش در صفحه‌گسترده، از Tools → Export / Import برای دانلود کاربران، پلن‌ها یا NAS در قالب CSV / XLSX استفاده کنید.

صفحه Live Traffic

یک نمای زنده و مجزا از نرخ انتقال داده (throughput) لحظه‌ای برای کاربرها، روترها و اینترفیس‌ها که در بازه‌های زمانی تا یک ثانیه به‌روزرسانی می‌شود. ترکیباتی را که اغلب بررسی می‌کنید Bookmark کنید تا در دفعات بعد تنها با یک کلیک در دسترس باشند.

عملیات روزانه

حسابداری & صورت‌حساب

SAMM دارای یک سیستم جامع دفترداری دوطرفه داخلی است — فاکتورها، هزینه‌ها، رسیدها، پرداخت‌ها، نمایندگان فروش، دارایی‌های ثابت و صورت‌های مالی کامل. هیچ محصول Billing مجزایی برای یکپارچه‌سازی وجود ندارد و برای مدیریت دقیق دفاتر حسابداری به حسابدار نیازی نیست.

شما هرگز با حساب‌های بدهکار و بستانکار سر و کار ندارید هر عملیات — ثبت پرداخت، افزودن هزینه، فروش یک گروه کارت — به‌طور خودکار یک ثبت روزنامه متوازن را در دفتر کل درج می‌کند. شما با عبارات ساده (فاکتورها، هزینه‌ها، رسیدها) کار می‌کنید؛ SAMM دفاتر دوطرفه را در پس‌زمینه مدیریت کرده و توازن آن‌ها را در تراز آزمایشی اثبات می‌کند.

صفحه Accounting در یازده زبانه سازمان‌دهی شده است.

نمای کلی

نمای کلی وضعیت مالی. چهار رقم کلیدی در بالا قرار دارند:

شکلمعنا
موجودی نقدموجودی کل در تمامی حساب‌های نقدی & بانکی
مبالغ طلب‌کاریحساب‌های دریافتنی — صورت‌حساب‌های پرداخت‌نشده مشتریان و نمایندگان فروش
مبلغ بدهی شماحسابات پرداختنی — هزینه‌های پرداخت‌نشده
سود این ماهدرآمد منهای هزینه‌های ماه جاری

در ادامه: جدولی از هر حساب بانکی & نقدی به همراه موجودی آن، و نمودار درآمد در مقابل هزینه‌ها در بازه زمانی 1، 2، 3، 6 یا 12 ماه گذشته.

کتاب‌ها به‌تفکیک شعبه

هر فاکتور، پرداخت، هزینه، دارایی و حساب نقدی متعلق به یک شعبه یا شرکت General است. یک فاکتور شعبه‌ای را که کاربر هنگام صدور داشته است حفظ می‌کند، حتی اگر کاربر بعداً جابه‌جا شود. یک انتخاب‌گر Branch در بالای هر زبانه، کل شرکت، فقط شرکت General یا یک شعبه به‌همراه زیرشعبه‌هایش را نمایش می‌دهد و لیست‌ها را می‌توان بر اساس شعبه فیلتر، مرتب و گروه‌بندی کرد. یک مدیر شعبه با دسترسی Financial فقط دفاتر حسابداری شعبه خود را مشاهده می‌کند.

تحویل وجه: یک شعبه وجه را از حساب وجه خود به حساب وجه شرکت ارسال می‌کند؛ این تراکنش زمانی ثبت می‌شود که شرکت دریافت آن را تأیید کند. Reports → Branches هر شعبه را در کنار یکدیگر نمایش می‌دهد: درآمد، هزینه‌ها، سود خالص، وصولی‌ها، مطالبات، کاربران فعال و درآمد به‌ازای هر کاربر.

صورت‌حساب‌ها

فاکتور سندی است که شما صادر می‌کنید. روی New invoice کلیک کرده و موارد زیر را تکمیل کنید:

فیلدمعنا
مشتریجست‌وجوی پیش‌بین برای حسابی که صورت‌حساب به نام آن صادر می‌شود
دسته‌بندی درآمدحساب درآمدی که فروش در آن ثبت می‌شود
تاریخ صدور / تاریخ سررسیدتاریخ صدور خالی = امروز؛ تاریخ سررسید خالی = تاریخ صدور
نرخ مالیات % / گروه مالیاتیبه‌صورت پیش‌فرض بر اساس نرخ در تنظیم → Billing است؛ یک گروه مالیاتی را اختصاص دهید تا چندین نرخ (VAT/GST و موارد دیگر) به‌طور هم‌زمان اعمال شوند و هر کدام در حساب مالیاتی مربوط به خود ثبت گردند
آیتم‌های ردیفیک یا چند ردیف شرح / تعداد / قیمت واحد — جمع جزئی، مالیات و جمع کل به‌صورت لحظه‌ای محاسبه می‌شوند

میزان هزینه دریافت شود — کامل، بخش‌بندی‌شده یا رایگان

هرگاه SAMM در حال صدور صورت‌حساب برای یک مشترک باشد — اعم از فعال‌سازی، تمدید، تغییر پلن، تمدید تاریخ انقضا یا انجام هر یک از این موارد به‌صورت دسته‌جمعی — همان invoice picker ظاهر می‌شود و مبلغ را پیش از تایید نهایی نمایش می‌دهد:

انتخابهزینه‌های دریافتی
صورت‌حساب کاملتنها دوره‌های کامل پلن — دوره‌های ناقص به یک دوره کامل گرد می‌شوند.
صورت‌حساب تفکیک‌شدهزمان دقیق، با محاسبه تناسبی برای آخرین دوره زمانی. مبلغ کل به نزدیک‌ترین عدد صحیح گرد می‌شود و تفاوت آن به‌عنوان تعدیل گرد کردن ثبت می‌گردد تا تراز حساب‌ها حفظ شود.
بدون صورت‌حسابسرویس را تغییر دهید و هزینه‌ای دریافت نکنید — یک تمدید رایگان، یک مهاجرت یا یک اصلاح.

مدت زمان را با استفاده از periods multiplier برای دوره‌های کامل پلن تنظیم کنید، یا یک تاریخ دقیق را وارد کنید تا SAMM هزینه آن را محاسبه کند. در هر دو حالت، پنل موارد تفکیکی، مالیات و مبلغ کل را هنگام تغییر نمایش می‌دهد و Paid یک پرداخت نقدی برای کل مبلغ را بلافاصله ثبت می‌کند.

"No invoice" یک حق است، نه یک چک‌باکس عدم دریافت هزینه یک تصمیم مالی است، بنابراین توسط یک مجوز برای هر نقش در Settings → Admins کنترل می‌شود. این موضوع بیشتر در مورد agents اهمیت دارد: agentهایی که مشترکین آن‌ها از موجودی پیش‌پرداخت خودشان پرداخت می‌کنند، در غیر این صورت می‌توانند در تمام روز پلن‌ها را تمدید، تغییر و تاریخ انقضا را افزایش دهند بدون اینکه هرگز هزینه‌ای بپردازند. در نقش‌های جدید، این دسترسی به‌صورت off تنظیم شده است.

Dunning & کیف پول پیش‌پرداخت

فراتر از صورت‌حساب‌های تک‌مرحله‌ای، SAMM کل چرخه وصول را خودکار می‌کند. یک dunning schedule روز صدور صورت‌حساب، روز سررسید و روز مسدودسازی خودکار را — همراه با جریمه‌های احتمالی دیرکرد — تعیین می‌کند تا به مشترکین دارای بدهی یادآوری شده و سپس دسترسی‌شان قطع شود، بدون اینکه نیاز باشد شما یک صفحه گسترده را رصد کنید. حالت prepaid wallet به مشترکین اجازه می‌دهد موجودی داشته باشند که به‌طور خودکار در زمان تمدید، صورت‌حساب‌ها را تسویه کند؛ آن‌ها می‌توانند موجودی خود را از طریق پورتال مشتری با کارت یا کریپتو شارژ کنند و هر شارژ یا کسر وجه در دفتر کل ثبت می‌شود.

پلن‌های Grace: ابتدا صدور صورت‌حساب، تمدید پس از پرداخت

یک پیکربندی رایج، زنجیره‌ای از پلن‌ها است: پلن پرداخت‌شده به یک پلن grace کوتاه با سرعت کامل تبدیل می‌شود، سپس به یک پلن کند و در نهایت کاربر قطع می‌شود. گزینه Raise the renewal invoice when a paid plan expires into its next plan را در Accounting → Settings فعال کنید تا SAMM در لحظه انتقال کاربر به grace، فاکتور تمدید را صادر کند که سررسید آن با پایان grace است. به‌محض پرداخت — در باجه، آنلاین یا از کیف پول — کاربر به پلن خود بازمی‌گردد و تاریخ آن از روز انقضا محاسبه می‌شود تا روز صورت‌حساب هرگز تغییر نکند. کاربرانی که پرداخت نمی‌کنند، به‌سادگی در زنجیره پلن‌ها پیش می‌روند.

برای این کاربرها دکمه Renew plan را فشار ندهید تمدید پلن، سرویس کامل را به‌صورت آنی، فارغ از پرداخت شدن یا نشدن، بازیابی می‌کند. در صورت فعال بودن این تنظیم، فاکتور و پرداخت، عملیات تمدید را برای شما انجام می‌دهند. این تنظیم تا زمانی که آن را فعال کنید، غیرفعال است.

فاکتورها همچنین به‌صورت خودکار هنگام تمدید پلن مشترک (از طریق اقدام Renew Expiration کاربر یا تمدید خودکار)، در صورتی که پلن دارای قیمت باشد، صادر می‌شوند. لیست بر اساس وضعیت — unpaid, partial, due, paid — فیلتر شده و بر اساس شماره فاکتور یا مشتری قابل جست‌وجو است. هر فاکتور را برای مشاهده صفحه جزئیات و دریافت PDF قابل چاپ باز کنید؛ کاربران می‌توانند نسخه‌های خود را از پورتال مشتری و ربات Telegram دانلود کنند.

هزینه‌ها

هزینه عبارت است از پولی که برای اداره ISP صرف می‌شود. New expense دسته‌بندی (حساب هزینه)، تولیدکننده پرداخت‌شده، مبلغ، تاریخ وقوع و یک تاریخ سررسید اختیاری را ثبت می‌کند. هر هزینه دارای همان چرخه حیات unpaid / partial / due / paid مشابه با فاکتور، یک صفحه جزئیات و یک voucher PDF قابل چاپ است.

رسیدهای & پرداخت‌ها

این دو زبانه جابه‌جایی واقعی وجه را ثبت می‌کنند — متمایز از فاکتور یا هزینه‌ای که باعث آن شده است.

  • رسیدها — پول ورودی: وجه دریافت‌شده از مشتری، یک reseller یا سایر درآمدها که به یکی از حساب‌های نقدی شما واریز می‌شود. Invoice همان صورت‌حساب است و receipt وجهی است که در ازای آن دریافت می‌شود.
  • پرداخت‌ها — وجه خروجی: مبلغ پرداخت‌شده بابت یک هزینه یا به یک reseller.

ثبت یک رسید یا پرداخت، فاکتور یا هزینه مربوطه را به وضعیت paid تغییر داده و سند دفتر کل متناظر را ثبت می‌کند.

مشتریان & فروش کارت

زبانه Customers مانده حساب جاری هر کاربر — مبلغی که به شما بدهکارند — را فهرست می‌کند. Card sales درآمدهای prepaid hotspot را پوشش می‌دهد: این بخش card groups فروخته‌شده و resellers را ردیابی می‌کند. یک reseller گروه‌های کامل کارت را از طریق فاکتور از شما خریداری کرده و سپس کارت‌های تکی را به کاربران نهایی می‌فروشد؛ balance owed آن‌ها مبلغی است که هنوز باید به شما پرداخت کنند.

نمایندگان — صورت‌حساب عمده‌فروشی

یک نماینده سرویس شما را با مدل عمده‌فروشیِ پیش‌پرداخت به مشتریان نهایی می‌فروشد — مانند یک نمایندگی یا خرده‌فروش که دفتر مشترکین خود را دارد اما روی شبکه شما کار می‌کند. کاملاً اختیاری است: اگر هرگز نماینده‌ای نسازید، صورت‌حساب دقیقاً مثل همیشه کار می‌کند.

دو بدهی، به‌روشنی جدا نماینده مبلغ عمده را به شما بدهکار است (در دفاتر شما این درآمد شماست)؛ و مشتری مبلغ خرده را به نماینده بدهکار است (خارج از دفاتر شما — این مطالباتِ خودِ نماینده است). کمیسیون شما فاصله میان این دو است که به‌عنوان تخفیف تجاری ثبت می‌شود، نه هزینه.

یک نماینده را در تنظیمات → مدیران بسازید و به مدیرِ جدید نقشِ داخلیِ نماینده را بدهید. نماینده یک ورودِ مدیرِ محدوده‌دار است با:

تنظیماتمعنا
درصد کمیسیونسهم نماینده از قیمت خرده (مثلاً ۴۰٪ — شما ۶۰٪ را به‌عنوان درآمد عمده نگه می‌دارید). برای هر نماینده و در هر زمان قابل ویرایش است.
سقف اعتباراینکه موجودیِ پیش‌پرداختِ نماینده تا چه حد می‌تواند منفی شود پیش از آنکه تمدیدها رد شوند. برای پیش‌پرداختِ سخت‌گیرانه روی ۰ بگذارید.
موجودیِ پیش‌پرداختهر گاه نماینده به شما پرداخت کرد آن را شارژ کنید؛ هر تمدید مبلغ عمده را از آن کسر می‌کند.

هنگامی که یکی از مشترکینِ نماینده تمدید می‌شود، SAMM مبلغ عمده را از موجودیِ نماینده کسر می‌کند، درآمد شما را ثبت می‌کند و یک فاکتورِ خرده‌فروشیِ واقعی برای مشتریِ نهایی صادر می‌کند که پرداختش به نماینده است و خارج از دفترِ شما می‌ماند. پیگیریِ مطالباتِ سمتِ نماینده — با کلیدِ مستقلِ خود در تنظیمات → صورت‌حساب، به‌طورِ پیش‌فرض روشن و با مهلتِ ارفاقِ قابل ویرایش — به‌طورِ خودکار مشتریِ بدهکار را معلق می‌کند (با ارسالِ قطعِ CoA)؛ و وقتی نماینده پرداختِ مشتری را ثبت کند، مشترک بی‌درنگ دوباره فعال می‌شود.

نماینده به یک نمای محدوده‌دار وارد می‌شود: داشبوردِ خودش، صفحه‌ی کیف‌پولِ موجودیِ من، فهرستِ مشتریانِ من با فاکتورها و پرداخت‌های هر مشتری، و صورت‌حسابِ من — همه محدود به دفترِ خودش. دفاترِ کلِ شرکتِ شما، نمایندگانِ دیگر و مشتریانِ سایرِ مدیران پنهان می‌مانند.

دارایی‌ها و حساب‌های نقدی

  • Assets — دارایی‌های ثابت (روترها، خودروها، تجهیزات) را ثبت کنید. SAMM ارزش و استهلاک آن‌ها را در طول زمان دنبال می‌کند.
  • Cash — حساب‌های نقدی و بانکی خود و حساب‌های سرمایه خود را مدیریت کنید: حقوق صاحب، که در آن یک آورده پولی است که مالک وارد کسب‌وکار می‌کند و یک برداشت پولی است که خارج می‌شود. سرمایه درآمد نیست و هرگز در صورت سود و زیان ظاهر نمی‌شود.

گزارش‌ها — صورت‌های مالی

تب Reports نمای حسابدار است. پنج صورت مالی، هرکدام دارای بازه تاریخ و قابل خروجی گرفتن به PDF:

گزارشپاسخ می‌دهد
سود و زیاندرآمد در برابر هزینه‌ها و سود خالص در یک بازه تاریخ. مبنای تعهدی — درآمد هنگام صدور فاکتور و هزینه‌ها هنگام تحقق شمرده می‌شوند، نه هنگام جابه‌جایی وجه نقد.
ترازنامهدر یک تاریخ مشخص: آنچه دارید (دارایی‌ها) در برابر آنچه بدهکارید (بدهی‌ها) به علاوه حقوق صاحبان. یک نشان balanced تأیید می‌کند که دو طرف با هم مطابقت دارند.
جریان نقدیبرای هر حساب نقدی — مانده ابتدای دوره، پول ورودی، پول خروجی، مانده پایان دوره در یک بازه.
سررسیدگذاریدریافتنی‌ها و پرداختنی‌های معوق که در بازه‌های سنی دسته‌بندی شده‌اند، تا بتوانید فاکتورهای سررسیدگذشته را پیگیری کنید و از صورت‌حساب‌ها جلوتر بمانید.
پیشرفتهدفاتر خام: دفتر کل (هر سطر روی یک حساب با یک مانده جاری)، تراز آزمایشی (بررسی توازن دفاتر)، دفتر روزنامه و یک activity log.
بررسی توازن در تراز آزمایشی جمع ستون‌های بدهکار و بستانکار هر حساب باید برابر باشد — این اثبات درستی دفاتر است. اگر هرگز از توازن خارج شود، به یک خطای ثبت اشاره دارد که ارزش بررسی دارد.

صادرات به نرم افزار حسابداری

در بخش حسابداری → گزارش ها → صادرات ، کتاب ها را به صورت CSV دانلود کنید QuickBooks، Xero یا هر صفحه گسترده: مجله عمومی، نمودار حساب ها، فاکتورها، آزمایشی تعادل، سود و زیان و ترازنامه. مجله عمومی، فاکتورها و P&L از محدوده تاریخ؛ بقیه تا امروز همان داده ها از طریق API در دسترس هستند GET /api/v1/accounting/export/{kind} ( format=json|csv ، دامنه accounting:read ) برای خطوط لوله BI و Zapier. صادرات شامل ورودی های باطل نمی شود، بنابراین الف دانلود همیشه با گزارش های روی صفحه مطابقت دارد.

عملیات روزانه

لغو & تأییدیه‌ها

بیشترین اشتباهات در پنل یک ارائه‌دهنده خدمات اینترنت، اشتباهات مالی هستند: تمدید اشتباه اشتراک، ثبت دو بار پرداخت، تغییر پلن در حساب اشتباه. SAMM به شما یک پنج دقیقه بازگردانی برای این اقدامات می‌دهد و — جایی که اقدامی پول را بازمی‌گرداند — یک درگاه تایید سوپر ادمین قبل از اینکه اثراتی داشته باشد.

پنجره واگرد

هر اقدام مدیریتی که شامل جابجایی پول یا وضعیت است، همان‌طور که اتفاق می‌افتد، ثبت می‌شود. در پنج دقیقه بعدی، نوار بالایی دکمه‌های بازگشت و تاریخچه اقدامات را به همراه دارد — با کلیک بر روی پیکان، آخرین اقدام را معکوس کنید، یا تاریخچه را باز کنید و به هر نقطه‌ای در پنجره برگردید. تکرار آن را بازمی‌گرداند.

چرا فقط پنج دقیقه خنثیسازی یک ماشین زمان نیست - یک شبکه ایمنی برای کلیکی است که شما انجام دادید. فراتر از چند دقیقه، دنیا حرکت کرده است: مشترک آنلاین بوده است، یک فاکتور پرداخت شده است، شخص دیگری رکورد را ویرایش کرده است. SAMM ترجیح می دهد رد کند تا بی سر و صدا تاریخچه را بازنویسی کنید، بنابراین مرحله به سادگی با بسته شدن پنجره، تاریخچه شما را ترک می کند.

یک واگرد رد می کند - با دلیل روی صفحه - وقتی معکوس کردن آن چیزی را که ایجاد نکرده است از بین می برد:

امتناعمفهوم آن چیست
آن رکورد دیگر وجود نداردمشترک، فاکتور یا پرداخت پس از اقدام شما حذف شد - چیزی برای بازگرداندن باقی نمانده است.
آن رکورد دوباره وجود داردچیزی در جای خود دوباره خلق شده است. لغو باعث بازنویسی رکورد جدیدتر می شود.
این رکورد پس از اقدام شما تغییر کرددر این مدت شخص دیگری آن را ویرایش کرده است - با واگرد کردن، ویرایش آنها بی‌صدا حذف می‌شود.
آن مرحله دیگر در تاریخ شما نیستپنجره پنج دقیقه ای بسته شد.

بازگرداندن یک معکوس است، نه حذف : عمل اصلی و لغو آن هر دو در لاگ حسابرسی باقی می‌مانند، بنابراین ثبت وقایع هرگز از دست نمی‌رود. اقداماتی که چیزی ایجاد می‌کنند، قبل از اجرا به روشنی شما را هشدار می‌دهند — لغو کردن این اقدام باعث حذف چیزی که ایجاد کرده است می‌شود.

دروازه تایید نماینده

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

بنابراین SAMM اقدامات یک نماینده را از طریق اینکه پول جابجا می شود تقسیم می کند:

جهتنمونه هارفتار
برای نماینده هزینه دارد فعال کردن، تمدید، تغییر طرح، جمع آوری پرداخت مشتری فوری کار روزانه یک نماینده هرگز منتظر کسی نیست.
پول را پس می دهد لغو، حذف یک مشترک، حذف یک فاکتور، لغو یک مجموعه به عنوان درخواست پارک شده است. هیچ چیز تغییر نمی کند تا زمانی که یک سوپرادمین آن را تایید کند.

اقدامات محدوده‌دار به‌طور ناقص انجام نمی‌شوند. درخواست با تمام جزئیات مورد نیاز برای اجرای آن در آینده ذخیره می‌شود و تأیید آن را از طریق همان کدی که عامل اجرا می‌کرد — هرگز یک پیاده‌سازی دوم که ممکن است از اولین متفاوت باشد. رد کردن جهان را دقیقاً همان‌طور که بود باقی می‌گذارد و عامل مسئولیت را بر عهده می‌گیرد.

کار کردن در صف

درخواست‌ها در بخش حسابداری → تایید نمایندگان با نماینده، اقدام، چیزی که به آن مربوط می‌شود و میزان پول بازگردانده شده — عددی که تصمیم‌گیرنده است — می‌رسند. بر اساس نماینده یا وضعیت فیلتر کنید، جستجو کنید، چندین مورد را علامت بزنید و تایید یا رد کنید؛ رد کردن می‌تواند دلیل کوتاهی داشته باشد که نماینده مشاهده می‌کند.

آن را تفویض کنید بررسی مداوم عوامل نادر است که وظیفه مدیرعالی را تشکیل می‌دهد. تأیید عامل می‌تواند به هر نقشی در تنظیمات → مدیران اعطا شود، بنابراین شخصی که در واقع بررسی می‌کند، دقیقاً آن قدرت را دارد — و هیچ چیز دیگری. ایجاد و مدیریت عوامل فقط برای مدیرعالی است. هیچ‌کس نمی‌تواند درخواست خود را تصمیم بگیرد.

چیزی که نماینده می بیند

یک عامل به صفحه‌ای در حساب من → درخواست‌های در انتظار دست می‌یابد که همه چیز را که درخواست کرده‌اند، فهرست می‌کند: آنچه هنوز در انتظار است و آنچه تایید یا رد شده است—با دلیل بازبین. بدون آن، رد شدن با درخواستی که ناپدید شده است، قابل تشخیص نیست و آنها فقط دوباره درخواست خواهند کرد.

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

برای مشترکین شما

پرداخت‌های آنلاین

SAMM به مشترکین شما امکان می‌دهد صورتحساب‌های خود را به‌صورت آنلاین پرداخت کنند — با کارت بانکی (Stripe یا PayPal)، با ارز دیجیتال (Binance)، یا با Sham Cash در سوریه. وقتی مشترکی پرداخت می‌کند، SAMM صورتحساب را پرداخت‌شده علامت می‌زند، آن را در دفاتر شما ثبت می‌کند و — اگر به‌دلیل عدم پرداخت قطع شده بود — به‌صورت خودکار دوباره وصلش می‌کند. هیچ هزینه‌ای از شما دریافت نمی‌شود: هر درگاه از حساب خودتان استفاده می‌کند، بنابراین پول مستقیماً به شما می‌رسد.

آن را روشن کنید (هر دروازه ای)

  1. باز کردن مالی → پرداخت‌های آنلاین (فقط سوپرادمین).
  2. با کلیک روی یک درگاه آن را باز کنید — Stripe، PayPal یا Binance.
  3. فرم‌های آن را پر کنید، چک فعال‌سازی این دروازه را بزنید و بر روی ذخیره کلیک کنید. SAMM تا زمانی که فیلدهای مورد نیاز پر نشده‌اند، ذخیره‌سازی را اجازه نخواهد داد.
  4. برای تأیید کارکرد اعتبارنامه‌هایتان، بر روی اجرای تست کلیک کنید.
  5. تکمیل شد — اشتراک‌گذاران شما اکنون دکمه‌ای با عنوان پرداخت را در صورتحساب‌های بدون پرداخت خود در پورتال (و در صفحه «اشتراک منقضی شده») مشاهده می‌کنند.

شما می توانید بیش از یک دروازه را فعال کنید - مشترک انتخاب می کند که از کدام دروازه استفاده کند.

Stripe — کارت های بانکی، در سراسر جهان

  1. یک حساب رایگان در stripe.com ایجاد کنید. در حین آزمایش، حالت آزمایشی را فعال نگه دارید.
  2. به توسعه‌دهندگان → کلیدهای API بروید و کلید مخفی (که با sk_ شروع می‌شود) را کپی کنید.
  3. در SAMM، Stripe را گسترش دهید، کلید مخفی را کپی کنید، واحد پولی و حساب نقدی که دریافت می‌کند را انتخاب کنید، سپس ذخیره کنید و آزمایش را اجرا کنید.
  4. توصیه می‌شود: یک webhook اضافه کنید تا تایید پرداخت‌ها به‌طور قابل اعتمادی انجام شود. در Stripe به بخش توسعه‌دهندگان → وب‌هوک‌ها → اضافه کردن نقطه پایانی بروید، آدرس URL را به https://YOUR-SAMM/pay/webhook/stripe تنظیم کنید، رویداد checkout.session.completed را انتخاب کنید، سپس رمز امضای آن (whsec_…) را به فیلد رمز امضای وب‌هوک در SAMM کپی کنید.
پخش زنده حالت تست در هر جایی کار می کند. دریافت پول واقعی از طریق Stripe نیاز به پشتیبانی از Stripe دارد کشور و یک حساب بانکی مرتبط

PayPal — کارت و PayPal موجودی

  1. یک حساب PayPal Business ایجاد کنید، سپس در developer.paypal.com یک اپلیکیشن REST بسازید و ID مشتری و راز آن را کپی کنید.
  2. در SAMM، PayPal را گسترش دهید، شناسه مشتری و راز مشتری را کپی کنید، Sandbox (آزمایشی) یا زنده را انتخاب کنید، سپس ذخیره و آزمایش اجرا کنید.
  3. توصیه می‌شود: یک وب‌هوک در developer.paypal.com → اپلیکیشن شما → وب‌هوک‌ها، آدرس URL https://YOUR-SAMM/pay/webhook/paypal، اشتراک در CHECKOUT.ORDER.APPROVED و PAYMENT.CAPTURE.COMPLETED ایجاد کنید، سپس شناسه وب‌هوک را در SAMM کپی کنید تا اعلان‌های ورودی رمزنگاری‌شده تأیید شوند.

Binance — ارز دیجیتال، همه‌جا کار می‌کند، نیازی به حساب بانکی نیست

این بهترین گزینه است وقتی کارت‌ها و PayPal در دسترس نیستند. مشترکین شما با ارز دیجیتال پرداخت می‌کنند؛ SAMM حساب Binance شما را رصد می‌کند و صورتحساب را به‌طور خودکار پرداخت‌شده علامت می‌زند. سه چیز لازم دارید: یک API Key، یک API Secret و محلی برای دریافت — یک آدرس کیف پول و/یا یک Binance Pay ID.

مرحله 1 - یک کلید API فقط خواندنی ایجاد کنید

اول ایمنی کلید را با دسترسی خواندن فقط ایجاد کنید. هرگز امکانات برداشت یا معامله را فعال نکنید — SAMM فقط نیاز به خواندن پرداخت‌های ورودی شما دارد، هرگز وجوه را جابجا نمی‌کند.
  1. به Binance وارد شوید → حساب خود را باز کنید → مدیریت API (یا "مدیریت API" را جستجو کنید).
  2. بر روی ایجاد API کلیک کنید → تولید شده توسط سیستم را انتخاب کنید → نام آن را به عنوان مثال "SAMM" بگذارید → بررسی امنیتی را تکمیل کنید.
  3. Binance کلید API و کلید مخفی را نشان می‌دهد — را اکنون هر دو کپی کنید (راز فقط یک بار نشان داده می‌شود).
  4. بر روی ویرایش محدودیت‌ها کلیک کنید و فقط فعال‌سازی خواندن را انتخاب کنید. تجارت نقطه‌ای و برداشت‌ها را غیرفعال بگذارید. (اختیاری: کلید را به آدرس IP سرور خود محدود کنید.)
  5. کلید API و API Secret را در کارت Binance SAMM قرار دهید (اول کلید، سپس مخفی - همان ترتیبی که Binance آنها را نشان می‌دهد).

مرحله 2 - آدرس کیف پول دریافتی خود را دریافت کنید

  1. در Binance به بخش کیف پول → بازار نقدی → واریز (واریز کریپتو) بروید.
  2. سکه را انتخاب کنید: USDT
  3. شبکه را انتخاب کنید — TRC20 ارزان ترین و رایج ترین است. BEP20 و ERC20 نیز کار می کنند. از همان موردی که در SAMM انتخاب کرده اید استفاده کنید.
  4. آدرس سپرده را کپی کنید و آن را در فیلد آدرس کیف پول دریافت آن‌لاین SAMM قرار دهید. اطمینان حاصل کنید که کشوی شبکه SAMM با شبکه‌ای که انتخاب کرده‌اید مطابقت دارد.

مرحله 3 — (اختیاری) Binance شناسه پرداخت

برای مشترکینی که ترجیح می‌دهند از Binance Pay (فوری، بدون هزینه شبکه): در اپلیکیشن Binance، Pay را باز کنید و شناسه پرداخت خود را یادداشت نمایید (ایمیل یا شماره تلفن شما نیز کار می‌کند). آن را در فیلد شناسه Binance Pay در SAMM کپی کنید. مشترکین سپس می‌توانند با شناسه پرداخت و همچنین از طریق زنجیره پرداخت کنند.

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

مقدار دقیق، شبکه صحیح یک مشترک باید مبلغ دقیق SAMM نشان می‌دهد (آخرین رقم‌های کوچک آن، شماره صورتحساب را مشخص می‌کند) در شبکه صحیح. مبلغ متفاوت یا شبکه نادرست، پرداخت را به تأخیر می‌اندازد یا از دست می‌دهد.

Sham Cash — سوریه

کاربران شما از اپلیکیشن یا وب‌سایت Sham Cash پرداخت می‌کنند و SAMM بلافاصله پس از انجام پرداخت مطلع می‌شود. پول به حساب تجاری خودتان در Sham Cash واریز می‌شود.

  1. یک حساب تجاری تأییدشده در Sham Cash باز کنید، سپس از پشتیبانی Sham Cash بخواهید یک سرویس پرداخت الکترونیکی برای شما بسازد (آدرس لوگوی شما و نامی را که کاربران می‌بینند می‌خواهند).
  2. Sham Cash سه مقدار به شما می‌دهد: Agent Key، Secret Key و Base URL. سرویس آزمایشی و سرویس واقعی هر کدام سه مقدار خود را دارند.
  3. در SAMM مسیر مالی → پرداخت‌های آنلاین → Sham Cash را باز کنید، اتصال را روی Official API نگه دارید، سه مقدار را جای‌گذاری کنید، ارز را انتخاب کنید (USD یا SYP، همان ارز SAMM شما) و ذخیره را بزنید، سپس اجرای تست.
  4. SAMM باید از اینترنت قابل دسترسی باشد تا Sham Cash بتواند هر پرداخت را تأیید کند. اگر SAMM شما تحت آدرس دیگری منتشر شده است، آن را در آدرس عمومی SAMM برای فراخوانی بازگشتی وارد کنید. هیچ تنظیم خاصی در سمت Sham Cash لازم نیست: SAMM آدرس خود را با هر پرداخت ارسال می‌کند.
سرویس آزمایشی یا سرویس واقعی با مقادیر آزمایشی هر پرداخت یک شبیه‌سازی است: صفحه پرداخت کد 000000 را می‌پذیرد، SAMM صورتحساب را پرداخت‌شده نشان می‌دهد و هیچ پولی به هیچ حسابی نمی‌رسد. پرداخت واقعی به مقادیر سرویس واقعی شما از پشتیبانی Sham Cash نیاز دارد. Base URL ذخیره‌شده را بررسی کنید: آدرس آزمایشی همان آدرس واقعی نیست.

آنچه کاربر انجام می‌دهد: روی کارت پرداخت دکمه باز کردن Sham Cash را می‌زند. در تلفن، اپلیکیشن Sham Cash (نسخه 2.2.5 یا جدیدتر) و در غیر این صورت وب‌سایت Sham Cash باز می‌شود؛ مبلغ را بررسی می‌کند و با کد تأیید انتقال خود (که در اپلیکیشن Sham Cash تنظیم شده) تأیید می‌کند. در کامپیوتر، کارت یک کد QR هم نشان می‌دهد که با دوربین تلفن اسکن می‌شود. هر لینک پرداخت ۱۰ دقیقه اعتبار دارد و کارت به محض تأیید Sham Cash خودش تأیید می‌شود.

اپلیکیشن اختصاصی Sham Cash نیز می‌تواند پرداخت‌ها را برای شما انجام دهد: به آن توکنی بدهید که فقط مجوز اپلیکیشن‌های پرداخت را دارد (بخش API REST را ببینید). آن کاربر را با نام کاربری جستجو می‌کند و پرداخت انجام‌شده را ثبت می‌کند.

Sham Cash بدون کلیدهای پذیرنده (Non-official API)

سرویس پذیرندگی از Sham Cash ندارید؟ SAMM می‌تواند پرداخت‌های Sham Cash را از طریق shamcash-api.com دریافت کند؛ یک سرویس مستقل (نه Sham Cash) که انتقال‌های واریزی به حساب Sham Cash خود شما را می‌خواند. فقط می‌تواند بخواند: نمی‌تواند پول ارسال کند.

  1. در shamcash-api.com حساب بسازید و حساب Sham Cash خود را متصل کنید: در برنامه Sham Cash بخش حساب من → دستگاه‌های متصل را باز کنید و کد QR آنها را اسکن کنید. اشتراک را شروع کنید و یک کلید API فقط‌خواندنی بسازید.
  2. در SAMM مسیر مالی → پرداخت‌های آنلاین → Sham Cash را باز کنید، اتصال را روی Non-official API (shamcash-api.com) بگذارید، کلید API را جای‌گذاری کنید، ارز را انتخاب کنید و ذخیره را بزنید. SAMM شناسه حساب و آدرس Sham Cash شما را از کلید می‌خواند. سپس اجرای تست.

کاری که کاربر انجام می‌دهد: کارت پرداخت آدرس Sham Cash شما (و کد QR آن)، مبلغ و یک کد کوتاه مانند SM-1234 را نشان می‌دهد. کاربر مبلغ را از برنامه Sham Cash خود می‌فرستد و کد را در یادداشت انتقال می‌نویسد. SAMM پرداخت را ظرف یک دقیقه تأیید می‌کند. انتقالی که کد ندارد، کمتر از مبلغ است یا با ارز دیگری است، به‌جای اعمال شدن برای بررسی شما نگه داشته می‌شود.

صفحه پرداخت و تمدید آنلاین

تنظیمات → صورتحساب → صفحه پرداخت یک صفحه عمومی را در /pay فعال می‌کند: یک کاربر نام کاربری خود را وارد می‌کند، مبلغ بدهی خود را مشاهده می‌کند و بدون ورود به سیستم پرداخت می‌کند. همان صفحه پرداخت در پورتال کاربر برای کاربران وارد شده نیز وجود دارد.

  • تمدید: کاربران می‌توانند طرح خود را آنلاین برای ۱ تا ۱۲ دوره، پیش یا پس از انقضا، تمدید کنند. پرداخت زودهنگام زمان باقی‌مانده را حفظ می‌کند؛ کاربر منقضی‌شده به محض رسیدن پرداخت دوباره آنلاین می‌شود. دو کلید محل نمایش را تعیین می‌کنند: تمدید در صفحه پرداخت و تمدید در پورتال کاربر (هر دو به‌طور پیش‌فرض روشن).
  • یافتن کاربران بدون پیشوند یا پسوند: برای نام‌های کاربری مانند 858000@inet، تایپ 858000 (حداقل ۶ نویسه) حساب را پیدا می‌کند. اگر بیش از یک حساب مطابقت داشته باشد، نام کاربری کامل خواسته می‌شود. به‌طور پیش‌فرض خاموش است.
  • انتخاب کنید صفحه چه چیزهایی از حساب نشان دهد (نام پوشیده، طرح، تاریخ انقضا و موارد دیگر)؛ به‌طور پیش‌فرض فقط نام پوشیده نشان داده می‌شود.

آنچه مشترک می‌بیند

  1. آنها به پورتال مشتری وارد می‌شوند → فاکتورهای من.
  2. در صورتی که فاکتور بدون پرداخت باشد، روی دکمه پرداخت (یا "پرداخت · Stripe" / "پرداخت · Binance" در صورت فعال بودن چندین گزینه) کلیک می‌کنند.
  3. کارت: به صفحه امن درگاه هدایت می‌شوند. ارز دیجیتال: مبلغ دقیق، آدرس شما همراه با کد QR و/یا Pay ID شما را می‌بینند.
  4. پس از پرداخت، فاکتور به حالت «پرداخت شده» تغییر می‌کند، در حساب‌های شما ثبت می‌شود و اگر منقضی شده بودند، به‌طور خودکار دوباره متصل می‌شوند — حتی مشترکین منقضی‌شده دکمه «پرداخت و دوباره اتصال» & را در صفحه منقضی‌شده مشاهده می‌کنند.
کتاب های شما دقیق می مانند هر پرداخت آنلاین یک بار ورود متوازن (دکتر نقدی / حساب های دریافتنی Cr) را ارسال می کند و روش ( Stripe / Binance ) را در فاکتور، سابقه پرداخت و در PDF ثبت می کند — بنابراین شما همیشه بدانید که هر پرداخت چگونه وارد شده است.

عملیات روزانه

تیکت‌های پشتیبانی

SAMM یک میز پشتیبانی درون‌ساخته دارد. مشترکان از پرتال مشتری یا ربات Telegram تیکت ثبت می‌کنند، یک مدیر می‌تواند به نمایندگی از یک مشترک تیکتی باز کند، و تیم شما همه آن‌ها را از Users → Support Tickets مدیریت می‌کند.

صف تیکت‌ها

صف هر تیکت را فهرست می‌کند — شماره، مشتری، موضوع، اولویت، وضعیت، تاریخ‌های باز شدن و آخرین به‌روزرسانی، و تعداد پیام‌ها. آن را با موارد زیر فیلتر کنید:

  • تراشه‌های وضعیت — یکی برای هر وضعیت تیکت، هرکدام دارای یک شمارش زنده، تا حجم کار در یک نگاه دیده شود.
  • اولویت — Normal، Moderate یا Critical.
  • Active / Withdrawn — یک مشتری می‌تواند تیکتی را که دیگر نیازی به آن ندارد پس بگیرد؛ تیکت‌های پس‌گرفته‌شده کم‌رنگ و به‌طور پیش‌فرض پنهان می‌شوند.
  • Search — بر اساس شماره تیکت، موضوع یا مشتری.

نشان نوار کناری تیکت‌های باز را می‌شمارد تا چیزی از قلم نیفتد.

باز کردن یک تیکت

New ticket به یک مدیر اجازه می‌دهد برای یک مشتری انتخاب‌شده تیکتی ثبت کند — مشتری را انتخاب کنید، سپس یک موضوع، اولویت و شرح تعیین کنید. مشترکان نیز تیکت خود را از پرتال مشتری یا ربات Telegram باز می‌کنند.

رسیدگی به یک تیکت

یک تیکت را باز کنید تا کل رشته گفتگو را بخوانید. از آنجا می‌توانید:

  • پاسخ به مشتری — یک پیام عمومی که مشترک آن را در پرتال خود و از طریق ربات Telegram می‌بیند.
  • افزودن یک یادداشت داخلی — یک پیام فقط برای کارکنان، پنهان از مشتری، برای یادداشت‌های تحویل میان اعضای تیم شما.
  • وضعیت و اولویت تیکت را تغییر دهید.

روی هر ردیف کلیک راست کنید — یا از دکمه ⋮ آن استفاده کنید — برای همان اقدام‌های وضعیت، اولویت، پاسخ و یادداشت داخلی بدون ترک صف.

عملیات روزانه

مرکز اعلان‌ها

SAMM مشترکین را بطور خودکار در جریان قرار می دهد — از طریق ایمیل ، Telegram , SMS و WhatsApp — و به شما امکان می دهد پیام ها را پخش کنید. را سرویس samm-notification همه چیز را از طریق یک صف محدود تحویل می دهد. صفحه سیستم → مرکز اطلاع رسانی دارای شش برگه است.

نمای کلی

تب فرود — شمارش‌های زنده (در صف، در حال ارسال، ارسال‌شده امروز، ناموفق، رد شده، انصراف‌داده)، وضعیت هر کانال تحویل و یک فید از جدیدترین اعلان‌ها.

کانال‌ها

نحوه خروج پیام‌ها از SAMM را پیکربندی کنید. ایمیل از اعلان خود استفاده می کند حساب، جدا از SMTP بازیابی رمز عبور نگهداری می شود تنظیمات . Telegram از یک رمز ربات استفاده می کند، پیامک از طریق یک دروازه HTTP عمومی یا Twilio می رود، و WhatsApp از API رسمی Meta WhatsApp Cloud (ایجاد شده در Meta برای توسعه دهندگان)، با یک پل غیر رسمی مرتبط با QR اختیاری با مسئولیت خودتان - پل با یک کلیک روی یک سرور بدون سیستم عامل نصب می شود و به عنوان یک ظرف آماده برای اجرا در Docker ارسال می شود. تمام اسرار کانال ذخیره می شود رمزگذاری شده با فرنت هر مشترک، از پورتال مشتری، کانال های خود را انتخاب می کند می خواهد و می تواند به طور کامل انصراف دهد.

SMS gateways همچنین می‌تواند در حالت الگو ارسال کند، برای اپراتورهایی که فقط قالب‌های تاییدشده را می‌پذیرند: شما نام قالب را ارائه می‌دهید و SAMM مقادیر را در نظم مورد انتظار قالب ارسال می‌کند. فرمت عددی را انتخاب کنید که هر درگاه می‌خواهد (بین‌المللی با + یا 00، یا ملی با یا بدون صفر اولیه). یک لینک درگاه کارآمد از ارائه‌دهنده خود را کپی کنید و SAMM فیلدهای مورد نظر، حالت قالب و فرمت عددی را برای شما پر می‌کند.

پیام‌ها

قالب‌های پیام، یک مجموعه برای هر رویداد. متن هر اعلان — یادآوری‌های تمدید، رسیدها و بقیه — را ویرایش کنید تا هر پیام با لحن و زبان خودتان ارسال شود.

قواعد و تایمرها

این تب تعیین می‌کند که اعلان‌های خودکار چه زمانی و چگونه فعال شوند. برای هر رویداد شما کنترل می‌کنید:

  • اینکه آیا قاعده روشن است.
  • Ignore opt-out — وقتی تنظیم شود، پیام به هر مشترکی می‌رسد حتی اگر انصراف داده باشد. آن را برای پیام‌های تراکنشی مهم نگه دارید.
  • زمان‌بندی — برای مثال، چند روز پیش از انقضا یک یادآوری تمدید ارسال می‌شود.
  • تحویل و throttling — worker صف را در هر tick یک دسته تخلیه می‌کند؛ اندازه دسته و بازه tick با هم سرعت خروج پیام‌ها را تنظیم می‌کنند، تا یک ارسال همگانی بزرگ هرگز سرور ایمیل شما را غرق نکند.

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

ارسال همگانی

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

صندوق خروجی

هر پیامی که SAMM به صف افزوده یا ارسال کرده، به همراه وضعیت تحویل هر پیام، تا بتوانید تأیید کنید که یک اعلان به مشترک رسیده یا ببینید چرا نرسیده است.

سیستم

VPN: WireGuard، L2TP/IPsec، SSTP

سامم (SAMM) سرور VPN اختصاصی خود را بر روی میزبان سامم (SAMM host) اجرا می‌کند تا روترها در هر مکانی — حتی پشت NAT، بر روی خط موبایل، یا در شهری دیگر — به سامم (SAMM) برای دسترسی به RADIUS و مدیریت متصل شوند. همه چیز در زیر سیستم → VPN قرار دارد؛ نیازی به خط فرمان نیست. نصب‌های جدید با هر سه آماده می‌آیند، هر کدام تا زمانی که آن‌ها را روشن نکنید، خاموش هستند.

نوعاز آن استفاده کنید
WireGuardروترهای RouterOS 7، تلفن‌ها و لپ‌تاپ‌ها. سریع‌ترین و ساده‌ترین.
L2TP/IPsecروترهای RouterOS 6 و 7 و دستگاه‌هایی که فاقد WireGuard هستند.
SSTPدو یا چند روتر که از طریق همان آدرس عمومی به اینترنت متصل می‌شوند، در RouterOS 6 یا 7.

تب Server

  1. برای WireGuard، بر روی تولید کلیدها کلیک کنید تا جفت کلید سرور را ایجاد کنید.
  2. پورت گوش دادن، آدرس تونل سرور و محدوده آدرس مشتری را بررسی کنید، یا تنظیمات پیش‌فرض را حفظ نمایید.
  3. سرور را روشن کنید. یک پنجره‌ی پراکنده هر تغییر را تأیید می‌کند.

اگر میزبان SAMM آدرس خصوصی داشته باشد و آدرس عمومی شما به آن ارسال شود، SAMM آدرس عمومی (یا شما آن را یک‌بار در صفحه VPN وارد می‌کنید) را به هر کلاینت و روتر می‌دهد.

یک روتر اضافه کنید

برای نام‌گذاری آن، روی مشتری اضافه کنید کلیک کنید. برای یک MikroTik، خط یک‌خطی لینک نصب را کپی کرده و در ترمینال روتر جای‌گذاری کنید: این تونل را تنظیم می‌کند، ورود SAMM اختصاصی روتر، پیکربندی RADIUS و صفحه کاربران منقضی‌شده را در یک مرحله. انتخاب کنید که SAMM چگونه روتر را اضافه می‌کند:

  • NAS مدیریت‌شده — روتر کاربران شما را از طریق SAMM احراز هویت می‌کند و SAMM آن را مدیریت می‌کند.
  • تنها نظارت — برای نقاط دسترسی و دستگاه‌های دیگر که می‌خواهید (سلامت، نقشه، صفحه بی‌سیم) را بدون ورود کاربران از طریق آنها نظارت کنید.

یک روتر که توسط کارکنان شعبه اضافه شده است، متعلق به شعبه آن است. مشتریان WireGuard نیز می‌توانند با فایل پیکربندی یا کد QR برای اپلیکیشن موبایل اضافه شوند. مشتریان می‌توانند نام‌گذاری، خاموش یا حذف شوند؛ رنگ آنها نشان‌دهنده اتصال، منقضی شده یا هرگز مشاهده نشده است.

تولید مجدد کلیدها مخرب است بازسازی کلیدهای WireGuard سرور جفت کلید را تغییر می‌دهد. هر کلاینت که قبلاً تنظیم شده است، تا زمانی که پیکربندی جدید را دریافت نکند، از اتصال بازمی‌ماند. پنل از شما می‌خواهد یک کلمه برای تأیید تایپ کنید.

شبکه & روترها

RouterOS 6 و 7

SAMM مدیریت روترها را در RouterOS 6 و RouterOS 7 به صورت همزمان انجام می‌دهد. شما کاری متفاوت انجام نمی‌دهید: SAMM نسخه هر روتر را می‌خواند و دستوراتی را ارسال می‌کند که آن نسخه درک می‌کند.

همه چیز در هر دو حالت کار می‌کند: ویزارد تنظیمات، اتمام خودکار، تحویل پیکربندی، اقدامات مدیریت، وب‌سایت‌ها & اپلیکیشن‌ها، کیفیت خدمات (QoS)، NTP، صفحه کاربران منقضی‌شده و WireGuard (RouterOS 7)، L2TP/IPsec و لینک‌های SSTP. در RouterOS 6، لیست‌های وب‌سایت‌ها & اپلیکیشن‌ها از نام‌های دامنه کاتالوگ ساخته می‌شوند، زیرا نسخه 6 لیست‌های آدرس DNS را ندارد.

روترهای قدیمی بدون WireGuard RouterOS 6 هیچ WireGuard ندارد. آن روترها را از طریق L2TP/IPsec یا SSTP وارد کنید.

شبکه & روترها

ارسال پیکربندی

هر تغییر SAMM که به روترهای شما ارسال می‌شود — RADIUS صفحه منقضی‌شده، ویزارد، فیلتر DNS، وب‌سایت‌ها & برنامه‌ها، کیفیت سرویس (QoS)، امنیت خودکار، DNS، NTP و کنترل والدین — یک تحویل است که می‌توانید زیر دستگاه‌ها → تحویل پیکربندی پیگیری کنید.

  • نوار پیشرفت و نتیجه برای هر روتر، همراه با دلیل دقیق زمانی که روتر تغییری را رد می‌کند.
  • روتری که از حالت غیرفعال خارج شده، بلافاصله تغییرات را دریافت می‌کند؛ تغییرات ناموفق به طور خودکار دوباره تلاش می‌کنند، و تکرار با یک کلیک انجام می‌شود.
  • هر تغییر پس از اعمال، در روتر بررسی می‌شود و RADIUS و QoS هرگز خالی نمی‌مانند در حین انجام آن.

شبکه & روترها

عملیات مدیریت دستگاه‌ها روی چندین روتر

در دستگاه‌ها → مدیریت، روترها را علامت‌گذاری کنید و عملیات را باز کنید تا یک کار را بر روی همه آنها اجرا کنید: برنامه‌های وب‌سایت‌ها را &، پیکربندی RADIUS را ارسال کنید، صفحه کاربران منقضی‌شده را تنظیم کنید، امنیت روتر، پشتیبان‌گیری و صادرات، RouterOS به‌روزرسانی، یک اسکریپت را اجرا کنید، یا راه‌اندازی مجدد کنید.

هر دیالوگ از تنظیمات کامل یافت‌شده در میان روترهایی که انتخاب کرده‌اید آغاز می‌شود. کارها در پس‌زمینه اجرا می‌شوند: می‌توانید صفحه را ترک کنید و یک پنجره پاپ‌آپ به شما اطلاع می‌دهد که هر روتر به اتمام رسیده یا چرا شکست خورده است. اقدامات پرخطر از شما می‌خواهد که یک کلمه را برای تأیید تایپ کنید. مدیریت‌کننده همچنین شعبه هر روتر را نشان می‌دهد.

شبکه & روترها

شتاب‌دهنده سرعت پویا

در حالی که اینترنت روتر بدون استفاده است، به کاربران خود سرعت بیشتری به صورت رایگان ارائه دهید — و آن را در لحظه‌ای که خط شلوغ می‌شود، بازپس بگیرید. آن را در زیر ابزار → افزایش سرعت → پویا (به طور پیش‌فرض خاموش) فعال کنید و برنامه‌هایی را که ممکن است افزایش یابد، انتخاب نمایید.

  • هر کسی که آنلاین از طریق آن روتر دسترسی دارد، همان چند برابر سرعت دانلود خود را دریافت می‌کند، به‌طور پیش‌فرض تا سه برابر.
  • تقویت‌کننده ساعات شلوغ و کم‌ترافیک هر روتر را (به‌طور پیش‌فرض 3 روز، روزهای اخیر بیشترین وزن را دارند) یاد می‌گیرد، هر 15 دقیقه برنامه‌ریزی می‌کند، نگاهی به یک ساعت آینده می‌اندازد و به‌تدریج گام‌به‌گام افزایش تقویت را اعمال می‌کند.
  • یک نگهبان هر دقیقه بررسی می‌کند و افزایش را بلافاصله پس از بازگشت ترافیک پایان می‌دهد. روترهایی که بیشتر روزها شلوغ هستند، هرگز افزایش نمی‌یابند.
  • کاربران در پورتال خود نشانگر افزایش‌یافته را مشاهده می‌کنند؛ لیست کاربران ستون و فیلتر «افزایش‌یافته» دارد.

عملیات روزانه

فعال‌سازی‌ها & لاگ داده‌ها

فعال‌سازی‌ها

بررسی کلی → فعال‌سازی‌ها نشان‌دهنده پلن‌هایی است که در این هفته، ماه، سال یا بین دو تاریخ فعال‌سازی بیشتری داشته‌اند، در مقایسه با دوره قبل: تجدید نظرها، کاربران جدید و تغییرات پلن. لیست‌های «بر اساس پلن» و «بر اساس کاربر» دارای قابلیت جستجو، فیلتر، مرتب‌سازی و صادرات به اکسل یا CSV هستند.

لاگ داده‌ها

بررسی کلی → ثبت داده‌ها به‌طور همزمان ثبت داده‌های هر کاربر را جستجو می‌کند: پیدا کنید که چه کسی به یک آدرس یا یک بازه، یک پورت، یک پروتکل یا یک برنامه دسترسی پیدا کرده است، در هر دوره‌ای. نتایج را گروه‌بندی کنید، نگاه‌ها را ذخیره کنید و به فرمت CSV یا XLSX صادر کنید. مدت زمان نگهداری تاریخچه به انتخاب شماست، در تمیزکننده تاریخچه تنظیم شده است.

پذیرش لاگ

لاگ پذیرش نشان می‌دهد که هر تلاش ورود از کدام روتر بوده است، با جستجو، گروه‌بندی، مرتب‌سازی و صادرات بر اساس روتر.

سیستم

برندسازی: لوگو، نام و رنگ شما

ظاهر کردن SAMM به‌شکل شرکت شما. همه چیز در System → Settings → ISP است.

لوگوی شما

  1. روی کاشی لوگو یا بارگذاری لوگو بزنید و یک تصویر PNG، JPEG، WebP یا GIF انتخاب کنید (حداکثر 5 MB).
  2. تصویر را بکشید و قرار دهید و از اسلایدر برای زوم کردن استفاده کنید. پس‌زمینه شفاف باقی می‌ماند.
  3. بر روی استفاده از لوگو کلیک کنید: بلافاصله به صورت یک مربع 400×400 پیکسل ذخیره می‌شود. حذف آن را حذف می‌کند.

لوگو در صورتحساب‌ها، رسید‌ها، کارت‌های داغ شده نقطه داغ، صفحه منقضی شده و صفحات ورود روترها استفاده می‌شود.

برچسب‌گذاری روی پنل‌ها

دکمه‌ی استفاده از برند من بر روی پنل‌ها را روشن کنید و نام، رنگ و یک خط متن پایانی (مانند شماره‌ی پشتیبانی خود) را تنظیم نمایید، سپس بر روی ذخیره در تب ISP کلیک کنید. برند شما سپس جایگزین برند SAMM در پنل‌های مدیریتی، پورتال کاربران و هر دو صفحه‌ی ورود می‌شود. آن را خاموش کنید و همه چیز به حالت عادی بازمی‌گردد.

سیستم

Cloudflare Tunnel

یک تونل Cloudflare Zero Trust، SAMM را به اینترنت عمومی منتشر می‌کند بدون باز کردن هیچ پورت فایروال — هنگامی که میزبان SAMM پشت NAT قرار دارد مفید است. این از System → Cloudflare Tunnel مدیریت می‌شود.

وضعیت سرویس

صفحه با یک کارت وضعیت باز می‌شود که حالت connector را گزارش می‌دهد:

حالتمعنا
در حال اجراتونل فعال است و ترافیک را forward می‌کند
متوقف‌شدهپیکربندی‌شده اما اکنون در حال اجرا نیست
پیکربندی‌نشدهباینری موجود است — برای راه‌اندازی آن یک توکن جای‌گذاری کنید
نصب‌نشدهاجرای مجدد install.sh برای نصب فایل اجرایی cloudflared

همچنین نسخه cloudflared و اینکه آیا connector برای اجرای خودکار هنگام بوت (auto-start at boot) تنظیم شده است یا خیر را نمایش می‌دهد.

پیکربندی تونل

  1. در داشبورد Cloudflare Zero Trust (one.dash.cloudflare.com)، مسیر Networks → Tunnels را باز کرده و روی Create a tunnel کلیک کنید.
  2. کانکتور Cloudflared را انتخاب کنید، نامی برای تونل تعیین نمایید و ذخیره کنید. در مرحله نصب، فقط توکن — رشته طولانی بعد از --token — را کپی کنید.
  3. آن را در SAMM جای‌گذاری کنید و روی Configure Tunnel کلیک کنید. SAMM توکن را به cloudflared تحویل داده و کانکتور را اجرا می‌کند.
  4. در Cloudflare، یک Public hostname اضافه کنید: آدرس انتخابی خودتان، نوع HTTP، URL localhost:80 (پروکسی‌شده توسط nginx — توصیه شده) یا localhost:8000 (اتصال مستقیم به API).

طی چند ثانیه نشان وضعیت سبز شده و SAMM از طریق hostname عمومی در دسترس قرار می‌گیرد. پس از پیکربندی، با استفاده از قابلیت‌های تک‌کلیکی می‌توانید کانکتور را Start، Stop یا Restart کنید، برای چرخش توکن از Replace Token استفاده نمایید یا تونل را حذف کنید Remove tunnel (اقدامی که برای تأیید نیاز به تایپ REMOVE دارد).

هیچ پورت بازی وجود ندارد، توکن هرگز در database نیست تونل یک اتصال خروجی به edge شرکت Cloudflare برقرار می‌کند — هیچ پورت فایروالی روی سرور باز نمی‌شود. توکن به cloudflared ارسال و در /etc/cloudflared/ ذخیره می‌شود؛ SAMM هرگز آن را در دیتابیس ذخیره نمی‌کند. TLS در edge شرکت Cloudflare خاتمه می‌یابد، بنابراین SAMM خود روی loopback به‌صورت HTTP ساده اجرا می‌شود.

سیستم

تنظیمات

System → Settings شامل تنظیمات زنده و قابل به‌روزرسانی فوری (hot-reloadable) است. دیمون‌ها در تیک بعدی خود آن‌ها را مجدداً می‌خوانند — نیازی به ری‌استارت سرویس نیست. تنظیمات در زبانه‌های مختلف سازمان‌دهی شده‌اند.

تنظیمات کلی

تنظیماتپیش‌فرضکنترل‌ها
samm-radius interval30 sتواتر ارزیابی رویدادهای زمان‌محور و ارسال CoAها
samm-worker interval5 sبازه زمانی ping روتر + همگام‌سازی MikroTik API
بازه زمانی موقت حساب60 sبازه زمانی accounting ارسال‌شده به روترها
زمان بازنشانی روزانه00:00هنگام بازگشت شمارنده‌های مصرف روزانه به صفر
منطقه زمانی سرورUTCمنطقه زمانی برای بازه‌های زمانی سرعت و بازنشانی روزانه
پورت پیش‌فرض CoA3799پورت UDP پیش‌فرض برای بسته‌های CoA
حداکثر تعداد تلاش‌های مجدد CoA3تعداد تلاش‌های مجدد پیش از بازگشت به حالت پشتیبان Disconnect-Request

برای اعمال سخت‌گیرانه‌تر، بازه زمانی samm-radius را کاهش دهید؛ برای کاهش بار، آن را افزایش دهید.

هویت ISP، لوگو، واحد پول & صورت‌حساب (زبانه ISP)

هر آنچه که اکثر اپراتورها می‌پرسند «کجا این مورد را تغییر دهم؟» در مسیر System → Settings → ISP قرار دارد. یک فیلد را ویرایش کرده و روی Save کلیک کنید — تغییرات بلافاصله (بدون نیاز به restart) اعمال شده و در فاکتورها، رسیدها، PDFها و پورتال مشتری منعکس می‌شود.

تغییرات اعمال‌شدهجایی که نمایش داده می‌شود
نام ISPفاکتورها، رسیدها، کارت‌های hotspot، سربرگ پورتال
تلفن پشتیبانی & ایمیلفاکتورها و کارت‌های چاپ‌شده Hotspot
شماره مالیاتی / ثبتچاپ در فاکتورها
لوگوی ISP (آپلود PNG/JPEG/WebP/GIF)آپلود کنید، سپس برای برش در مرورگر، آن را بکشید و زوم کنید؛ این تصویر در PDFهای فاکتور/رسید، کارت‌های چاپ‌شده hotspot و صفحات ورود روتر نمایش داده می‌شود. به Branding مراجعه کنید.
کد ارز (e.g. USD)ارز ISO در صورت‌حساب‌ها و دفتر کل
نماد ارز (e.g. $)تمام مبالغ نمایش‌داده‌شده در UI مدیر، پورتال مشتری و PDFها
فعال/غیرفعال‌سازی مالیات، برچسب & نرخیک ردیف VAT/GST به فاکتورها اضافه می‌کند (به‌عنوان مثال برچسب VAT، نرخ 11 = 11%)
تغییر نماد ارز برای تغییر واحد پولی نمایش‌داده‌شده در همه جای سیستم (مثلاً از $ به £ یا یک نماد محلی)، در زبانه ISP گزینه Currency symbol را تنظیم کرده و ذخیره کنید — این کار پنل مدیر، پورتال مشتری و تمام فایل‌های PDF را به‌طور هم‌زمان به‌روزرسانی می‌کند. در کنار آن، Currency code (مانند USD، EUR، …) را برای کد ISO که روی فاکتورها چاپ می‌شود، تنظیم کنید.

حریم خصوصی — آمار نصب ناشناس

هنگامی که SAMM به‌روزرسانی‌ها را بررسی می‌کند، می‌تواند یک install ID تصادفی، نسخه SAMM، سطح پلن شما و کشور تقریبی (بر اساس IP شما و از طریق Cloudflare) را به SecuryTik ارسال کند — بدون هیچ‌گونه داده‌ای از مشترک یا مشتری. این کار تنها به ما در شمارش نصب‌های فعال و اولویت‌بندی پشتیبانی و زبان‌ها کمک می‌کند. هر زمان که بخواهید می‌توانید این قابلیت را در مسیر System → Settings → Privacy غیرفعال کنید؛ سیاست حریم خصوصی را مشاهده کنید.

زبانه Email

سرور SMTP مورد استفاده برای کدهای بازیابی رمز عبور که برای مدیران و مشتریان ارسال می‌شود را پیکربندی کنید (host، پورت، SSL/STARTTLS، username، from-address، password). برای تأیید اعتبار اطلاعات بدون ارسال ایمیل، روی Test connection کلیک کنید.

دو حساب ایمیل زبانه Email در اینجا فقط برای OTP / بازیابی رمز عبور است. حسابی که برای اعلان‌های مشتری استفاده می‌شود، به‌طور جداگانه در Notification Center پیکربندی می‌شود.

سیستم

مدیران، شعبه‌ها & نقش‌ها

System → Admins جایی است که تعیین می‌کنید چه کسی می‌تواند به پورتال مدیر وارد شود، هر فرد چه کارهایی می‌تواند انجام دهد و کدام کاربران را می‌تواند ببیند. از نسخه 5.1.0، مدیران یک درخت از شعبه‌ها و کارکنان را تشکیل می‌دهند. این صفحه دارای دو زبانه است: Admins و Roles.

شعبه‌ها و کارکنان

گرهمعرفی
شعبهیک مکان — یک دفتر، یک شهر. این مکان مالک کاربرانی است که در آن ایجاد شده‌اند. هیچ‌کس به‌عنوان یک شعبه وارد نمی‌شود: شعبه هیچ رمز عبور و نقشی ندارد.
مدیر (کارکنان)شخصی که وارد حساب کاربری می‌شود. در صورت قرارگیری زیر یک شعبه، کارکنان آن شعبه محسوب می‌شوند: هر کاربر و کارتی که ایجاد کنند به آن شعبه تعلق دارد.
Superadminهمیشه در بالای درخت و هرگز زیر یک شعبه قرار ندارد. همه چیز را می‌بیند و قادر به انجام هر کاری است.

برای ساخت درخت از + Branch و + Admin استفاده کنید و برای جابه‌جایی یک گره، آن را روی گره دیگر بکشید. تنها یک شعبه می‌تواند مدیرانی زیرمجموعه خود داشته باشد. یک agent مدیری است که خدمات را می‌فروشد و مالک آن‌هاست؛ کارکنانی که زیرمجموعه یک agent قرار می‌گیرند، از کیف پول و قوانین تأییدیه آن agent استفاده می‌کنند.

چه کسی چه چیزی را می‌بیند

قابلیت مشاهده از ساختار درختی پیروی می‌کند. یک شعبه — و تمام افرادی که در آن فعالیت می‌کنند — کاربران خود و کاربران شعب زیرمجموعه‌اش را می‌بینند. این شعبه هرگز یک شعبه هم‌رده یا شعبه بالادستی را نمی‌بیند. HQ همه چیز را می‌بیند. مجوزهای یک مدیر هرگز بیشتر از آنچه مدیران بالادستی اجازه داده‌اند نیست و یک مدیر تنها می‌تواند مجوزهایی را اعطا کند که خودش داراست.

محدودیت‌ها به‌ازای هر شعبه

محدود کردنچه مواردی شمارش می‌شوند
حداکثر تعداد کاربرتعداد کاربرانی که شعبه و شعبه‌های زیرمجموعه آن می‌توانند داشته باشند. حذف یک کاربر، یک جایگاه را آزاد می‌کند.
حداکثر تعداد کارت‌هاچه تعداد کارت hotspot در شعبه قابل چاپ است.

زمانی که هر محدودیتی در سطح مدیر ایجادکننده یا بالاتر از او تکمیل شود، کاربر یا کارت جدید رد می‌شود و پیامی مبنی بر نوع محدودیت و مقدار باقی‌مانده نمایش داده می‌شود. برای عدم اعمال محدودیت، فیلد مربوطه را خالی بگذارید. هر دو مورد بعداً از طریق دیالوگ Edit قابل تغییر هستند.

دستگاه‌های یک شعبه

هر روتر، از جمله access point، به یک شعبه یا به Headquarters تعلق دارد. منوی یک شعبه را باز کرده و Assigned devices را انتخاب کنید تا دستگاه‌های متعلق به آن را علامت بزنید؛ دستگاهی که علامت آن را بردارید به Headquarters باز می‌گردد که بین تمام شعب مشترک است. دستگاهی که توسط کارکنان شعبه (از طریق مدیریت دستگاه‌ها، فرم مانیتور یا لینک نصب VPN) اضافه شود، در شعبه آن‌ها قرار می‌گیرد؛ دستگاهی که توسط Headquarters اضافه شود، در Headquarters قرار می‌گیرد.

چه کسیدستگاهِ شعبه
کارکنان آن شعبه، شعبه‌های بالاتر از آن و دفتر مرکزیمدیریت
کارکنان شعبه‌های زیرمجموعهمشاهده، فقط‌خواندنی
سایر شعبه‌هامشاهده نمی‌شود
کاربران آن شعبه و شعبه‌های زیرمجموعه آنامکان ورود از طریق آن وجود دارد

نقشه، صفحه Wireless، وضعیت سلامت و لیست روترها از همان قانون پیروی می‌کنند. بخش ورود به سیستم مربوط به تنظیم Users log in only through their branch's routers در Settings → Authentication است: برای نصب‌های جدید، این گزینه فعال است؛ در نصب‌های به‌روزرسانی‌شده‌ای که دستگاه‌های آن‌ها به شعبه‌ها اختصاص یافته است، این گزینه در ابتدا غیرفعال است تا دسترسی هیچ‌کس قطع نشود — پس از تخصیص دستگاه‌ها، آن را فعال کنید. کاربران General company می‌توانند از هر روتر استفاده کنند.

دریافت‌کنندگان هشدار به‌ازای هر شعبه

منوی یک شعبه همچنین دارای Alert recipients است: آدرس‌های e-mail، شماره‌های WhatsApp و SMS و چت‌های Telegram، هر کدام در یک خط. هنگامی که دستگاهی از آن شعبه (یا شعبه‌ای زیرمجموعه آن) قطع شود، دچار خطا شود، حمله‌ای را مسدود کند یا پیکربندی‌اش را از دست بدهد، به آن‌ها اطلاع داده می‌شود. دفتر مرکزی همچنان تمامی هشدارها را دریافت می‌کند.

لیست‌های قیمت

Financial → Price Lists (فقط superadmin) قیمت هر پلن و add-on را به‌ازای هر شعبه تعیین می‌کند. یک زیرشعبه از قیمت‌های شعبه مادر خود پیروی می‌کند مگر اینکه قیمت‌های اختصاصی داشته باشد، و یک شعبه جدید با قیمت کارتِ پلن شروع می‌کند. می‌توانید چندین قیمت را به‌طور هم‌زمان بر اساس درصد یا مبلغ ثابت و با قابلیت گرد کردن تغییر دهید؛ Reset All قیمت‌های یک شعبه را به حالت شعبه مادر بازمی‌گرداند و لیست برای بررسی قابل خروجی گرفتن است.

نقش‌ها & دسترسی‌ها

یک role دسترسی به هر بخش را اعطا می‌کند. SAMM چهار نقش آماده ارائه می‌دهد که می‌توانید آن‌ها را ویرایش یا حذف کنید — Manager (مدیریت دستگاه‌ها و عملیات روزمره)، Reseller، Accountant (امور مالی) و Monitor (فقط خواندنی) — و دو نقش داخلی قفل‌شده: superadmin (دسترسی کامل) و Agent که مدیر را به یک Reseller عمده‌فروش با موجودی پیش‌پرداخت و تقسیم کمیسیون تبدیل می‌کند (به Accounting & billing → Agents مراجعه کنید).

برای هر بخش از SAMM (کاربران، پلن‌ها، روترها، حسابداری، تنظیمات و غیره)، یک نقش در یکی از سه سطح تنظیم می‌شود:

سطحمعنا
غیرمجازاین بخش به‌طور کامل از نوار کناری پنهان شده است
مشاهدهدسترسی فقط‌خواندنی
ویرایشدسترسی کامل — ایجاد، تغییر، حذف

مدیران & نقش‌ها، ابزارها، API و پرداخت‌ها صرف‌نظر از تعریف هر نقش، در اختیار HQ باقی می‌مانند.

دو دسترسی در کنار سطوح ناحیه قرار دارند، زیرا هر یک بیشتر یک تصمیم مالی است تا یک تنظیمات نمایش:

تأییدقابلیت‌ها
مجاز کردن "No Invoice" سرویس یک کاربر را تغییر دهید — تمدید، تغییر پلن، تمدید زمان — و هیچ هزینه‌ای برای آن دریافت نکنید. این گزینه به‌صورت پیش‌فرض برای هر نقش جدید غیرفعال است.
اجازه تأیید Agentها درخواست‌های agentها برای بازگشت وجه را بررسی و تایید یا رد کنید. ایجاد و مدیریت agentها فقط برای superadmin امکان‌پذیر است. به Undo & approvals مراجعه کنید.

سطوح دسترسی دقیق

در بخش Edit، گزینه‌های Users، Cards، Financial و Routers دسترسی‌های مجزایی را باز می‌کنند — به‌عنوان مثال حذف کاربرها، تمدید، تغییر پلن، پرداخت فاکتورها، اعمال تخفیف و اجرای اسکریپت‌های روتر. هر یک از این موارد را برای یک نقش غیرفعال کنید؛ دکمه‌های مربوط به دسترسی‌هایی که آن نقش فاقد آن‌هاست، پنهان می‌شوند.

مدت زمان اعطای نقش

از اعطای چندین ماه سرویس توسط کارکنان جلوگیری کنید. در هر نقش:

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

Add days و Type an expiry date دسترسی‌های مجزایی در بخش Users هستند، بنابراین یک نقش می‌تواند بدون داشتن قابلیت تعیین تاریخ دلخواه، تمدید را انجام دهد. برای عدم اعمال محدودیت، فیلد را خالی بگذارید؛ superadmin هرگز محدود نمی‌شود. تغییرات دسته‌جمعی کاربرانی را که با این تغییر از حد مجاز فراتر می‌روند نادیده گرفته و دلیل آن را اعلام می‌کند.

همچنین می‌توان به یک نقش اجازه داد تا کارت هر کاربر & را در install مشاهده کند، صرف‌نظر از ساختار درختی. در صورت غیرفعال بودن این گزینه، نقش مربوطه تنها شعبه خود و شعب زیرمجموعه آن را مشاهده می‌کند.

داشبورد هرگز حذف نمی‌شود صرف‌نظر از اینکه چه دسترسی‌هایی از یک نقش سلب شده باشد، هر مدیر داشبورد و پروفایل خود را حفظ می‌کند — ورودی که منجر به خطای دسترسی شود، یک ورودی معیوب است، نه امن.
لایسنس همیشه در دسترس است صفحه System → License یک بلوک دسترسی معمولی است — اما هرگاه دستگاه در وضعیت lockdown (از نوع grace، soft یا hard) باشد، SAMM دسترسی به آن را برای هر مدیر وارد شده، صرف‌نظر از نقش او، فراهم می‌کند تا مسیر بازیابی هرگز مسدود نشود.

سیستم

ابزارها

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

پشتیبان‌گیری & بازیابی

پیش از هر تغییر عمده، یک snapshot کامل از database ایجاد کنید. یک backup، آرشیوی gzipped از pg_dump است که روی سرور ذخیره شده و هر یک دارای یک هدر SAMM هستند.

  • ایجاد پشتیبان — در صورت تمایل یادداشتی اضافه کنید؛ برای دریافت یک dump کوچک‌تر و سریع‌تر که جداول حجیم log را نادیده می‌گیرد، گزینه Skip usage & history را علامت بزنید.
  • یک نسخه پشتیبان را روی PC خود دانلود کنید، یا یک نسخه پشتیبان قبلی SAMM را مجدداً به سرور آپلود کنید.
  • Restore پایگاه داده فعلی را بازنویسی می‌کند — این عملیات توسط یک پنجره تأیید از نوع RESTORE کنترل می‌شود.

پایداری بالا

برای استقرار بدون نقطه شکست واحد، SAMM را روی دو گره اجرا کنید: PostgreSQL streaming replication (یک گره اصلی به همراه یک گره hot standby با تأخیر چند ثانیه‌ای) به‌علاوه یک گره AAA آماده‌به‌کار، و در صورت بروز خطا، عملیات promote + repoint را انجام دهید. دفترچه راهنمای کامل اپراتور — شامل تنظیمات replication، جایگزینی خودکار برنامه‌ریزی‌شده و برنامه‌ریزی‌نشده، failback، حالت اختیاری synchronous-replication و چک‌لیست تأیید پس از جایگزینی خودکار — در قالب docs/HA.md همراه با سورس ارائه شده است. توجه داشته باشید که replication جایگزین پشتیبان‌گیری (backup) نیست (یک حذف اشتباه فوراً تکثیر می‌شود)، بنابراین پشتیبان‌گیری‌های زمان‌بندی‌شده ذکرشده در بالا را نیز فعال نگه دارید.

پاک‌ساز تاریخچه

ردیف‌های قدیمی لاگ و تاریخچه را به‌طور دائمی حذف کنید تا فضای دیتابیس بازیابی شود. یک پیش‌تنظیم برای بازه نگهداری انتخاب کرده و تأیید کنید. ابزار پاک‌ساز، نشست‌های بسته شده RADIUS، رکوردهای پس از احراز هویت، مجموع‌های مصرف روزانه، تاریخچه روتر/اینترفیس، لاگ‌های محدودیت، ورودی‌های حسابرسی اعمال شده و ردیف‌های CoA به پایان رسیده را پاک می‌کند. این ابزار هرگز به نشست‌های فعال، دستورات در صف، CoAهای در انتظار یا مجموع مصرف مادام‌العمر غیرقابل بازنشانی دست نمی‌زند.

ابتدا یک backup تهیه کنید History Cleaner داده‌ها را به‌طور دائمی حذف می‌کند. اگر احتمال می‌دهید بعداً به این داده‌ها نیاز داشته باشید، پیش از پاک‌سازی یک backup بگیرید.

خروجی / ورودی

خروجی و ورودی دسته‌جمعی برای Users، Plans و NAS به‌صورت .csv یا .xlsx. یک قالب (ستون‌های صحیح به‌همراه یک ردیف نمونه) یا یک snapshot از داده‌های فعلی را دانلود کنید، آن را تکمیل کرده و مجدداً آپلود کنید. هر ردیف اعتبارسنجی شده و در یک صفحه پیش‌نمایش نمایش داده می‌شود — ردیف‌های تکراری و نامعتبر مشخص می‌شوند و شما پیش از ثبت هرگونه داده، انتخاب می‌کنید که ردیف‌های تکراری نادیده گرفته شوند یا به‌روزرسانی گردند.

تغییرات دسته‌جمعی

اعمال یک تغییر — مالک، تاریخ انقضا، وضعیت، تمدید خودکار، یا کل دوره‌های پلن — برای تمام مشترکانی که با یک فیلتر مطابقت دارند، در یک مرحله. تغییر مورد نظر را انتخاب کنید، فیلتر (وضعیت / پلن / مالک / جستجو) را بسازید، لیست موارد مطابقت‌یافته را بررسی و تایید کنید.

افزودن دوره‌های کامل پلن گزینه تمدید دسته‌جمعی است: هر مشترک به تعداد دوره‌های مشخص‌شده از پلن خودش دریافت می‌کند؛ بنابراین یک پلن 7 روزه در هر دوره 7 روز و یک پلن ماهانه یک ماه تقویمی دریافت می‌کند — در یک اجرای واحد و بدون نیاز به تفکیک اولیه لیست بر اساس پلن. مشترکانی که پلن آن‌ها تاریخ انقضا ندارد، به‌جای حدس زدن، نادیده گرفته می‌شوند. افزودن روز برای مواردی که تعداد ثابتی از روزها را بدون بازنشانی شمارنده می‌خواهید، در دسترس باقی می‌ماند.

افزایش سرعت

سرعت تمام پلن‌ها به‌طور هم‌زمان را بر اساس یک درصد افزایش یا کاهش دهید — مثلاً سرعت دوبرابر در تعطیلات آخر هفته، یا محدود کردن سرعت در مواقع اضطراری هنگام افت کیفیت backhaul. این تغییرات بلافاصله برای ورودهای جدید و نشست‌های فعال اعمال می‌شود.

کنترلعملکرد
درصدمقادیر مثبت باعث ضرب و مقادیر منفی باعث تقسیم می‌شوند: 100%+ $\rightarrow$ دو برابر شدن سرعت، 100%− $\rightarrow$ نصف شدن سرعت، 500%− $\rightarrow$ یک‌ششم سرعت. سرعت هرگز به صفر نمی‌رسد.
پلن‌های ارتقاءتعداد دلخواهی از پلن‌ها را انتخاب کنید؛ هر ردیف نرخ پلن، تقویت فعال و سرعت لحظه‌ای را نمایش می‌دهد.
بازگشت خودکار پس ازتعداد ساعت تا پایان خودکار boost. مقدار 0 آن را تا زمانی که به‌صورت دستی بازنشانی کنید، فعال نگه می‌دارد.
اولویت Boost بر speed window ارجحیت دارد افزایش سرعت بر اساس plan rate اندازه‌گیری شده و تا زمانی که فعال است، جایگزین هر speed window می‌شود — پلنی با window شب 20M به 40M تبدیل نمی‌شود، بلکه به مقداری تبدیل می‌شود که boost روی plan rate آن اعمال می‌کند. Windows در لحظه انقضای boost مجدداً فعال می‌شوند.

مشترکی که محدودیت خود را تمام کرده است، هرگز با boost به سرعت کامل باز نمی‌گردد. به همین دلیل، پلنی که به عنوان هدف throttle استفاده شده است، توسط Select all نادیده گرفته شده و به همین صورت برچسب‌گذاری می‌شود؛ زیرا boost کردن آن، دقیقاً سرعت افرادی را افزایش می‌دهد که در حال throttle کردن آن‌ها هستید. اگر قصد دارید این کار را انجام دهید، همچنان می‌توانید آن را به‌صورت دستی علامت بزنید. Reset everything to normal تمام boostها را حذف کرده و نشست‌های فعال را به سرعت پلن خود باز می‌گرداند.

حذف دسته‌جمعی

حذف دائمی تعداد زیادی از مشترکین یا کارت‌های hotspot به‌صورت یک‌جا، بر اساس فیلتر انتخاب‌شده. حذف یک مشترک همچنین باعث حذف تاریخچه مصرف، sessionها، RADIUS accounting و صورت‌حساب‌های آن‌ها شده و هر session فعال را قطع می‌کند. این عملیات توسط یک دیالوگ تأیید از نوع DELETE کنترل می‌شود.

سیستم

زبان‌ها & پوسته‌ها

زبان‌ها

پورتال‌های مدیر و کاربر به‌طور کامل قابل ترجمه هستند. هشت زبان به‌صورت پیش‌فرض در دسترس هستند: English, Arabic (راست‌به‌چپ)، Russian, Persian (راست‌به‌چپ)، Turkish, French, Spanish و German. هر کاربر زبان خود را از نوار بالا یا پروفایل خود انتخاب می‌کند؛ این انتخاب برای هر حساب کاربری به‌خاطر سپرده می‌شود.

غیرفعال کردن یک زبان

در System → Translations هر زبان دارای یک کلید فعال/غیرفعال است (فقط برای superadmin). زبانی که غیرفعال باشد توسط هیچ‌کس قابل انتخاب نیست: در لیست انتخاب‌ها نمایش داده نمی‌شود، کاربرانی که آن را انتخاب کرده بودند زبان English را می‌بینند و پیام‌های ارسالی برای آن‌ها به زبان English نوشته می‌شود. زبان English همیشه فعال می‌ماند. در یک نصب جدید، تمامی زبان‌ها در حالت فعال هستند.

ویرایشگر ترجمه

یک superadmin می‌تواند ترجمه‌ها را به‌صورت زنده از مسیر System → Translations ویرایش کند — بدون نیاز به restart یا ویرایش فایل. این ویرایشگر همچنین امکان ایجاد زبان‌های کاملاً جدید و وارد/صادر کردن فایل‌های ترجمه به‌صورت .xlsx را فراهم می‌کند تا بتوانید SAMM را به هر زبانی که ارائه می‌دهید بومی‌سازی کنید.

پوسته‌ها

SAMM دارای 16 پوسته بصری روشن و تاریک است. هر کاربر یک پوسته را از نوار بالا انتخاب می‌کند؛ پیش‌نمایش به‌طور آنی به‌روزرسانی شده و برای هر حساب ذخیره می‌شود. اصطلاحات IT هرگز ترجمه نمی‌شوند تا صفحات فنی در هر زبانی دقیق باقی بمانند.

سیستم

لاگ حسابرسی & فعالیت

System → Audit Log به یک سؤال پاسخ می‌دهد: چه اتفاقی افتاده است و چه کسی آن را انجام داده است. در این لیست، تمامی تغییرات اعمال‌شده توسط مدیر، اقداماتی که سیستم به‌طور خودکار انجام داده است (مانند انقضا) و تغییراتی که کاربران در حساب خود در پورتال یا Telegram ایجاد کرده‌اند — از جمله تغییرات پلن، تمدیدها، پرداخت‌ها و ویرایش پروفایل و رمز عبور — ثبت می‌شود.

ستونآنچه نمایش داده می‌شود
زمانی کهزمان، بر اساس منطقه زمانی شما
چه کسیمدیر، "ali, in the portal"، "ali, on Telegram"، یک API token یا System
چه اتفاقی افتادیک جمله، تنها شامل فیلدهایی که تغییر کرده‌اند، مقدار قدیمی ← مقدار جدید — برای مثال "ویرایش کاربر: Expiry: 01 Oct ← 15 Oct"
مقصدتغییرات اعمال شده بر — کاربر · ali، پلن · Gold 20M، روتر · Hamra، مدیر · rami

بر اساس Who و Period فیلتر کنید یا نام مورد نظر را در کادر جست‌وجو تایپ کنید. ورودها و خروجی‌ها مخفی هستند، مگر اینکه گزینه Show logins & exports را فعال کنید. Via، Action، Category، Severity و ID در بخش انتخاب ستون‌ها قرار دارند. ردیف‌ها را برای Export یا Print انتخاب کنید؛ فایل خروجی دارای ستون‌های مشابه با صفحه است. دکمه ⓘ در هر ردیف، جدول کامل تغییرات (قبل و بعد) را نمایش می‌دهد.

تایم‌لاین کاربر

یک کاربر را باز کرده و Timeline را برای مشاهده تمام اتفاقاتی که برای آن حساب رخ داده است انتخاب کنید — ایجاد، تمدید، تغییر پلن، تعلیق، رسیدن به محدودیت‌ها — به همراه فاکتورها، پرداخت‌ها و هزینه‌های کیف پول و نماینده در ستون Amount. بر اساس نوع، بازه زمانی یا فقط مبالغ فیلتر کرده و خروجی را به CSV یا Excel صادر کنید. ردیف‌های Timeline هرگز پاک نمی‌شوند و حتی پس از حذف کاربر نیز باقی می‌مانند.

لاگ پذیرش و لاگ دسترسی

Overview → Accept Log لیستی از تمامی تلاش‌های ورود ارسال‌شده توسط روترها و پاسخ RADIUS را به‌ترتیب از جدیدترین به قدیمی‌ترین، به همراه دلیل هر رد درخواست نمایش می‌دهد. این صفحه‌ای است که هنگام عدم توانایی کاربر در اتصال باید باز شود. درخواست‌های ردشده‌ای که تکرار شوند، در یک خط به همراه تعداد نمایش داده می‌شوند. Overview → Access Log نشست‌هایی را که آغاز شده‌اند، بر اساس accounting در RADIUS فهرست می‌کند.

همچنین یک صف دستورات (command queue) بازنشانی‌ها، تغییرات پلن و تمدیدهایی که از طریق CLI یا API در صف قرار می‌گیرند، در جدول یکسانی ثبت شده و توسط سرویس samm-radius در تیک بعدی اعمال می‌شوند؛ سپس این سرویس، نشست فعال را با CoA به‌روزرسانی می‌کند. نشان (badge) در نوار کناری، تعداد موارد در انتظار را نمایش می‌دهد.

مجوزدهی

لایسنس‌ها و سطوح دسترسی &

هر نصب SAMM به‌صورت به‌ازای هر دستگاه لایسنس شده است — پلن روی همان نصب قرار دارد، بنابراین می‌توانید چندین سرور SAMM را اجرا کنید که هر کدام در tier خاص خود باشند. هر tier چهار سقف عددی را تعیین می‌کند.

لایهکاربران AAAکارت‌های HotspotNAS / روترهامانیتورها
ثبت‌نشده252513
رایگان1005026
Lite5001,500412
Plus1,0003,000618
Pro2,0006,0001236
Mega5,00015,0002472
Max10,00030,000نامحدودنامحدود
Unlimitedنامحدودنامحدودنامحدودنامحدود

یک نصب تازه در حالت unregistered و در پایین‌ترین سطح اجرا می‌شود. هر قابلیت در هر سطح در دسترس است و سطح انتخابی تنها سقف‌های مجاز را تعیین می‌کند. ایجاد مشترک، کارت یا NAS فراتر از سقف تعیین‌شده تا زمان ارتقای لایسنس مسدود است؛ هیچ داده‌ای هرگز از دست نمی‌رود.

Monitors نقاط دسترسی و لینک‌هایی هستند که SAMM صرفاً آن‌ها را مانیتور می‌کند. این موارد سهمیه مجزایی دارند (سه مورد به‌ازای هر NAS)، بنابراین مانیتور کردن یک نقطه دسترسی هرگز از ظرفیت اسلات‌های روتر استفاده نمی‌کند.

فعال‌سازی ارتقای &

  1. System → License را باز کنید.
  2. با ورود به حساب SecuryTik خود فعال کنید — یا از Link this device استفاده کنید؛ در این حالت کدی نمایش داده می‌شود که باید آن را در samm.securytik.com تأیید کنید، بدون اینکه نیاز باشد رمز عبور خود را در سرور وارد کنید. دستگاه در طرح Free فعال می‌شود.
  3. برای ارتقاء، یک پلن را از همین صفحه انتخاب کنید یا از طریق داشبورد خود مشترک شوید. درخواست ارسالی از این صفحه توسط مدیر SecuryTik بررسی و تأیید می‌شود.

صفحه License همچنین لایسنس را در صورت درخواست مجدداً بررسی کرده و میزان استفاده فعلی شما را نسبت به هر سقف نمایش می‌دهد. Unlink device نصب را بدون حذف هیچ داده‌ای به سطح ثبت‌نشده بازمی‌گرداند.

در صورت انقضای لایسنس پولی

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

مرحلهچه اتفاقی می‌افتد
هشداریک بنر یادآور؛ همه چیز به طور عادی به کار خود ادامه می‌دهد
دوره اتمام تدریجیبازه کوتاهی برای فعال‌سازی مجدد؛ مشترکین آنلاین می‌مانند
محدودیت نرم (Soft lockdown)سرویس‌های پس‌زمینه متوقف می‌شوند؛ RADIUS تا حدود 7 روز به احراز هویت ادامه می‌دهد
قفل سخت‌افزاریسرویس‌ها به‌جز صفحه فعال‌سازی مجدد متوقف می‌شوند

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

به‌روزرسانی‌های خودکار

به‌روزرسانی خودکار مستقل از لایسنس است — تمامی سطوح به‌روزرسانی می‌شوند و انقضای لایسنس هرگز مانع آن نمی‌شود. SAMM به‌صورت روزانه برای انتشار نسخه‌های جدید امضا شده بررسی می‌کند. از مسیر System → License می‌توانید بین حالت notify (پیش‌فرض — بنری همراه با دکمه Apply now) و auto (اعمال خودکار) سوئیچ کنید. هر به‌روزرسانی تأیید، پشتیبان‌گیری و در جای خود اعمال می‌شود. همچنین می‌توانید در هر زمان نصب‌کننده را مجدداً اجرا کنید — این فرآیند به‌صورت idempotently ارتقا می‌دهد.

برای مشترکین شما

پرتال مشتریان & بات

SAMM برای هر مشترک دو رابط خودسرویس — یک پورتال وب و یک ربات Telegram — فراهم می‌کند تا آن‌ها بتوانند میزان مصرف را بررسی کرده و بدون تماس با شما، پرداخت را انجام دهند.

پرتال مشتری

مشترکان با نام کاربری و رمز عبور SAMM خود در ریشه سایت SAMM (/) وارد می‌شوند. این پورتال شامل موارد زیر است:

صفحهآنچه مشترک می‌بیند
نمای کلیوضعیت حساب، پلن، تاریخ انقضا، میزان مصرف امروز و این ماه، هرگونه صورت‌حساب پرداخت‌نشده
استفاده & نشستمجموع حجم دانلود/آپلود، بودجه uptime و تاریخچه کامل نشست‌ها
پلن‌های منپلن فعلی به‌علاوه کاتالوگ پلن‌های موجود
صورت‌حساب‌های منتاریخچه صورت‌حساب با قابلیت دانلود PDF با یک کلیک
تیکت‌های پشتیبانیباز کردن و پیگیری تیکت‌های پشتیبانی
پروفایلویرایش جزئیات تماس، تغییر رمز عبور، تنظیم زبان & پوسته، مدیریت اعلان‌ها

از بخش Profile، مشترک حساب Telegram خود را متصل می‌کند، کانال‌های اعلان مورد نظر خود را انتخاب می‌کند یا به‌طور کلی از دریافت اعلان‌ها انصراف می‌دهد. در صورت فراموشی رمز عبور، یک کد OTP به ایمیل آن‌ها ارسال می‌شود (این مورد نیازمند پیکربندی زبانه Email است).

ربات Telegram

سرویس samm-telegram یک بات خودسرویس تعاملی را اجرا می‌کند. مشترک دستور /start را ارسال کرده، یک‌بار با نام کاربری و رمز عبور SAMM خود احراز هویت می‌کند (بات پیام حاوی رمز عبور را بلافاصله حذف می‌کند) و سپس می‌تواند به‌طور کامل از طریق چت:

  • پلن، سهمیه، میزان مصرف و تاریخ انقضای آن‌ها را بررسی کنید
  • مشاهده و دانلود فاکتورها به‌صورت PDF
  • به‌روزرسانی پروفایل و تغییر رمز عبور آن‌ها
  • باز کردن و پیگیری تیکت‌های پشتیبانی

این بات همچنین اعلان‌های خودکار — یادآورهای تمدید، اطلاعیه‌های انقضا، هشدارهای سهمیه و رسیدها — را برای مشترکانی که Telegram را متصل کرده‌اند، ارسال می‌کند.

صفحه فرود مشترکین منقضی‌شده

هنگامی که اشتراک یک کاربر به پایان می‌رسد، روتر (که توسط بخش "Expired pool & internet block" در ویزارد پیکربندی شده است) به‌جای قطع بی‌صدای اتصال، مرورگر کاربر را به یک صفحه مناسب "subscription expired" هدایت می‌کند که توسط SAMM روی پورت 81 — همراه با لوگوی ISP شما و دکمه ورود به پورتال — ارائه می‌شود.

سیستم

REST API

System → API اینترفیس عمومی /api/v1 را مدیریت می‌کند. API تا زمانی که اولین توکن را ایجاد نکنید غیرفعال است، بنابراین اگر در نصب خود هرگز از آن استفاده نکنید، هیچ موردی در معرض نمایش قرار نمی‌گیرد. تمام موارد زیر به‌عنوان مستندات تعاملی OpenAPI — همراه با کنسول try-it و شمای کامل درخواست/پاسخ — در نصب شما در مسیر /api/v1/docs نیز در دسترس است.

مستندات تعاملی (Swagger UI)

هر نصب یک کنسول API زنده در /api/v1/docs ارائه می‌دهد — که مستقیماً از پنل API در پورتال مدیر قابل دسترسی است. روی Authorize کلیک کنید، یک توکن را جای‌گذاری کنید و هر نقطه پایانی را می‌توان با Try it out روی داده‌های خودتان اجرا کرد؛ هر فراخوانی، پاسخ واقعی به‌همراه یک دستور curl آماده برای کپی را نمایش می‌دهد.

هر نقطه پایانی یک schema کامل و تایپ‌شده — هم برای بدنه درخواست‌ها و هم پاسخ‌ها — تعریف می‌کند، به‌طوری که نام فیلدها، انواع (types) و مثال‌ها بدون نیاز به فراخوانی هر چیزی قابل مشاهده هستند. همین schema به‌صورت OpenAPI ماشین‌خوان در /api/v1/openapi.json ارائه می‌شود که یک client کاملاً تایپ‌شده به زبان انتخابی شما تولید می‌کند:

openapi-generator-cli generate \
  -i https://YOUR-SAMM/api/v1/openapi.json \
  -g python -o ./samm-client

samm-openapi.json · SAMM 6.0.0 · 187 نقاط پایانی

راهنمای شروع سریع

  1. System → API را باز کنید (فقط superadmin)، New token را فشار دهید، یک نام و تاریخ انقضا تعیین کرده و تنها مجوزهای مورد نیاز برای integration را فعال کنید (Read یا Write، هر مورد در یک خط).
  2. Secret را فوراً کپی کنید — این عبارت تنها یک بار نمایش داده می‌شود و فقط hash آن روی سرور ذخیره می‌شود.
  3. عملکرد آن را بررسی کرده و ببینید token چه قابلیت‌هایی دارد:
curl -H "Authorization: Bearer samm_YOUR_TOKEN" https://YOUR-SAMM/api/v1/me

لیست مشترکین فعال را مشاهده کنید و سپس یک مورد ایجاد کنید:

curl -H "Authorization: Bearer samm_YOUR_TOKEN" \
  "https://YOUR-SAMM/api/v1/customers?status=active&limit=20"

curl -X POST -H "Authorization: Bearer samm_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username":"john","password":"secret1","firstname":"John",
       "lastname":"Doe","plan_id":3}' \
  https://YOUR-SAMM/api/v1/customers

احراز هویت، توکن‌ها و محدوده‌ها (scopes)

هر درخواست شامل Authorization: Bearer <token> است. یک token حاوی نام، محدودیت نرخ در هر دقیقه (rate limit)، تاریخ انقضا (30–360 روز یا نامحدود) و مجموعه‌ای از scopes است — مجوزهای خواندن/نوشتن برای هر منبع؛ یک scope از نوع write به‌طور خودکار read متناظر را نیز شامل می‌شود. secret دقیقاً یک بار نمایش داده می‌شود و سرور تنها hash آن را ذخیره می‌کند. یک token می‌تواند ابطال شود (در این حالت درخواست‌ها بلافاصله با خطا مواجه می‌شوند و این تغییر قابل بازگشت است) یا به‌طور کامل حذف شود.

پاسخ‌ها از یک مجموعه قرارداد پیروی می‌کنند: نقاط پایانیِ لیست، limit/offset را دریافت کرده و {"total", "items"} را برمی‌گردانند؛ خطاها از کدهای وضعیت استاندارد استفاده می‌کنند — 401 توکن مفقود/نامعتبر/منقضی‌شده، 403 محدوده (scope) مفقود، 404 یافت نشد، 409 تکراری، 422 خطای اعتبارسنجی، و 429 هنگامی که حد نرخ بازدید (rate limit) تکمیل شود (همراه با هدرهای Retry-After و X-RateLimit-*).

مبالغ در داده‌های payment، wallet و webhook به‌صورت رشته‌ای اعشاری مانند "12.50" هستند؛ زمان‌ها مطابق استاندارد ISO 8601 با offset مربوط به نصب (install) می‌باشند.

مرجع نقطه پایانی

بخشنقاط پایانیدامنه
Token & commands GET /commands · GET /me any token
Users GET /customers · POST /customers · POST /customers/bulk · GET /customers/{customer_id} · PATCH /customers/{customer_id} · DELETE /customers/{customer_id} · POST /customers/{customer_id}/activate · POST /customers/{customer_id}/assign-plan · PUT /customers/{customer_id}/custom-fields · GET /customers/{customer_id}/data-log · POST /customers/{customer_id}/disconnect · POST /customers/{customer_id}/renew · POST /customers/{customer_id}/reset-limit · POST /customers/{customer_id}/suspend · GET /customers/{customer_id}/timeline · GET /customers/{customer_id}/usage · GET /customers/{customer_id}/timeline/export.{fmt} coa:write customers:read customers:renew customers:write diagnostics:read
Plans GET /plans · POST /plans · GET /plans/{plan_id} · PATCH /plans/{plan_id} plans:read plans:write
Invoices GET /invoices · POST /invoices · GET /invoices/{invoice_id} · DELETE /invoices/{invoice_id} · POST /invoices/{invoice_id}/pay · GET /invoices/{invoice_id}/pdf · POST /invoices/{invoice_id}/unpay billing:read billing:write
Payments, discounts & wallet GET /cash-accounts · GET /customers/{customer_id}/wallet · GET /invoices/{invoice_id}/balance · POST /invoices/{invoice_id}/discounts · POST /invoices/{invoice_id}/payments · POST /customers/{customer_id}/wallet/pay-invoice · POST /customers/{customer_id}/wallet/topup · POST /customers/{customer_id}/wallet/withdraw · DELETE /invoices/{invoice_id}/discounts/{discount_id} billing:read billing:write
Payment apps (collect) GET /collect/lookup · POST /collect/payments · GET /collect/payments/{channel}/{reference} collect:read collect:write
Accounting export GET /accounting/export · GET /accounting/export/{kind} accounting:read
Add-ons & price lists GET /addons · GET /price-lists · DELETE /user-addons/{user_addon_id} · GET /customers/{customer_id}/addons · POST /customers/{customer_id}/addons addons:read addons:write
Hotspot cards GET /cards/groups · POST /cards/groups · GET /cards/{card_id} · GET /cards/groups/{group_id} · POST /cards/{card_id}/disable · POST /cards/{card_id}/enable · GET /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/disable · POST /cards/groups/{group_id}/enable · POST /cards/groups/{group_id}/extend · GET /cards/groups/{group_id}/print.pdf · POST /cards/{card_id}/reset/{kind} cards:read cards:write
Sessions & CoA GET /coa-outbox · GET /sessions · POST /coa-outbox/cancel · POST /coa-outbox/retry · POST /sessions/disconnect · POST /sessions/reconnect coa:write sessions:read
Webhooks GET /webhooks · POST /webhooks · GET /webhooks/events · PATCH /webhooks/{endpoint_id} · DELETE /webhooks/{endpoint_id} · GET /webhooks/{endpoint_id}/deliveries · POST /webhooks/{endpoint_id}/disable · POST /webhooks/{endpoint_id}/enable · POST /webhooks/{endpoint_id}/roll-secret · POST /webhooks/{endpoint_id}/test · POST /webhooks/deliveries/{delivery_id}/resend webhooks:manage
User files GET /customers/{customer_id}/files · POST /customers/{customer_id}/files · GET /customers/{customer_id}/files/{file_id} · DELETE /customers/{customer_id}/files/{file_id} customers:read customers:write
Branches GET /branches · PUT /customers/{customer_id}/branch admins:write customers:read
Admins GET /admins customers:read
Self Service (guests) GET /self-service/handouts · GET /self-service/summary guests:read
Statistics GET /stats/overview stats:read
Routers & router control GET /routers · POST /routers/jobs · GET /routers/playbooks · GET /routers/{router_id} · GET /routers/jobs/kinds · GET /routers/jobs/prefill · GET /routers/jobs/{job_id} · GET /routers/{router_id}/log · POST /routers/{router_id}/probe · GET /routers/{router_id}/probes · GET /routers/{router_id}/radius · GET /routers/{router_id}/ros · POST /routers/{router_id}/ros · POST /routers/{router_id}/scoop-change · GET /routers/{router_id}/scoop-changes · POST /routers/{router_id}/script · GET /routers/{router_id}/test · GET /routers/{router_id}/traffic · POST /routers/jobs/{job_id}/cancel · GET /routers/wireless/by-user/{customer_id} · GET /routers/{router_id}/ppp/{username} · GET /routers/{router_id}/scoop-change/preview · POST /routers/{router_id}/scoop-change/{change_id}/undo routers:diagnose routers:jobs routers:read routers:write
Network map & health GET /network/findings · GET /network/health · GET /network/topology · PUT /customers/{customer_id}/features · GET /network/ftth/olts · GET /network/ftth/onus · GET /network/wireless/aps · GET /network/wireless/stations · GET /routers/{router_id}/reach · POST /routers/{router_id}/reach · DELETE /routers/{router_id}/reach/{reach_id} customers:write routers:read
Bulk import POST /imports/users imports:write
Backups GET /backups · POST /backups · GET /backups/schedule · PUT /backups/schedule · DELETE /backups/{name} · GET /backups/{name}/download · POST /backups/{name}/restore backups:read backups:write
History cleaner POST /history/clean · GET /history/schedule · PUT /history/schedule · GET /history/space history:read history:write
VPN clients GET /vpn/l2tp/clients · POST /vpn/l2tp/clients · GET /vpn/sstp/clients · POST /vpn/sstp/clients · GET /vpn/wireguard/clients · POST /vpn/wireguard/clients · PUT /vpn/l2tp/clients/{cid} · DELETE /vpn/l2tp/clients/{cid} · PUT /vpn/sstp/clients/{cid} · DELETE /vpn/sstp/clients/{cid} · PUT /vpn/wireguard/clients/{peer_id} · DELETE /vpn/wireguard/clients/{peer_id} · GET /vpn/l2tp/clients/{cid}/config · GET /vpn/l2tp/clients/{cid}/mikrotik · POST /vpn/l2tp/clients/{cid}/toggle · GET /vpn/sstp/clients/{cid}/config · GET /vpn/sstp/clients/{cid}/mikrotik · POST /vpn/sstp/clients/{cid}/toggle · GET /vpn/wireguard/clients/{peer_id}/config · GET /vpn/wireguard/clients/{peer_id}/mikrotik · POST /vpn/wireguard/clients/{peer_id}/toggle vpn:read vpn:write
Diagnostics GET /diagnostics diagnostics:read
Support & logs GET /audit · GET /auth-log · GET /audit/actors · GET /support/alerts · GET /support/backups · GET /support/database · GET /support/errors · GET /support/license · GET /support/logs · GET /support/notifications · GET /support/payments · GET /support/probe · GET /support/queues · GET /support/self-test · POST /support/service-restart · GET /support/services · GET /support/settings · PUT /support/settings · GET /support/system · GET /support/update · GET /customers/{customer_id}/why-blocked · GET /support/errors/{incident} · GET /support/payments/incoming customers:read diagnostics:read errors:read logs:read services:write settings:write
Reports GET /reports/activations · GET /reports/financial · POST /retention/lookup · GET /customers/{customer_id}/statement accounting:read customers:read retention:lookup
Scoop GET /scoop/schedules · POST /scoop/schedules · DELETE /scoop/schedules/{schedule_id}

صورت‌حساب‌ها، پرداخت‌ها، تخفیف‌ها و کیف پول

هر تراکنش مالی دقیقاً مشابه پنل، از طریق دفاتر دفتری دوطرفه SAMM ثبت می‌شود. یک فاکتور مبلغ total − paid − discount طلب دارد؛ وضعیت آن از unpaid/due به partial و paid تغییر می‌کند (یا در صورتی که تنها تخفیف‌ها باعث تسویه شده باشند، به discounted تغییر می‌یابد).

# what an invoice still owes
curl -H "Authorization: Bearer $T" https://YOUR-SAMM/api/v1/invoices/501/balance

# a 10 percent discount (or "kind":"fixed","value":"2.00")
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"kind":"percent","value":"10","reason":"Loyalty"}' \
  https://YOUR-SAMM/api/v1/invoices/501/discounts

# a partial payment into a cash account (GET /cash-accounts)
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"amount":"5.00","cash_account_id":1,"memo":"Counter"}' \
  https://YOUR-SAMM/api/v1/invoices/501/payments

# prepaid wallet: top up (pays open invoices oldest first), then read it
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"amount":"25.00","cash_account_id":1}' \
  https://YOUR-SAMM/api/v1/customers/42/wallet/topup
curl -H "Authorization: Bearer $T" https://YOUR-SAMM/api/v1/customers/42/wallet

POST /invoices/{id}/unpay یک صورت‌حساب پرداخت‌شده را مجدداً باز می‌کند و DELETE /invoices/{id} یک صورت‌حساب را به‌درستی می‌بندد (باقیمانده پرداخت‌نشده به‌عنوان هزینه حذف می‌شود). خروجی دفاتر حسابداری در قالب JSON یا CSV از طریق GET /accounting/export/{kind} قابل دریافت است.

اپلیکیشن‌های پرداخت

اپلیکیشن‌های انتقال وجه و نمایندگان فروش (Wish Money، Sham Cash و غیره) دارای scopeهای اختصاصی خود، یعنی collect:read و collect:write، و سه فراخوانی هستند: جستجوی کاربر بر اساس username (نام ماسک‌شده، مبلغ بدهی، فاکتورهای باز)، ثبت یک پرداخت و بازخوانی آن. یک پرداخت بر اساس مرجع خود idempotent است: ارسال مجدد همان پرداخت، پاسخ اول را برمی‌گرداند و هیچ تراکنش جدیدی ثبت نمی‌کند.

curl -H "Authorization: Bearer $T" "https://YOUR-SAMM/api/v1/collect/lookup?username=ali"

curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"username":"ali","amount":"20.00","reference":"WM-88213","channel":"wishmoney"}' \
  https://YOUR-SAMM/api/v1/collect/payments

دستورات در صف

تغییراتی که به وضعیت زنده حسابداری دست می‌زنند — بازنشانی محدودیت‌ها، فعال/غیرفعال کردن کارت‌ها و گروه‌ها، تمدید اعتبار — داخل درخواست اعمال نمی‌شوند. در صف فرمان حسابرسی‌شده قرار می‌گیرند و samm-radius در یک تیک (چند ثانیه) اعمالشان می‌کند؛ دقیقا مانند همان کلیک‌ها در پورتال مدیریت. این نقاط {"queued": true} برمی‌گردانند؛ با GET /commands ببینید فرمان‌های توکن شما applied شده‌اند.

Webhooks

یک URL نقطه پایانی را در System → API → Webhooks یا از طریق POST /webhooks ثبت کنید و رویدادها را انتخاب نمایید: رویدادهای تکی، یک گروه کامل مانند invoice.* (رویدادهای آتی آن گروه شامل می‌شوند) یا * برای همه موارد. signing secret در صفحه نقطه پایانی نمایش داده می‌شود و قابل بازنشانی است.

هر ارسال به‌صورت JSON شامل id، type، api_version، created_at و data است. id برای هر نقطه پایانی و هر تلاش مجدد یکسان است: هر id را تنها یک‌بار پردازش کنید. پاسخ 2xx باید ظرف 10 ثانیه ارسال شود؛ هر پاسخ دیگری با استراتژی backoff تا حدود دو ساعت مجدداً تلاش می‌شود و نقطه پایانی که به‌طور مداوم با خطا مواجه شود، به‌طور خودکار غیرفعال می‌گردد. هر ارسال همراه با کد HTTP بازگشتی سرور شما ثبت شده و قابلیت ارسال مجدد دارد.

پیش از اعتماد به یک delivery، X-SAMM-Signature-256: t=<unix>,v1=<hex> را که یک HMAC-SHA256 از t.body است، تأیید کنید:

import hmac, hashlib, time

def verify(raw: bytes, header: str, secret: bytes) -> bool:
    p = dict(x.split("=", 1) for x in header.split(","))
    if abs(time.time() - int(p["t"])) > 300:      # replay window
        return False
    mac = hmac.new(secret, p["t"].encode() + b"." + raw,
                   hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, p["v1"])
رویدادزمانی که
customer.createdA user account was created
customer.updatedA user account was updated
customer.renewedA plan was renewed (expiration extended)
customer.plan_changedA user moved to another plan
customer.expiredA user expired (expiration sweep)
customer.suspendedA user was suspended (by an admin or for not paying)
customer.restoredA suspended user was restored
customer.deletedA user account was deleted
limit.exhaustedA usage limit was exhausted (quota / daily / uptime / expiration)
invoice.createdAn invoice was created
invoice.updatedWhat an invoice owes changed (payment, discount, reversal, write-off)
invoice.paidAn invoice was marked paid
invoice.deletedAn invoice was deleted
payment.receivedA payment was received and posted (online, payment app)
payment.reversedA payment was voided or an invoice reopened
wallet.topupMoney was added to a user's prepaid wallet
addon.addedAn add-on was given to or bought by a user
session.startedA user session started (off unless enabled in settings)
session.stoppedA user session stopped (off unless enabled in settings)
alert.openedAn alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolvedAn alert cleared on its own or was resolved
webhook.testManual test event (sent from the test button)
همان قوانین portal تغییرات API از همان صف دستورات بازرسی‌شده و لایه سرویس پورتال مدیر عبور می‌کنند؛ یک بازنشانی یا تغییر پلن از طریق API دقیقاً مشابه عملیاتی که در UI کلیک شود عمل می‌کند، از جمله CoA و سایر موارد.
لینک به SAMM قفل شده است توکن‌های کنترل روتر نمی‌توانند بر ارتباط بین SAMM و خود روتر تأثیر بگذارند — شامل اطلاعات ورود، سرویس API، تنظیمات RADIUS، قوانین امنیتی خود SAMM یا آدرسی که SAMM از طریق آن به روتر متصل می‌شود. SAMM پس از هر تغییر بررسی می‌کند که آیا همچنان امکان ورود وجود دارد یا خیر، و هر تغییر یا اجرای اسکریپت در Admin Log ثبت می‌شود.

منابع

بهره‌برداری از SAMM

تقریباً همه امور از طریق پورتال مدیر انجام می‌شود. این صفحه مرجعی برای shell است و برای موارد نادری که به آن نیاز دارید، کاربرد دارد.

مدیریت سرویس

# Restart all SAMM services
systemctl restart samm-api samm-radius samm-worker samm-notification samm-telegram

# Live logs for one service
journalctl -u samm-api    -f
journalctl -u samm-radius -f

# Validate the FreeRADIUS config after any change
freeradius -CX

# Port 8000 stuck after a crash (admin portal unreachable)
kill -9 $(lsof -ti:8000); systemctl restart samm-api

CLI مدیر

برای عملیات سریع مشترکین از طریق shell. هر دستور در audit log صف‌بندی شده و در tick بعدی samm-radius اعمال می‌شود — دقیقاً مشابه اقدامات UI.

CLI="sudo -u samm /opt/samm/venv/bin/python -m samm_radius.cli"

$CLI reset-quota      alice          # reset a limit counter
$CLI reset-daily      alice
$CLI reset-uptime     alice
$CLI reset-expiration alice
$CLI change-plan      alice home-50M # switch a subscriber's plan
$CLI encrypt-pw                       # encrypt a router API password for the DB

فایل‌های پیکربندی

فایلتوقف‌ها
/etc/samm/samm.yamlDSN پایگاه داده، اندازه connection-pool و سطح log
/etc/samm/api.envرمزهای نشست Portal و تنظیمات SMTP بازیابی رمز عبور
/etc/samm/secret.keyکلید رمزنگاری برای گذرواژه‌های ذخیره‌شده‌ی API روتر

این فایل‌ها در هنگام به‌روزرسانی‌ها حفظ می‌شوند و هرگز با اجرای مجدد نصب‌کننده بازنویسی نمی‌شوند. تنظیمات زمان اجرا (بازه زمانی حلقه‌ها، زمان بازنشانی روزانه، پورت‌های CoA) به‌جای آن در تنظیمات قرار دارند و بدون نیاز به راه‌اندازی مجدد اعمال می‌شوند.

به‌روزرسانی SAMM

یا اجازه دهید SAMM از مسیر System → License به‌روزرسانی شود، یا نصب‌کننده را مجدداً اجرا کنید — به Installation → Upgrading مراجعه کنید. هر دو مسیر، مهاجرت‌ها را مجدداً اعمال کرده و سرویس‌ها را ری‌استارت می‌کنند؛ تنظیمات و داده‌های شما دست‌نخورده باقی می‌مانند.

پشتیبان‌گیری و بازیابی &

برای تهیه یک snapshot کامل از پایگاه داده پیش از هر تغییر عمده، از Tools → Backup & Restore استفاده کنید. برای بازسازی در یک host جدید، SAMM را نصب کرده و سپس backup را بازیابی کنید.

ابزارهای نگهداری (خارجی)

برخی از عملیات‌های نگهداری به‌قدری تخریبی هستند که نباید در پنل مدیر قرار گیرند، زیرا یک کلیک اشتباه می‌تواند باعث نابودی یک کسب‌وکار فعال شود. SAMM این موارد را به‌صورت اسکریپت‌های مستقل و فقط برای root نگه می‌دارد که شما آن‌ها را دانلود کرده و به‌صورت آگاهانه از طریق shell اجرا می‌کنید — و هرگز به‌صورت یک دکمه ارائه نمی‌شوند. این اسکریپت‌ها در مخزن توزیع عمومی در مسیر tools/ قرار دارند.

بازنشانی رمز عبور admin مسدودشده

دسترسی به پنل مدیر را از دست داده‌اید؟ برای یک حساب superadmin مستقیماً در database رمز عبور جدیدی تنظیم کنید — بدون نیاز به داشتن دسترسی ورود. این کار همچنین در صورت غیرفعال بودن حساب، آن را مجدداً فعال کرده و هیچ مورد دیگری را تغییر نمی‌دهد.

curl -fsSL -o samm-reset-admin-password.sh \
  https://raw.githubusercontent.com/mhdhaidarah/samm/main/tools/samm-reset-admin-password.sh

sudo bash samm-reset-admin-password.sh --list   # list the superadmin accounts
sudo bash samm-reset-admin-password.sh          # reset (prompts for the new password, twice)

آن را به‌عنوان root روی سرور SAMM اجرا کنید. اگر چندین superadmin وجود دارد، برای انتخاب یکی از آن‌ها، عبارت --user <name> را وارد کنید.

بازنشانی دفاتر (پاک‌سازی داده‌های مالی)

تمامی تراکنش‌های مالی را پاک می‌کند تا یک ISP بتواند حسابداری خود را از صفر آغاز کند، در حالی که تمام داده‌های مشترکین و AAA کاملاً دست‌نخورده باقی می‌مانند. این قابلیت هنگام تحویل گرفتن یک نصب، یا پس از دوره آزمایشی/تست، زمانی که دفاتر پر از داده‌هایی است که اپراتور می‌خواهد حذف شوند اما پایگاه مشتریان باید دقیقاً به همان شکل باقی بماند، مفید است.

خطر — از دست رفتن بازگشت‌ناپذیر داده‌ها این عملیات تمامی فاکتورها، پرداخت‌ها، رسیدها، موجودی کیف پول و تاریخچه دفتر کل را به‌طور دائمی حذف می‌کند. این اقدام قابل بازگشت نیست. تنها راه بازیابی، استفاده از پشتیبان دیتابیس است. هرگز این دستور را روی یک نصب Production که پیش‌تر از آن پشتیبان نگرفته و صحت آن را تأیید نکرده‌اید، اجرا نکنید.

حذف‌شده: فاکتورها و اقلام آن‌ها، دفتر کل دوطرفه (پرداخت‌ها، رسیدها، تعدیلات، شارژ و برداشت‌های کیف پول)، تراکنش‌های پرداخت آنلاین، هزینه‌ها، دارایی‌های ثابت و لاگ فعالیت‌های حسابداری. شماره‌گذاری فاکتورها بازنشانی می‌شود، بنابراین فاکتور بعدی از #1 شروع می‌شود.

حفظ شده: هر مشترک، پلن، بازه سرعت، محدودیت، شمارنده مصرف، تاریخچه پلن، کارت hotspot، روتر، نشست و رکورد accounting RADIUS — به‌علاوه پیکربندی accounting شما (جدول حساب‌ها، حساب‌های نقدی، گروه‌های مالیاتی، درگاه‌های پرداخت). مانده‌های نقدی، کیف پول و حساب‌های دریافتنی از دفتر کل استخراج می‌شوند، بنابراین پس از آن به‌سادگی صفر نمایش داده می‌شوند.

آن را دانلود کنید، بخوانید و سپس اجرا کنید. همیشه ابتدا یک اجرای آزمایشی (dry run) انجام دهید:

curl -fsSL -o samm-wipe-financials.sh \
  https://raw.githubusercontent.com/mhdhaidarah/samm/main/tools/samm-wipe-financials.sh

sudo bash samm-wipe-financials.sh --dry-run   # show what would be deleted, change nothing
sudo bash samm-wipe-financials.sh             # do it
آن را مستقیماً به یک shell پایپ نکنید هرگز این دستور را به‌صورت curl … | sudo bash اجرا نکنید. در مورد اسکریپتی که داده‌ها را پاک می‌کند، باید ابتدا آن را مطالعه کنید؛ زیرا یک دانلود ناقص نباید بتواند نیمی از عملیات پاک‌سازی را اجرا کند. ابتدا دانلود کنید، سپس بررسی و در نهایت اجرا نمایید.

اسکریپت از اجرا توسط کاربری غیر از root خودداری می‌کند، دقیقاً مواردی را که قصد حذف آن‌ها را دارد چاپ می‌کند و سپس از شما می‌خواهد برای تأیید داشتن یک نسخه پشتیبان معتبر YES و برای ادامه WIPE را تایپ کنید. این اسکریپت ابتدا پیشنهاد می‌دهد که یک dump از دیتابیس خود (در مسیر /var/backups/samm/) تهیه کند و در صورت شکست این عملیات، متوقف می‌شود. عملیات پاک‌سازی به صورت یک تراکنش واحد و یکپارچه (all-or-nothing) اجرا می‌شود و RADIUS تعمداً در تمام این مدت فعال می‌ماند تا مشترکین در حالی که سوابق برطرف‌شده‌اند، آنلاین باقی بمانند.

منابع

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

SAMM از چه سیستم‌عامل‌هایی پشتیبانی می‌کند؟

Ubuntu 22.04 / 24.04 / 26.04 LTS و Debian 12 / 13. فقط Linux نسخه‌ی Server — نسخه‌های desktop پشتیبانی نمی‌شوند. نصب‌کننده به systemd، یک نصب تازه از PostgreSQL (یکی برای شما پیکربندی می‌شود) و دسترسی root نیاز دارد.

آیا برای اجرای SAMM به اتصال اینترنت نیاز است؟

خیر. SAMM به‌طور کامل روی سرور شما اجرا می‌شود و مشترکین را به‌صورت محلی از طریق RADIUS احراز هویت می‌کند. تنها ترافیک خروجی، یک heartbeat دوره‌ای برای لایسنس به سرور لایسنس SecuryTik است تا پلن شما معتبر باقی بماند.

آیا می‌توانم SAMM را در cloud اجرا کنم یا باید به‌صورت on-prem باشد؟

هر دو روش کاربردی هستند. اکثر اپراتورها آن را به‌صورت on-prem در کنار روترهای core خود اجرا می‌کنند؛ برخی دیگر از یک VM کوچک در cloud همراه با یک تونل Cloudflare Zero Trust برای اتصال بازگشتی استفاده می‌کنند. تنها پیش‌نیاز این است که روترهای MikroTik بتوانند از طریق پورت‌های RADIUS (1812/1813 UDP) به سرور SAMM دسترسی داشته باشند و SAMM بتواند از طریق MikroTik API به روترها دسترسی پیدا کند.

آیا هنگام افزودن یا حذف یک روتر باید FreeRADIUS را مجدداً راه‌اندازی کنم؟

خیر. SAMM کلاینت‌های NAS را به‌صورت پویا از پایگاه داده شناسایی می‌کند، بنابراین افزودن، ویرایش یا حذف یک روتر در MikroTik → NAS بدون نیاز به ری‌استارت اعمال می‌شود.

تغییر پلن یا بازنشانی شمارنده با چه سرعتی اعمال می‌شود؟

عملیات مدیر در صف قرار گرفته و توسط سرویس samm-radius در تیک بعدی — به‌طور پیش‌فرض ظرف 30 ثانیه — اعمال می‌شوند. اگر مشترک آنلاین باشد، SAMM یک CoA زنده نیز برای به‌روزرسانی نشست ارسال می‌کند. برای زمان‌بندی دقیق‌تر، فاصله samm-radius را در System → Settings کاهش دهید.

اگر لایسنس پولی من منقضی شود، چه اتفاقی برای داده‌هایم می‌افتد؟

هیچ‌چیز هرگز حذف نمی‌شود. یک لایسنس منقضی‌شده به‌ترتیب از مراحل هشدار، دوره ارفاق، lockdown نرم (RADIUS تا حدود یک هفته احراز هویت را ادامه می‌دهد) و در نهایت lockdown سخت عبور می‌کند. فعال‌سازی مجدد در هر مرحله، تمامی سرویس‌ها را در حالی که همه داده‌ها دست‌نخورده باقی مانده‌اند، مجدداً راه‌اندازی می‌کند.

آیا SAMM رایگان است؟ نسخه Pro چه قابلیت‌هایی اضافه می‌کند؟

سطح Free برای همیشه رایگان است و شامل تمام قابلیت‌ها می‌شود. پلن‌های پولی قابلیت‌های جدیدی را فعال نمی‌کنند، بلکه سقف تعداد کاربران AAA و کارت‌های hotspot را افزایش داده و محدودیت تعداد روترها را حذف می‌کنند. Licensing & tiers را مشاهده کنید.

یک مشترک نمی‌تواند احراز هویت کند — از کجا شروع کنم؟

بررسی کنید که RADIUS shared secret روتر دقیقاً با رکورد NAS مطابقت داشته باشد، روتر برای PPP / Hotspot RADIUS فعال باشد و حساب مشترک Active و منقضی نشده باشد. خروجی journalctl -u samm-api -f و لاگ FreeRADIUS را رصد کرده و تأیید کنید که روتر می‌تواند به میزبان SAMM روی UDP 1812/1813 دسترسی داشته باشد.

به کمک بیشتری نیاز دارید؟

برای گزارش باگ یا درخواست قابلیت جدید، به samm@securytik.com ایمیل کنید.