SAMM belgeler

Başlarken

Kurulum

SAMM ihtiyaç duyduğu her şeyi yükler - FreeRADIUS , PostgreSQL, nginx, WireGuard , bulut alevlendi ve beş SAMM hizmeti tek adımda. Yükleyici idempotent : yeniden çalıştırmak mevcut yüklemeyi yükseltir ve hiçbir zaman yapılandırmanızın üzerine yazmaz veya veritabanı parolanızı yeniden oluşturmaz.

SAMM her yerde çalışır; ağınıza uygun yükleme yolunu seçin:

• Seçenek A / B — çıplak Linux sunucu (üretim için önerilir): Ubuntu / Debian'a tek komutla veya manuel kurulum.
• Seçenek C — Docker Oluştur: kapsayıcılarla aynı SAMM ; multi-arch (amd64 + arm64) olduğundan Ubuntu , Windows Docker Masaüstünde, Apple -silicon Mac'lerde, her yerde çalışır.
• Seçenek D — MikroTik RouterOS 7 kapsayıcı: Oluşturulan YAML'yi doğrudan yönlendiricinize yapıştırın. Harici Linux kutusuna gerek yok.

Ön koşullar

• yeni bir sunucu : Ubuntu 22.04 LTS, Ubuntu 24.04 LTS veya Debian 12. Yalnızca sunucu sınıfı Linux — masaüstü çeşitleri desteklenmez.
• Root / sudo erişimi ve internet bağlantısı.
• systemd ve PostgreSQL'in yerel olarak kurulabileceği bir ana bilgisayar (biri sizin için ayarlanmıştır).

Seçenek A — tek komutla kur

Sunucuda şunu çalıştırın:

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

Bu önyükleme komut dosyası, GitHub'dan en son SAMM sürüm paketini indirir, alıntılar ve tam yükleyiciyi otomatik olarak çalıştırır. Birkaç dakika içinde tamamlandı.

Seçenek B — bir sürüm paketinden manuel olarak yükleme

En son samm-<version>.tar.gz dosyasını şu adresten indirin: GitHub Sürümleri sayfası, sonra sunucuda:

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

Ayrıca başka bir makinede (yükleyici) oluşturulan bir zip'ten de dağıtım yapabilirsiniz. rsync , kaynağı /opt/samm 'in kendisine aktarır:

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

Veya depoyu /opt/samm dizinine kopyalayın ve sudo bash /opt/samm/install.sh komutunu çalıştırın.

Her iki durumda da kurulum tamamlandığında yönetim portalını açın ve şu kimlik bilgileriyle oturum açın:

İlk girişinizden hemen sonra yönetici parolasını değiştirin.

Seçenek C — Docker Compose ile yükleyin

SAMM 'ü kaplar olarak çalıştırmayı tercih ederseniz (aynı ürün, farklı şekilde paketlenmiş) github.com/mhdhaidarah/samm-docker adresindeki Docker Compose dağıtımını kullanın. Docker 'in mevcut olduğu herhangi bir ana bilgisayarda:

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

Bu, eksikse Docker 'yi yükler, bir docker-compose.yml + .env bırakır /opt/samm-docker/ içine girin ve yığını başlatın. görüntü mhdhaidarah/samm , yapısı gereği kapalı kaynak olan çıplak işletim sistemi kurulumuyla aynı derlenmiş paketten oluşturulmuştur.

v2.2.6'dan bu yana çoklu arşiv — aynı etiket, linux/amd64 ve linux/arm64 için gönderilir. docker pull doğru değişkeni şeffaf bir şekilde seçer; dolayısıyla yükleme yolu, 64 bit Intel/AMD sunucusunda, Docker Masaüstü çalıştıran bir Apple -silicon Mac'te veya RouterOS 7'nin kapsayıcı özelliğini kullanan bir ARM MikroTik cihazında (RB5009, hAP ​​ax², CCR2004/2116/2216) aynıdır.

curl ile bash arasında borulamaya izin verilmeyen ana bilgisayarlarda (kilitli kutular, katı çıkış politikaları), çalışmaya hazır oluşturma dosyasını doğrudan alabilirsiniz:

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

Birkaç özellik henüz Docker modelinde mevcut değildir (aşamalı lisans kilitleme, dinamik FreeRADIUS yeniden yükleme). Yerleşik WireGuard ve Cloudflare Tünel yönetici sayfaları, Docker varyantında kasıtlı olarak gizlenmiştir; kapsayıcının içinden erişilemeyen ana bilgisayar düzeyindeki sistemd hizmetlerini yönetirler. Yerleşik olanlara ihtiyacınız varsa yukarıdaki Seçenek A veya B'yi seçin veya Docker ana bilgisayarında doğrudan SAMM ile birlikte cloudflared / wg-quick komutunu çalıştırın. Bkz. Tam v1 uyarıları ve manuel yükleme yolu için Docker varyantının README dosyası.

Windows'ta ( Docker Masaüstü) — yalnızca değerlendirme

Yükle Windows için Docker Masaüstü (ilk başlatmada WSL2 arka ucunu kurmasına olanak tanır). Daha sonra PowerShell 'den (WSL terminaline gerek yok) oluşturma paketini alın ve yığını başlatın:

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

Yığının Docker Desktop → Konteynerler içinde başlamasını izleyin — samm grubu 7 hizmete açılır. Hepsi yeşil olduğunda yönetim portalını açın ve şu kimlik bilgileriyle oturum açın:

İlk girişinizden hemen sonra yönetici parolasını değiştirin.

Gerçek bir MikroTik NAS, RADIUS için bu Windows ana bilgisayarına çarpacaksa, Windows Güvenlik Duvarı üzerinden UDP 1812 + 1813'e izin verin:

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

Parçalayın: docker, kurulum dizininden -v 'yi oluşturun ( -v , postgres birimini ve Fernet anahtarını siler; veri eklediyseniz önce bunları yedekleyin).

Seçenek D — bir MikroTik yönlendiriciye kurulum ( RouterOS 7)

Desteklenen: arm64 MikroTik — RB5009, hAP ​​ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216. amd64 SKU'ları — CCR2004-1G-2XS-PCIe (amd64), x86 RouterOS , amd64 hipervizörlerinde CHR.
Desteklenmiyor: armv7 / mipsbe / smips /tile / ppc cihazları (hEX, RB750, eski RB modelleri) — konteyner desteği yok veya SAMM yığını için çok az RAM/CPU.

1. Yönlendiriciyi hazırlayın

kapsayıcı paketini yükleyin (mikrotik.com/download adresindeki extra_packages.zip adresinden - eşleşen Container-*.npk dosyasını Dosyalar aracılığıyla yükleyin, ardından yeniden başlatın). Ardından konteyner modunu etkinleştirin (tek seferlik, yeniden başlatma gerektirir):

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

2. Diski biçimlendirin ve bağlayın (ext4)

Bir USB sürücü veya microSD takın (≥ 8 GB önerilir — Postgres + görüntü katmanları eklenir). Yönlendiricide:

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

Biçimlendirmeden sonra disk bağlantılarını ve yazılabilir olduğunu doğrulayın:

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

3. Oluşturulan YAML'yi kapsayıcı uygulamasına yapıştırın

WebFig veya WinBox'ta Kapsayıcı → Uygulamalar → + Yeni → YAML öğesini açın. Aşağıdaki oluşturma dosyasını YAML alanına yapıştırın, 2. adımda biçimlendirdiğiniz diski depolama konumu olarak ayarlayın ve gönderin. RouterOS her görüntüyü alacak ve sizin için hizmetlerin bağlantılarını oluşturacaktır.

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: {}

yapıştırmadan önce, her change-me-strong-random-string 'i AYNI güçlü rastgele şifreyle (≥ 24 rastgele karakter) değiştirin — ilk başlangıçta Postgres 'e girer ve her SAMM hizmeti bağlanmak için bunu kullanır. Şifre yöneticisiyle bir şifre oluşturun veya herhangi bir Linux kutusunda pwgen 32 1 komutunu çalıştırın.

4. MikroTik cihazını doğrulayın ve SAMM cihazına bağlayın

7 konteynerin tümü çalıştığında yönetim portalını bir tarayıcıda açın ve şu kimlik bilgileriyle oturum açın:

Yönetici parolasını hemen değiştirin. RADIUS kimlik doğrulama + muhasebe, yönlendiricinin kendisinde UDP 1812 + 1813 üzerinde sunulur; böylece MikroTik RADIUS istemcisi, Sistem → RADIUS bölümünde belirlediğiniz paylaşılan parola ile 127.0.0.1 adresini gösterebilir.

Etkileşimsiz seçenekler

Tüm istemler ortam değişkenleriyle önceden yanıtlanabilir, böylece yükleyici çalıştırılabilir gözetimsiz:

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

Yükleyicinin kurduğu şeyler

Yükleyici canlı, renkli bir ilerleme ekranı olarak çalışır; bir yüzde çubuğu ve bir faz başına kontrol listesi. Her aşamanın ham çıktısı yakalanır /var/log/samm-install.log ; başarısızlık durumunda son 30 satır yazdırılır.

Tüm kimlik bilgileri (veritabanı parolası ve oturum imzalama anahtarları) , ilk yüklemede otomatik olarak oluşturuldu.

Etkileşimli istemler

Tüm istemler kurulum başlamadan önce önden gerçekleşir:

• Cloudflare belirteci — yayınlamak için bir Sıfır Güven bağlayıcı belirtecini yapıştırın SAMM açık bağlantı noktası olmadan çevrimiçi yapın veya atlayıp daha sonra yapılandırmak için Enter tuşuna basın.
• HTTP bağlantı noktası — bağlantı noktası 80 zaten kullanımdaysa yükleyici ayrılır bu sitelere dokunulmaz ve alternatif bir bağlantı noktası ister (varsayılan 8080 ).

Kurulum özeti

Yükleyici işini bitirdiğinde varsayılan yönetici URL'sini içeren bir özet yazdırır. oturum açma adı, seçilen HTTP bağlantı noktası, veritabanı kimlik bilgileri ve yapılandırma dosyası yolları:

============================================================
  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
============================================================

Yükseltme

Yükseltmek için yeni kaynağı alın ve yükleyiciyi yeniden çalıştırın:

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

Yeniden çalıştırma, kaynağı yeniden senkronize eder, venv'yi yükseltir, tüm geçişleri yeniden uygular, FreeRADIUS ve nginx yapılandırmalarını yeniden yükler ve her hizmeti yeniden başlatır. Yapılandırmanız dosyalar ve ilk kurulumda seçilen HTTP bağlantı noktası korunur .

Başlarken

İlk adımlar

Beş kısa görev, yeni bir kurulumu abonelerin bağlanıp faturalandırılabileceği noktaya getirir.

1 · İlk giriş

1. http://<sunucunuz>/admin/ adresini açın (http://<sunucunuz>/admin/ 80 değilse yükleme özeti) veya Cloudflare tünel URL'niz.
2. yönetici / yönetici ile oturum açın.
3. Şifreyi hemen Sistem → Yöneticiler bölümünden değiştirin, veya üst çubuktaki profil menüsünden.

2 · İlk yönlendiricinizi ekleyin

1. MikroTik → NAS 'e gidin ve Yönlendirici Ekle 'ye tıklayın.
2. Yönlendiricinin IP'sini, kısa adını ve RADIUS paylaşılan sırrını girin. MikroTik için isteğe bağlı olarak canlı cihaz senkronizasyonu için API kimlik bilgilerini ekleyin.
3. MikroTik üzerine, SAMM ana bilgisayarına (bağlantı noktaları 1812/1813) işaret eden bir RADIUS sunucusu ekleyin aynı paylaşılan sırla kullanın ve PPP / Erişim Noktası için RADIUS'u etkinleştirin.

FreeRADIUS yeniden başlatma gerekmez — SAMM , NAS istemcilerini dinamik olarak veritabanı. Prosedürün tamamı için Yönlendiriciler (NAS) 'e bakın, veya kurulum sihirbazının yapılandırmasına izin verin MikroTik senin için.

3 · Plan oluşturun

Bir plan hızı, sınırları ve sattığınız fiyatı tanımlar. Git Kullanıcılar → Planlar → Yeni plan . Tam alan referansı: Planlar ve amp; sınırlar .

4 · Abone ekleyin

Kullanıcılar → Yeni müşteri 'ye gidin, giriş bilgilerini girin kimlik bilgileri ve bir plan seçin. Abone hemen bağlanabilir. Ön ödemeli için etkin nokta erişimi, bunun yerine kupon kartı oluşturun.

5 · Lisansınızı etkinleştirin

Yeni bir yükleme, minimum katmanda kayıtsız çalıştırır. Açık Sistem → Lisans ve sınırları kaldırmak için etkinleştirin - bkz. Lisanslama ve katmanlar .

Aboneler & planlar

Planlar & limitler

planı , abonelere atanan hizmet tanımıdır; hız, sınırlar ve fiyat. Kullanıcıları eklemeden önce planlar oluşturun.

Plan oluştur

1. Kullanıcılar → Planlar 'a gidin.
2. Yeni plan'a tıklayın.
3. Formu doldurun ve Planı kaydet'e tıklayın.

Her sınır bir geçiştir; yalnızca ihtiyacınız olanı etkinleştirin. Aynı mod mevcut bir planı düzenler (satırın ⋮ menüsünü açın → Düzenle).

Plan alanları

Dört limit

Her limit bağımsız ve isteğe bağlıdır. Birkaçı ayarlandığında, SAMM bunları bir sabit sıra — sona erme → kota → çalışma süresi → günlük — ve ilki Bitkin olan eyleme karar verir.

Her limit için egzozda ne olacağını seçersiniz: bir sonraki plan seçin aboneyi açmak veya şu şekilde bırakmak için: — bağlantıyı kes — . Günlük için bir sonraki planı sınırlandırmak bir kısma görevi görür; abone en kısa sürede orijinal plana geri döner sonraki günlük otomatik olarak sıfırlanır.

Hız pencereleri

Bir hız aralığı , ayarlanan saatler boyunca planın temel hızını geçersiz kılar; örneğin gece yarısından sonra sınırsız hız penceresi. Açmak için bir plan satırını tıklayın Haftanın günü kontrolü ekleyen ve destek sağlayan Speed Windows düzenleyicisi gece yarısını geçen pencereler. Birkaç pencere eşleştiğinde, en yüksek hızlı olanı kazanır.

İki kullanım kavramı

SAMM kullanımı iki yerde tutar ve bunları hiçbir zaman birleştirmez:

• Sıfırlanabilir sayaçlar — limit başına durum. Bir yönetici tarafından sıfırlandı sıfırlama ve günlük sıfırlama ile.
• Faturalandırma sayaçları — sıfırlanamayan ömür boyu toplamlar. Hiç sıfırlanmadı, böylece raporlar ve faturalar doğru kalır.

Planları yönetme

Planlar listesi her planın hızını, abone sayısını, etkin limitlerini ve hızını gösterir pencereler. Bir satırın ⋮ menüsünden düzenleyebilir, hız pencerelerini açabilir, etkinleştirebilir/devre dışı bırakabilirsiniz, abonelerine atlayın veya silin (yalnızca abonesi olmadığında). Düzenleme Değişikliğin tüm mevcut abonelere yayılması için otomatik yenileme teklifleri.

Aboneler & planlar

Aboneler

abone (müşteri / kullanıcı), bir PPPoE veya Hotspot hesabıdır. SAMM 'ye karşı kimlik doğrulaması yapar. Her aboneye tam olarak bir plan atanır.

Abone oluştur

1. Kullanıcılar 'a gidin ve Yeni müşteri 'yi tıklayın.
2. Formu doldurun ve kaydedin — abone hemen bağlanabilir.

Abone listesi

Kullanıcılar sayfası, her aboneyi bir bakışta atanmış durum noktasıyla listeler. planı ve her bir sınırın ne kadarının kaldığını - ilerleme çubuğuyla günlük kullanım, kota kalan, kalan çalışma süresi ve kalan gün sayısı. Duruma göre filtrele (Tümü / Etkin / Askıya Alındı / Süresi Doldu / Çevrimiçi) veya kullanıcı adına, isme veya cep telefonuna göre arama yapın.

Abone yönetme

Abone başına yapılan her işlem için bir satıra sağ tıklayın veya ⋮ menüsünü kullanın:

Kullanım görünümü

Kullanım işlemi, bir abone için ayrıntılı bir trafik sayfası açar, 7g / 14g / 30d / 90d dönem seçiciyle. Üç manşet rakamı rapor ediyor: bugünün trafiği (yükleme/indirme bölümü ve çevrimiçi dakikalarla birlikte), bu ayın trafiği ve kümülatif çevrimiçi süre ay için. Bunların altında yüklemelerin günlük trafik grafiği yer alır indirme ve tam bir oturum geçmişi tablosu: başlangıç ve bitiş zamanı, süre, bayt aşağı ve yukarı, NAS ve her oturumun sonlandırılma nedeni.

Toplu işlemler

Aynı anda birden fazla abonenin sahibini, son kullanma tarihini, durumunu veya otomatik yenilemesini değiştirmek için veya çoğunu silmek için — Toplu Değişiklikleri ve Toplu'yu kullanın Araçları silin . Aboneleri bir e-tablodan toplu olarak oluşturmak için Dışa Aktar / İçe Aktar'ı kullanın.

Aboneler & planlar

Hotspot kartları

Ön ödemeli Erişim Noktası erişimi için bir grup kupon kartı oluşturun Bireysel aboneler yerine. Her kart kendine ait bir kullanıcı adı/şifre çiftidir. Binlercesi tarafından oluşturulan ve dağıtım için basılan hız ve sınırlar.

Kart grubu oluştur

1. Kullanıcılar → Erişim Noktası Kartları 'na gidin ve Yeni grup 'u tıklayın.
2. Aşağıdaki formu doldurun ve Grup oluştur 'a tıklayın — SAMM şunu oluşturur her kartın kimlik bilgileri otomatik olarak.

son kullanma tarihi , her kartın ilk girişinden itibaren sayılır; , tarihine kadar geçerlidir; kesin raf tarihidir; kartlar bu tarihten sonra kullanılamaz, etkinleştirilip etkinleştirilmedikleri.

Kart durumları

Yazdırma ve amp; izleme

Kartlarını görmek için bir grup açın, dağıtım için bunları bir PDF olarak yazdırın (yazdırma düzeni, Ayarlar'daki ISP logonuzu kullanır) ve kart başına kullanımı gözden geçirin. Kart trafik aynı zamanda Raporlarda da görünür. Kartlar sekmesinde her grubun kendi muhasebe görünümü vardır.

Ağ & yönlendiriciler

Yönlendiriciler (NAS)

NAS (Ağ Erişim Sunucusu), kimlik doğrulaması yapan bir yönlendiricidir RADIUS üzerinden SAMM aboneye karşı. Abone trafiğini taşıyan her yönlendirici NAS kaydına ihtiyacı var.

Yönlendirici ekle

1. MikroTik → NAS 'e gidin ve Yönlendirici Ekle 'ye tıklayın.
2. Aşağıdaki alanları doldurun ve kaydedin.

NAS listesi

Her yönlendirici tek bir tabloda gösterilir: Kimlik, NAS IP/ana bilgisayar adı, kısa ad, tür, maskelenmiş gizli (görüntülemek için hücreyi tıklayın), CoA ve API bağlantı noktaları ve bir gidiş-dönüş süresiyle birlikte canlı ping sonucu. Arama kutusu IP'ye göre filtreler, kısa ad veya açıklama.

Her satırın ⋮ menüsü, yönlendirici başına eylemleri taşır - Cihazı Görüntüle ve Bilgileri Yenile (yalnızca MikroTik ), Düzenle , Push RADIUS yapılandırması (yalnızca MikroTik ) ve Sil . Bir açılış mikrotik -tipi satır doğrudan kendisine atlar cihaz sayfası .

Komşuları keşfet

MikroTik cihazı taramak için Komşuları keşfet 'i tıklayın. Ağa bağlanın ve her adresi elle yazmanıza gerek kalmadan bunları NAS kayıtları olarak ekleyin.

RADIUS yapılandırmasını yönlendiriciye gönder

MikroTik NAS kaydı için satırın ⋮ menüsü Push RADIUS yapılandırması seçeneğini sunar — SAMM , elle yazmanız yerine, API üzerinden yönlendiriciyi sizin için yapılandırır. sen SAMM sunucu IP'sini (yönlendiriciden ulaşılabilir olmalıdır) ve kimlik doğrulamasını onaylayın, muhasebe ve CoA bağlantı noktaları; SAMM daha sonra yönlendiricide bir RADIUS girişi oluşturur veya değiştirir:

İletim tamamlandığında diyalog bir sonuç günlüğü gösterir.

MikroTik tarafını yapılandır

Bunun yerine yönlendiriciyi manuel olarak yapılandırırsanız:

• aynı 'nin paylaşıldığı, SAMM ana bilgisayarına işaret eden bir RADIUS sunucusu ekleyin gizli, PPP / Hotspot için etkinleştirildi.
• Kimlik doğrulama bağlantı noktasını 1812 ve muhasebe bağlantı noktasını 1813 kullanın.
• 3799 numaralı bağlantı noktasından gelen CoA'yı kabul edin.
• Muhasebe Ara Güncelleme aralığını yaklaşık 60 saniyeye ayarlayın — SAMM bu sıklıkta kullanımı biriktirir ve sınırları değerlendirir.

Yalnızca izleme cihazları

Monitör olarak eklenen bir yönlendirici, MikroTik envanterinde görünür ve pinglenir ve senkronize edilir, ancak RADIUS rolü yoktur; abonelerin kimliğini doğrulayamaz. Kullanım abone NAS'ları olmayan yönlendiricilere göz kulak olmak için.

Ağ & yönlendiriciler

MikroTik yöneticisi

Bir yönlendiricinin API kimlik bilgileri olduğunda, SAMM onu doğrudan yönetir MikroTik API — WinBox yok, SSH yok. MikroTik bölümü, her yönlendiricinin canlı bir envanteridir ve her cihaz, aşağıdakileri içeren bir ayrıntı sayfası açar: RouterOS 'ın neredeyse her bölümünü tarayıcınızdan yapılandıran on beş sekme.

MikroTik Monitörü

MikroTik → Monitör , yönlendirici başına bir kartın düzenini gösteriyor bir ızgara olarak. Her kart raporu — samm çalışanı tarafından yenilendi ve canlı anket yapıldı her 30 saniyede bir — erişilebilirlik noktası, RouterOS sürümü, CPU yükü ve çekirdek sayısı, hafıza kullanımı, aktif oturum sayısı, çalışma süresi ve son örneğin süresi.

Bir kart, NAS (kimlik doğrulamasını da yapan bir yönlendirici) olarak etiketlenir RADIUS üzerinden aboneler) veya monitör (izleme için eklenen bir cihaz) yalnızca). Ekle MikroTik yeni bir cihazı kaydeder; Şimdi yenileyin acil bir anket yapılmasını zorunlu kılıyor. Yalnızca monitör kartlarında sağ tıklama menüsü bulunur — Aç, Düzenle, Bilgileri Yenile, Sil.

Cihaz sayfası — on altı sekme

Tam yönetim sayfası için herhangi bir cihazı açın. Sekmeler dört gruba ayrılır.

İzleme

Yönetici

Yönetici → Genel sekmesi, cihazın temizlik sayfasıdır: Kimlik (yönlendirici adı), Saat (saat, saat dilimi ve NTP) ve Araçlar (yeniden başlatma, ping ve diğer tek tıklamayla yönlendirici eylemleri).

Ağ yapılandırması

Hizmetler & bakım

PPPoE ara güncelleme aralığı

PPPoE sekmesinde, Geçici güncelleme , yönlendirici, RADIUS muhasebe Ara Güncelleme paketlerini SAMM adresine gönderir. SAMM bu paketleri şunu yapmak için kullanıyor: bayt ve çalışma süresi sayaçlarını biriktirmek ve kotayı, günlük ve çalışma süresi sınırlarını değerlendirmek - bunlar olmadan, yaptırımı sınırlayın ve canlı oturum sayaçları durur . Önerilen değer: 5m .

Hotspot giriş sayfası

Erişim Noktası sekmesinden, giriş portalı giriş sayfasını yönetirsiniz: MikroTik varsayılan sayfayı koruyun, yerleşik şablonlardan birini uygulayın, veya kayıtlı tasarımlarınızdan birini uygulayın. SAMM görsel bir tasarım içerir düzenleyici ve şablon galerisi — oturum açma sayfasını özelleştirin ve doğrudan yönlendiricinin etkin noktası.

Uygulama farkındalıklı QoS

QoS sekmesi, SAMM'in yönlendiricide zaten gördüğü uygulamaları ve siteleri bir indirme önceliği planına dönüştürür. Her uygulamayı havuzdan sekiz öncelik yuvasından birine sürükleyin — rekabet altında 1. yuva ilk, 8. yuva son sırada hizmet alır; havuzda bırakılan uygulamalar şekillendirilmez. İsteğe bağlı olarak herhangi bir uygulamanın indirme hızını sınırlandırın (örneğin 10M) ve önceliğin üzerinde rekabet edeceği bir toplam indirme tavanı belirleyin. Kategoriye göre otomatik dağıt her şeyi tek tıkla düzenler — önce mesajlaşma ve konferans, en sona ise toplu indirmeler ve hız testleri gelir.

Gönderdiğinizde SAMM, yuvaları en yüksek öncelik önce gelecek şekilde, eşleşen paket işaretleme güvenlik duvarı kurallarıyla birlikte bir MikroTik queue tree halinde derler (SAMM:qos, parent=global etiketli). Bu, izlemeyi de güçlendiren aynı Websites & App filter kataloğu üzerine kuruludur; bu nedenle yalnızca yönlendiricide gerçekten görülen uygulamalar görünür — ve SAMM QoS'u kaldırmak, sayaçlarınıza dokunmadan her SAMM:qos nesnesini yönlendiriciden tamamen geri çıkarır.

Kurulum sihirbazı

Sihirbaz sekmesi her şeyi dokuz kısa adımda toplar ve sonunda tek bir grup halinde yönlendiriciye tam yapılandırma. sana kadar hiçbir şey gönderilmez son inceleme adımında onaylayın.

1. Hoş Geldiniz & 'i tespit et — SAMM yönlendiriciyi inceler ve ne olduğunu gösterir zaten yapılandırılmış olduğundan, bu öğeleri anında atlayabilirsiniz.
2. Köprü arayüzü — LAN köprüsünü adlandırın.
3. Köprü bağlantı noktaları — köprüye hangi fiziksel arayüzlerin katılacağını seçin.
4. DNS — yukarı akış çözümleyicilerini ayarlayın ( Google için tek tıklamayla ön ayarlar, Cloudflare , Quad9 ve daha fazlası), önbellek boyutu ve isteğe bağlı olarak bir DNS içerik filtresi.
5. İnternet — bir veya daha fazla WAN yukarı bağlantısı ekleyin (Statik / DHCP / PPPoE).
6. RADIUS'tan SAMM 'ya — yönlendiriciyi SAMM ana makinenize yönlendirin kimlik doğrulama, muhasebe ve CoA.
7. Hizmetler — sihirbazın bir PPPoE sunucusu oluşturup oluşturmayacağını seçin. Hotspot sunucusu veya her ikisi.
8. PPPoE / Erişim Noktası ayrıntıları ve Güvenlik duvarı — havuzlar, profiller, kiralama kez artı güvenlik duvarı & NAT kuralları.
9. İncele ve incele tuşuna basın — uygulanacak komutların tam listesini görün gönderin, ardından hepsini yönlendiriciye gönderin.

Ağ & yönlendiriciler

CoA & canlı değişiklikler

CoA (Yetki Değişikliği), SAMM 'nin bir abonenin haklarını nasıl değiştirdiğidir çevrimiçiyken oturum açın — hızlarını artırmak veya azaltmak ya da bağlantılarını kesmek için — yeniden bağlanmalarını beklemeden.

Bir değişiklik canlı aboneye nasıl ulaşır

SAMM hiçbir zaman yönlendirici değişikliğini doğrudan bir düğme tıklamasıyla gerçekleştirmez. Her yönetici eylemi tek bir güvenli yolu izler:

1. Eylem, sıraya alınmış bir komut olarak bir denetim günlüğüne kaydedilir.
2. samm-radius hizmeti bir sonraki onay işaretinde sırayı boşaltır ve uygulanır değişiklik yapılır ve abone çevrimiçiyse bir CoA oluşturulur.
3. CoA giden kutusu boşaltılır ve paket yönlendiriciye gönderilir.

Sürenin sona ermesi, hızlı pencere kenarları, günlük sıfırlamalar gibi zamana bağlı olaylar aynı giden kutusunu besler. Gecikmenin üst sınırı bir samm yarıçaplı onay işaretidir (varsayılan olarak 30 sn; daha düşük Daha sıkı yaptırım için bunu Ayarlar 'da yapın).

Hibrit CoA

SAMM , oturumu yerinde değiştirmek için önce bir CoA Güncellemesi gönderir. Eğer yönlendirici, yapılandırılmış yeniden denemelerden sonra bunu reddeder, SAMM otomatik olarak bir Bağlantıyı Kesme İsteği — abone yeniden bağlanır ve yeni bağlantıyı alır ayarlar. Bu karma strateji, MikroTik donanım yazılımı sürümünde çalışır.

CoA Giden Kutusu sayfası

Kullanıcılar → CoA Giden Kutusu bu kuyruğun canlı görüntüsüdür. samm-radius tek gönderendir — yönetici paneli hiçbir zaman CoA'yı iletmez doğrudan — ve her onay işaretinde kuyruğu boşaltır. Sayfa her seferinde otomatik olarak yenilenir 30 saniye.

Sayfada altı sayaç bulunuyor: Beklemede, Gönderildi, NACK (yeniden deneniyor), Bitti, Başarısız ve Toplam . Tabloyu duruma ve eyleme göre filtreleyin ( güncelle veya bağlantıyı kes ) veya kullanıcı adına, NAS IP'sine veya sebep.

Her satırda kullanıcı, yönlendirici, eylem, deneme sayısı, neden ve oluşturulan ve kez gönderildi. Satır başına işlemler, başarısız veya eksik bir paketi Yeniden Denemenize olanak tanır, Hâlâ uçuşta olan tanesini iptal edin veya şuraya Nitelikleri açın: paketin taşıdığı RADIUS niteliklerini tam olarak inceleyin. Kenar çubuğu rozeti önemlidir bekleyen satırlar; Kontrol Paneli 24 saatlik arızaları izler. Sağlıklı bir sistem bu kuyruğu tutar neredeyse boş.

Günlük operasyonlar

Pano & canlı oturumlar

Genel Bakış altındaki iki ekran, başlayacağınız yerdir her vardiyada — tüm sistemin sağlığı için Kontrol Paneli, şu anda tam olarak kimin bağlı olduğu.

Pano

Genel Bakış → Kontrol Paneli operatörün ana ekranıdır. bir üstteki dönem seçici — Bugün, 7g, 14g, 30g, 90g — dönemi ayarlar Trend grafiği ve tarihle sınırlı rakamlar için pencere.

Altı KPI karesi

Her kutucuk canlı bir sayaç ve bir kısayoldur; doğrudan numaranın arkasındaki filtrelenmiş listeye geçmek için ona tıklayın.

Kullanıcılar & canlı oturumlar grafiği

Günlük anlık görüntü çizgi grafiği, seçilen dönem boyunca üç seriyi çizer: aktif kullanıcı , çevrimiçi oturum ve süresi dolmuş kullanıcılar ; böylece büyüme ve kayıplar bir bakışta görülebilir.

İşlem hattı sağlığı

Bu panel, denetim motorunun kalbidir. Sağlıklı bir sistemde kuyruklar sıfırda veya sıfıra yakın durumda; yüksek kalan bir sayı, takılıp kalmış bir hizmete veya bir soruna işaret ediyor Yönlendirici değişiklikleri reddediyor.

Son etkinlik tabloları

Grafiğin altındaki dört tablo, az önce olup bitenlerin kapsamlı bir görünümünü veriyor; her biri Tümünü görüntüle tam sayfasına bağlantı:

• En son CoA giden kutusu — eylem, kullanıcı, durum (tamamlandı / beklemede / onaylanmadı / başarısız oldu), deneme sayısı, neden ve zaman.
• Son yönetici işlemleri — eylem, hedef, onu tetikleyen aktör, henüz uygulanıp uygulanmadığı ve zaman.
• Son aboneler — durumları ve son kimlik doğrulama zamanıyla birlikte en yeni hesaplar.
• Yönlendiriciler — ulaşılabilir/ulaşılamaz/verisiz durum noktasına sahip her NAS.

Canlı Oturumlar

Genel Bakış → Canlı Oturumlar her aboneyi listeler yönlendiriciler şu anda RADIUS muhasebesi üzerinden çevrimiçi olarak rapor veriyor. sayfa her 30 saniyede bir otomatik olarak yenilenir ; manuel Yenile düğmesi başlıkta bulunur.

Listeyi filtreleme

• Ara — siz yazdıkça gönderilen kullanıcı adı, çerçeveli IP veya NAS IP ile eşleşir.
• Yönlendirici — listeyi tek bir NAS'taki oturumları içerecek şekilde daraltın.
• Yalnızca kısılmış — yalnızca bir sınırın düşük hızda tuttuğu aboneleri gösterir.
• Sayfa başına — 20, 50, 100 veya 200 satır.

Her satır neyi gösterir

Oturumu kesme

Bir satırdaki Bağlantıyı Kes düğmesi, bir CoA-Bağlantı Kesme 'yi sıraya koyar bir onay isteminden sonra tam olarak bu oturum için (neden admin_manual ). Abone hemen düşer; eğer hesapları hala aktifse, bunu yapmakta özgürdürler. yeniden bağlanın. Paketi CoA Giden Kutusu 'nda izleyin.

Günlük operasyonlar

Raporlar & analizler

Genel Bakış → Raporlar analiz görünümüdür — abone trendler, zaman içindeki trafik ve ağınızdaki en yoğun kullanıcılar ve kartlar.

Aralık seçme

Sayfadaki her şekil bir tarih aralığına bağlıdır. Bir ön ayar seçin — 7d, 14d, 30d, 90d — veya açık bir şekilde başlangıç yazın ve bitiş tarihlerini seçin ve Uygula 'yı tıklayın. Bir yükleme kaplaması kapakları 90d gibi uzun menzilli bir sorgu çalıştırılırken sayfa.

Abone & oturum trendleri

Seçilen aralıkta üç seri içeren çizgi grafik: Etkin aboneler, Çevrimiçi oturumlar ve Süresi Dolmuş aboneler. Ağınızın büyümesini, kaybını ve yoğun saatlerini tespit etmek için bunu kullanın.

Günlük trafik

yükleme ve indirme bayttan oluşan yığılmış çubuk grafik günlük. Bir günün üzerine gelindiğinde yükleme ve indirme rakamları artı bunların birleştirilmiş hali gösterilir Araç ipucu altbilgisinde toplam .

İlk 10 listesi

Her biri Büyük Britanya cinsinden hacme göre sıralanan dört tablo, en yoğun trafiğe sahip hesaplarınızı gösterir:

Varlığa göre trafik

Hesap başına trafiğin sayfalandırılmış, aranabilir bir tablosu. İki sekme listelediklerini değiştirir:

• Kullanıcılar — her abonenin adı, planı ve bugünkü durumuyla birlikte yükleme/indirme MB cinsinden ve bu ayın yükleme/indirme işlemi GB cinsinden.
• Kartlar — grubu, durumu ve aynı bilgileri içeren her bir erişim noktası kartı bugün / ay trafiği bölünmüş.

arama kutusu siz yazarken tabloyu filtreler; the Sayfa başına seçici 20 ila 200 satır alır. Her satır şuraya bağlanır: söz konusu abonenin veya kartın ayrıntı sayfası.

Günlük operasyonlar

Muhasebe & faturalandırma

SAMM yerleşik olarak eksiksiz bir çift girişli defter tutma sistemine sahiptir — faturalar, giderler, makbuzlar, ödemeler, satıcılar, sabit kıymetler ve tam mali ifadeler. Entegre edilecek ayrı bir faturalandırma ürünü yok ve muhasebeci yok Kitapları düz tutmak gerekiyordu.

Muhasebe sayfası on sekme halinde düzenlenmiştir.

Genel Bakış

Finansal anlık görüntü. En üstte dört manşet figürü yer alıyor:

Aşağıda: her nakit paranın bir tablosu. bakiyesi ile birlikte banka hesabı ve Son 1, 2, 3, 6 veya 12 aylık gelir-giderler tablosu.

Faturalar

Fatura, sizin düzenlediğiniz bir faturadır. Yeni fatura 'yı tıklayın ve şunu doldurun:

Faturalar ayrıca bir abonenin planı gerçekleştiğinde otomatik olarak oluşturulur. şu şartla yenilenir (kullanıcının Sona Ermeyi Yenile işlemiyle veya otomatik yenileme yoluyla) planın bir bedeli var. Liste duruma göre filtreler: ödenmemiş, kısmi, vadesi geçmiş, ücretli — ve fatura numarasına veya müşteriye göre arama yapar. Herhangi bir faturayı açın ayrıntı sayfası ve yazdırılabilir bir PDF; aboneler kendi kopyalarını şuradan indirebilirler: müşteri portalı ve Telegram bot.

Giderler

Gider, ISP'yi çalıştırmak için harcanan paradır. Yeni gider , bir kategorisi (gider hesabı), ödenen satıcı, tutar, tahakkuk tarihi ve isteğe bağlı vade tarihi. Her giderin aynı ödenmemiş / kısmi / vadesi geçmiş / ödenmiş 'i vardır fatura, ayrıntı sayfası ve yazdırılabilir bir makbuz PDF'si olarak yaşam döngüsü.

Makbuzlar & Ödemeler

Bu iki sekme, fatura veya giderden farklı olarak fiili olarak hareket eden nakdi kaydeder buna neden oldu.

• Makbuzlar — cinsinden para : müşteriden alınan nakit, nakit hesaplarınızdan birine giren satıcı veya diğer gelir. Bir fatura fatura; makbuz, karşılığında gelen paradır.
• Ödemeler — para çıkışı : bir gider karşılığında ödenen nakit veya bir satıcıya.