SAMM التوثيق

البدء

التثبيت

يثبت SAMM كل ما يحتاجه — FreeRADIUS، وPostgreSQL، وnginx، وWireGuard، وcloudflared، وخدمات SAMM الخمس — في خطوة واحدة. المثبت متكرر آمن (idempotent): إعادة تشغيله ترقي تثبيتا قائما في مكانه ولا تستبدل إعداداتك أو تعيد توليد كلمة مرور قاعدة البيانات.

يتم تشغيل SAMM في أي مكان — اختر مسار التثبيت الذي يناسب شبكتك:

• الخيار أ / ب — خادم Linux مكشوف (موصى به للإنتاج): أمر واحد أو تثبيت يدوي على Ubuntu / دبيان.
• الخيار ج — Docker الإنشاء: نفس SAMM مثل الحاويات؛ متعدد القوس (amd64 + Arm64) لذا فهو يعمل على Ubuntu ، Windows Docker Desktop، Apple -Silicon Macs، في أي مكان.
• الخيار د — MikroTik RouterOS 7 حاوية: قم بلصق إنشاء YAML مباشرة في جهاز التوجيه الخاص بك. لا حاجة إلى صندوق Linux خارجي.

المتطلبات الأساسية

• خادم جديد: Ubuntu 22.04 LTS أو Ubuntu 24.04 LTS أو Debian 12. نسخ Linux الخاصة بالخوادم فقط — نسخ سطح المكتب غير مدعومة.
• صلاحية Root / sudo واتصال بالإنترنت.
• systemd، ومضيف يمكن تثبيت PostgreSQL عليه محليا (يتم إعداده لك).

الخيار أ — التثبيت بأمر واحد

على الخادم، نفذ:

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

يقوم سكربت التهيئة هذا بتنزيل أحدث حزمة إصدار SAMM من GitHub، ويستخرجها، ويشغل المثبت الكامل تلقائيا. يتم خلال دقائق قليلة.

الخيار ب — التثبيت يدويا من حزمة إصدار

نزل أحدث samm-<version>.tar.gz من صفحة إصدارات GitHub، ثم على الخادم:

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

يمكنك أيضا النشر من ملف zip تم إنشاؤه على جهاز آخر — يقوم المثبت بمزامنة المصدر عبر rsync إلى /opt/samm بنفسه:

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

أو استنسخ المستودع إلى /opt/samm ونفذ sudo bash /opt/samm/install.sh.

في كلتا الحالتين، بعد انتهاء التثبيت، افتح بوابة الإدارة وسجل الدخول بهذه البيانات:

غير كلمة مرور المدير فورا بعد أول تسجيل دخول.

الخيار ج — التثبيت باستخدام Docker الإنشاء

إذا كنت تفضل تشغيل SAMM كحاويات - نفس المنتج، ولكن معبأ بشكل مختلف - استخدم Docker توزيع الإنشاء على github.com/mhdhaidarah/samm-docker . على أي مضيف يتوفر به Docker :

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

يؤدي ذلك إلى تثبيت Docker إذا كان مفقودًا، ويسقط docker-compose.yml + .env إلى /opt/samm-docker/ ، ويبدأ المكدس. الصورة تم إنشاء mhdhaidarah/samm من نفس الحزمة المترجمة مثل تثبيت نظام التشغيل المجرد - مصدر مغلق حسب الإنشاء.

Multi-arch منذ الإصدار 2.2.6 — نفس العلامة تأتي لـ linux/amd64 و linux/arm64 . يختار docker pull المتغير الصحيح بشفافية، بحيث يكون مسار التثبيت متطابقًا على خادم Intel/AMD 64 بت، أو جهاز Apple -silicon Mac يعمل بنظام Docker Desktop، أو جهاز ARM MikroTik (RB5009، hAP ax²، CCR2004/2116/2216) باستخدام ميزة حاوية RouterOS 7.

على الأجهزة المضيفة حيث لا يُسمح بتوصيل الأنابيب curl إلى bash (المربعات المغلقة، سياسات الخروج الصارمة)، يمكنك جلب ملف الإنشاء الجاهز للتشغيل مباشرةً:

git clone https://github.com/mhdhaidarah/samm-docker.git
cd samm-docker
cp .env.example .env
$EDITOR .env       # set POSTGRES_PASSWORD and SAMM_PUBLIC_HOST
docker compose up -d

بعض الميزات ليست موجودة بعد في متغير Docker (تأمين الترخيص المرحلي، إعادة التحميل الديناميكي FreeRADIUS ). تم إخفاء صفحات إدارة WireGuard و Cloudflare النفق المضمنة عمدًا في المتغير Docker - فهي تدير خدمات systemd على مستوى المضيف التي لا يمكن الوصول إليها من داخل الحاوية. اختر الخيار A أو B أعلاه إذا كنت بحاجة إلى تلك المضمنة، أو قم بتشغيل cloudflared / wg-quick على المضيف Docker مباشرة بجانب SAMM . انظر الملف التمهيدي Docker الخاص بالمتغير للحصول على تحذيرات الإصدار 1 الكاملة ومسار التثبيت اليدوي.

على نظام التشغيل Windows (سطح المكتب Docker ) — تقييم فقط

تثبيت Docker سطح المكتب لنظام التشغيل Windows (يتيح له إعداد الواجهة الخلفية لـ WSL2 عند التشغيل لأول مرة). ثم من PowerShell - لا حاجة إلى محطة WSL - احصل على حزمة الإنشاء وابدأ المكدس:

mkdir C:\samm-docker
cd C:\samm-docker
curl.exe -fLO https://github.com/mhdhaidarah/samm-docker/releases/latest/download/docker-compose.yml
curl.exe -fLO https://github.com/mhdhaidarah/samm-docker/releases/latest/download/env.example
copy env.example .env
notepad .env       # set POSTGRES_PASSWORD and SAMM_PUBLIC_HOST (your Windows LAN IPv4)
docker compose pull
docker compose up -d

راقب إقلاع الحزمة في Docker Desktop → الحاويات — تتوسع مجموعة samm إلى 7 خدمات. بمجرد أن تصبح كلها خضراء، افتح بوابة الإدارة وسجل الدخول بهذه البيانات:

غير كلمة مرور المدير فورا بعد أول تسجيل دخول.

إذا كان NAS MikroTik حقيقيًا سيصل إلى مضيف Windows هذا لـ RADIUS، فاسمح بـ UDP 1812 + 1813 من خلال جدار حماية Windows:

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

هدم: إنشاء عامل الإرساء -v من دليل التثبيت (يمسح -v حجم postgres ومفتاح Fernet - قم بعمل نسخة احتياطية لهما أولاً إذا كنت قد أضفت بيانات).

الخيار د — التثبيت على جهاز توجيه MikroTik ( RouterOS 7)

مدعوم: الذراع64 MikroTik — RB5009، hAP ax²، CCR2004-1G-12S+2XS، CCR2116، CCR2216. وحدات SKU AMD64 — CCR2004-1G-2XS-PCIe (amd64)، x86 RouterOS ، CHR على برامج Hypervisor AMD64.
غير مدعوم: أجهزة Armv7 / mipsbe / smips / Tile / PPC (hEX، RB750، نماذج RB الأقدم) — لا يوجد دعم للحاوية أو ذاكرة الوصول العشوائي/وحدة المعالجة المركزية (RAM) قليلة جدًا لمكدس SAMM .

1. قم بإعداد جهاز التوجيه

قم بتثبيت حزمة الحاوية (من extra_packages.zip على mikrotik.com/download — قم بتحميل حاوية المطابقة-*.npk عبر الملفات، ثم أعد التشغيل). ثم قم بتمكين وضع الحاوية (مرة واحدة، يتطلب إعادة التشغيل):

/system device-mode update container=yes
# router reboots

2. تهيئة القرص وتثبيته (ext4)

أدخل محرك أقراص USB أو بطاقة microSD (يوصى بسعة ≥ 8 جيجابايت — Postgres + إضافة طبقات الصورة). على جهاز التوجيه:

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

بعد التهيئة، تحقق من تركيب القرص وقابليته للكتابة:

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

3. الصق إنشاء YAML في تطبيق الحاوية

في WebFig أو WinBox، افتح الحاوية → التطبيقات → + جديد → YAML . الصق ملف الإنشاء أدناه في حقل YAML، وقم بتعيين القرص الذي قمت بتنسيقه في الخطوة 2 كموقع تخزين، ثم أرسله. سيقوم RouterOS بسحب كل صورة وتوصيل الخدمات لك.

name: samm

services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - pgdata:/var/lib/postgresql/data

  samm-api:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["api"]
    environment:
      # SAMM_ROLE picks the daemon. Docker reads `command:` above; MikroTik's
      # container feature drops that field on YAML import, so we also pass
      # the role as an env var — every parser preserves environment blocks.
      SAMM_ROLE: api
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_HOST: 0.0.0.0
      SAMM_API_PORT: 8000
      SAMM_API_WORKERS: 2
    ports:
      - "8000:8000"
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm
      - sammlocales:/opt/samm/app/locales

  samm-radius:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["radius"]
    environment:
      SAMM_ROLE: radius
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-worker:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["worker"]
    environment:
      SAMM_ROLE: worker
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-notification:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["notification"]
    environment:
      SAMM_ROLE: notification
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-telegram:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["telegram"]
    environment:
      SAMM_ROLE: telegram
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

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

volumes:
  pgdata: {}
  etcsamm: {}
  sammvar: {}
  sammlogs: {}
  sammlocales: {}

قبل لصق ، استبدل كل سلسلة Change-me-strong-random-string بكلمة المرور العشوائية القوية SAME (≥ 24 حرفًا عشوائيًا) - تنتقل إلى Postgres عند البداية الأولى وتستخدمها كل خدمة SAMM للاتصال. قم بإنشاء واحد باستخدام مدير كلمات المرور أو قم بتشغيل pwgen 32 1 على أي مربع Linux .

4. تحقق من MikroTik واربطه بـ SAMM

بمجرد تشغيل الحاويات السبع جميعها، افتح بوابة الإدارة في المتصفح وسجل الدخول بهذه البيانات:

غير كلمة مرور المدير فورا. مصادقة RADIUS والمحاسبة معروضتان على UDP 1812 + 1813 على الموجه نفسه، لذا يمكن لعميل RADIUS في MikroTik الإشارة إلى 127.0.0.1 بالسر المشترك الذي تضبطه في النظام → RADIUS.

خيارات غير تفاعلية

يمكن الإجابة على جميع المطالبات مسبقا باستخدام متغيرات البيئة، حتى يمكن تشغيل المثبت دون تدخل:

DB_PASS='strong_pw'   sudo bash /opt/samm/install.sh
CF_TOKEN='eyJ...'     sudo bash /opt/samm/install.sh
SAMM_HTTP_PORT=8080   sudo bash /opt/samm/install.sh

ما الذي يقوم المثبت بإعداده

يعمل المثبت كعرض تقدم ملون مباشر — شريط نسبة مئوية وقائمة تحقق لكل مرحلة. يتم التقاط المخرجات الخام لكل مرحلة إلى /var/log/samm-install.log؛ وفي حالة الفشل تتم طباعة آخر 30 سطرا.

جميع بيانات الاعتماد — كلمة مرور قاعدة البيانات ومفاتيح توقيع الجلسة — تولد تلقائيا عند التثبيت الأول.

المطالبات التفاعلية

تظهر أي مطالبات في البداية، قبل بدء التثبيت:

• رمز Cloudflare — الصق رمز موصل Zero Trust لنشر SAMM عبر الإنترنت دون منافذ مفتوحة، أو اضغط Enter للتخطي وإعداده لاحقا.
• منفذ HTTP — إذا كان المنفذ 80 مستخدما، فإن المثبت يترك تلك المواقع دون تغيير ويطلب منفذا بديلا (الافتراضي 8080).

ملخص التثبيت

عند انتهاء المثبت يطبع ملخصا يتضمن رابط المسؤول، وبيانات تسجيل الدخول الافتراضية، ومنفذ 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

تعيد إعادة التشغيل مزامنة المصدر، وترقي البيئة الافتراضية، وتعيد تطبيق جميع الترحيلات، وتعيد تحميل إعدادات FreeRADIUS وnginx، وتعيد تشغيل كل خدمة. ملفات الإعداد ومنفذ HTTP الذي تم اختياره عند التثبيت الأول يتم الحفاظ عليها.

البدء

الخطوات الأولى

خمس مهام قصيرة تنقل تثبيتا جديدا إلى نقطة يمكن فيها للمشتركين الاتصال وإصدار فواتيرهم.

1 · أول تسجيل دخول

1. افتح http://<your-server>/admin/ (استخدم منفذ HTTP من ملخص التثبيت إذا لم يكن 80)، أو رابط نفق Cloudflare الخاص بك.
2. سجل الدخول بـ admin / admin.
3. غير كلمة المرور فورا من النظام ← المسؤولون، أو من قائمة الملف الشخصي في الشريط العلوي.

2 · أضف أول راوتر

1. اذهب إلى MikroTik ← NAS وانقر على إضافة راوتر.
2. أدخل IP الراوتر، واسما مختصرا، وسرا مشتركا لـ RADIUS. لأجهزة MikroTik، يمكنك اختياريا إضافة بيانات اعتماد API للمزامنة المباشرة للجهاز.
3. على MikroTik، أضف خادم RADIUS يشير إلى مضيف SAMM (المنافذ 1812/1813) بـ نفس السر المشترك، وفعل RADIUS لـ PPP / Hotspot.

لا حاجة لإعادة تشغيل FreeRADIUS — يحل SAMM عملاء NAS ديناميكيا من قاعدة البيانات. راجع الراوترات (NAS) للإجراء الكامل، أو دع معالج الإعداد يهيئ MikroTik لك.

3 · أنشئ باقة

تحدد الباقة السرعة والحدود والسعر الذي تبيعه. اذهب إلى المستخدمون ← الباقات ← باقة جديدة. مرجع كامل للحقول: الباقات & الحدود.

4 · أضف مشتركا

اذهب إلى المستخدمون ← عميل جديد، واملأ بيانات تسجيل الدخول واختر باقة. يمكن للمشترك الاتصال فورا. للوصول المدفوع مسبقا إلى Hotspot، أنشئ بطاقات قسائم بدلا من ذلك.

5 · فعل ترخيصك

يعمل التثبيت الجديد غير مسجل على باقة الحد الأدنى. افتح النظام ← الترخيص وفعله لرفع الحدود — راجع الترخيص & الباقات.

المشتركون & الباقات

الباقات & الحدود

الباقة هي تعريف الخدمة المخصصة للمشتركين — تحدد السرعة والحدود والسعر. أنشئ الباقات قبل إضافة المستخدمين.

إنشاء باقة

1. اذهب إلى المستخدمون ← الباقات.
2. انقر على باقة جديدة.
3. املأ النموذج وانقر على حفظ الباقة.

كل حد هو مفتاح تبديل — فعل فقط ما تحتاجه. تستخدم النافذة المنبثقة نفسها لتعديل باقة قائمة (افتح قائمة ⋮ للصف ← تعديل).

حقول الباقة

الحدود الأربعة

كل حد مستقل واختياري. عند ضبط عدة حدود، يتحقق SAMM منها بـ ترتيب ثابت — الانتهاء ← الحصة ← زمن التشغيل ← اليومي — وأول حد يستنفد يحدد الإجراء.

لكل حد تختار ما يحدث عند الاستنفاد: اختر باقة تالية للتبديل إليها للمشترك، أو اتركها كـ — قطع الاتصال —. بالنسبة للحد اليومي تعمل الباقة التالية كتخفيف — يعود المشترك إلى الباقة الأصلية في الإعادة اليومية التالية تلقائيا.

نوافذ السرعة

نافذة السرعة تتجاوز السرعة الأساسية للباقة لساعات محددة — على سبيل المثال نافذة سرعة غير محدودة بعد منتصف الليل. انقر على صف الباقة لفتح محرر نوافذ السرعة الخاص بها، الذي يضيف التحكم بأيام الأسبوع ويدعم النوافذ التي تتخطى منتصف الليل. عند تطابق عدة نوافذ، تفوز النافذة الأعلى سرعة.

مفهومان للاستخدام

يحتفظ SAMM بالاستخدام في مكانين، ولا يخلط بينهما أبدا:

• عدادات قابلة للإعادة — حالة كل حد. تصفر بإعادة من المسؤول وبالإعادة اليومية.
• عدادات الفوترة — إجماليات مدى الحياة غير قابلة للإعادة. لا تصفر أبدا، حتى تبقى التقارير والفواتير دقيقة.

إدارة الباقات

تعرض قائمة الباقات سرعة كل باقة، وعدد المشتركين، والحدود النشطة، ونوافذ السرعة. من قائمة ⋮ للصف يمكنك التعديل، أو فتح نوافذ السرعة الخاصة بها، أو تفعيلها/تعطيلها، أو الانتقال إلى مشتركيها، أو حذفها (فقط عندما لا يكون لها مشتركون). تعديل التجديد التلقائي يعرض تعميم التغيير على جميع المشتركين الحاليين.

المشتركون & الباقات

المشتركون

المشترك (العميل / المستخدم) هو حساب PPPoE أو Hotspot يقوم بالمصادقة عبر SAMM. يخصص لكل مشترك باقة واحدة بالضبط.

إنشاء مشترك

1. اذهب إلى المستخدمون وانقر على عميل جديد.
2. أكمل النموذج واحفظ — يمكن للمشترك الاتصال فورا.

قائمة المشتركين

تسرد صفحة المستخدمين كل مشترك مع نقطة حالة سريعة الفهم، والباقة المعينة، وكم تبقى من كل حد — الاستخدام اليومي مع شريط تقدم، والحصة المتبقية، وزمن التشغيل المتبقي، والأيام المتبقية. صف حسب الحالة (الكل / نشط / موقوف / منته / متصل) أو ابحث باسم المستخدم أو الاسم أو رقم الجوال.

إدارة المشترك

انقر بزر الفأرة الأيمن على صف — أو استخدم قائمة ⋮ — لكل إجراء خاص بالمشترك:

عرض الاستخدام

يفتح إجراء الاستخدام صفحة حركة بيانات مفصلة لمشترك واحد، مع محدد فترات 7 / 14 / 30 / 90 يوما. يظهر ثلاثة أرقام رئيسية — حركة اليوم (مع تقسيم الرفع/التنزيل ودقائق الاتصال)، وحركة هذا الشهر، وزمن الاتصال التراكمي للشهر. أسفلها رسم بياني يومي لحركة البيانات للرفع مقابل التنزيل، وجدول كامل لسجل الجلسات: وقت البدء والإنهاء، والمدة، والبايتات المنزلة والمرفوعة، وجهاز NAS، وسبب إنهاء كل جلسة.

العمليات الجماعية

لتغيير المالك أو الانتهاء أو الحالة أو التجديد التلقائي لعدة مشتركين دفعة واحدة — أو لحذف الكثير — استخدم أدوات التغييرات الجماعية والحذف الجماعي. لإنشاء مشتركين بالجملة من جدول بيانات، استخدم التصدير / الاستيراد.

المشتركون & الباقات

بطاقات Hotspot

للوصول المدفوع مسبقا إلى Hotspot، أنشئ دفعة من بطاقات القسائم بدلا من المشتركين الأفراد. كل بطاقة هي زوج من اسم مستخدم/كلمة مرور بسرعتها وحدودها الخاصة، تولد بالآلاف وتطبع للتوزيع.

إنشاء مجموعة بطاقات

1. اذهب إلى المستخدمون ← بطاقات Hotspot وانقر على مجموعة جديدة.
2. املأ النموذج أدناه وانقر على إنشاء مجموعة — يولد SAMM بيانات اعتماد كل بطاقة تلقائيا.

يحتسب الانتهاء من أول تسجيل دخول لكل بطاقة، بينما صالح حتى هو تاريخ نهائي صارم — لا يمكن استخدام البطاقات بعده، سواء تم تفعيلها أم لا.

حالات البطاقة

الطباعة & التتبع

افتح مجموعة لرؤية بطاقاتها، واطبعها كملف PDF للتوزيع (يستخدم تخطيط الطباعة شعار مزود الخدمة الخاص بك من الإعدادات)، وراجع استخدام كل بطاقة. تظهر حركة بيانات البطاقات أيضا في التقارير ضمن علامة تبويب البطاقات، ولكل مجموعة عرض محاسبي خاص بها.

الشبكة & الراوترات

الراوترات (NAS)

NAS (Network Access Server) هو راوتر يصادق المشتركين عبر SAMM عبر RADIUS. كل راوتر يحمل حركة بيانات المشتركين يحتاج إلى سجل NAS.

إضافة راوتر

1. اذهب إلى MikroTik ← NAS وانقر على إضافة راوتر.
2. املأ الحقول أدناه واحفظ.

قائمة NAS

يظهر كل راوتر في جدول واحد — المعرف، وIP / اسم مضيف NAS، والاسم المختصر، والنوع، وسر مقنع (انقر على الخلية لإظهاره)، ومنفذا CoA وAPI، ونتيجة ping مباشرة مع زمن الذهاب والإياب. يصف مربع البحث حسب IP أو الاسم المختصر أو الوصف.

تحمل قائمة ⋮ لكل صف إجراءات خاصة بالراوتر — عرض الجهاز و تحديث المعلومات (MikroTik فقط)، وتعديل، ودفع إعدادات RADIUS (MikroTik فقط)، وحذف. فتح صف من نوع mikrotik ينتقل مباشرة إلى صفحة جهازه.

اكتشاف الجيران

انقر على اكتشاف الجيران لفحص أجهزة MikroTik على الشبكة وإضافتها كسجلات NAS دون كتابة كل عنوان يدويا.

دفع إعدادات RADIUS إلى الراوتر

بالنسبة لسجلات MikroTik NAS، تقدم قائمة ⋮ للصف دفع إعدادات RADIUS — يقوم SAMM بتهيئة الراوتر لك عبر API بدلا من أن تكتبها يدويا. تؤكد IP خادم SAMM (يجب أن يكون قابلا للوصول من الراوتر) ومنافذ المصادقة والمحاسبة وCoA؛ ثم ينشئ SAMM أو يستبدل إدخال RADIUS على الراوتر:

يعرض الحوار سجل نتائج عند انتهاء عملية الدفع.

إعداد جانب MikroTik

إذا قمت بإعداد الراوتر يدويا بدلا من ذلك:

• أضف خادم RADIUS يشير إلى مضيف SAMM، بـ نفس السر المشترك، مفعلا لـ PPP / Hotspot.
• استخدم منفذ المصادقة 1812، ومنفذ المحاسبة 1813.
• اقبل CoA الواردة على المنفذ 3799.
• اضبط فاصل Interim-Update للمحاسبة على نحو 60 ثانية — هذه هي الوتيرة التي يجمع بها SAMM الاستخدام ويقيم الحدود.

أجهزة للمراقبة فقط

الراوتر الذي يضاف كـ مراقبة يظهر في مخزون MikroTik ويتم فحصه ومزامنته، لكن ليس له دور RADIUS — لا يستطيع مصادقة المشتركين. استخدمه لمراقبة الراوترات التي ليست NAS للمشتركين.

الشبكة & الراوترات

مدير MikroTik

عندما يكون للراوتر بيانات اعتماد API، يديره SAMM مباشرة عبر MikroTik API — بدون WinBox، وبدون SSH. قسم MikroTik هو مخزون مباشر لكل راوتر، وكل جهاز يفتح صفحة تفاصيل بها خمس عشرة علامة تبويب تهيئ تقريبا كل جزء من RouterOS من متصفحك.

مراقب MikroTik

يعرض MikroTik ← المراقب بطاقة واحدة لكل راوتر، مرتبة كشبكة. تظهر كل بطاقة — يتم تحديثها من قبل samm-worker وتستفسر مباشرة كل 30 ثانية — نقطة قابلية الوصول، وإصدار RouterOS، وحمل المعالج وعدد النوى، واستخدام الذاكرة، وعدد الجلسات النشطة، وزمن التشغيل، ووقت آخر عينة.

توسم البطاقة إما NAS (راوتر يصادق أيضا المشتركين عبر RADIUS) أو مراقبة (جهاز أضيف للمراقبة فقط). إضافة MikroTik تسجل جهازا جديدا؛ وتحديث الآن يفرض استفسارا فوريا. تحمل بطاقات المراقبة فقط قائمة بالنقر بالزر الأيمن — فتح، تعديل، تحديث المعلومات، حذف.

صفحة الجهاز — ست عشرة علامة تبويب

افتح أي جهاز للحصول على صفحة إدارته الكاملة. تنقسم علامات التبويب إلى أربع مجموعات.

المراقبة

المدير

علامة التبويب المدير ← عام هي صفحة الصيانة للجهاز: الهوية (اسم الراوتر)، والوقت (الساعة، والمنطقة الزمنية وNTP)، والأدوات (إعادة التشغيل، وping، وإجراءات أخرى للراوتر بنقرة واحدة).

إعداد الشبكة

الخدمات & الصيانة

فاصل التحديث المرحلي (Interim-Update) لـ PPPoE

في تبويب PPPoE، يحدد التحديث المرحلي (Interim update) عدد المرات التي يرسل فيها الراوتر حزم RADIUS accounting Interim-Update إلى SAMM. يستخدم SAMM هذه الحزم لتجميع عدادات البايتات ووقت التشغيل وتقييم حدود الحصة (Quota) والحدود اليومية وحدود وقت التشغيل — بدونها، يتوقف فرض الحدود وعدادات الجلسات المباشرة عن العمل. القيمة الموصى بها هي 5m.

صفحة تسجيل الدخول إلى Hotspot

من تبويب Hotspot يمكنك إدارة صفحة تسجيل الدخول الخاصة بالـ captive-portal: الإبقاء على صفحات MikroTik الافتراضية، أو تطبيق أحد القوالب الجاهزة، أو تطبيق أحد تصاميمك المحفوظة. يتضمن SAMM محرر تصميم مرئيا ومعرض قوالب — خصص صفحة تسجيل الدخول وادفعها مباشرة إلى Hotspot الراوتر.

QoS واع بالتطبيقات

علامة التبويب QoS تحول التطبيقات والمواقع التي يراها SAMM أصلا على الراوتر إلى خطة أولوية تنزيل. اسحب كل تطبيق من المجمع إلى إحدى خانات الأولوية الثماني — الخانة 1 تخدم أولا عند الازدحام، والخانة 8 أخيرا؛ والتطبيقات المتروكة في المجمع لا يجري تشكيلها. اختياريا حد سرعة تنزيل أي تطبيق (على سبيل المثال 10M) وعين سقف تنزيل إجماليا تتنافس عليه الأولوية. التوزيع التلقائي حسب الفئة يرتب كل شيء بنقرة واحدة — المراسلة والمؤتمرات أولا، والتنزيلات الضخمة واختبارات السرعة أخيرا.

عند الدفع، يجمع SAMM الخانات في شجرة طوابير على MikroTik (موسومة بـ SAMM:qos، parent=global) مع قواعد جدار حماية مطابقة لعلامات الرزم، الأعلى أولوية أولا. وهي مبنية على نفس كتالوج Websites & App filter الذي يشغل المراقبة، لذا لا تظهر إلا التطبيقات التي شوهدت فعلا على الراوتر — وإزالة SAMM QoS تجرد الراوتر من كل كائن SAMM:qos، مع ترك عداداتك دون مساس.

معالج الإعداد

يجمع تبويب المعالج (Wizard) كل شيء في تسع خطوات قصيرة، ثم يدفع الإعدادات الكاملة إلى الراوتر دفعة واحدة في النهاية. لا يرسل أي شيء قبل تأكيدك في خطوة المراجعة النهائية.

1. الترحيب والاكتشاف (Welcome & detect) — يفحص SAMM الراوتر ويعرض ما هو معد مسبقا، بحيث يمكنك تخطي تلك العناصر عند الدفع.
2. واجهة الـ Bridge — أعط اسما لـ bridge شبكة LAN.
3. منافذ الـ Bridge — اختر الواجهات الفيزيائية التي ستنضم إلى الـ bridge.
4. DNS — حدد الـ resolvers الأعلى (إعدادات جاهزة بنقرة واحدة لـ Google وCloudflare وQuad9 وغيرها)، وحجم الـ cache، واختياريا فلتر محتوى DNS.
5. الإنترنت — أضف وصلة WAN واحدة أو أكثر (Static / DHCP / PPPoE).
6. RADIUS إلى SAMM — وجه الراوتر إلى مضيف SAMM لديك للمصادقة (Authentication) والمحاسبة (Accounting) وCoA.
7. الخدمات — اختر ما إذا كان المعالج سينشئ خادم PPPoE أو خادم Hotspot أو كليهما.
8. تفاصيل PPPoE / Hotspot وجدار الحماية — الـ pools والـ profiles وأوقات الإيجار (lease)، إضافة إلى قواعد الـ firewall وNAT.
9. المراجعة والدفع — اطلع على القائمة الدقيقة للأوامر التي سترسل، ثم ادفعها جميعها إلى الراوتر.

الشبكة & الراوترات

CoA & التغييرات الفورية

CoA (Change-of-Authorization) هو الأسلوب الذي يغير به SAMM جلسة المشترك أثناء اتصاله — لرفع سرعته أو خفضها، أو لقطع اتصاله — دون انتظار إعادة اتصاله.

كيف يصل التغيير إلى مشترك متصل حاليا

لا يدفع SAMM أبدا تغييرا للراوتر مباشرة بنقرة زر. يتبع كل إجراء إداري مسارا آمنا واحدا:

1. يسجل الإجراء في سجل التدقيق (Audit Log) كأمر في الطابور.
2. تفرغ خدمة samm-radius الطابور في نبضتها التالية، وتطبق التغيير، و — إذا كان المشترك متصلا — تضيف CoA إلى الطابور.
3. يفرغ صندوق صادر CoA وترسل الحزمة إلى الراوتر.

الأحداث المعتمدة على الوقت — انتهاء الصلاحية، وحدود نوافذ السرعة، وعمليات إعادة التعيين اليومية — تغذي الصندوق نفسه. الحد الأقصى للتأخير هو نبضة samm-radius واحدة (30 ثانية افتراضيا؛ خفضها من الإعدادات لفرض أكثر صرامة).

CoA الهجين

يرسل SAMM أولا CoA-Update لتغيير الجلسة في مكانها. إذا رفضها الراوتر بعد عدد المحاولات المعد، يتراجع SAMM تلقائيا إلى Disconnect-Request — يعيد المشترك الاتصال ويلتقط الإعدادات الجديدة. تعمل هذه الاستراتيجية الهجينة عبر كل إصدارات firmware MikroTik.

صفحة صندوق صادر CoA

المستخدمون → صندوق صادر CoA هو العرض المباشر لذلك الطابور. samm-radius هو المرسل الوحيد — لا تدفع لوحة الإدارة CoA مباشرة أبدا — ويفرغ الطابور في كل نبضة. تحدث الصفحة تلقائيا كل 30 ثانية.

تتصدر الصفحة ستة عدادات — قيد الانتظار، مرسل، NACK (إعادة المحاولة)، تم، فشل والمجموع. صف الجدول حسب الحالة، أو حسب الإجراء (update أو disconnect)، أو ابحث باسم المستخدم أو IP الـ NAS أو السبب.

يعرض كل صف المستخدم، والراوتر، والإجراء، وعدد المحاولات، والسبب، وأوقات الإنشاء والإرسال. تتيح لك إجراءات كل صف إعادة المحاولة لحزمة فشلت أو رفضت بـ nack، أو إلغاء حزمة لا تزال جارية، أو فتح الخصائص (Attributes) لفحص خصائص RADIUS الدقيقة التي تحملها الحزمة. تعد شارة الشريط الجانبي الصفوف قيد الانتظار، وتتتبع لوحة المعلومات حالات الفشل خلال 24 ساعة. النظام السليم يبقي هذا الطابور شبه فارغ.

العمليات اليومية

لوحة المعلومات & الجلسات المباشرة

الشاشتان ضمن نظرة عامة هما نقطة بداية كل دوام عمل — لوحة المعلومات لصحة النظام بأكمله، والجلسات المباشرة لمعرفة من المتصل تحديدا الآن.

لوحة التحكم

نظرة عامة → لوحة المعلومات هي الشاشة الرئيسية للمشغل. يضبط محدد الفترة في الأعلى — اليوم، 7 أيام، 14 يوما، 30 يوما، 90 يوما — نافذة مخطط الاتجاه والأرقام المحددة بتاريخ.

بطاقات مؤشرات الأداء الست (KPI)

كل بطاقة هي عداد مباشر واختصار — انقرها للانتقال مباشرة إلى القائمة المصفاة وراء الرقم.

مخطط المستخدمين & الجلسات المباشرة

مخطط خطي يومي يرسم ثلاث سلاسل عبر الفترة المختارة — المستخدمون النشطون، والجلسات المتصلة، والمستخدمون منتهو الصلاحية — بحيث يصبح النمو والتسرب مرئيين بنظرة واحدة.

صحة خط المعالجة (Pipeline)

هذه اللوحة هي نبض محرك فرض السياسات. في نظام سليم تكون الطوابير عند الصفر أو قريبا منه — أي رقم يبقى مرتفعا يشير إلى خدمة عالقة أو راوتر يرفض التغييرات.

جداول النشاط الأخير

أربعة جداول تحت المخطط تعطي عرضا متجددا لما حدث للتو، ولكل منها رابط عرض الكل إلى صفحته الكاملة:

• صندوق صادر CoA الأخير — الإجراء، المستخدم، الحالة (تم / قيد الانتظار / nack / فشل)، عدد المحاولات، السبب، والوقت.
• الإجراءات الإدارية الأخيرة — الإجراء، الهدف، الجهة التي أطلقته، وما إذا طبق بعد، والوقت.
• المشتركون الجدد — أحدث الحسابات مع حالتها ووقت آخر مصادقة.
• الراوترات — كل NAS مع نقطة صحة: قابل للوصول / غير قابل للوصول / لا توجد بيانات.

الجلسات المباشرة

تسرد نظرة عامة → الجلسات المباشرة كل مشترك تبلغ الراوترات حاليا عن اتصاله عبر RADIUS accounting. تحدث الصفحة تلقائيا كل 30 ثانية؛ كما يوجد زر تحديث يدوي في الرأس.

تصفية القائمة

• بحث — يطابق اسم المستخدم أو الـ Framed IP أو IP الـ NAS، ويتم البحث أثناء الكتابة.
• الراوتر — قصر القائمة على الجلسات الموجودة على NAS واحد.
• المقيدون فقط — اعرض فقط المشتركين الذين يبقيهم حد ما على سرعة منخفضة.
• لكل صفحة — 20 أو 50 أو 100 أو 200 صف.

ما يعرضه كل صف

قطع جلسة

يضع زر قطع الاتصال الموجود على الصف CoA-Disconnect في الطابور لتلك الجلسة بالذات (السبب admin_manual) بعد رسالة تأكيد. يقطع المشترك فورا؛ وإذا كان حسابه لا يزال نشطا فبإمكانه إعادة الاتصال. تتبع الحزمة في صندوق صادر CoA.

العمليات اليومية

التقارير & التحليلات

نظرة عامة → التقارير هي عرض التحليلات — اتجاهات المشتركين، وحركة البيانات عبر الوقت، وأكثر المستخدمين والبطاقات استهلاكا على شبكتك.

اختيار النطاق

كل رقم على الصفحة مرتبط بنطاق تواريخ. اختر إعدادا جاهزا — 7 أيام، 14 يوما، 30 يوما، 90 يوما — أو أدخل تاريخي البداية والنهاية صراحة ثم انقر تطبيق. تغطي طبقة تحميل الصفحة أثناء تنفيذ استعلام طويل المدى كاستعلام 90 يوما.

اتجاهات المشتركين & الجلسات

مخطط خطي بثلاث سلاسل عبر النطاق المختار: المشتركون النشطون، والجلسات المتصلة، والمشتركون منتهو الصلاحية. استخدمه لرصد النمو والتسرب والساعات المزدحمة في شبكتك.

حركة البيانات اليومية

مخطط أعمدة مكدسة لبايتات الرفع والتنزيل لكل يوم. عند تمرير المؤشر فوق يوم تظهر أرقام الرفع والتنزيل إضافة إلى المجموع الكلي في تذييل تلميح الأداة.

قوائم أعلى 10

أربعة جداول تظهر حساباتك الأكثر استهلاكا لحركة البيانات، مرتبة حسب الحجم بالـ GB:

حركة البيانات حسب الكيان

جدول مقسم إلى صفحات وقابل للبحث يعرض حركة البيانات لكل حساب. يبدل تبويبان ما يعرضه:

• المستخدمون — كل مشترك مع اسمه وباقته، ورفع/تنزيل اليوم بالـ MB، ورفع/تنزيل الشهر بالـ GB.
• البطاقات — كل بطاقة hotspot مع مجموعتها وحالتها ونفس تقسيم حركة البيانات اليوم / الشهر.

يصفي مربع البحث الجدول أثناء الكتابة؛ ويقبل محدد لكل صفحة من 20 إلى 200 صف. كل صف يربطك بصفحة تفاصيل ذلك المشترك أو البطاقة.

العمليات اليومية

المحاسبة & الفوترة

يتضمن SAMM نظاما كاملا للقيد المزدوج (double-entry bookkeeping) — فواتير، ومصاريف، وإيصالات، ومدفوعات، وموزعين، وأصول ثابتة، وقوائم مالية كاملة. لا حاجة لمنتج فوترة منفصل لدمجه، ولا لمحاسب لإبقاء الدفاتر منضبطة.

صفحة المحاسبة منظمة في عشرة تبويبات.

نظرة عامة

اللقطة المالية. أربعة أرقام رئيسية في الأعلى:

في الأسفل: جدول بكل حسابات النقد & البنوك مع رصيد كل منها، ومخطط الدخل مقابل المصاريف خلال آخر 1 أو 2 أو 3 أو 6 أو 12 شهرا.

الفواتير

الفاتورة هي مطالبة مالية تصدرها. انقر فاتورة جديدة واملأ:

تنشأ الفواتير أيضا تلقائيا عند تجديد باقة مشترك (من إجراء تجديد الصلاحية أو عبر التجديد التلقائي)، شرط أن يكون للباقة سعر. تصفى القائمة حسب الحالة — غير مدفوعة، جزئية، مستحقة، مدفوعة — وتبحث برقم الفاتورة أو العميل. افتح أي فاتورة لرؤية صفحة تفاصيلها وملف PDF قابل للطباعة؛ يمكن للمشتركين تنزيل نسخهم الخاصة من بوابة العملاء وبوت Telegram.

المصاريف

المصروف هو مال أنفق لتشغيل الـ ISP. يسجل مصروف جديد فئة (حساب المصروف)، والمورد المدفوع له، والمبلغ، وتاريخ التكبد، وتاريخ استحقاق اختياري. لكل مصروف نفس دورة الحياة غير مدفوع / جزئي / مستحق / مدفوع الخاصة بالفاتورة، وصفحة تفاصيل، وسند PDF قابل للطباعة.

الإيصالات & المدفوعات

هذان التبويبان يسجلان النقد الذي ينتقل فعليا — منفصلين عن الفاتورة أو المصروف الذي تسبب فيه.

• الإيصالات — أموال داخلة: نقد مستلم من عميل أو موزع أو دخل آخر، يدخل إلى أحد حسابات النقد لديك. الفاتورة هي المطالبة؛ والإيصال هو المال الواصل مقابلها.
• المدفوعات — أموال خارجة: نقد يدفع مقابل مصروف أو لموزع.

تسجيل إيصال أو دفعة يدفع الفاتورة أو المصروف المرتبط نحو مدفوع ويرحل القيد المحاسبي المطابق.

العملاء & مبيعات البطاقات

يسرد تبويب العملاء الرصيد الجاري لكل عميل — أي ما يدين لك به. أما مبيعات البطاقات فتغطي إيرادات Hotspot المدفوعة مسبقا: يتتبع مجموعات البطاقات المباعة والموزعين. يشتري الموزع منك مجموعات بطاقات كاملة على فاتورة، ثم يعيد بيع البطاقات الفردية للمستخدمين النهائيين؛ ورصيده المستحق هو ما لا يزال عليه دفعه لك.

الأصول & حسابات النقد

• الأصول — سجل الأصول الثابتة (راوترات، مركبات، معدات). يتتبع SAMM قيمتها واستهلاكها عبر الزمن.
• النقد — أدر حسابات النقد & البنوك، وحسابات رأس المال: حقوق المالك، حيث المساهمة هي مال يضعه المالك في النشاط، والسحب هو مال يخرجه منه. رأس المال ليس إيرادا ولا يظهر أبدا في قائمة الأرباح & الخسائر.

التقارير — القوائم المالية

تبويب التقارير هو عرض المحاسب. خمس قوائم، كل منها بنطاق تواريخ وقابلة للتصدير إلى PDF:

العمليات اليومية

تذاكر الدعم

يتضمن SAMM مكتب دعم مدمجا. يفتح المشتركون التذاكر من بوابة العملاء أو بوت Telegram، ويمكن للمسؤول فتح تذكرة نيابة عن المشترك، ويعمل فريقك عليها جميعا من المستخدمون → تذاكر الدعم.

طابور التذاكر

يسرد الطابور كل تذكرة — الرقم، العميل، الموضوع، الأولوية، الحالة، تاريخا الفتح وآخر تحديث، وعدد الرسائل. صفه عبر:

• شارات الحالة — واحدة لكل حالة تذكرة، تحمل كل منها عدادا مباشرا، بحيث يصبح حجم العمل واضحا بنظرة واحدة.
• الأولوية — عادية أو متوسطة أو حرجة.
• نشطة / مسحوبة — يمكن للعميل سحب تذكرة لم يعد بحاجة إليها؛ التذاكر المسحوبة تظهر باهتة ومخفية افتراضيا.
• بحث — برقم التذكرة أو الموضوع أو العميل.

تعد شارة الشريط الجانبي التذاكر المفتوحة بحيث لا يفوت أي شيء.

فتح تذكرة

يتيح تذكرة جديدة للمسؤول فتح تذكرة لعميل مختار — اختر العميل، ثم حدد الموضوع والأولوية والوصف. كما يفتح المشتركون تذاكرهم بأنفسهم من بوابة العملاء أو بوت Telegram.

العمل على تذكرة

افتح تذكرة لقراءة سلسلة المحادثة الكاملة. من هناك يمكنك:

• الرد على العميل — رسالة عامة يراها المشترك في بوابته ومن خلال بوت Telegram.
• إضافة ملاحظة داخلية — رسالة للموظفين فقط، مخفية عن العميل، لملاحظات التسليم بين أفراد فريقك.
• تغيير حالة وأولوية التذكرة.

انقر بزر الفأرة الأيمن على أي صف — أو استخدم زر ⋮ الخاص به — للحصول على نفس إجراءات الحالة والأولوية والرد والملاحظة الداخلية دون مغادرة الطابور.

العمليات اليومية

مركز الإشعارات

يبقي SAMM المشتركين على اطلاع تلقائيا — عبر البريد الإلكتروني وTelegram — ويتيح لك بث الرسائل. تسلم خدمة samm-notification كل شيء عبر طابور مقيد الإيقاع. تتضمن صفحة النظام → مركز الإشعارات ستة تبويبات.

نظرة عامة

تبويب البداية — عدادات مباشرة (في الطابور، قيد الإرسال، أرسلت اليوم، فشلت، تم تخطيها، مستبعدة)، وحالة كل قناة تسليم، وتغذية بأحدث الإشعارات.

القنوات

اضبط كيفية خروج الرسائل من SAMM. يستخدم البريد الإلكتروني حساب إشعارات خاصا به، منفصلا عن SMTP استعادة كلمة المرور في الإعدادات. ويستخدم Telegram توكن البوت. يختار كل مشترك، من بوابة العملاء، القنوات التي يريدها ويمكنه إيقاف الإشعارات كليا.

الرسائل

قوالب الرسائل، مجموعة واحدة لكل حدث. عدل صياغة أي إشعار — تذكيرات التجديد والإيصالات وما إلى ذلك — بحيث تخرج كل رسالة بصوتك ولغتك.

القواعد & المؤقتات

يتحكم هذا التبويب بمتى وكيف تطلق الإشعارات التلقائية. لكل حدث، أنت تتحكم بـ:

• ما إذا كانت القاعدة مفعلة.
• تجاهل الاستبعاد — عند تفعيلها، تصل الرسالة إلى كل مشترك حتى لو اختار الاستبعاد. خصصها للرسائل المعاملاتية المهمة.
• التوقيت — مثلا، كم يوما قبل انتهاء الصلاحية يرسل تذكير التجديد.
• التسليم & ضبط الإيقاع — يفرغ العامل الطابور دفعة واحدة في كل نبضة؛ ويتحكم حجم الدفعة وفاصل النبضة معا في سرعة خروج الرسائل، بحيث لا يغرق بث كبير خادم البريد لديك أبدا.

تشمل الأحداث التي يمكن لـ SAMM إصدارها بنفسه: تذكير التجديد (قبل انتهاء الاشتراك)، وإشعار انتهاء الصلاحية (عند انقضائه)، وتحذير الحصة (عند اقتراب استنفاد حد البيانات)، وإيصال الدفع (عند تسجيل دفعة)، وتجديد الباقة.

البث

أرسل رسالة لمرة واحدة — نافذة صيانة، تغيير سعر — إلى مجموعة مختارة من المشتركين. يمر البث عبر نفس الطابور المقيد الإيقاع الذي تمر فيه الإشعارات التلقائية.

صندوق الصادر

كل رسالة وضعها SAMM في الطابور أو أرسلها، مع حالة التسليم الخاصة بكل رسالة، بحيث يمكنك تأكيد وصول إشعار إلى المشترك أو معرفة سبب عدم وصوله.

النظام

WireGuard VPN

يستطيع SAMM تشغيل خادم WireGuard VPN على مضيف SAMM — عادة للوصول الإداري عن بعد إلى جهاز SAMM والوصول الإداري إلى أجهزة MikroTik الموجودة خلفه. تدار بالكامل من النظام → VPN

تبويب الخادم

1. انقر توليد المفاتيح لإنشاء زوج مفاتيح الخادم. يظهر المفتاح العام للخادم فور توليده — يحتاجه العملاء.
2. حدد منفذ الاستماع (UDP، الافتراضي 51820)، وعنوان نفق الخادم (الـ CIDR على واجهة wg0، الافتراضي 10.254.254.1/24)، ونطاق IP العملاء — عنوانا البداية والنهاية اللذان يوزعهما SAMM تلقائيا على الأقران الجدد.
3. فعل تفعيل WireGuard VPN وانقر حفظ — يرفع SAMM واجهة wg0. يبقى المفتاح مقفلا حتى وجود مفاتيح الخادم.

تبويب العملاء

انقر إضافة عميل، أعط القرين اسما، وسيخصص له SAMM العنوان التالي من نطاق العملاء. لكل قرين يمكنك تنزيل ملف إعداداته، أو مسح رمز QR بتطبيق WireGuard للجوال، أو نسخ أوامر MikroTik RouterOS الجاهزة لإدخال راوتر إلى الـ VPN. يمكن تفعيل الأقران/تعطيلهم أو حذفهم؛ وتظهر ألوان الحالة ما إذا كان كل قرين متصلا أو غير محدث أو لم ير قط.

النظام

Cloudflare Tunnel

ينشر نفق Cloudflare Zero Trust نظام SAMM على الإنترنت العام دون فتح أي منافذ في جدار الحماية — مفيد عندما يكون مضيف SAMM خلف NAT. يدار من النظام → نفق Cloudflare.

حالة الخدمة

تفتح الصفحة على بطاقة حالة تبلغ عن وضع الـ connector:

كما تعرض إصدار cloudflared وما إذا كان الـ connector مهيأ للتشغيل التلقائي عند الإقلاع.

إعداد النفق

1. في لوحة Cloudflare Zero Trust (one.dash.cloudflare.com)، افتح Networks → Tunnels ثم Create a tunnel.
2. اختر الـ connector من نوع Cloudflared، أعط النفق اسما، واحفظ. في خطوة التثبيت، انسخ التوكن فقط — السلسلة الطويلة بعد --token.
3. الصقه في SAMM وانقر إعداد النفق. يسلم SAMM التوكن إلى cloudflared ويشغل الـ connector.
4. ارجع إلى Cloudflare وأضف Public hostname: العنوان الذي اخترته، النوع HTTP، URL localhost:80 (ممرر عبر nginx — موصى به) أو localhost:8000 (مباشرة إلى الـ API).

خلال بضع ثوان تتحول شارة الحالة إلى الأخضر ويصبح SAMM متاحا على اسم المضيف العام. بعد الإعداد، تتيح لك الإجراءات بنقرة واحدة تشغيل الـ connector أو إيقافه أو إعادة تشغيله، أو استبدال التوكن لتدويره، أو إزالة النفق (إجراء يتطلب كتابة REMOVE للتأكيد).

النظام

الإعدادات

تحتوي النظام → الإعدادات على المعلمات الحية القابلة لإعادة التحميل الفوري. تعيد العفاريت (daemons) قراءتها في نبضتها التالية — دون الحاجة إلى إعادة تشغيل الخدمة. الإعدادات منظمة في تبويبات.

المعلمات العامة

خفض فاصل samm-radius لفرض أكثر صرامة؛ ارفعه لتقليل الحمل.

تبويب الـ ISP

حدد هوية الـ ISP لديك وارفع شعار الـ ISP. يعاد ضبط حجم الشعار تلقائيا ويظهر على بطاقات Hotspot المطبوعة وملفات PDF للفواتير.

تبويب البريد الإلكتروني

اضبط خادم SMTP المستخدم لـ رموز استعادة كلمة المرور المرسلة إلى المسؤولين والعملاء (المضيف، المنفذ، SSL/STARTTLS، اسم المستخدم، عنوان المرسل، كلمة المرور). انقر اختبار الاتصال للتحقق من بيانات الاعتماد دون إرسال بريد.

النظام

المسؤولون & الأدوار

تدير النظام → المسؤولون من يستطيع تسجيل الدخول إلى بوابة الإدارة وما يمكن لكل شخص فعله. تحتوي على تبويبين: المسؤولون والأدوار.

حسابات المسؤولين

أنشئ مسؤولا باسم مستخدم وكلمة مرور وبريد إلكتروني اختياري ودور. من قائمة ⋮ الخاصة بالصف يمكنك تعديل الدور أو كلمة المرور، أو تعطيل الحساب، أو حذفه. السوبر أدمن وحده هو من يستطيع إدارة المسؤولين الآخرين.

الأدوار & الصلاحيات

يمنح الدور صلاحية وصول لكل منطقة. يتمتع دور السوبر أدمن المدمج دائما بصلاحية وصول كاملة ولا يمكن تغييره. أنشئ أدوارا مخصصة للوصول المحدود — يبدأ الدور الجديد بلا أي صلاحية وصول حتى تحدد صلاحياته.

لكل منطقة في SAMM (المشتركون، الباقات، NAS، المحاسبة، الأدوات، الإعدادات، وما إلى ذلك) يضبط الدور على أحد ثلاثة مستويات:

نطاق رؤية البيانات

لكل دور أيضا نطاق. رؤية كل العملاء & البطاقات تعني أن الدور يرى كل سجل؛ وعند إلغاء تفعيلها، يرى مسؤولوه فقط المشتركين والبطاقات التي أنشأوها بأنفسهم — مثالي للموزعين أو موظفي الفروع.

النظام

الأدوات

يجمع قسم الأدوات أدوات العمليات بالجملة والصيانة.

النسخ الاحتياطي & الاستعادة

أنشئ لقطة كاملة لقاعدة البيانات قبل أي تغيير كبير. النسخة الاحتياطية هي أرشيف pg_dump مضغوط بـ gzip ومخزن على الخادم، ولكل منها ترويسة خاصة بـ SAMM.

• إنشاء نسخة احتياطية — اختياريا أضف ملاحظة؛ فعل تخطي الاستخدام & السجل التاريخي للحصول على نسخة أصغر وأسرع تتجاهل جداول السجلات الضخمة.
• تنزيل نسخة احتياطية إلى جهازك، أو رفع نسخة احتياطية سابقة لـ SAMM إلى الخادم مجددا.
• الاستعادة تكتب فوق قاعدة البيانات الحالية — محمية بنافذة تتطلب كتابة RESTORE للتأكيد.

منظف السجل التاريخي

احذف نهائيا صفوف السجل والتاريخ القديمة لاسترداد مساحة قاعدة البيانات. اختر إعدادا جاهزا للاحتفاظ وأكد. يقلم المنظف جلسات RADIUS المغلقة، وسجلات post-auth، وتجميعات الاستخدام اليومية، وتاريخ الراوترات/الواجهات، وسجلات التقييد، وقيود التدقيق المطبقة، وصفوف CoA المنتهية. وهو لا يمس أبدا الجلسات المباشرة، أو الأوامر في الطابور، أو حزم CoA قيد الانتظار، أو إجماليات الاستخدام مدى الحياة غير القابلة للتصفير.

التصدير / الاستيراد

تصدير واستيراد بالجملة لـ المستخدمين والباقات وNAS بصيغة .csv أو .xlsx. نزل قالبا (الأعمدة الصحيحة مع صف عينة) أو لقطة من البيانات الحالية، املأها، وارفعها مرة أخرى. يفحص كل صف ويعرض على شاشة معاينة — تظهر التكرارات والصفوف غير الصالحة، وتختار ما إذا كنت تريد تخطي التكرارات أو تحديثها في مكانها — قبل أن تكتب أي بيانات.

التغييرات بالجملة

طبق تغييرا واحدا — المالك أو تاريخ الانتهاء أو الحالة أو التجديد التلقائي — على كل مشترك يطابق فلترا، في تشغيل واحد. اختر التغيير، وابن الفلتر (الحالة / الباقة / المالك / البحث)، وراجع القائمة المطابقة، ثم أكد.

الحذف بالجملة

احذف نهائيا العديد من المشتركين أو بطاقات Hotspot دفعة واحدة، مختارين عبر فلتر. يؤدي حذف مشترك أيضا إلى إزالة تاريخ استخدامه وجلساته وسجلات RADIUS الخاصة به وفواتيره، ويقطع أي جلسة مباشرة. محمي بنافذة تتطلب كتابة DELETE للتأكيد.

النظام

اللغات & السمات

اللغات

بوابتا الإدارة والعملاء قابلتان للترجمة بالكامل. تأتي ست لغات مدمجة: الإنجليزية، العربية (من اليمين إلى اليسار)، التركية، الفرنسية، الإسبانية والألمانية. يختار كل مستخدم لغته من الشريط العلوي أو من ملفه الشخصي؛ ويحفظ الخيار لكل حساب.

محرر الترجمات

يستطيع السوبر أدمن تعديل الترجمات مباشرة من النظام → الترجمات — دون إعادة تشغيل ودون تعديل ملفات. ينشئ المحرر أيضا لغات جديدة كليا ويستورد/يصدر مصنفات الترجمة بصيغة .xlsx، بحيث يمكنك تعريب SAMM إلى أي لغة تخدمها.

السمات

يأتي SAMM مع 11 سمة بصرية، فاتحة وداكنة. يختار كل مستخدم سمة من الشريط العلوي؛ تتحدث المعاينة فورا وتحفظ لكل حساب. مصطلحات تكنولوجيا المعلومات لا تترجم أبدا، بحيث تبقى الشاشات التقنية دقيقة في كل لغة.

النظام

سجل التدقيق

النظام → سجل التدقيق هو سجل الإجراءات الإدارية — وطابور الأوامر الذي ينفذها. عندما تعيد تعيين عداد، أو تغير باقة، أو تجدد مشتركا، يكتب SAMM الإجراء هنا بدلا من المس المباشر براوتر يعمل.

يعرض كل قيد الإجراء وهدفه والمسؤول الذي أطلقه ومتى حدث وما إذا تم تطبيقه بعد. تفرغ خدمة samm-radius القيود المعلقة في نبضتها التالية، وعند الحاجة تصدر CoA لتحديث جلسة مباشرة. تعد شارة الشريط الجانبي القيود التي لا تزال معلقة؛ وتتتبع لوحة صحة خط المعالجة (Pipeline) في لوحة المعلومات هذا التراكم.

الترخيص

الترخيص & الباقات

كل تثبيت لـ SAMM مرخص لكل جهاز — تكون الباقة على ذلك التثبيت، لذا يمكنك تشغيل عدة خوادم SAMM، كل منها على باقته الخاصة. تحدد الباقة ثلاثة سقوف رقمية.

يعمل التثبيت الجديد غير المسجل عند الحد الأدنى. كل ميزة متاحة في كل باقة — الباقة تحدد السقوف فقط. إنشاء مشترك أو بطاقة أو NAS بعد تجاوز السقف يحظر حتى ترقي؛ ولا تفقد أي بيانات أبدا.

التفعيل & الترقية

1. افتح النظام → الترخيص.
2. فعل بتسجيل الدخول بحساب SecuryTik الخاص بك — أو استخدم ربط هذا الجهاز، الذي يظهر رمزا تعتمده على samm.securytik.com دون كتابة كلمة المرور على الخادم. يفعل الجهاز على Free.
3. للارتقاء أعلى، اطلب Pro أو Pro Max من الصفحة نفسها — يقوم مسؤول SecuryTik بالمراجعة والموافقة.

تعيد صفحة الترخيص أيضا فحص الترخيص عند الطلب وتظهر استخدامك الحالي مقابل كل سقف. إلغاء ربط الجهاز يعيد التثبيت إلى الباقة غير المسجلة دون حذف أي بيانات.

إذا انتهت صلاحية ترخيص مدفوع

لا يحذف SAMM البيانات أبدا. الترخيص المنتهي يتدرج للأسفل بسلاسة:

إعادة التفعيل في أي مرحلة تعيد تشغيل كل الخدمات تلقائيا — وتبقى بيانات المشتركين وسجلاتهم سليمة.

التحديثات التلقائية

التحديث التلقائي مستقل عن الترخيص — كل الباقات تتحدث، ولا يمنعه ترخيص منتهي الصلاحية أبدا. يتفقد SAMM يوميا وجود إصدار جديد موقع. من النظام → الترخيص يمكنك التبديل بين الإبلاغ (الافتراضي — شريط مع زر تطبيق الآن) والتلقائي (تطبيق دون تدخل). يتحقق من كل تحديث، ويؤخذ منه نسخة احتياطية، ويطبق في مكانه. يمكنك أيضا إعادة تشغيل المثبت في أي وقت — فهو يرقي بطريقة idempotent.

لمشتركيك

بوابة العملاء & الروبوت

يمنح SAMM كل مشترك واجهتين للخدمة الذاتية — بوابة ويب وبوت Telegram — بحيث يمكنه التحقق من الاستخدام والدفع دون التواصل معك.

بوابة العملاء

يسجل المشتركون الدخول من جذر موقع SAMM (/) باسم مستخدم SAMM وكلمة المرور الخاصة بهم. تحتوي البوابة على:

من الملف الشخصي، يربط المشترك حسابه على Telegram، ويرتب قنوات الإشعارات المفضلة لديه، أو يستبعد نفسه من الإشعارات كليا. وإذا نسي كلمة المرور، يرسل إليه رمز OTP بالبريد الإلكتروني (يتطلب ذلك ضبط تبويب البريد الإلكتروني).

بوت Telegram

تشغل خدمة samm-telegram بوت خدمة ذاتية تفاعليا. يرسل المشترك /start، ويتحقق مرة واحدة باسم مستخدم SAMM وكلمة المرور (يحذف البوت رسالة كلمة المرور فورا)، ثم يستطيع، عبر الدردشة بالكامل:

• التحقق من باقته وحصته واستخدامه وتاريخ انتهائه
• عرض الفواتير وتنزيلها بصيغة PDF
• تحديث ملفه الشخصي وتغيير كلمة المرور
• فتح تذاكر الدعم ومتابعتها

يسلم البوت أيضا الإشعارات التلقائية — تذكيرات التجديد، إشعارات الانتهاء، تحذيرات الحصة، والإيصالات — للمشتركين الذين ربطوا Telegram.

المرجع

تشغيل 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

سطر أوامر المسؤول (Admin CLI)

لعمليات سريعة على المشتركين من الـ shell. يوضع كل أمر في طابور سجل التدقيق ويطبق في نبضة samm-radius التالية — تماما مثل إجراءات الواجهة.

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

ملفات الإعداد

تحفظ هذه الملفات عبر الترقيات ولا يكتب فوقها أبدا عند إعادة تشغيل المثبت. أما المعلمات في وقت التشغيل (إيقاع الحلقات، وقت إعادة التعيين اليومية، منافذ CoA) فتوجد في الإعدادات بدلا من ذلك، وتطبق دون إعادة تشغيل.

تحديث SAMM

إما أن تترك SAMM يحدث نفسه من النظام → الترخيص، أو تعيد تشغيل المثبت — راجع التثبيت → الترقية. كلا المسارين يعيد تطبيق الـ migrations ويعيد تشغيل الخدمات؛ أما إعداداتك وبياناتك فلا تمس.

النسخ الاحتياطي & الاستعادة

استخدم الأدوات → النسخ الاحتياطي & الاستعادة للحصول على لقطة كاملة لقاعدة البيانات قبل أي تغيير كبير. لإعادة البناء على مضيف جديد، ثبت SAMM ثم استعد النسخة الاحتياطية.

المرجع

الأسئلة الشائعة & حل المشكلات

بحاجة إلى مساعدة إضافية؟

راسلنا على [email protected] للإبلاغ عن خلل أو طلب ميزة جديدة.