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:

• A Tek komut (Linux) En hızlı yol — taze bir Ubuntu / Debian sunucusuna tek satır yapıştırın. Üretim için önerilir.
• B Manuel paket Sürüm arşivini kendiniz indirip kurucuyu çalıştırın — çevrimdışı / yalıtılmış sunucular için idealdir.
• C Docker Compose Aynı SAMM, çok mimarili konteynerler olarak — her Docker ana makinesi, Windows Docker Desktop, Apple Silicon Mac'ler.
• D MikroTik konteyneri Tüm yığını doğrudan RouterOS 7.23+ yönlendiricide çalıştırın. Harici Linux makinesi gerekmez.
• E Sunucu ISO (hazır kurulum) Boş bir makineyi hazır ISO'dan başlatın — işletim sistemini ve en güncel SAMM'ı kendi kendine kurar. Linux bilgisi gerekmez.
• i Kurulum referansı Ortam değişkenleri, kurulum aşamaları, etkileşimli sorular ve yükseltme.

Ön koşullar

• Temiz bir sunucu: Ubuntu 22.04 / 24.04 / 26.04 LTS veya Debian 12 / 13. Yalnızca sunucu sınıfı Linux — masaüstü türevleri 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).

Kurulum

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ı.

Ülkenizde github.com engelliyse bunun yerine Cloudflare üzerindeki yansıyı kullanın — aynı kurulum, GitHub'dan hiçbir şey indirilmez. (Yukarıdaki standart komut da engelli GitHub'ı algılayıp bu yansıya kendiliğinden geçer.)

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

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.

Kurulum

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ı,\n 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.

Kurulum

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'ı kurar, /opt/samm-docker/ içine güçlü rastgele veritabanı parolası önceden doldurulmuş bir docker-compose.yml bırakır ve yığını başlatır. mhdhaidarah/samm imajı, bare-OS kurulumuyla aynı derlenmiş paketten oluşturulur — tasarım gereği kapalı kaynak.

Çoklu mimari — aynı etiket linux/amd64 ve linux/arm64 için yayınlanır ve doğru sürüm etiketten otomatik seçilir: herhangi bir Docker ana bilgisayarında docker pull (Intel/AMD, ARM sunucu, Apple Silicon Mac) ve yönlendiricinin kendisinde MikroTik RouterOS 7.23+. Tek dosya, tüm platformlar.

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
# optional: edit docker-compose.yml and replace change-me-strong-random-string
docker compose up -d

Birkaç özellik henüz Docker modelinde mevcut değildir (aşamalı lisans kilitleme, dinamik FreeRADIUS yeniden yükleme).\n 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.\n Tam v1 uyarıları ve manuel yükleme yolu için Docker varyantının README dosyası.

Windows'ta ( Docker Desktop ) — yalnızca değerlendirme

Yükle\n Windows için Docker Desktop (ilk başlatmada WSL2 arka ucunu ayarlamasına olanak tanır).\n 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
# optional: notepad docker-compose.yml — replace change-me-strong-random-string with your own password
docker compose pull
docker compose up -d

Docker Desktop → Kapsayıcılar 'da yığın önyüklemesini izleyin — samm grubu 8 hizmete genişliyor. Hepsi yeşil olduğunda yönetici 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

Şunu sökün: yükleme dizininden docker compose down -v ( -v , postgres birimini ve Fernet anahtarını siler; veri eklediyseniz önce bunları yedekleyin).

Kurulum

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

Desteklenir: kapsayıcı özellikli tüm MikroTik yönlendiriciler — RB5009, hAP ​​ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009 ve benzerleri (arm64), ayrıca x86 RouterOS ve CHR (amd64). Desteklenmiyor: armv7 / mipsbe / smips /tile / ppc cihazları (hEX, RB750, daha eski RB modelleri) — konteyner desteği yok veya SAMM yığını için çok az RAM/CPU. RouterOS 7.23 veya daha yenisi gereklidir (eski sürümler, çoklu arşiv etiketinden mimariyi seçemez).

1. Yönlendiriciyi hazırlayın

container paketini kurun (mikrotik.com/download'daki extra_packages.zip içinden — uygun container-*.npk dosyasını Files üzerinden yükleyip yeniden başlatın). Ardından konteyner modunu etkinleştirin (tek seferlik — yalnızca fişi çekip takarak etkinleşir, normal yeniden başlatma yetmez):

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

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. compose dosyasını kopyalayın

Her platform için tek dosya. change-me-strong-random-string (Postgres parolası — her yerde aynı güçlü değer) ve change-me-random-token değerlerini değiştirin. Sonra WebFig/WinBox'ta: Container → Apps → + New → YAML, yapıştırın, 2. adımdaki ext4 diski depolama olarak ayarlayın ve gönderin. RouterOS 7.23+ doğru CPU mimarisini imaj etiketlerinden otomatik çeker.

name: samm

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

  samm-api:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["api"]
    environment:
      SAMM_ROLE: api
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_HOST: 0.0.0.0
      SAMM_API_PORT: 8000
      SAMM_API_WORKERS: 2
      WA_BRIDGE_URL: http://wa-bridge:8787
      WA_BRIDGE_TOKEN: change-me-random-token
    depends_on:
      postgres:
        condition: service_healthy
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:8000/health >/dev/null || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 30
      start_period: 30s
    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  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

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

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

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

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

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

volumes:
  pgdata: {}
  etcsamm: {}
  sammvar: {}
  sammlogs: {}
  sammlocales: {}
  wabridge_auth: {}      # WhatsApp bridge multi-device session

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

SAMM kapsayıcıları çalışmaya başladıktan sonra yönetici 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.

5. Güncelleme — elle yedekleme ve geri yükleme

MikroTik kapsayıcı kurulumunu yeni bir sürüme taşımak için:

1. SAMM içinde, Araçlar → Yedekleme seçeneğine gidin, bir yedek oluşturun ve dosyayı bilgisayarınıza indirin .
2. Yönlendiricide uygulamayı kaldırın ve yeni sürümle tekrar ekleyin. versiyon.
3. Yeni SAMM dosyasını açın, Araçlar → Yedekle seçeneğine gidin ve indirdiğiniz dosya.

Bu yalnızca MikroTik kapsayıcısı için geçerlidir. Docker tarihinde ( Linux , Windows veya bir Linux VM) güncelleme docker compose pull ise docker compose up -d ve verilerinize dokunulmaz; birimler konteynerler ve hayatta kalmak.

Kurulum

Seçenek E — SAMM Server ISO (hazır kurulum)

SAMM Server ISO boş herhangi bir makineyi veya sanal makineyi hazır bir SAMM sunucusuna dönüştürür: başlatın, gösterdiği tek ekranda DHCP veya sabit IP seçin, onaylayın ve bırakın. Ubuntu Server 24.04 LTS (küçültülmüş) kurar, ana makineye samm-server adını verir ve ilk açılışta en son SAMM sürümünü otomatik indirip kurar — ISO asla eskimez. Konsolda SAMM açılış ekranı ile sunucunun IP'sini, yönetim paneli adresini ve varsayılan giriş bilgilerini gösteren bir karşılama görünür; samm-tools komutu bakım araçlarına (sağlık kontrolü, veritabanı yedekleme/geri yükleme, yönetici parola sıfırlama) doğrudan erişim sağlar.

Bir USB belleğe yazın (Rufus, balenaEtcher veya dd) ya da bir sanal makineye bağlayın, başlatın ve ağ sorusunu yanıtlayın. Kurulumdan sonra varsayılan girişler — panel: admin / admin, işletim sistemi: samm / samm veya root / samm — hepsini değiştirin.

SAMM Server ISO'yu indir 2.2 GB

SHA-2568b6d57e286a4c0524d96b5b4970b57079113e000fc8229f94360410c12f5102e

Kurulum

Kurulum referansı

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://<your-server>/admin/ 'ı açın (HTTP bağlantı noktasını kullanın) 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\n veritabanı. Prosedürün tamamı için Yönlendiriciler (NAS) 'e bakın,\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 sınırlar .

4 · Abone ekleyin

Kullanıcılar → Yeni müşteri 'ye gidin, giriş bilgilerini girin\n kimlik bilgileri ve bir plan seçin. Abone hemen bağlanabilir. Ön ödemeli için\n 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 .

Başlarken

Başka bir sistemden geçiş

Halihazırda başka bir RADIUS faturalandırma sistemi mi kullanıyorsunuz? SAMM onun verilerini okur ve planlarınızı ve abonelerinizi yeniden oluşturur, böylece hiçbir şeyi yeniden yazmanız gerekmez. Aboneler mevcut hizmet parolalarını ve bitiş tarihlerini korur; yani tam olarak eskisi gibi oturum açmaya devam ederler.

Araçlar → Dışa / İçe Aktar bölümüne gidin ve Başka bir sistemden geçiş altından eski sisteminizi seçin. Araçlar bölümünün geri kalanı gibi, yalnızca süper yöneticilere açıktır.

Ne yüklenmeli

Veritabanı yedekleri çoğu zaman birkaç gigabayttır; sorun değil, dosyayı olduğu gibi yükleyin. Sıkıştırılmış yedeklerin önce açılması gerekmez.

Nasıl çalışır

1. Dosyayı yükleyin. Henüz hiçbir şey yazılmaz.
2. Önizlemeyi inceleyin. Oluşturulacak planları ve aboneleri listeler, atlamak veya düzeltmek zorunda kaldığı her şeyi bildirir ve siz onaylamadan önce toplamı lisansınıza karşı denetler.
3. SAMM'de zaten var olan kullanıcı adlarına ne olacağını seçin — onları atlayıp SAMM kaydını koruyun ya da adını ve iletişim bilgilerini eski sistemden güncelleyin.
4. İçe aktarın. Her satır bağımsız olarak yazılır, bu yüzden tek bir hatalı satır asla geri kalanı geri almaz.

Neler aktarılıyor

• Planlar — eski sistemin kaydettiği ölçüde ad, hızlar, fiyat, süre ve trafik kotası.
• Aboneler — kullanıcı adı, hizmet parolası, ad, iletişim bilgileri, bitiş tarihi, plan, statik IP ve MAC.
• Eski sistemde devre dışı bırakılmış aboneler devre dışı kalır.

Faturalandırma, faturalar, ön ödemeli kartlar, destek talepleri, muhasebe ve yönetici günlükleri bilinçli olarak içe aktarılmaz — bunlar eski sistemin veri modeline aittir ve nadiren temiz biçimde karşılık bulur.

Sütunuyla uyuşmayan değerler

Gerçek veritabanları dağınıktır: e-posta kutusuna yazılmış bir adres, cep telefonu alanına düşmüş bir not, Arapça klavyeyle yazılmış bir telefon numarası. SAMM her değeri, sütununun içermesi gereken şeye karşı denetler. Uymayan her şey o alanın dışında tutulur ve bunun yerine abonenin yalnızca yöneticiye açık notlarına, nereden geldiği etiketlenerek kaydedilir — böylece hiçbir şey kaybolmaz ve hiçbir alan kirlenmez. Önizleme bunun kaç değeri etkilediğini size söyler.

Pro Radius ayrıntıları

Pro Radius aboneleri dışa aktarır ama planları aktarmaz; bu yüzden SAMM planları her abonenin hizmet seviyesinden çıkarır ve hızı adından alır ("4MBPS" adlı bir hizmet 4 Mbps'lik bir plana dönüşür). Üç şey bu dosyada hiç yoktur ve sonradan gözden geçirmeniz gereken makul varsayılanlara ayarlanır:

• Süre — 1 ay olarak ayarlanır. Her abonenin gerçek bitiş tarihi değiştirilmeden içe aktarılır, dolayısıyla bu yalnızca gelecekteki yenilemeleri etkiler.
• Yükleme hızı — indirme hızıyla eşitlenir.
• Fiyat — 0 olarak ayarlanır.

Bilmekte fayda var

• Birden fazla kez güvenle çalıştırabilirsiniz. Aynı dosyayı yeniden içe aktarmak, hâlihazırda var olan herkesi çoğaltmak yerine atlar.
• Lisansınız yine de geçerlidir. Dosyada katmanınızın izin verdiğinden fazla abone varsa, önizleme bunu baştan söyler ve kaçının sığacağını belirtir — yükseltebilir veya kısmi bir küme içe aktarabilirsiniz.
• Önce bir yedek alın — özellikle zaten gerçek veri bulunan bir kuruluma içe aktarıyorsanız.

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.

Temiz kurulum 9 hazır paketle gelir — sekiz aylık hız kademesi ve bir "Expired" kısma paketi — hemen satabilir veya kendi paketlerinizi oluşturabilirsiniz. Tohumlama yalnızca ilk kurulumda çalışır ve eklediğiniz paketlerin üzerine asla yazmaz.

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 tükenince ne olacağını seçersiniz: aboneyi geçireceğiniz bir sonraki paket seçin veya — bağlantıyı kes — olarak bırakın. Günlük limit kesmek yerine kısar: varsayılan olarak kısma hızlarını doğrudan girersiniz (indirme/yükleme alanları) ya da daha yavaş bir "sonraki" paket seçersiniz — her iki durumda da abone bir sonraki günlük sıfırlamada otomatik olarak asıl paketine döner.

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.

Çoğalt bir planı tam olarak kopyalar - hızlar, sınırlar, hız aralıkları ve fiyat - yeni bir ad altında; bu, bir tarifeyi elle yeniden oluşturmaktan çok daha hızlıdır numara. Verdiğiniz isim daha önce alınmışsa bir sonraki boş numara kullanılır.

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.

Aynı anda birden fazla abone oluşturun

Yeni toplu kullanıcılar , tek geçişte numaralandırılmış bir hesap özeti oluşturur — Bir köy dağıtımına, bir otele veya bir satıcıya bir oturum açma bloku vermenin olağan yolu. Kaç tane, hangi sayıyla başlayacağınızı ve kaç basamakla doldurulacağını seçin (3, 001 , 002 , …); diğer her şey (plan, son kullanma tarihi, otomatik yenileme) bir kez doldurulup hepsine uygulandı. Bir şifreyi paylaşıyorlar.

fatura seçeneği , gruptaki her kullanıcı için geçerlidir ayrı ayrı , yani elli adetlik bir seri ya elli fatura oluşturur ya da hiç fatura oluşturmaz ve toplam taahhütte bulunmadan önce gösterilir.

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:

Detay sayfası, abonenin giriş şifresini bir göz düğmesinin arkasında da gösterebilir (tek tıkla kopyalama) — müşteri bilgilerini sorduğunda pratiktir.

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\n çoğunu silmek için — Toplu Değişiklikleri ve Toplu'yu kullanın\n Araçları silin . Aboneleri bir e-tablodan toplu olarak oluşturmak için Dışa Aktar / İçe Aktar'ı kullanın.

Bir aboneyi belirli yönlendiricilerle kısıtlama

Bir abone (veya kart grubunun tamamı) belirli bir NAS'a sabitlenebilir düzenleme formundan yönlendiricileri seçin. Hiçbir yönlendirici seçilmediğinde hesap herhangi bir cihazda çalışır. NAS'ı; bir veya daha fazlası seçildiğinde kimlik doğrulaması yalnızca bunlardan kabul edilir yönlendiriciler — RADIUS'un kendi içinde arıza kapatma işlemi uygulanır. Setin değiştirilmesi herhangi bir bağlantıyı keser Artık izin verilmeyen bir yönlendiricide anında canlı oturum. By-NAS yöneticisi ile birleştirildi kapsam belirleme, çoklu şube ve franchise kurulumlarının her şubenin abonelerini bu şekilde tutması o şubenin yönlendiricilerinde.

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.

Grup yönetimi

Bir grubun ⋮ menüsünden tüm kartları tek seferde etkinleştirin veya devre dışı bırakın, grubun "geçerlilik" tarihini uzatın, partiye kart ekleyin veya bilgilerini düzenleyin. Tekil kartlar, kart detay sayfasından sıfırlanabilir (kota, bağlantı süresi veya bitiş) ya da devre dışı bırakılabilir.

Yinelenen grup her ayarı tam olarak kopyalar ve aynısını oluşturur yeni koda sahip kart sayısı — bir kart kodu yalnızca bir karta ait olabilir, yani bir kopya eskisinin bir kopyası değil, yeni bir baskı çalışmasıdır. Yeniden sipariş vermenin hızlı yolu tükenen kupon partisi.

Kart durumları

Yazdırma ve izleme

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

Aboneler & planlar

Self Servis — misafirler kendileri oturum açar

Kuponun tam tersi: kimse hiçbir şey basmaz ve kimse basmaz bir masada duruyor. Bir ziyaretçi erişim noktanıza bağlanır ve Kaydol 'a dokunur oturum açma sayfasında adını ve cep telefonu numarasını yazar ve SAMM onlara bir şifreyi SMS, WhatsApp veya e-postayla girin. Aynı sayfaya giriyorlar ve çevrimiçi — ve misafiri kullanan herkesin adlandırılmış, dışa aktarılabilir bir kaydını tutarsınız ağ.

Tipik mekanlar: restoranlar ve kafeler, oteller ve misafirhaneler, fuarlar ve fuarlar, konferanslar, alışveriş merkezleri, klinikler ve bekleme salonları, spor salonları, ortak çalışma alanları, salonlar, havaalanı bekleme salonları, stadyumlar, kampüsler, kütüphaneler, araba galerileri, düğün mekanları, tatil köyleri ve kamp alanları.

Açma

1. Öncelikle bir dağıtım kanalı oluşturun. Bildirim Merkezi → SMS'i etkinleştirin veya WhatsApp ve kendinize bir test mesajı gönderin. Bir kanal çalışana kadar başka hiçbir şey çalışmaz.
2. Self Servis → Ayarlar : işaretleyin Konukların kendilerini kaydetmesine izin verin , hangi kanalların yapılacağını seçin teklif edebilir ve bir şifrenin ne kadar süre geçerli kalacağını ve misafirin ne kadar beklemesi gerektiğini ayarlayabilirsiniz başka bir tane istemeden önce.
3. tarafından gelen Şifre Kodunu Self Serviste bırakın Değiştirmek için bir nedeniniz olmadığı sürece kart grubu; hıza o grup karar verir ve kaç cihazın bir şifreyi paylaşabileceği.
4. Kullandığınız her giriş tasarımı için Kayıt sekmesini açın — aşağıya bakın. Bu insanların kaçırdığı adımdır.