SAMM — SecuryTik Active Mikrotik
Manager — هي منصة متكاملة لإدارة الـ ISP مخصصة لشبكات MikroTik PPPoE
& Hotspot. حيث يقوم برنامج تثبيت واحد بتحويل خادم Linux خام إلى نظام كامل للـ AAA،
والفوترة، وإدارة المشتركين.
الفئات المستهدفة من SAMM
صمم SAMM لمزودي خدمات الإنترنت اللاسلكي، ومشغلي الألياف الضوئية، ومزودي نقاط الاتصال Hotspot الذين يستخدمون MikroTik RouterOS. إذا كنت تقوم بمصادقة المشتركين عبر PPPoE أو Hotspot أو IPoE/DHCP وتحتاج إلى تطبيق باقات السرعة، وحدود البيانات، وتواريخ الانتهاء، والفوترة — فإن SAMM ينجز كل ذلك من شاشة واحدة.
يتم تحديد مشتركي IPoE/DHCP عبر DHCP Option 82 circuit-id (منفذ الوصول المادي — الطريقة الاحترافية لمزودي خدمة الإنترنت ISP) أو MAC الخاص بالجهاز، ويكون radius-password الخاص بخادم DHCP هو ببساطة RADIUS shared secret الخاص بالراوتر، لذا لا يتطلب الأمر تهيئة أي إعدادات إضافية.
IPv6 dual-stack خيار تفعّله عند الحاجة: يمكن لكل مستخدم أن يحصل على IPv6
إلى جانب IPv4. فعّله في معالج الراوتر واختر طول البادئة المفوّضة (DHCPv6-PD)
— /56 افتراضيًا، أو أي طول من /48 إلى /64 — وكتل IPv6 التي توزَّع. مع كل
Access-Accept يعيد SAMM مجمع WAN IPv6 وبادئة موجَّهة مفوّضة إلى LAN المستخدم،
فيقسّمها راوتر الزبون نفسه (في وضع route) إلى شبكات /64 ويشغّل SLAAC
لأجهزته — وهو نموذج تفويض البادئات المعتمد لدى أي ISP. يعمل مع PPPoE وHotspot وIPoE،
ويمكن تثبيت بادئة IPv6 ثابتة لكل مستخدم من عملاء الشركات.
آلية العمل
يحافظ SAMM على المسار السريع بالقرب من قاعدة البيانات. يتولى FreeRADIUS معالجة كل حزمة مصادقة ومحاسبة؛ وعند كل تحديث مؤقت (Interim-Update) للمحاسبة، يستدعي وظائف PostgreSQL مباشرة لتجميع الاستهلاك وتقييم الحدود — فلا توجد دورة ذهاب وإياب عبر 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
تفريغ صندوق CoA الصادر؛ تشغيل عمليات مسح انتهاء الصلاحية / إعادة الضبط اليومية / نافذة السرعة
samm-worker
إرسال Pings إلى الراوترات؛ مزامنة البيانات الوصفية لأجهزة MikroTik عبر API
samm-notification
إرسال إشعارات البريد الإلكتروني & Telegram عبر طابور واحد محدود السرعة
samm-telegram
تشغيل بوت Telegram التفاعلي للخدمة الذاتية
وظائف SAMM
نواة AAA
مصادقة PPPoE & Hotspot، وفرض السرعة لكل مستخدم، وCoA هجين.
الباقات & الحدود
مستويات السرعة بالإضافة إلى أربعة حدود مستقلة ونوافذ زمنية مجدولة للسرعة.
المشتركون
مستخدمو PPPoE و Hotspot و IPoE/DHCP، بالإضافة إلى بطاقات قسائم Hotspot مسبقة الدفع مع ملفات PDF قابلة للطباعة.
الفواتير
تسعير لكل باقة، فواتير تلقائية، ودفتر أستاذ مزدوج للإيصالات والمدفوعات والمصاريف.
تنبيهات التجديد، وانتهاء الصلاحية، والحصة، والإيصالات عبر البريد الإلكتروني و Telegram.
يتناول بقية هذا الدليل كيفية التعامل مع كل منطقة من هذه المناطق. استخدم القائمة على اليسار، أو ابدأ بـ Installation.
دليل البدء
ما الجديد
يقوم SAMM بتحديث نفسه تلقائيا، لذا تحصل كل نسخة مثبتة على هذه الميزات في التحديث التالي. يرتبط كل سطر بالصفحة التي تشرح كيفية استخدامه.
6.0
تصاميم البطاقات: صمّم بطاقة Hotspot المطبوعة بنفسك (الحجم، الخلفية، شعارك، ورمز QR يُدخل البطاقة بمسحة واحدة)، أو ابدأ من عشرة تصاميم جاهزة. تحتفظ كل مجموعة بتصميم للطباعة وآخر للطباعة السريعة على طابعة حرارية (80 أو 58 mm). بطاقات Hotspot
أضف بطاقة واحدة أو استورد قائمة: يضيف زر + Card بطاقة باسم المستخدم وكلمة المرور والاسم الذي تختاره؛ ويستورد Import قائمة CSV أو Excel مع معاينة أولاً. بطاقات Hotspot
الوقت والبيانات المتبقية على الراوتر: تعرض صفحة حالة Hotspot ما تبقى على البطاقة، وينهي الراوتر الجلسة عند نفادها. بطاقات Hotspot
مجمّع IP لكل مستخدم (مثل مجمّع CGNAT)، يُختار من مجمّعات الراوترات لديك. CGNAT ومجمّعات IP
كل المناطق الزمنية في العالم، مع الشرق الأوسط في أول القائمة.
التحقيق العميق: اختر أجهزة MikroTik BNG ومدة التشغيل، ثم اقرأ تقريراً بدرجة وما يجب فعله أولاً، بلغتك، كصفحة أو ملف PDF. يقرأ الراوتر فقط. التحقيق العميق
SCOOP AI: مساعد في أسفل كل صفحة. اسأل بكلماتك عن مستخدميك وباقاتك وفواتيرك وراوتراتك؛ المال والحذف وتغييرات الراوتر تنتظر ضغطك على Approve. SCOOP AI
Queue أسرع للمستخدمين: يحافظ على سلاسة المكالمات والألعاب أثناء تنزيل مستخدم. يستطيع معالج الراوتر ضبطه، وتقدّم الحالة إصلاحاً بنقرة واحدة.
لوحة المعلومات لكل دور: اختر إن كان الدور يرى لوحة المعلومات. الدور الذي لا يراها يفتح على أول صفحة مسموح بها.
Sham Cash: على الاتصال غير الرسمي، يستطيع المستخدم الذي نسي الرمز تأكيد الدفعة برقم الحوالة وعنوانه الخاص.
5.12
الاحتفاظ بالبيانات و Lookup: احفظ الجلسات للمدة التي يطلبها القانون (سنتان افتراضيًا)، حتى للمشتركين المحذوفين، واعرف أي مشترك كان له عنوان عام ومنفذ في وقت معين. كل بحث يحتاج رقم قضية ويُحفظ في سجل Lookup، ويمكن إرسال ملف مشفّر يوميًا إلى NAS الخاص بك. الاحتفاظ بالبيانات & Lookup
CGNAT ومجموعات عناوين IP: شارك العناوين العامة بين المشتركين بكتلة منافذ لكل مشترك، أو دع SAMM يمنح المشترك عنوانه بنفسه، لكل راوتر وخطة. CGNAT & مجموعات عناوين IP
Cisco و Huawei و Nokia و ZTE كـ NAS، مع السرعات وانقطاعات الاتصال، وصفحة إعداد جاهزة، وData Log وCGNAT على Cisco. راوترات من شركات أخرى
FTTH: OLTs من V-SOL و Huawei و ZTE و Nokia، وكل ONU مع إشارتها، وربط ONUs بالمشتركين، وقفل خط المشترك. 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 عبر NordVPN (برمز وصول) أو ملفات WireGuard من أي مزوّد بدلاً من خط SAMM، حتى عندما لا يملك SAMM عنواناً عاماً. VPN عبر SAMM
VPN عبر SAMM: يرسل المستخدمون الذين تختارهم كل حركة بياناتهم، أو التطبيقات التي يختارونها فقط، عبر خادم SAMM الخاص بك بدلاً من خطهم المحلي. فعّله لكل مستخدم أو بِعه كإضافة؛ ويشغّله المستخدمون من بوابة المستخدم. VPN عبر SAMM
SAMM على شاشتين: افتح أي صفحة، أو كتلة واحدة من لوحة المعلومات، في نافذة مستقلة وأبقِها على شاشة ثانية. لوحة المعلومات
الرقابة الأبوية كإضافة: بِع الرقابة الأبوية لمدة محددة، مثل أي إضافة أخرى. الإضافات
مُحسّن الـ Wi-Fi: عرض حي للطيف لكل راديو، والشبكات التي يلتقطها ومدى ازدحام كل قناة، مع مخطط قنوات يقترح أهدأ قناة وأفضل عرض قناة ويمكنه نقل الراديوهات بنفسه ليلاً. الشبكة
أجهزة Ubiquiti: أضف نقاط الوصول UniFi وراديوهات airOS كأجهزة مراقبة. راديوهات UniFi تعرض عملاءها والشبكات المجاورة والطيف، والمُحسّن ينقلها فعلياً إلى قناة وعرض قناة أفضل. مدير MikroTik
ثلاثة أجهزة مراقبة لكل راوتر في كل باقة: نقاط الوصول والراديوهات التي تراقبها فقط لم تعد تستهلك حصة الراوترات. مدير MikroTik
استيراد المستخدمين المحفوظين على الراوتر (PPP و Hotspot و User Manager، على RouterOS 6 و 7) مع كلمات المرور والباقات والحدود والأسماء وأرقام الهواتف وتواريخ الانتهاء، في الخلفية. مدير MikroTik
التراجع عن التجديد: حذف فاتورة تجديد يمكن أن يعيد تاريخ انتهاء المستخدم كما كان، ويمكن التراجع عن Renew Plan من الشريط العلوي، وقائمة الفواتير تعرض مجاميع كل ما يظهره الفلتر. التراجع والموافقات
نسخ احتياطية إلى Google Drive الخاص بك. اربط Google Drive من صفحة النسخ الاحتياطي والاستعادة برمز قصير؛ بعدها تُنسخ كل نسخة احتياطية تلقائية أيضًا إلى مجلد SAMM Backups في Drive الخاص بك، ويمكن استعادة أي نسخة منه. الأدوات
وقت تجديد ثابت للباقة: كل انتهاء يقع على الساعة التي تختارها، مع التقريب إلى الساعة التالية حتى لا يحصل المستخدم أبدًا على أقل من المدة. الباقات
قائمة عناوين لكل باقة: يضيف الراوتر عنوان كل مستخدم إلى قائمة تحمل اسم باقته، لاستخدامها في قواعد Firewall وQueue والتوجيه الخاصة بك. الباقات
الخدمة الذاتية: وضع جمع البيانات. يُدخل الضيف اسمه ورقم هاتفه فيتصل بالإنترنت فورًا، بدون رمز مرور؛ ويُحفظ كل دخول للتصدير. الخدمة الذاتية
مخطط جودة الاتصال الأكثر وضوحًا مع محاور، خطوط تنزيل وتحميل، تفاصيل عند المرور فوقها بالماوس وبيانات مستخدمة، بالإضافة إلى بريد إلكتروني في بحث المستخدمين وأي منفذ في بحث سجلات البيانات. المستخدمون، سجلات البيانات
5.7
الفروع تمتلك أجهزتها. كل راوتر ونقطة وصول تتبع لفرع أو للمقر الرئيسي؛ يدير موظفو الفرع أجهزتهم الخاصة ويطلعون فقط على الأجهزة التي تعلوهم في التسلسل الإداري، ويسمح إعداد للمستخدمين بتسجيل الدخول فقط من خلال راوترات فرعهم. المسؤولون، الفروع & الأدوار
القيود الزمنية للأدوار. تحديد الحد الأقصى لعدد الفترات أو الأيام التي يمكن أن يمنحها الدور مسبقا، وبدء المستخدمين الجدد بوقت محدد (ساعتان مثلا)، وفصل خيار إضافة الأيام عن إدخال تاريخ انتهاء الصلاحية. المسؤولون، الفروع & الأدوار
SSTP VPN إلى جانب WireGuard و L2TP/IPsec، لعدة راوترات خلف نفس العنوان العام. VPN
RouterOS 6 يعمل في كل مكان: المعالج، والإكمال التلقائي، وتسليم الإعدادات، والإجراءات الجماعية، ومواقع الويب & التطبيقات، و QoS وروابط VPN. RouterOS 6
الرقابة الأبوية في بوابة المستخدم: حظر الفئات والتطبيقات والمواقع الإلكترونية، بشكل دائم أو وفق تقويم أسبوعي. الرقابة الأبوية
نقاط & مكافآت عند التجديد ودعوة الأصدقاء، تُستبدل بزيادة السرعة أو أيام مجانية. نقاط & مكافآت
علامتك التجارية في لوحة التحكم وبوابة المستخدم وصفحات تسجيل الدخول، مع شعار يمكنك قصّه عبر المتصفح. Branding
تبديل اللغات، وظهور الباقة في البوابة، ووضع قالب SMS، وتثبيت SAMM عبر سطر واحد على راوتر MikroTik. اللغات، الباقات، حاوية MikroTik
5.6
تسليم الإعدادات: يتم تتبع كل تغيير يتم إرساله إلى الراوترات الخاصة بك مع نتيجة لكل راوتر، وتصل الإعدادات إلى الراوترات غير المتصلة عند عودتها، مع إعادة المحاولة تلقائيا. تسليم الإعدادات
لوحة معلومات تفتح في ثانية واحدة تقريباً، وشريط جانبي يبقى ثابتاً أثناء تغيير الصفحات.
5.5
البحث في سجل البيانات عبر جميع المستخدمين: من وصل إلى عنوان، أو منفذ، أو بروتوكول، أو تطبيق، في أي فترة زمنية. Data Log
صلاحيات مفصلة ضمن خيار تعديل (حذف المستخدمين، التمديد، تغيير الباقة، دفع الفواتير، تشغيل سكربتات الراوتر...)، ومعاينة لتاريخ الانتهاء الجديد قبل التجديد. الأدوار
5.4
البيانات المالية حسب الفرع: تتبع كل فاتورة وعملية دفع ومصروف وحساب نقدي لفرع معين، مع توفر أداة اختيار الفروع، وعمليات تسليم النقد، وتقرير الفروع. المحاسبة & الفوترة
5.3
Sham Cash، نقطة دفع واحدة لكل وسيلة دفع، وصفحة دفع عامة، وتجديد عبر الإنترنت لفترات تتراوح من 1 إلى 12. المدفوعات عبر الإنترنت
خصومات الفواتير، والإضافات مع التطبيقات المجانية، وتقرير التنشيطات، وتغيير اسم المستخدم، والدفعات المقدمة عند التجديد. Add-ons
5.2
Dynamic Speed Booster، وإجراءات مدير الأجهزة على العديد من الـ routers في وقت واحد، والإضافات، وقوائم الأسعار لكل فرع، وملفات المستخدم، والحقول المخصصة، وصفحة Traffic، وأداة تنظيف History. Speed Booster، وإجراءات مدير الأجهزة
دليل البدء
التثبيت
يقوم SAMM بتثبيت كل ما يحتاجه — FreeRADIUS و PostgreSQL و nginx و WireGuard و cloudflared والخدمات الخمس الخاصة بـ SAMM — في خطوة واحدة. يتميز برنامج التثبيت بأنه مستقل: إذ تؤدي إعادة تشغيله إلى ترقية التثبيت الحالي في مكانه، ولا يقوم أبداً بالكتابة فوق إعداداتك أو إعادة إنشاء كلمة مرور قاعدة البيانات.
دليل التنصيب
كل الخطوات مع صور توضيحية: Windows (بما في ذلك تفعيل Virtualization من BIOS)، و Ubuntu، وراوتر MikroTik، والسيرفر الجاهز، والترخيص (الدفع والربط والتجديد)، وربط الراوترات عبر VPN، والميزات الإضافية.
يقوم سكربت bootstrap هذا بتنزيل أحدث حزمة إصدار من SAMM من GitHub، وفك ضغطها، وتشغيل المثبت الكامل تلقائياً. يتم ذلك في غضون دقائق قليلة.
إذا كان github.com محظوراً في بلدك، استخدم النسخة الاحتياطية (mirror) المستضافة على Cloudflare بدلاً من ذلك — فهو نفس برنامج التثبيت، ولا يتم جلب أي ملفات من GitHub. (كما أن الأمر القياسي المذكور أعلاه يكتشف حظر GitHub وينتقل إلى هذه النسخة تلقائياً.)
في كلتا الحالتين، بمجرد انتهاء برنامج التثبيت، افتح بوابة المسؤول وسجل الدخول باستخدام بيانات الاعتماد هذه:
رابط تسجيل الدخول URLhttp://<your-server>/admin·اسم المستخدمadmin·كلمة المرورadmin
تغيير كلمة مرور المسؤول فور تسجيل الدخول لأول مرة.
التثبيت
الخيار B — التثبيت على Windows (Hyper-V)
يعمل SAMM على Windows داخل جهاز Ubuntu 24.04 افتراضي صغير على Hyper-V، يتم إنشاؤه وإدارته بواسطة مثبت واحد. تنضم الـ VM إلى شبكتك بعنوان IP خاص بها، مما يتيح لراوترات MikroTik الوصول إلى SAMM مباشرة — حيث يرى RADIUS العنوان الحقيقي لكل راوتر، وتعمل عمليات فصل CoA — تماما مثل خادم Linux.
افتح PowerShell كمسؤول — وليس موجه الأوامر (cmd):
انقر بزر الماوس الأيمن على زر ابدأ، واختر الطرفية (المسؤول) أو Windows
PowerShell (Admin)، ثم اختر نعم. بعد ذلك قم بتشغيل:
إذا تعذّر الوصول إلى samm.securytik.com من هذا الجهاز، فاستخدم المرآة المستضافة على Cloudflare بدلاً منه — المُثبِّت نفسه. (ويتحوّل المُثبِّت أيضاً إلى المرآة تلقائياً عند فشل أي تنزيل.)
في كلتا الحالتين، بمجرد انتهاء برنامج التثبيت، افتح بوابة المسؤول وسجل الدخول باستخدام بيانات الاعتماد هذه:
رابط تسجيل الدخول URLhttp://<SAMM IP>/admin·اسم المستخدمadmin·كلمة المرورadmin
تسجيل الدخول إلى OS (SSH)samm / samm·Root (console)root / samm
نفس الإعدادات الافتراضية لـ SAMM Server ISO. يجب تغييرها جميعاً بعد تسجيل الدخول الأول. يعرض اختصار SAMM Info على سطح المكتب هذه الإعدادات مرة أخرى، مع عنوان IP الخاص بـ SAMM وكيفية الوصول إلى VM عبر SSH.
المطلوب
يجب اختيار أي شبكة SAMM عندما يكون لدى PC أكثر من محول متصل. اضغط Enter للخيار الموصى به (السلكي قبل Wi-Fi).
عنوان IP الخاص بـ SAMM على تلك الشبكة. يقترح النظام عنواناً متاحاً؛
اضغط Enter لقبوله، أو اكتب عنواناً آخر، أو اكتب dhcp.
إذا كان Hyper-V متوقفاً، سيقوم برنامج التثبيت بتفعيله ويطلب إعادة تشغيل Windows مرة واحدة؛ وبعد تسجيل الدخول مرة أخرى، سيواصل العملية تلقائياً. أما بقية المكونات — Multipass، وجسر الشبكة، والـ VM، و SAMM نفسه — فتستغرق من 10 إلى 20 دقيقة، مع ظهور شريط تقدم.
المتطلبات
Windows 10 / 11 Pro, Enterprise أو Education، أو Windows Server 2019 والإصدارات الأحدث (64-bit). لا يتوفر Hyper-V في Windows Home.
تفعيل تقنية المحاكاة الافتراضية للعتاد في BIOS/UEFI (Intel VT-x أو
AMD-V). يتحقق برنامج التثبيت من ذلك ويتوقف مع ظهور رسالة واضحة في حال كانت معطلة — انظر
تفعيل المحاكاة الافتراضية.
ذاكرة لا تقل عن 8 GB، مع توفير 4 GB مساحة حرة لـ VM الخاصة بـ SAMM (الحد الأدنى 3 GB؛ وتُحسب الآلات الافتراضية الأخرى — VMware، VirtualBox — من ضمن هذه المساحة)، ومساحة قرص فارغة تبلغ 40 GB.
يوصى بشدة باستخدام كابل شبكة؛ حيث لا تدعم العديد من تعريفات Wi-Fi ربط جهاز افتراضي بالشبكة، مما يجعل الوصول إلى SAMM مقتصرًا على جهاز PC نفسه فقط.
بعد التثبيت
افتح لوحة التحكم للمسؤول عبر http://<SAMM IP>/admin/login (يوجد اختصار SAMM Admin على سطح المكتب)، وسجل الدخول باستخدام admin / admin ثم قم بتغيير كلمة المرور على الفور.
قم بتوجيه MikroTik RADIUS إلى SAMM IP (UDP 1812/1813) — وسيقوم معالج الراوتر في لوحة التحكم بذلك نيابة عنك.
يبدأ SAMM مع Windows، قبل تسجيل دخول أي مستخدم، ويتم ضبط PC بحيث لا يدخل في وضع السكون أبداً. في حالة laptop، حافظ على توصيل الشاحن واضبط خيار إغلاق الغطاء على "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 — في AMD. تأتي معظم أجهزة PC وهذه الميزة مفعلة، بينما تكون معطلة في بعض الأجهزة. وتضع كل شركة مصنعة هذا الخيار في قائمة مختلفة، لذا إليك الخطوات العامة وأماكن تواجدها عادة.
أولاً، تحقق مما إذا كان مفعلًا بالفعل
افتح Task Manager (Ctrl+Shift+Esc) ← Performance ←
CPU. تحت الرسم البياني، تعني عبارة Virtualization: Enabled أن العملية تمت بنجاح.
(في حال كان Hyper-V مفعلًا بالفعل، قد يظهر Windows سطرًا يشير إلى اكتشاف hypervisor بدلاً من ذلك —
وهذا يعني أيضًا أنه مفعل.)
خطوات عامة
احفظ عملك وأعد تشغيل الـ PC.
افتح إعدادات BIOS/UEFI: اضغط على مفتاح الإعداد بشكل متكرر بمجرد إضاءة الشاشة (راجع الجدول). في Windows 10/11 يمكنك أيضا الانتقال إلى Settings → System → Recovery → Advanced startup → Restart now، ثم Troubleshoot → Advanced options → UEFI Firmware Settings → Restart.
ابحث في قائمة Advanced أو Advanced CPU أو
Processor أو Chipset أو Security أو
Virtualization عن Intel Virtualization Technology أو
Intel VT-x أو SVM Mode أو AMD-V، واضبط الخيار على
Enabled. (لا حاجة لـ Intel VT-d / AMD IOMMU.)
حفظ وخروج (عادة F10)، ثم اترك Windows يبدأ، وبعد ذلك قم بتشغيل مثبت SAMM مرة أخرى.
الموقع المعتاد لها
العلامة التجارية
مفتاح الإعداد
المكان المعتاد
Dell
F2
دعم Virtualization ← Virtualization / تفعيل Intel Virtualization Technology
HP
F10 (أو Esc، ثم F10)
متقدم (أو Security / System Configuration) ← تقنية Virtualization Technology (VTx)
الوضع المتقدم (F7) ← Advanced ← CPU Configuration ← Intel Virtualization Technology أو SVM Mode
Acer
F2
متقدم (أو رئيسي) ← Intel Virtualization Technology
MSI
Del
OC ← ميزات CPU ← Intel Virtualization Tech أو SVM Mode
Gigabyte
Del
Tweaker (أو Advanced) ← إعدادات CPU المتقدمة ← Intel Virtualization Technology أو SVM Mode
الخوادم (Dell iDRAC, HPE, Supermicro)
F2 / F9 / Del
إعدادات Processor ← Virtualization Technology — غالباً ما تكون مفعلة بالفعل
الجهاز الافتراضي داخل جهاز افتراضي آخر (مثل تشغيل Windows داخل VMware أو Proxmox أو Hyper-V) يتطلب تفعيل nested virtualization في الـ hypervisor الخارجي — على سبيل المثال "Virtualize Intel VT-x/EPT" في إعدادات CPU الخاصة بـ VMware، مع إيقاف تشغيل الـ VM.
التثبيت
الخيار C — التثبيت يدوياً من حزمة الإصدار
قم بتنزيل أحدث إصدار من samm-<version>.tar.gz من صفحة GitHub Releases، ثم على الخادم:
tar -xzf samm-<version>.tar.gz
cd samm-<version>
sudo bash install.sh
يمكنك أيضا النشر باستخدام ملف zip تم إنشاؤه على جهاز آخر — حيث يقوم برنامج التثبيت بنقل المصدر عبر rsync إلى المسار /opt/samm نفسه:
أو استنساخ المستودع إلى /opt/samm وتشغيل sudo bash /opt/samm/install.sh.
في كلتا الحالتين، بمجرد انتهاء برنامج التثبيت، افتح بوابة المسؤول وسجل الدخول باستخدام بيانات الاعتماد هذه:
رابط تسجيل الدخول URLhttp://<your-server>/admin·اسم المستخدمadmin·كلمة المرورadmin
تغيير كلمة مرور المسؤول فور تسجيل الدخول لأول مرة.
التثبيت
الخيار D — التثبيت باستخدام Docker Compose
إذا كنت تفضل تشغيل SAMM كحاويات — وهو نفس المنتج ولكن بتغليف مختلف —
استخدم توزيعة Docker Compose المتاحة في github.com/mhdhaidarah/samm-docker.
على أي مضيف يتوفر فيه Docker:
يقوم ذلك بتثبيت Docker في حال عدم توفره، ويضع ملف docker-compose.yml في المسار /opt/samm-docker/ مع تعبئة كلمة مرور عشوائية وقوية لقاعدة البيانات مسبقاً، ثم يبدأ تشغيل الـ stack. يتم بناء الصورة mhdhaidarah/samm من نفس الحزمة المجمعة المستخدمة في تثبيت bare-OS — وهي مغلقة المصدر بطبيعتها.
Multi-arch — يتوفر نفس الوسم لـ linux/amd64 و linux/arm64، ويتم اختيار الإصدار المناسب تلقائياً من الوسم: docker pull على أي مضيف Docker (Intel/AMD, ARM server, Apple-silicon Mac)، و MikroTik RouterOS 7.23+ على الراوتر نفسه. ملف واحد، لكل المنصات.
في المضيفات التي لا يُسمح فيها بتمرير curl إلى bash (الأجهزة المقيدة، سياسات الخروج الصارمة)، يمكنك جلب ملف 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 على مستوى المضيف والتي لا يمكن الوصول إليها من داخل الحاوية. اختر الخيار A أو C أعلاه إذا كنت بحاجة إلى هذه الميزات المدمجة، أو قم بتشغيل cloudflared / wg-quick على مضيف Docker مباشرة بجانب SAMM. راجع
README الخاص بنسخة Docker للاطلاع على كافة تنبيهات الإصدار v1 ومسار التثبيت اليدوي.
على Windows (Docker Desktop) — للتقييم فقط
غير موصى به لبيئات الإنتاج. تؤدي وضعيات السكون / السبات / إغلاق غطاء الجهاز في Windows إلى إيقاف الحاويات؛ ولا يتم تفعيل إعادة التشغيل عند الإقلاع إلا عند بدء تشغيل WSL (وليس عند إقلاع Windows)؛ كما أن مهمة التحديث التلقائي اليومية cron تعمل فقط طالما كان WSL نشطاً. استخدم هذا الخيار للتقييم / العرض التجريبي، ثم قم بنشر بيئة الإنتاج على Linux VM (مثل Hyper-V، Proxmox، ESXi) أو جهاز مادي صغير (مثل NUC يعمل بنظام Ubuntu Server).
تثبيت Docker Desktop لنظام Windows (ليقوم بإعداد البنية التحتية 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 خدمات. بمجرد أن تصبح جميعها باللون الأخضر، افتح بوابة المسؤول وسجل الدخول باستخدام بيانات الاعتماد هذه:
رابط تسجيل الدخول URLhttp://localhost:8000/admin·اسم المستخدمadmin·كلمة المرورadmin
تغيير كلمة مرور المسؤول فور تسجيل الدخول لأول مرة.
إذا كان جهاز MikroTik NAS حقيقي سيقوم بزيارة مضيف Windows هذا لطلبات RADIUS، اسمح بمرور UDP 1812 + 1813 عبر جدار الحماية Windows Firewall:
إزالة: docker compose down -v من دليل التثبيت
(يقوم الخيار -v بمسح وحدة postgres ومفتاح Fernet — يرجى أخذ نسخة احتياطية منهما أولا إذا كنت قد أضفت بيانات).
التثبيت
الخيار E — التثبيت على راوتر MikroTik (RouterOS 7.23+)
نفس SAMM، دون الحاجة إلى جهاز Linux. إذا كان جهاز MikroTik يدعم حزمة container وبه محرك أقراص USB أو microSD متصل، يمكنك تشغيل المكونات البرمجية بالكامل مباشرة على الراوتر — باستخدام نفس docker-compose.yml المستخدم في كل مكان آخر. يقوم RouterOS 7.23+ بسحب بنية CPU الصحيحة من وسوم الصور متعددة البنيات تلقائياً، لذا لا يوجد شيء خاص بالراوتر للتنزيل.
الأجهزة المدعومة: كل راوتر MikroTik يدعم الحاويات — RB5009, hAP ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009, وما يماثلها (arm64)، بالإضافة إلى x86 RouterOS و CHR (amd64). الأجهزة غير المدعومة: أجهزة armv7 / mipsbe / smips / tile / ppc (مثل hEX, RB750, وموديلات RB القديمة) — لعدم دعم الحاويات أو لعدم كفاية RAM/CPU لتشغيل SAMM. يتطلب RouterOS الإصدار 7.23 أو أحدث (الإصدارات الأقدم لا يمكنها اختيار المعمارية من علامة multi-arch).
الطريقة السريعة: سطر واحد يتم لصقه
افتح الطرفية الخاصة بالراوتر (WinBox ← New Terminal، أو SSH) والصق هذا السطر:
يتحقق من إصدار RouterOS وCPU والذاكرة في الراوتر، ويثبّت حزمة الحاويات، ويفعّل وضع الحاويات، ويبحث عن قرص ext4 بسعة 30 GB على الأقل، ويُنزّل SAMM مع كلمة مرور قاعدة بيانات عشوائية قوية، ويشغّله، ثم ينتظر حتى تستجيب اللوحة. عندما يطلب منك ذلك (بعد إعادة التشغيل، أو بعد إعادة تشغيل الطاقة، أو بعد تجهيز القرص)، الصق السطر نفسه مرة أخرى: كل خطوة تتحقق مما تم إنجازه وتكمل من حيث توقفت. لا يقوم أبدًا بتهيئة قرص بنفسه، ولا يمسّ أي شيء يعمل بالفعل.
هل تفضل القيام بذلك يدويا؟ اتبع الخطوات أدناه.
1. تجهيز الراوتر
ثبت حزمة container (من extra_packages.zip على mikrotik.com/download — ارفع ملف container-*.npk المطابق عبر Files، ثم أعد التشغيل). بعد ذلك فعل وضع container (لمرة واحدة — يتم التفعيل فقط بعد إعادة تشغيل الطاقة بالكامل، وليس إعادة تشغيل برمجية):
/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 وطبقات الصورة مساحة إضافية). في الراوتر:
/disk print
# note the disk slot, e.g. "usb1-part1" or "disk1"
/disk format usb1-part1 file-system=ext4 label=samm
بعد التهيئة، تحقق من تثبيت القرص وقابليته للكتابة:
/disk print detail
# look for "type=ext4" and a mount point like "/usb1-part1"
ثم حدد للراوتر مكان تنزيل الصور من (Docker Hub) ومكان فك ضغطها — وبدون ذلك ستفشل كل حاوية 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 (نقطة تعيينه)، وليس في وحدة التخزين الصغيرة الخاصة بالراوتر. ثم في 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، ثم إرسال. يقوم RouterOS 7.23+ بسحب بنية CPU الصحيحة من image tags تلقائياً.
هل توقفت عند "waiting for reverse proxy"؟ في RouterOS 7.23+، قم بإلغاء تحديد Use HTTPS في نافذة Apps ثم أعد النشر — هذا الخيار يتحكم في proxy الخاص بـ web-UI للتطبيق، وليس في كيفية سحب الصور.
بمجرد تشغيل حاويات SAMM، افتح بوابة المسؤول في المتصفح وسجل الدخول باستخدام بيانات الاعتماد هذه:
رابط تسجيل الدخول URLhttp://<router-ip>:8000/admin·اسم المستخدمadmin·كلمة المرورadmin
قم بتغيير كلمة مرور المسؤول فوراً. تتوفر خدمات RADIUS auth + accounting على منافذ UDP 1812 + 1813 على الراوتر نفسه، لذا يمكن لـ MikroTik RADIUS client الاتصال بالعنوان 127.0.0.1 باستخدام الـ shared secret الذي قمت بتعيينه في System → RADIUS.
مسار نشر تجريبي. ميزة الحاويات في RouterOS أكثر بساطة من Docker Compose — حيث يختلف سلوك DNS لاسم الخدمة، وترتيب التبعيات (depends_on)، وإعادة التشغيل المباشرة. إذا لم يعمل المكدس بشكل صحيح على جهازك، ارجع إلى تشغيل Docker على جهاز Linux صغير (NUC, Pi 4, Linux VM) بجانب MikroTik. يعمل ملف compose نفسه هناك مع دلالات Compose الكاملة.
ضمان استمرار تشغيل SAMM بعد إعادة التشغيل أو الانهيار
يقوم RouterOS بإنشاء حاويات التطبيق دون تفعيل التشغيل التلقائي. قم بتشغيل هذا الأمر مرة واحدة بعد التثبيت: لتبدأ كل حاوية 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. تحديث — النسخ الاحتياطي والاستعادة يدوياً
تحديث تطبيق MikroTik container يؤدي إلى حذف قاعدة البيانات الخاصة بك.
لا يمكن لـ RouterOS تغيير إصدار تطبيق مثبت في مكانه؛ فالطريقة الوحيدة هي إزالة التطبيق وإضافته مجدداً، وعملية الإزالة تحذف كل ما خزنه التطبيق، بما في ذلك قاعدة بيانات SAMM. خذ نسخة احتياطية وقم بتنزيلها إلى جهاز الكمبيوتر الخاص بك قبل إزالة التطبيق. فالنسخة الاحتياطية التي تترك على الراوتر تُحذف مع كافة البيانات الأخرى.
لتحديث تثبيت MikroTik container إلى إصدار جديد:
في SAMM، انتقل إلى Tools → Backup، وأنشئ نسخة احتياطية، ثم
تنزيل الملف إلى جهاز الكمبيوتر.
في الراوتر، إزالة التطبيق وإضافته مرة أخرى بالإصدار الجديد.
افتح SAMM الجديد، وانتقل إلى Tools → Backup واسترجع الملف الذي قمت بتنزيله.
ينطبق هذا على MikroTik container فقط. أما في Docker
(Linux أو Windows أو Linux VM)، فيتم التحديث عبر docker compose pull ثم
docker compose up -d، وتبقى بياناتك دون تغيير — حيث تظل volumes خارج
containers ومحفوظة.
التثبيت
الخيار 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 — يجب تغييرها جميعاً.
يعمل برنامج التثبيت كشاشة عرض تقدم ملونة ومباشرة — شريط نسبة مئوية وقائمة مراجعة لكل مرحلة. يتم تسجيل المخرجات الخام لكل مرحلة في /var/log/samm-install.log؛ وفي حال الفشل يتم طباعة آخر 30 سطراً.
المكون
تفاصيل
FreeRADIUS 3
تم تكوينه باستخدام قاعدة بيانات PostgreSQL وعملاء NAS ديناميكيين؛ وتم التحقق من صحة الإعدادات عبر freeradius -CX
PostgreSQL
قاعدة البيانات، والمخطط، وجميع ترحيلات SQL المطبقة — كل ملف ترحيل مستقل ويمكن تشغيله أكثر من مرة
Python venv
تم تثبيت جميع التبعيات من requirements.txt؛ وتجميع كتالوجات الترجمة. إذا لم يتطابق Python الخاص بالتوزيعة مع الحزمة المجمعة، يقوم المثبت بجلب مترجم مستقل مطابق إلى /opt/samm/runtime تلقائياً
nginx
إضافة Reverse proxy بشكل تراكمي — لا يتم حذف المواقع الموجودة أبداً. يستخدم منفذ 80 إذا كان متاحاً؛ وإلا يطلب منفذاً بديلاً
تم تثبيت الحزم؛ يتم التكوين لاحقاً من System → VPN
cloudflared
يتم تثبيت Binary دائماً؛ رمز النفق اختياري عند التثبيت أو يمكن إضافته لاحقاً من System → Cloudflare Tunnel
يتم إنشاء جميع بيانات الاعتماد تلقائياً — كلمة مرور قاعدة البيانات ومفاتيح توقيع الجلسة — عند التثبيت الأول.
مطالبات تفاعلية
تظهر أي مطالبات في البداية، قبل بدء التثبيت:
Cloudflare token — لصق رمز Zero Trust connector لنشر
SAMM عبر الإنترنت دون فتح منافذ، أو الضغط على Enter للتخطي وتكوينه لاحقاً.
منفذ HTTP — إذا كان المنفذ 80 مستخدماً بالفعل، يترك برنامج التثبيت تلك المواقع دون تغيير ويطلب منفذاً بديلاً (الافتراضي 8080).
ملخص التثبيت
عندما ينتهي برنامج التثبيت، يطبع ملخصاً يحتوي على URL المسؤول، وبيانات تسجيل الدخول الافتراضية، ومنفذ HTTP المختار، وبيانات اعتماد قاعدة البيانات، ومسارات ملف التكوين:
============================================================
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.
بيئات معزولة & قاعدة بيانات بعيدة
يشحن SAMM برنامج SAMM فقط — أما FreeRADIUS و PostgreSQL و nginx والبقية فيتم جلبها عند التثبيت من مستودعات apt الأصلية، لذا يجب تجهيز هذه الحزم مسبقاً في عمليات التثبيت المعزولة عن الشبكة (air-gapped). بالنسبة لـ PostgreSQL عن بعد، يتم تعيين DSN في /etc/samm/samm.yaml بعد التثبيت.
دليل البدء
الخطوات الأولى
تتطلب عملية التثبيت الجديدة خمس مهام قصيرة للوصول إلى المرحلة التي يمكن للمشتركين فيها الاتصال وبدء الفوترة.
1 · تسجيل الدخول لأول مرة
افتح http://<your-server>/admin/ (استخدم منفذ HTTP من
ملخص التثبيت إذا لم يكن 80)، أو رابط نفق Cloudflare الخاص بك.
تسجيل الدخول باستخدام المسؤول / admin.
غير كلمة المرور فوراً من System → Admins،
أو من قائمة الملف الشخصي في الشريط العلوي.
2 · إضافة أول راوتر لك
انتقل إلى MikroTik → NAS وانقر على إضافة راوتر.
أدخل عنوان IP الخاص بالراوتر، واسماً مختصراً، والسر المشترك لـ RADIUS. بالنسبة لأجهزة MikroTik، يمكنك اختيارياً إضافة بيانات اعتماد API لمزامنة الجهاز مباشرة.
في MikroTik، أضف خادم RADIUS يشير إلى مضيف SAMM (المنافذ 1812/1813) باستخدام نفس shared secret، وفعّل RADIUS لـ PPP / Hotspot.
لا حاجة لإعادة تشغيل FreeRADIUS — حيث يقوم SAMM بتحديد عملاء NAS ديناميكياً من قاعدة البيانات. راجع Routers (NAS) لمعرفة الإجراء الكامل، أو استخدم معالج الإعداد لتكوين MikroTik تلقائياً.
3 · إنشاء باقة
تحدد الباقة السرعة والحدود والسعر الذي تبيعه. انتقل إلى
Users → Plans → New plan. المرجع الكامل للحقول:
Plans & limits.
4 · إضافة مشترك
انتقل إلى Users → New customer، واملأ بيانات تسجيل الدخول واختر باقة. يمكن للمشترك الاتصال فوراً. وللوصول إلى hotspot مسبق الدفع، قم بإنشاء voucher cards بدلاً من ذلك.
5 · تفعيل الترخيص
يعمل التثبيت الجديد بحالة غير مسجل ضمن أدنى فئة. افتح
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
قائمة المشتركين المصدرة — لا يوفر هذا النظام تصدير نسخة احتياطية
غالباً ما تكون النسخ الاحتياطية لقاعدة البيانات بحجم عدة جيجابايت؛ وهذا أمر طبيعي، ارفع الملف كما هو. النسخ الاحتياطية المضغوطة لا تحتاج إلى فك الضغط أولاً.
آلية العمل
رفع الملف. لم يتم كتابة أي شيء بعد.
مراجعة المعاينة. تعرض هذه المعاينة الباقات والمشتركين الذين سيتم إنشاؤهم، وتنبه إلى أي عناصر تم تخطيها أو تصحيحها، وتتحقق من المجموع مقابل الترخيص الخاص بك قبل التأكيد.
اختر الإجراء المتخذ لأسماء المستخدمين الموجودة مسبقاً في
SAMM — تخطيها والاحتفاظ بسجل SAMM، أو تحديث الاسم وبيانات الاتصال من
النظام القديم.
استيراد. يتم كتابة كل صف بشكل مستقل، لذا فإن وجود صف واحد خاطئ لا يؤدي إلى تراجع العمليات في الصفوف الأخرى.
ما يتم استقباله
الباقات — الاسم، والسرعات، والسعر، والمدة، وحصة البيانات
حيث يتم تسجيلها في النظام القديم.
المشتركون — اسم المستخدم، كلمة مرور الخدمة، الاسم، تفاصيل الاتصال، تاريخ الانتهاء، الباقة، static IP و MAC.
يبقى المشتركون الذين تم تعطيلهم في النظام القديم معطلين.
لا يتم استيراد الفواتير، والمطالبات المالية، والبطاقات مسبقة الدفع، والتذاكر، والسجلات المحاسبية وسجلات المسؤول عمدًا — لأنها تتبع نموذج بيانات النظام القديم ونادرًا ما تتوافق بشكل دقيق.
قيم لا تتطابق مع العمود الخاص بها
قواعد البيانات الحقيقية تكون غير منظمة: عنوان مكتوب في خانة البريد الإلكتروني، ملاحظة في حقل الهاتف المحمول، أو رقم هاتف مكتوب بلوحة مفاتيح عربية. يقوم SAMM بفحص كل قيمة مقابل ما يفترض أن يحتويه العمود الخاص بها. وأي قيمة غير متوافقة يتم استبعادها خارج ذلك الحقل وحفظها بدلاً من ذلك في ملاحظات المشترك المخصصة للمسؤول فقط، مع الإشارة إلى مصدرها — لضمان عدم فقدان أي بيانات وعدم تلوث أي حقل. وتوضح المعاينة عدد القيم التي تأثرت بذلك.
Pro Radius تفاصيل
يقوم Pro Radius بتصدير المشتركين وليس الباقات، لذا يقوم SAMM باستنتاج الباقات من مستوى خدمة كل مشترك، مع استخراج السرعة من الاسم (الخدمة المسماة "4MBPS" تصبح باقة 4 Mbps). هناك ثلاثة عناصر غير موجودة في ذلك الملف، ويتم تعيينها إلى قيم افتراضية منطقية يجب مراجعتها لاحقاً:
المدة — يتم ضبطها على شهر واحد. يتم استيراد تاريخ انتهاء الصلاحية الفعلي لكل مشترك دون تغيير، لذا فإن هذا يؤثر فقط على عمليات التجديد المستقبلية.
سرعة الرفع — يتم ضبطها لتطابق معدل التنزيل.
Price — تعيين القيمة إلى 0.
مراجعة الباقات قبل الفوترة
بعد استيراد Pro Radius، افتح Plans وحدد السعر والفترة الفعليين لكل باقة. وإلى أن يتم ذلك، ستكون قيمة فوترة هذه الباقات صفراً.
معلومات مفيدة
يمكن تشغيله أكثر من مرة بأمان. فإعادة استيراد الملف نفسه تتجاوز جميع المستخدمين الموجودين بالفعل بدلاً من تكرارهم.
لا يزال ترخيصك سارياً. إذا كان الملف يحتوي على مشتركين أكثر مما تسمح به الفئة الخاصة بك، فستوضح المعاينة ذلك مسبقاً وتخبرك بالعدد الذي يمكن استيعابه — يمكنك الترقية، أو استيراد مجموعة جزئية.
قم بأخذ نسخة احتياطية أولاً إذا كنت تقوم بالاستيراد إلى تثبيت يحتوي بالفعل على بيانات فعلية.
المشتركون و& الباقات
الباقات & الحدود
تعتبر الباقة تعريفاً للخدمة المخصصة للمشتركين — حيث تحدد السرعة والحدود والسعر. أنشئ الباقات قبل إضافة المستخدمين.
يتضمن التثبيت الجديد بالفعل 9 باقات جاهزة للاستخدام — ثماني فئات سرعة شهرية بالإضافة إلى باقة "Expired" لتحديد السرعة — بحيث يمكنك البدء بالبيع فوراً أو إنشاء باقاتك الخاصة. تتم عملية التغذية الأولية فقط عند التثبيت الأول ولا تقوم أبداً باستبدال الباقات التي أضفتها.
إنشاء باقة
انتقل إلى Users → Plans.
انقر على باقة جديدة.
املأ النموذج وانقر على حفظ الباقة.
كل حد عبارة عن مفتاح تبديل — فعل الحدود التي تحتاجها فقط. تستخدم نفس النافذة المنبثقة لتعديل باقة موجودة (افتح قائمة ⋮ الخاصة بالصف ← Edit).
حقول الباقة
حقل
المعنى
الاسم
اسم باقة فريد، على سبيل المثال Home-50M
السعر
يتم الاحتساب لكل فترة فوترة عند استخدام إصدار الفواتير
سرعة التنزيل / الرفع
مثلا 50M، 512K، 1G — يتم تطبيقها كـ MikroTik rate limit
جلسات متزامنة
عدد الأجهزة التي يمكن أن تكون متصلة في وقت واحد في هذه الباقة. 1 بشكل افتراضي — يتم رفض تسجيل الدخول الثاني طالما أن الاتصال الأول لا يزال قائماً. ضع 0 لعدد غير محدود. يتم تجاهل الجلسة التي توقفت عن إرسال التقارير، لذا فإن انقطاع الاتصال لا يمنع المشترك من الدخول أبداً
الحد: تاريخ الانتهاء
ينتهي الاشتراك بعد فترة زمنية محددة من التفعيل (أيام/شهور/ساعات/دقائق)
الحد: الحصة
حد أقصى لإجمالي البيانات (مدمج، أو للتنزيل فقط، أو للرفع فقط) للاشتراك بأكمله
الحد: وقت التشغيل
حد أقصى لوقت الاتصال التراكمي — مجموع مدد جميع الجلسات
الحد: الاستخدام اليومي
حد أقصى للبيانات يتم إعادة ضبطه يوميا في وقت إعادة الضبط اليومي المحدد
نافذة غير محدودة
إضافة سريعة لنافذة سرعة واحدة — يتوفر المحرر الكامل في صفحة Speed Windows الخاصة بالباقة
تجمع عناوين IP
اسم RADIUS Framed-Pool اختياري لتعيين العنوان
تجديد تلقائي
بدء فترة جديدة عند انتهاء الصلاحية بدلاً من تغيير الباقة أو قطع الاتصال
الحدود الأربعة
كل حد مستقل واختياري. عند تعيين عدة حدود، يقوم SAMM بالتحقق منها بـ
ترتيب ثابت — expiration ← quota ← uptime ← daily — والحد الأول الذي يتم استنفاده هو الذي يحدد الإجراء المتخذ.
تحديد
مسارات
عند النفاذ
انتهاء الصلاحية
وقت التقويم منذ التفعيل
التبديل إلى باقة أخرى، أو قطع الاتصال
الحصة
إجمالي البايتات المستخدمة
التبديل إلى باقة أخرى، أو قطع الاتصال
مدة التشغيل
مجموع ثواني الجلسة
التبديل إلى باقة أخرى، أو قطع الاتصال
يومي
عدد البايتات منذ آخر إعادة ضبط يومية
تحديد السرعة — إلى السرعات التي تحددها، أو عبر باقة أبطأ — حتى إعادة الضبط اليومية التالية
لكل حد، اختر ما يحدث عند النفاد: حدد next plan
لتحويل المشترك إليها، أو اتركها — disconnect —. يقوم الحد اليومي بتقليل السرعة بدلاً من قطع الاتصال: بشكل افتراضي، يمكنك إدخال سرعات التحديد مباشرة (حقول download / upload)، أو اختيار باقة "التالية" أبطأ — وفي كلتا الحالتين، يعود المشترك إلى الباقة الأصلية تلقائياً عند إعادة الضبط اليومي التالي.
نوافذ السرعة
تتجاوز نافذة السرعة السرعة الأساسية للباقة لساعات محددة — على سبيل المثال نافذة سرعة غير محدودة بعد منتصف الليل. انقر على صف الباقة لفتح محرر Speed Windows، الذي يضيف تحكماً في أيام الأسبوع ويدعم النوافذ التي تتجاوز منتصف الليل. عند تطابق عدة نوافذ، يتم تطبيق النافذة ذات السرعة الأعلى.
ملاحظة
يتم استبعاد المشتركين الذين تم تقييد سرعتهم أو استنفاد حدودهم من نوافذ السرعة — لا يقوم SAMM أبداً برفع السرعة طالما كان هناك حد مفروض.
مفهومان للاستخدام
يحتفظ SAMM ببيانات الاستخدام في مكانين، ولا يخلط بينهما أبداً:
عدادات قابلة لإعادة الضبط — حالة كل حد. يتم تصفيرها عند قيام المسؤول بإعادة الضبط أو عبر إعادة الضبط اليومية.
عدادات الفوترة — إجماليات تراكمية غير قابلة لإعادة الضبط. لا يتم تصفيرها أبداً، لضمان دقة التقارير والفواتير.
إدارة الباقات
تعرض قائمة الباقات سرعة كل باقة، وعدد المشتركين، والحدود النشطة، ونوافذ السرعة. يمكنك من قائمة ⋮ الخاصة بالصف تعديل الباقة، أو فتح نوافذ السرعة الخاصة بها، أو تفعيلها/تعطيلها، أو الانتقال إلى المشتركين التابعين لها، أو حذفها (فقط في حال عدم وجود مشتركين). يتيح تعديل عروض التجديد التلقائي تعميم التغيير على جميع المشتركين الحاليين.
تقوم عملية Duplicate بنسخ باقة بالكامل — السرعات، والحدود، ونوافذ السرعة، والسعر — تحت اسم جديد، وهو أمر أسرع بكثير من إعادة بناء التعرفة يدوياً لتغيير رقم واحد. إذا كان الاسم الذي اخترته مستخدماً بالفعل، فسيتم استخدام الرقم المتاح التالي.
الباقات التي يراها المستخدمون
يحدد مفتاح Users can see this plan في كل باقة (وكذلك كإجراء جماعي في قائمة Plans) الباقات التي يراها المستخدمون ويمكنهم اختيارها في البوابة الخاصة بهم. يكون هذا المفتاح معطلاً افتراضياً لكل باقة، لذا لن يظهر شيء حتى تقوم بالاختيار؛ ويرى المستخدم دائماً باقته الخاصة.
المشتركون و& الباقات
المشتركون
إن المشترك (العميل / المستخدم) هو حساب PPPoE أو Hotspot يتم التحقق من هويته عبر SAMM. يتم تعيين باقة واحدة فقط لكل مشترك.
إنشاء مشترك
انتقل إلى Users وانقر على New customer.
تعبئة النموذج والحفظ — يمكن للمشترك الاتصال فوراً.
حقل
المعنى
اسم المستخدم *
اسم تسجيل الدخول PPPoE / Hotspot — يجب أن يكون فريداً
كلمة المرور *
كلمة مرور تسجيل الدخول (المخزنة لتوثيق RADIUS عبر PAP/CHAP)
الاسم الأول / اسم العائلة
اسم المشترك
جوال / بريد إلكتروني / عنوان
بيانات الاتصال — تستخدم للإشعارات والفواتير
باقة *
باقة الخدمة المراد تعيينها
تجاوز تاريخ الانتهاء
تاريخ انتهاء يدوي اختياري بدلاً من التاريخ المحتسب للباقة
تجديد تلقائي
تجديد فترة الباقة تلقائيا عند الانتهاء
إنشاء مشتركين متعددين دفعة واحدة
تتيح خاصية New batch users إنشاء سلسلة مرقمة من الحسابات في عملية واحدة — وهي الطريقة المعتادة لتسليم مجموعة من بيانات تسجيل الدخول عند تنفيذ مشروع في قرية، أو فندق، أو لموزع. اختر عدد الحسابات، ورقم البداية، وعدد الخانات المطلوب تعبئتها (3 تعطي 001, 002, …)؛ أما بقية التفاصيل — الباقة، وتاريخ الانتهاء، والتجديد التلقائي — فيتم تعبئتها مرة واحدة وتطبيقها على الجميع. يتشارك جميع المستخدمين كلمة مرور واحدة.
ينطبق خيار الفاتورة على كل مستخدم في الدفعة بشكل منفصل، لذا فإن تشغيل عملية لخمسين مستخدماً يؤدي إما إلى إصدار خمسين فاتورة أو عدم إصدار أي فاتورة، ويظهر المجموع قبل التأكيد.
قائمة المشتركين
تعرض صفحة Users قائمة بكل مشترك مع نقطة حالة للمعاينة السريعة، والباقة المخصصة، والمقدار المتبقي من كل حد — الاستخدام اليومي مع شريط تقدم، والحصة المتبقية، ومدة التشغيل المتبقية، والأيام المتبقية. يمكن التصفية حسب الحالة (All / Active / Suspended / Expired / Online) أو البحث بواسطة اسم المستخدم، أو الاسم، أو الهاتف المحمول.
شارة تبديل الباقة
تمثل الشارة الواحدة باقة المشترك. شاراتان يربط بينهما سهم
تعني أن المشترك وصل إلى حده اليومي وتم نقله مؤقتا إلى باقة خنق السرعة — ويعود إلى الباقة الأصلية عند إعادة الضبط اليومي التالي.
إدارة المشتركين
انقر بزر الماوس الأيمن على صف — أو استخدم قائمة ⋮ — للقيام بأي إجراء خاص بالمشترك:
إجراء
الوظيفة
عرض / تعديل
افتح صفحة التفاصيل، أو تعديل بيانات الاتصال وكلمة المرور وتاريخ الانتهاء
تفعيل / تعطيل
تعليق الحساب — فصل المشتركين المتصلين بالإنترنت
تجديد الباقة
إضافة مدة الباقة إلى أي وقت متبق؛ يتم إنشاء فاتورة إذا كان للباقة سعر. يتيح خيار Plan للمستخدم الذي انتهت صلاحيته العودة بباقة مختلفة في نفس الخطوة — اتركه على "Keep the current plan" للتجديد كما كان سابقاً
إعادة ضبط وقت التشغيل / الحصة / اليومية
تصفير عداد الحد المختار
الاستخدام
فتح رسوم الاستخدام البيانية وسجل الجلسات
حذف
إزالة المشترك وجميع سجلاته — يتم فصل الجلسات النشطة أولاً
كيفية تنفيذ الإجراءات
توضع عمليات إعادة الضبط وتغييرات الباقة والتجديدات في قائمة انتظار سجل التدقيق، ويتم تطبيقها عبر samm-radius tick — عادةً في غضون ثوانٍ قليلة. وإذا كان المشترك متصلاً، يقوم SAMM أيضاً بإرسال تحديث مباشر. راجع CoA & live changes.
يمكن لصفحة التفاصيل أيضا إظهار كلمة مرور تسجيل دخول المشترك عبر أيقونة العين (مع إمكانية النسخ بنقرة واحدة) — وهو أمر مفيد عندما يطلب العميل بيانات الاعتماد الخاصة به.
عرض الاستخدام
يفتح إجراء Usage صفحة تفصيلية لحركة مرور مشترك واحد، مع محدد فترة 7d / 14d / 30d / 90d. وتعرض الصفحة ثلاثة أرقام رئيسية — حركة مرور اليوم (مع تقسيم الرفع/التنزيل ودقائق الاتصال)، وحركة مرور هذا الشهر، وإجمالي وقت الاتصال للشهر. ويوجد أسفلها مخطط حركة المرور اليومية للرفع مقابل التنزيل، وجدول سجل الجلسات الكامل: وقت البدء والانتهاء، والمدة، وحجم بيانات التنزيل والرفع، و NAS، وسبب إنهاء كل جلسة.
عمليات جماعية
لتغيير المالك، أو تاريخ الانتهاء، أو الحالة، أو التجديد التلقائي للعديد من المشتركين دفعة واحدة — أو لحذف العديد منهم — استخدم أدوات التغييرات الجماعية والحذف الجماعي. لإنشاء مشتركين بكميات كبيرة من جدول بيانات، استخدم Export / Import.
تقييد المشترك براوترات محددة
عندما يكون إعداد تسجيل دخول الفرع مفعلًا، يمكن للمستخدم تسجيل الدخول عبر راوترات الفرع التابع له، والفروع التي تعلوه، والمقر الرئيسي (راجع Admins, branches & roles). يمكنك من خلال نموذج التحرير تضييق نطاق وصول المستخدم (أو مجموعة بطاقات كاملة) بشكل أكبر ليشمل راوترات محددة: في حال عدم تحديد أي راوتر، يتم تطبيق راوترات الفرع؛ أما عند تحديد راوتر واحد أو أكثر، فيتم قبول تسجيل الدخول فقط من تلك الراوترات، ويتم فرض ذلك داخل RADIUS. يؤدي تغيير هذه المجموعة إلى قطع أي جلسة نشطة على أي راوتر لم يعد مسموحًا به.
تغيير اسم المستخدم، التجديد مع معاينة
إعادة تسمية مستخدم من صفحته (زر Username بجانب Edit) أو من قائمة Users، بعد كتابة اسم المستخدم الحالي للتأكيد. تنتقل الجلسات والاستخدام والسجلات إلى الاسم الجديد، ويتم فصل الجلسة النشطة لكي ينسى الراوتر تسجيل الدخول القديم، ويتم إخطار المستخدم باسم المستخدم الجديد ما لم يتم إلغاء تحديد ذلك المربع. عند تجديد أو تغيير باقة، اختر ما إذا كانت الفترة الجديدة تستمر من تاريخ الانتهاء أو تبدأ من اليوم، وراجع — وعدل — تاريخ الانتهاء الجديد قبل الحفظ. يمكن أن يتضمن التجديد أيضاً دفعة مقدمة.
وصلة لاسلكية
بالنسبة للمشترك على نقطة وصول MikroTik، يمكن لصفحة المستخدم قراءة بيانات الراديو مباشرة: الإشارة (مع وصف نصي لجودتها)، والسرعة في كل اتجاه، وCCQ، ومدة التشغيل. يمكن قراءة أجهزة راديو MikroTik فقط.
ملفات المستخدم & الحقول المخصصة
رفع بطاقات الهوية وجوازات السفر والعقود والصور لمستخدم من صفحة التفاصيل الخاصة به؛
معاينة الملفات دون تحميلها، ويمكن عرضها للمشترك في بوابته الخاصة تحت Files. الحقول المخصصة — التي يتم تعريفها مرة واحدة في الإعدادات — تضيف إدخالات بيانات إضافية للمستخدمين والملفات والباقات ومجموعات البطاقات والتذاكر والإضافات.
المشتركون و& الباقات
بطاقات Hotspot
للوصول إلى Hotspot مسبق الدفع، يتم إنشاء مجموعة من بطاقات القسائم بدلاً من المشتركين الفرديين. كل بطاقة عبارة عن زوج من اسم المستخدم وكلمة المرور مع سرعة وحدود خاصة بها، يتم إنشاؤها بالآلاف وطباعتها للتوزيع.
إنشاء مجموعة بطاقات
انتقل إلى Users → Hotspot Cards وانقر على مجموعة جديدة.
املأ النموذج أدناه وانقر على إنشاء مجموعة — يقوم SAMM بإنشاء بيانات اعتماد كل بطاقة تلقائياً.
قسم
الحقول
الهوية
اسم مجموعة فريد، وصف، بادئة اسم مستخدم اختيارية، عدد البطاقات المراد إنشاؤها (حتى 10,000)
بيانات الاعتماد
تنسيق اسم المستخدم وكلمة المرور (أرقام / حروف / أبجدية رقمية) وطولهما
تحديد السرعة
سرعة التنزيل والرفع — 256k, 6M, 1G; 0 = غير محدود
تحديد حجم النقل
غير محدود، أو سقف مدمج، أو سقوف منفصلة للتنزيل/الرفع (MB / GB / TB)
تحديد الأوقات
حد وقت التشغيل، وانتهاء الصلاحية بعد أول تسجيل دخول، وتاريخ "صالح حتى" للمجموعة
يتم احتساب مدة الصلاحية بدءاً من أول تسجيل دخول لكل بطاقة، بينما يمثل صالح حتى تاريخ انتهاء نهائي — حيث لا يمكن استخدام البطاقات بعد هذا التاريخ، سواء تم تفعيلها أم لا.
إدارة مجموعة
افتح قائمة ⋮ الخاصة بالمجموعة لـ تفعيل أو تعطيل جميع البطاقات دفعة واحدة، أو تمديد تاريخ صلاحية المجموعة، أو إضافة المزيد من البطاقات إلى الدفعة، أو تعديل تفاصيلها. يمكن إعادة ضبط البطاقات الفردية (الحصة، أو وقت التشغيل، أو تاريخ الانتهاء) أو تعطيلها من صفحة تفاصيل البطاقة.
تقوم عملية Duplicate group بنسخ كل إعداد بدقة وإنشاء نفس العدد من البطاقات بـ fresh codes — حيث لا يمكن لرمز البطاقة أن ينتمي إلا لبطاقة واحدة فقط، لذا فإن النسخة هي عملية طباعة جديدة وليست استنساخاً للقديمة. وهي الطريقة السريعة لإعادة طلب دفعة من القسائم التي نفدت.
أضف بطاقة واحدة أو استورد قائمة
يضيف + 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 أو البريد الإلكتروني. يدخل الزائر الرمز في الصفحة نفسها ليصبح متصلاً بالإنترنت — بينما تحتفظ أنت بسجل مسمى وقابل للتصدير لكل من استخدم شبكة الضيوف.
إعداد قناة إرسال أولاً.Notification Center ← تفعيل SMS أو WhatsApp و
إرسال رسالة اختبار لنفسك. لن يعمل أي شيء آخر حتى يتم تفعيل قناة واحدة.
Self Service → Settings: تفعيل
Allow guests to register themselves، واختيار القنوات التي سيتم توفيرها، وتحديد مدة صلاحية رمز المرور ومدة انتظار الضيف قبل طلب رمز آخر.
اترك Passcodes come from كما هي في مجموعة بطاقة Self Service ما لم يكن لديك سبب لتغييرها — فهذه المجموعة هي التي تحدد السرعة وعدد الأجهزة التي يمكنها مشاركة رمز مرور واحد.
تفعيل تبويب Register لكل تصميم تسجيل دخول تستخدمه
— انظر أدناه. هذه هي الخطوة التي يتجاهلها المستخدمون.
صفحة تسجيل الدخول — الخطوة التي يتجاهلها المستخدمون
تبويب Register يعتمد على تصميم صفحة تسجيل الدخول، وهو معطل افتراضيا. افتح MikroTik Manager ← الراوتر ← Login Page، وحرر التصميم المستخدم وفعّل Allow Self Service. يمكنك إعادة صياغة كل جملة يراها الضيف في الشاشة نفسها — تسمية تبويب Register، والسطر التعريفي، وتسميات الحقلين، والزر، والردود الخمسة ("رمز المرور في طريقه إليك"، "لديك حساب بالفعل"، "يرجى المحاولة مرة أخرى لاحقا"، "تعذر إرساله"، "التسجيل غير متاح").
ثم اضغط Push — واضغط عليه مجددا بعد كل تحديث لـ SAMM.
توجد صفحات تسجيل الدخول الخاصة بـ Hotspot على ذاكرة الفلاش الخاصة بالراوتر، وليس على SAMM. تحديث SAMM لا يعيد إرسالها، لذا يستمر الراوتر في تقديم صفحته القديمة — التي لا تحتوي على تبويب Register — حتى تقوم بإرسالها مرة أخرى. ينبهك SAMM في تبويب Login Page عندما يقدم الراوتر صفحات أقدم من الإصدار المثبت لديك، وتدرج صفحة Self Service أسماء جميع الراوترات التي لا يمكنها عرض التبويب وتتيح إصلاحها جميعاً دفعة واحدة.
القواعد التي تمنع إساءة الاستخدام
رمز مرور مباشر واحد لكل رقم. طلب رمز آخر بينما لا يزال الرمز الحالي صالحا يوجه الضيف للتحقق من رسائله بدلا من إرسال رمز جديد.
ثم فترة انتظار تحددها، قبل أن يتمكن هذا الرقم من طلب رقم جديد.
تبدأ مدة الصلاحية من لحظة إرسال رمز المرور،
وليس من أول تسجيل دخول — لذا فإن الرمز الذي ظل غير مستخدم لمدة أسبوع لن يظل صالحا للعمل.
حد يومي يحدده الترخيص الخاص بك (انظر أدناه). بمجرد استنفاده، سيُطلب من الضيوف المحاولة مرة أخرى لاحقاً، بينما تظل رموز المرور الصادرة مسبقاً تعمل.
يتم تسجيل كل محاولة بناء على عنوان MAC الخاص بالجهاز كما أبلغ عنه الراوتر — وهو أمر لا يمكن للضيف تزييفه من خلال متصفحه.
الترخيص
يتم ترخيص خدمة Self Service
بشكل منفصل عن باقتك، بناء على عدد رموز المرور التي يمكن أن يصدرها التثبيت يومياً، وتتجدد في تاريخها الخاص — لذا يمكنك الاشتراك في باقة Free مع إضافة مدفوعة،
أو في باقة Unlimited بدون إضافات. يحصل كل تثبيت على 10 رموز يومياً مجاناً؛
وترفع باقة Light هذا العدد إلى 50، وباقة Heavy إلى 200، بينما تلغي باقة Max هذا الحد. راجع
الأسعار.
تعرض صفحة الخدمة الذاتية المستخدم / المسموح به لهذا اليوم، وتوضح صراحة عند نفاد الحصة. قم بالشراء أو التجديد من لوحة المعلومات الخاصة بك على securytik.com، أو اطلب من System → License وسيقوم المسؤول في SecuryTik بالموافقة عليه. رمز المرور الذي تعذر تسليمه لا يستهلك من حصتك.
المشتركون و& الباقات
إضافات & قسائم
الإضافة هي ميزة إضافية يشتريها المستخدم فوق باقته لعدد من الأيام: زيادة السرعة، أو أيام غير محدودة، أو زيادة ليلية لساعات مختارة. يتم إنشاؤها عبر Users → Add-ons.
بيع إضافة من صفحة المستخدم، والسماح للمستخدمين بشرائها عبر بوابة المستخدم أو بوت Telegram (الدفع من المحفظة)، أو طباعة أكواد قسائم لمرة واحدة يستبدلها المستخدمون في البوابة أو البوت.
التطبيقات المجانية: تفعيل Unmetered واختيار التطبيقات حسب الفئة؛ عندها فقط يتوقف احتساب حركة مرور هذه التطبيقات ضمن حصة المستخدم. ترك جميع التطبيقات معطلة يجعل كافة حركة المرور غير محدودة. يتطلب هذا تفعيل Data Log.
الرقابة الأبوية والـ VPN: يمكن للإضافة أن تفعّل الرقابة الأبوية أو VPN عبر SAMM طوال مدتها؛ ويتوقف كلاهما تلقائياً عند انتهائها. حدّد المدة بقيمة ووحدة (أيام، أسابيع أو أشهر تقويمية).
يرى المستخدمون الإضافات النشطة وتواريخ انتهائها في صفحة الباقات الخاصة بهم. يتم تحصيل رسوم الإضافة الممنوحة لمستخدم تابع لوكيل من الوكيل كما هو الحال في التجديد.
يمكن لكل فرع تحديد أسعار إضافية خاصة به في Accounting → Price Lists.
خصومات الفواتير
منح خصم بنسبة مئوية أو مبلغ ثابت على فاتورة مفتوحة، مع ذكر السبب، من الفاتورة أو فواتير المستخدم. يمكن أن يتكرر الخصم الدائم في تجديدات المستخدم القادمة. لكل دور حد أقصى للخصم الذي يمكن منحه.
المشتركون و& الباقات
النقاط & المكافآت
كافئ المستخدمين المخلصين واسمح لهم بدعوة أصدقائهم. النقاط معطلة حتى يتم تفعيلها
من خلال Users → Points & rewards.
تفعيل النقاط وتحديد عدد النقاط التي يمنحها التجديد المدفوع في كل باقة، وعدد النقاط التي يحصل عليها المستخدم الداعي عندما يقوم صديق تمت دعوته بدفع فاتورته الأولى.
إنشاء مكافآت: سرعة أعلى (مضاعفة سرعة الباقة لعدة أيام) أو أيام مجانية، مع تحديد سعر لكل منها بالنقاط.
يرى المستخدمون رصيدهم ورابط الدعوة والمكافآت في بوابة المستخدم، ويقومون بإنفاق النقاط هناك. وعندما يفتح صديق رابط الدعوة يترك بياناته؛ ثم تقوم بإنشاء المستخدم ويتم تسجيل الإحالة.
يتم احتساب النقاط من الفواتير المدفوعة، مرة واحدة لكل فاتورة. وفي حال إلغاء الفاتورة، يتم استرداد نقاطها. يمكنك أيضا إضافة أو خصم النقاط يدويا، والاطلاع على أعلى الأرصدة وطلبات الانضمام في الصفحة نفسها.
المشتركون و& الباقات
الرقابة الأبوية
تحمي العائلات خطوطها الخاصة عبر بوابة المستخدم. تكون هذه الميزة معطلة لكل مستخدم حتى يتم السماح بها: تفعيل 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) وكلمة مرور قوية للمدير.
اطلبه
سجّل الدخول إلى samm.securytik.com وافتح Dashboard → Get a server.
اختر اسمًا للخادم وعدد المشتركين، ثم ابحث عن نطاق .com الخاص بك أو اختر أحد الاقتراحات.
ادفع بأي طريقة معروضة عند الدفع. ينتظر الطلب ساعتين للدفع؛ بعد ذلك يُلغى وعليك تقديم طلب جديد.
بعد الدفع كل شيء تلقائي. عندما يصبح الخادم جاهزًا تستلم البريد الذي يحمل عنوانك وبيانات الدخول.
وصول SSH
من Dashboard → Servers يمكنك إنشاء دخول SSH الخاص بك بكلمة مرور، أو بمفاتيح عامة، أو بالاثنين. دليل SSH خطوة بخطوة لـ Termius وWindows وUbuntu وmacOS موجود في الصفحة نفسها.
التجديد
جدّد قبل نهاية السنة بيوم واحد على الأقل؛ يفتح التجديد قبل سبعة أيام. إذا لم يُجدَّد الخادم، ينتهي الخادم والنطاق والبيانات الموجودة عليه. احتفظ بنسخك الاحتياطية الخاصة أيضًا.
المشتركون و& الباقات
CGNAT & مجموعات عناوين IP
كلاهما تحت Plans، بجانب مجموعات العناوين الخاصة بالراوتر.
CGNAT Pools
مجموعة CGNAT تسمح لعدة مشتركين بمشاركة عنوان عام واحد. يحصل كل مشترك على كتلة ثابتة من المنافذ على ذلك العنوان، فيمكن تتبع كل اتصال إلى مشترك واحد.
افتح Plans → CGNAT Pools وأضف مجموعة: العناوين العامة، وعدد المشتركين الذين يشاركون عنوانًا واحدًا، وعدد المنافذ لكل مشترك.
يعرض خط السعة عدد المشتركين الذين تتسع لهم قبل الحفظ.
أرسلها إلى الراوتر. يكتب SAMM قواعد NAT ويحتفظ بسجل المشترك الذي كان له كل عنوان ومنافذ، وهو ما يقرؤه Lookup.
مجموعات عناوين IP
مع مجموعة عناوين IP، يمنح SAMM كل مشترك عنوانه بنفسه، لكل راوتر وخطة، فلا يحتاج الراوتر إلى مجموعة عناوين خاصة به. يُحرَّر العنوان عند انتهاء الجلسة. عندما تمتلئ المجموعة، تتولى مجموعة الراوتر نفسها الأمر.
العمليات اليومية
الاحتفاظ بالبيانات & Lookup
تطلب دول كثيرة من مزود الخدمة حفظ سجلات الاتصال، وأن يحدد أي مشترك استخدم عنوانًا في وقت معين. الاحتفاظ بالبيانات يحقق الأمرين. وهو متوقف حتى تفعّله.
فعّله
افتح System → Settings → Data retention وفعّله.
حدد مدة حفظ الجلسات (سنتان افتراضيًا). تُحفظ الجلسات طوال هذه المدة حتى للمشتركين الذين تحذفهم.
اختياريًا، أرسل ملفًا يوميًا مشفّرًا إلى NAS الخاص بك عبر SFTP أو SMB أو NFS. افتحه بـ gpg --decrypt.
Lookup: من استخدم هذا العنوان؟
افتح Overview → Data Log → Data retention.
أدخل العنوان العام والمنفذ والوقت من الطلب الذي استلمته.
أدخل رقم قضية (يقترح 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 أيضًا الاتصال بـ SAMM عبر L2TP.
صفحة الجهاز: CPU والذاكرة والحرارة ومدة التشغيل والرسوم البيانية، مثل MikroTik.
الشبكة & الراوترات
FTTH & OLTs
يقرأ SAMM أجهزة OLT من V-SOL وHuawei (SmartAX) وZTE (C300 وC320) وNokia (ISAM) عبر SSH.
صفحة FTTH تحت Devices → FTTH: قائمة بأجهزة OLT مع فلاتر وأعمدة وتصدير، مثل صفحة Wireless.
كل ONU مع إشارتها الضوئية، والـ ONUs التي تنتظر الإضافة.
ربط ONUs بمشتركيها تلقائيًا.
قفل خط المشترك: يتعلم SAMM الخط الذي يتصل منه كل مشترك، ويمكنه إبقاء دخوله على ذلك الخط.
صفحة جهاز OLT: CPU والذاكرة والحرارة ومدة التشغيل والرسوم البيانية.
الشبكة & الراوترات
راوترات (NAS)
يعتبر NAS (Network Access Server) راوتر يقوم بمصادقة المشتركين عبر SAMM باستخدام RADIUS. يحتاج كل راوتر ينقل حركة مرور المشتركين إلى سجل NAS.
إضافة راوتر
انتقل إلى MikroTik → NAS وانقر على إضافة راوتر.
تعبئة الحقول أدناه والحفظ.
حقل
المعنى
عنوان IP / اسم المضيف لـ NAS
عنوان الراوتر، كما يظهر لمضيف SAMM
الاسم المختصر
تسمية واضحة تظهر في كل أنحاء الواجهة
النوع
تتيح mikrotik مزامنة الأجهزة المباشرة ودفع الإعدادات؛ أما الأنواع الأخرى فهي مخصصة لـ 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 أو الاسم المختصر أو الوصف.
تحتوي قائمة ⋮ في كل صف على الإجراءات الخاصة بكل راوتر — عرض الجهاز و
تحديث المعلومات (MikroTik فقط)، وتعديل، ودفع إعدادات
RADIUS (MikroTik فقط)، وحذف. يؤدي فتح صف من نوع
mikrotik إلى الانتقال مباشرة إلى
صفحة الجهاز.
اكتشاف الجيران
انقر على Discover neighbors لفحص الشبكة بحثا عن أجهزة MikroTik
(عبر بروتوكول neighbor-discovery الخاص بـ MikroTik) وإضافتها كسجلات NAS دون كتابة كل
عنوان يدويا. يمكن إضافة الراوتر المكتشف عبر IP، أو عبر Auto-added — وهي عملية bootstrap بنقرة واحدة تقوم بإنشاء مستخدم إدارة SAMM على الراوتر، وتعيين IP للإدارة ومسح bridge المصنع.
خاصية الإضافة التلقائية مخصصة للراوترات الجديدة
إن عملية التشغيل الذاتي بنقرة واحدة مخصصة للأجهزة الجديدة (أو التي تمت إعادة ضبطها) — ففي حال استخدامها على راوتر يحتوي بالفعل على إعدادات، قد تؤدي إلى استبدال أو تعطيل الإعدادات الحالية.
إرسال إعدادات RADIUS إلى الراوتر
بالنسبة لسجلات MikroTik NAS، توفر قائمة ⋮ في الصف خيار Push RADIUS config
— يقوم SAMM بتكوين الراوتر نيابة عنك عبر API بدلاً من القيام بذلك يدوياً. تقوم بتأكيد IP خادم SAMM (يجب أن يكون متاحاً من الراوتر) ومنافذ auth و accounting و CoA؛ ثم يقوم SAMM بإنشاء أو استبدال إدخال RADIUS على الراوتر:
إعداد
القيمة
تعليق
SAMM — الوسم الذي يستخدمه SAMM للعثور على هذا الإدخال وتحديثه لاحقاً
خدمة
hotspot, ppp
العنوان / كلمة السر
مضيف SAMM، باستخدام السر المشترك من سجل NAS هذا
مهلة الانتظار
3000 ms
استقبال CoA
تم القبول، على منفذ CoA الذي أكدته
يعرض مربع الحوار سجل النتائج عند انتهاء عملية push.
إعداد جانب MikroTik
إذا قمت بتكوين الراوتر يدوياً بدلاً من ذلك:
إضافة خادم RADIUS يشير إلى مضيف SAMM، مع نفس السر المشترك، وتفعيل PPP / Hotspot.
استخدام منفذ auth 1812، ومنفذ accounting 1813.
قبول CoA الوارد على منفذ 3799.
اضبط فاصل Interim-Update للمحاسبة على 5 دقائق تقريباً
(الافتراضي في معالج SAMM) — هذا هو المعدل الذي يقوم SAMM من خلاله بتجميع الاستهلاك وتقييم الحدود؛
الفواصل الأقصر تقلل من زمن استجابة الحدود على حساب زيادة حركة مرور المحاسبة.
أجهزة للمراقبة فقط
يظهر الراوتر المضاف كـ monitor في قائمة MikroTik ويتم عمل ping ومزامنة له، ولكن ليس له دور RADIUS — لذا لا يمكنه مصادقة المشتركين. استخدمه لمراقبة الراوترات التي لا تعمل كـ NAS للمشتركين.
احتياطي SAMM
إذا توقف SAMM عن الاستجابة، تستمر الراوترات التي تختارها في تسجيل دخول المشتركين ذاتيا — من خلال نسخة معطلة من كل مستخدم نشط يبقي SAMM متزامنة عليها. وعند عودة SAMM، يعيد الجميع الاتصال من خلاله. هذه الخاصية معطلة افتراضيا؛ يمكن تفعيلها لكل راوتر من Settings → Advanced.
يتم تفعيل الاحتياطي بعد فترة التأخير التي تحددها، أو يدويا، ويقوم الراوتر بالإبلاغ عن ذلك عبر Telegram. يعرض جدول الحالة حالة المزامنة لكل راوتر، وعدد المستخدمين الذين فشلت مزامنتهم والسبب، ويحدد الراوتر الذي أصبحت نسخته الاحتياطية قديمة أو الذي لا يمكنه الوصول إلى عنوان الصحة الخاص بـ SAMM.
الشبكة & الراوترات
MikroTik مدير الأجهزة
عندما يمتلك الراوتر بيانات اعتماد API، يقوم SAMM بإدارته مباشرة عبر MikroTik API — دون الحاجة إلى WinBox أو SSH. قسم MikroTik هو جرد حي لكل راوتر، ويفتح كل جهاز صفحة تفاصيل تحتوي على خمسة عشر تبويب لتهيئة كل جزء تقريباً من RouterOS من خلال متصفحك.
مراقب MikroTik
تعرض MikroTik → Monitor بطاقة واحدة لكل راوتر، مرتبة على شكل شبكة. تعرض كل بطاقة — التي يتم تحديثها بواسطة samm-worker واستطلاعها مباشرة كل 30 ثانية — نقطة إمكانية الوصول، وإصدار RouterOS، وحمل CPU وعدد الأنوية، واستهلاك الذاكرة، وعدد الجلسات النشطة، ومدة التشغيل، ووقت آخر عينة.
يتم تمييز البطاقة إما بـ NAS (راوتر يقوم أيضاً بمصادقة المشتركين عبر RADIUS) أو monitor (جهاز مضاف للمراقبة فقط). يقوم Add MikroTik بتسجيل جهاز جديد، بينما يقوم Refresh now بفرض عملية استعلام فورية. توفر بطاقات المراقبة فقط قائمة عند النقر بزر الماوس الأيمن — Open، Edit، Refresh Info، Delete.
أجهزة Ubiquiti
عند إضافة جهاز مراقبة تختار نوعه: MikroTik أو Ubiquiti airOS أو نقطة وصول Ubiquiti UniFi. يتم الوصول إلى أجهزة Ubiquiti عبر SSH باستخدام بيانات دخول الجهاز نفسه، وصفحة Probe تعرض ما يبلّغ عنه الجهاز. تظهر نقطة وصول UniFi في صفحات Wireless بصف لكل راديو: القناة وعرض القناة وأسماء SSID، والعملاء المتصلون مع الإشارة والضجيج والسرعة، والشبكات المجاورة التي يلتقطها، وتشارك في مُحسّن الـ Wi-Fi ومخطط القنوات.
كل باقة تسمح بـثلاثة أجهزة مراقبة لكل راوتر (الباقة ذات الراوترات غير المحدودة فيها أجهزة مراقبة غير محدودة)، فمراقبة نقاط الوصول لا تستهلك أبداً حصة الراوترات.
المستخدمون المحفوظون على الراوتر
يعثر SAMM على حسابات PPP ومستخدمي Hotspot ومستخدمي User Manager المحفوظين على الراوتر نفسه (RouterOS 6 و 7) ويعرضهم في صفحة الراوتر. قبل نقل أي شيء، يعرض كل صف ما سينشئه SAMM: اسم المستخدم وكلمة المرور والاسم والجوال والباقة (مع إشارة "جديدة" عندما ينشئها SAMM) وتاريخ الانتهاء والحدود وعنوان MAC وعنوان IP. كما تُقرأ الأسماء وأرقام الهواتف وتواريخ الانتهاء المكتوبة في تعليقات الراوتر، بالعربية أو بالإنجليزية. حدد المستخدمين واستوردهم: تعمل العملية في الخلفية وتمتلئ قائمة المستخدمين مع وصولهم.
صفحة الجهاز — خمسة عشر تبويبا
افتح أي جهاز للوصول إلى صفحة الإدارة الكاملة الخاصة به. تندرج التبويبات ضمن أربع مجموعات.
المراقبة
تبويب
ما يتم عرضه
نظرة عامة
معلومات الجهاز، ومعلومات النظام، ومخططات سجل الأداء (CPU، والذاكرة، والجلسات بمرور الوقت)
المنافذ
كل منفذ مع حالته المباشرة، بالإضافة إلى سجل حركة المرور لكل منفذ
المواقع & التطبيقات
ثلاثة عرض فرعية: Monitor (المواقع و & التطبيقات التي تم رصدها على الراوتر مع سجل حركة المرور)، QoS (أولوية تعتمد على نوع التطبيق، أدناه)، و App Filter (حظر المحتوى بناء على DNS من الكتالوج)
مدير الأجهزة
تبويب Manager → General هو صفحة الإدارة العامة للجهاز:
Identity (اسم الراوتر)، وTime (الساعة، والمنطقة الزمنية، وNTP)، وTools (إعادة التشغيل، وping، وإجراءات الراوتر الأخرى التي تتم بنقرة واحدة).
إعدادات الشبكة
تبويب
الإعدادات التي تقوم بتكوينها
جسر
إنشاء جسور LAN واختيار المنافذ الفيزيائية (ports) التي تنتمي لكل جسر
VLAN
إضافة وإدارة منافذ VLAN
IP
ثلاثة تبويبات فرعية — Static (العناوين الثابتة والديناميكية)، DHCP client (سحب عنوان من المزود)، DHCP server (توزيع العناوين، مع جدول تخصيص مباشر)
DNS
خوادم DNS والذاكرة المخبئية (يوجد تصفية محتوى التطبيقات/المواقع ضمن Websites & Apps)
WiFi / CAPsMAN
منافذ Wi-Fi مع إعداداتها وملفات تعريف الأمان الخاصة بها؛ ومتحكم CAPsMAN — الإعدادات، وقواعد التزويد، وأجهزة CAPs البعيدة
خوادم Hotspot، وملفات تعريف Hotspot وملفات تعريف المستخدم، ونطاقات DHCP/IP، وصفحة تسجيل الدخول لـ captive-portal
الإنترنت
وصلات WAN الصاعدة — مسارات WAN ومسارات افتراضية مُدارة بواسطة SAMM، مع عرض أي وصلات WAN موجودة غير مُدارة بواسطة SAMM للقراءة فقط
جدار الحماية
قواعد التصفية، وتحليل أمان الراوتر، وأهداف الاتصال &، ووحدات الأمان، ونسخ جدار الحماية الاحتياطية — تقوم ميزة Auto-Security بأخذ لقطة لجدار الحماية قبل التطبيق ويمكنها تفعيل تراجع تلقائي مؤقت، بحيث يتم التراجع تلقائياً عن أي مجموعة قواعد تتسبب في حظرك من الدخول
تحديث
تحديثات RouterOS — اختر قناة التحديث، ثم التحقق والتطبيق، ومراجعة الحزم المثبتة
معالج
دليل الإعداد لأول مرة، أدناه
فاصل التحديث المرحلي لـ PPPoE
في تبويب PPPoE، يحدد Interim update معدل إرسال الراوتر لحزم RADIUS accounting Interim-Update إلى SAMM. يستخدم SAMM هذه الحزم لتجميع عدادات البايتات ووقت التشغيل وتقييم الحصة والحدود اليومية وحدود وقت التشغيل — وبدونها، يتوقف فرض القيود وعدادات الجلسات المباشرة. القيمة الموصى بها هي 5m.
صفحة تسجيل الدخول إلى Hotspot
من تبويب Hotspot يمكنك إدارة صفحة تسجيل الدخول لـ captive-portal:
إما الإبقاء على صفحات MikroTik الافتراضية، أو تطبيق أحد القوالب المدمجة،
أو تطبيق أحد تصاميمك المحفوظة. يتضمن SAMM محرراً مرئياً للتصميم
ومعرضاً للقوالب — خصص صفحة تسجيل الدخول وارفعها مباشرة إلى
hotspot الخاص بالراوتر.
جودة الخدمة (QoS) المعتمدة على التطبيقات
تحول واجهة QoS (تبويب فرعي من Websites & Apps) التطبيقات والمواقع التي يكتشفها SAMM بالفعل على الراوتر إلى باقة أولويات التنزيل. اسحب كل تطبيق من المجموعة إلى إحدى خانات الأولويات الثمانية — حيث يتم خدمة الخانة 1 أولا عند حدوث ازدحام، والخانة 8 أخيرا؛ أما التطبيقات المتبقية في المجموعة فلا يتم تشكيل سرعتها. يمكنك اختياريا تحديد سقف لسرعة التنزيل لأي تطبيق (على سبيل المثال 10M) ووضع سقف إجمالي للتنزيل تتنافس عليه الأولويات. يقوم خيار Auto-distribute by category بترتيب كل شيء بنقرة واحدة — تطبيقات المراسلة أولا، ثم خدمات AI، ثم المتاجر، مع وضع كل شيء آخر أدناه.
عند الضغط على push، يقوم SAMM بتجميع الفتحات في queue tree لـ MikroTik
(موسومة بـ SAMM:qos، parent=global) مع قواعد جدار الحماية المطابقة لـ packet-mark، مع ترتيب الأولويات من الأعلى إلى الأدنى. يتم بناؤه بناءً على نفس كتالوج Websites & App filter
الذي يشغل عملية المراقبة، لذا تظهر فقط التطبيقات التي تم رصدها فعلياً على الراوتر — وإزالة SAMM QoS تحذف كل كائن SAMM:qos من الراوتر، مع ترك العدادات دون تغيير.
معالج الإعداد
يجمع تبويب Wizard كل شيء في عشر خطوات قصيرة، ثم يرسل الإعدادات الكاملة إلى الراوتر دفعة واحدة في النهاية. لا يتم إرسال أي شيء حتى يتم التأكيد في خطوة المراجعة النهائية.
مرحباً & detect — SAMM يقوم بفحص الراوتر وعرض ما تم تكوينه بالفعل، بحيث يمكنك تخطي هذه العناصر أثناء عملية الـ push.
منفذ Bridge — تسمية جسر LAN.
Bridge ports — اختيار المنافذ الفيزيائية التي تنضم إلى الـ bridge.
DNS — تعيين خوادم DNS العلوية (إعدادات مسبقة بنقرة واحدة لـ Google و Cloudflare و Quad9 وغيرها)، وحجم ذاكرة التخزين المؤقت، وفلتر محتوى DNS اختيارياً.
NTP — تعيين مصدر ساعة الراوتر (كعميل NTP، مع إمكانية تقديم الوقت لشبكة LAN).
Internet — إضافة وصلة WAN صاعدة واحدة أو أكثر (Static / DHCP / PPPoE).
RADIUS to SAMM — توجيه الراوتر إلى مضيف SAMM الخاص بك لعمليات المصادقة والمحاسبة و CoA.
Services — اختر ما إذا كان المعالج سينشئ خادم PPPoE، أو خادم Hotspot، أو خدمة IPoE / DHCP، مع إمكانية تفعيل IPv6 dual-stack (اختياري، معطل افتراضياً): اختر طول البادئة المفوضة (DHCPv6-PD) وكتل IPv6، وسيقوم المعالج بإنشاء الـ pools وربطها بـ PPP profile.
تفاصيل PPPoE / Hotspot & جدار الحماية — مجموعات العناوين، والملفات الشخصية، وأوقات التخصيص، وقواعد جدار الحماية & NAT، وخيار Expired pool & حظر الإنترنت الذي يقوم بتوجيه المشتركين المنتهية اشتراكاتهم إلى صفحة "انتهى الاشتراك" الخاصة بـ SAMM بدلاً من انقطاع الاتصال.
مراجعة & push — اطلع على القائمة الدقيقة للأوامر التي سيتم
إرسالها، ثم دفعها جميعاً إلى الراوتر.
يتم تحديد سرعة كل مستخدم عبر RADIUS
يقوم المعالج بإنشاء ملف تعريف PPPoE / hotspot واحد — ولا يقوم بتعيين ملفات تعريف لكل فئة. يتم تحديد سرعة كل مشترك بواسطة SAMM في رد RADIUS عند تسجيل الدخول، لذا لا تتطلب تغييرات الباقة تعديل الراوتر أبداً.
الشبكة & الراوترات
التحقيق العميق
عندما تبدو الشبكة بطيئة، يفعل التحقيق العميق ما يفعله المهندس: يراقب راوتراً واحداً لفترة، ويقرأ كل ما يستطيع، ويخبرك بما الخطأ وما يجب فعله أولاً. يقرأ فقط: لا يغيّر شيئاً على الراوتر أبداً، وأي إصلاح يبقى قرارك.
ابدأ فحصاً
افتح Devices → Network Health واضغط التحقيق العميق، أو انقر بزر الفأرة الأيمن على راوتر في الصفحة.
فعّل الراوترات المراد فحصها. جميع المفاتيح تبدأ متوقفة. تظهر فقط أجهزة MikroTik BNG التي لها تسجيل دخول محفوظ.
اختر المدة: 15 دقيقة أو 30 دقيقة أو ساعة أو ساعتين. التشغيل الأطول أكثر دقة؛ شغّله في ساعة الذروة.
اضغط بدء التحقيق. يعمل في الخلفية، فيمكنك إغلاق الصفحة. يعمل فحص واحد لكل راوتر، وبحدّ أقصى فحصان في الوقت نفسه.
التقارير، بجانب الزر، تعرض كل فحص مع تقدّمه ونتيجته ودرجته. يمكنك إيقاف فحص مبكراً والاحتفاظ بما قاسه حتى الآن.
ماذا يفحص
خطوط الإنترنت: الفقد والتأخير نحو الإنترنت وعلى كل خط، والقفزات المفاجئة، ومدى وصول الحزم الكبيرة.
تجربة المستخدم: رسائل اختبار إلى عيّنة متغيّرة من المستخدمين المتصلين، ومدة وصول الردود.
Queue المستخدمين والسرعة: هل يفقد المستخدمون البيانات عندما تمتلئ باقتهم، والرفع والتنزيل، والقواعد التي قد تتجاوز حدود السرعة.
شبكة الوصول والمنافذ: كل جهة وصول، والأبراج والأجهزة خلف الراوتر، وأخطاء المنافذ والانقطاعات والسرعة وإشارة الألياف.
موازنة الحمل: كيف تتقاسم الخطوط الترافيك، وهل قواعد الموازنة مكتملة وتنتبه لخط متوقف.
صحة الراوتر: حمل المعالج وكل نواة، والذاكرة، والحرارة، وإعادات التشغيل، والبرنامج الثابت، وسجلّ الراوتر.
تسجيلات الدخول وRADIUS: الردود في وقتها، وتسجيلات الدخول المرفوضة، والجلسات التي تنتهي مبكراً، وإعدادات حجم الحزم.
الأمان: هل الراوتر مغلق عن الإنترنت، وترتيب الحماية، والحمايات، والخدمات الإضافية، وتسجيلات الدخول الفاشلة.
التوجيه: جلسات BGP وجيران OSPF والمسارات المعطلة.
تُدرج كل فحوص الحالة. الفحص الذي تعذّرت قراءته يُستبعد من التقرير، ولا يُحسب أبداً على أنه سليم.
التقرير
يبدأ بدرجة من 100 وحكم بكلمات بسيطة، ثم بطاقة نتائج لكل مجال وقائمة بما يجب فعله، الأهم أولاً. تحتها التفاصيل والأرقام. يتبع لغة لوحتك، وتصدير PDF يحفظه بشعار SAMM وعبارة «أعدّه SAMM» في كل صفحة.
الفحص خفيف، ويتوقف عن اختبار المستخدمين عندما يكون معالج الراوتر مشغولاً جداً. إذا بقي الراوتر مثقلاً ينتهي مبكراً ويُعلن ذلك.
النظام
SCOOP AI
SCOOP AI مساعد في أسفل كل صفحة إدارة. اسأل بكلماتك ولغتك عن مستخدميك وباقاتك وبطاقاتك وفواتيرك ودفعاتك وراوتراتك، واحصل على جواب بسيط خلال ثوانٍ. يُثبَّت ويُشغَّل تلقائياً.
وصّل ذكاءً اصطناعياً
في Settings → SCOOP AI، وصّل Google Gemini (مفتاح مجاني)، أو ChatGPT (سجّل الدخول، بلا مفتاح)، أو Claude، أو OpenAI، أو OpenRouter، أو DeepSeek. احتفظ بعدة تسجيلات دخول محفوظة وبدّل بينها، واختر نموذجاً أو اتركه على Automatic. المفتاح الذي يرفضه الذكاء الاصطناعي نفسه يُوقَف عند حفظه، وصفحة مساعدة تعرض كيفية الحصول على مفتاح لكل ذكاء.
ما الذي يحميه
يعمل بصلاحيات كل مدير: المدير يرى ويغيّر فقط ما يسمح به دوره.
المال والحذف وتغييرات الراوتر تُحتجز حتى تضغط Approve.
كل تغيير على الراوتر يحتفظ بإمكانية التراجع على الراوتر نفسه، ولا يمسّ اتصال SAMM الخاص بالراوتر أبداً.
سجلّ SCOOP AI يحفظ كل سؤال وجواب وموافقة لكل مدير.
ما الذي يمكنك أن تطلبه منه
الإجابة عن أسئلتك حول بياناتك، بلغتك.
موازنة الإنترنت بين خطوطك حسب النسبة، وإرسال تطبيقات محددة أو VPN عبر خط تختاره، وضبط DNS أسرع.
إرسال تقرير إليك كل يوم اثنين، أو تذكيرك في وقت محدد.
للصلاحيات قسم SCOOP AI: استخدامه، ورؤية السجل، وتغيير الإعدادات. يستطيع كل مدير إخفاءه لنفسه من قائمة الروبوت أو من ملفه الشخصي.
الشبكة & الراوترات
خريطة الشبكة، والحالة، وسجل البيانات & جودة الاتصال
خريطة الشبكة
يتم رسم Devices → Network Map بناء على ما يبلغ عنه كل راوتر بخصوص جيرانه — لا يوجد مخطط يتطلب صيانة. بدّل الطبقات لعرض المنافذ، وعناوين IP، والشبكات الفرعية وCPU، أو إظهار المسار الذي يتخذه كل جهاز للوصول إلى الإنترنت. اسحب العقد إلى أماكنها واحفظ الترتيب؛ يقوم Discover now بقراءة الجيران مرة أخرى.
حالة الشبكة
تعرض Devices → Network Health قائمة بكل راوتر بدءا من الأسوأ حالة:
سليم، أو مع تحذيرات، أو يستجيب ولكنه معطل، أو لا يمكن الوصول إليه. توضح كل نتيجة الخلل بكلمات بسيطة — تعطيل CoA، أو عدم تطابق RADIUS secret، أو عدم مزامنة الساعة، أو ترك Telnet أو FTP مفتوحا. تكتفي هذه الفحوصات بقراءة بيانات الراوتر. ومن خلال عرض Diagnose الخاص بالراوتر، تتوفر للمشكلات الشائعة ميزة الإصلاح بنقرة واحدة تعرض معاينة أولا ويمكن التراجع عنها. وتؤدي النتائج المفتوحة إلى إرسال تنبيهات في Alert Center.
لفحص أطول لجهاز MikroTik BNG واحد، مع تقرير كامل، استخدم التحقيق العميق.
توجد كلتا الصفحتين خلف مفتاح تبديل واحد، Settings → Advanced → Network Health.
عندما يكون هذا الخيار متوقفاً، لا يقوم SAMM بالاتصال بالراوترات نيابة عنها. وعندما يكون مفعلًا، يمكنك أيضاً اختيار عدد مرات فحص كل راوتر، وعدد الراوترات التي يتم قراءتها في الدورة الواحدة (يتم توزيع عمليات التثبيت المزدحمة على عدة دورات)، وما إذا كان سيتم اكتشاف الجيران من أجل الخريطة.
الراوتر المتوقف لفترة طويلة يمكن إيقافه مؤقتاً، فلا يرسل تنبيهات حتى يعود للاستجابة.
مُحسّن الـ Wi-Fi
Devices → Wireless → Wi-Fi optimizer يعرض لكل راديو عرض الطيف للنطاق الذي يعمل فيه (الإشارة بالـ dBm عبر الترددات، والشبكات التي يلتقطها وأين تتداخل)، وقائمة بهذه الشبكات، ومخطط قنوات يصف كل قناة بأنها Quiet أو Busy أو Crowded. زر Survey now يستمع عبر النطاق كاملاً، راديو واحداً في كل مرة حتى لا يخسر موقع فيه عدة قطاعات كل عملائه معاً، ويخبرك بالكلفة قبل البدء. Live sweep يرسم القراءة الأخيرة والذروة والمتوسط وأنت تتابع.
يقترح مخطط القنوات أهدأ قناة وأفضل عرض قناة لكل راديو. اختر Off أو Suggest أو Auto لكل راديو، للقناة وعرض القناة كل على حدة، أو اتركه يتبع شبكته، واضبط عدة راديوهات معاً من قائمة Wireless. في وضع Auto ينقل SAMM الراديوهات الساعة 04:00 واحداً تلو الآخر، ثم يعيد مسح كل راديو على قناته الجديدة. Apply ينقل الراديو الآن وUndo يعيده. يعمل على راديوهات MikroTik (حزمتا wifi و wireless و CAPsMAN) وعلى نقاط الوصول Ubiquiti UniFi.
سجل البيانات
افتح ملف مستخدم واختر Data Log لرؤية وجهة حركة المرور الخاصة به: أهم الوجهات حسب المضيف والتطبيق — YouTube، Facebook، WhatsApp — مع بيانات الرفع والتنزيل والاتصالات، أو جدول زمني. يقوم SAMM بقراءة تصدير التدفق (IPFIX) الخاص بالراوتر، والرجوع إلى جدول الاتصالات الخاص به عند الحاجة، وتسمية التطبيقات من نفس الكتالوج الذي يستخدمه App Filter. لا يتواجد SAMM أبداً في مسار حركة المرور.
يتم تفعيل Record user Data Log من خلال Settings → Advanced → Data Log.
يتم الاحتفاظ بـ التفاصيل الساعية لبضعة أيام، ثم يتم دمجها في صف واحد لكل موقع يومياً — أي حوالي جزء من 24 من الحجم. وتقوم كل من الصفحة وعملية التصدير بقراءة كليهما، لذا لا يختفي أي شيء من العرض.
Destinations per hour تحتفظ بالوجهات الأكثر نشاطا لكل مستخدم في الساعة وتستبعد العناوين التي تظهر لمرة واحدة فقط؛ 0 تحتفظ بكل شيء.
تحدد Retention مدة الاحتفاظ بالصفوف قبل إزالتها بواسطة عملية التنظيف الليلية.
تؤدي النسخة الاحتياطية مع تفعيل Skip usage إلى استبعاد سجل البيانات Data Log، مما يحافظ على صغر حجم الملف.
معطل حتى يتم تفعيله
يقوم الـ superadmin بتفعيل Data Log في الإعدادات واختيار مدة الاحتفاظ به. هذه الأرقام استرشادية، حيث تعتمد الفوترة دائما على RADIUS accounting.
جودة الاتصال
بينما يكون المستخدم متصلاً، يمكن لـ SAMM تسجيل متوسط السرعة كل بضع دقائق، بناءً على بيانات المحاسبة التي يتلقاها بالفعل، وقياس التأخير والفقد عبر اختبار قصير من الراوتر الخاص به. تعرض صفحة المستخدم بطاقة جودة الاتصال تتضمن أحدث الأرقام، وسجل السرعة مقارنة بالباقة، وزر اختبار الآن؛ كما تحتوي قائمة المستخدمين على عمود اختياري ويمكن أن يتضمن التصدير هذه الأرقام. يتم الاحتفاظ بالسجل لمدة يومين.
معطل حتى يتم تفعيله
قم بتفعيله في Settings → Advanced → Connection Quality، حيث يمكنك أيضاً تحديد تكرار أخذ عينات من المستخدمين وعدد المستخدمين الذين يختبرهم كل راوتر في الجولة الواحدة (الأقل قياساً مؤخراً أولاً). تم تصميمه ليكون خفيفاً: لا تستهلك قياسات السرعة أي حركة مرور في الراوتر، كما يتم تحديد سقف لحمل الاختبار على كل راوتر. الجهاز الذي يحظر الاختبار لا يظهر أي رد حتى لو كان الخط سليماً. يعمل Test now حتى عندما تكون الميزة متوقفة.
الشبكة & الراوترات
CoA & التغييرات الفورية
تعتبر CoA (Change-of-Authorization) هي الوسيلة التي يغير بها SAMM جلسة المشترك أثناء اتصاله — لرفع أو خفض السرعة، أو لفصله — دون انتظار إعادة اتصاله.
كيفية وصول التغييرات إلى المشترك النشط
لا يقوم SAMM أبداً بتطبيق تغيير على الراوتر مباشرة بنقرة زر. كل إجراء يقوم به المسؤول يتبع مساراً آمناً واحداً:
إجراء المسؤول→سجل التدقيق→samm-radius tick→صندوق CoA الصادر→راوتر
يتم تسجيل الإجراء في سجل التدقيق كأمر مؤجل.
تقوم خدمة samm-radius بتفريغ قائمة الانتظار في الدورة التالية، وتطبيق التغيير، و— في حال كان المشترك متصلاً — إضافة CoA إلى قائمة الانتظار.
يتم تفريغ صندوق CoA الصادر وإرسال الحزمة إلى الراوتر.
تغذي الأحداث المعتمدة على الوقت — مثل انتهاء الصلاحية، وحدود نافذة السرعة، وإعادة الضبط اليومية — صندوق الصادر نفسه.
الحد الأعلى للتأخير هو دورة samm-radius واحدة (30 s افتراضياً؛ يمكن خفضها في الإعدادات لفرض أكثر صرامة).
CoA هجين
يرسل SAMM طلب CoA-Update أولاً لتغيير الجلسة الحالية. وإذا رفض الراوتر الطلب بعد عدد محاولات إعادة الإرسال المحددة، ينتقل SAMM تلقائياً إلى Disconnect-Request — حيث يعيد المشترك الاتصال ويطبق الإعدادات الجديدة. تعمل هذه الاستراتيجية الهجينة عبر إصدارات MikroTik المختلفة.
صفحة CoA Outbox
تعتبر Users → CoA Outbox العرض المباشر لهذا الطابور.
samm-radius هو المرسل الوحيد — حيث لا تقوم لوحة تحكم المسؤول بإرسال CoA مباشرة — وهو يقوم بتفريغ الطابور في كل دورة. يتم تحديث الصفحة تلقائياً كل 30 ثانية.
تتصدر الصفحة ستة عدادات — Pending, Sent, NACK (retrying), Done, Failed و Total. يمكن تصفية الجدول حسب الحالة، أو حسب الإجراء (update أو disconnect)، أو البحث باسم المستخدم، أو NAS IP أو السبب.
الحالة
المعنى
قيد الانتظار
في قائمة الانتظار، بانتظار tick samm-radius التالي
تم الإرسال
تم الإرسال (حالة مؤقتة — يتم تسجيل عملية الإرسال ونتيجتها في نفس الـ tick، لذا نادراً ما تبقى الصفوف في هذه الحالة)
nack
رفض الراوتر CoA-Update — يعيد SAMM المحاولة، ثم يلجأ إلى قطع الاتصال
تم
تم التطبيق بنجاح
فشل
توقف بعد الوصول إلى حد إعادة المحاولة — مرر المؤشر فوق الشارة لعرض الخطأ الأخير
يعرض كل صف المستخدم، والراوتر، والإجراء، وعدد المحاولات، والسبب، ووقتي الإنشاء والإرسال. تتيح لك إجراءات كل صف إعادة محاولة إرسال حزمة فشلت أو تم رفضها (nack'd)، أو إلغاء حزمة لا تزال قيد الإرسال، أو فتح الخصائص لفحص سمات RADIUS الدقيقة التي تحملها الحزمة. تحسب شارة الشريط الجانبي عدد الصفوف المعلقة، بينما تتتبع لوحة المعلومات الإخفاقات خلال 24 ساعة. النظام السليم يبقي هذا الطابور شبه فارغ.
أداة تنظيف الجلسات الراكدة
إذا تعطل راوتر أو فقد الاتصال، فقد تضيع حزم 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) الستة
كل مربع هو عداد مباشر واختصار — انقر عليه للانتقال مباشرة إلى القائمة المصفاة المرتبطة بهذا الرقم.
مربع
عرض
فتح
متصل الآن
المشتركون الذين لديهم جلسة RADIUS نشطة حاليا
تصفية المستخدمين حسب Online
المشتركون النشطون
الحسابات النشطة، مع إجمالي عدد المشتركين في الأسفل
تصفية المستخدمين حسب Active
منتهية الصلاحية
المشتركون الذين انتهى اشتراكهم دون تحديد باقة تالية
تصفية المستخدمين حسب Expired
التذاكر المفتوحة
تذاكر الدعم التي لم يتم حلها بعد (باستثناء المكتملة و& المغلقة)
المستخدمون ← تذاكر الدعم
راوترات
إجمالي سجلات NAS، بالإضافة إلى عدد السجلات التي لا يمكن الوصول إليها حاليا
أداة مراقبة MikroTik
فواتير غير مدفوعة
الفواتير التي لا تزال تتطلب متابعة الدفع
تصفية الفواتير حسب Unpaid
مخطط المستخدمين & الجلسات النشطة
يعرض المخطط الخطي للقطات اليومية ثلاث سلاسل بيانات عبر الفترة المحددة —
المستخدمين النشطين، والجلسات المتصلة، و
المستخدمين المنتهية صلاحيتهم — بحيث يمكن رؤية النمو ومعدل فقدان المستخدمين بلمحة سريعة.
حالة Pipeline
تعد لوحة التحكم هذه القلب النابض لمحرك التنفيذ. في النظام السليم، تكون الطوابير عند الصفر أو قريبة منه — أما الرقم الذي يظل مرتفعاً فيشير إلى خدمة متوقفة أو راوتر يرفض التغييرات.
المقياس
المعنى
samm-radius قائمة الانتظار
طلبات CoA المعلقة بانتظار الدورة التالية — من المفترض مسحها خلال ثوان
فشل CoA (24h)
تكون القيمة صفراً في النظام السليم؛ أما القيمة غير الصفرية فتعني أن هناك راوتر يرفض CoAs
سجل التدقيق قيد الانتظار
إجراءات المسؤول المجدولة التي لم يتم تطبيقها بعد بواسطة samm-radius
تحديد معدل الجلسات
المشتركون الذين يتم تقييد سرعتهم حاليا بواسطة حد — أمر متوقع وليس خطأ
لقطة فورية للجلسات
عدد الجلسات النشطة — يجب أن يطابق Online now
الباقات النشطة
حجم كتالوج الباقات الخاص بك
مسار الإنفاذ
توضع إجراءات المسؤول في قائمة انتظار samm.audit_log؛ حيث يقوم الـ samm-radius tick بتفريغها وإرسال CoAs إلى samm.coa_outbox. المسار الكامل موجود في CoA & live changes.
جداول النشاط الأخير
توفر أربعة جداول أسفل المخطط عرضا متجددا لما حدث للتو، مع وجود رابط View all لكل منها للانتقال إلى الصفحة الكاملة:
صندوق CoA الصادر مؤخراً — الإجراء، المستخدم، الحالة (done / pending / nack / failed)، عدد المحاولات، السبب، والوقت.
المشتركون الجدد — أحدث الحسابات مع عرض الحالة ووقت آخر مصادقة.
الراوترات — كل NAS مع نقطة حالة تشير إلى (متاح / غير متاح / لا توجد بيانات).
الجلسات المباشرة
تعرض Overview → Live Sessions قائمة بكل مشترك تبلغ عنه الـ routers حاليا بأنه متصل عبر RADIUS accounting. يتم تحديث الصفحة تلقائيا كل 30 ثانية؛ ويوجد زر تحديث يدوي في الترويسة.
تصفية القائمة
بحث — مطابقة اسم المستخدم، أو framed IP، أو NAS IP، مع عرض النتائج أثناء الكتابة.
Router — تصفية القائمة لعرض الجلسات على NAS واحد.
المحدودون فقط — عرض المشتركين الذين يتم تقييد سرعتهم فقط بسبب وصولهم إلى الحد المحدد.
لكل صفحة — 20 أو 50 أو 100 أو 200 صف.
ما يظهره كل صف
عمود
المعنى
مستخدم
اسم المستخدم — رابط لصفحة تفاصيل المشترك
Framed IP
العنوان الذي خصصه الراوتر لهذه الجلسة
راوتر
الاسم المختصر لـ NAS وعنوان IP الخاص به
باقة
الباقة الحالية للمشترك
السرعة الفعلية
السرعة المفروضة على الراوتر حاليا — سرعة الباقة المعدلة بناء على أي نافذة سرعة نشطة. تعني شارة throttled أن هناك حدًا يبقي المشترك عند سرعة منخفضة.
إيقاف / تشغيل
عدادات البايت اللحظية للجلسة
عبر الإنترنت
مدة استمرار الجلسة
بدأت
عند بدء الجلسة
فصل الجلسة
يقوم زر Disconnect في الصف بإدراج طلب CoA-Disconnect
لتلك الجلسة تحديداً (السبب admin_manual) بعد ظهور رسالة تأكيد.
يتم فصل المشترك فوراً؛ وإذا كان حسابه لا يزال نشطاً، يمكنه إعادة الاتصال. تتبع الحزمة في CoA Outbox.
العمليات اليومية
التقارير & التحليلات
Overview → Reports هي واجهة التحليلات — اتجاهات المشتركين، وحركة المرور بمرور الوقت، والمستخدمين والبطاقات الأكثر استهلاكاً في شبكتك.
اختيار النطاق
ترتبط كل قيمة في الصفحة بنطاق زمني. اختر إعدادا مسبقا —
7d, 14d, 30d, 90d — أو أدخل تواريخ البداية و
النهاية المحددة وانقر على تطبيق. تظهر طبقة تحميل تغطي
الصفحة أثناء تنفيذ استعلام لنطاق زمني طويل مثل 90d.
مخطط شريطي مكدس لبايتات الرفع والتنزيل يومياً. يؤدي تمرير المؤشر فوق اليوم إلى إظهار أرقام الرفع والتنزيل بالإضافة إلى المجموع الكلي في تذييل تلميح الأداة.
قوائم أفضل 10
تعرض أربعة جداول الحسابات ذات حركة المرور الأعلى، مرتبة حسب الحجم بـ GB:
قائمة
الرتب
أكثر 10 عمليات تنزيل اليوم
أكبر عملية تنزيل منذ آخر إعادة ضبط يومية
أعلى 10 عمليات رفع اليوم
أكبر حجم رفع منذ آخر إعادة ضبط يومية
أعلى 10 عمليات تنزيل شهريا
أكبر حجم تنزيل لهذا الشهر التقويمي
أعلى 10 عمليات رفع شهرياً
أكبر حجم رفع لهذا الشهر التقويمي
حركة المرور حسب الكيان
جدول مقسم إلى صفحات وقابل للبحث لحركة مرور البيانات لكل حساب. يتيح تبويبان التبديل بين القوائم المعروضة:
المستخدمون — كل مشترك مع اسمه، وباقته، وحجم الرفع/التنزيل اليومي بـ MB، وحجم الرفع/التنزيل لهذا الشهر بـ GB.
البطاقات — كل بطاقة hotspot مع مجموعتها وحالتها، وتقسيم حركة المرور اليومية / الشهرية ذاتها.
يقوم مربع البحث بتصفية الجدول أثناء الكتابة؛ ويحدد خيار عدد الصفوف لكل صفحة من 20 إلى 200 صف. يؤدي كل صف إلى صفحة التفاصيل الخاصة بذلك المشترك أو البطاقة.
تصدير
التقارير هي عرض تحليلي على الشاشة. وللحصول على صفوف بيانات خام لمعالجتها في جدول بيانات، استخدم Tools → Export / Import لتنزيل المستخدمين أو الباقات أو NAS بصيغة CSV / XLSX.
صفحة Live Traffic
عرض مباشر ومنفصل لمعدل نقل البيانات الحالي للمستخدمين والراوترات والمنافذ، مع تحديث يصل إلى مرة واحدة في الثانية. أضف المجموعات التي تراجعها كثيرا إلى العلامات المرجعية لتكون على بعد نقرة واحدة في المرة القادمة.
العمليات اليومية
محاسبة & الفوترة
يحتوي SAMM على نظام قيد مزدوج متكامل مدمج —
الفواتير، والمصاريف، والإيصالات، والمدفوعات، والموزعين، والأصول الثابتة، والقوائم المالية الكاملة. لا يوجد منتج فوترة منفصل لدمجه، ولا حاجة لمحاسب لضبط السجلات المالية.
لا تتعامل أبداً مع قيود المدين والدائن
كل إجراء — تسجيل دفعة، إضافة مصروف، بيع مجموعة بطاقات —
يرحل قيد يومية متوازن إلى دفتر الأستاذ تلقائياً. أنت
تعمل بمصطلحات بسيطة (فواتير، مصروفات، إيصالات)؛ بينما يتولى SAMM إدارة
دفاتر القيد المزدوج في الخلفية ويثبت توازنها في ميزان المراجعة.
تنقسم صفحة Accounting إلى أحد عشر تبويباً.
نظرة عامة
ملخص مالي. تظهر أربعة أرقام رئيسية في الأعلى:
الشكل
المعنى
النقد المتوفر
إجمالي الرصيد في جميع حسابات & البنكية النقدية
المبالغ المستحقة لك
المستحقات — فواتير العملاء والموزعين غير المدفوعة
المبالغ المستحقة عليك
الحسابات الدائنة — مصاريف غير مدفوعة
أرباح هذا الشهر
صافي الدخل للشهر الحالي
أدناه: جدول لكل حساب بنكي & نقدي مع رصيده، ومخطط الدخل مقابل المصروفات خلال آخر 1، 2، 3، 6 أو 12 شهراً.
الكتب حسب الفرع
تنتمي كل فاتورة، وعملية دفع، ومصروف، وأصل، وحساب نقدي إلى فرع أو إلى الشركة العامة. تحتفظ الفاتورة بالفرع الذي كان يتبعه المستخدم عند إصدارها، حتى لو انتقل المستخدم لاحقا. يظهر محدد Branch في أعلى كل تبويب الشركة بأكملها، أو الشركة العامة فقط، أو فرعا واحدا مع فروعه الفرعية، ويمكن تصفية القوائم وفرزها وتجميعها حسب الفرع. يرى مسؤول الفرع الذي يملك صلاحية Financial دفاتر فرعه فقط.
تسليم النقد: يقوم الفرع بإرسال مبالغ نقدية من حسابه النقدي الخاص إلى حساب الشركة النقدي؛ ويتم تسجيل العملية عند تأكيد الشركة وصول المبلغ. التقارير ← الفروع تعرض بيانات كل فرع جنباً إلى جنب: الإيرادات، المصروفات، الصافي، التحصيلات، المبالغ المستحقة، المستخدمين النشطين، والإيراد لكل مستخدم.
الفواتير
الفاتورة هي مستند مالي تقوم بإصداره. انقر على New invoice واملأ البيانات التالية:
حقل
المعنى
العميل
بحث تلقائي عن الحساب الذي تتم فوترته
فئة الإيرادات
حساب الإيرادات الذي ترحل إليه المبيعات
تاريخ الإصدار / تاريخ الاستحقاق
إذا ترك تاريخ الإصدار فارغاً = اليوم؛ وإذا ترك تاريخ الاستحقاق فارغاً = تاريخ الإصدار
نسبة الضريبة % / مجموعة الضريبة
القيمة الافتراضية هي المعدل في Settings → Billing؛ تعيين مجموعة ضرائب لتطبيق عدة معدلات (VAT/GST وغيرها) في وقت واحد، بحيث يتم ترحيل كل منها إلى حساب ضريبي خاص بها
بنود السطور
صف واحد أو أكثر من الوصف / الكمية / سعر الوحدة — يتم حساب المجموع الفرعي والضريبة والإجمالي بشكل فوري
تحديد قيمة الرسوم — كاملة، مجزأة، أو بدون رسوم
كلما كان SAMM على وشك فوترة مشترك — سواء عند التفعيل، أو التجديد، أو تغيير باقة، أو تمديد تاريخ انتهاء الصلاحية، أو القيام بأي من هذه العمليات بشكل جماعي — يظهر محدد الفواتير نفسه، ويعرض المبلغ قبل التأكيد:
الخيار
الرسوم المفروضة
فاتورة كاملة
فترات الباقة الكاملة فقط — يتم تقريب أي جزء من الفترة إلى فترة كاملة.
فاتورة مجزأة
الوقت الدقيق، مع احتساب نسبة وتناسب للفترة الأخيرة. يتم تقريب المجموع إلى أقرب مبلغ صحيح، مع تسجيل الفرق كتسوية تقريب لضمان توازن الدفاتر.
لا توجد فاتورة
تغيير الخدمة دون فرض أي رسوم — تمديد كبادرة حسن نية، أو ترحيل، أو تصحيح.
حدد المدة باستخدام مضاعف الفترات لفترات الباقة الكاملة، أو أدخل تاريخاً محدداً واترك SAMM يحسب التكلفة. في كلتا الحالتين، تعرض لوحة التحكم بنود الفاتورة والضريبة والمجموع أثناء تغييرها، ويسجل Paid دفعة نقدية للمبلغ الكامل فوراً.
"No invoice" حق وليس مربع اختيار
عدم فرض رسوم هو قرار مالي، لذا يتم التحكم به عبر صلاحية لكل دور في
Settings → Admins. هذا الأمر يهم بشكل أكبر بالنسبة لـ
agents: فمن الممكن للوكيل الذي يقوم مشتركون لديه بالدفع من رصيدهم المسبق الدفع أن يقوم بتجديد الاشتراكات وتغيير الباقات وتمديد تواريخ الانتهاء طوال اليوم دون دفع ثمنها. يتم تعيين هذا الخيار في الأدوار الجديدة على وضع off.
التحصيل & المحفظة مسبقة الدفع
إلى جانب الفواتير الفردية، يقوم SAMM بأتمتة دورة التحصيل بالكامل. يحدد جدول المطالبة يوم الفوترة، ويوم الاستحقاق، ويوم الحظر التلقائي — مع رسوم تأخير اختيارية — بحيث يتم تذكير المشتركين المتأخرين ثم قطع الخدمة عنهم، دون الحاجة لمراقبة جدول بيانات. يتيح وضع المحفظة مسبقة الدفع للمشتركين الاحتفاظ برصيد يتم من خلاله تسوية الفواتير تلقائياً عند التجديد؛ حيث يقومون بشحن الرصيد بأنفسهم من بوابة العملاء عبر البطاقة أو العملات الرقمية، ويتم تسجيل كل عملية شحن وخصم في دفتر الحسابات.
باقات Grace: الفوترة أولاً، والتجديد عند الدفع
الإعداد الشائع هو سلسلة من الباقات: تنتهي الباقة المدفوعة بالانتقال إلى باقة grace قصيرة بالسرعة الكاملة، ثم باقة بطيئة، ثم يتم فصل المستخدم. قم بتفعيل Raise the renewal invoice when a paid plan expires into its next plan في Accounting → Settings وسيقوم SAMM بإصدار فاتورة التجديد في اللحظة التي ينتقل فيها المستخدم إلى grace، وتكون مستحقة عند انتهاء grace. وبمجرد دفعها — عند الكاونتر، أو عبر الإنترنت، أو من المحفظة — يعود المستخدم إلى باقته، بتاريخ يبدأ من يوم انتهائها، بحيث لا يتغير يوم الفوترة أبداً. أما المستخدمون الذين لم يدفعوا فيستمرون ببساطة في الانتقال عبر السلسلة.
تجنب الضغط على تجديد باقة لهؤلاء المستخدمين
يؤدي تجديد الباقة إلى استعادة الخدمة الكاملة على الفور، سواء تم الدفع أم لا. عند تفعيل هذا الإعداد، تتم عملية التجديد تلقائياً عبر الفاتورة والدفع. يكون الإعداد متوقفاً حتى تقوم بتفعيله.
يتم إنشاء الفواتير أيضا تلقائيا عند تجديد باقة المشترك (من خلال إجراء Renew Expiration الخاص بالمستخدم أو عبر التجديد التلقائي)، بشرط أن يكون للباقة سعر. يتم تصفية القائمة حسب الحالة — غير مدفوعة، جزئية، مستحقة، مدفوعة — والبحث برقم الفاتورة أو العميل. افتح أي فاتورة للانتقال إلى صفحة التفاصيل والحصول على ملف PDF قابل للطباعة؛ ويمكن للمشتركين التنزيل لنسخهم الخاصة من بوابة العملاء و Telegram bot.
المصاريف
المصروف هو الأموال التي يتم إنفاقها لتشغيل ISP. يسجل New expense الفئة (حساب المصروفات)، والمصنّع الذي تم الدفع له، والمبلغ، وتاريخ حدوث المصروف، وتاريخ استحقاق اختياري. يمر كل مصروف بنفس دورة حياة unpaid / partial / due / paid الخاصة بالفاتورة، مع صفحة تفاصيل، و voucher PDF قابل للطباعة.
إيصالات & مدفوعات
يسجل هذان التبويبان حركة النقد الفعلية — بشكل منفصل عن الفاتورة أو المصروف الذي تسبب في ذلك.
المقبوضات — أموال واردة: مبالغ نقدية مستلمة من عميل، أو موزع، أو أي دخل آخر، تودع في أحد حساباتك النقدية. الفاتورة هي المطالبة المالية؛ أما المقبوضات فهي الأموال التي تصل مقابلها.
المدفوعات — أموال خارجة: مبالغ نقدية مدفوعة مقابل مصروفات أو لموزع.
يؤدي تسجيل إيصال أو دفعة إلى تغيير حالة الفاتورة أو المصروف ذي الصلة إلى paid وترحيل القيد الدفتري المطابق.
العملاء ومبيعات البطاقات &
يسرد تبويب Customers الرصيد الحالي لكل مستخدم — وهو المبلغ المستحق لك. تغطي Card sales إيرادات hotspot مسبقة الدفع: حيث تتبع card groups و resellers المباعة. يقوم reseller بشراء مجموعات بطاقات كاملة منك بموجب فاتورة، ثم يعيد بيع البطاقات الفردية للمستخدمين النهائيين؛ ويكون balance owed هو المبلغ الذي لا يزال يتعين عليه دفعه لك.
الوكلاء — فوترة الجملة
يقوم الوكيل ببيع خدمتك للعملاء النهائيين وفق نموذج الجملة مسبق الدفع — مثل نظام الامتياز أو الموزع الفرعي الذي يدير سجل المشتركين الخاص به ولكن يعتمد على شبكتك. هذا الخيار اختياري تماماً: إذا لم تقم بإنشاء وكيل، فإن نظام الفوترة سيعمل تماماً كما كان دائماً.
دينان، مفصولان تماما
يدين الوكيل لك بسعر الجملة (في سجلاتك، يمثل هذا إيراداتك)؛ بينما يدين العميل للوكيل بسعر التجزئة (خارج سجلاتك — وهي مستحقات الوكيل الخاصة). عمولتك هي الفارق بين الاثنين، وتُسجل كـ خصم تجاري، وليس كمصروف أبداً.
أنشئ وكيلاً في إعدادات ← المسؤولين عن طريق منح مسؤول جديد دور Agent المدمج. الوكيل هو scoped admin login يتمتع بـ:
إعداد
المعنى
نسبة العمولة %
نسبة الوكيل من سعر التجزئة (مثلاً 40% — تحتفظ بـ 60% كإيرادات بيع بالجملة). قابلة للتعديل لكل وكيل في أي وقت.
حد الائتمان
الحد الذي يمكن أن يصل إليه رصيد الوكيل المسبق الدفع بالسالب قبل رفض عمليات التجديد. تعيين 0 للنظام المسبق الدفع الصارم.
رصيد مسبق الدفع
اشحنه عندما يدفع لك الوكيل؛ حيث يتم خصم سعر الجملة منه عند كل تجديد.
عندما يقوم أحد مشتركي الوكيل بالتجديد، يخصم SAMM سعر الجملة من رصيد الوكيل، ويسجل إيراداتك، ويصدر فاتورة بيع بالتجزئة حقيقية للعميل النهائي تكون مستحقة الدفع للوكيل ولا تظهر في دفتر حساباتك. تحصيل الديون من جانب الوكيل — وهو خيار مستقل تحت إعدادات ← Billing، مفعل افتراضياً، مع فترة سماح قابلة للتعديل — يقوم تلقائياً بـ تعليق العميل غير الدافع (عبر إصدار CoA disconnect)؛ وعندما يسجل الوكيل دفعة العميل، يتم إعادة تفعيل المشترك على الفور.
يسجل الوكيل الدخول إلى عرض محدد: لوحة المعلومات الخاصة به، وصفحة محفظة My Balance، وقائمة My Customers التي تضم فواتير ومدفوعات كل عميل، و My Statement — وكل ذلك مقتصر على سجلاته الخاصة، بينما تظل سجلات الشركة وعملاء الوكلاء والمسؤولين الآخرين مخفية.
الأصول & حسابات النقدية
الأصول — تسجيل الأصول الثابتة (راوترات، مركبات، معدات). يتتبع SAMM قيمتها وإهلاكها بمرور الوقت.
Cash — إدارة حسابات cash & البنكية، وحسابات capital accounts: حقوق الملكية، حيث تمثل المساهمة الأموال التي يضعها المالك في العمل، والسحب هو الأموال التي يتم إخراجها. رأس المال ليس إيراداً ولا يظهر أبداً في Profit & Loss.
التقارير — القوائم المالية
تبويب Reports هو واجهة المحاسب. خمسة تقارير، كل منها محدد بنطاق زمني وقابل للتصدير إلى PDF:
تقرير
الإجابات
الربح & الخسارة
الدخل مقابل المصروفات وصافي الربح خلال نطاق زمني. أساس الاستحقاق — يُحتسب الدخل عند إصدار الفاتورة، والمصروفات عند استحقاقها، وليس عند التدفق النقدي.
الميزانية العمومية
في تاريخ معين: ما تملكه (الأصول) مقابل ما عليك من التزامات (الخصوم) بالإضافة إلى حقوق الملكية. تؤكد شارة balanced تطابق الجانبين.
التدفق النقدي
لكل حساب نقدي — الرصيد الافتتاحي، والمبالغ الواردة، والمبالغ الصادرة، والرصيد الختامي خلال فترة محددة.
التقادم
المستحقات والمدفوعات القائمة مصنفة حسب الفترات الزمنية، لتمكينك من متابعة الفواتير المتأخرة والالتزام بمواعيد سداد الفواتير.
متقدم
الدفاتر الأساسية: دفتر الأستاذ العام (كل سطر في حساب واحد مع رصيد تراكمي)، ميزان المراجعة (التحقق من توازن الدفاتر)، دفتر اليومية، وسجل النشاط.
التحقق من التوازن
في Trial Balance يجب أن يتساوى مجموع عمودي المدين والدائن — وهذا هو الدليل على سلامة الدفاتر. وإذا حدث أي خلل في التوازن، فإن ذلك يشير إلى خطأ في الترحيل يستوجب التحقق منه.
تصدير إلى برنامج المحاسبة
من خلال Accounting → Reports → Export، يمكن تنزيل السجلات بصيغة CSV لبرامج QuickBooks أو Xero أو أي جدول بيانات: General Journal و Chart of Accounts و Invoices و Trial Balance و Profit & Loss و Balance Sheet. تعتمد General Journal و Invoices و P&L على النطاق الزمني، بينما تعكس التقارير الأخرى الحالة حتى تاريخ اليوم. تتوفر البيانات نفسها عبر API من خلال GET /api/v1/accounting/export/{kind} (format=json|csv, scope accounting:read) لخطوط أنابيب BI و Zapier. تستثني عمليات التصدير القيود الملغاة، لذا فإن التنزيل يتطابق دائماً مع التقارير المعروضة على الشاشة.
العمليات اليومية
تراجع & موافقات
معظم الأخطاء في لوحة التحكم الخاصة بـ ISP هي أخطاء مالية: تجديد اشتراك مشترك خاطئ، أو تسجيل عملية دفع مرتين، أو تغيير باقة في حساب خاطئ. يمنحك SAMM نافذة تراجع لمدة خمس دقائق لهذه الإجراءات، و — في الحالات التي تتضمن استرداد أموال — بوابة موافقة superadmin قبل أن يدخل الإجراء حيز التنفيذ.
نافذة التراجع
يتم تسجيل كل إجراء يقوم به المسؤول ويؤدي إلى نقل أموال أو تغيير حالة فور حدوثه. ولمدة خمس دقائق القادمة، يظهر في الشريط العلوي زر Undo وقائمة Action history — انقر على السهم للتراجع عن الإجراء الأخير، أو افتح السجل للعودة إلى أي نقطة ضمن هذه الفترة. يقوم Redo بإعادة تنفيذ الإجراء.
لماذا خمس دقائق فقط
التراجع ليس آلة زمن — بل هو شبكة أمان للنقرة التي قمت بها للتو.
بعد مرور بضع دقائق يتغير الوضع: قد يكون المشترك قد اتصل بالإنترنت، أو تم دفع فاتورة، أو قام شخص آخر بتعديل السجل. يفضل SAMM الرفض بدلاً من إعادة كتابة التاريخ بصمت، لذا فإن هذه الخطوة تُحذف ببساطة من سجلك عند إغلاق النافذة.
يتم رفض التراجع — مع ظهور السبب على الشاشة — عندما يؤدي عكس العملية إلى حذف شيء لم يتم إنشاؤه بواسطة هذه العملية:
رفض
المعنى
هذا السجل لم يعد موجوداً
تم حذف المشترك أو الفاتورة أو الدفعة بعد اتخاذ هذا الإجراء — لم يتبق شيء لاستعادته.
هذا السجل موجود مسبقاً
تم إنشاء عنصر بدلاً منه؛ التراجع سيؤدي إلى استبدال السجل الأحدث.
تغير هذا السجل بعد تنفيذ إجراءك
قام شخص آخر بتعديله في هذه الأثناء — التراجع سيؤدي إلى تجاهل تعديلاته دون تنبيه.
هذه الخطوة لم تعد موجودة في السجل
انتهت مهلة الخمس دقائق.
التراجع هو عملية عكسية وليس حذفاً: حيث يظل الإجراء الأصلي وعملية التراجع عنه في Audit log، لذا لا يفقد سجل ما حدث أبداً. أما الإجراءات التي تنشئ شيئاً ما، فستنبهك بوضوح — التراجع عن هذا الإجراء سيؤدي إلى حذف ما تم إنشاؤه — قبل تنفيذها.
بوابة موافقة الوكيل
يقوم الوكيل بدفع قيمة اشتراك المشترك من رصيده المسبق الدفع لحظة تفعيل الاشتراك. وهذا يجعل عكس الإجراء وسيلة لاسترداد الأموال — وطريقة للغش: تفعيل مشترك، وتركه يستخدم الخدمة طوال الشهر، ثم حذفه في اليوم الأخير واستعادة الرسوم.
يقوم SAMM بتقسيم إجراءات الوكيل بناء على اتجاه حركة الأموال:
الاتجاه
أمثلة
السلوك
يتكبد الوكيل تكاليف مالية
تفعيل، تجديد، تغيير الباقة، تحصيل دفعة عميل
فوري. فعمل الوكيل اليومي لا ينتظر أحداً.
استرداد الأموال
تراجع، حذف مشترك، حذف فاتورة، إلغاء تحصيل
تم تعليقه كطلب. لن يتم تغيير أي شيء حتى يوافق عليه superadmin.
لا يتم تنفيذ الإجراءات المقيدة بشكل جزئي. يتم تخزين الطلب مع كل ما يلزم لتنفيذه لاحقاً، والموافقة تعيد تشغيله عبر نفس الكود الذي كان سيعمل به الـ agent — وليس عبر تنفيذ ثانٍ قد ينحرف عن الأول. أما الرفض فيترك الوضع كما كان تماماً، ويحتفظ الـ agent بالمهمة.
التعامل مع قائمة الانتظار
تصل الطلبات إلى Accounting → Agents Approval مع الوكيل، والإجراء، والموضوع المشار إليه، ومقدار المبلغ المسترد — وهو الرقم الذي يتم بناء القرار عليه. يمكن التصفية حسب الوكيل أو الحالة، أو البحث، أو تحديد عدة طلبات والموافقة عليها أو رفضها معاً؛ ويمكن أن يتضمن الرفض سبباً قصيراً يراه الوكيل.
تفويض
نادراً ما تكون مراجعة الوكلاء طوال اليوم مهمة المسؤول الخارق. يمكن منح صلاحية Agents Approval لأي دور في إعداد → المسؤولين، بحيث يحصل الشخص الذي يقوم بالمراجعة فعلياً على هذه الصلاحية تحديداً — ولا شيء غيرها. تظل عملية إنشاء وإدارة الوكلاء مقتصرة على المسؤول الخارق فقط، ولا يمكن لأي شخص البت في طلبه الخاص.
ما يراه الموظف
تظهر للوكيل صفحة My Account → Pending Approvals
تسرد كل ما طلبه: ما يزال قيد الانتظار، وما تمت الموافقة عليه أو
رفضه — مع ذكر سبب المراجع. وبدون ذلك، سيكون الرفض غير قابل للتمييز
عن الطلب المفقود، وسيقوم الوكيل ببساطة بإعادة الطلب مرة أخرى.
يمكنهم سحب طلباتهم المعلقة — سواء طلب واحد في كل مرة أو عدة طلبات معاً — لأن طلب شيء لا يمكنك التراجع عنه هو فخ بحد ذاته. الطلب المسحوب لم يتم تنفيذه أبداً، لذا لا يتغير شيء؛ أما الطلب الذي تم البت فيه فقد أصبح جزءاً من السجل ويبقى كما هو. الفاتورة التي تنتظر المراجعة تظهر حالتها أيضاً في صفحتها الخاصة، لذا فإن الوكيل الذي نقر على Delete ولم يلاحظ حدوث شيء سيفهم السبب.
لمشتركيكم
المدفوعات عبر الإنترنت
يتيح SAMM لمشتركيك دفع فواتيرهم عبر الإنترنت — بالبطاقة البنكية
(Stripe أو PayPal)، أو بالعملات الرقمية (Binance)،
أو عبر Sham Cash في سوريا.
عندما يدفع المشترك،
يقوم SAMM بتحديد الفاتورة كمدفوعة، ويسجلها في دفاترك،
وإذا كان قد انقطع عنه الاتصال بسبب عدم الدفع — يعيد توصيله تلقائياً.
لا يتم تحصيل أي رسوم منك: كل بوابة تستخدم حسابك الخاص، فتصل الأموال إليك مباشرة.
تفعيل (أي بوابة)
انتقل إلى Financial → Online payments (للمسؤول الخارق فقط).
انقر على بوابة لتوسيعها — Stripe أو PayPal أو Binance.
املأ الحقول، وحدد Enable this gateway، ثم انقر Save. لن يسمح لك SAMM بالحفظ حتى يتم ملء الحقول المطلوبة.
انقر على Run test للتأكد من عمل بيانات الاعتماد.
تم — يظهر للمشتركين الآن زر Pay في فواتيرهم غير المدفوعة عبر البوابة (وفي صفحة "subscription expired").
يمكنك تفعيل أكثر من بوابة — ويختار المشترك البوابة التي يرغب في استخدامها.
Stripe — البطاقات البنكية، عالمياً
أنشئ حساباً مجانياً في stripe.com. أبقِ Test mode مفعلاً أثناء التجربة.
انتقل إلى Developers → API keys وانسخ Secret key (الذي يبدأ بـ sk_).
في SAMM، قم بتوسيع Stripe، ثم لصق Secret key، واختر العملة والحساب النقدي الذي يستقبلها، ثم حفظ و تشغيل الاختبار.
موصى به: إضافة webhook لضمان تأكيد المدفوعات بشكل موثوق. في Stripe انتقل إلى Developers → Webhooks → Add endpoint، واضبط URL على https://YOUR-SAMM/pay/webhook/stripe، واختر الحدث checkout.session.completed، ثم انسخ سر التوقيع (signing secret) الخاص بنقطة النهاية (whsec_…) في حقل Webhook signing secret في SAMM.
إطلاق الخدمة
يعمل وضع الاختبار في أي مكان. يتطلب استلام أموال حقيقية عبر Stripe دولة مدعومة من Stripe وحساب بنكي مرتبط.
PayPal — البطاقات & رصيد PayPal
أنشئ حساب PayPal Business، ثم من خلال developer.paypal.com أنشئ App من نوع REST وانسخ Client ID و Secret الخاصين به.
في SAMM، قم بتوسيع PayPal، ثم لصق Client ID و Client secret، واختر Sandbox (للاختبار) أو Live، ثم حفظ و تشغيل الاختبار.
موصى به: إضافة webhook في developer.paypal.com ← your App ← Webhooks، وURL https://YOUR-SAMM/pay/webhook/paypal، والاشتراك في CHECKOUT.ORDER.APPROVED و PAYMENT.CAPTURE.COMPLETED، ثم لصق معرف Webhook في SAMM لضمان التحقق من صحة الإشعارات الواردة تشفيرياً.
Binance — عملات رقمية، تعمل في كل مكان، ولا تتطلب حساباً بنكياً
هذا هو الخيار الأفضل عندما لا تتوفر البطاقات وPayPal. يدفع مشتركوك بـ
العملات الرقمية؛ يراقب SAMM حساب Binance الخاص بك ويحدد الفاتورة كمدفوعة تلقائياً.
تحتاج إلى ثلاثة أشياء: API Key، وAPI Secret، ومكان للاستلام —
عنوان محفظة و/أو Binance Pay ID.
الخطوة 1 — إنشاء API key للقراءة فقط
السلامة أولاً
أنشئ المفتاح بصلاحية القراءة فقط. لا تفعل Withdraw أو Trade أبداً —
يحتاج SAMM فقط إلى قراءة مدفوعاتك الواردة، ولا يحتاج أبداً إلى نقل الأموال.
تسجيل الدخول إلى Binance ← فتح Account → API Management (أو البحث عن "API Management").
انقر على Create API ← اختر System generated ← قم بتسميته مثلا "SAMM" ← أكمل فحص الأمان.
تعرض Binance الـ API Key والـ Secret Key — انسخ كليهما الآن (يظهر الـ Secret مرة واحدة فقط).
انقر على Edit restrictions وأبقِ خيار only "Enable Reading" محدداً فقط. اترك Spot Trading و Withdrawals في وضع OFF. (اختياري: تقييد المفتاح بعنوان IP الخاص بخادمك.)
لصق API Key و API Secret في بطاقة Binance الخاصة بـ SAMM (المفتاح أولاً، ثم السر — بنفس الترتيب الذي يظهره Binance).
الخطوة 2 — الحصول على عنوان محفظة الاستلام
في Binance انتقل إلى Wallet → Spot → Deposit (إيداع العملات الرقمية).
اختر العملة USDT.
اختر الشبكة — TRC20 هي الأرخص والأكثر شيوعا؛ كما يمكن استخدام BEP20 و ERC20 أيضا. استخدم نفس الشبكة التي اخترتها في SAMM.
انسخ Address الخاص بالإيداع والصقه في حقل On-chain receiving wallet address في SAMM. تأكد من أن قائمة Network المنسدلة في SAMM تطابق الشبكة التي اخترتها.
الخطوة 3 — (اختياري) Binance Pay ID
للمشتركين الذين يفضلون Binance Pay (فوري، بدون رسوم شبكة): افتح Pay في تطبيق Binance ودوّن Pay ID الخاص بك (يمكن استخدام البريد الإلكتروني أو الهاتف أيضاً). قم بلصقه في حقل Binance Pay ID في SAMM. يمكن للمشتركين بعد ذلك الدفع عبر Pay ID وكذلك عبر on-chain.
أخيرا، حدد Enable، ثم انقر على Save، ثم Run test
(للتحقق من قدرة المفتاح على قراءة حسابك). أنت الآن متصل.
المبلغ الدقيق، الشبكة الصحيحة
يجب على المشترك إرسال المبلغ الدقيق الذي يظهره SAMM (تحدد الأرقام الصغيرة الأخيرة رقم فاتورته) عبر الشبكة الصحيحة. أي مبلغ مختلف أو استخدام شبكة خاطئة سيؤدي إلى تأخير الدفع أو فقدانه.
Sham Cash — سوريا
يدفع المستخدمون عبر تطبيق Sham Cash أو موقع Sham Cash الإلكتروني، ويتم إخطار SAMM فور إتمام عملية الدفع. تذهب الأموال إلى حساب Sham Cash التجاري الخاص بك.
افتح حساب Sham Cash تجاري موثق، ثم اطلب من دعم Sham Cash إنشاء خدمة دفع إلكتروني لك (سيطلبون عنوان الشعار والاسم الذي سيراه المستخدمون).
توفر لك Sham Cash ثلاث قيم: Agent Key و Secret Key و Base URL. وتملك خدمة الاختبار والخدمة الحقيقية ثلاث قيم خاصة بكل منهما.
في SAMM افتح المالية → المدفوعات عبر الإنترنت → Sham Cash، وأبقِ الاتصال على Official API، والصق القيم الثلاث، واختر العملة (USD أو SYP، نفس عملة SAMM لديك)، ثم حفظ، ثم تشغيل الاختبار.
يجب أن يكون SAMM متاحا عبر الإنترنت لتمكين Sham Cash من تأكيد كل عملية دفع. إذا كان SAMM الخاص بك متاحا عبر عنوان آخر، فأدخله في Public SAMM address for the callback. لا يتطلب الأمر أي إعدادات من جانب Sham Cash: حيث يرسل SAMM عنوانه الخاص مع كل عملية دفع.
خدمة تجريبية أو خدمة فعلية
باستخدام قيم test تكون كل عملية دفع عبارة عن محاكاة: تقبل صفحة الدفع الرمز 000000، ويظهر SAMM أن الفاتورة مدفوعة، ولا تصل أي أموال إلى أي حساب. تتطلب المدفوعات الحقيقية قيم خدمة real الخاصة بك من الدعم في Sham Cash. تحقق من Base URL الذي حفظته: رابط الاختبار ليس هو الرابط الحقيقي.
ما يفعله المستخدم: يضغط على Open Sham Cash في بطاقة الدفع.
على الهاتف، يفتح تطبيق Sham Cash (الإصدار 2.2.5 أو أحدث)، وإلا يفتح موقع Sham Cash الإلكتروني؛ يتحقق المستخدم من المبلغ ويؤكد العملية باستخدام رمز تأكيد التحويل (الذي تم إعداده في تطبيق Sham Cash). على الكمبيوتر، تعرض البطاقة أيضاً رمز QR للمسح بواسطة كاميرا الهاتف. يعمل كل رابط دفع لمدة 10 دقائق؛ وتؤكد البطاقة العملية تلقائياً بمجرد تأكيد Sham Cash لها.
يمكن لتطبيق Sham Cash الخاص استقبال المدفوعات نيابة عنك أيضاً: امنحه token بصلاحية Payment apps فقط (راجع قسم REST API). يقوم التطبيق بالبحث عن مستخدم بواسطة اسم المستخدم وتسجيل الدفعة التي استلمها.
Sham Cash بدون مفاتيح تاجر (Non-official API)
لا تملك خدمة تاجر من Sham Cash؟ يمكن لـ SAMM استقبال مدفوعات Sham Cash عبر shamcash-api.com، وهي خدمة مستقلة (ليست Sham Cash) تقرأ التحويلات الواردة إلى حساب Sham Cash الخاص بك. يمكنها القراءة فقط: ولا يمكنها إرسال المال.
أنشئ حساباً على shamcash-api.com واربط حساب Sham Cash الخاص بك: في تطبيق Sham Cash افتح حسابي → الأجهزة المرتبطة وامسح رمز QR الخاص بهم. ابدأ اشتراكه وأنشئ مفتاح API للقراءة فقط.
في SAMM افتح المالية → المدفوعات عبر الإنترنت → Sham Cash، واضبط الاتصال على Non-official API (shamcash-api.com)، والصق مفتاح الـ API، واختر العملة ثم حفظ. يقرأ SAMM معرّف حسابك وعنوان Sham Cash الخاص بك من المفتاح. ثم تشغيل الاختبار.
ما يفعله المستخدم: تعرض بطاقة الدفع عنوان Sham Cash الخاص بك (ورمز QR الخاص به)، والمبلغ ورمزاً قصيراً مثل SM-1234. يرسل المستخدم المبلغ من تطبيق Sham Cash ويكتب الرمز في ملاحظة التحويل. يؤكد SAMM الدفعة خلال دقيقة. أما التحويل بدون الرمز، أو بأقل من المبلغ، أو بعملة أخرى، فيُحفظ لمراجعتك بدلاً من تطبيقه.
صفحة الدفع والتجديد عبر الإنترنت
تؤدي Settings → Billing → Pay page إلى تفعيل صفحة عامة في
/pay: حيث يقوم المستخدم بإدخال اسم المستخدم الخاص به، ومعرفة المبلغ المستحق عليه والدفع، دون الحاجة لتسجيل الدخول. وتتوفر صفحة Pay نفسها في بوابة المستخدم للمستخدمين الذين سجلوا دخولهم.
التجديد: يمكن للمستخدمين تجديد باقتهم عبر الإنترنت لفترة تتراوح من 1 إلى 12 فترة، سواء قبل انتهاء صلاحيتها أو بعدها. يحافظ الدفع المسبق على الوقت المتبقي لديهم، بينما يعود المستخدم الذي انتهت صلاحية باقته للخدمة بمجرد وصول الدفع. يحدد مفتاحان مكان عرض هذه الميزة: Renew on the Pay page و Renew in the user portal (كلاهما مفعل افتراضيا).
البحث عن المستخدمين بدون البادئة أو اللاحقة: بالنسبة لأسماء المستخدمين مثل 858000@inet، فإن كتابة 858000 (6 أحرف على الأقل) تتيح العثور على الحساب. وعندما يتطابق أكثر من حساب واحد، يُطلب من المستخدم إدخال اسم المستخدم الكامل. معطل افتراضياً.
اختر المعلومات التي تعرضها الصفحة عن الحساب (الاسم المقنع، الباقة، تاريخ الانتهاء والمزيد)؛ يظهر الاسم المقنع فقط بشكل افتراضي.
ما يراه المشترك
تسجيل الدخول إلى بوابة العميل ← فواتيري
في الفاتورة غير المدفوعة، يتم النقر على Pay (أو "Pay · Stripe" / "Pay · Binance" في حال تفعيل عدة خيارات).
البطاقة: يتم توجيههم إلى الصفحة الآمنة للبوابة. العملات الرقمية: يرون المبلغ الدقيق، وعنوانك مع رمز QR، و/أو Pay ID الخاص بك.
بمجرد الدفع، تتحول حالة الفاتورة إلى Paid، وتُقيد في دفاتر حساباتك، وإذا كانت منتهية الصلاحية يتم إعادة الاتصال تلقائياً — بل ويظهر للمشتركين الذين انتهت صلاحيتهم زر "Pay & reconnect" في صفحة انتهاء الصلاحية.
تبقى سجلاتك دقيقة
كل عملية دفع عبر الإنترنت تسجل قيداً مزدوجاً متوازناً (Dr Cash / Cr Accounts Receivable) وتوثق طريقة الدفع (Stripe / Binance) في الفاتورة، وسجل المدفوعات، وملف PDF — لتعرف دائماً وسيلة سداد كل عملية دفع.
العمليات اليومية
تذاكر الدعم
يحتوي SAMM على مكتب دعم مدمج. يقوم المشتركون بفتح تذاكر من بوابة العملاء أو بوت Telegram، ويمكن للمسؤول فتح تذكرة نيابة عن مشترك، ويعالج فريقك جميع هذه التذاكر من Users → Support Tickets.
قائمة انتظار التذاكر
تعرض قائمة الانتظار كل تذكرة — الرقم، والعميل، والموضوع، والأولوية، والحالة، وتاريخ الفتح وتاريخ آخر تحديث، وعدد الرسائل. يمكن تصفيتها باستخدام:
شرائح الحالة — شريحة لكل حالة تذكرة، تعرض كل منها عدداً محدثاً لحظياً، بحيث يمكن معرفة حجم العمل بنظرة سريعة.
الأولوية — Normal، أو Moderate، أو Critical.
نشط / مسحوب — يمكن للعميل سحب التذكرة التي لم يعد بحاجة إليها؛ تظهر التذاكر المسحوبة باهتة وتكون مخفية بشكل افتراضي.
بحث — حسب رقم التذكرة، أو الموضوع، أو العميل.
تعرض شارة الشريط الجانبي عدد التذاكر المفتوحة لضمان عدم تفويت أي منها.
فتح تذكرة
تتيح تذكرة جديدة للمسؤول إنشاء تذكرة لعميل مختار —
اختر العميل، ثم حدد الموضوع والأولوية والوصف. كما يمكن للمشتركين فتح تذاكرهم الخاصة من بوابة العملاء أو عبر Telegram bot.
معالجة تذكرة
افتح التذكرة لقراءة سلسلة المحادثة الكاملة. ومن هناك يمكنك:
الرد على العميل — رسالة عامة يراها المشترك في البوابة الخاصة به وعبر Telegram bot.
إضافة ملاحظة داخلية — رسالة للموظفين فقط، مخفية عن العميل، لتدوين ملاحظات التسليم بين أعضاء فريقك.
تغيير حالة التذكرة وأولويتها.
انقر بزر الماوس الأيمن على أي صف — أو استخدم زر ⋮ الخاص به — للقيام بنفس إجراءات الحالة والأولوية والرد والملاحظات الداخلية دون مغادرة قائمة الانتظار.
العمليات اليومية
مركز التنبيهات
يبقي SAMM المشتركين على اطلاع تلقائيا — عبر email و
Telegram و SMS و WhatsApp — ويتيح لك بث الرسائل. تقوم
خدمة samm-notification بتسليم كافة التنبيهات عبر طابور واحد محدود السرعة.
تحتوي صفحة System → Notification Center على ستة تبويبات.
نظرة عامة
تبويب الصفحة الرئيسية — أعداد مباشرة (في الانتظار، جاري الإرسال، تم الإرسال اليوم، فشلت، تم تخطيها، تم إلغاء الاشتراك)، وحالة كل قناة تسليم، وخلاصة لأحدث الإشعارات.
القنوات
تكوين كيفية إرسال الرسائل من SAMM. يستخدم Email حساب إشعارات خاص به، منفصل عن SMTP استعادة كلمة المرور في إعدادات. يستخدم Telegram رمز bot token، وتمر SMS عبر بوابة HTTP عامة أو Twilio، بينما يستخدم WhatsApp واجهة Meta WhatsApp Cloud API الرسمية (التي يتم إنشاؤها في Meta for Developers)، مع خيار استخدام جسر غير رسمي مرتبط بـ QR على مسؤوليتك الخاصة — يتم تثبيت هذا الجسر بنقرة واحدة على خادم bare-OS ويأتي كحاوية جاهزة للتشغيل على Docker. يتم تخزين جميع أسرار القنوات بتشفير Fernet. يختار كل مشترك، من خلال بوابة العملاء، القنوات التي يريدها ويمكنه إلغاء الاشتراك بالكامل.
يمكن لـ SMS gateways أيضا الإرسال في template mode، بالنسبة للمشغلين الذين يقبلون القوالب المعتمدة فقط: تقوم بتحديد اسم القالب ويرسل SAMM القيم بالترتيب الذي يتوقعه القالب. اختر تنسيق الرقم الذي تطلبه كل بوابة (دولي مع + أو 00، أو وطني مع أو بدون 0 في البداية). قم بعمل لصق لرابط بوابة يعمل من مزود الخدمة الخاص بك وسيقوم SAMM بتعبئة الحقول و template mode وتنسيق الرقم نيابة عنك.
الرسائل
قوالب الرسائل، مجموعة واحدة لكل حدث. تعديل صيغة أي إشعار — تذكيرات التجديد، والإيصالات، وغيرها — بحيث تصدر كل رسالة بأسلوبك ولغتك الخاصة.
القواعد & المؤقتات
يتحكم هذا التبويب في توقيت وكيفية إرسال الإشعارات التلقائية. يمكنك التحكم في كل حدث على حدة:
ما إذا كانت القاعدة مفعلة.
تجاهل إلغاء الاشتراك — عند تفعيل هذا الخيار، تصل الرسالة إلى جميع المشتركين حتى لو قاموا بإلغاء الاشتراك. يرجى تخصيص هذا الخيار للرسائل الإجرائية الهامة.
التوقيت — على سبيل المثال، عدد الأيام قبل انتهاء الصلاحية لإرسال تذكير بالتجديد.
تحديد سرعة & التسليم — يقوم العامل بتفريغ الطابور دفعة واحدة لكل نبضة؛ ويحدد حجم الدفعة وفاصل النبضة معاً سرعة إرسال الرسائل، بحيث لا يؤدي البث الواسع أبداً إلى إغراق خادم البريد الخاص بك.
تشمل الأحداث التي يمكن لـ SAMM إصدارها تلقائياً تذكير التجديد
(قبل انتهاء الاشتراك)، وإشعار الانتهاء (عند انتهائه)،
وتحذير الحصة (عند اقتراب نفاد سعة البيانات)، وإيصال الدفع
(عند تسجيل عملية دفع)، وتجديد الباقة.
بث
إرسال رسالة لمرة واحدة — مثل نافذة صيانة أو تغيير في السعر — إلى مجموعة مختارة من المشتركين. تتدفق هذه الرسائل عبر نفس طابور التحديد (throttled queue) الخاص بالتنبيهات التلقائية.
صندوق الصادر
كل رسالة قام SAMM بجدولتها أو إرسالها، مع حالة التسليم الخاصة بكل رسالة، بحيث يمكنك التأكد من وصول الإشعار إلى المشترك أو معرفة سبب عدم وصوله.
النظام
VPN: WireGuard، L2TP/IPsec، SSTP
يقوم SAMM بتشغيل خادم VPN خاص به على مضيف SAMM بحيث يمكن للراوترات في أي مكان — خلف NAT، أو عبر خط خلوي، أو في مدينة أخرى — الوصول إلى SAMM من أجل RADIUS والإدارة. كل شيء متاح تحت System → VPN؛ ولا حاجة لاستخدام shell. تأتي عمليات التثبيت الجديدة بجميع الخيارات الثلاثة جاهزة، ويكون كل منها معطلا حتى تقوم بتفعيله.
راوترات RouterOS 6 و 7، والأجهزة التي لا تدعم WireGuard.
SSTP
راوتران أو أكثر يتصلان بالإنترنت عبر نفس العنوان العام، على RouterOS 6 أو 7.
تبويب Server
بالنسبة لـ WireGuard، انقر على Generate Keys لإنشاء زوج مفاتيح الخادم.
تحقق من منفذ الاستماع، وعنوان نفق الخادم، ونطاق عناوين العميل، أو احتفظ بالقيم الافتراضية.
تشغيل الخادم. تظهر نافذة منبثقة لتأكيد كل تغيير.
إذا كان مضيف SAMM يمتلك عنوانا خاصا ويتم توجيه عنوانك العام إليه، فإن SAMM يكتشف العنوان العام (أو تقوم بكتابته مرة واحدة في صفحة VPN) ويزود به كل عميل وراوتر.
إضافة راوتر بعملية لصق واحدة
انقر على Add Client وقم بتسميته. بالنسبة لـ MikroTik، انسخ install link المكون من سطر واحد والصقه في الطرفية الخاصة بالراوتر: حيث يقوم بإعداد النفق، وبيانات تسجيل دخول SAMM الخاصة بالراوتر، وتكوين RADIUS، وصفحة المستخدمين المنتهية الصلاحية في خطوة واحدة. اختر كيفية إضافة SAMM للراوتر:
Managed NAS — يقوم الراوتر بمصادقة المستخدمين عبر SAMM، بينما يتولى SAMM إدارته.
مراقبة فقط — لنقاط الوصول والأجهزة الأخرى التي ترغب في مراقبتها (الحالة، الخريطة، صفحة Wireless) دون تسجيل دخول المستخدمين من خلالها.
ينتمي الراوتر الذي يضيفه موظفو الفرع إلى فرعهم. يمكن أيضاً إضافة عملاء WireGuard باستخدام ملف config أو رمز QR للتطبيق الخاص بالهاتف المحمول. يمكن إعادة تسمية العملاء، أو إيقاف تشغيلهم، أو حذفهم؛ ويوضح لونهم ما إذا كانوا متصلين، أو غير نشطين، أو لم يظهروا أبداً.
إعادة توليد المفاتيح عملية تدميرية
تؤدي عملية Regenerate Keys إلى تغيير زوج مفاتيح server الخاص بـ WireGuard. سيتوقف كل عميل تم إعداده مسبقاً عن الاتصال حتى يحصل على الإعدادات الجديدة. تطلب منك لوحة التحكم كتابة كلمة للتأكيد.
الشبكة & الراوترات
RouterOS 6 و 7
يدير SAMM راوترات RouterOS 6 و RouterOS 7 جنباً إلى جنب. لا يتطلب منك القيام بأي إجراء مختلف؛ حيث يقرأ SAMM إصدار كل راوتر ويرسل الأوامر التي يفهمها ذلك الإصدار.
كل شيء يعمل على كليهما: معالج الإعداد، والإكمال التلقائي، وتسليم الإعدادات، وإجراءات مدير الأجهزة،
والمواقع الإلكترونية & التطبيقات، و QoS، و NTP، وصفحة المستخدمين المنتهية صلاحيتهم، وروابط WireGuard (RouterOS 7) و L2TP/IPsec و SSTP. في RouterOS 6، يتم بناء قوائم المواقع الإلكترونية & التطبيقات من أسماء النطاقات في الكتالوج، لأن الإصدار 6 لا يحتوي على قوائم عناوين DNS.
راوترات قديمة لا تدعم WireGuard
لا يتوفر WireGuard في RouterOS 6. اربط هذه الراوترات عبر L2TP/IPsec أو SSTP.
الشبكة & الراوترات
تسليم الإعدادات
كل تغيير يرسله SAMM إلى أجهزة الراوتر الخاصة بك — RADIUS، وصفحة انتهاء الصلاحية، والمعالج، وفلتر DNS، وWebsites & Apps، وQoS، وAuto Security، وDNS، وNTP والرقابة الأبوية — يمثل عملية delivery واحدة يمكنك متابعتها عبر Devices → Config delivery.
شريط تقدم والنتيجة لكل راوتر، مع توضيح السبب الدقيق في حال رفض الراوتر للتغيير.
يتلقى الراوتر غير المتصل بالتغييرات بمجرد عودته للعمل؛ وتتم إعادة محاولة التغييرات الفاشلة تلقائياً، كما أن Retry يتم بنقرة واحدة.
يتم التحقق من كل تغيير على الراوتر بعد تطبيقه، ولا يتم ترك RADIUS و QoS فارغين أبداً أثناء إجراء التغيير.
الشبكة & الراوترات
إجراءات مدير الأجهزة على عدة راوترات
في Devices → Manager، حدد الراوترات وافتح
Actions لتنفيذ مهمة واحدة على جميع هذه الأجهزة: دفع Websites & Apps، دفع إعدادات RADIUS، إعداد صفحة المستخدمين المنتهية، Router Security، النسخ الاحتياطي والتصدير، تحديث RouterOS، تشغيل سكربت، أو إعادة التشغيل.
تبدأ كل نافذة حوار بأكثر الإعدادات اكتمالاً الموجودة بين الراوترات التي اخترتها. تعمل المهام في الخلفية: يمكنك مغادرة الصفحة، وسينبهك إشعار منبثق عند انتهاء كل راوتر أو سبب الفشل. تطلب الإجراءات الخطرة كتابة كلمة للتأكيد. يعرض مدير الأجهزة أيضاً فرع كل راوتر.
الشبكة & الراوترات
معزز السرعة الديناميكي
بينما يكون اتصال الإنترنت في الراوتر غير مستخدم، امنح المستخدمين سرعة أكبر مجاناً — واستعدها في اللحظة التي يصبح فيها الخط مشغولاً. قم بتفعيل هذه الميزة من Tools → Speed Boost → Dynamic (معطلة افتراضياً) واختر الباقات التي يمكن تعزيز سرعتها.
يحصل كل مستخدم متصل بهذا الراوتر على نفس مضاعف سرعة التنزيل الخاصة به، بحد أقصى 3 مرات بشكل افتراضي.
يتعرف المعزز على ساعات الذروة والخمول لكل راوتر (3 أيام افتراضيا، مع إعطاء وزن أكبر للأيام الأخيرة)، ويضع باقة كل 15 دقيقة، ويتوقع الساعة القادمة ويرفع مستوى التعزيز تدريجيا.
يقوم نظام حماية بالتحقق كل دقيقة وإنهاء الـ boost بمجرد عودة حركة المرور. الراوترات التي تكون مشغولة في معظم الأيام لا يتم تفعيل الـ boost لها أبداً.
يرى المستخدمون شارة Boosted في البوابة الخاصة بهم؛ وتحتوي قائمة المستخدمين على عمود وتصفية Boosted.
العمليات اليومية
التنشيطات & سجل البيانات
عمليات التنشيط
تظهر Overview → Activations الباقات الأكثر تفعيلاً هذا الأسبوع أو الشهر أو السنة أو بين تاريخين، مقارنة بالفترة السابقة: التجديدات، والمستخدمين الجدد، وتغييرات الباقات. وتوفر قائمتي By plan و By user ميزات البحث والتصفية والفرز والتصدير إلى Excel أو CSV.
سجل البيانات
Overview → Data Log يبحث في سجل البيانات لكل مستخدم في وقت واحد: ابحث عمن وصل إلى عنوان أو نطاق، أو منفذ، أو بروتوكول أو تطبيق، في أي فترة زمنية. تجميع النتائج، وحفظ طرق العرض وتصديرها إلى CSV أو XLSX. مدة الاحتفاظ بالسجل تعود لخيارك، ويتم ضبطها في History cleaner.
قبول السجل
يعرض سجل القبول (Accept Log) الراوتر الذي جاءت منه كل محاولة تسجيل دخول، مع إمكانية البحث والتجميع والفرز والتصدير حسب الراوتر.
النظام
الهوية البصرية: الشعار والاسم واللون
خصص SAMM ليعكس هوية شركتك. جميع الإعدادات موجودة في
System → Settings → ISP.
شعارك
اضغط على مربع الشعار أو رفع الشعار واختر صورة بصيغة PNG أو JPEG أو WebP أو GIF (بحجم يصل إلى 5 MB).
انقر على Use logo: يتم حفظه فوراً كمربع بمقاس 400×400 px. Remove لإزالته.
يستخدم الشعار في الفواتير، والإيصالات، وبطاقات hotspot المطبوعة، وصفحة انتهاء الصلاحية، وصفحات تسجيل الدخول التي تعرضها أجهزة الراوتر الخاصة بك.
تخصيص العلامة التجارية في لوحات التحكم
فعل Use my brand on the panels وحدد الاسم واللون وسطر التذييل (على سبيل المثال رقم الدعم الخاص بك)، ثم اضغط على Save في تبويب ISP. ستحل علامتك التجارية محل SAMM في لوحة التحكم وبوابة المستخدم وصفحتي تسجيل الدخول. قم بإيقاف تفعيلها ليعود كل شيء كما كان.
النظام
نفق Cloudflare
يقوم نفق Cloudflare Zero Trust بنشر SAMM على الإنترنت العام
دون فتح أي منافذ في جدار الحماية — وهو أمر مفيد عندما يكون مضيف SAMM خلف NAT. يتم إدارته من System → Cloudflare Tunnel.
حالة الخدمة
تفتح الصفحة على بطاقة حالة تعرض حالة الموصل:
الحالة
المعنى
قيد التشغيل
النفق نشط ويقوم بتمرير حركة المرور
متوقف
تم التكوين ولكن لا يعمل حاليا
غير مهيأ
الملف الثنائي موجود — لصق token لإعداده
غير مثبت
أعد تشغيل install.sh لتثبيت ملف cloudflared الثنائي
كما يعرض إصدارcloudflared وما إذا كان الموصل مضبوطاً على التشغيل التلقائي عند الإقلاع.
تكوين النفق
في لوحة المعلومات الخاصة بـ Cloudflare Zero Trust
(one.dash.cloudflare.com)، افتح Networks → Tunnels
واختر إنشاء نفق.
اختر موصل Cloudflared، وسمِّ النفق، ثم حفظ. في خطوة التثبيت، انسخ الرمز فقط — السلسلة الطويلة التي تلي --token.
الصقه في SAMM وانقر على Configure Tunnel. يقوم SAMM بتسليم الرمز إلى cloudflared وتشغيل الموصل.
بالعودة إلى Cloudflare، أضف اسم المضيف العام: العنوان الذي اخترته،
النوع HTTP، وURL localhost:80 (عبر nginx —
موصى به) أو localhost:8000 (مباشرة إلى API).
خلال ثوانٍ قليلة تتحول شارة الحالة إلى اللون الأخضر ويصبح SAMM متاحا عبر الاسم المضيف العام. بمجرد الإعداد، تتيح لك إجراءات النقرة الواحدة بدء أو إيقاف أو إعادة تشغيل الموصل، أو استبدال Token لتدويره، أو إزالة نفق (إجراء يتطلب كتابة REMOVE للتأكيد).
لا توجد منافذ مفتوحة، والرمز غير موجود في قاعدة البيانات
يقوم النفق بإنشاء اتصال صادر إلى edge الخاصة بـ Cloudflare — ولا يتم فتح أي منفذ في جدار الحماية على الخادم أبداً. يتم توجيه الـ token إلى cloudflared وتخزينه في /etc/cloudflared/؛ ولا يقوم SAMM بحفظه في قاعدة البيانات. تنتهي جلسة TLS عند edge الخاصة بـ Cloudflare، لذا يعمل SAMM نفسه ببروتوكول HTTP عادي على الـ loopback.
النظام
إعدادات
يحتوي System → Settings على الإعدادات القابلة للتعديل الفوري والتحميل السريع. تعيد الـ daemons قراءتها في الدورة التالية — لا حاجة لإعادة تشغيل الخدمة. يتم تنظيم الإعدادات في تبويبات.
إعدادات عامة قابلة للضبط
إعداد
الافتراضي
عناصر التحكم
samm-radius interval
30 s
معدل تكرار تقييم الأحداث المعتمدة على الوقت وإرسال CoAs
samm-worker interval
5 s
وتيرة ping للراوتر ومزامنة MikroTik API
فاصل المحاسبة المؤقت
60 s
فترة المحاسبة المرسلة إلى الراوترات
وقت إعادة الضبط اليومي
00:00
عند تصفير عدادات الاستخدام اليومي
المنطقة الزمنية للخادم
UTC
المنطقة الزمنية لنوافذ السرعة وإعادة الضبط اليومية
منفذ CoA الافتراضي
3799
منفذ UDP الافتراضي لحزم CoA
الحد الأقصى لإعادة محاولة CoA
3
عدد محاولات إعادة المحاولة قبل الانتقال إلى الاحتياطي Disconnect-Request
خفض فاصل samm-radius لفرض قيود أكثر صرامة، أو زيادته لتقليل الحمل.
هوية ISP، والشعار، والعملة & الفوترة (تبويب ISP)
كل ما يتساءل عنه معظم المشغلين "أين أقوم بتغيير هذا؟" موجود في
System → Settings → ISP. قم بتحرير الحقل وانقر على حفظ —
يتم تطبيق التغيير فوراً (بدون إعادة تشغيل) وينعكس على الفواتير، والإيصالات، وملفات PDF وبوابة العملاء.
الرفع، ثم السحب والتكبير لقص الصورة في المتصفح؛ تظهر في ملفات PDF للفواتير/الإيصالات، وبطاقات hotspot المطبوعة، وصفحات تسجيل الدخول إلى الراوتر. انظر Branding.
رمز العملة (e.g. USD)
عملة ISO في الفواتير ودفتر الأستاذ
رمز العملة (e.g. $)
كل مبلغ يظهر في واجهة الإدارة وبوابة العملاء وملفات PDF
تفعيل/تعطيل الضريبة، التسمية & النسبة
إضافة سطر VAT/GST إلى الفواتير (مثلا: التسمية VAT، المعدل 11 = 11%)
تغيير رمز العملة
لتغيير العملة المعروضة في جميع أنحاء النظام (على سبيل المثال من $ إلى £ أو رمز محلي)، حدد Currency symbol في تبويب ISP ثم حفظ — سيؤدي ذلك إلى تحديث لوحة التحكم وبوابة العميل وجميع ملفات PDF دفعة واحدة. حدد Currency code (USD, EUR, …) بجانبه لتعيين رمز ISO المطبوع على الفواتير.
الخصوصية — إحصائيات تثبيت مجهولة الهوية
عندما يتحقق SAMM من التحديثات، يمكنه إرسال معرف تثبيت عشوائي إلى SecuryTik، وإصدار SAMM، وفئة الباقة، والدولة بشكل تقريبي (من خلال IP، عبر Cloudflare) — دون أي بيانات للمشترك أو العميل. يساعدنا هذا فقط في حساب عمليات التثبيت النشطة وتحديد أولويات الدعم واللغات. يمكن إيقاف هذه الميزة في أي وقت عبر System → Settings → Privacy؛ راجع سياسة الخصوصية.
تبويب Email
تكوين خادم SMTP المستخدم لـ أكواد استعادة كلمة المرور المرسلة إلى المسؤولين والعملاء (المضيف، المنفذ، SSL/STARTTLS، اسم المستخدم، عنوان المرسل، كلمة المرور).
انقر على اختبار الاتصال للتحقق من بيانات الاعتماد دون إرسال بريد إلكتروني.
حسابا بريد إلكتروني
تبويب Email هنا مخصص فقط لـ OTP / استعادة كلمة المرور. أما الحساب المستخدم لـ إشعارات العملاء فيتم تكوينه بشكل منفصل في Notification Center.
النظام
أدوار المسؤولين والفروع &
System → Admins هو المكان الذي تحدد فيه من يمكنه تسجيل الدخول إلى بوابة المسؤول، والصلاحيات المتاحة لكل شخص، والمستخدمين الذين يمكنهم رؤيتهم. بدءا من الإصدار 5.1.0، يشكل المسؤولون شجرة من الفروع والموظفين. تحتوي الصفحة على تبويبين: Admins و Roles.
الفروع والموظفون
العقدة
تعريف الخدمة
فرع
مكان — مكتب أو مدينة. يتبع له المستخدمون الذين تم إنشاؤهم فيه. لا يمكن تسجيل الدخول بصفتك فرع: فليس له كلمة مرور ولا دور.
المسؤول (الموظفون)
الشخص الذي يقوم بتسجيل الدخول. عند تعيينه ضمن فرع، يصبح من موظفيه: كل مستخدم وبطاقة يقوم بإنشائها تتبع ذلك الفرع.
Superadmin
دائما في أعلى الشجرة، وليس تحت أي فرع. يرى ويمكنه القيام بكل شيء.
استخدم + Branch و + Admin لبناء الشجرة، واسحب عقدة فوق أخرى لنقلها. يمكن للفرع فقط أن يضم مسؤولين تحته. الوكيل هو مسؤول يبيع ويمتلك ما يبيعه؛ أما الموظفون التابعون لوكيل فيستخدمون محفظة الوكيل وقواعد الموافقة الخاصة به.
صلاحيات العرض
تتبع الرؤية هيكل الشجرة. يرى الفرع — وكل من يعمل فيه — المستخدمين التابعين له والمستخدمين في الفروع التي تقع تحته، ولا يمكنه رؤية فرع موازٍ أو الفرع الذي يعلوه.
يرى HQ كل شيء. لا تتجاوز صلاحيات المسؤول أبداً ما يسمح به المسؤولون الذين يعلون مرتبته، ولا يمكن للمسؤول منح صلاحيات لا يملكها هو نفسه.
الحدود لكل فرع
تحديد
ما يتم احتسابه
أقصى عدد من المستخدمين
عدد المستخدمين الذين يمكن أن يستوعبهم الفرع والفروع التابعة له. حذف المستخدم يوفر مساحة.
الحد الأقصى للبطاقات
كم عدد بطاقات hotspot التي يمكن طباعتها في الفرع.
يتم رفض أي مستخدم أو بطاقة جديدة عند الوصول إلى أي حد مساوٍ أو أعلى من حدود المسؤول الذي قام بإنشائها، وتوضح الرسالة الحد الذي تم الوصول إليه والمقدار المتبقي. اترك حقل الحد فارغاً لتعطيل الحد. يمكن تغيير كليهما لاحقاً من مربع حوار التعديل.
أجهزة الفرع
ينتمي كل راوتر، بما في ذلك نقاط الوصول، إلى فرع أو إلى Headquarters.
افتح قائمة الفرع واختر Assigned devices لتحديد الأجهزة التي تنتمي إليه؛
الجهاز الذي تلغي تحديده يعود إلى Headquarters، والتي يتشاركها كل فرع. الجهاز الذي يضيفه موظفو الفرع
(من مدير الأجهزة، أو نموذج المراقبة، أو رابط تثبيت VPN) يوضع في فرعهم؛ أما الجهاز الذي تضيفه
Headquarters فيبدأ في Headquarters.
من
جهاز الفرع
موظفو ذلك الفرع، والفروع التي تعلوه، والمقر الرئيسي
إدارة
موظفو الفروع التابعة لها
عرض، للقراءة فقط
فروع أخرى
لا يظهر
مستخدمو ذلك الفرع وفروعه التابعة
يمكن تسجيل الدخول من خلاله
تتبع الخريطة وصفحة Wireless وقوائم الحالة والراوتر القاعدة نفسها. جزء تسجيل الدخول هو الإعداد Users log in only through their branch's routers في Settings → Authentication: يكون مفعلًا في عمليات التثبيت الجديدة؛ أما في عمليات التثبيت المحدثة التي تم تسليم أجهزتها للفروع فيبدأ وهو معطل لضمان عدم انقطاع الاتصال عن أي شخص — قم بتفعيله عند تعيين أجهزتك. يمكن لمستخدمي General company استخدام أي راوتر.
مستلمو التنبيهات لكل فرع
تحتوي قائمة الفرع أيضاً على مستلمي التنبيهات: عناوين البريد الإلكتروني، وأرقام WhatsApp وSMS، ومحادثات Telegram، كل منها في سطر منفصل. عند تعطل جهاز في ذلك الفرع (أو في فرع تابع له)، أو حدوث خلل، أو صد هجوم، أو فقدان الإعدادات، يتم إخطارهم. ولا يزال المقر الرئيسي يتلقى كل تنبيه.
قوائم الأسعار
تحدد Financial → Price Lists (للمسؤول الخارق فقط) سعراً لكل باقة وإضافة لكل فرع. يتبع الفرع الفرعي أسعار الفرع الأب ما لم يتم تعيين أسعار خاصة به، بينما يبدأ الفرع الجديد بسعر بطاقة الباقة. يمكن تغيير عدة أسعار دفعة واحدة بنسبة مئوية أو بمبلغ ثابت مع التقريب؛ ويقوم Reset All بإعادة الفرع إلى أسعار الفرع الأب، كما يمكن تصدير القائمة للمراجعة.
الأدوار & الصلاحيات
يمنح الدور صلاحية الوصول لكل منطقة. يتضمن SAMM أربعة أدوار جاهزة يمكنك تعديلها أو حذفها — مدير الأجهزة (للعمليات اليومية)، وReseller، وAccountant (للشؤون المالية)، وMonitor (للقراءة فقط) — ودورين مدمجين مقفلين: superadmin (صلاحية كاملة) وAgent، الذي يحول المسؤول إلى موزع بالجملة برصيد مسبق الدفع وتقاسم للعمولة (راجع Accounting & billing → Agents).
لكل قسم في SAMM (المستخدمين، والباقات، والراوترات، والمحاسبة، والإعدادات، وما إلى ذلك) يتم تعيين دور بأحد ثلاثة مستويات:
المستوى
المعنى
غير مسموح
هذه المنطقة مخفية تماما من الشريط الجانبي
عرض
صلاحية القراءة فقط
تعديل
صلاحية وصول كاملة — إنشاء، تعديل، حذف
تظل Admins & roles و Tools و API و Payments تابعة لـ HQ بغض النظر عما يحدده الدور.
يوجد خياران بجانب مستويات المنطقة، لأن كل منهما يمثل قراراً مالياً وليس مجرد إعداد للشاشة:
يمين
الميزات المتاحة
السماح بـ "No Invoice"
تغيير خدمة المستخدم — تجديد، تغيير باقة، تمديد — دون فرض أي رسوم. معطل افتراضيا في كل دور جديد.
السماح بموافقة Agents
مراجعة والبت في طلبات الوكلاء لعكس الرسوم. تظل عملية إنشاء وإدارة الوكلاء مقتصرة على superadmin فقط. راجع Undo & approvals.
صلاحيات مفصلة
تحت Edit، تفتح أقسام Users و Cards و Financial و Routers صلاحيات فردية — على سبيل المثال حذف المستخدمين، التجديد، تغيير الباقة، دفع الفواتير، منح الخصومات، تشغيل سكربت الراوتر. قم بإيقاف أي منها لدور معين؛ حيث يتم إخفاء أزرار الصلاحيات التي لا يمتلكها هذا الدور.
مدة صلاحية الدور
منع الموظفين من منح خدمات لعدة أشهر. في كل دور:
إعداد
التأثير
أقصى عدد فترات مقدمًا
يمكن أن يكون تاريخ الانتهاء بحد أقصى هذا العدد من فترات الباقة من الآن — عند الإنشاء، التجديد، إضافة أيام، التعديل، والتغييرات الجماعية.
أقصى عدد أيام مقدمًا
نفس القيمة، محسوبة بالأيام.
يبدأ المستخدمون الجدد بـ (ساعات)
يحصل المستخدم الذي يتم إنشاؤه عبر هذا الدور على هذه المدة بالضبط (ساعتان مثلا) دون فاتورة؛ ويمكن لمن يملك صلاحية منح المزيد تمديدها لاحقا.
تعتبر إضافة أيام و كتابة تاريخ انتهاء صلاحيات منفصلة ضمن المستخدمين، لذا يمكن للدور التجديد دون القدرة على كتابة أي تاريخ يريده. اترك الحقل فارغاً لعدم وجود حد؛ أما superadmin فلا يخضع لأي قيود. يتخطى التغيير الجماعي المستخدمين الذين سيتجاوزون الحد المسموح به مع توضيح السبب.
يمكن أيضا السماح للدور بـ رؤية كل مستخدم & بطاقة في التثبيت،
بغض النظر عن الشجرة. وعند إيقاف هذا الخيار، يرى الدور فرعه والفروع التي تندرج تحته.
لوحة المعلومات متاحة دائماً
بغض النظر عن الصلاحيات الممنوعة لأي دور، يحتفظ كل مسؤول بلوحة المعلومات والملف الشخصي الخاص به —
فإن تسجيل الدخول الذي ينتهي بخطأ في الصلاحيات هو تسجيل دخول معطل، وليس آمناً.
الترخيص متاح دائماً
تعتبر صفحة System → License كتلة صلاحيات عادية —
لكن عندما يكون الجهاز في حالة lockdown (سواء كانت grace أو soft أو hard)، يفرض SAMM إمكانية الوصول إليها لكل المسؤولين المسجلين بغض النظر عن الدور، لضمان عدم إغلاق مسار الاستعادة أبداً.
النظام
أدوات
يجمع قسم Tools أدوات الصيانة والعمليات الجماعية. وبما أنه يعمل على كامل مجموعة البيانات، فهو متاح للمسؤولين الخارقين (superadmins) فقط.
نسخ احتياطي & استعادة
إنشاء لقطة كاملة لقاعدة البيانات قبل إجراء أي تغيير رئيسي. النسخة الاحتياطية عبارة عن أرشيف pg_dump مضغوط بصيغة gzipped ومخزن على الخادم، وكل منها يحتوي على ترويسة SAMM.
إنشاء نسخة احتياطية — إضافة ملاحظة اختيارياً؛ تفعيل Skip usage &
history للحصول على نسخة احتياطية أصغر وأسرع تستثني جداول السجلات الضخمة.
التنزيل نسخة احتياطية إلى جهاز PC الخاص بك، أو الرفع نسخة احتياطية سابقة من SAMM إلى الخادم.
تؤدي عملية Restore إلى استبدال قاعدة البيانات الحالية — ويتم ذلك عبر مربع حوار تأكيد من نوع RESTORE.
التوفر العالي
لضمان نشر لا يحتوي على نقطة فشل واحدة، قم بتشغيل SAMM عبر عقدتين:
PostgreSQL streaming replication (عقدة أساسية مع عقدة احتياطية ساخنة بتأخر ثوانٍ) بالإضافة إلى عقدة AAA احتياطية، مع الترقية وإعادة التوجيه عند الفشل. دليل التشغيل الكامل للمشغل — إعداد replication، والتبديل التلقائي المخطط له وغير المخطط له، والعودة للحالة الأصلية، ووضع synchronous-replication الاختياري، وقائمة التحقق من ما بعد التبديل التلقائي — يتوفر في docs/HA.md مع المصدر. لاحظ أن replication ليس نسخة احتياطية (عملية الحذف الخاطئة تتكرر فوراً)، لذا حافظ على استمرار النسخ الاحتياطية المجدولة المذكورة أعلاه أيضاً.
منظف السجل
حذف صفوف السجلات والتاريخ القديمة نهائيا لاستعادة مساحة قاعدة البيانات. اختر إعداد مسبق للاحتفاظ بالبيانات ثم أكد العملية. تقوم أداة التنظيف بحذف جلسات RADIUS المغلقة، وسجلات ما بعد المصادقة، وملخصات الاستخدام اليومي، وسجل الراوتر/المنفذ، وسجلات القيود، ومدخلات التدقيق المطبقة، وصفوف CoA المنتهية. وهي لا تمس الجلسات النشطة، أو الأوامر المجدولة، أو طلبات CoA المعلقة، أو إجمالي الاستخدام مدى الحياة غير القابل لإعادة الضبط.
قم بأخذ نسخة احتياطية أولاً
يقوم History Cleaner بالحذف نهائياً. يرجى إجراء نسخة احتياطية قبل عملية التنظيف في حال الرغبة في استعادة البيانات لاحقاً.
تصدير / استيراد
تصدير واستيراد جماعي لـ Users و Plans و NAS بصيغة .csv أو .xlsx. قم بتنزيل نموذج (الأعمدة الصحيحة مع صف عينة) أو لقطة من البيانات الحالية، ثم قم بتعبئتها وإعادة رفعها. يتم التحقق من كل صف وعرضه في شاشة معاينة — حيث تظهر الصفوف المكررة وغير الصالحة، ويمكنك اختيار تخطي المكررات أو تحديثها — قبل حفظ أي بيانات.
تغييرات جماعية
تطبيق تغيير واحد — المالك، أو تاريخ الانتهاء، أو الحالة، أو التجديد التلقائي، أو فترات باقة كاملة — على جميع المشتركين المطابقين لفلتر معين، في عملية واحدة. اختر التغيير، ثم أنشئ الفلتر (الحالة / الباقة / المالك / بحث)، وراجع القائمة المطابقة، ثم أكد.
خيار إضافة فترات الباقة كاملة هو خيار التجديد الجماعي: يحصل كل مشترك على هذا العدد من فترات باقته الخاصة، فمثلاً تضاف 7 أيام لباقة الـ 7 أيام لكل فترة، ويضاف شهر تقويمي للباقة الشهرية — وذلك في عملية واحدة، دون الحاجة لتقسيم القائمة حسب الباقة أولاً. يتم تخطي المشتركين الذين لا تحتوي باقاتهم على فترة انتهاء بدلاً من التخمين. يظل خيار إضافة أيام متاحاً عندما ترغب في إضافة عدد ثابت من الأيام دون إعادة ضبط العداد.
تعزيز السرعة
زيادة أو خفض سرعة جميع الباقات دفعة واحدة بنسبة مئوية —
عطلة نهاية أسبوع بسرعة مضاعفة، أو تقليل السرعة في حالات الطوارئ عند تدهور اتصال الـ backhaul.
يتم التطبيق فوراً، لعمليات تسجيل الدخول الجديدة وللجلسات المتصلة حالياً.
التحكم
الوظيفة
النسبة المئوية
القيم الموجبة تضاعف، والقيم السالبة تقلل: +100% ← ضعف السرعة، −100% ← نصف السرعة، −500% ← سدس السرعة. السرعة لا تصل أبداً إلى الصفر.
باقات التعزيز
حدد أي عدد من الباقات؛ يعرض كل صف سعر الباقة، والتعزيز المفعل، والسرعة الفعلية حاليا.
تراجع تلقائي بعد
عدد الساعات المتبقية حتى ينتهي الـ boost تلقائيا. القيمة 0 تبقيه مفعلا حتى يتم إعادة ضبطه يدويا.
تكون أولوية الـ boost أعلى من نافذة السرعة (speed window)
يتم قياس التعزيز بناء على معدل الباقة ويحل محل أي نافذة سرعة أثناء تفعيله — فالباقة التي تملك نافذة ليلية بسعة 20M لا تصبح 40M، بل تصبح القيمة التي يحددها التعزيز لمعدل باقتها. Windows تستأنف العمل في اللحظة التي ينتهي فيها التعزيز.
لا يتم استعادة السرعة الكاملة للمشترك الذي استنفد الحد عبر الـ boost. وللسبب نفسه، يتم تخطي الباقة المستخدمة كـ هدف للتقييد (throttle target) عند استخدام Select all ويتم تمييزها بذلك — لأن عمل boost لها سيزيد سرعة الأشخاص الذين تقوم بتقييدهم تحديداً. لا يزال بإمكانك تحديدها يدوياً إذا كان هذا هو قصدك. خيار Reset everything to normal يزيل كل الـ boosts ويعيد الجلسات النشطة إلى سرعة الباقة الخاصة بها.
حذف جماعي
حذف العديد من المشتركين أو بطاقات hotspot بشكل نهائي دفعة واحدة، بناء على التحديد عبر الفلتر.
يؤدي حذف المشترك أيضاً إلى إزالة سجل الاستخدام، والجلسات، ومحاسبة RADIUS، والفواتير، وفصل أي جلسة نشطة. تتم العملية عبر مربع حوار تأكيد من نوع DELETE.
النظام
اللغات & السمات
اللغات
بوابات المسؤول والعميل قابلة للترجمة بالكامل. تتوفر ثماني لغات مدمجة:
English, Arabic (من اليمين إلى اليسار)، Russian, Persian (من اليمين إلى اليسار)،
Turkish, French, Spanish و German. يختار كل مستخدم لغته من الشريط العلوي أو من ملفه الشخصي؛ ويتم حفظ هذا الخيار لكل حساب.
إيقاف تشغيل لغة
في System → Translations يوجد مفتاح تشغيل/إيقاف لكل لغة (للمسؤول superadmin فقط). اللغة التي يتم إيقافها لا يمكن لأي شخص اختيارها: تتوقف قوائم الاختيار عن عرضها، ويرى المستخدمون الذين اختاروها اللغة English، وتُكتب الرسائل الموجهة إليهم باللغة English. تظل اللغة English مفعلة دائماً. يبدأ التثبيت الجديد بجميع اللغات مفعلة.
محرر الترجمة
يمكن للمسؤول الخارق superadmin تعديل الترجمات مباشرة من
System → Translations — دون إعادة تشغيل أو تعديل ملفات.
كما يتيح المحرر إنشاء لغات جديدة كلياً واستيراد/تصدير دفاتر عمل الترجمة بصيغة .xlsx، بحيث يمكنك توطين SAMM إلى أي لغة تقدمها.
سمات
يتضمن SAMM 16 سمة بصرية، فاتحة وداكنة. يختار كل مستخدم سمة من الشريط العلوي؛ وتتحدث المعاينة فوراً ويتم حفظها لكل حساب. لا تُترجم المصطلحات التقنية، لذا تظل الشاشات التقنية دقيقة في كل لغة.
النظام
سجل التدقيق & النشاط
تجيب System → Audit Log على سؤال واحد: ماذا حدث، ومن قام بذلك. تضم قائمة واحدة كل تغيير أجراه المسؤول، وما قام به النظام تلقائيا (مثل انتهاء الصلاحية)، والتغييرات التي أجراها المستخدمون على حساباتهم في البوابة أو عبر Telegram — تغييرات الباقة، والتجديدات، والمدفوعات، وتعديلات الملف الشخصي وكلمة المرور.
عمود
ما يتم عرضه
عندما
الوقت، حسب منطقتك الزمنية
من
المسؤول، "ali, in the portal"، "ali, on Telegram"، أو رمز API، أو System
ماذا حدث
جملة واحدة، تحتوي فقط على الحقول التي تغيرت، القديم ← الجديد — على سبيل المثال "تعديل المستخدم: Expiry: 01 Oct ← 15 Oct"
التصفية حسب Who و Period، أو كتابة اسم في مربع البحث.
يتم إخفاء عمليات تسجيل الدخول والتصدير ما لم يتم تفعيل Show logins & exports. تتوفر Via و Action و Category و Severity و ID في أداة اختيار الأعمدة. حدد الصفوف لعمل Export أو Print — يحتوي الملف على نفس أعمدة الشاشة. يعرض زر ⓘ في الصف الجدول الكامل قبل وبعد التغيير.
السجل الزمني للمستخدم
افتح ملف مستخدم واختر Timeline لعرض كافة الأحداث التي تمت على هذا الحساب — إنشاء، تجديد، تغيير باقة، تعليق، الوصول إلى الحدود — مع الفواتير والمدفوعات ورسوم المحفظة والوكيل في عمود Amount. يمكنك التصفية حسب النوع أو الفترة، أو المبالغ المالية فقط، والتصدير إلى CSV أو Excel. لا يتم حذف صفوف Timeline أبداً وتظل موجودة حتى بعد حذف المستخدم.
سجل القبول وسجل الوصول
تعرض Overview → Accept Log كل محاولة تسجيل دخول أرسلتها الـ routers ورد RADIUS عليها، مع عرض الأحدث أولا، وسبب كل رفض. هذه هي الصفحة التي يجب فتحها عندما لا يستطيع المستخدم الاتصال. الرفض الذي يتكرر يظهر في سطر واحد مع عدد المرات.
تعرض Overview → Access Log الجلسات التي بدأت بالفعل، من خلال محاسبة RADIUS.
وكذلك طابور أوامر
يتم تسجيل عمليات إعادة الضبط وتغييرات الباقة والتجديدات المجدولة عبر CLI أو API في الجدول نفسه، وتقوم خدمة samm-radius بتطبيقها في الدورة التالية، ومن ثم تحديث الجلسة النشطة باستخدام CoA. تحسب شارة الشريط الجانبي العمليات التي لا تزال معلقة.
الترخيص
التراخيص والفئات &
كل تثبيت SAMM مرخص لكل جهاز — تخطط الباقة تعيش على ذلك التثبيت، لذا يمكنك تشغيل عدة خوادم SAMM، كل على مستواه الخاص. يحدد المستوى أربعة حدود رقمية.
المستوى
مستخدمو AAA
بطاقات Hotspot
NAS / راوترات
المُراقبة
غير مسجل
25
25
1
3
مجاني
100
50
2
6
Lite
500
1,500
4
12
Plus
1,000
3,000
6
18
Pro
2,000
6,000
12
36
Mega
5,000
15,000
24
72
Max
10,000
30,000
غير محدود
غير محدود
Unlimited
غير محدود
غير محدود
غير محدود
غير محدود
يعمل التثبيت الجديد بحالة غير مسجل عند الحد الأدنى. تتوفر كافة الميزات في جميع الفئات — حيث تحدد الفئة الحدود القصوى فقط. يتم حظر إنشاء مشترك أو بطاقة أو NAS يتجاوز الحد الأقصى حتى يتم الترقية؛ لا يتم فقدان أي بيانات على الإطلاق.
المُراقِبون هم نقاط الوصول والروابط التي يراقبها SAMM فقط. لديهم حصصهم الخاصة، ثلاثة لكل NAS، لذا فإن مراقبة نقطة وصول لا تستهلك أيًا من منافذ الراوتر.
تفعيل & ترقية
انتقل إلى System → License.
التفعيل عبر تسجيل الدخول بحساب SecuryTik الخاص بك — أو استخدام
ربط هذا الجهاز، والذي يظهر رمزاً تقوم بالموافقة عليه عبر
samm.securytik.com دون كتابة
كلمة المرور على الخادم. يتم تفعيل الجهاز على خطة Free.
للانتقال إلى مستوى أعلى، اختر باقة من الصفحة نفسها، أو اشترك من لوحة المعلومات. يتم مراجعة الطلب المقدم من الصفحة والموافقة عليه من قبل مسؤول SecuryTik.
تقوم صفحة الترخيص أيضاً بإعادة التحقق من الترخيص عند الطلب وعرض الاستخدام الحالي مقابل كل حد أقصى. يؤدي خيار Unlink device إلى إعادة التثبيت إلى الفئة غير المسجلة دون حذف أي بيانات.
في حال انتهاء صلاحية ترخيص مدفوع
لا يقوم SAMM بحذف البيانات أبداً. عند انتهاء صلاحية الترخيص، يتم خفض المستوى بسلاسة:
المرحلة
ماذا يحدث
تحذير
شريط تذكيري؛ يستمر تشغيل كافة الخدمات
فترة السماح
نافذة زمنية قصيرة لإعادة التنشيط؛ يبقى المشتركون متصلين بالإنترنت
إغلاق جزئي
تتوقف خدمات الخلفية؛ ويستمر RADIUS في إجراء المصادقة لمدة 7 أيام تقريباً
إغلاق تام
تتوقف الخدمات باستثناء صفحة إعادة التنشيط
إعادة التنشيط في أي مرحلة تعيد تشغيل كل خدمة تلقائياً — مع بقاء جميع بيانات المشتركين والسجل كما هي.
تحديثات تلقائية
التحديث التلقائي مستقل عن الترخيص — يتم التحديث في جميع الفئات، ولا يؤدي انتهاء صلاحية الترخيص إلى منعه أبداً. يقوم SAMM بالتحقق من وجود إصدار موقع جديد يومياً. من System → License يمكنك التبديل بين notify (الخيار الافتراضي — لافتة تحتوي على زر Apply now) و auto (تطبيق تلقائي). يتم التحقق من كل تحديث، وأخذ نسخة احتياطية منه، وتطبيقه في مكانه. يمكنك أيضاً إعادة تشغيل برنامج التثبيت في أي وقت — حيث يقوم بالترقية بشكل مستقل وآمن.
لمشتركيكم
بوابة العملاء والبوت &
يوفر SAMM لكل مشترك واجهتين للخدمة الذاتية — بوابة ويب وبوت Telegram — لتمكينهم من التحقق من الاستهلاك والدفع دون الحاجة للتواصل معك.
بوابة العميل
يسجل المشتركون الدخول في جذر موقع SAMM (/) باستخدام اسم المستخدم وكلمة المرور الخاصة بـ SAMM. تحتوي البوابة على:
صفحة
ما يراه المشترك
نظرة عامة
حالة الحساب، والباقة، وتاريخ الانتهاء، واستهلاك اليوم وهذا الشهر، وأي فاتورة مستحقة
استخدام & جلسات
إجمالي البيانات المحملة/المرفوعة، وميزانية وقت التشغيل، وسجل الجلسات الكامل
باقاتي
الباقة الحالية بالإضافة إلى قائمة الباقات المتاحة
فواتيري
سجل الفواتير مع إمكانية التنزيل بصيغة 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 خاملة حتى تقوم بإنشاء أول token، لذا فإن عملية التثبيت التي لا تستخدمها لا تكشف عن أي شيء. كل ما يلي متاح أيضاً كتوثيق OpenAPI تفاعلي — مع وحدة تحكم للتجربة ومخططات كاملة للطلب والاستجابة — في تثبيتك الخاص عبر المسار /api/v1/docs.
توثيق تفاعلي (Swagger UI)
توفر كل عملية تثبيت وحدة تحكم API مباشرة على /api/v1/docs —
يمكن الوصول إليها مباشرة من لوحة API في بوابة المسؤول. انقر على
Authorize، ثم قم بلصق token، ويمكن تنفيذ أي نقطة نهاية مقابل
بياناتك الخاصة باستخدام Try it out؛ حيث يعرض كل استدعاء الاستجابة الفعلية بالإضافة إلى
أمر curl جاهز للنسخ.
تعلن كل نقطة نهاية عن مخطط كامل ومحدد النوع — سواء لأجسام الطلبات أو الاستجابات — بحيث تكون أسماء الحقول وأنواعها وأمثلتها مرئية دون الحاجة لاستدعاء أي شيء. يتم تقديم المخطط نفسه كـ OpenAPI قابل للقراءة آلياً في /api/v1/openapi.json، والذي يقوم بتوليد عميل محدد النوع بالكامل بلغة اختيارك:
افتح System → API (للمسؤول الخارق فقط)، واضغط على
New token، ثم حدد اسماً وتاريخ انتهاء صلاحية، وقم بتفعيل الأذونات التي يتطلبها التكامل فقط (Read أو Write، سطر واحد لكل منطقة).
انسخ السر فورا — فهو يظهر مرة واحدة فقط، ويتم تخزين الـ hash الخاص به فقط على الخادم.
تحقق من عمله واطلع على الصلاحيات المتاحة للـ token:
يرسل كل طلب Authorization: Bearer <token>. يحمل الرمز (token) اسماً، وحد معدل لكل دقيقة، وتاريخ انتهاء (30–360 يوماً أو بدون تاريخ انتهاء)، ومجموعة من النطاقات (scopes) — وهي صلاحيات قراءة/كتابة لكل مورد؛ حيث يتضمن نطاق write تلقائياً نطاق read المقابل. يظهر السر (secret) مرة واحدة فقط؛ ويخزن الخادم قيمة الـ hash فقط. يمكن إلغاء الرمز (فتفشل الطلبات فوراً، وهي عملية قابلة للتراجع) أو حذفه نهائياً.
تتبع الاستجابات مجموعة واحدة من الاصطلاحات: تقبل نقاط النهاية الخاصة بالقوائم
limit/offset وتعيد {"total", "items"}؛
تستخدم الأخطاء رموز الحالة القياسية — 401 لرمز مميز مفقود/غير صالح/منتهي الصلاحية،
403 لنطاق مفقود، 404 لغير موجود، 409 لمكرر،
422 لخطأ في التحقق، و 429 عند حدوث زيارة تتجاوز حد المعدل
(مع ترويسات Retry-After و X-RateLimit-*).
تظهر المبالغ المالية في بيانات الدفع والمحفظة وwebhook كسلسلة نصية عشرية مثل "12.50"؛ وتكون الأوقات بصيغة ISO 8601 مع إزاحة التوقيت الخاصة بالتثبيت.
مرجع نقطة النهاية
القسم
نقاط النهاية
النطاق
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}
GET /plans · POST /plans · GET /plans/{plan_id} · PATCH /plans/{plan_id}
plans:readplans: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:readbilling: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:readbilling:write
Payment apps (collect)
GET /collect/lookup · POST /collect/payments · GET /collect/payments/{channel}/{reference}
collect:readcollect: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:readaddons: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:readcards:write
Sessions & CoA
GET /coa-outbox · GET /sessions · POST /coa-outbox/cancel · POST /coa-outbox/retry · POST /sessions/disconnect · POST /sessions/reconnect
coa:writesessions: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:readcustomers:write
Branches
GET /branches · PUT /customers/{customer_id}/branch
admins:writecustomers: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
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:writerouters: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:readbackups:write
History cleaner
POST /history/clean · GET /history/schedule · PUT /history/schedule · GET /history/space
history:readhistory: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:readvpn: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
GET /reports/activations · GET /reports/financial · POST /retention/lookup · GET /customers/{customer_id}/statement
accounting:readcustomers:readretention: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…) على نطاقات خاصة بها، collect:read و collect:write، وثلاث عمليات استدعاء: البحث عن مستخدم بواسطة اسم المستخدم (الاسم المقنع، المبلغ المستحق، الفواتير المفتوحة)، تسجيل عملية دفع، وقراءتها مرة أخرى. وتعتبر عملية الدفع مستقلة بمرجعها: حيث يؤدي إرسال نفس العملية مرة أخرى إلى إعادة الإجابة الأولى دون تسجيل أي شيء إضافي.
التغييرات التي تؤثر على حالة المحاسبة المباشرة — مثل إعادة تعيين الحدود، وتفعيل أو تعطيل البطاقات والمجموعات، وتمديد الصلاحية — لا يتم تطبيقها فورياً داخل الطلب، بل يتم إدراجها في قائمة أوامر المراجعة ليقوم samm-radius بتطبيقها خلال دورة واحدة (بضع ثوان)، تماماً كما يحدث عند النقر في بوابة المسؤول. ترد نقاط النهاية هذه بـ {"queued": true}؛ استخدم استطلاع GET /commands لمراقبة تحول حالة أوامر الرمز المميز الخاصة بك من قائمة الانتظار إلى applied.
Webhooks
سجل مسار URL لنقطة النهاية في System → API → Webhooks أو
عبر POST /webhooks، واختر الأحداث: أحداث فردية، أو مجموعة كاملة مثل
invoice.* (تتضمن الأحداث اللاحقة لتلك المجموعة) أو * للكل.
يظهر سر التوقيع في صفحة نقطة النهاية ويمكن تدويره.
تكون كل عملية تسليم بتنسيق JSON وتتضمن id و type و api_version و created_at و data. يكون id متطابقا لكل نقطة نهاية ولكل محاولة إعادة: عالج كل id مرة واحدة فقط. يجب الرد برمز 2xx خلال 10 ثوان؛ وأي استجابة أخرى يتم إعادة محاولتها مع تراجع زمني (backoff) لمدة ساعتين تقريبا، ويتم تعطيل نقطة النهاية التي تستمر في الفشل تلقائيا. يتم تسجيل كل عملية تسليم مع رمز HTTP الذي أعاده خادمك، ويمكن إعادة إرسالها.
تحقق من 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.created
A user account was created
customer.updated
A user account was updated
customer.renewed
A plan was renewed (expiration extended)
customer.plan_changed
A user moved to another plan
customer.expired
A user expired (expiration sweep)
customer.suspended
A user was suspended (by an admin or for not paying)
customer.restored
A suspended user was restored
customer.deleted
A user account was deleted
limit.exhausted
A usage limit was exhausted (quota / daily / uptime / expiration)
invoice.created
An invoice was created
invoice.updated
What an invoice owes changed (payment, discount, reversal, write-off)
invoice.paid
An invoice was marked paid
invoice.deleted
An invoice was deleted
payment.received
A payment was received and posted (online, payment app)
payment.reversed
A payment was voided or an invoice reopened
wallet.topup
Money was added to a user's prepaid wallet
addon.added
An add-on was given to or bought by a user
session.started
A user session started (off unless enabled in settings)
session.stopped
A user session stopped (off unless enabled in settings)
alert.opened
An alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolved
An alert cleared on its own or was resolved
webhook.test
Manual test event (sent from the test button)
تطبق نفس قواعد البوابة
تمر تعديلات API عبر نفس طابور الأوامر المدقق وطبقة الخدمات المستخدمة في بوابة الإدارة — إعادة التصفير أو تغيير الباقة عبر API يتصرف تماما مثل النقر في المنفذ، بما في ذلك 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. يتم وضع كل أمر في قائمة انتظار سجل التدقيق وتطبيقه عند 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.yaml
سلسلة اتصال قاعدة البيانات (DSN)، وأحجام مجمع الاتصالات (connection-pool)، ومستوى السجل
/etc/samm/api.env
أسرار جلسات Portal وإعدادات SMTP لاستعادة كلمة المرور
/etc/samm/secret.key
مفتاح التشفير لكلمات مرور API المخزنة في الراوتر
يتم الحفاظ على هذه الملفات أثناء التحديثات ولا يتم استبدالها أبداً عند إعادة تشغيل برنامج التثبيت. أما متغيرات التشغيل (تكرار الحلقات، وقت إعادة الضبط اليومي، منافذ CoA) فتوجد في الإعدادات بدلاً من ذلك، وتطبق دون الحاجة إلى إعادة التشغيل.
تحديث SAMM
إما السماح لـ SAMM بتحديث نفسه من System → License،
أو إعادة تشغيل برنامج التثبيت — راجع Installation →
Upgrading. كلا المسارين يعيدان تطبيق عمليات الترحيل وإعادة تشغيل الخدمات؛ مع بقاء الإعدادات والبيانات دون تغيير.
النسخ الاحتياطي & الاستعادة
استخدم Tools → Backup & Restore لأخذ لقطة كاملة لقاعدة البيانات قبل إجراء أي تغيير رئيسي. ولإعادة التثبيت على مضيف جديد، قم بتثبيت SAMM ثم استعادة النسخة الاحتياطية.
أدوات الصيانة (خارجية)
تعتبر بعض مهام الصيانة خطيرة لدرجة أنها لا تنتمي إلى لوحة التحكم، حيث يمكن لنقرة خاطئة أن تتسبب في توقف عمل قائم. لذا يبقيها SAMM كـ سكربتات مستقلة مخصصة للمسؤول فقط، تقوم بتنزيلها وتشغيلها عمداً من الـ shell — وليس كزر أبداً. وهي موجودة في مستودع التوزيع العام تحت المسار tools/.
إعادة تعيين كلمة مرور المسؤول في حال فقدان الوصول
هل فقدت الوصول إلى لوحة التحكم الخاصة بالمسؤول؟ قم بتعيين كلمة مرور جديدة لحساب superadmin مباشرة في قاعدة البيانات — دون الحاجة إلى تسجيل دخول فعال. كما تقوم هذه العملية بإعادة تفعيل الحساب إذا كان معطلاً، دون المساس بأي شيء آخر.
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. إذا كان هناك عدة superadmins، فاستخدم --user <name> لاختيار أحدهم.
إعادة ضبط السجلات (مسح البيانات المالية)
يمسح كافة المعاملات المالية لتمكين ISP من بدء المحاسبة من الصفر، مع الإبقاء على جميع بيانات المشتركين و AAA سليمة تماماً. مفيد عند استلام نظام قائم، أو بعد فترة تجريبية/اختبار، عندما تكون السجلات مليئة ببيانات يرغب المشغل في حذفها بينما يجب أن تبقى قاعدة العملاء كما هي تماماً.
خطر — فقدان بيانات غير قابل للاستردادسيؤدي هذا إلى حذف جميع الفواتير والمدفوعات والإيصالات وأرصدة المحفظة وسجل الدفاتر بشكل نهائي. لا يمكن التراجع عن هذه العملية، والسبيل الوحيد لاستعادة البيانات هو استخدام نسخة احتياطية لقاعدة البيانات. لا تقم بتشغيل هذا الأمر أبداً على بيئة إنتاجية لم يتم أخذ نسخة احتياطية لها والتحقق منها أولاً.
تمت الإزالة: الفواتير وبنودها، ودفتر الأستاذ مزدوج القيد
(المدفوعات، المقبوضات، التسويات، شحن المحفظة والسحوبات)، ومعاملات الدفع عبر الإنترنت، والمصاريف، والأصول الثابتة، وسجل النشاط المحاسبي. يتم إعادة تعيين ترقيم الفواتير، بحيث تبدأ الفاتورة التالية من #1.
محفوظ: كل مشترك، وباقة، ونافذة سرعة، وحد، وعداد استخدام،
وسجل باقة، وبطاقة hotspot، وراوتر، وجلسة، وسجل محاسبة RADIUS — بالإضافة إلى
إعدادات المحاسبة (شجرة الحسابات، وحسابات النقد، ومجموعات الضرائب، وبوابات الدفع). يتم اشتقاق أرصدة النقد والمحفظة والمستحقات من دفتر الأستاذ، لذا ستظهر ببساطة كصفر بعد ذلك.
تنزيله، وقراءته، ثم تشغيله. قم دائما بإجراء تشغيل تجريبي أولا:
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 للمتابعة. كما يعرض أخذ نسخة احتياطية من قاعدة بياناته أولاً (في /var/backups/samm/) ويتوقف إذا فشلت هذه العملية. تتم عملية المسح كمعاملة واحدة شاملة (إما تنفيذ كامل أو لا شيء)، ويظل RADIUS قيد التشغيل عمداً طوال الوقت، ليبقى المشتركون متصلين بينما زال السجلات.
المراجع
الأسئلة الشائعة & حل المشكلات
ما هي أنظمة التشغيل التي يوفر لها SAMM الدعم؟
Ubuntu 22.04 / 24.04 / 26.04 LTS و Debian 12 / 13. توزيعات Linux المخصصة للخوادم فقط — إصدارات desktop غير مدعومة. يتطلب برنامج التثبيت وجود systemd، وتثبيت PostgreSQL حديث (سيتم إعداد نسخة لك)، وصلاحيات root.
هل أحتاج إلى اتصال بالإنترنت لتشغيل SAMM؟
لا، يعمل SAMM بالكامل على خادمك الخاص ويقوم بمصادقة المشتركين محليا عبر RADIUS. حركة المرور الخارجية الوحيدة هي إرسال نبضات ترخيص دورية إلى خادم تراخيص SecuryTik لضمان بقاء باقتك مفعلة.
هل يمكنني تشغيل SAMM في السحابة، أم يجب أن يكون تثبيته محليا (on-prem)؟
كلا الخيارين متاحان. معظم المشغلين يقومون بتشغيله محلياً بجانب الراوترات الأساسية، بينما يقوم البعض بتشغيله على VM سحابية صغيرة مع نفق Cloudflare Zero Trust للربط. المتطلب الوحيد هو أن تتمكن راوترات MikroTik من الوصول إلى خادم SAMM عبر منافذ RADIUS (1812/1813 UDP)، وأن يتمكن SAMM من الوصول إلى الراوترات عبر MikroTik API.
هل يجب إعادة تشغيل FreeRADIUS عند إضافة أو إزالة راوتر؟
لا. يقوم SAMM بتحديد عملاء NAS ديناميكياً من قاعدة البيانات، لذا فإن إضافة أو تعديل أو إزالة راوتر في MikroTik → NAS يتم تطبيقه دون الحاجة إلى إعادة التشغيل.
ما مدى سرعة تفعيل تغيير الباقة أو إعادة ضبط العداد؟
توضع إجراءات المسؤول في قائمة انتظار وتطبقها خدمة samm-radius في الدورة التالية — خلال 30 ثانية افتراضيا. إذا كان المشترك متصلا، يقوم SAMM أيضا بإرسال CoA مباشر لتحديث الجلسة. يمكن خفض فاصل samm-radius في System → Settings لتوقيت أكثر دقة.
ماذا يحدث لبياناتي في حال انتهاء صلاحية ترخيص مدفوع؟
لا يتم حذف أي شيء على الإطلاق. يمر الترخيص المنتهي بمراحل تبدأ بالتحذير، ثم فترة السماح، ثم الإغلاق المرن (يستمر RADIUS في عملية المصادقة لمدة أسبوع تقريباً)، وأخيراً الإغلاق التام. إعادة التفعيل في أي مرحلة تعيد تشغيل كل خدمة مع بقاء جميع البيانات سليمة.
هل SAMM مجاني؟ وما الذي تضيفه نسخة Pro؟
باقة Free مجانية للأبد وتتضمن كافة الميزات. الباقات المدفوعة لا تفتح ميزات إضافية — بل ترفع الحدود القصوى لمستخدمي AAA وبطاقات hotspot، وتزيل الحد الأقصى لعدد الـ router. راجع Licensing & tiers.
تعذر مصادقة المشترك — من أين أبدأ؟
تأكد من تطابق RADIUS shared secret الخاص بالراوتر تماما مع سجل NAS،
ومن تفعيل PPP / Hotspot RADIUS في الراوتر، ومن أن حساب المشترك نشط وغير منتهي الصلاحية. راقب journalctl -u samm-api -f
وسجل FreeRADIUS، وتأكد من قدرة الراوتر على الوصول إلى مضيف SAMM عبر UDP
1812/1813.