Dokümantasyon

SAMM dokümantasyon

İlk kurulumdan günlük işlemlere kadar eksiksiz operatör kılavuzu.

25 konu 8 bölüm Tek komutla kurulum
Hızlı kurulum

Tek bir komutla, dakikalar içinde çevrimiçi olun.

Yeni bir Ubuntu veya Debian sunucusunda — ya da Windows üzerinde PowerShell'de — tek bir satır komut çalıştırın; yükleyici en güncel sürümü indirir ve tüm SAMM yığınını sizin için kurar.

Kurulum kılavuzunun tamamını okuyun
Ubuntu / Debian — root olarak çalıştırın
curl -fsSL https://samm.securytik.com/install.sh | sudo bash
Windows — yönetici olarak PowerShell üzerinden çalıştırın
irm https://samm.securytik.com/install-windows.ps1 | iex
Oynatma Listesi Video kursu Kurulumdan günlük işlemlere kadar SAMM'i öğrenin — kapsamlı bir video kursu SAMM kurulumunu ve günlük kullanımını adım adım anlatan ücretsiz bir YouTube oynatma listesi — bu kılavuzda yer alan konuların aynısı, video formatında. YouTube'da izle

Başlangıç

Genel bakış & mimari

SAMM — SecuryTik Active Mikrotik Manager — MikroTik PPPoE & Hotspot ağları için eksiksiz bir ISP yönetim platformudur. Tek bir yükleyici, boş bir Linux sunucusunu tam kapsamlı bir AAA, faturalandırma ve abone yönetim sistemine dönüştürür.

SAMM kimler içindir

SAMM, MikroTik RouterOS kullanan kablosuz ISP'ler, fiber operatörleri ve hotspot sağlayıcıları için geliştirilmiştir. Aboneleri PPPoE, Hotspot veya IPoE/DHCP üzerinden kimliklendiriyorsanız ve hız paketlerini, veri kotalarını, son kullanma tarihlerini ve faturalandırmayı yönetmeniz gerekiyorsa; SAMM tüm bunları tek bir ekrandan gerçekleştirir.

IPoE/DHCP aboneleri, DHCP Option 82 circuit-id'leri (fiziksel erişim portu — profesyonel ISP yöntemi) veya cihaz MAC adresleri ile tanımlanır ve DHCP sunucusunun radius-password değeri basitçe router'ın kendi RADIUS shared secret değeridir, dolayısıyla ek bir yapılandırma gerekmez.

IPv6 dual-stack isteğe bağlı bir seçenektir: her abone IPv4'ün yanı sıra IPv6 alabilir. Bunu router sihirbazında etkinleştirin ve delegasyon (DHCPv6-PD) ön ek uzunluğunu —varsayılan olarak /56 veya /48 ile /64 arasında herhangi bir değer— ve dağıtılacak IPv6 bloklarını seçin. SAMM'in döndürdüğü her Access-Accept, bir WAN IPv6 havuzunun yanı sıra abonenin LAN'ine delegasyon yapılmış bir rota ön eki içerir; böylece müşterinin kendi router'ı (rota modunda) bunu /64'lere böler ve cihazları için SLAAC çalıştırır — bu, standart ISP ön ek delegasyon modelidir. PPPoE, Hotspot ve IPoE ile çalışır ve kurumsal müşteriler için abone başına statik bir IPv6 ön eki sabitlenebilir.

Çalışma prensibi

SAMM, sıcak yolu veritabanına yakın tutar. FreeRADIUS her kimlik doğrulama ve muhasebe paketini işler; her muhasebe Interim-Update işleminde, kullanımı biriktirmek ve limitleri değerlendirmek için doğrudan PostgreSQL fonksiyonlarını çağırır — aboneler çevrimiçiyken herhangi bir Python gidiş-dönüş işlemi gerçekleşmez.

Dört yürütme yüzeyi, tek bir veritabanı üzerinden birlikte çalışır:

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

Beş servis

ServisRol
samm-apiYönetici portalı + müşteri self-servis portalı + REST API
samm-radiusCoA giden kutusunu boşaltır; süre aşımı / günlük sıfırlama / hız penceresi taramalarını yürütür
samm-workerRouter'lara ping atar; MikroTik cihaz meta verilerini API üzerinden senkronize eder
samm-notificationE-posta & Telegram bildirimlerini hız sınırlamalı tek bir kuyruk üzerinden iletir
samm-telegramEtkileşimli Telegram self-servis botunu çalıştırır

SAMM ne işe yarar

AAA core

PPPoE & Hotspot kimlik doğrulaması, kullanıcı başına hız sınırlaması, hibrit CoA.

Planlar & limitler

Hız kademelerinin yanı sıra dört bağımsız limit ve zamanlanmış hız pencereleri.

Aboneler

PPPoE, Hotspot ve IPoE/DHCP kullanıcılarının yanı sıra yazdırılabilir PDF formatındaki ön ödemeli hotspot kupon kartları.

Faturalandırma

Plan başına fiyatlandırma, otomatik faturalar, çift kayıtlı makbuz/ödeme/gider defteri.

Self-servis

Kullanım, faturalar ve destek talepleri için bir müşteri web portalı ve bir Telegram botu.

İşlemler

Canlı MikroTik envanteri, rol tabanlı yöneticiler, yedekleme & geri yükleme, toplu işlem araçları.

Sistem

Yerleşik WireGuard VPN, Cloudflare Tünel, sekiz dil, temalı kullanıcı arayüzü.

Bildirimler

Yenileme, süre dolumu, kota ve makbuz uyarıları e-posta ve Telegram üzerinden iletilir.

Bu kılavuzun geri kalanı, bu alanların her biri için bir uygulama rehberidir. Soldaki menüyü kullanın veya Kurulum ile başlayın.

Başlangıç

Yenilikler

SAMM kendisini güncellediği için her kurulum, bir sonraki güncellemede bu özelliklere sahip olur. Her satır, özelliğin nasıl kullanılacağının açıklandığı sayfaya bağlantı verir.

6.0

  • Kart tasarımları: basılı Hotspot kartınızı kendiniz tasarlayın (boyut, arka plan, logonuz ve kartla tek taramada giriş yapan bir QR kodu) ya da on hazır tasarımdan biriyle başlayın. Her grup, baskı için bir tasarım ve termal yazıcıda hızlı yazdırma (80 veya 58 mm) için bir tasarım tutar. Hotspot kartları
  • Tek kart ekleyin veya liste içe aktarın: + Card, seçtiğiniz kullanıcı adı, parola ve adla bir kart ekler; Import bir CSV veya Excel listesini önizlemeyle getirir. Hotspot kartları
  • Router üzerinde kalan süre ve veri: Hotspot durum sayfası kartta kalanı gösterir ve bittiğinde router oturumu sonlandırır. Hotspot kartları
  • Kullanıcı başına IP havuzu (örneğin bir CGNAT havuzu), router'larınızın havuzlarından seçilir. CGNAT ve IP havuzları
  • Dünyadaki tüm saat dilimleri, Orta Doğu listenin başında.
  • Derin inceleme: MikroTik BNG'lerinizi ve süreyi seçin; ardından puanlı ve önce ne yapılacağını gösteren bir raporu dilinizde, sayfa ya da PDF olarak okuyun. Yalnızca router'ı okur. Derin inceleme
  • SCOOP AI: her sayfanın altında bir asistan. Kullanıcılarınız, paketleriniz, faturalarınız ve router'larınız hakkında kendi cümlelerinizle sorun; para, silme işlemleri ve router değişiklikleri sizin Approve onayınızı bekler. SCOOP AI
  • Daha hızlı kullanıcı kuyrukları: bir kullanıcı indirirken çağrıları ve oyunları akıcı tutar. Router sihirbazı bunu ayarlayabilir; Health tek tıklamalık bir düzeltme sunar.
  • Rol başına pano: bir rolün panoyu görüp görmeyeceğini seçin. Panosu olmayan rol, izin verilen ilk sayfasında açılır.
  • Sham Cash: resmi olmayan bağlantıda kodunu unutan bir kullanıcı, ödemeyi transfer numarası ve kendi adresiyle onaylayabilir.

5.12

  • Veri saklama ve Lookup: oturumları kanunun istediği süre boyunca (varsayılan iki yıl) saklayın; silinmiş kullanıcılar için de geçerlidir ve belirli bir zamanda hangi kullanıcının genel adres ve porta sahip olduğunu bulabilirsiniz. Her arama bir dava referansı gerektirir ve Lookup günlüğünde tutulur; günlük şifrelenmiş bir dosya NAS'ınıza gönderilebilir. Veri saklama & Lookup
  • CGNAT ve IP havuzları: genel adresleri kullanıcılar arasında her biri kendi port bloğuyla paylaştırın ya da SAMM'in her router ve plan için kullanıcıya adresi kendisinin vermesini sağlayın. CGNAT & IP havuzları
  • NAS olarak Cisco, Huawei, Nokia ve ZTE; hız, bağlantı kopmaları, hazır kurulum sayfası, Data Log ve Cisco'da CGNAT. Diğer router markaları
  • FTTH: V-SOL, Huawei, ZTE ve Nokia OLT'leri; her ONU sinyaliyle, ONU'lar kullanıcılara bağlı ve abone hattı kilidi. FTTH & OLTs
  • Her marka için cihaz sayfaları: OLT'ler ve MikroTik gibi diğer router'lar için CPU, bellek, sıcaklık, çalışma süresi ve grafikler; router formu her tür için doğru girişi ister. Diğer router markaları
  • Her router için SAMM üzerinden VPN: Through SAMM veya Through Router; Sham Cash ödemeleri hiçbir zaman VPN üzerinden geçmez. SAMM üzerinden VPN
  • Kullanıcı kullanımı: Seçili dönem kartı (toplam, oturumlar, çevrimiçi süre) ve plan, durum, bitiş, adres ve MAC'i gösteren bir şerit; Telegram botu komutlarını kullanıcının dilinde listeler. Kullanıcılar
  • Sunucunuzu biz kuruyoruz: kendi .com alan adınızla hazır bir SAMM sunucusunu panelinizden sipariş edin. Sunucunuzu kurun

5.11

  • Kasiyer: Muhasebe altında bir kasa sayfası. Kullanıcıyı yazarken ad, cep telefonu veya kullanıcı adının bir kısmıyla bulun, sonra ödemesini alın, yenileyin, kota ekleyin veya cüzdanını nakit yükleyin. Dört seçenekli kendi yetkisi vardır, kâr veya rapor göstermez ve yalnızca kasiyerin şubesindeki kullanıcıları bulur. Muhasebe, Yöneticiler, şubeler ve roller
  • Fatura vadesini siz seçin: Muhasebe ayarlarında "Fatura vadesi (gün sonra)". 0 olduğunda fatura kesildiği anda, otomatik yenileme ise paketin bittiği gün vadelidir; böylece ek süre bitiş tarihinden sayılır. Muhasebe
  • Daha ucuz pakete geçişte telafi: kullanıcıyı daha ucuz bir pakete taşırken dönemin kullanılmayan kısmı cüzdanına veya nakit olarak iade edilebilir; tutar kaydetmeden önce gösterilir. Paket değiştirme Kullanıcılar listesinin satır menüsünde de var. Kullanıcılar
  • Otomatik yenileme cüzdandan ödenir ve gecikmiş kullanıcının cüzdanı, hesap askıya alınmadan önce borcu kapatır. Muhasebe
  • Kanala göre bildirimler: her bildirimin kullanabileceği kanalları seçin, hepsinden gönderin ve canlı karakter sayacıyla ayrı bir SMS metni yazın. Bildirimler
  • Tünel olmadan SAMM üzerinden VPN (SAMM ile aynı ağdaki routerlar için) ve kullanıcının ebeveyn denetimi ile VPN ayarlarının yönetim panelinden yönetilmesi. SAMM üzerinden VPN
  • Doğru sıfırlanan arayüz kotası: Reset quota saymayı sıfırdan başlatır ve arayüzü hemen geri açar; istediğiniz zaman kullanılabilir ve son sıfırlamadan beri kullanım sayfada görünür. MikroTik yöneticisi
  • Router başına Web siteleri ve Uygulamalar listeleri: her router listesinin güncel olup olmadığını gösterir, Uygula düğmesi ve Sağlık sayfasında bulgular vardır; izleme değerleri her 5 saniyede yenilenir. MikroTik yöneticisi

5.9

  • Harici VPN sağlayıcıları: NordVPN, Mullvad, IVPN veya AirVPN hesabını tek adımda ekleyin, sunucu sayısını ve ülkeyi seçin ya da ProtonVPN gibi herhangi bir sağlayıcıdan dosya yükleyin. Her kullanıcı tek bir bağlantıda kalır, bağlantılar yükü ağırlıklarına göre paylaşır ve biri durursa kullanıcıları SAMM'in kendi hattı üzerinden internete çıkmaya devam eder. SAMM üzerinden VPN
  • Ek kota bir eklenti olarak: kullanıcının paketini veya son kullanma tarihini değiştirmeden daha fazla veri satın, paket olarak ya da GB başına fiyatla; panelden veya kullanıcı portalından. Eklentiler
  • Kablosuz sektörler: her kullanıcı radyosunun bulunduğu sektörü, orada kaldığı süreyi ve yaptığı her geçişi bir yıl boyunca saklar; sektörlerinizin arkasındaki switch'leri ve her birindeki kullanıcıları gösterir; kullanıcı sayfasında ise sinyal, menzil ve kaliteyle birlikte sektör › radyo › switch › kullanıcı zincirini gösterir. Ağ
  • Bir kullanıcıyı izleyin 24, 48 veya 72 saat boyunca: çevrimiçi süre, hız, sinyal, sektör ve her bağlantı kopması ile nedeni; ardından grafikler ve kısa bir değerlendirme içeren yazdırılabilir bir rapor. Kullanıcılar
  • OpenStreetMap üzerinde ağ haritası: router'larınızı, sektörlerinizi ve kullanıcılarınızı gerçek konumlarında, ağ diyagramının yanında gösterin. Ağ
  • Uygulama listesi güncellemeleri: SAMM, SecuryTik uygulama listesini her gün denetler; «Bana bildir», «Otomatik uygula» veya «Kapalı» seçeneğini belirleyin ve önceki listeyi tek tıkla geri yükleyin. MikroTik yöneticisi
  • Tarih içeren her aramada Başlangıç ve Bitiş tarihleri, Kullanıcılar listesinde Ebeveyn denetimi ve VPN filtreleri ile ekran sayınız kadar pencerede açılabilen aynı sayfa. Kullanıcılar, Gösterge paneli
  • ADV Radius'tan taşınma: kullanıcıları ve paketleri yedek dosyasından; şifreler, son kullanma tarihleri, sabit adresler ve paket limitleriyle birlikte aktarın. Araçlar

5.8

  • Harici VPN: VPN kullanıcıları SAMM'in kendi hattı yerine NordVPN (erişim belirteciyle) veya herhangi bir sağlayıcının WireGuard dosyaları üzerinden çıkar; SAMM'in genel adresi olmasa bile. SAMM üzerinden VPN
  • SAMM üzerinden VPN: seçtiğiniz kullanıcılar tüm trafiklerini ya da yalnızca seçtikleri uygulamaları kendi yerel hatları yerine SAMM sunucunuz üzerinden çıkarır. Kullanıcı bazında izin verin veya eklenti olarak satın; kullanıcılar bunu kullanıcı portalından açar. SAMM üzerinden VPN
  • İki ekranda SAMM: herhangi bir sayfayı veya tek bir gösterge paneli bloğunu kendi penceresinde açın ve ikinci monitörde tutun. Gösterge paneli
  • Eklenti olarak ebeveyn denetimi: ebeveyn denetimini diğer eklentiler gibi belirli bir süre için satın. Eklentiler
  • Wi-Fi optimize edici: her radyonun canlı spektrum görünümü, algıladığı ağlar ve her kanalın doluluk oranı; en boş kanalı ve en uygun genişliği öneren, geceleri radyoları otomatik olarak taşıyabilen bir kanal planlayıcı ile birlikte. Ağ
  • Ubiquiti cihazları: UniFi erişim noktalarını ve airOS radyolarını izlenen cihazlar olarak ekleyin. UniFi radyoları istemcilerini, komşu ağları ve spektrumu gösterir; optimize edici ise bunları gerçekten daha iyi bir kanala ve genişliğe taşır. MikroTik Cihaz Yöneticisi
  • Her planda her router için üç monitör: yalnızca izleme amacıyla kullanılan erişim noktaları ve radyolar artık router kotanızı tüketmez. MikroTik Cihaz Yöneticisi
  • Bir router'ın halihazırda tuttuğu kullanıcıları (PPP, Hotspot ve User Manager, RouterOS 6 ve 7) şifreleri, planları, limitleri, isimleri, telefon numaraları ve bitiş tarihleriyle birlikte arka planda aktarın. MikroTik Cihaz Yöneticisi
  • Bir yenilemeyi geri alma: Bir yenileme faturasının silinmesi, kullanıcının sona erme tarihini eski haline getirebilir; Plan Yenile işlemi üst çubuktan geri alınabilir ve Faturalar listesi, filtrenin gösterdiği tüm kalemlerin toplamlarını görüntüler. Geri alma & onaylar
  • Kendi Google Drive hesabınıza yedekleme. Yedekleme & Geri Yükleme bölümünde Google Drive'ı kısa bir kodla bağlayın; böylece her otomatik yedekleme Drive'ınızdaki bir SAMM Backups klasörüne de kopyalanır ve herhangi bir kopya geri yükleme işlemi için geri getirilebilir. Araçlar
  • Bir planda Sabit yenileme zamanı: her süre dolumu, kullanıcının tanımlanan dönemden daha az süre almaması için yukarı yuvarlanarak seçtiğiniz saate denk gelir. Planlar
  • Plan başına adres listesi: router, kendi güvenlik duvarı, kuyruk ve yönlendirme kurallarınızda kullanabilmeniz için her kullanıcının adresini, plan adıyla oluşturulan bir listeye ekler. Planlar
  • Self Servis Toplama Modu: konuklar isimlerini ve cep telefonu numaralarını girer ve herhangi bir parola gerekmeden anında çevrimiçi olurlar; her giriş, dışa aktarım için saklanır. Self Servis
  • Eksenler, indirme ve yükleme çizgileri, üzerine gelindiğinde detaylar ve kullanılan veri bilgilerini içeren daha net bir Bağlantı kalitesi grafiği; ayrıca Kullanıcılar aramasında e-posta ve Veri Günlüğü aramasında herhangi bir port desteği. Users, Data Log

5.7

  • Cihazlar şubelere aittir. Her router ve erişim noktası bir şubeye veya Genel Merkeze aittir; şube personeli kendi cihazlarını yönetir ve yalnızca üst seviyedekileri görüntüleyebilir; ayrıca bir ayar, kullanıcıların yalnızca kendi şubelerinin router'ları üzerinden giriş yapmasına olanak tanır. Yöneticiler, şubeler & roller
  • Rol süre sınırları. Bir rolün ne kadar süre veya gün önceden tanımlanabileceğini sınırlayın, yeni kullanıcıları sabit bir süreyle (örneğin 2 saat) başlatın ve Gün ekle seçeneğini son kullanma tarihi girme işleminden ayırın. Yöneticiler, şubeler & roller
  • WireGuard ve L2TP/IPsec'in yanı sıra, aynı genel adres arkasındaki birden fazla router için SSTP VPN. VPN
  • RouterOS 6 her yerde çalışır: sihirbaz, Otomatik Tamamlama, yapılandırma iletimi, toplu işlemler, Web Siteleri & Uygulamalar, QoS ve VPN bağlantıları. RouterOS 6
  • Kullanıcı portalında Ebeveyn kontrolü: kategorileri, uygulamaları ve web sitelerini her zaman veya haftalık bir takvimle engelleyin. Ebeveyn kontrolü
  • Puanlar, & ödülleri yenilemeler ve davet edilen arkadaşlar için kazanılır, daha yüksek hız veya ücretsiz günler için harcanır. Puan & ödülleri
  • Yönetici panelinde, kullanıcı portalında ve oturum açma sayfalarında, tarayıcı üzerinden kırptığınız bir logo ile Kendi markanız. Markalama
  • Dil seçenekleri, portalda plan görünürlüğü, SMS şablon modu ve bir MikroTik router üzerinde tek satırlık SAMM kurulumu. Diller, Planlar, MikroTik container

5.6

  • Yapılandırma iletimi: router'larınıza gönderilen her değişiklik, router başına bir sonuçla takip edilir; çevrimdışı router'lara tekrar çevrimiçi olduklarında ulaşır ve otomatik olarak yeniden denenir. Yapılandırma iletimi
  • Yaklaşık bir saniyede açılan bir gösterge paneli ve sayfalar değişirken sabit kalan bir yan çubuk.

5.5

  • Tüm kullanıcılar genelinde Data Log araması: herhangi bir zaman aralığında bir adrese, porta, protokole veya uygulamaya kimin eriştiği. Data Log
  • Düzenle altında Detaylı izinler (kullanıcıları sil, süreyi uzat, planı değiştir, faturaları öde, router betikleri çalıştır…) ve yenileme öncesinde yeni sona erme tarihinin önizlemesi. Roller

5.4

  • Şubeye göre finansal durum: şube seçici, kasa devirleri ve şubeler raporu ile birlikte her fatura, ödeme, gider ve kasa hesabı bir şubeye atanır. Muhasebe & faturalandırma

5.3

  • Sham Cash, her ödeme yöntemi için tek bir ödeme ekranı, genel bir Ödeme sayfası ve 1 ile 12 dönem arası Çevrimiçi yenileme. Çevrimiçi ödemeler
  • Fatura indirimleri, ücretsiz uygulamalı eklentiler, Aktivasyonlar raporu, kullanıcı adı değiştirme ve yenilemelerde ön ödemeler. Eklentiler

5.2

  • Dynamic Speed Booster, birçok router üzerinde aynı anda Cihaz Yöneticisi işlemleri, eklentiler, şube bazlı fiyat listeleri, kullanıcı dosyaları, özel alanlar, Trafik sayfası ve Geçmiş temizleyici. Speed Booster, Cihaz Yöneticisi işlemleri

Başlangıç

Kurulum

SAMM; FreeRADIUS, PostgreSQL, nginx, WireGuard, cloudflared ve beş SAMM servisi dahil olmak üzere ihtiyacı olan her şeyi tek bir adımda kurar. Yükleyici idempotent yapıdadır: yeniden çalıştırıldığında mevcut kurulumu yerinde yükseltir; yapılandırmanızın üzerine asla yazmaz veya veritabanı şifrenizi yeniden oluşturmaz.

Kurulum kılavuzu

Ekran görüntüleriyle her adım: Windows (BIOS'ta sanallaştırmayı açmak dahil), Ubuntu, bir MikroTik router, hazır sunucu, lisans (ödeme, bağlama, yenileme), router'larınızı VPN üzerinden bağlama ve ek özellikler.

SAMM her yerde çalışır — ağınıza uygun olan kurulum yolunu seçin:

Ö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ü sürümleri desteklenmez.
  • Root / sudo erişimi ve internet bağlantısı.
  • systemd ve PostgreSQL'in yerel olarak kurulabileceği bir ana makine (bir tanesi sizin için hazırlanmıştır).

Kurulum

Seçenek A — tek komutla kurulum

Sunucuda çalıştırın:

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

Bu bootstrap betiği, en güncel SAMM sürüm paketini GitHub üzerinden indirir, dosyaları çıkarır ve tam yükleyiciyi otomatik olarak çalıştırır. Birkaç dakika içinde tamamlanır.

Eğer ülkenizde github.com engelliyse, bunun yerine Cloudflare tarafından barındırılan mirror'ı kullanın — aynı yükleyici kullanılır, GitHub'dan herhangi bir veri çekilmez. (Yukarıdaki standart komut, GitHub'ın engellendiğini otomatik olarak algılar ve bu mirror'a kendiliğinden geçer.)

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

Her iki durumda da, yükleyici tamamlandığında yönetici portalını açın ve bu kimlik bilgileriyle giriş yapın:

Giriş URL'sihttp://<your-server>/admin · Kullanıcı adıadmin · Şifreadmin

İlk girişinizden hemen sonra yönetici şifresini değiştirin.

Kurulum

Seçenek B — Windows (Hyper-V) üzerine kurulum

SAMM, tek bir yükleyici tarafından oluşturulan ve yönetilen, Windows üzerindeki kendi küçük Hyper-V üzerindeki Ubuntu 24.04 sanal makinesinde çalışır. VM, ağınıza kendi IP adresiyle katılır; böylece MikroTik router'larınız SAMM'a doğrudan erişir — RADIUS her router'ın gerçek adresini görür ve CoA bağlantı kesme işlemleri tıpkı bir Linux sunucusunda olduğu gibi çalışır.

PowerShell'i yönetici olarak açın — Komut İstemi (cmd) değil: Başlat düğmesine sağ tıklayın, Terminal (Yönetici) veya Windows PowerShell (Yönetici) seçeneğini seçin ve Evet'e tıklayın. Ardından şunu çalıştırın:

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

samm.securytik.com bu bilgisayardan erişilemiyorsa, bunun yerine Cloudflare'de barındırılan yansıyı kullanın — aynı yükleyici. (Yükleyici de bir indirme başarısız olduğunda yansıya kendiliğinden geçer.)

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

Her iki durumda da, yükleyici tamamlandığında yönetici portalını açın ve bu kimlik bilgileriyle giriş yapın:

Giriş URL'sihttp://<SAMM IP>/admin · Kullanıcı adıadmin · Şifreadmin
OS girişi (SSH)samm / samm · Root (konsol)root / samm

SAMM Server ISO ile aynı varsayılanlar geçerlidir. İlk girişinizden sonra bunların tamamını değiştirin. Masaüstündeki SAMM Info kısayolu; bu bilgileri, SAMM'ın IP adresini ve VM'e SSH üzerinden nasıl erişileceğini tekrar gösterir.

İstenenler

  1. PC'de birden fazla bağlı adaptör olduğunda, SAMM'ın hangi ağa katılması gerektiğini belirtin. Önerilen seçenek için (Wi-Fi'dan önce kablolu) Enter tuşuna basın.
  2. O ağdaki SAMM'in IP adresi. Boş bir adres önerilir; kabul etmek için Enter'a basın, başka bir adres girin veya dhcp yazın.

Hyper-V kapalıysa, yükleyici bunu etkinleştirir ve Windows'un bir kez yeniden başlatılmasını ister; tekrar oturum açtığınızda işlem kendiliğinden devam eder. Geri kalanı — Multipass, ağ köprüsü, VM ve SAMM'ın kendisi — bir ilerleme çubuğu eşliğinde 10 ila 20 dakika sürer.

Gereksinimler

  • Windows 10 / 11 Pro, Enterprise veya Education ya da Windows Server 2019 ve sonrası (64-bit). Windows Home sürümünde Hyper-V bulunmamaktadır.
  • BIOS/UEFI'de donanım sanallaştırmanın etkinleştirilmiş olması (Intel VT-x veya AMD-V). Yükleyici bunu kontrol eder ve kapalıysa net bir uyarı mesajı vererek durur — bkz. Sanallaştırmayı açın.
  • En az 8 GB bellek (SAMM VM'i için 4 GB boş alan; minimum 3 GB'dır; diğer sanal makineler — VMware, VirtualBox — bu miktardan düşülür) ve 40 GB boş disk alanı.
  • Ağ kablosu kullanılması şiddetle önerilir. Birçok Wi-Fi sürücüsü, sanal makineyi ağa köprüleyemez ve bu durumda SAMM'a yalnızca PC'nin kendisi erişebilir.

Kurulumdan sonra

  • http://<SAMM IP>/admin/login adresinden yönetici panelini açın (masaüstünde bir SAMM Admin kısayolu bulunur), admin / admin bilgileriyle giriş yapın ve şifreyi hemen değiştirin.
  • MikroTik RADIUS ayarlarınızı SAMM IP adresine (UDP 1812/1813) yönlendirin — paneldeki Router sihirbazı bunu sizin için yapar.
  • SAMM, herhangi bir kullanıcı oturum açmadan önce Windows ile birlikte başlar ve PC'nin uyku modu hiçbir zaman kullanılmayacak şekilde ayarlanır. Dizüstü bilgisayarlarda şarj cihazını bağlı tutun ve kapak kapatma ayarını "Hiçbir şey yapma" olarak belirleyin.
  • Kaldırmak için: aynı satırı -Uninstall parametresiyle çalıştırın veya & ([scriptblock]::Create((irm https://samm.securytik.com/install-windows.ps1))) -Uninstall komutunu kullanın.

Kurulum

BIOS/UEFI üzerinden sanallaştırmayı açın

Windows üzerinde SAMM, işlemcinin sanallaştırma özelliğine ihtiyaç duyan bir Hyper-V sanal makinesinde çalışır: Intel işlemcilerde Intel Virtualization Technology (VT-x), AMD işlemcilerde ise genellikle SVM Mode olarak adlandırılan AMD-V. Çoğu PC'de bu özellik varsayılan olarak açıktır; bazılarında ise kapalıdır. Her marka bu ayarı farklı bir menüye yerleştirdiğinden, genel adımlar ve ayarın genellikle nerede bulunduğu aşağıda belirtilmiştir.

Önce, zaten açık olup olmadığını kontrol edin

Görev Yöneticisi'ni açın (Ctrl+Shift+Esc) → Performans → CPU. Grafiğin altında Sanallaştırma: Etkin ifadesini görüyorsanız işlem tamamlanmıştır. (Hyper-V zaten açıksa, Windows bunun yerine bir hipervizör tespit edildiğine dair bir satır gösterebilir; bu da özelliğin etkin olduğu anlamına gelir.)

Genel adımlar

  1. Çalışmanızı kaydedin ve PC'yi yeniden başlatın.
  2. BIOS/UEFI kurulumunu açın: ekran ışığı yanar yanmaz kurulum tuşuna art arda basın (tabloya bakın). Windows 10/11 üzerinde Ayarlar → Sistem → Kurtarma → Gelişmiş başlangıç → Şimdi yeniden başlat, ardından Sorun Gider → Gelişmiş seçenekler → UEFI Donanım Yazılımı Ayarları → Yeniden Başlat yolunu da izleyebilirsiniz.
  3. Intel Virtualization Technology, Intel VT-x, SVM Mode veya AMD-V seçenekleri için Advanced, Advanced CPU, Processor, Chipset, Security veya Virtualization menülerine bakın ve bu ayarı Enabled olarak belirleyin. (Intel VT-d / AMD IOMMU gerekli değildir.)
  4. Kaydet ve çık (genellikle F10), Windows'un başlamasını bekleyin ve ardından SAMM yükleyicisini tekrar çalıştırın.

Genellikle bulunduğu yer

MarkaKurulum anahtarıGenel konum
DellF2Sanallaştırma Desteği → Sanallaştırma / Intel Virtualization Technology'yi Etkinleştir
HPF10 (veya Esc, ardından F10)Gelişmiş (veya Güvenlik / Sistem Yapılandırması) → Sanallaştırma Teknolojisi (VTx)
LenovoF1 / F2 (veya Novo düğmesi)Güvenlik (ThinkPad) veya Yapılandırma → Intel Virtualization Technology / AMD SVM Technology
ASUSF2 / DelGelişmiş Mod (F7) → Gelişmiş → CPU Yapılandırması → Intel Virtualization Technology veya SVM Mode
AcerF2Gelişmiş (veya Ana) → Intel Virtualization Technology
MSIDelOC → CPU Özellikleri → Intel Virtualization Tech veya SVM Mode
GigabyteDelTweaker (veya Advanced) → Advanced CPU Settings → Intel Virtualization Technology veya SVM Mode
Sunucular (Dell iDRAC, HPE, Supermicro)F2 / F9 / Delİşlemci Ayarları → Sanallaştırma Teknolojisi — genellikle zaten açık
Başka bir sanal makine içindeki bir sanal makine (Windows'un kendisinin VMware, Proxmox veya Hyper-V üzerinde çalışması), bunun yerine dış hipervizörde nested virtualization özelliğinin etkinleştirilmesini gerektirir — örneğin, VM kapalıyken VMware'in CPU ayarlarındaki "Virtualize Intel VT-x/EPT" seçeneği.

Kurulum

Seçenek C — bir sürüm paketinden manuel kurulum

En güncel samm-<version>.tar.gz dosyasını GitHub Releases sayfasından indirin, ardından sunucuda:

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

Başka bir makinede oluşturulmuş bir zip dosyasından da kurulum yapabilirsiniz — yükleyici, kaynağı rsync ile doğrudan /opt/samm dizinine 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 konumuna klonlayın ve sudo bash /opt/samm/install.sh komutunu çalıştırın.

Her iki durumda da, yükleyici tamamlandığında yönetici portalını açın ve bu kimlik bilgileriyle giriş yapın:

Giriş URL'sihttp://<your-server>/admin · Kullanıcı adıadmin · Şifreadmin

İlk girişinizden hemen sonra yönetici şifresini değiştirin.

Kurulum

Seçenek D — Docker Compose ile kurulum

SAMM'i konteyner olarak çalıştırmayı tercih ederseniz — aynı ürün, farklı paketleme — github.com/mhdhaidarah/samm-docker adresindeki Docker Compose dağıtımını kullanın. Docker yüklü herhangi bir host üzerinde:

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

Eksiğindeyse Docker'ı yükler, güçlü rastgele bir veritabanı şifresiyle doldurulmuş bir docker-compose.yml /opt/samm-docker/ içine bırakır ve yığını başlatır. Görünüm mhdhaidarah/samm, çıplak işletim sistemi yüklemesinden aynı derlenmiş paketle oluşturulur — yapılandırılmış olarak kapalı kaynaklı.

Multi-arch — aynı etiket hem linux/amd64 hem de linux/arm64 için sunulur ve uygun varyant etiketten otomatik olarak seçilir: herhangi bir Docker ana bilgisayarında (Intel/AMD, ARM sunucu, Apple-silicon Mac) docker pull komutuyla ve router'ın kendisinde MikroTik RouterOS 7.23+ ile. Tek dosya, tüm platformlar.

curl çıktısının bash komutuna yönlendirilmesine izin verilmeyen ana makinelerde (kısıtlanmış sistemler, katı çıkış politikaları), çalışmaya hazır compose dosyasını doğrudan indirebilirsiniz:

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

Bazı özellikler henüz Docker varyantında mevcut değildir (kademeli lisans kısıtlaması, dinamik FreeRADIUS yeniden yükleme). Yerleşik WireGuard ve Cloudflare Tunnel yönetici sayfaları Docker varyantında kasıtlı olarak gizlenmiştir; çünkü bu sayfalar, konteyner içinden erişilemeyen ana makine düzeyindeki systemd servislerini yönetir. Bu özelliklerin yerleşik olarak sunulmasını istiyorsanız yukarıdaki Seçenek A veya C'yi seçin ya da cloudflared / wg-quick komutlarını Docker ana makinesinde doğrudan SAMM ile birlikte çalıştırın. v1 ile ilgili tüm kısıtlamalar ve manuel kurulum yolu için Docker varyantının README dosyasına bakın.

Windows (Docker Desktop) üzerinde — yalnızca değerlendirme amaçlı

Üretim ortamı için önerilmez. Windows uyku / hazırda beklet / kapak kapatma modları konteynerleri durdurur; önyükleme-yeniden başlatma yalnızca WSL başladığında tetiklenir (Windows önyüklemesinde değil); günlük otomatik güncelleme cron işlemi yalnızca WSL aktifken çalışır. Değerlendirme / demo için kullanın, ardından üretim ortamını bir Linux VM (Hyper-V, Proxmox, ESXi) veya küçük bir fiziksel cihaz (örneğin Ubuntu Server çalıştıran bir NUC) üzerine kurun.

Windows için Docker Desktop kurun (ilk başlatmada WSL2 backend kurulumunu yapmasına izin verin). Ardından PowerShell üzerinden — WSL terminaline gerek yoktur — compose paketini indirin ve stack'i 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

Yığının önyüklemesini Docker Desktop → Containers üzerinden izleyin — samm grubu 8 servise genişleyecektir. Hepsi yeşil olduğunda, yönetici portalını açın ve şu kimlik bilgileriyle giriş yapın:

Giriş URL'sihttp://localhost:8000/admin · Kullanıcı adıadmin · Şifreadmin

İlk girişinizden hemen sonra yönetici şifresini değiştirin.

Gerçek bir MikroTik NAS, RADIUS için bu Windows ana bilgisayarına erişecekse, Windows güvenlik duvarı üzerinden UDP 1812 + 1813 portlarına izin verin:

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

Kaldır: yükleme dizininden docker compose down -v (-v parametresi postgres birimini ve Fernet anahtarını siler; veri eklediyseniz önce bunları yedekleyin).

Kurulum

Seçenek E — bir MikroTik router'a kurulum (RouterOS 7.23+)

Aynı SAMM, Linux kutusuna gerek yok. MikroTik cihazınız container paketini destekliyorsa ve bir USB sürücüsü veya microSD kart takılıysa, tüm yığını doğrudan router üzerinde — her yerde kullanılan aynı docker-compose.yml ile çalıştırabilirsiniz. RouterOS 7.23+ sürümü, doğru CPU mimarisini multi-arch imaj etiketlerinden otomatik olarak çeker, bu nedenle router'a özel herhangi bir indirme yapmanıza gerek yoktur.

Desteklenenler: konteyner destekli tüm MikroTik router'lar — RB5009, hAP ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009 ve benzerleri (arm64), ayrıca x86 RouterOS ve CHR (amd64). Desteklenmeyenler: armv7 / mipsbe / smips / tile / ppc cihazlar (hEX, RB750, eski RB modelleri) — konteyner desteği bulunmamaktadır veya SAMM yığını için RAM/CPU yetersizdir. RouterOS 7.23 veya daha yeni bir sürüm gereklidir (eski sürümlerde çoklu mimari etiketinden mimari seçimi yapılamaz).

Hızlı yöntem: yapıştırılan tek bir satır

Router terminalini açın (WinBox → New Terminal veya SSH) ve şu tek satırı yapıştırın:

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

Router'ın RouterOS sürümünü, CPU ve belleğini kontrol eder, container paketini yükler, container modunu açar, en az 30 GB boyutunda bir ext4 disk bulur, güçlü ve rastgele bir veritabanı parolasıyla SAMM'ı indirir, başlatır ve panel yanıt verene kadar bekler. Sizden istendiğinde (yeniden başlatma sonrası, güç döngüsü sonrası veya diski hazırladıktan sonra), aynı satırı tekrar yapıştırın: her adım halihazırda nelerin tamamlandığını kontrol eder ve kaldığı yerden devam eder. Asla kendi başına bir diski formatlamaz ve halihazırda çalışan hiçbir şeye dokunmaz.

Manuel olarak yapmayı mı tercih edersiniz? Aşağıdaki adımları izleyin.

1. Router'ı hazırlayın

container paketini yükleyin (mikrotik.com/download adresindeki extra_packages.zip içerisinden — uygun container-*.npk dosyasını Files üzerinden yükleyin, ardından yeniden başlatın). Ardından container modunu etkinleştirin (bir seferlik — yalnızca donanımsal güç döngüsünden sonra aktif olur, yazılımsal yeniden başlatma ile değil):

/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 kart takın (≥ 8 GB önerilir — Postgres + imaj katmanları yer kaplar). Router üzerinde:

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

Biçimlendirme işleminden sonra, diskin bağlandığını ve yazılabilir olduğunu doğrulayın:

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

Ardından router'a imajların nereden indirileceğini (Docker Hub) ve nereye çıkartılacağını belirtin — bu işlem yapılmazsa her SAMM container'ı "download/extract error: no registry url set" hatasıyla başarısız olur:

/container config set registry-url=https://registry-1.docker.io tmpdir=samm/tmp layer-dir=samm/layers
# "samm" = your disk's Mount Point (System > Disks > the disk > Mount Point)
# if layer-dir is refused on your RouterOS version, keep only tmpdir
/ip dns set servers=8.8.8.8,1.1.1.1
:put "ok"
"no registry url set" veya "not enough disk space to download layer" hatası mı alıyorsunuz? Yukarıdaki satırları çalıştırın — indirme klasörü router'ın kendi küçük depolama alanında değil, USB/microSD diskte (bağlama noktasında) olmalıdır. Ardından App → samm menüsünde Enabled onayını kaldırın, Uygula'ya basın, tekrar işaretleyin ve Uygula'ya basın: router tüm SAMM parçalarını yeniden indirir ve başlatır.

3. Compose dosyasını kopyalayın

Her platform için bir dosya. change-me-strong-random-string (Postgres parolası — göründüğü her yerde aynı güçlü değeri kullanın) ve change-me-random-token kısımlarını değiştirin. Ardından WebFig/WinBox üzerinden: Container → Apps → + New → YAML yolunu izleyin, yapıştırın, 2. adımdaki ext4 diskini depolama alanı olarak belirleyin ve onaylayın. RouterOS 7.23+ sürümü, uygun CPU mimarisini imaj etiketlerinden otomatik olarak çeker.

"waiting for reverse proxy" aşamasında mı takıldınız? RouterOS 7.23+ sürümlerinde, Apps iletişim kutusundaki Use HTTPS seçeneğinin işaretini kaldırın ve yeniden dağıtın — bu seçenek imajların nasıl çekildiğini değil, uygulamanın web-UI proxy'sini kontrol eder.
docker-compose.yml
name: samm

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

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

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

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

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

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

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

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

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

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

4. MikroTik'i doğrulayın ve SAMM'a bağlayın

SAMM konteynerleri çalışmaya başladığında, yönetici portalını bir tarayıcıda açın ve şu kimlik bilgileriyle giriş yapın:

Giriş URL'sihttp://<router-ip>:8000/admin · Kullanıcı adıadmin · Şifreadmin

Yönetici şifresini derhal değiştirin. RADIUS auth + accounting, router üzerinde UDP 1812 + 1813 portlarından erişime açıktır; bu nedenle MikroTik RADIUS istemcisi, System → RADIUS menüsünde belirlediğiniz ortak sır (shared secret) ile 127.0.0.1 adresine yönlendirilebilir.

Deneysel dağıtım yolu. RouterOS'un container özelliği Docker Compose'dan daha yalındır; servis-adı DNS, bağımlılık sıralaması (depends_on) ve canlı yeniden başlatmalar farklı çalışır. Yığın donanımınızda hatalı çalışırsa, MikroTik'in yanındaki küçük bir Linux cihazında (NUC, Pi 4, Linux VM) Docker çalıştırma yöntemine geri dönün. Aynı compose dosyası, orada tam Compose semantiği ile çalışacaktır.

Yeniden başlatma veya çökme sonrası SAMM'in çalışmaya devam etmesini sağlayın

RouterOS, uygulamanın konteynerlerini otomatik başlatma özelliği kapalı olarak oluşturur. Kurulumdan sonra bunu bir kez çalıştırın: böylece her SAMM konteyneri router ile birlikte başlar, durması halinde yeniden başlatılır ve küçük bir watchdog durmuş olan herhangi bir konteyneri her dakika yeniden başlatır.

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

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

Bir MikroTik container uygulamasını güncellemek veritabanınızı siler. RouterOS, yüklü bir uygulamanın sürümünü mevcut konumunda değiştiremez; tek yol uygulamayı kaldırıp yeniden eklemektir. Uygulamanın kaldırılması, SAMM veritabanı dahil uygulamanın depoladığı her şeyi siler. Uygulamayı kaldırmadan ÖNCE bir yedek alın ve bunu bilgisayarınıza indirin. Router üzerinde bırakılan bir yedek, diğer her şeyle birlikte silinir.

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

  1. SAMM içinde Tools → Backup bölümüne gidin, bir yedek oluşturun ve dosyayı bilgisayarınıza indirin.
  2. Router üzerinde uygulamayı kaldırın ve yeni sürümüyle tekrar ekleyin.
  3. Yeni SAMM'ı açın, Tools → Backup bölümüne gidin ve indirdiğiniz dosyayı geri yükleyin.

Bu yalnızca MikroTik container'ı için geçerlidir. Docker'da (Linux, Windows veya bir Linux VM) güncelleme işlemi docker compose pull ve ardından docker compose up -d komutlarıyla yapılır; verileriniz ise etkilenmez — volume'lar container'ların dışında yer aldığı için korunur.

Kurulum

Seçenek F — SAMM Server ISO (appliance kurulumu)

SAMM Server ISO, boş bir makineyi veya VM'i kullanıma hazır bir SAMM sunucusuna dönüştürür: başlatın, gösterdiği tek ekranda DHCP veya statik IP seçin, onaylayın ve bırakın. Ubuntu Server 24.04 LTS (minimized) kurar, makineye samm-server adını verir, ardından ilk açılışta SAMM'i internetli veya internetsiz olarak doğrudan ISO'dan kurar; sunucu internete bağlanır bağlanmaz kendini bir kez en son sürüme günceller. Konsolda bir SAMM açılış ekranı ve sunucunun IP'sini, yönetim paneli adresini ve varsayılan giriş bilgilerini gösteren bir giriş bildirimi görünür; samm-tools komutu bakım araçlarına tek tuşla erişim sağlar (sağlık kontrolü, veritabanı yedekleme/geri yükleme, yönetici parolası sıfırlama).

ISO, makinenin ilk diskini siler. Yalnızca SAMM'e ayrılmış bir donanımda veya VM'de başlatın. İnternet gerekmez: SAMM ISO'nun içindedir ve kapalı bir ağda çalışır.

Bir USB belleğe yazın (Rufus, balenaEtcher veya dd) veya bir VM'ye bağlayın, başlatın ve ağ sorusunu yanıtlayın. Kurulum sonrası varsayılan giriş bilgileri — panel: admin / admin, OS: samm / samm veya root / samm — hepsini değiştirin.

SAMM Server ISO'yu indirin 2.5 GB

SHA-2560aa7c06bea4aba8ce7f632aacf243639ac7f78359cc0aa72005d88735930e9be

Kurulum

Kurulum referansı

Etkileşimsiz seçenekler

Tüm istemler ortam değişkenleri ile önceden yanıtlanabilir, böylece yükleyici katılımsız olarak çalıştırılabilir:

DeğişkenEtki
DB_PASSOtomatik oluşturulan şifre yerine bu veritabanı şifresini kullanın (yalnızca ilk kurulumda)
CF_TOKENCloudflare Tunnel konnektörünü bu Zero Trust token ile kurun
SAMM_HTTP_PORTNginx dinleme portunu zorla (port-80 algılama istemini atlar)
SAMM_VERBOSE1 ilerleme çubuğu yerine ham komut çıktısını akış olarak verir
NO_COLOR1 renkli çıktıyı devre dışı bırakır
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 yapılandırdıkları

Yükleyici, canlı ve renkli bir ilerleme ekranı — bir yüzde çubuğu ve aşama bazlı bir kontrol listesi — şeklinde çalışır. Her aşamanın ham çıktısı /var/log/samm-install.log dosyasına kaydedilir; hata durumunda son 30 satır ekrana yazdırılır.

BileşenDetaylar
FreeRADIUS 3PostgreSQL backend ve dinamik NAS istemcileri ile yapılandırıldı; freeradius -CX ile doğrulandı
PostgreSQLVeritabanı, şema ve tüm SQL migrasyonları uygulandı — her migrasyon dosyası idempotenttir
Python venvTüm bağımlılıklar requirements.txt üzerinden kuruldu; çeviri katalogları derlendi. Dağıtımın Python sürümü derlenen paketle eşleşmezse, yükleyici /opt/samm/runtime konumuna uygun bir bağımsız yorumlayıcıyı otomatik olarak indirir
nginxTers proxy eklemeli olarak eklenir — mevcut lokasyonlar asla kaldırılmaz. Boş olduğunda port 80'i kullanır; aksi takdirde alternatif bir port ister
5 servicessamm-api, samm-radius, samm-worker, samm-notification, samm-telegram — tamamı systemd birimleri olarak etkinleştirildi
WireGuardPaketler yüklendi; daha sonra System → VPN yolundan yapılandırılır
cloudflaredBinary her zaman kurulur; tünel token'ı kurulum sırasında isteğe bağlıdır veya daha sonra System → Cloudflare Tunnel yolundan eklenir

Tüm kimlik bilgileri — veritabanı parolası ve oturum imzalama anahtarları — ilk kurulumda otomatik olarak oluşturulur.

Etkileşimli istemler

Tüm istemler, kurulum başlamadan önce karşınıza çıkar:

  • Cloudflare token — SAMM'yi açık port gerektirmeden çevrimiçi yayınlamak için bir Zero Trust connector token yapıştırın veya bu adımı atlayıp daha sonra yapılandırmak için Enter tuşuna basın.
  • HTTP portu — eğer 80 portu zaten kullanımdaysa, yükleyici bu lokasyonlara dokunmaz ve alternatif bir port ister (varsayılan 8080).

Kurulum özeti

Yükleyici tamamlandığında; yönetici URL'sini, varsayılan giriş bilgilerini, seçilen HTTP portunu, veritabanı kimlik bilgilerini ve yapılandırma dosyası yollarını içeren bir özet yazdırır:

============================================================
  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ğı çekin 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 işlemi kaynağı yeniden senkronize eder, venv'i yükseltir, tüm migrasyonları yeniden uygular, FreeRADIUS ve nginx konfigürasyonlarını yeniden yükler ve her servisi yeniden başlatır. Konfigürasyon dosyalarınız ve ilk kurulumda seçilen HTTP portu korunur.

İpucu SAMM kendisini güncelleyebilir — Lisanslama & güncellemeler kısmına bakın. Otomatik güncellemeleri etkinleştirin veya System → License yolundan manuel olarak uygulayın.
Air-gapped & uzak DB SAMM yalnızca SAMM'ı içerir — FreeRADIUS, PostgreSQL, nginx ve diğerleri kurulum sırasında ilgili apt depolarından çekilir; bu nedenle internet erişimi olmayan (air-gapped) kurulumlarda bu paketler önceden hazırlanmalıdır. Uzak bir PostgreSQL için, kurulumdan sonra /etc/samm/samm.yaml dosyasındaki DSN ayarını yapın.

Başlangıç

İlk adımlar

Beş kısa işlemle, yeni kurulumu abonelerin bağlanabileceği ve faturalandırılabileceği aşamaya getirebilirsiniz.

1 · İlk giriş

  1. http://<your-server>/admin/ adresini (80 değilse kurulum özetindeki HTTP portunu kullanın) veya Cloudflare tünel URL'nizi açın.
  2. yönetici / yönetici ile giriş yapın.
  3. Şifreyi hemen System → Admins yolundan veya üst bardaki profil menüsünden değiştirin.

2 · İlk router'ınızı ekleyin

  1. MikroTik → NAS yoluna gidin ve Router Ekle butonuna tıklayın.
  2. Router IP adresini, kısa adı ve bir RADIUS ortak sırrını girin. MikroTik cihazlar için, isteğe bağlı olarak canlı cihaz senkronizasyonu için API kimlik bilgilerini ekleyin.
  3. MikroTik üzerinde, aynı shared secret ile SAMM host'unu (portlar 1812/1813) işaret eden bir RADIUS sunucusu ekleyin ve PPP / Hotspot için RADIUS'u etkinleştirin.

FreeRADIUS'u yeniden başlatmaya gerek yoktur — SAMM, NAS istemcilerini veritabanından dinamik olarak çözümler. Tüm prosedür için Routers (NAS) kısmına bakın veya MikroTik yapılandırmasını sizin için kurulum sihirbazının yapmasını sağlayın.

3 · Plan oluştur

Bir plan; hızı, limitleri ve satış fiyatını tanımlar. Kullanıcılar → Planlar → Yeni plan yoluna gidin. Tüm alan referansları için: Planlar & limitler.

4 · Abone ekle

Users → New customer yoluna gidin, giriş bilgilerini doldurun ve bir plan seçin. Abone hemen bağlanabilir. Ön ödemeli hotspot erişimi için bunun yerine voucher kartları oluşturun.

5 · Lisansınızı etkinleştirin

Yeni bir kurulumda kayıtsız minimum seviyede çalışır. Limitleri artırmak için Sistem → Lisans sayfasını açın ve etkinleştirin — bkz. Lisanslama & katmanları.

Günlük işleyiş Router'ları ekleyin → planlar oluşturun → aboneleri veya kartları ekleyin → gösterge paneli'ni takip edin → Muhasebe altından ödemeleri kaydedin.

Başlangıç

Başka bir sistemden taşıma

Hali hazırda başka bir RADIUS faturalandırma sistemi mi kullanıyorsunuz? SAMM bu sistemin verilerini okur ve planlarınız ile abonelerinizi yeniden oluşturur, böylece hiçbir şeyi tekrar yazmanıza gerek kalmaz. Aboneler mevcut servis şifrelerini ve son kullanma tarihlerini korurlar; bu da tam olarak eskisi gibi giriş yapmaya devam edecekleri anlamına gelir.

Tools → Export / Import yoluna gidin ve Migrate from another system altından eski sisteminizi seçin. Tools menüsünün geri kalanı gibi, bu alan yalnızca superadmin yetkisine açıktır.

Neler yüklenecek

Eski sistemDosyaNereden geliyor
SAS4 / Radius Manager .sql veya .sql.gz Eski veritabanının bir MySQL yedeği
Super Speed Radius .sql veya .sql.gz Eski veritabanının bir MySQL yedeği
Pro Radius .xlsx veya .csv Dışa aktarılan abone listesi — bu sistem herhangi bir yedekleme dışa aktarımı sunmamaktadır

Veritabanı yedekleri genellikle birkaç gigabayt boyutundadır; bu normaldir, dosyayı olduğu gibi yükleyin. Sıkıştırılmış yedeklerin önceden açılmasına gerek yoktur.

Çalışma prensibi

  1. Dosyayı yükleyin. Henüz hiçbir şey yazılmadı.
  2. Önizlemeyi gözden geçirin. Oluşturulacak planları ve aboneleri listeler, atlanması veya düzeltilmesi gereken durumlar hakkında uyarır ve işlemi onaylamadan önce toplam sayıyı lisansınızla karşılaştırır.
  3. SAMM içinde halihazırda mevcut olan kullanıcı adları için ne yapılacağını seçin — bunları atlayıp SAMM kaydını koruyun veya adını ve iletişim bilgilerini eski sistemden güncelleyin.
  4. İçe aktar. Her satır bağımsız olarak yazılır, bu nedenle tek bir hatalı satır diğerlerini asla geri almaz.

Gelenler

  • Planlar — eski sistemin kayıt tuttuğu isim, hızlar, fiyat, süre ve trafik kotası.
  • Aboneler — kullanıcı adı, servis şifresi, isim, iletişim bilgileri, son kullanma tarihi, plan, statik IP ve MAC.
  • Eski sistemde devre dışı bırakılan aboneler devre dışı kalmaya devam eder.

Faturalandırma, faturalar, ön ödemeli kartlar, destek talepleri, muhasebe ve yönetici günlükleri kasıtlı olarak içe aktarılmaz; bunlar eski sistemin veri modeline aittir ve nadiren tam olarak eşleşirler.

Sütunuyla eşleşmeyen 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 ancak planları aktarmaz, bu nedenle SAMM planları her abonenin servis seviyesinden çözümleyerek hızı isminden alır ("4MBPS" adlı bir servis 4 Mbps planı olur). Üç öğe bu dosyada yer almaz ve daha sonra gözden geçirmeniz gereken mantıklı varsayılan değerlere ayarlanır:

  • Süre — 1 ay olarak ayarlanır. Her abonenin gerçek sona erme tarihi değiştirilmeden aktarıldığı için bu ayar yalnızca gelecekteki yenilemeleri etkiler.
  • Yükleme hızı — indirme hızıyla eşleşecek şekilde ayarlayın.
  • Fiyat — 0 olarak ayarlayın.
Faturalandırmadan önce planları gözden geçirin Pro Radius içe aktarma işleminden sonra Planlar'ı açın ve her biri için gerçek fiyatı ve dönemi ayarlayın. Bunu yapana kadar bu planlar sıfır olarak faturalandırılır.

Faydalı bilgiler

  • Güvenle birden fazla kez çalıştırabilirsiniz. Aynı dosyanın yeniden içe aktarılması, mevcut kişileri çoğaltmak yerine onları atlar.
  • Lisansınız hâlâ geçerlidir. Dosya, paketinizin izin verdiğinden daha fazla abone içeriyorsa, önizleme bunu önceden belirtir ve kaç abonenin sığacağını söyler — lisansınızı yükseltebilir veya kısmi bir küme içe aktarabilirsiniz.
  • Halihazırda gerçek verilerin bulunduğu bir kuruluma içe aktarma yapıyorsanız, önce yedek alın

Aboneler & planlar

Planlar & limitler

plan, abonelere atanan servis tanımıdır; hızı, limitleri ve fiyatı belirler. Kullanıcıları eklemeden önce planlar oluşturun.

Yeni bir kurulum halihazırda 9 kullanıma hazır plan ile gelir — sekiz aylık hız kademesi ve bir "Expired" kısıtlama planı — böylece hemen satış yapabilir veya kendi planlarınızı oluşturabilirsiniz. Başlangıç verileri yalnızca ilk kurulumda yüklenir ve eklediğiniz planların üzerine asla yazmaz.

Plan oluştur

  1. Kullanıcılar → Planlar yoluna gidin.
  2. Yeni plan seçeneğine tıklayın.
  3. Formu doldurun ve Planı kaydet düğmesine tıklayın.

Her limit bir anahtardır — yalnızca ihtiyacınız olanları etkinleştirin. Aynı modal penceresi mevcut bir planı düzenlemek için de kullanılır (satırın ⋮ menüsünü açın → Düzenle).

Plan alanları

AlanAnlam
İsimBenzersiz plan adı, örn. Home-50M
FiyatFaturalandırma kullanıldığında fatura dönemi başına ücretlendirilir
İndirme / Yükleme hızıörneğin 50M, 512K, 1G — MikroTik hız sınırı olarak uygulanır
Eşzamanlı oturumlarBu planda aynı anda kaç cihazın çevrimiçi olabileceği. Varsayılan olarak 1 — ilk bağlantı hâlâ aktifken ikinci bir giriş reddedilir. Sınırsız için 0 ayarlayın. Raporlamayı durduran bir oturum görmezden gelinir, böylece kopan bir bağlantı abonenin erişimini asla engellemez
Limit: Süre SonuAbonelik, aktivasyondan belirli bir süre sonra (gün/ay/saat/dakika) sona erer
Limit: KotaTüm abonelik için toplam bir veri sınırı (birleşik, yalnızca indirme veya yalnızca yükleme)
Limit: Çalışma SüresiToplam bağlantı süresi sınırı — tüm oturum sürelerinin toplamı
Limit: Günlük kullanımYapılandırılan daily-reset saatinde her gün sıfırlanan bir veri sınırı
Sınırsız penceresiHızlıca bir hız penceresi ekleyin — tam düzenleyici planın Speed Windows sayfasında yer alır
IP havuzuAdres ataması için isteğe bağlı RADIUS Framed-Pool adı
Otomatik yenilemePlan değiştirmek veya bağlantıyı kesmek yerine, süre dolduğunda yeni bir dönem başlatın

Dört sınır

Her limit bağımsızdır ve isteğe bağlıdır. Birden fazla limit belirlendiğinde, SAMM bunları sabit bir sırayla — son kullanma tarihi → kota → çalışma süresi → günlük — kontrol eder ve tükenen ilk limit yapılacak işlemi belirler.

Sınırlaİzleme KayıtlarıTükendiğinde
Sona Erme TarihiAktivasyondan itibaren geçen takvim süresiBaşka bir plana geçin veya bağlantıyı kesin
KotaToplam kullanılan baytBaşka bir plana geçin veya bağlantıyı kesin
Çalışma SüresiKümülatif oturum saniyesiBaşka bir plana geçin veya bağlantıyı kesin
GünlükSon günlük sıfırlamadan beri geçen bayt sayısıSınırla — girdiğiniz hızlara veya daha yavaş bir plana — bir sonraki günlük sıfırlamaya kadar

Her limit için tükenme durumunda ne olacağını seçin: aboneyi geçireceğiniz bir sonraki plan belirleyin veya — bağlantıyı kes — olarak bırakın. Günlük limit, bağlantıyı kesmek yerine hızı sınırlar: varsayılan olarak hız sınırlama değerlerini doğrudan girersiniz (indirme / yükleme alanları) veya daha yavaş bir "sonraki" plan seçersiniz — her iki durumda da abone, bir sonraki günlük sıfırlamada otomatik olarak orijinal planına döner.

Hız pencereleri

Bir hız penceresi, belirlenen saatler için planın temel hızını geçersiz kılar — örneğin gece yarısından sonra sınırsız hız penceresi. Bir plan satırına tıklayarak, haftanın günleri kontrolü ekleyen ve gece yarısını aşan pencereleri destekleyen Hız Windows düzenleyicisini açın. Birden fazla pencere eşleştiğinde, en yüksek hıza sahip olanı geçerli olur.

Not Hız kısıtlaması uygulanan veya limitleri tükenen aboneler hız pencerelerinin dışında tutulur — SAMM, bir limit yürürlükteyken hızı asla artırmaz.

İki kullanım kavramı

SAMM kullanım verilerini iki farklı yerde tutar ve bunları asla birbirine karıştırmaz:

  • Sıfırlanabilir sayaçlar — limit başına durum. Yönetici tarafından yapılan sıfırlama ve günlük sıfırlama ile sıfırlanır.
  • Faturalandırma sayaçları — sıfırlanamayan toplam yaşam süresi değerleri. Raporların ve faturaların doğruluğunu korumak için asla sıfırlanmazlar.

Planları yönetme

Planlar listesi; her planın hızını, abone sayısını, aktif limitlerini ve hız pencerelerini gösterir. Bir satırın ⋮ menüsünden planı düzenleyebilir, hız pencerelerini açabilir, etkinleştirebilir/devre dışı bırakabilir, abonelerine gidebilir veya silebilirsiniz (yalnızca abonesi olmadığında). Otomatik yenileme seçeneklerini düzenlemek, değişikliği tüm mevcut abonelere yayma imkanı sunar.

Kopyala, bir planı — hızlar, limitler, hız pencereleri ve fiyat dahil — olduğu gibi yeni bir isim altında kopyalar; bu, tek bir değeri değiştirmek için bir tarifeyi manuel olarak yeniden oluşturmaktan çok daha hızlıdır. Verdiğiniz isim zaten kullanılıyorsa, bir sonraki boş numara kullanılır.

Kullanıcıların hangi planları gördüğü

Her plandaki (ayrıca Planlar listesindeki toplu işlem) Kullanıcılar bu planı görebilir anahtarı, kullanıcıların portallarında hangi planları görebileceğini ve seçebileceğini belirler. Bu seçenek her plan için başlangıçta kapalıdır, dolayısıyla siz seçene kadar hiçbir şey gösterilmez; bir kullanıcı her zaman kendi planını görür.

Aboneler & planlar

Aboneler

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

Abone oluştur

  1. Users bölümüne gidin ve New customer butonuna tıklayın.
  2. Formu doldurup kaydedin; abone hemen bağlanabilir.
AlanAnlam
Kullanıcı adı *PPPoE / Hotspot giriş adı — benzersiz olmalıdır
Şifre *Giriş parolası (PAP/CHAP RADIUS kimlik doğrulaması için saklanır)
Ad / SoyadAbone adı
Cep Telefonu / E-posta / Adresİletişim bilgileri — bildirimler ve faturalar için kullanılır
Plan *Atanacak servis planı
Süre aşımını geçersiz kılmaPlanın hesaplanan tarihi yerine isteğe bağlı manuel son geçerlilik tarihi
Otomatik yenilemePlan süresini sona erdiğinde otomatik olarak yenile

Aynı anda çok sayıda abone oluşturun

Yeni toplu kullanıcılar tek seferde numaralandırılmış bir hesap serisi oluşturur — bir köy kurulumuna, bir otele veya bir bayiye toplu giriş bilgileri teslim etmenin standart yoludur. Kaç adet oluşturulacağını, başlangıç numarasını ve kaç basamağa tamamlanacağını seçin (3 seçeneği 001, 002, … sonucunu verir); plan, son kullanma tarihi, otomatik yenileme gibi diğer tüm detaylar bir kez doldurulur ve hepsine uygulanır. Tüm hesaplar aynı şifreyi kullanır.

fatura seçimi toplu işlemdeki her kullanıcı için ayrı ayrı uygulanır; bu nedenle elli kişilik bir işlem ya elli fatura oluşturur ya da hiç oluşturmaz ve toplam tutar onaylamadan önce gösterilir.

Abone listesi

Kullanıcılar sayfası; her aboneyi durum belirten bir simge, atanan plan ve her bir limitin ne kadarının kaldığıyla birlikte listeler — ilerleme çubuğuyla günlük kullanım, kalan kota, kalan çalışma süresi ve kalan gün sayısı. Duruma göre filtreleyin (Tümü / Aktif / Askıya Alındı / Süresi Doldu / Çevrimiçi) veya kullanıcı adı, isim veya mobil numara ile arama yapın.

Plan değiştirme rozeti Tek bir rozet, abonenin planını temsil eder. Okla birbirine bağlanmış iki rozet, abonenin günlük limitine isabet ettiğini ve geçici olarak bir kısıtlama planına alındığını belirtir — bir sonraki günlük sıfırlamada orijinal plana dönerler.

Abone yönetimi

Her bir abone işlemi için bir satıra sağ tıklayın veya ⋮ menüsünü kullanın:

İşlemNe işe yarar
Görüntüle / DüzenleDetay sayfasını açın veya iletişim bilgilerini, parolayı ve son geçerlilik tarihini düzenleyin
Etkinleştir / Devre Dışı BırakHesabı askıya al — çevrimiçi abonelerin bağlantısı kesilir
Planı YenilePlan süresini kalan sürenin üzerine ekler; planın bir fiyatı varsa fatura oluşturur. Plan seçimi, süresi dolmuş bir kullanıcının aynı adımda farklı bir planla geri dönmesini sağlar — önceki gibi yenilemek için "Mevcut planı koru" seçeneğinde bırakın
Çalışma Süresi / Kota / Günlük SıfırlaSeçili limit sayacını sıfırla
KullanımKullanım grafiklerini ve oturum geçmişini açın
SilAboneyi ve tüm geçmişini kaldırın — önce aktif oturumlar sonlandırılır
İşlemlerin nasıl yürürlüğe gireceği Sıfırlamalar, plan değişiklikleri ve yenilemeler bir denetim günlüğüne kuyruğa alınır ve genellikle birkaç saniye içinde samm-radius tick tarafından uygulanır. Abone çevrimiçiyse, SAMM ayrıca canlı bir yenileme gönderir. Bkz. CoA & canlı değişiklikler.

Detay sayfası, bir göz simgesi aracılığıyla abonenin giriş şifresini de gösterebilir (tek tıkla kopyalama özelliğiyle); bu, bir müşteri kimlik bilgilerini talep ettiğinde oldukça kullanışlıdır.

Kullanım görünümü

Kullanım eylemi, bir abone için 7g / 14g / 30g / 90g dönem seçicisine sahip detaylı bir trafik sayfasını açar. Bu sayfa üç ana veriyi raporlar — bugünkü trafik (yükleme/indirme ayrımı ve çevrimiçi dakika süresi ile birlikte), bu ayki trafik ve ay için toplam çevrimiçi süre. Bunların altında, yükleme ve indirmeyi karşılaştıran bir günlük trafik grafiği ve tam bir oturum geçmişi tablosu yer alır: her oturumun başlangıç ve bitiş zamanı, süresi, indirilen ve yüklenen bayt miktarı, NAS ve sonlandırma nedeni.

Toplu işlemler

Birçok abonenin sahibini, sona erme tarihini, durumunu veya otomatik yenileme ayarını aynı anda değiştirmek — veya birçok aboneyi silmek — için Toplu Değişiklikler ve Toplu Silme araçlarını kullanın. Bir hesap tablosundan toplu olarak abone oluşturmak için Dışa Aktar / İçe Aktar özelliğini kullanın.

Bir aboneyi belirli router'lar ile sınırlandırın

Şube giriş ayarı açık olduğunda, bir kullanıcı kendi şubesinin, üst şubelerinin ve Genel Merkezin router'ları üzerinden giriş yapar (bkz. Yöneticiler, şubeler & roller). Düzenleme formu üzerinden bir kullanıcıyı (veya tüm bir kart grubunu) belirli router'lara daha dar bilirsiniz: hiçbiri seçilmediğinde şubenin router'ları geçerli olur; bir veya daha fazlası seçildiğinde, giriş yalnızca yalnızca bu router'lardan kabul edilir ve bu durum RADIUS içinde zorunlu kılınır. Seçimin değiştirilmesi, artık izin verilmeyen bir router üzerindeki tüm aktif oturumların bağlantısını keser.

Kullanıcı adını değiştirin, önizleme ile yenileyin

Bir kullanıcıyı, onaylamak için mevcut kullanıcı adını yazdıktan sonra kendi sayfasından (Düzenle yanındaki Username butonu) veya Kullanıcılar listesi menüsünden yeniden adlandırın. Oturumlar, kullanım ve günlükler yeni ismi takip eder; router eski girişi unutsun diye aktif oturum sonlandırılır ve siz o kutucuğun işaretini kaldırmadığınız sürece kullanıcıya yeni kullanıcı adı bildirilir. Bir planı yenilediğinizde veya değiştirdiğinizde, yeni dönemin sona erme tarihinden itibaren devam mı edeceğini yoksa bugün mü başlayacağını seçin ve kaydetmeden önce yeni sona erme tarihini görün — ve ayarlayın. Bir yenileme işlemi peşinat da alabilir.

Kablosuz bağlantı

MikroTik erişim noktasındaki bir abone için kullanıcı sayfası, radyo bilgilerini doğrudan okuyabilir: sinyal (kalitesini belirten basit bir ifadeyle), her iki yöndeki hız, CCQ ve çalışma süresi. Yalnızca MikroTik radyolar okunabilir.

Kullanıcı dosyaları & özel alanlar

Kullanıcı detay sayfasından kullanıcıya kimlik kartları, pasaportlar, sözleşmeler ve fotoğraflar yükleyin; dosyalar indirilmeden önizlenebilir ve aboneye kendi portalındaki Files sekmesi altında gösterilebilir. Ayarlar'da bir kez tanımlanan Custom fields, kullanıcılara, dosyalara, planlara, kart gruplarına, destek taleplerine ve eklentilere ek veri girişi sağlar.

Aboneler & planlar

Hotspot kartları

Ön ödemeli Hotspot erişimi için, tekil aboneler yerine toplu voucher kartları oluşturun. Her kart; binlerce adet oluşturulup dağıtım için yazdırılabilen, kendine özgü hız ve limitleri olan bir kullanıcı adı/şifre çiftidir.

Kart grubu oluştur

  1. Kullanıcılar → Hotspot Kartları yoluna gidin ve Yeni grup butonuna tıklayın.
  2. Aşağıdaki formu doldurun ve Grup oluştur düğmesine tıklayın — SAMM her kartın kimlik bilgilerini otomatik olarak oluşturur.
BölümAlanlar
KimlikBenzersiz grup adı, açıklama, isteğe bağlı kullanıcı adı ön eki, oluşturulacak kart sayısı (10.000'e kadar)
Kimlik BilgileriKullanıcı adı ve şifre formatı (sayılar / harfler / alfanümerik) ve uzunluğu
Hız sınırıİndirme ve yükleme hızı — 256k, 6M, 1G; 0 = sınırsız
Transfer Limitini BelirleSınırsız, birleşik kota veya ayrı indirme/yükleme kotaları (MB / GB / TB)
Zaman SınırlarıÇalışma süresi sınırı, ilk girişten sonra sona erme ve bir grup "geçerlilik tarihi" raf ömrü

Süre sonu her kartın ilk girişinden itibaren sayılırken, geçerlilik tarihi kesin bir son tarihtir — kartlar, aktive edilip edilmediklerine bakılmaksızın bu tarihten sonra kullanılamaz.

Bir grubu yönetme

Bir grubun ⋮ menüsünü açarak tüm kartları aynı anda etkinleştirebilir veya devre dışı bırakabilir, grubun "geçerlilik tarihi" süresini uzatabilir, gruba daha fazla kart ekleyebilir veya detaylarını düzenleyebilirsiniz. Tekil kartlar, kart detay sayfasından sıfırlanabilir (kota, çalışma süresi veya son kullanma tarihi) veya devre dışı bırakılabilir.

Grubu çoğalt seçeneği her ayarı aynen kopyalar ve yeni kodlarla aynı sayıda kart oluşturur — bir kart kodu yalnızca tek bir karta ait olabilir, bu nedenle kopya işlemi eski kartların bir klonu değil, yeni bir baskıdır. Bu, tükenen bir voucher grubunu yeniden oluşturmanın hızlı yoludur.

Tek kart ekleyin veya liste içe aktarın

Kart listesinde ve grup sayfasında + Card, yazdığınız kullanıcı adı, parola ve isteğe bağlı adla bir kartı, arama listesinden seçtiğiniz gruba ekler. Grup sayfasında Import cards bir CSV veya Excel dosyası (kullanıcı adı, parola ve isteğe bağlı ad) getirir; bir şey kaydedilmeden önce neyin ekleneceğini ve neyin atlanacağını görürsünüz.

Kart tasarımları

Basılı kartı tasarlamak için Hotspot Cards → Card designs sayfasını açın: boyutu, arka plan görseli, logonuz ve kullanıcı adı, parola, fiyat, geçerlilik ile QR kodunun yeri. QR kodu kartla Hotspot'a tek taramada giriş yapar. Başlamak için on hazır tasarım var; bunları kendi tasarımlarınız gibi düzenleyin, kopyalayın veya silin.

Bir tasarım ya kartlardan oluşan bir A4 sayfası (Export) ya da hızlı yazdırma için 80 veya 58 mm termal fiştir. Her grup ikisi için de kendi tasarımını tutar; tasarımı olmayan bir grup yerleşik kartı basar ve hızlı yazdırma hazır Thermal Pro fişini kullanır.

Kart durumları

DurumAnlam
KullanılmayanOluşturuldu ancak hiç giriş yapılmadı
AktifKullanımda, sınırları dahilinde
TükendiBir limite (kota, çalışma süresi veya son kullanma tarihi) ulaşıldı
Devre dışıManuel olarak devre dışı bırakıldı

& takibi yazdırılıyor

Kartlarını görmek için bir grup açın, dağıtım için bunları 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 trafiği ayrıca Raporlar altındaki Kartlar sekmesinde görünür ve her grubun kendi muhasebe görünümü vardır.

Router'a her kartta ne kaldığı bildirilir; böylece Hotspot durum sayfası kalan süreyi ve veriyi gösterir ve kart bittiğinde router oturumu sonlandırır.

Aboneler & planlar

Self Servis — konuklar kendi kayıtlarını yapar

Voucher sisteminin tam tersi: kimse bir şey yazdırmaz ve kimse bir masada beklemez. Bir ziyaretçi hotspot'unuza bağlanır, giriş sayfasındaki Register butonuna dokunur, adını ve cep telefonu numarasını girer ve SAMM onlara SMS, WhatsApp veya e-posta yoluyla bir geçiş kodu gönderir. Bu kodu aynı sayfaya girerek çevrimiçi olurlar — siz de misafir ağını kullanan herkesin isimli ve dışa aktarılabilir bir kaydını tutarsınız.

Tipik mekanlar: restoranlar ve kafeler, oteller ve pansiyonlar, expo'lar ve ticaret fuarları, konferanslar, alışveriş merkezleri, klinikler ve bekleme salonları, spor salonları, ortak çalışma alanları, güzellik salonları, havalimanı bekleme salonları, stadyumlar, kampüsler, kütüphaneler, araç showroom'ları, düğün mekanları, tatil köyleri ve kamp alanları.

Açma işlemi

  1. Önce bir iletim kanalı kurun. Notification Center → SMS veya WhatsApp'ı etkinleştirin ve kendinize bir test mesajı gönderin. Bir kanal çalışır hale gelene kadar diğer hiçbir özellik çalışmaz.
  2. Self Service → Settings: Allow guests to register themselves seçeneğini işaretleyin, sunulacak kanalları seçin, geçiş kodunun geçerlilik süresini ve bir konuğun yeni bir kod istemeden önce beklemesi gereken süreyi ayarlayın.
  3. Bir sebebiniz yoksa, Self Service kart grubundaki Passcodes come from seçeneğini olduğu gibi bırakın — bu grup, hızı ve bir parolayı kaç cihazın paylaşabileceğini belirler.
  4. Kullandığınız her giriş tasarımı için Kayıt sekmesini etkinleştirin — aşağıya bakınız. Bu, genellikle atlanan adımdır.

Giriş sayfası — gözden kaçırılan adım

Kayıt sekmesi giriş başına tasarıma sahiptir ve varsayılan olarak kapalıdır. MikroTik Cihaz Yöneticisi → router → Giriş Sayfası yolunu izleyin, kullandığınız tasarımı düzenleyin ve Kendi Kendine Servise İzin Ver seçeneğini işaretleyin. Bir konuğun aynı ekranda gördüğü her cümleyi yeniden düzenleyebilirsiniz: Kayıt sekmesi etiketi, giriş satırı, iki alan etiketi, buton ve beş yanıt (“parolanız yolda”, “zaten bir hesabınız var”, “lütfen daha sonra tekrar deneyin”, “gönderemedik”, “kayıt mevcut değil”).

Ardından Push düğmesine basın — ve her SAMM yükseltmesinden sonra tekrar basın. Hotspot oturum açma sayfaları SAMM üzerinde değil, router'ın kendi flash depolama alanında bulunur. SAMM'i yükseltmek bu sayfaları yeniden göndermez, bu nedenle bir router, siz tekrar gönderene kadar —üzerinde Kayıt sekmesi bulunmayan— eski sayfasını sunmaya devam eder. Bir router, yüklü sürümünüzden daha eski sayfalar sunduğunda SAMM sizi Oturum Açma Sayfası sekmesinde uyarır ve Self Service sayfası, sekmeyi gösteremeyen tüm router'ları listeleyerek hepsini tek seferde düzeltme imkanı sunar.

Kötüye kullanımı engelleyen kurallar

  • Numara başına bir aktif geçiş kodu. Bir kod hâlâ geçerliyken tekrar talep edildiğinde, konuğa yeni bir kod göndermek yerine mesajlarını kontrol etmesi söylenir.
  • Ardından, o numaranın yeni bir tane talep edebilmesinden önce belirlediğiniz bir bekleme süresi gelir.
  • Geçerlilik süresi, parola gönderildiği andan itibaren başlar, ilk girişten itibaren değil; dolayısıyla bir hafta boyunca kullanılmadan bekleyen bir kod artık çalışmaz.
  • Lisansınız tarafından belirlenen günlük sınır (aşağıya bakınız). Bu sınır dolduğunda, konuklardan daha sonra tekrar denemeleri istenir ve halihazırda verilmiş olan geçiş kodları çalışmaya devam eder.
  • Her girişim, cihazın MAC adresi üzerinden router'ın bildirdiği şekilde kaydedilir; bir konuk bunu tarayıcısı üzerinden taklit edemez.

Lisans

Self Service, planınızdan ayrı olarak, kurulumun günde kaç adet geçici şifre oluşturabileceğine göre lisanslanır ve kendi tarihinde yenilenir; böylece ücretli bir eklentiyle Free planında veya eklentisiz Unlimited planında olabilirsiniz. Her kurulum günde 10 adedi ücretsiz olarak alır; Light bu sınırı 50'ye, Heavy 200'e çıkarır ve Max limiti tamamen kaldırır. Fiyatlandırmaya göz atın.

Self Service sayfası bugün için kullanılan / izin verilen miktarını gösterir ve limit dolduğunda bunu açıkça belirtir. securytik.com adresindeki gösterge panelinizden satın alın veya yenileyin ya da System → License üzerinden talep edin; bir SecuryTik yöneticisi bunu onaylayacaktır. İletilemeyen bir geçiş kodu limitinizi tüketmez.

Aboneler & planlar

Eklentiler & kuponlar

Eklenti, bir kullanıcının planına ek olarak belirli bir gün sayısı için satın aldığı ekstra bir özelliktir: hız artırıcı, kotasız günler veya seçilen saatler için gece artırıcı. Bunları Users → Add-ons yolundan oluşturun.

  • Kullanıcı sayfasından bir eklenti satın, kullanıcıların bunu kullanıcı portalı veya Telegram botu üzerinden (cüzdan ile ödeyerek) satın almalarına olanak tanıyın veya kullanıcıların portalda ya da botta kullanabileceği tek seferlik voucher kodları yazdırın.
  • Ücretsiz uygulamalar: Sınırsız seçeneğini açın ve uygulamaları kategoriye göre seçin; yalnızca bu uygulamaların trafiği kullanıcının kotasından düşülmez. Tüm uygulamaları kapalı bırakırsanız tüm trafik sınırsız olur. Bunun için Data Log gereklidir.
  • Ebeveyn denetimi ve VPN: bir eklenti, süresi boyunca Ebeveyn denetimi veya SAMM üzerinden VPN özelliğini açabilir; süre bitince ikisi de kendiliğinden kapanır. Süreyi bir değer ve birimle belirleyin (gün, hafta veya takvim ayı).
  • Kullanıcılar, aktif eklentilerini ve bitiş tarihlerini Planlar sayfasında görürler. Bir acentenin kullanıcısına tanımlanan eklenti, yenileme işlemi gibi acenteye faturalandırılır.
  • Her şubenin Accounting → Price Lists yolunda kendi ek hizmet fiyatları olabilir.

Fatura indirimleri

Açık bir faturaya, faturadan veya kullanıcının faturalarından seçerek ve bir neden belirterek yüzdelik veya sabit bir indirim uygulayın. Sürekli bir indirim, kullanıcının sonraki yenilemelerinde tekrarlanabilir. Her rolün verebileceği maksimum bir indirim tutarı vardır.

Aboneler & planlar

Puanlar & ödüller

Sadık kullanıcıları ödüllendirin ve arkadaşlarını davet etmelerini sağlayın. Users → Points & rewards yolundan etkinleştirene kadar puanlar kapalıdır.

  1. Puanları etkinleştirin ve her plan için ücretli yenilemenin kaç puan verdiğini ve davet ettikleri bir arkadaş ilk faturasını ödediğinde davet eden kullanıcının kaç puan alacağını ayarlayın.
  2. Ödüller oluşturun: daha yüksek hız (plan hızının belirli günlerce katlanması) veya ücretsiz günler; her birinin puan cinsinden bir bedeli vardır.
  3. Kullanıcılar bakiyelerini, davet bağlantılarını ve ödülleri kullanıcı portalında görür ve puanlarını orada harcar. Davet bağlantısını açan bir arkadaş bilgileri bıraktığında, siz kullanıcıyı oluşturursunuz ve referans kaydedilir.

Puanlar, ödenmiş faturalardan bir kez sayılır. Bir fatura iptal edilirse, puanları geri alınır. Ayrıca manuel olarak puan ekleyebilir veya çıkarabilir; en yüksek bakiyeleri ve katılım isteklerini aynı sayfada görebilirsiniz.

Aboneler & planlar

Ebeveyn denetimi

Aileler, kendi hatlarını kullanıcı portalı üzerinden korurlar. Siz izin verene kadar bu özellik her kullanıcı için kapalıdır: kullanıcının ekleme veya düzenleme formunda (Şifre Değişikliğine İzin Ver seçeneğinin hemen ardından gelir) Ebeveyn kontrolü seçeneğini açın veya Kullanıcılar listesindeki toplu işlemlerden birçok kullanıcı için aynı anda etkinleştirin.

Kullanıcının engelleyebilecekleri

  • Kategoriler: yetişkin içerik, uyuşturucu, kumar, arkadaşlık, şiddet ve nefret ile filtreyi aşmak için kullanılan proxy veya VPN servisleri. Yetişkin içeriğin engellenmesi, büyük arama motorlarında ve YouTube üzerinde SafeSearch özelliğini de etkinleştirir.
  • Websites & Apps ile aynı katalogda yer alan ve resmi logolarıyla gösterilen Uygulamalar ve web siteleri
  • Ne zaman: her zaman veya haftalık takvim üzerinden (örneğin okul geceleri saat 22:00'den sonra).
Router üzerindeki ışık SAMM kullanıcı başına kural yazmaz. Her router birkaç ortak kural alır ve kullanıcılar, programları başladığında veya bittiğinde bu kuralların kapsamına dahil edilir veya çıkarılır; böylece çok sayıda aile olsa bile router yükü düşük kalır. Uygulama engelleme için router'ın SAMM tarafından yönetilmesi (API erişimi) gerekir.

Aboneler & planlar

SAMM üzerinden VPN

Seçtiğiniz kullanıcılar trafiklerini router'ın kendi internet hattı yerine SAMM sunucunuz üzerinden çıkarır. Bu, her router'ın SAMM'e zaten sahip olduğu tünelden geçer (WireGuard, L2TP/IPsec veya SSTP; bkz. VPN), bu yüzden kullanıcının telefonuna veya bilgisayarına hiçbir şey kurulmaz.

İzin verin

  • Kullanıcı bazında: kullanıcı ekleme veya düzenleme formunda SAMM üzerinden VPN seçeneğini açın ya da Kullanıcılar listesindeki toplu işlemlerle birçok kullanıcı için tek seferde açın.
  • Eklenti olarak: Kullanıcılar → Eklentiler altında bir eklentide VPN'i açın ve belirli sayıda gün, hafta veya ay için satın. Eklentinin süresi boyunca açık kalır ve sonra kendiliğinden kapanır.

Kullanıcının seçimleri

İzin verilen kullanıcılar, kullanıcı portalında üç seçenekli bir VPN sayfası görür:

  • Kapalı — VPN'den hiçbir şey geçmez.
  • Tüm trafik — her uygulama ve web sitesi VPN'den geçer; kullanıcının DNS'i de VPN'den geçer.
  • Seçilen uygulamalar — yalnızca kullanıcının Web Siteleri ve Uygulamalar ile aynı katalogdan seçtiği uygulamalar ve siteler; geri kalan her şey yerel hatta kalır.
Tünel kesilirse Kullanıcılar VPN yüzünden asla internetsiz kalmaz: router SAMM'e ulaşamazsa trafikleri tünel geri gelene kadar router'ın kendi hattına döner. Yerel adresler (LAN ve CGNAT aralıklarınız) asla VPN'den geçmez. RouterOS 6 ve 7'de çalışır; router'ın SAMM tarafından yönetiliyor olması gerekir.

Harici VPN: başka bir sağlayıcı üzerinden çıkış

System → VPN → External VPN altında SAMM, VPN kullanıcılarını kendi hattı yerine ticari bir VPN üzerinden çıkarabilir; böylece SAMM yerel ağınızda genel adressiz dursa bile VPN çalışır.

  • NordVPN: NordVPN hesabınızdan bir erişim belirteci yapıştırın ve açılacak sunucu sayısını seçin (hesap başına en fazla 10). SAMM anahtarı alır ve sunucuları kendisi seçer.
  • Diğer sağlayıcılar (ProtonVPN, Mullvad, Surfshark, kendi sunucunuz): WireGuard .conf dosyalarını yükleyin, dosya başına bir bağlantı. Dosyadaki betik satırları yok sayılır ve asla çalıştırılmaz.
  • Bağlantılar her bağlantıyı canlı gösterir: durum, son el sıkışma, trafik ve kullanıcılar. Her kullanıcı tek bir bağlantıda (aynı çıkış adresinde) kalır; ağırlık kullanıcıları bağlantılar arasında paylaştırır.
  • Bir bağlantı çalışmayı durdurursa kullanıcıları o geri gelene kadar SAMM'in kendi hattından çıkar; bir bağlantıyı silmek veya kapatmak kullanıcılarını diğerlerine taşır.
SAMM'in genel bir adrese ihtiyacı var VPN yalnızca SAMM sunucunuz internete kullanıcılardan farklı bir yerden çıktığında işe yarar, örneğin bir veri merkezindeki sunucu. SAMM aynı ağda NAT arkasındaysa trafik aynı hattan çıkar; bu yüzden çalışan bir Harici VPN bağlantısı yoksa kullanıcı formu ve eklenti formu bir uyarı gösterir.

Başlangıç

Sunucunuzu kurun

Sunucunuz yok mu? Sizin için kurarız. SAMM panelinizden siparişi verir, ödersiniz ve kendi .com alan adınızda, adınızla hazırlanmış bir SAMM sunucusu alırsınız. Kurulacak bir şey yoktur.

Neler elde edeceksiniz

  • Bir bulut sunucu ve bir .com alan adı, üç boyutta: 6 çekirdek, 12 GB RAM, 200 GB SSD yılda $100; 8 çekirdek, 24 GB RAM, 300 GB SSD $200; 12 çekirdek, 48 GB RAM, 400 GB SSD $300. Boyutu ilk adımda seçersiniz.
  • Alan adınızda HTTPS; sunucunun kendi adresi asla yayımlanmaz.
  • Şirket adınızla kurulmuş ve markalanmış SAMM; lisansınız bağlı ve ilk girişte etkin.
  • Panel adresinizi (https://your-domain/admin) ve güçlü bir yönetici şifresini içeren bir e-posta.

Sipariş verin

  1. samm.securytik.com adresinde oturum açın ve Dashboard → Get a server bölümünü açın.
  2. Bir sunucu adı ve kullanıcı sayısı seçin, ardından .com alan adınızı arayın veya önerilerden birini seçin.
  3. Ödeme ekranında gösterilen herhangi bir yöntemle ödeyin. Sipariş ödeme için iki saat bekler; bu süreden sonra iptal edilir ve yeni bir sipariş vermeniz gerekir.
  4. Ödemeden sonra her şey otomatiktir. Sunucu hazır olduğunda adresiniz ve girişinizle birlikte e-posta alırsınız.

SSH erişimi

Dashboard → Servers bölümünden şifreli, ortak anahtarlı ya da ikisini birden içeren kendi SSH girişinizi oluşturabilirsiniz. Termius, Windows, Ubuntu ve macOS için adım adım SSH rehberi aynı sayfadadır.

Yenileme Yılın bitiminden en az bir gün önce yenileyin; yenileme yedi gün önce açılır. Sunucu yenilenmezse sunucu, alan adı ve üzerindeki veriler sona erer. Kendi yedeklerinizi de tutun.

Aboneler & planlar

CGNAT & IP havuzları

İkisi de Plans altında, router'ın kendi havuzlarının yanında.

CGNAT Pools

CGNAT havuzu, birkaç kullanıcının tek bir genel adresi paylaşmasını sağlar. Her kullanıcı o adreste sabit bir port bloğu alır; böylece her bağlantı tek bir kullanıcıya kadar izlenebilir.

  1. Plans → CGNAT Pools bölümünü açın ve bir havuz ekleyin: genel adresler, bir adresi kaç kullanıcının paylaştığı ve her kullanıcının kaç port aldığı.
  2. Kapasite satırı, kaydetmeden önce kaç kullanıcının sığdığını gösterir.
  3. Router'a gönderin. SAMM NAT kurallarını yazar ve hangi kullanıcının hangi adres ve portlara sahip olduğunun geçmişini tutar; bunu Lookup okur.

IP havuzları

IP havuzuyla SAMM her kullanıcıya, router ve plan başına, adresini kendisi verir; bu nedenle router'ın kendi adres havuzuna ihtiyacı yoktur. Adres, oturum bittiğinde serbest bırakılır. Bir havuz dolduğunda router'ın kendi havuzu devreye girer.

Günlük operasyonlar

Veri saklama & Lookup

Birçok ülke, bir internet servis sağlayıcısından bağlantı kayıtlarını tutmasını ve belirli bir zamanda hangi abonenin bir adresi kullandığını bildirmesini ister. Veri saklama ikisini de yapar. Siz etkinleştirene kadar kapalıdır.

Etkinleştirin

  1. System → Settings → Data retention bölümünü açın ve etkinleştirin.
  2. Oturumların ne kadar saklanacağını belirleyin (varsayılan iki yıl). Oturumlar, sildiğiniz kullanıcılar için bile bu süre boyunca saklanır.
  3. İsteğe bağlı olarak SFTP, SMB veya NFS üzerinden NAS'ınıza günlük şifrelenmiş bir dosya gönderin. gpg --decrypt ile açın.

Lookup: bu adresi kim kullandı?

  1. Overview → Data Log → Data retention bölümünü açın.
  2. Aldığınız talepteki genel adresi, portu ve zamanı girin.
  3. Bir dava referansı girin (SAMM CASE-1, CASE-2… önerir). Sonuç kullanıcıyı, MAC adresini, router'ı ve oturumu gösterir; aranabilir ve dışa aktarılabilir.
Lookup günlüğü Her arama; kimin, ne zaman ve hangi dava referansıyla aradığı bilgisiyle Lookup günlüğünde tutulur ve düzenlenemez. CGNAT ile Lookup, CGNAT havuzlarınızın port bloklarını kullanır.

Ağ & routerlar

Diğer router markaları

MikroTik'in yanı sıra SAMM, Cisco, Huawei, Nokia ve ZTE router'larıyla da NAS (BNG) olarak çalışır.

  • Router'ı ekleyin Devices → Manager altında ve türünü seçin. Form doğru girişi ister: MikroTik için API, diğer markalar için SSH.
  • Kurulum sayfası: SAMM, o router için yapılandırma satırlarını üretir; yapıştırmaya hazırdır.
  • Hızlar ve bağlantı kopmaları her markanın kendi RADIUS özniteliklerini kullanır; böylece plan değişiklikleri router'a ulaşır.
  • Data Log, router'ın kendi trafik kayıtlarından (NetFlow veya IPFIX) gelir.
  • Cisco'da CGNAT: SAMM kuralları SSH üzerinden iter ve Lookup, MikroTik'teki gibi çalışır. Cisco router'lar L2TP üzerinden SAMM'e bağlanabilir.
  • Cihaz sayfası: MikroTik gibi CPU, bellek, sıcaklık, çalışma süresi ve grafikler.

Ağ & routerlar

FTTH & OLTs

SAMM, OLT'leri V-SOL, Huawei (SmartAX), ZTE (C300 ve C320) ve Nokia (ISAM) üzerinden SSH ile okur.

  • FTTH sayfası, Devices → FTTH altında: filtreler, sütunlar ve dışa aktarma ile OLT listesi; Wireless gibi.
  • Her ONU optik sinyaliyle, ve eklenmeyi bekleyen ONU'lar.
  • ONU'lar kendi kullanıcılarına otomatik bağlanır.
  • Abone hattı kilidi: SAMM her kullanıcının bağlandığı hattı öğrenir ve girişini o hatta sabitleyebilir.
  • OLT cihaz sayfası: CPU, bellek, sıcaklık, çalışma süresi ve grafikler.

Ağ & routerlar

Routerlar (NAS)

NAS (Network Access Server), aboneleri RADIUS üzerinden SAMM ile doğrulayan bir router'dır. Abone trafiğini taşıyan her router'ın bir NAS kaydı olması gerekir.

Router ekle

  1. MikroTik → NAS yoluna gidin ve Router Ekle butonuna tıklayın.
  2. Aşağıdaki alanları doldurun ve kaydedin.
AlanAnlam
NAS IP / ana bilgisayar adıSAMM ana bilgisayarının gördüğü router adresi
Kısa adArayüz genelinde görüntülenen kolay bir etiket
Türmikrotik canlı cihaz senkronizasyonunu ve yapılandırma iletimini etkinleştirir; diğer türler yalnızca RADIUS desteklidir
Gizli anahtarRADIUS ortak sırrı — router ile birebir eşleşmelidir, aksi takdirde kimlik doğrulama başarısız olur
CoA portuSAMM'in Change-of-Authorization paketlerini gönderdiği UDP portu (MikroTik varsayılanı 3799)
API port / kullanıcı / şifreSAMM'nin cihaz bilgilerini okumak ve yapılandırmayı göndermek için kullandığı MikroTik API kimlik bilgileri
Yeniden başlatma gerekmiyor SAMM, NAS istemcilerini veritabanından dinamik olarak çözümleyerek tanımlar; bir router eklemek veya kaldırmak için FreeRADIUS'ı yeniden başlatmaya gerek yoktur.

NAS listesi

Tüm router'lar tek bir tabloda gösterilir — ID, NAS IP / hostname, shortname, tip, maskelenmiş bir secret (görüntülemek için hücreye tıklayın), CoA ve API portları ve gidiş-dönüş süresiyle birlikte canlı bir ping sonucu. Arama kutusu IP, shortname veya açıklamaya göre filtreleme yapar.

Her satırın ⋮ menüsü, router başına işlemleri içerir — Cihazı Görüntüle ve Bilgileri Yenile (yalnızca MikroTik), Düzenle, RADIUS yapılandırmasını gönder (yalnızca MikroTik) ve Sil. mikrotik tipi bir satıra tıklamak, doğrudan ilgili cihaz sayfasına yönlendirir.

Komşuları keşfet

MikroTik cihazlarını ağda taramak (MikroTik'in neighbor-discovery protokolü aracılığıyla) ve her adresi elle yazmadan NAS kayıtları olarak eklemek için Discover neighbors seçeneğine tıklayın. Keşfedilen bir router, IP ile veya Auto-added seçeneğiyle eklenebilir; bu tek tıkla başlatma işlemi router üzerinde bir SAMM yönetim kullanıcısı oluşturur, bir yönetim IP'si atar ve fabrika ayarlarındaki bridge yapılandırmasını temizler.

Otomatik ekleme, yeni router'lar içindir Tek tıkla bootstrap, fabrika ayarlarındaki (veya sıfırlanmış) cihazlar için tasarlanmıştır; halihazırda yapılandırması olan bir router üzerinde mevcut kurulumun üzerine yazabilir veya kurulumu bozabilir.

RADIUS yapılandırmasını router'a gönderin

MikroTik NAS kayıtları için satırdaki ⋮ menüsü Push RADIUS config seçeneğini sunar — SAMM, sizin elle yazmanız yerine API üzerinden router yapılandırmasını sizin için gerçekleştirir. SAMM sunucu IP'sini (router tarafından erişilebilir olmalıdır) ve auth, accounting ve CoA portlarını onaylarsınız; SAMM ardından router üzerinde bir RADIUS girişi oluşturur veya mevcut olanı değiştirir:

AyarDeğer
YorumSAMM — SAMM'nin bu girişi daha sonra bulmak ve güncellemek için kullandığı etiket
Servishotspot, ppp
Adres / gizli anahtarBu NAS kaydındaki paylaşılan gizli anahtarı kullanan SAMM ana bilgisayarı
Zaman aşımı3000 ms
Gelen CoAOnayladığınız CoA portu üzerinden kabul edildi

İletişim kutusu, push işlemi tamamlandığında bir sonuç günlüğü gösterir.

MikroTik tarafını yapılandırın

Router'ı bunun yerine manuel olarak yapılandırırsanız:

  • SAMM hostuna yönlendirilmiş, aynı paylaşılan gizli anahtara sahip, PPP / Hotspot için etkinleştirilmiş bir RADIUS sunucusu ekleyin.
  • Kimlik doğrulama portu 1812, accounting portu 1813 kullanın.
  • 3799 portundan gelen CoA isteklerini kabul et.
  • Accounting Interim-Update aralığını yaklaşık 5 dakika (SAMM sihirbazı varsayılanı) olarak ayarlayın — SAMM kullanımı bu sıklıkla toplar ve limitleri değerlendirir; daha kısa aralıklar, daha fazla accounting trafiği pahasına limit gecikmesini azaltır.

Sadece izleme modundaki cihazlar

monitor olarak eklenen bir router, MikroTik envanterinde görünür, pinglenir ve senkronize edilir ancak bir RADIUS rolüne sahip değildir; yani aboneleri doğrulayamaz. Bunu, abone NAS'i olmayan router'ları takip etmek için kullanın.

SAMM Yedekleme

SAMM yanıt vermeyi keserse, seçtiğiniz router'lar abonelerin oturum açma işlemlerini kendi başlarına sürdürür — bunu, SAMM'in üzerlerinde senkronize tuttuğu her aktif kullanıcının devre dışı bırakılmış bir kopyası üzerinden yaparlar. SAMM tekrar aktif olduğunda, herkes onun üzerinden yeniden bağlanır. Varsayılan olarak kapalıdır; her router için Settings → Advanced yolundan açın.

Yedek, belirlediğiniz gecikmeden sonra veya manuel olarak devreye girer ve router bunu Telegram üzerinden bildirir. Bir durum tablosu, her router'ın senkronizasyon durumunu, kaç kullanıcının senkronizasyonunun başarısız olduğunu ve nedenini gösterir; ayrıca yedeği güncelliğini yitirmiş olan veya SAMM'in sağlık adresine ulaşamayan router'ları işaretler.

Ağ & routerlar

MikroTik Cihaz Yöneticisi

Bir router API kimlik bilgilerine sahip olduğunda, SAMM onu doğrudan MikroTik API üzerinden yönetir — WinBox veya SSH gerekmez. MikroTik bölümü, tüm router'ların canlı bir envanteridir ve her cihaz, RouterOS'un neredeyse her bölümünü tarayıcınızdan yapılandırabileceğiniz on beş sekme içeren bir detay sayfası açar.

MikroTik Monitor

MikroTik → Monitor, her router için bir kartı ızgara düzeninde gösterir. Her kart; samm-worker tarafından yenilenen ve her 30 saniyede bir canlı olarak sorgulanan erişilebilirlik durumunu, RouterOS sürümünü, CPU yükünü ve çekirdek sayısını, bellek kullanımını, aktif oturum sayısını, çalışma süresini ve son örnekleme zamanını raporlar.

Bir kart ya NAS olarak etiketlenir (RADIUS ile aboneleri de kimlik doğrulayan bir router) ya da izleme olarak (sadece izleme için eklenen bir cihaz). MikroTik ekle yeni bir cihaz kaydeder; Şimdi yenile anında bir sorgulama zorlar. Sadece izleme kartları sağ tıklama menüsü taşır — Aç, Düzenle, Bilgi Yenile, Sil.

Ubiquiti cihazları

Bir monitör eklediğinizde türünü seçersiniz: MikroTik, Ubiquiti airOS veya Ubiquiti UniFi access point. Ubiquiti cihazlarına cihazın kendi giriş bilgileriyle SSH üzerinden erişilir; Probe sayfası cihazın raporladığı bilgileri gösterir. Bir UniFi access point, Wireless sayfalarında her radyo için bir satır şeklinde görünür — kanalı, genişliği ve SSID'leri, sinyal, gürültü ve hız değerleriyle birlikte bağlı istemciler ve algıladığı komşu ağlar — ayrıca Wi-Fi optimize edici ve kanal planlayıcıda yer alır.

Her plan her router için üç monitöre izin verir (sınırsız router içeren bir plan sınırsız monitöre sahiptir), böylece erişim noktalarınızı izlemek router kotanızı asla tüketmez.

Router'da tutulan kullanıcılar

SAMM, bir router'ın (RouterOS 6 ve 7) kendi bünyesinde tuttuğu PPP girişlerini, Hotspot kullanıcılarını ve User Manager kullanıcılarını bulur ve bunları router sayfasında listeler. Herhangi bir işlem yapılmadan önce, her satır SAMM'in neleri oluşturacağını gösterir: kullanıcı adı, şifre, isim, cep telefonu, plan (SAMM tarafından oluşturulduğunda "new" olarak işaretlenir), son kullanma tarihi, limitler, MAC ve IP. Router yorumlarına Arapça veya İngilizce olarak yazılmış isimler, telefon numaraları ve bitiş tarihleri de okunur. Kullanıcıları seçin ve içeri aktarın: işlem arka planda çalışır ve kullanıcılar aktarıldıkça Kullanıcılar listesi dolar.

Cihaz sayfası — on beş sekme

Tam yönetim sayfasına erişmek için herhangi bir cihazı açın. Sekmeler dört grup altında toplanmıştır.

İzleme

SekmeNeleri gösterir
Genel BakışCihaz bilgileri, sistem bilgileri ve performans geçmişi grafikleri (zaman içindeki CPU, bellek, oturumlar)
ArayüzlerCanlı durumuyla birlikte her arayüz ve arayüz başına trafik geçmişi
Web Siteleri & UygulamalarÜç alt görünüm: Monitor (trafik geçmişiyle birlikte router üzerinde görülen web siteleri ve & uygulamalar), QoS (aşağıda belirtilen, uygulama duyarlı önceliklendirme) ve App Filter (katalogdan DNS tabanlı içerik engelleme)

Cihaz Yöneticisi

Cihaz Yöneticisi → Genel sekmesi, cihazın genel yönetim sayfasıdır: Identity (router adı), Time (saat, zaman dilimi ve NTP) ve Tools (yeniden başlatma, ping ve diğer tek tıkla router işlemleri).

Ağ yapılandırması

SekmeYapılandırdıklarınız
KöprüLAN köprüleri oluşturun ve hangi fiziksel arayüzlerin (portların) hangisine ait olduğunu seçin
VLANVLAN arayüzlerini ekleme ve yönetme
IPÜç alt sekme — Static (statik ve dinamik adresler), DHCP client (üst birimden adres alma), DHCP server (canlı kiralama tablosu ile adres dağıtma)
DNSDNS sunucuları ve önbellek (uygulama/lokasyon içerik filtresi Websites & Apps altında yer alır)
WiFi / CAPsMANYapılandırmaları ve güvenlik profilleriyle birlikte Wi-Fi arayüzleri; ve CAPsMAN denetleyicisi — yapılandırmalar, provisioning kuralları ve uzak CAP'ler

Servisler & bakım

SekmeYapılandırdıklarınız
PPPoEPPPoE sunucuları, PPP profilleri, IP havuzları ve RADIUS accounting interim-update aralığı
HotspotHotspot sunucuları, hotspot profilleri ve kullanıcı profilleri, DHCP/IP havuzları ve captive-portal giriş sayfası
İnternetWAN uplinkleri — SAMM tarafından yönetilen WAN'lar ve varsayılan rotalar; mevcut SAMM dışı WAN'lar salt okunur olarak gösterilir
Güvenlik duvarıFiltre kuralları, router güvenlik analizi, bağlantı & hedefler, güvenlik modülleri ve güvenlik duvarı yedekleri — Auto-Security, uygulamadan önce güvenlik duvarının anlık görüntüsünü alır ve süreli otomatik geri alma özelliğini etkinleştirebilir; böylece erişiminizi engelleyen bir kural seti otomatik olarak geri yüklenir
GüncelleRouterOS güncellemeleri — bir güncelleme kanalı seçin, kontrol edip uygulayın ve yüklü paketleri gözden geçirin
SihirbazAşağıdaki yönlendirmeli ilk kurulum süreci

PPPoE interim-update aralığı

PPPoE sekmesinde, Interim update router'ın SAMM'e ne sıklıkla RADIUS accounting Interim-Update paketleri göndereceğini belirler. SAMM bu paketleri bayt ve çalışma süresi sayaçlarını toplamak; kota, günlük ve çalışma süresi limitlerini değerlendirmek için kullanır — bu paketler olmazsa, limitlerin uygulanması ve canlı oturum sayaçları durur. Önerilen değer 5m'dir.

Hotspot giriş sayfası

Hotspot sekmesinden captive-portal giriş sayfasını yönetebilirsiniz: MikroTik varsayılan sayfalarını kullanmaya devam edin, dahili şablonlardan birini uygulayın veya kayıtlı tasarımlarınızdan birini uygulayın. SAMM, görsel bir tasarım düzenleyici ve şablon galerisi içerir; bir giriş sayfasını özelleştirip doğrudan router'ın hotspot'una gönderebilirsiniz.

Uygulama farkındalıklı QoS

QoS görünümü (Websites & Apps sekmesinin bir alt sekmesi), SAMM'in router üzerinde halihazırda gördüğü uygulama ve lokasyonları bir indirme önceliği planına dönüştürür. Her uygulamayı havuzdan sekiz öncelik yuvasından birine sürükleyin — yoğunluk anında önce 1. yuva, en son ise 8. yuva hizmet alır; havuzda kalan uygulamalar şekillendirilmez. İsteğe bağlı olarak herhangi bir uygulamanın indirme hızını sınırlayabilir (örneğin 10M) ve önceliklerin yarışacağı toplam bir indirme tavanı belirleyebilirsiniz. Kategoriye göre otomatik dağıt seçeneği her şeyi tek tıklamayla düzenler — önce mesajlaşma, ardından AI servisleri, sonra mağazalar ve geri kalan her şey bunların altında yer alır.

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 tüm bilgileri on kısa adımda toplar ve yapılandırmanın tamamını sonunda tek seferde router'a gönderir. Son inceleme adımında onaylayana kadar hiçbir veri gönderilmez.

  1. Hoş geldiniz & tespit et — SAMM router'ı tarar ve halihazırda nelerin yapılandırıldığını gösterir, böylece push işlemi sırasında bu öğeleri atlayabilirsiniz.
  2. Bridge arayüzü — LAN bridge'ine bir isim verin.
  3. Bridge portları — bridge'e dahil edilecek fiziksel arayüzleri seçin.
  4. DNS — üst çözücüleri (Google, Cloudflare, Quad9 ve daha fazlası için tek tıkla ön ayarlar), önbellek boyutunu ve isteğe bağlı olarak bir DNS içerik filtresini ayarlayın.
  5. NTP — router'ın saat kaynağını belirleyin (NTP istemcisi ve isteğe bağlı olarak LAN'a saat sunucusu hizmeti).
  6. Internet — bir veya daha fazla WAN uplink bağlantısı ekleyin (Static / DHCP / PPPoE).
  7. RADIUS'tan SAMM'e — kimlik doğrulama, accounting ve CoA için router'ı SAMM sunucunuza yönlendirin.
  8. Servisler — sihirbazın bir PPPoE sunucusu, bir Hotspot sunucusu veya bir IPoE / DHCP servisi oluşturup oluşturmayacağını seçin ve isteğe bağlı olarak IPv6 dual-stack özelliğini etkinleştirin (isteğe bağlı, varsayılan olarak kapalı): delegasyon (DHCPv6-PD) önek uzunluğunu ve IPv6 bloklarını seçin; sihirbaz havuzları oluşturur ve bunları PPP profiline ekler.
  9. PPPoE / Hotspot detayları & Güvenlik duvarı — havuzlar, profiller, kiralama süreleri, güvenlik duvarı & NAT kuralları ve süresi dolan aboneleri bağlantı kopukluğu yerine SAMM'in "abonelik süresi doldu" sayfasına yönlendiren isteğe bağlı bir Süresi dolmuş havuz & internet engelleme özelliği.
  10. & gönderimini gözden geçirin — gönderilecek komutların tam listesini görün, ardından hepsini router'a gönderin.
Kullanıcı başına hız RADIUS üzerinden belirlenir Sihirbaz tek bir PPPoE / hotspot profili oluşturur — her seviye için ayrı profiller atamaz. Her abonenin hızı, giriş anındaki RADIUS yanıtında SAMM tarafından iletilir, bu nedenle plan değişiklikleri için router üzerinde düzenleme yapılmasına gerek kalmaz.

Ağ & routerlar

Derin inceleme

Bir ağ yavaş hissettirdiğinde Derin inceleme, bir mühendisin yapacağını yapar: bir router'ı bir süre izler, okuyabildiği her şeyi okur ve neyin yanlış olduğunu ve önce ne yapılacağını söyler. Yalnızca okur: router üzerinde hiçbir şeyi değiştirmez ve herhangi bir düzeltme sizin kararınız olarak kalır.

İnceleme başlat

  1. Devices → Network Health sayfasını açın ve Derin inceleme düğmesine basın ya da sayfadaki bir router'a sağ tıklayın.
  2. İncelenecek router'ları açın. Tüm anahtarlar kapalı başlar. Yalnızca kayıtlı girişi olan MikroTik BNG'ler listelenir.
  3. Süreyi seçin: 15 dakika, 30 dakika, 1 saat veya 2 saat. Daha uzun çalışma daha güvenilirdir; yoğun bir saatte çalıştırın.
  4. İncelemeyi başlat düğmesine basın. Arka planda çalışır, sayfayı kapatabilirsiniz. Router başına bir inceleme çalışır, aynı anda en fazla iki tane.

Düğmenin yanındaki Raporlar, her incelemeyi ilerlemesi, sonucu ve puanıyla listeler. Birini erken durdurabilir ve o ana kadar ölçtüklerini saklayabilirsiniz.

Neyi denetler

  • İnternet hatları: internete ve her hatta kayıp ve gecikme, ani yükselmeler ve büyük paketlerin geçip geçmediği.
  • Kullanıcı deneyimi: değişen çevrim içi kullanıcı örneğine test mesajları ve yanıtların ne kadar sürdüğü.
  • Kullanıcı kuyrukları ve hız: paketleri dolduğunda kullanıcıların veri kaybedip kaybetmediği, yükleme ve indirme ile hız sınırlarını atlayabilen kurallar.
  • Erişim ağı ve portlar: her erişim tarafı, router arkasındaki kuleler ve cihazlar, port hataları, kopmalar, hız ve fiber sinyali.
  • Yük dengeleme: hatların trafiği nasıl paylaştığı ve dengeleme kurallarının eksiksiz olup ölü bir hattı fark edip etmediği.
  • Router sağlığı: işlemci yükü ve her çekirdek, bellek, sıcaklık, yeniden başlatmalar, yazılım ve router günlüğü.
  • Girişler ve RADIUS: zamanında yanıtlar, reddedilen girişler, erken biten oturumlar ve paket boyutu ayarları.
  • Güvenlik: router'ın internete kapalı olup olmadığı, güvenlik duvarı sırası, korumalar, ek servisler ve başarısız girişler.
  • Yönlendirme: BGP oturumları, OSPF komşuları ve ölü rotalar.

Tüm Network Health denetimleri dahildir. Okunamayan bir denetim rapordan çıkarılır, asla iyi sayılmaz.

Rapor

100 üzerinden bir puan ve sade bir dille bir karar ile başlar; ardından her alan için bir puan tablosu ve neyin yapılacağına dair bir liste gelir, en önemli olan başta. Altında ayrıntılar ve sayılar bulunur. Panelinizin dilini izler ve Export PDF onu her sayfasında SAMM logosu ve “Prepared by SAMM” ile kaydeder.

İnceleme hafiftir ve router'ın işlemcisi çok meşgulken kullanıcıları yoklamayı durdurur. Router aşırı yüklü kalırsa erken biter ve bunu söyler.

Sistem

SCOOP AI

SCOOP AI, her yönetici sayfasının altındaki bir asistandır. Kullanıcılarınız, paketleriniz, kartlarınız, faturalarınız, ödemeleriniz ve router'larınız hakkında kendi cümlelerinizle ve kendi dilinizde sorun; saniyeler içinde sade bir yanıt alın. Kendiliğinden kurulur ve açılır.

Bir yapay zekâ bağlayın

Settings → SCOOP AI bölümünde Google Gemini (ücretsiz anahtar), ChatGPT (giriş yapın, anahtar gerekmez), Claude, OpenAI, OpenRouter veya DeepSeek'i bağlayın. Birden çok kayıtlı giriş tutup aralarında geçiş yapabilir, bir model seçebilir ya da Automatic'te bırakabilirsiniz. Yapay zekânın kendisinin reddettiği bir anahtar, kaydederken durdurulur; bir yardım sayfası her yapay zekâ için anahtarın nasıl alınacağını gösterir.

Onu güvenli tutan şeyler

  • Her yöneticinin kendi yetkileriyle çalışır: bir yönetici yalnızca rolünün izin verdiklerini görür ve değiştirir.
  • Para, silme işlemleri ve router değişiklikleri siz Approve düğmesine basana kadar beklemede tutulur.
  • Her router değişikliği, router üzerinde geri alma seçeneğini korur ve SAMM'in router ile olan bağlantısına asla dokunmaz.
  • SCOOP AI günlüğü, her yöneticinin her sorusunu, yanıtını ve onayını tutar.

Ondan neler yapmasını isteyebilirsiniz

  • Verileriniz hakkındaki soruları kendi dilinizde yanıtlamak.
  • İnterneti hatlarınız arasında yüzdeye göre dengelemek, seçilen uygulamaları ya da bir VPN'i seçilen bir hat üzerinden göndermek ve daha hızlı DNS ayarlamak.
  • Her pazartesi size rapor göndermek ya da belirli bir saatte hatırlatmak.

Yetkilerde bir SCOOP AI bloğu vardır: kullanmak, günlüğü görmek, ayarları değiştirmek. Her yönetici, robotun menüsünden ya da kendi Profilinden onu kendisi için gizleyebilir.

Ağ & routerlar

Ağ haritası, sağlık durumu, Veri Günlüğü & bağlantı kalitesi

Ağ haritası

Devices → Network Map, her router'ın komşuları hakkında bildirdiği verilere göre çizilir; bakımı gereken bir diyagram yoktur. Portlar, IP adresleri, alt ağlar ve CPU için katmanları değiştirin veya her cihazın internete erişim yolunu görüntüleyin. Düğümleri sürükleyerek yerleştirin ve yerleşimi kaydedin; Discover now komutu komşuları yeniden tarar.

Ağ sağlığı

Devices → Network Health tüm router'ları en kötü durumdan başlayarak listeler: sağlıklı, uyarıları olan, yanıt veren ancak sorunlu veya ulaşılamayan. Her bulgu, sorunun ne olduğunu açıkça belirtir — CoA devre dışı, RADIUS secret uyuşmazlığı, saat senkronizasyon hatası, Telnet veya FTP açık bırakılmış. Kontroller yalnızca router'ı okur. Bir router'ın Diagnose görünümünde, yaygın bulgular için önce bir önizleme gösteren ve geri alınabilen tek tıkla düzeltme seçeneği sunulur. Açık bulgular, Alert Center'da uyarılar oluşturur.

Tek bir MikroTik BNG'ye dair daha uzun bir bakış ve tam rapor için Derin inceleme kullanın.

Her iki sayfa da aynı anahtar altındadır: Settings → Advanced → Network Health. Kapalıyken SAMM, router'lar ile iletişime geçmez. Açık olduğunda ise her router'ın ne sıklıkla kontrol edileceğini, tek bir geçişte kaç router'ın okunacağını (yoğun kurulumlar birkaç geçişe yayılır) ve harita için komşuların keşfedilip keşfedilmeyeceğini seçersiniz.

Uzun süredir çevrimdışı olan bir router duraklatılabilir, böylece tekrar yanıt verene kadar uyarı oluşturmayı durdurur.

Wi-Fi optimize edici

Devices → Wireless → Wi-Fi optimizer, her radyo için çalıştığı bandın spektrum görünümünü (frekanslar genelindeki dBm cinsinden sinyal seviyesi, algılanan ağlar ve bunların çakıştığı noktalar), bu ağların bir listesini ve her kanalı Quiet, Busy veya Crowded olarak işaretleyen bir kanal grafiğini gösterir. Survey now, tüm bandı her seferinde tek bir radyo üzerinden tarar; böylece birden fazla sektörü olan bir lokasyon tüm istemcilerini aynı anda kaybetmez; buton, işlem başlamadan önce maliyetini bildirir. Live sweep, siz izlerken son, zirve ve ortalama değerleri çizer.

Kanal planlayıcı, her radyo için en sessiz kanalı ve en iyi kanal genişliğini önerir. Her radyo için kanal ve genişlik ayarlarını ayrı ayrı Off, Suggest veya Auto olarak seçin ya da ağını takip etmesini sağlayın; Wireless listesinden birçok radyoyu aynı anda ayarlayabilirsiniz. Auto modunda SAMM, radyoları saat 04:00'te teker teker taşır ve her radyoyu yeni kanalında yeniden tarar. Uygula bir radyoyu hemen taşır, Geri Al ise eski kanalına geri taşır. MikroTik radyolarında (wifi ve wireless paketleri, CAPsMAN) ve Ubiquiti UniFi erişim noktalarında çalışır.

Veri Günlüğü

Bir kullanıcıyı açın ve trafiğin nereye gittiğini görmek için Data Log seçeneğini belirleyin: host ve uygulama bazlı en popüler hedefler — YouTube, Facebook, WhatsApp — yükleme, indirme ve bağlantı sayılarıyla birlikte veya bir zaman çizelgesi şeklinde görüntülenir. SAMM, router'ın kendi akış dışa aktarımını (IPFIX) okur, bunun yokluğunda bağlantı tablosuna başvurur ve uygulamaları App Filter'ın kullandığı katalogla aynı isimlerle adlandırır. SAMM hiçbir zaman trafik yolunda yer almaz.

  • Ayarlar → Gelişmiş → Veri Günlüğü yolundaki Kullanıcı Veri Günlüğünü Kaydet seçeneği bunu etkinleştirir.
  • Saatlik detaylar birkaç gün boyunca saklanır, ardından lokasyon başına günlük tek bir satıra indirgenerek sıkıştırılır — bu da boyutun yaklaşık yirmi dörtten birine denk gelir. Hem sayfa hem de dışa aktarma işlemi her iki veriyi de okuduğu için görünürden hiçbir şey kaybolmaz.
  • Saatlik hedef sayısı her kullanıcının saat başına en yoğun hedeflerini tutar ve tek seferlik adreslerin oluşturduğu uzun kuyruğu eler; 0 her şeyi tutar.
  • Retention, satırların gece yapılan temizlik işlemiyle silinmeden önce ne kadar süreyle saklanacağını belirler.
  • Skip usage seçeneğiyle yapılan bir yedekleme, Data Log'u hariç tutar, böylece dosya boyutu küçük kalır.
Siz açana kadar kapalı kalır Bir superadmin, Ayarlar'dan Data Log özelliğini etkinleştirir ve verilerin ne kadar süreyle saklanacağını seçer. Rakamlar gösterge niteliğindedir; faturalandırma her zaman RADIUS accounting kullanır.

Bağlantı kalitesi

Bir kullanıcı çevrimiçiyken SAMM, halihazırda aldığı accounting verilerinden yararlanarak her birkaç dakikada bir kullanıcının ortalama hızını kaydedebilir ve router üzerinden kısa bir test yaparak gecikme ve kaybı ölçebilir. Kullanıcı sayfası; en güncel değerlerin yer aldığı bir Bağlantı kalitesi kartı, plana göre hız geçmişi ve bir Şimdi test et butonu gösterir; kullanıcı listesinde isteğe bağlı bir sütun bulunur ve dışa aktarma işlemi bu değerleri içerebilir. Geçmiş iki gün boyunca saklanır.

Siz açana kadar kapalı kalır Ayarlar → Gelişmiş → Bağlantı Kalitesi kısmından etkinleştirin; burada aynı zamanda kullanıcıların ne sıklıkla örneklemeye alınacağını ve bir router'ın tur başına kaç kullanıcıyı test edeceğini (en eski ölçüm öncelikli olacak şekilde) ayarlarsınız. Tasarımı gereği hafiftir: hız ölçümü router trafiğine yük getirmez ve her router üzerindeki test yükü sınırlandırılmıştır. Testi engelleyen bir cihaz, hat sorunsuz olsa bile yanıt vermez. Şimdi test et, özellik kapalıyken bile çalışır.

Ağ & routerlar

CoA & anlık değişiklikler

CoA (Change-of-Authorization), SAMM'in bir abonenin oturumunu çevrimiçiyken —hızını artırmak, düşürmek veya bağlantısını kesmek için— yeniden bağlanmasını beklemeden değiştirme yöntemidir.

Bir değişikliğin aktif aboneye ulaşma süreci

SAMM, bir butona tıklayarak router değişikliğini asla doğrudan uygulamaz. Her yönetici işlemi tek bir güvenli yol izler:

Yönetici işlemi → Denetim günlüğü → samm-radius tick → CoA giden kutusu → Router
  1. İşlem, denetim günlüğüne kuyruğa alınmış bir komut olarak kaydedilir.
  2. samm-radius servisi, bir sonraki tick işleminde kuyruğu boşaltır, değişikliği uygular ve — eğer abone çevrimiçiyse — bir CoA'yı kuyruğa ekler.
  3. CoA giden kutusu boşaltılır ve paket router'a gönderilir.

Zaman güdümlü olaylar — süre dolumu, hız penceresi sınırları, günlük sıfırlamalar — aynı giden kutusunu besler. Gecikme için üst sınır bir samm-radius tikidir (varsayılan olarak 30 s; daha sıkı uygulama için Ayarlar kısmından düşürün).

Hibrit CoA

SAMM, oturumu mevcut haliyle değiştirmek için önce bir CoA-Update gönderir. Router, yapılandırılan yeniden deneme sayısından sonra bunu reddederse, SAMM otomatik olarak Disconnect-Request yöntemine geri döner — abone yeniden bağlanır ve yeni ayarları alır. Bu hibrit strateji, MikroTik donanım yazılımı sürümleri genelinde çalışır.

CoA Giden Kutusu sayfası

Users → CoA Outbox, bu kuyruğun canlı görünümüdür. samm-radius tek göndericidir — yönetici paneli hiçbir zaman doğrudan bir CoA göndermez — ve kuyruğu her tick işleminde boşaltır. Sayfa her 30 saniyede bir otomatik olarak yenilenir.

Sayfanın başında altı sayaç bulunur — Pending, Sent, NACK (retrying), Done, Failed ve Total. Tabloyu duruma, işleme (update veya disconnect) göre filtreleyebilir veya kullanıcı adı, NAS IP veya neden ile arama yapabilirsiniz.

DurumAnlam
beklemedeSıraya alındı, bir sonraki samm-radius tick bekleniyor
gönderildiGönderildi (geçici — gönderim ve sonucu aynı tick içinde kaydedildiğinden, satırlar nadiren bu durumda kalır)
nackRouter CoA-Update isteğini reddetti — SAMM yeniden deniyor, ardından bağlantıyı kesme işlemine geçiyor
tamamlandıBaşarıyla uygulandı
başarısızYeniden deneme sınırı aşıldı — son hatayı görmek için rozetin üzerine gelin

Her satır kullanıcıyı, router'ı, işlemi, deneme sayısını, nedeni, oluşturulma ve gönderilme zamanlarını gösterir. Satır bazlı işlemler; başarısız olan veya nack'lenen bir paketi Yeniden Denemenize, hâlâ iletimde olan bir paketi İptal etmenize veya paketin taşıdığı kesin RADIUS özniteliklerini incelemek için Öznitelikler kısmını açmanıza olanak tanır. Yan çubuk rozeti bekleyen satırları sayar; gösterge paneli ise 24 saatlik başarısızlıkları takip eder. Sağlıklı bir sistemde bu kuyruk neredeyse boş kalır.

Zaman aşımına uğramış oturum temizleyici

Bir router çökerse veya bağlantısı kesilirse, Accounting-Stop paketleri kaybolabilir ve birçok sistemde bu aboneler sonsuza dek "çevrimiçi" kalır. SAMM, Interim-Update göndermeyi durdurmuş oturumları tarar ve bunları otomatik olarak kapatır (sonlandırma nedeni Reaped-Stale); böylece aktif oturum listesi, eşzamanlı kullanım sayıları ve kullanım verileri güncel kalır. Zaman aşımı süresi stale_session_timeout_seconds ayarıdır (varsayılan 900 s = 15 dakika; devre dışı bırakmak için 0 olarak ayarlayın) ve yeniden başlatma gerektirmeden anında etkili olur.

Günlük operasyonlar

Gösterge paneli & canlı oturumlar

Overview altındaki iki ekran, her vardiyaya başladığınız yerdir: tüm sistemin genel durumu için Gösterge Paneli ve şu an tam olarak kimlerin bağlı olduğunu görmek için Canlı Oturumlar.

İki ekran: yeni pencerede açma

Her sayfanın üst çubuğunda bir Yeni pencerede aç düğmesi vardır: sayfa kenar çubuğu ve üst çubuk olmadan tek başına açılır, ikinci monitöre sürüklenmeye hazırdır. O penceredeki bağlantılar aynı modda kalır. Her gösterge paneli bloğunun köşesinde de aynı düğme bulunur: blok kendi penceresini doldurur ve gösterge paneliyle birlikte yenilenmeye devam eder; böylece Canlı Oturumlar, router sağlığı veya bir grafik gösterge paneli düzeninizi değiştirmeden gün boyu gözünüzün önünde kalır.

Gösterge paneli

Overview → Gösterge Paneli operatör ana ekranıdır. Üst kısımdaki dönem seçici — Today, 7d, 14d, 30d, 90d — trend grafiği ve tarih bazlı rakamlar için zaman aralığını belirler.

Altı KPI kutucuğu

Her kutucuk canlı bir sayaç ve bir kısayoldur; sayının temsil ettiği filtrelenmiş listeye doğrudan gitmek için üzerine tıklayın.

KutucukGösterirAçılır
Şu an çevrimiçiŞu anda aktif RADIUS oturumu olan abonelerKullanıcılar Çevrimiçi olarak filtrelendi
Aktif abonelerAktif hesaplar ve toplam abone sayısı aşağıdadırKullanıcılar Aktif olarak filtrelendi
Süresi dolduSonraki planı belirlenmemiş ve aboneliği sona ermiş abonelerKullanıcılar Süresi Dolmuş şeklinde filtrelendi
Açık destek talepleriHenüz çözülmemiş destek talepleri (& tamamlandı veya kapatıldı olanlar hariç)Kullanıcılar → Destek Talepleri
RouterlarToplam NAS kayıtları ve şu an ulaşılamayanların sayısıMikroTik monitörü
Ödenmemiş faturalarÖdeme takibi gereken faturalarFaturalar Ödenmemiş olarak filtrelendi

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

Günlük anlık görüntü çizgi grafiği, seçilen dönem boyunca üç seriyi — aktif kullanıcılar, çevrimiçi oturumlar ve süresi dolmuş kullanıcılar — grafikleyerek büyüme ve kullanıcı kaybının bir bakışta görülmesini sağlar.

Pipeline durumu

Bu panel, uygulama motorunun kalbidir. Sağlıklı bir sistemde kuyruklar sıfırda veya sıfıra yakın olur; bu sayının yüksek kalması, takılmış bir servise veya değişiklikleri reddeden bir router'a işaret eder.

MetrikNe anlama gelir
samm-radius kuyrukBir sonraki tick'i bekleyen Beklemedeki CoA'lar — saniyeler içinde temizlenir
Başarısız CoA (24sa)Sağlıklı bir sistemde sıfırdır; sıfır dışındaki bir değer, bir router'ın CoA'ları reddettiği anlamına gelir
Denetim günlüğü beklemedesamm-radius tarafından henüz uygulanmamış, kuyrukta bekleyen yönetici işlemleri
Sınırlandırılan oturumlarBir limit nedeniyle şu anda düşük hızda tutulan aboneler — beklenen bir durum, hata değil
Oturumların anlık görüntüsüCanlı oturum sayısı — Şu an çevrimiçi değerini takip etmelidir
Aktif planlarPlan kataloğunuzun boyutu
Yürütme yolu Yönetici işlemleri samm.audit_log üzerinde kuyruğa alınır; samm-radius tick'i bu kuyruğu boşaltarak samm.coa_outbox içine CoA'lar gönderir. Tam yol CoA & canlı değişiklikler kısmında yer almaktadır.

Son etkinlik tabloları

Grafiğin altındaki dört tablo, az önce neler olduğuna dair güncel bir görünüm sunar ve her birinde ilgili sayfanın tamamına giden bir Tümünü görüntüle bağlantısı bulunur:

  • Son CoA giden kutusu — işlem, kullanıcı, durum (tamamlandı / beklemede / nack / başarısız), deneme sayısı, neden ve zaman.
  • Son yönetici işlemleri — işlem, hedef, işlemi tetikleyen kişi, uygulanıp uygulanmadığı ve zaman.
  • Son aboneler — en yeni hesaplar, durumları ve son kimlik doğrulama zamanları.
  • Routerlar — her NAS için erişilebilir / erişilemez / veri yok sağlık göstergesiyle birlikte.

Canlı Oturumlar

Overview → Live Sessions sayfası, router'ların RADIUS accounting üzerinden şu an çevrimiçi olarak bildirdiği tüm aboneleri listeler. Sayfa her 30 saniyede bir otomatik olarak yenilenir; üst bilgi kısmında manuel bir Yenile butonu bulunur.

Listeyi filtreleme

  • Ara — kullanıcı adı, framed IP veya NAS IP ile eşleşir ve siz yazdıkça arama yapar.
  • Router — listeyi tek bir NAS üzerindeki oturumlarla sınırlandırın.
  • Yalnızca sınırlandırılmış — sadece limiti nedeniyle düşük hızda kalan aboneleri gösterir.
  • Sayfa başına — 20, 50, 100 veya 200 satır.

Her satırın gösterdiği bilgiler

SütunAnlam
KullanıcıKullanıcı adı — abonenin detay sayfasına yönlendirir
Framed IPRouter'ın bu oturuma atadığı adres
RouterNAS kısa adı ve IP adresi
PlanAbonenin mevcut planı
Etkin hızŞu anda router üzerinde uygulanan hız — plan hızının aktif herhangi bir hız penceresiyle ayarlanmış halidir. throttled rozeti, bir limitin aboneyi düşük bir hızda tuttuğu anlamına gelir.
Devre Dışı / EtkinOturum için anlık bayt sayaçları
ÇevrimiçiOturumun aktif olduğu süre
BaşlatıldıOturum başladığında

Oturumu sonlandırma

Bir satırdaki Disconnect butonu, bir onay isteminin ardından ilgili oturum için (neden admin_manual) bir CoA-Disconnect isteğini sıraya alır. Abonenin bağlantısı hemen kesilir; hesapları hâlâ aktifse yeniden bağlanabilirler. Paketi CoA Outbox üzerinden takip edin.

Günlük operasyonlar

Raporlar & analizler

Overview → Reports analiz görünümüdür; burada abone trendleri, zaman içindeki trafik ile ağınızdaki en yoğun kullanıcılar ve kartlar yer alır.

Aralık seçimi

Sayfadaki tüm veriler bir tarih aralığına bağlıdır. Bir ön ayar seçin — 7d, 14d, 30d, 90d — veya belirli başlangıç ve bitiş tarihlerini girip Uygula düğmesine tıklayın. 90d gibi uzun süreli bir sorgu çalışırken sayfa üzerinde bir yükleme ekranı görünür.

Abone & oturum trendleri

Seçilen aralıkta üç seriden oluşan bir çizgi grafik: Active aboneler, Online oturumlar ve Expired aboneler. Büyümeyi, müşteri kaybını ve ağınızın yoğun saatlerini tespit etmek için kullanın.

Günlük trafik

Günlük yükleme ve indirme baytlarının yığılmış sütun grafiği. Bir günün üzerine gelindiğinde, araç ipucu alt bilgisinde yükleme ve indirme rakamlarının yanı sıra birleştirilmiş toplam değer gösterilir.

En iyi 10 listeleri

En yoğun trafiğe sahip hesaplarınız, her biri GB cinsinden hacme göre sıralanmış dört tabloda gösterilir:

ListeRütbeler
Bugünün en çok indirilen ilk 10 içeriğiSon günlük sıfırlamadan beri gerçekleşen en büyük indirme
Bugünün en yüksek 10 yüklemesiSon günlük sıfırlamadan bu yana gerçekleşen en büyük yükleme
En yüksek 10 indirme ayıBu takvim ayındaki en yüksek indirme
En yüksek 10 yükleme ayıBu takvim ayındaki en yüksek yükleme

Varlığa göre trafik

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

  • Kullanıcılar — her bir abonenin adı, planı, bugünkü yükleme/indirme miktarı (MB) ve bu ayki yükleme/indirme miktarı (GB).
  • Kartlar — her bir hotspot kartı; grubu, durumu ve aynı günlük / aylık trafik dağılımı ile birlikte gösterilir.

arama kutusu siz yazdıkça tabloyu filtreler; sayfa başına seçici ile 20 ile 200 arasında satır seçilebilir. Her satır, ilgili abonenin veya kartın detay sayfasına yönlendirir.

Dışa Aktarma Raporlar, ekran üzerinden erişilebilen bir analiz görünümüdür. Verileri bir hesap tablosunda işlemek üzere ham satırlar halinde almak için kullanıcıları, planları veya NAS verilerini CSV / XLSX olarak indirmek amacıyla Araçlar → Dışa Aktar / İçe Aktar kısmını kullanın.

Canlı Trafik sayfası

Kullanıcılar, routerlar ve arayüzler için saniyede bir kez yenilenen, güncel veri akışının ayrı ve canlı bir görünümü. Sık kontrol ettiğiniz kombinasyonları, bir sonraki seferde tek tıkla ulaşabilmek için yer imlerine ekleyin.

Günlük operasyonlar

Muhasebe & faturalandırma

SAMM, yerleşik ve eksiksiz bir çift kayıtlı defter tutma sistemine sahiptir — faturalar, giderler, makbuzlar, ödemeler, bayiler, sabit varlıklar ve tam mali tablolar. Entegre edilecek ayrı bir faturalandırma ürününe veya kayıtları düzenli tutmak için bir muhasebeciye ihtiyaç yoktur.

Borç ve alacak kayıtlarına asla müdahale etmezsiniz Her işlem — ödeme kaydetme, gider ekleme, kart grubu satma — deftere otomatik olarak dengeli bir yevmiye kaydı işler. Siz basit terimlerle (faturalar, giderler, makbuzlar) çalışırsınız; SAMM arka planda çift kayıtlı defterleri tutar ve bunların Mizan'da dengelendiğini kanıtlar.

Accounting sayfası on bir sekmeden oluşmaktadır.

Genel Bakış

Finansal genel bakış. Üst kısımda dört ana rakam yer alır:

ŞekilAnlam
Kasadaki nakitTüm nakit & banka hesaplarındaki toplam bakiye
AlacaklarınızAlacaklar — ödenmemiş müşteri ve bayi faturaları
BorcunuzBorçlar — ödenmemiş giderler
Bu ayki kârCari ay için gelirler eksi giderler

Aşağıda: her bir nakit & banka hesabının bakiyesini gösteren bir tablo ve son 1, 2, 3, 6 veya 12 aya ait bir gelirler ile giderler grafiği bulunmaktadır.

Şubeye göre kitaplar

Her fatura, ödeme, gider, varlık ve kasa hesabı bir şubeye veya Genel şirkete aittir. Bir fatura, kullanıcı daha sonra yer değiştirse bile, düzenlendiği sırada kullanıcının bağlı olduğu şubeyi korur. Her sekmenin üst kısmındaki Şube seçici; tüm şirketi, yalnızca Genel şirketi veya alt şubeleriyle birlikte tek bir şubeyi gösterir; listeler şubeye göre filtrelenebilir, sıralanabilir ve gruplandırılabilir. Finansal yetkiye sahip bir şube yöneticisi yalnızca kendi şubesinin kayıtlarını görür.

Nakit devri: bir şube, kendi nakit hesabından şirket nakit hesabına nakit gönderir; işlem, şirket nakdin ulaştığını onayladığında kaydedilir. Raporlar → Şubeler tüm şubeleri yan yana listeler: gelir, gider, net, tahsilatlar, bakiye, aktif kullanıcılar ve kullanıcı başına gelir.

Faturalar

Fatura, düzenlediğiniz bir belgedir. Yeni fatura butonuna tıklayın ve şunları doldurun:

AlanAnlam
MüşteriFaturalandırılan hesap için otomatik tamamlama araması
Gelir kategorisiSatışın kaydedileceği gelir hesabı
Düzenleme tarihi / Vade tarihiDüzenleme tarihi boşsa = bugün; vade tarihi boşsa = düzenleme tarihi
Vergi oranı % / vergi grubuVarsayılan olarak Ayarlar → Faturalandırma'na ayarlanır; birden fazla oran (KDV/GST ve daha fazlası) aynı anda uygulanmak üzere bir vergilendirme grubu atayın, her biri kendi vergi hesabına gönderilir
Satır kalemleriBir veya daha fazla açıklama / miktar / birim fiyat satırı — ara toplam, vergi ve toplam anlık olarak hesaplanır

Ücretlendirme tutarı — tam, kademeli veya ücretsiz

SAMM'nin bir aboneye fatura keseceği her durumda — plan etkinleştirme, yenileme, değiştirme, son geçerlilik tarihini uzatma veya tüm bunları toplu olarak yapma — aynı fatura seçici görünür ve siz onaylamadan önce tutarı gösterir:

SeçimÜcretlendirme detayları
Tam faturaYalnızca tam plan dönemleri — eksik dönemler bir üst tam döneme yuvarlanır.
Kırılımlı faturaTam süre, son kısmi dönem için oranlanarak hesaplanır. Toplam tutar en yakın tam sayıya yuvarlanır ve defterlerin dengede kalması için fark yuvarlama düzeltmesi olarak kaydedilir.
Fatura yokServisi değiştirin ve ücret almayın — bir iyi niyet uzatması, bir taşıma veya bir düzeltme.

Tüm plan süreleri için uzunluğu periods multiplier ile ayarlayın veya kesin bir tarih girerek maliyetin SAMM tarafından hesaplanmasını sağlayın. Her iki durumda da panel; siz değişiklik yaptıkça kalemleri, vergiyi ve toplam tutarı gösterir ve Paid seçeneği toplam tutar için nakit ödemeyi anında kaydeder.

"Fatura yok" bir haktır, onay kutusu değil Ücret almamak finansal bir karardır, bu nedenle Settings → Admins kısmındaki rol bazlı bir izinle sınırlandırılmıştır. Bu durum en çok agentlar için önemlidir: aboneleri kendi ön ödemeli bakiyeleri üzerinden faturalandırılan bir agent, aksi takdirde hiçbir ödeme yapmadan gün boyu yenileme yapabilir, plan değiştirebilir ve süre uzatabilir. Yeni rollerde bu hak kapalı olarak gelir.

Dunning & ön ödemeli cüzdan

Tek seferlik faturaların ötesinde SAMM, tüm tahsilat döngüsünü otomatikleştirir. Bir ödeme hatırlatma çizelgesi; fatura gününü, son ödeme gününü ve otomatik engelleme gününü —isteğe bağlı gecikme ücretleriyle birlikte— belirler; böylece vadesi geçmiş abonelere hatırlatma yapılır ve ardından erişimleri kesilir, sizin bir hesap tablosunu takip etmenize gerek kalmaz. Ön ödemeli cüzdan modu, abonelerin yenileme sırasında faturaları otomatik olarak ödeyen bir bakiye tutmalarına olanak tanır; aboneler bakiyelerini müşteri portalı üzerinden kartla veya kripto ile kendileri doldurur ve her yükleme ile kesinti deftere kaydedilir.

Grace planları: önce fatura kesilir, ödeme sonrası yenilenir

Yaygın bir kurulum, planlar zinciridir: ücretli plan sona erdiğinde tam hızda kısa bir tolerans süresi planına, ardından yavaş bir plana geçer ve sonrasında kullanıcının bağlantısı kesilir. Muhasebe → Ayarlar içindeki Ücretli bir plan sona erdiğinde, bir sonraki planı için yenileme faturası oluşturun özelliğini açtığınızda, SAMM kullanıcı ek süreye (grace) geçtiği anda yenileme faturasını oluşturur ve bu fatura ek süre sona erdiğinde ödenmelidir. Ödeme yapıldığı anda —kasada, çevrimiçi veya cüzdandan— kullanıcı, faturalandırma gününün kaymaması için planının sona erdiği tarihten itibaren geçerli olacak şekilde eski planına geri döner. Ödeme yapmayan kullanıcılar ise zincir boyunca ilerlemeye devam eder.

Bu kullanıcılar için Planı yenile butonuna basmayın Planı yenilemek, ödeme yapılmış olsun veya olmasın, servisi anında tamamen geri yükler. Bu ayar açık olduğunda, fatura ve ödeme işlemi yenilemeyi sizin yerinize gerçekleştirir. Siz açana kadar bu ayar kapalıdır.

Faturalar, planın bir fiyatı olması kaydıyla, bir abonenin planı yenilendiğinde (kullanıcının Süreyi Yenile işlemiyle veya otomatik yenileme ile) otomatik olarak da oluşturulur. Liste; ödenmemiş, kısmi, vadesi gelmiş, ödenmiş durumlarına göre filtrelenebilir ve fatura numarasına veya müşteriye göre aranabilir. Detay sayfası ve yazdırılabilir bir PDF için herhangi bir faturayı açın; aboneler kendi kopyalarını müşteri portalından ve Telegram botundan indirebilirler.

Giderler

Gider, ISP'yi işletmek için harcanan paradır. Yeni gider bir kategoriyi (gider hesabı), ödeme yapılan üreticiyi, tutarı, oluşma tarihini ve isteğe bağlı bir son ödeme tarihini kaydeder. Her gider, bir fatura ile aynı ödenmemiş / kısmi / vadesi gelmiş / ödenmiş yaşam döngüsüne, bir detay sayfasına ve yazdırılabilir bir makbuz PDF dosyasına sahiptir.

Tahsilatlar & Ödemeler

Bu iki sekme, buna sebep olan fatura veya giderden farklı olarak, fiilen hareket eden nakit akışını kaydeder.

  • Makbuzlar — gelen para: bir müşteriden, bir bayiden alınan nakit veya diğer gelirlerin nakit hesaplarınızdan birine girmesidir. Fatura ödeme talebidir; makbuz ise bu faturaya karşılık gelen paradır.
  • Ödemeler — çıkan para: bir gidere karşılık veya bir bayiye ödenen nakit.

Bir makbuz veya ödeme kaydetmek, ilgili faturayı veya gideri ödendi durumuna taşır ve eşleşen defter kaydını oluşturur.

Müşteriler & Kart satışları

Customers sekmesi, her müşterinin güncel bakiyesini — size olan borcunu listeler. Card sales, ön ödemeli hotspot gelirlerini kapsar: satılan card groups ve resellers takibini yapar. Bir reseller, sizden fatura karşılığında tüm kart gruplarını satın alır ve ardından tekil kartları son kullanıcılara satar; balance owed kısmı, size hâlâ ödemeleri gereken tutardır.

Acenteler — toptan faturalandırma

Bir agent, servislerinizi son müşterilere prepaid wholesale modeliyle satar — bunu, kendi abone portföyünü yöneten ancak sizin ağınızı kullanan bir franchise veya alt bayi gibi düşünebilirsiniz. Bu tamamen isteğe bağlıdır: eğer hiçbir zaman bir agent oluşturmazsanız, faturalandırma her zamanki gibi çalışmaya devam eder.

İki borç, net bir şekilde ayrılmış Acente size toptan satış fiyatını borçludur (kayıtlarınızda bu sizin gelirinizdir); müşteri ise acenteye perakende satış fiyatını borçludur (kayıtlarınızın dışında — acentenin kendi alacağıdır). Komisyonunuz, bu ikisi arasındaki farktır ve bir gider olarak değil, ticari iskonto olarak kaydedilir.

Ayarlar → Yöneticiler kısmında yeni bir yöneticiye yerleşik Agent rolünü vererek bir agent oluşturun. Agent, şunlara sahip kapsamlı bir yönetici girişidir:

AyarAnlam
Komisyon %Acentenin perakende fiyat üzerinden aldığı pay (örneğin %40 — %60'lık kısmı toptan satış geliri olarak sizde kalır). Her acente için istenildiği zaman düzenlenebilir.
Kredi limitiYenilemeler reddedilmeden önce temsilcinin ön ödemeli bakiyesinin ne kadar eksiye düşebileceği. Kesin ön ödemeli sistem için 0 ayarlayın.
Ön ödemeli bakiyeAcente size ödeme yaptığında bakiyeyi doldurun; her yenileme işlemi buradan toptan satış fiyatını çeker.

Acentenin abonelerinden biri yenileme yaptığında, SAMM acentenin bakiyesinden toptan satış fiyatını tahsil eder, gelirinizi kaydeder ve son müşteriye, acenteye ödenecek olan ve sizin defterinizde yer almayan gerçek bir perakende faturası düzenler. Ayarlar → Faturalandırma altında kendi anahtarı bulunan, varsayılan olarak açık olan ve düzenlenebilir bir ek süreye sahip Acente tarafı borç hatırlatma (dunning) özelliği, ödeme yapmayan müşteriyi otomatik olarak askıya alır (bir CoA bağlantı kesme işlemi başlatır); acente müşterinin ödemesini kaydettiğinde, abone anında yeniden aktif hale gelir.

Bir temsilci kapsamlı görünüme giriş yapar: kendi gösterge paneli, bir Bakiyem cüzdan sayfası, her müşterinin faturalarını ve ödemelerini içeren bir Müşterilerim listesi ve bir Ekstrelerim — tüm bunlar kendi defteriyle sınırlıdır. Şirket genelindeki defterleriniz, diğer temsilcilerin ve diğer yöneticilerin müşterileri gizli kalır.

Varlıklar & Nakit hesapları

  • Varlıklar — sabit varlıkları (routerlar, araçlar, ekipmanlar) kaydedin. SAMM, bunların değerini ve zaman içindeki amortismanını takip eder.
  • Nakit — nakit & banka hesaplarınızı ve sermaye hesaplarınızı yönetin: katkının sahibin işletmeye koyduğu para, çekimin ise dışarı çıkarılan para olduğu özkaynaklar. Sermaye bir gelir değildir ve Kar & Zarar tablosunda asla görünmez.

Raporlar — mali tablolar

Reports sekmesi muhasebeci görünümüdür. Her biri tarih aralığı belirlenebilen ve PDF olarak dışa aktarılabilen beş rapor sunar:

RaporYanıtlar
Kâr & ZararBelirli bir tarih aralığındaki gelirler, giderler ve net kâr. Tahakkuk esası — gelirler faturalandırıldığında, giderler ise nakit hareketi gerçekleştiğinde değil, ortaya çıktığında kaydedilir.
BilançoBelirli bir tarih itibarıyla: sahip olduğunuz varlıklar ile borçlarınız (yükümlülükler) ve özkaynakların toplamı karşılaştırılır. balanced rozeti, iki tarafın birbirini tuttuğunu onaylar.
Nakit AkışıNakit hesap başına — belirli bir tarih aralığı için açılış bakiyesi, gelen para, giden para ve kapanış bakiyesi.
YaşlandırmaVadesi geçmiş faturaların takibini yapabilmeniz ve ödemelerinizi önceden planlayabilmeniz için yaşlandırma gruplarına göre sıralanmış bekleyen alacaklar ve borçlar.
GelişmişHam defterler: Genel Defter (her hesapta birikimli bakiyeli her satır), Mizan (defter dengesi kontrolü), Yevmiye Defteri ve bir etkinlik günlüğü.
Denge kontrolü Trial Balance içinde her hesabın borç ve alacak sütunlarının toplamı eşit olmalıdır; bu, kayıtların doğru olduğunun kanıtıdır. Eğer bir dengesizlik oluşursa, bu durum araştırılması gereken bir kayıt hatasına işaret eder.

Muhasebe yazılımına aktar

Accounting → Reports → Export altında; General Journal, Chart of Accounts, Invoices, Trial Balance, Profit & Loss ve Balance Sheet defterlerini QuickBooks, Xero veya herhangi bir hesap tablosu için CSV olarak indirin. General Journal, Invoices ve P&L tarih aralığını kullanır; diğerleri ise güncel durumu esas alır. Aynı verilere BI hatları ve Zapier için GET /api/v1/accounting/export/{kind} (format=json|csv, kapsam accounting:read) API uç noktası üzerinden erişilebilir. Dışa aktarımlar iptal edilen kayıtları hariç tutar, bu nedenle indirme işlemi her zaman ekrandaki raporlarla uyuşur.

Günlük operasyonlar

Geri al & onaylar

Bir ISP panelindeki hataların çoğu finansal hatalardır: yanlış abonenin yenilenmesi, bir ödemenin iki kez kaydedilmesi veya yanlış hesapta plan değişikliği yapılması. SAMM, bu işlemler için size beş dakikalık bir geri alma penceresi ve —bir işlem para iadesi içerdiğinde— işlemin yürürlüğe girmesinden önce bir superadmin onay mekanizması sunar.

Geri al penceresi

Para veya durum değişikliği yapan her yönetici işlemi gerçekleştiği anda kaydedilir. Sonraki beş dakika boyunca üst çubukta bir Geri Al butonu ve bir İşlem geçmişi listesi yer alır — son işlemi geri almak için oka tıklayın veya geçmişi açarak bu süre içindeki herhangi bir noktaya geri dönün. Yinele işlemi tekrar uygular.

Neden sadece beş dakika Geri alma işlemi bir zaman makinesi değil, sadece yaptığınız son tıklama için bir güvenlik ağıdır. Birkaç dakika sonra dünya ilerlemiş olur: abone çevrimiçi olmuş, bir fatura ödenmiş veya başka biri kaydı düzenlemiş olabilir. SAMM, geçmişi sessizce yeniden yazmak yerine işlemi reddetmeyi tercih eder; bu nedenle pencere kapandığında bu adım geçmişinizden silinir.

Bir geri alma işlemi, tersine çevrildiğinde kendi oluşturmadığı bir şeyi yok edecekse —ekrandaki gerekçeyle birlikte— reddedilir:

ReddetmeNe anlama gelir
Bu kayıt artık mevcut değilİşleminizden sonra abone, fatura veya ödeme silindi; geri getirilecek hiçbir şey kalmadı.
Bu kayıt zaten mevcutYerine yeni bir kayıt oluşturuldu; geri alma işlemi daha yeni olan kaydın üzerine yazacaktır.
Bu kayıt, işleminizden sonra değiştiBu süre zarfında başka biri düzenleme yaptı — geri alma işlemi, yapılan bu düzenlemeyi sessizce iptal edecektir.
Bu adım artık geçmişinizde yer almıyorBeş dakikalık süre doldu.

Geri al işlemi bir tersine çevirmedir, silme işlemi değildir: hem orijinal işlem hem de geri alma işlemi Audit log içinde kalır, böylece ne olduğuna dair kayıt asla kaybolmaz. Bir şeyler oluşturan işlemler, çalışmadan önce sizi açıkça uyarır — bunu geri almak, oluşturulan şeyi silecektir —.

Ajan onay mekanizması

Bir agent, bir aboneyi etkinleştirdiği anda ödemeyi kendi ön ödemeli bakiyesinden yapar. Bu durum, bir işlemi geri almayı parayı geri almanın bir yolu — ve aynı zamanda bir hile yöntemi haline getirir: bir aboneyi etkinleştirip tüm ay boyunca kullanmasını sağlamak, ardından son günde aboneyi silip ücreti geri talep etmek.

Böylece SAMM, bir temsilcinin eylemlerini paranın hareket yönüne göre ayırır:

YönÖrneklerDavranış
Acenteye maliyet çıkarır Etkinleştir, yenile, planı değiştir, müşteri ödemesi tahsil et Anında. Bir ajanın günlük işleri asla kimseyi beklemez.
Parayı iade eder Geri al, abone sil, fatura sil, tahsilatı iptal et İstek olarak bekletiliyor. Bir superadmin onaylayana kadar hiçbir değişiklik yapılmaz.

Kısıtlanmış eylemler yarıda kalmaz. İstek, daha sonra yürütülmesi için gereken her şeyle birlikte saklanır ve onaylamak, isteği ajanın çalıştıracağı kodun aynısı üzerinden yeniden yürütür — ilk uygulamadan sapabilecek ikinci bir uygulama asla kullanılmaz. Reddetmek, durumu olduğu gibi bırakır ve görev ajanda kalır.

Kuyruğun işlenmesi

İstekler; temsilci, işlem, ilgili konu ve kararı belirleyen rakam olan iade edilecek tutar ile birlikte Accounting → Agents Approval yoluna düşer. Temsilciye veya duruma göre filtreleme yapabilir, arama gerçekleştirebilir, birden fazlasını seçerek topluca onaylayabilir veya reddedebilirsiniz; reddetme işlemine, temsilcinin görebileceği kısa bir neden eklenebilir.

Devret Tüm gün boyunca temsilcileri incelemek nadiren süper yöneticinin görevidir. Agents Approval yetkisi, Ayarlar → Yöneticiler kısmından herhangi bir role atanabilir; böylece inceleme işlemini fiilen gerçekleştiren kişi tam olarak bu yetkiye sahip olur — başka hiçbir şeye değil. Temsilcileri oluşturma ve yönetme işlemleri yalnızca süper yöneticiye özel kalır. Hiç kimse kendi talebi hakkında karar veremez.

Ajanın gördükleri

Bir temsilci, talep ettiği her şeyin listelendiği; nelerin hâlâ beklediğini, nelerin onaylandığını veya inceleyicinin gerekçesiyle birlikte nelerin reddedildiğini gösteren bir My Account → Pending Approvals sayfasına erişir. Bu sayfa olmasaydı, bir ret cevabı kaybolan bir talepten ayırt edilemezdi ve temsilci talebini basitçe tekrarlardı.

Bekleyen taleplerini —tek tek veya birkaçını aynı anda— geri çekebilirler; çünkü geri çekilemeyen bir talepte bulunmak başlı başına bir tuzaktır. Geri çekilen bir talep hiçbir zaman çalıştırılmadığı için hiçbir şey değişmez; karara bağlanmış bir talep ise geçmişte kalır ve değişmez. İnceleme bekleyen bir fatura, kendi sayfasında bunu belirtir; böylece Sil butonuna tıklayıp hiçbir işlem gerçekleşmediğini gören bir temsilci nedenini anlar.

Aboneleriniz için

Çevrimiçi ödemeler

SAMM, abonelerinizin faturalarını çevrim içi ödemesine olanak tanır — banka kartıyla (Stripe veya PayPal), kripto parayla (Binance) veya Suriye'de Sham Cash ile. Bir abone ödeme yaptığında, SAMM faturayı ödenmiş olarak işaretler, kayıtlarınıza işler ve — ödeme yapılmadığı için erişimi kesilmişse — onu otomatik olarak yeniden bağlar. Sizden hiçbir ücret alınmaz: her ağ geçidi kendi hesabınızı kullanır, bu yüzden para doğrudan size ulaşır.

Etkinleştirin (herhangi bir ağ geçidi)

  1. Financial → Online payments yolunu açın (yalnızca superadmin).
  2. Bir ağ geçidine tıklayarak ayrıntılarını görün — Stripe, PayPal veya Binance.
  3. Alanlarını doldurun, Enable this gateway seçeneğini işaretleyin ve Kaydet düğmesine tıklayın. Gerekli alanlar doldurulana kadar SAMM kaydetmenize izin vermeyecektir.
  4. Kimlik bilgilerinizin çalıştığını onaylamak için Run test butonuna tıklayın.
  5. Tamamlandı — aboneleriniz artık portalda ödenmemiş faturalarında (ve "abonelik süresi doldu" sayfasında) bir Öde butonu görecek.

Birden fazla ağ geçidini etkinleştirebilirsiniz; abone hangisini kullanacağını seçer.

Stripe — banka kartları, dünya çapında

  1. stripe.com adresinde ücretsiz bir hesap oluşturun. Deneme süresince Test mode seçeneğini açık tutun.
  2. Developers → API keys bölümüne gidin ve Secret key değerini kopyalayın (sk_ ile başlar).
  3. SAMM içinde Stripe'ı genişletin, Secret key'i yapıştırın, para birimini ve ödemenin alınacağı kasa hesabını seçin, ardından Kaydet ve Testi çalıştır butonlarına tıklayın.
  4. Önerilen: Ödemelerin güvenilir şekilde onaylanması için bir webhook ekleyin. Stripe'da Developers → Webhooks → Add endpoint bölümüne gidin, URL'yi https://YOUR-SAMM/pay/webhook/stripe olarak ayarlayın, checkout.session.completed olayını seçin ve ardından imzalama sırrını (whsec_…) SAMM'deki Webhook signing secret alanına kopyalayın.
Canlıya geçiş Test modu her yerde çalışır. Stripe üzerinden gerçek ödeme almak için Stripe destekli bir ülke ve bağlı bir banka hesabı gereklidir.

PayPal — kartlar & PayPal bakiyesi

  1. Bir PayPal Business hesabı oluşturun, ardından developer.paypal.com adresinde bir REST App oluşturun ve bunun Client ID ile Secret bilgilerini kopyalayın.
  2. SAMM içinde PayPal'ı genişletin, Client ID ve Client secret bilgilerini yapıştırın, Sandbox (test) veya Live seçeneğini belirleyin, ardından Kaydet ve Testi çalıştır butonlarına tıklayın.
  3. Önerilen: developer.paypal.com → Uygulamanız → Webhooks kısmına bir webhook ekleyin, URL olarak https://YOUR-SAMM/pay/webhook/paypal girin, CHECKOUT.ORDER.APPROVED ve PAYMENT.CAPTURE.COMPLETED olaylarına abone olun, ardından gelen bildirimlerin kriptografik olarak doğrulanması için Webhook ID bilgisini SAMM içine yapıştırın.

Binance — kripto, her yerde geçerli, banka gerekmez

Kartların ve PayPal'ın kullanılamadığı durumlarda bu en iyi seçenektir. Aboneleriniz kripto parayla öder; SAMM Binance hesabınızı izler ve faturayı otomatik olarak ödenmiş işaretler. Üç şeye ihtiyacınız var: bir API Key, bir API Secret ve ödemelerin alınacağı bir yer — bir cüzdan adresi ve/veya bir Binance Pay ID.

Adım 1 — salt okunur bir API anahtarı oluşturun

Önce güvenlik Anahtarı yalnızca okuma erişimiyle oluşturun. Withdraw veya Trade seçeneklerini asla etkinleştirmeyin — SAMM'nin yalnızca gelen ödemelerinizi okuması gerekir, fonları asla taşımaz.
  1. Binance hesabınıza giriş yapın → Hesap → API Yönetimi kısmını açın (veya "API Yönetimi" şeklinde aratın).
  2. Create API düğmesine tıklayın → System generated seçeneğini belirleyin → örneğin "SAMM" şeklinde adlandırın → güvenlik kontrolünü tamamlayın.
  3. Binance API Key ve Secret Key bilgilerini gösterir — her ikisini de şimdi kopyalayın (Secret Key yalnızca bir kez gösterilir).
  4. Kısıtlamaları düzenle seçeneğine tıklayın ve yalnızca "Okumayı Etkinleştir" seçeneğini işaretli bırakın. Spot Trading ve Withdrawals seçeneklerini KAPALI tutun. (İsteğe bağlı: anahtarı sunucunuzun IP adresiyle kısıtlayın.)
  5. API Key ve API Secret bilgilerini SAMM'in Binance kartına yapıştırın (önce Key, sonra Secret — Binance'in gösterdiği sırayla).

Adım 2 — alıcı cüzdan adresinizi edinin

  1. Binance'de Wallet → Spot → Deposit (Deposit Crypto) bölümüne gidin.
  2. USDT coinini seçin.
  3. ağ seçin — TRC20 en ucuz ve en yaygın olanıdır; BEP20 ve ERC20 de kullanılabilir. SAMM'de seçtiğiniz ağ ile aynı olanı kullanın.
  4. Yatırma Adresini kopyalayın ve SAMM'in On-chain receiving wallet address alanına yapıştırın. SAMM'in Network açılır menüsünün seçtiğiniz ağ ile eşleştiğinden emin olun.

Adım 3 — (isteğe bağlı) Binance Pay ID

Binance Pay'i (anlık, ağ ücreti yok) tercih eden aboneler için: Binance uygulamasında Pay kısmını açın ve Pay ID'nizi not edin (e-postanız veya telefon numaranız da geçerlidir). Bunu SAMM'deki Binance Pay ID alanına yapıştırın. Aboneler daha sonra hem Pay ID ile hem de on-chain üzerinden ödeme yapabilirler.

Son olarak Enable kutucuğunu işaretleyin, Save ve ardından Run test düğmelerine tıklayın (bu işlem anahtarın hesabınıza erişebildiğini kontrol eder). Artık yayındasınız.

Tam miktar, doğru ağ Bir abone, SAMM'ın gösterdiği tam tutarı (son küçük rakamlar faturayı tanımlar) doğru ağ üzerinden göndermelidir. Farklı bir tutar veya yanlış ağ, ödemenin gecikmesine veya kaybolmasına neden olur.

Sham Cash — Suriye

Kullanıcılarınız Sham Cash uygulaması veya Sham Cash web sitesi üzerinden ödeme yapar ve ödeme tamamlandığı an SAMM'e bildirilir. Para kendi Sham Cash ticari hesabınıza aktarılır.

  1. Doğrulanmış bir Sham Cash ticari hesabı açın, ardından Sham Cash destek ekibinden sizin için bir elektronik ödeme servisi oluşturmalarını isteyin (sizden logo adresinizi ve kullanıcılarınızın göreceği ismi isteyeceklerdir).
  2. Sham Cash size üç değer sağlar: Agent Key, Secret Key ve Base URL. Test servisi ve gerçek servisin her birinin kendine ait üç değeri vardır.
  3. SAMM'de Finansal → Çevrim içi ödemeler → Sham Cash sayfasını açın, Bağlantı ayarını Official API olarak bırakın, üç değeri yapıştırın, para birimini seçin (USD veya SYP, SAMM para biriminizle aynı) ve Kaydet, ardından Testi çalıştır.
  4. Sham Cash'in her ödemeyi onaylayabilmesi için SAMM'ın internet üzerinden erişilebilir olması gerekir. SAMM farklı bir adres üzerinden yayınlanıyorsa, bu adresi Public SAMM address for the callback alanına girin. Bunun için Sham Cash tarafında herhangi bir yapılandırma yapılmasına gerek yoktur: SAMM, her ödeme ile birlikte kendi adresini gönderir.
Test servisi veya gerçek servis test değerleri ile her ödeme bir simülasyondur: ödeme sayfası 000000 kodunu kabul eder, SAMM faturayı ödenmiş olarak gösterir ve hiçbir hesaba para aktarılmaz. Gerçek ödemeler için Sham Cash destek ekibinden real servisinizin değerlerini almanız gerekir. Kaydettiğiniz Base URL'yi kontrol edin: test URL'si gerçek olanla aynı değildir.

Kullanıcının yaptığı işlem: ödeme kartı üzerinde Open Sham Cash butonuna basar. Telefonda Sham Cash uygulaması (sürüm 2.2.5 veya daha yenisi), aksi takdirde Sham Cash web sitesi açılır; kullanıcı tutarı kontrol eder ve transfer onay kodu (Sham Cash uygulamasında ayarlanmış) ile onaylar. Bilgisayarda kart, telefon kamerası ile taranacak bir QR kod da gösterir. Her ödeme bağlantısı 10 dakika boyunca geçerlidir; Sham Cash onay verdiği anda kart otomatik olarak onaylanır.

Sham Cash'in kendi uygulaması sizin adınıza ödemeler de alabilir: uygulamaya yalnızca Payment apps iznine sahip bir token tanımlayın (REST API bölümüne bakın). Uygulama, kullanıcıyı kullanıcı adına göre bulur ve aldığı ödemeyi kaydeder.

Üye işyeri anahtarları olmadan Sham Cash (Non-official API)

Sham Cash'ten üye işyeri hizmetiniz yok mu? SAMM, Sham Cash ödemelerini shamcash-api.com üzerinden alabilir; bu, kendi Sham Cash hesabınıza gelen transferleri okuyan bağımsız bir hizmettir (Sham Cash değildir). Yalnızca okuyabilir: para gönderemez.

  1. shamcash-api.com'da bir hesap açın ve Sham Cash hesabınızı bağlayın: Sham Cash uygulamasında Hesabım → Bağlı cihazlar bölümünü açın ve onların QR kodunu okutun. Aboneliği başlatın ve salt okunur bir API anahtarı oluşturun.
  2. SAMM'de Finansal → Çevrim içi ödemeler → Sham Cash sayfasını açın, Bağlantı ayarını Non-official API (shamcash-api.com) yapın, API anahtarını yapıştırın, para birimini seçin ve Kaydet. SAMM, hesap kimliğinizi ve Sham Cash adresinizi anahtardan okur. Ardından Testi çalıştır.

Kullanıcı ne yapar: ödeme kartında Sham Cash adresiniz (ve QR kodu), tutar ve SM-1234 gibi kısa bir kod görünür. Kullanıcı tutarı Sham Cash uygulamasından gönderir ve kodu transfer notuna yazar. SAMM ödemeyi bir dakika içinde onaylar. Kodsuz, tutardan az veya başka bir para birimindeki transfer uygulanmak yerine incelemeniz için bekletilir.

Ödeme sayfası ve çevrimiçi yenileme

Settings → Billing → Pay page, /pay adresinde herkese açık bir sayfayı etkinleştirir: kullanıcı giriş yapmadan kullanıcı adını girer, borcunu görür ve ödemesini yapar. Aynı Pay page, giriş yapmış kullanıcılar için kullanıcı portalında da yer alır.

  • Yenileme: kullanıcılar, planlarını sona ermeden önce veya sona erdikten sonra, 1 ile 12 dönem arasında çevrimiçi olarak yenileyebilirler. Ön ödeme yapıldığında mevcut süreleri korunur; planı sona ermiş bir kullanıcı, ödeme ulaştığı anda tekrar çevrimiçi olur. Bu seçeneğin nerede sunulacağını iki anahtar belirler: Ödeme sayfasında yenile ve Kullanıcı portalında yenile (her ikisi de varsayılan olarak açıktır).
  • Kullanıcıları ön ek veya son ekleri olmadan bulun: 858000@inet gibi kullanıcı adları için 858000 (en az 6 karakter) yazıldığında hesap bulunur. Birden fazla hesap eşleştiğinde, kullanıcıdan tam kullanıcı adı istenir. Varsayılan olarak kapalıdır.
  • Sayfanın hesap hakkında neleri göstereceğini seçin (maskelenmiş isim, plan, son kullanma tarihi ve daha fazlası); varsayılan olarak yalnızca maskelenmiş isim gösterilir.

Abonenin gördükleri

  1. Müşteri portalına giriş yapın → Faturalarım.
  2. Ödenmemiş bir faturada Öde (veya birden fazlası etkinse "Öde · Stripe" / "Öde · Binance") butonuna tıklarlar.
  3. Kart: ağ geçidinin güvenli sayfasına yönlendirilirler. Kripto: tam tutarı, QR kodlu adresinizi ve/veya Pay ID'nizi görürler.
  4. Ödeme yapıldığında fatura Paid durumuna geçer, kayıtlarınıza işlenir ve eğer süreleri dolmuşsa otomatik olarak yeniden bağlanırlar — süresi dolan aboneler, süre dolum sayfasında bir "Öde & yeniden bağlan" butonu bile görürler.
Kayıtlarınız olduğu gibi kalır Her çevrimiçi ödeme, dengeli bir çift kayıt (Dr Nakit / Cr Alacaklar) oluşturur ve ödeme yöntemini (Stripe / Binance) faturaya, ödeme geçmişine ve PDF'e kaydeder; böylece her ödemenin hangi yöntemle geldiğini her zaman bilirsiniz.

Günlük operasyonlar

Destek talepleri

SAMM yerleşik bir yardım masasına sahiptir. Aboneler müşteri portalı veya Telegram botu üzerinden destek talebi oluşturabilir, bir yönetici bir abone adına talep açabilir ve ekibiniz tüm bu talepleri Users → Support Tickets yolundan yönetebilir.

Destek talebi kuyruğu

Kuyruk; her bir destek talebinin numarasını, müşterisini, konusunu, önceliğini, durumunu, açılış ve son güncelleme tarihlerini ve mesaj sayısını listeler. Şunlarla filtreleyin:

  • Durum çipleri — her bilet durumu için bir adet ve her biri anlık sayım içeren bu çipler sayesinde iş yükü bir bakışta görülebilir.
  • Öncelik — Normal, Orta veya Kritik.
  • Aktif / Geri Çekilmiş — bir müşteri artık ihtiyaç duymadığı bir talebi geri çekebilir; geri çekilen talepler soluklaşır ve varsayılan olarak gizlenir.
  • Ara — destek talebi numarasına, konuya veya müşteriye göre.

Yan menü rozeti, hiçbir şeyin gözden kaçmaması için açık destek taleplerini sayar.

Destek talebi oluşturma

Yeni talep, yöneticinin seçilen bir müşteri için talep oluşturmasını sağlar — müşteriyi seçin, ardından konu, öncelik ve açıklama belirleyin. Aboneler ayrıca müşteri portalı veya Telegram botu üzerinden kendi taleplerini oluşturabilirler.

Destek talebiyle çalışma

Konuşma geçmişinin tamamını okumak için bir destek talebi açın. Buradan şunları yapabilirsiniz:

  • Müşteriye yanıt ver — abonenin portalında ve Telegram botu üzerinden gördüğü herkese açık bir mesajdır.
  • Dahili not ekle — ekibiniz arasındaki devir notları için kullanılan, müşteriden gizlenen ve yalnızca personelin görebileceği bir mesaj.
  • Biletin durumunu ve önceliğini değiştirin.

Kuyruktan ayrılmadan aynı durum, öncelik, yanıt ve dahili not işlemlerini gerçekleştirmek için herhangi bir satıra sağ tıklayın veya ⋮ düğmesini kullanın.

Günlük operasyonlar

Bildirim Merkezi

SAMM, aboneleri email, Telegram, SMS ve WhatsApp üzerinden otomatik olarak bilgilendirir ve mesaj yayınlamanıza olanak tanır. samm-notification servisi tüm iletimleri tek bir sınırlandırılmış kuyruk üzerinden gerçekleştirir. System → Notification Center sayfasında altı sekme bulunur.

Genel Bakış

Ana sekme — canlı sayımlar (sıradaki, gönderiliyor, bugün gönderilenler, başarısız, atlanan, abonelikten çıkanlar), her bir teslimat kanalının durumu ve en son bildirimlerin akışı.

Kanallar

Mesajların SAMM üzerinden nasıl gönderileceğini yapılandırın. Email, Ayarlar kısmındaki şifre kurtarma SMTP'sinden ayrı tutulan kendi bildirim hesabını kullanır. Telegram bir bot token'ı kullanır, SMS genel bir HTTP ağ geçidi veya Twilio üzerinden iletilir ve WhatsApp, (Meta for Developers'da oluşturulan) resmi Meta WhatsApp Cloud API'sini kullanır; ayrıca kendi riskinize kullanabileceğiniz isteğe bağlı, resmi olmayan QR bağlantılı bir köprü mevcuttur — bu köprü, yalın bir OS sunucusuna tek tıkla kurulur ve Docker üzerinde çalışmaya hazır bir container olarak sunulur. Tüm kanal sırları Fernet ile şifrelenmiş olarak saklanır. Her abone, müşteri portalı üzerinden hangi kanalları istediğini seçebilir veya bildirimleri tamamen kapatabilir.

SMS ağ geçitleri, yalnızca onaylanmış şablonları kabul eden operatörler için şablon modunda da gönderim yapabilir: şablon adını girersiniz ve SAMM değerleri, şablonun beklediği sırada gönderir. Her ağ geçidinin istediği numara formatını seçin (+ veya 00 ile uluslararası veya başında 0 olan ya da olmayan ulusal format). Sağlayıcınızdan çalışan bir ağ geçidi bağlantısını yapıştırın; SAMM alanları, şablon modunu ve numara formatını sizin için doldurur.

Mesajlar

Her olay için bir set şeklinde mesaj şablonları. Yenileme hatırlatıcıları, makbuzlar ve diğer tüm bildirimlerin metinlerini düzenleyerek her mesajın kendi üslubunuz ve dilinizle gönderilmesini sağlayın.

Kurallar & Zamanlayıcılar

Bu sekme, otomatik bildirimlerin ne zaman ve nasıl tetikleneceğini yönetir. Her bir olay için şunları kontrol edebilirsiniz:

  • Kuralın açık olup olmadığı.
  • Abonelikten çıkma isteğini yoksay — etkinleştirildiğinde, mesaj abonelikten çıkmış olanlar dahil tüm abonelere ulaşır. Bunu yalnızca önemli işlemsel mesajlar için kullanın.
  • Zamanlama — örneğin, yenileme hatırlatıcısının süre dolmadan kaç gün önce gönderileceği.
  • Teslimat & sınırlaması — işlemci, her tik başına bir grup şeklinde kuyruğu boşaltır; grup boyutu ve tik aralığı, mesajların çıkış hızını birlikte belirler, böylece büyük bir yayın asla e-posta sunucunuzu aşırı yüklemez.

SAMM tarafından otomatik olarak tetiklenebilen olaylar arasında yenileme hatırlatıcısı (bir abonelik sona ermeden önce), süre dolum bildirimi (abonelik sona erdiğinde), kota uyarısı (veri sınırı azaldığında), ödeme makbuzu (bir ödeme kaydedildiğinde) ve plan yenilendi yer alır.

Broadcast

Seçilen bir abone grubuna tek seferlik bir mesaj — bakım penceresi, fiyat değişikliği gibi — gönderin. Yayın, otomatik bildirimlerle aynı hız sınırlı kuyruk üzerinden iletilir.

Giden Kutusu

SAMM tarafından kuyruğa alınan veya gönderilen her mesaj ve her mesajın teslimat durumu; böylece bir bildirimin aboneye ulaşıp ulaşmadığını onaylayabilir veya ulaşmadıysa nedenini görebilirsiniz.

Sistem

VPN: WireGuard, L2TP/IPsec, SSTP — VPN: WireGuard, L2TP/IPsec, SSTP

SAMM, kendi VPN sunucusunu SAMM host üzerinde çalıştırır; böylece NAT arkasında, mobil hatta veya başka bir şehirde olan router'lar RADIUS ve yönetim için SAMM'a erişebilir. Her şey System → VPN yolundadır; shell gerekmez. Yeni kurulumlar üç seçeneği de hazır olarak sunar ve her biri siz etkinleştirene kadar kapalıdır.

TürŞu amaçlarla kullanın:
WireGuardRouterOS 7 routerlar, telefonlar ve dizüstü bilgisayarlar. En hızlı ve en basit yöntem.
L2TP/IPsecRouterOS 6 ve 7 router'lar ile WireGuard özelliği bulunmayan cihazlar.
SSTPRouterOS 6 veya 7 üzerinde, aynı genel adres üzerinden İnternet'e erişen iki veya daha fazla router.

Sunucu sekmesi

  1. WireGuard için, sunucu anahtar çiftini oluşturmak üzere Generate Keys butonuna tıklayın.
  2. Dinleme portunu, sunucu tünel adresini ve istemci adres aralığını kontrol edin veya varsayılan değerleri bırakın.
  3. Sunucuyu açın. Her değişiklik bir açılır pencere ile onaylanır.

SAMM host'unun özel bir adresi varsa ve genel adresiniz ona yönlendirilmişse, SAMM genel adresi bulur (veya siz bunu VPN sayfasında bir kez girersiniz) ve bu adresi her istemciye ve router'a iletir.

Tek seferde router ekle

Add Client butonuna tıklayın ve bir isim verin. MikroTik için, tek satırlık install link bağlantısını kopyalayın ve router terminaline yapıştırın: bu işlem tüneli, router'ın kendi SAMM girişini, RADIUS yapılandırmasını ve süresi dolmuş kullanıcılar sayfasını tek adımda kurar. SAMM'ın router'ı nasıl ekleyeceğini seçin:

  • Yönetilen NAS — router, kullanıcılarınızı SAMM üzerinden kimliklendirir ve yönetimi SAMM sağlar.
  • Yalnızca izle — kullanıcıların üzerinden giriş yapmasını istemediğiniz, ancak takip etmek istediğiniz (sağlık durumu, harita, Wireless sayfası) erişim noktaları ve diğer cihazlar için.

Şube personeli tarafından eklenen bir router, ilgili şubeye aittir. WireGuard istemcileri ayrıca bir yapılandırma dosyası veya mobil uygulama için bir QR kod ile eklenebilir. İstemciler yeniden adlandırılabilir, kapatılabilir veya silinebilir; renkleri ise bağlı, zaman aşımına uğramış veya hiç görülmemiş olduklarını gösterir.

Anahtarların yeniden oluşturulması mevcut verileri siler Anahtarları Yeniden Oluştur, WireGuard sunucu anahtar çiftini değiştirir. Mevcut tüm istemciler, yeni yapılandırmayı alana kadar bağlantısı kesilir. Panel, onaylamanız için sizden bir kelime yazmanızı ister.

Ağ & routerlar

RouterOS 6 ve 7

SAMM, RouterOS 6 ve RouterOS 7 yüklü router'ları aynı anda yönetebilir. Ekstra bir işlem yapmanıza gerek yoktur: SAMM, her router'ın versiyonunu tespit eder ve o versiyona uygun komutları gönderir.

Her şey her ikisinde de çalışır: kurulum sihirbazı, Auto-Complete, yapılandırma iletimi, Cihaz Yöneticisi işlemleri, Websites & Apps, QoS, NTP, süresi dolmuş kullanıcılar sayfası ve WireGuard (RouterOS 7), L2TP/IPsec ve SSTP bağlantıları. RouterOS 6'da, sürüm 6'da DNS adres listeleri bulunmadığı için Websites & Apps listeleri kataloğun alan adlarından oluşturulur.

WireGuard desteği olmayan eski routerlar RouterOS 6'da WireGuard bulunmamaktadır. Bu router'ları L2TP/IPsec veya SSTP üzerinden bağlayın.

Ağ & routerlar

Yapılandırma iletimi

SAMM'in router'larınıza gönderdiği her değişiklik — RADIUS, süresi dolmuş sayfa, sihirbaz, DNS filtresi, Websites & Apps, QoS, Auto Security, DNS, NTP ve ebeveyn kontrolü — Devices → Config delivery yolunda takip edebileceğiniz bir delivery işlemidir.

  • Her router için bir ilerleme çubuğu ve sonuç; bir router değişikliği reddettiğinde ise bunun kesin nedeni görüntülenir.
  • Çevrimdışı olan bir router, tekrar çevrimiçi olduğu anda değişikliği alır; başarısız olan değişiklikler otomatik olarak yeniden denenir ve Yeniden Dene tek tıkla gerçekleştirilir.
  • Her değişiklik uygulandıktan sonra router üzerinde kontrol edilir ve işlem sırasında RADIUS ve QoS asla boş bırakılmaz.

Ağ & routerlar

Çok sayıda router üzerinde Cihaz Yöneticisi işlemleri

Devices → Manager kısmında, router'ları işaretleyin ve tümü üzerinde tek bir işlem gerçekleştirmek için Actions menüsünü açın: Websites & Apps gönderin, RADIUS yapılandırmasını gönderin, süresi dolmuş kullanıcılar sayfasını kurun, Router Security, yedekleme ve dışa aktarma, RouterOS güncellemesi, betik çalıştırın veya yeniden başlatın.

Her diyalog, seçtiğiniz router'lar arasındaki en kapsamlı ayarlarla başlar. İşlemler arka planda çalışır: sayfadan ayrılabilirsiniz ve bir açılır pencere, her router'ın işlemini ne zaman tamamladığını veya neden başarısız olduğunu size bildirir. Riskli işlemler, onaylamanız için bir kelime yazmanızı ister. Cihaz Yöneticisi ayrıca her router'ın şubesini de gösterir.

Ağ & routerlar

Dinamik Hız Artırıcı

Bir router'ın interneti boşta kaldığında, kullanıcılara ücretsiz olarak daha fazla hız sağlayın ve hat meşgul olduğu anda bu hızı geri alın. Tools → Speed Boost → Dynamic (varsayılan olarak kapalı) altından etkinleştirin ve hızlandırılabilecek planları seçin.

  • O router üzerindeki tüm çevrimiçi kullanıcılar, varsayılan olarak 3 kata kadar, indirme hızlarının aynı kat sayısını alır.
  • Booster, her router'ın yoğun ve sakin saatlerini öğrenir (varsayılan olarak 3 gün, son günler daha ağırlıklıdır), her 15 dakikada bir plan yapar, bir saat sonrasını öngörür ve artırımı adım adım yükseltir.
  • Bir koruyucu her dakika kontrol yapar ve trafik normale döner dönmez boost işlemini sonlandırır. Çoğu gün yoğun olan router'lar asla boost edilmez.
  • Kullanıcılar portallarında Boosted rozeti görürler; Kullanıcılar listesinde Boosted sütunu ve filtresi bulunur.

Günlük operasyonlar

Aktivasyonlar & Veri Günlüğü

Aktivasyonlar

Overview → Activations; yenilemeler, yeni kullanıcılar ve plan değişiklikleri bazında, bu hafta, ay, yıl veya iki tarih arasında, önceki döneme kıyasla hangi planların en çok etkinleştirildiğini gösterir. By plan ve By user listeleri; arama, filtreleme, sıralama ve Excel veya CSV dışa aktarma özelliklerine sahiptir.

Veri Günlüğü

Overview → Data Log tüm kullanıcıların Veri Günlüğü'nde aynı anda arama yapar: herhangi bir zaman diliminde bir adrese veya aralığa, bir porta, bir protokole veya bir uygulamaya kimin eriştiğini bulun. Sonuçları gruplandırın, görünümleri kaydedin ve CSV veya XLSX formatında dışa aktarın. Geçmişin ne kadar süreyle saklanacağı, History cleaner üzerinden ayarlayabileceğiniz sizin tercihinizdir.

Günlüğü Kabul Et

Kabul Günlüğü, her giriş denemesinin hangi router'dan geldiğini gösterir; router bazlı arama, gruplandırma, sıralama ve dışa aktarma özelliklerine sahiptir.

Sistem

Markalama: logonuz, adınız ve renginiz

SAMM'i şirketinize uygun hale getirin. Tüm ayarlar System → Settings → ISP yolundadır.

Logonuz

  1. Logo kutucuğuna veya Logo yükle kısmına basın ve bir PNG, JPEG, WebP veya GIF resmi (en fazla 5 MB) seçin.
  2. Resmi yerleştirmek için sürükleyin ve yakınlaştırmak için kaydırıcıyı kullanın. Şeffaf arka planlar şeffaf kalır.
  3. Use logo düğmesine basın: anında 400×400 px kare olarak kaydedilir. Remove ise logoyu kaldırır.

Logo; faturalarda, makbuzlarda, basılı hotspot kartlarında, süre dolum sayfasında ve router'larınızın gösterdiği giriş sayfalarında kullanılır.

Panellerdeki markalama

Panellerde markamı kullan seçeneğini açın; ismi, rengi ve bir alt bilgi satırını (örneğin destek numaranızı) ayarlayın, ardından ISP sekmesindeki Kaydet butonuna basın. Böylece markanız; yönetici panelinde, kullanıcı portalında ve her iki oturum açma sayfasında SAMM'ın yerine geçer. Bu seçeneği kapattığınızda her şey her zamanki görünümüne döner.

Sistem

Cloudflare Tüneli

Bir Cloudflare Zero Trust tüneli, SAMM'ı herhangi bir güvenlik duvarı portu açmadan genel internete açar; bu, SAMM ana bilgisayarı NAT arkasında olduğunda kullanışlıdır. System → Cloudflare Tunnel üzerinden yönetilir.

Servis durumu

Sayfa, konnektörün durumunu raporlayan bir durum kartıyla açılır:

DurumAnlam
ÇalışıyorTünel aktif ve trafiği yönlendiriyor
DurdurulduYapılandırıldı ancak şu an çalışmıyor
Yapılandırılmadıİkili dosya mevcut — kurulumu yapmak için bir token yapıştırın
Yüklü değilinstall.sh'ı yeniden çalıştırın ve cloudflared ikili dosyasını yükleyin

Ayrıca cloudflared sürümünü ve bağlayıcının açılışta otomatik başlatılma durumunu gösterir.

Tüneli yapılandırın

  1. Cloudflare Zero Trust gösterge panelinde (one.dash.cloudflare.com), Networks → Tunnels yolunu açın ve Create a tunnel butonuna tıklayın.
  2. Cloudflared bağlayıcısını seçin, tünele bir isim verin ve kaydedin. Kurulum adımında, --token ifadesinden sonra gelen uzun dizgeyi, yani yalnızca token'ı kopyalayın.
  3. SAMM içine yapıştırın ve Configure Tunnel düğmesine tıklayın. SAMM, token'ı cloudflared birimine iletir ve konnektörü başlatır.
  4. Cloudflare'e geri dönün ve bir Public hostname ekleyin: seçtiğiniz adres, tür HTTP, URL localhost:80 (nginx üzerinden proxy — önerilen) veya localhost:8000 (doğrudan API'ye).

Birkaç saniye içinde durum rozeti yeşile döner ve SAMM genel ana bilgisayar adı üzerinden erişilebilir hale gelir. Yapılandırıldıktan sonra, tek tıkla işlemlerle bağlayıcıyı Başlat, Durdur veya Yeniden Başlat yapabilir, token'ı yenilemek için Token Değiştir seçeneğini kullanabilir veya Tüneli kaldır (onay için REMOVE yazılması gereken bir işlem) işlemini gerçekleştirebilirsiniz.

Açık port yok, token veritabanında hiç bulunmadı Tünel, Cloudflare'in edge noktasına dışa doğru bir bağlantı kurar; böylece sunucuda hiçbir güvenlik duvarı portu açılmasına gerek kalmaz. Token, cloudflared uygulamasına iletilir ve /etc/cloudflared/ altında saklanır; SAMM bunu veritabanında asla kalıcı olarak tutmaz. TLS, Cloudflare'in edge noktasında sonlandığı için SAMM'in kendisi loopback üzerinde yalın HTTP çalıştırır.

Sistem

Ayarlar

System → Settings, canlı ve anında yeniden yüklenebilir ayarları içerir. Daemon'lar bu ayarları bir sonraki döngüde yeniden okur — servislerin yeniden başlatılmasına gerek yoktur. Ayarlar sekmeler halinde düzenlenmiştir.

Genel ayarlar

AyarVarsayılanKontroller
samm-radius interval30 sZaman güdümlü olayların ne sıklıkla değerlendirildiği ve CoA'ların ne sıklıkla gönderildiği
samm-worker interval5 sRouter ping + MikroTik API senkronizasyon sıklığı
Hesap ara periyodu60 sRouter'lara iletilen hesaplama aralığı
Günlük sıfırlama zamanı00:00Günlük kullanım sayaçları sıfırlandığında
Sunucu saat dilimiUTCHız pencereleri ve günlük sıfırlama için zaman dilimi
Varsayılan CoA portu3799CoA paketleri için varsayılan UDP portu
Maksimum CoA yeniden deneme sayısı3Disconnect-Request yedeğine geçmeden önceki yeniden denemeler

Daha sıkı denetim için samm-radius aralığını düşürün; yükü azaltmak için artırın.

ISP kimliği, logosu, para birimi & faturalandırma (ISP sekmesi)

Çoğu operatörün "bunu nereden değiştiririm?" diye sorduğu tüm ayarlar System → Settings → ISP yolunda yer alır. Bir alanı düzenleyin ve Kaydet butonuna tıklayın — değişiklik anında aktif olur (yeniden başlatma gerekmez) ve faturalara, makbuzlara, PDF'lere ve müşteri portalına yansır.

Neleri değiştirdiğinizGörüntülendiği yer
ISP adıFaturalar, makbuzlar, hotspot kartları, portal üst bilgisi
Destek telefonu & e-postaFaturalar ve yazdırılabilir hotspot kartları
Vergi / kayıt numarasıFaturalarda yazdırılır
ISP logosu (yükleme PNG/JPEG/WebP/GIF)Yükleyin, ardından tarayıcıda kırpmak için sürükleyin ve yakınlaştırın; fatura/makbuz PDF'lerinde, basılı hotspot kartlarında ve router giriş sayfalarında görünür. Branding bölümüne bakın.
Para birimi kodu (e.g. USD)Faturalardaki ve defterdeki ISO para birimi
Para birimi simgesi (e.g. $)Yönetim arayüzü, müşteri portalı ve PDF'lerde gösterilen her tutar
Vergi açık/kapalı, etiket & oranFaturalara bir VAT/GST satırı ekler (örn. etiket VAT, oran 11 = %11)
Para simgesini değiştirin Her yerde gösterilen para birimini değiştirmek için (örneğin $ yerine £ veya yerel bir sembol kullanmak için), ISP sekmesindeki Currency symbol alanını ayarlayın ve Kaydet'e tıklayın; bu işlem yönetici panelini, müşteri portalını ve tüm PDF'leri aynı anda günceller. Faturalarda yazdırılacak ISO kodu için yanındaki Currency code (USD, EUR, …) alanını ayarlayın.

Gizlilik — anonim kurulum istatistikleri

SAMM güncellemeleri kontrol ettiğinde SecuryTik'e rastgele bir kurulum kimliği, SAMM sürümü, plan seviyeniz ve yaklaşık ülke bilgisini (IP adresiniz üzerinden, Cloudflare aracılığıyla) gönderebilir — hiçbir abone veya müşteri verisi gönderilmez. Bu, yalnızca aktif kurulumları saymamıza, destek ve dilleri önceliklendirmemize yardımcı olur. İstediğiniz zaman System → Settings → Privacy altından kapatabilirsiniz; gizlilik politikasını inceleyin.

E-posta sekmesi

Yöneticilere ve müşterilere gönderilen şifre kurtarma kodları için kullanılan SMTP sunucusunu yapılandırın (host, port, SSL/STARTTLS, kullanıcı adı, gönderen adresi, şifre). Kimlik bilgilerini e-posta göndermeden doğrulamak için Bağlantıyı test et düğmesine tıklayın.

İki e-posta hesabı Buradaki Email sekmesi yalnızca OTP / şifre kurtarma içindir. Müşteri bildirimleri için kullanılan hesap, Bildirim Merkezi'nde ayrı olarak yapılandırılır.

Sistem

Yöneticiler, şubeler & roller

System → Admins, yönetici portalına kimlerin giriş yapabileceğine, her bir kişinin neler yapabileceğine ve hangi kullanıcıları görebileceğine karar verdiğiniz yerdir. 5.1.0 sürümünden itibaren yöneticiler bir şube ve personel ağacı oluşturur. Sayfanın iki sekmesi vardır: Admins ve Roles.

Şubeler ve personel

DüğümNedir
ŞubeBir yer — bir ofis, bir şehir. İçinde oluşturulan kullanıcıların bağlı olduğu üst birimdir. Hiç kimse şube olarak giriş yapmaz: şubenin parolası ve rolü yoktur.
Yönetici (personel)Oturum açan kişi. Bir şube altına atandıklarında, o şubenin personeli olurlar: oluşturdukları her kullanıcı ve kart o şubeye ait olur.
SuperadminHer zaman ağacın en üstünde, asla bir şubenin altında değildir. Her şeyi görür ve her şeyi yapabilir.

Ağacı oluşturmak için + Branch ve + Admin seçeneklerini kullanın ve bir düğümü taşımak için başka bir düğümün üzerine sürükleyin. Yalnızca bir şubenin altında yöneticiler bulunabilir. Ajan, satış yapan ve sattıklarının sahibi olan bir yöneticidir; bir ajanın altına yerleştirilen personel, ajanın cüzdanını ve onay kurallarını kullanır.

Kimin neyi gördüğü

Görünürlük ağaç yapısını takip eder. Bir şube — ve orada çalışan herkes — kendi kullanıcılarını ve altındaki şubelerin kullanıcılarını görür. Kardeş bir şubeyi veya üst şubeyi asla görmez. HQ her şeyi görür. Bir yöneticinin izinleri, üstündeki yöneticilerin izin verdiğinden daha fazla olamaz ve bir yönetici yalnızca kendisinin sahip olduğu izinleri verebilir.

Şube başına limitler

SınırlaNeleri saydığı
Maksimum kullanıcı sayısıŞubenin ve altındaki şubelerin kaç kullanıcı barındırabileceği. Bir kullanıcıyı silmek yer açar.
Maksimum kart sayısıŞubede kaç adet hotspot kartı yazdırılabilir?

Yeni bir kullanıcı veya kart, onu oluşturan yönetici veya üst seviyedeki herhangi bir limite ulaşıldığında reddedilir ve mesajda hangi limitin aşıldığı ve ne kadar kaldığı belirtilir. Limit uygulamamak için alanı boş bırakın. Her ikisi de daha sonra Düzenle iletişim kutusundan değiştirilebilir.

Şube cihazları

Erişim noktaları da dahil olmak üzere her router, bir şubeye veya Headquarters birimine aittir. Bir şubenin menüsünü açın ve ona ait olan cihazları işaretlemek için Assigned devices seçeneğini seçin; işaretini kaldırdığınız bir cihaz, tüm şubelerin ortak kullandığı Headquarters birimine geri döner. Şube personeli tarafından eklenen bir cihaz (Cihaz Yöneticisi, izleme formu veya bir VPN kurulum bağlantısı üzerinden) kendi şubelerine eklenir; Headquarters tarafından eklenen bir cihaz ise Headquarters bünyesinde başlar.

KimŞube cihazı
Bu şubenin, üst şubelerin ve Genel Merkezin personeliYönet
Alt şubelerinin personeliGörüntüle, salt okunur
Diğer şubelerGörmeyin
Bu şubenin ve alt şubelerinin kullanıcılarıBuradan giriş yapılabilir

Harita, Wireless sayfası, sağlık ve router listeleri aynı kurala tabidir. Giriş kısmı, Settings → Authentication yolundaki Users log in only through their branch's routers ayarıdır: yeni kurulumlar için açıktır; cihazları şubelere atanmış olan güncellenmiş bir kurulumda, kimsenin erişimi kesilmesin diye kapalı olarak başlar — cihazlarınız atandığında bu ayarı açın. General şirketinin kullanıcıları herhangi bir router'ı kullanabilir.

Şube başına uyarı alıcıları

Bir şubenin menüsünde ayrıca Uyarı alıcıları bulunur: her satıra bir tane gelecek şekilde e-posta adresleri, WhatsApp ve SMS numaraları ile Telegram sohbetleri. Bu şubeye (veya altındaki bir şubeye) ait bir cihaz çevrimdışı olduğunda, bir hata oluştuğunda, bir saldırıyı engellediğinde veya yapılandırması eksik olduğunda bu kişilere bilgi verilir. Genel merkez tüm uyarıları almaya devam eder.

Fiyat Listeleri

Financial → Price Lists (yalnızca superadmin), her şube için tüm plan ve eklentilere fiyat belirler. Bir alt şube, kendisine özel fiyat atanmadığı sürece üst şubesinin fiyatlarını kullanır; yeni bir şube ise planın kart fiyatı ile başlar. Yuvarlama seçeneğiyle birlikte birçok fiyatı aynı anda yüzdelik veya sabit bir tutarla değiştirin; Reset All bir şubeyi tekrar üst şubesine döndürür ve liste inceleme için dışa aktarılabilir.

Roller & izinler

Bir rol, alan bazlı erişim sağlar. SAMM, düzenleyebileceğiniz veya silebileceğiniz dört hazır rol — Cihaz Yöneticisi (günlük operasyonlar), Reseller, Accountant (finansallar) ve Monitor (salt okunur) — ve iki kilitli yerleşik rol sunar: superadmin (tam erişim) ve yöneticiyi ön ödemeli bakiyesi ve komisyon paylaşımı olan bir toptan satıcıya dönüştüren Agent (bkz. Accounting & billing → Agents).

SAMM'in her alanı için (kullanıcılar, planlar, routerlar, muhasebe, ayarlar ve benzerleri) bir rol, üç seviyeden birine ayarlanır:

SeviyeAnlam
İzin verilmiyorAlan, yan menüden tamamen gizlenir
GörüntüleSalt okunur erişim
DüzenleTam erişim — oluştur, değiştir, sil

Yöneticiler & roller, Araçlar, API ve Ödemeler, rol tanımlamaları ne olursa olsun HQ bünyesinde kalır.

Alan seviyelerinin yanında iki hak bulunur, çünkü bunların her biri bir ekran tercihinden ziyade mali bir karardır:

SağNeleri sağlar
"Fatura Yok" seçeneğine izin ver Bir kullanıcının servisini — yenileme, plan değiştirme, süre uzatma — değiştirin ve bunun için ücret almayın. Her yeni rolde varsayılan olarak kapalıdır.
Ajan Onayına İzin Ver Temsilcilerin ücret iadesi taleplerini inceleyin ve karar verin. Temsilci oluşturma ve yönetimi yalnızca superadmin yetkisindedir. Geri alma & onaylar bölümüne bakın.

Ayrıntılı izinler

Edit altındaki Users, Cards, Financial ve Routers bölümleri ayrı ayrı yetkileri açar — örneğin kullanıcıları silme, yenileme, plan değiştirme, faturaları ödeme, indirim tanımlama, router betikleri çalıştırma. Bir rol için bunlardan herhangi birini kapatın; rolün sahip olmadığı yetkilere ait butonlar gizlenir.

Bir rolün verebileceği süre

Personelin aylarca servis tanımlamasını engelleyin. Her rolde:

AyarEtki
En fazla ileri dönemSüre sonu; oluşturma, yenileme, gün ekleme, düzenleme ve toplu değişikliklerde, şu andan itibaren en fazla bu kadar plan dönemi sonrası olabilir.
En fazla ileri günAynısı, gün cinsinden.
Yeni kullanıcılar için başlangıç süresi (saat)Bu rol ile oluşturulan bir kullanıcı tam olarak bu kadar süreye (örneğin 2 saat) sahip olur ve fatura oluşturulmaz; daha fazla süre verme yetkisi olan bir kullanıcı bunu daha sonra uzatır.

Gün ekle ve Bir son kullanma tarihi yaz, Kullanıcılar altında ayrı yetkilerdir; böylece bir rol, herhangi bir tarih giremese bile yenileme işlemi yapabilir. Sınır olmaması için bir alanı boş bırakın; superadmin hiçbir zaman sınırlandırılmaz. Toplu değişiklik işlemi, limiti aşacak kullanıcıları atlar ve nedenini belirtir.

Bir role, ağaç yapısından bağımsız olarak, kurulumdaki her kullanıcının & kartını görmesine de izin verilebilir. Bu seçenek kapalıyken, rol yalnızca kendi şubesini ve altındaki şubeleri görür.

Gösterge paneli hiçbir zaman kaldırılmaz Bir role başka ne yasaklanırsa yasaklansın, her yönetici kendi gösterge paneline ve profiline sahip olur — yetki hatasıyla sonuçlanan bir giriş, güvenli bir giriş değil, hatalı bir giriştir.
Lisansa her zaman erişilebilir System → License sayfası normal bir yetki bloğudur — ancak cihaz ne zaman kilitlenme durumunda (grace, soft veya hard) olsa, SAMM rolüne bakılmaksızın oturum açmış her yönetici için burayı erişilebilir kılar; böylece kurtarma yolu hiçbir zaman engellenmez.

Sistem

Araçlar

Tools bölümü, toplu işlem ve bakım araçlarını bir araya getirir. Tüm veri kümesi üzerinde işlem yaptığı için yalnızca süper yöneticilerin erişimine açıktır.

Yedekle & Geri Yükle

Herhangi bir büyük değişiklikten önce tam bir veritabanı anlık görüntüsü oluşturun. Yedekleme, sunucuda saklanan ve her biri SAMM başlığına sahip gzipped bir pg_dump arşividir.

  • Yedek oluştur — isteğe bağlı olarak bir not ekleyin; hantal günlük tablolarını hariç tutan, daha küçük ve daha hızlı bir döküm için Kullanım & geçmişi atla seçeneğini işaretleyin.
  • PC'nize bir yedek indirin veya önceki bir SAMM yedeğini sunucuya yükleyin.
  • Restore mevcut veritabanının üzerine yazar — bu işlem type-RESTORE-to-confirm onay penceresi ile doğrulanır.

Yüksek kullanılabilirlik

Tek bir hata noktası bulunmayan bir kurulum için SAMM'ı iki düğüm üzerinde çalıştırın: PostgreSQL streaming replication (bir birincil düğüm ile saniyelerle geriden gelen sıcak yedek) artı bir yedek AAA düğümü; hata durumunda terfi ettirin ve yeniden yönlendirin. Operatör kılavuzunun tamamı — replikasyon kurulumu, planlı ve plansız yük devri, geri dönüş, isteğe bağlı senkron replikasyon modu ve yük devri sonrası doğrulama kontrol listesi — kaynakla birlikte docs/HA.md dokümantasyonu olarak sunulur. Replikasyonun bir yedekleme olmadığını (hatalı bir silme işlemi anında replike edilir), bu nedenle yukarıdaki zamanlanmış yedeklemeleri de çalıştırmaya devam etmeniz gerektiğini unutmayın.

Geçmiş Temizleyici

Veritabanı alanını geri kazanmak için eski günlük ve geçmiş satırlarını kalıcı olarak silin. Bir saklama ön ayarı seçin ve onaylayın. Temizleyici; kapatılmış RADIUS oturumlarını, kimlik doğrulama sonrası kayıtlarını, günlük kullanım özetlerini, router/arayüz geçmişini, sınırlama günlüklerini, uygulanan denetim girişlerini ve tamamlanmış CoA satırlarını temizler. Canlı oturumlara, kuyruğa alınmış komutlara, bekleyen CoA kayıtlarına veya sıfırlanamayan toplam ömür boyu kullanım miktarlarına asla dokunmaz.

Önce yedek alın Geçmiş Temizleyici verileri kalıcı olarak siler. Verilere daha sonra ihtiyaç duyabileceğiniz ihtimaline karşı, temizleme işleminden önce yedekleme yapın.

Dışa Aktar / İçe Aktar

Kullanıcılar, Planlar ve NAS için .csv veya .xlsx formatında toplu dışa aktarma ve içe aktarma. Bir şablonu (doğru sütunlar ve örnek bir satır) veya mevcut verilerin anlık görüntüsünü indirin, doldurun ve geri yükleyin. Her satır doğrulanır ve bir önizleme ekranında gösterilir; herhangi bir veri yazılmadan önce yinelenen ve geçersiz satırlar belirlenir, ardından yinelenenleri atlamayı veya mevcut olanları güncellemeyi seçersiniz.

Toplu Değişiklikler

Tek bir işlemle; sahip, sona erme tarihi, durum, otomatik yenileme veya tüm plan süreleri gibi tek bir değişikliği, bir filtreyle eşleşen tüm abonelere uygulayın. Değişikliği seçin, filtreyi (durum / plan / sahip / arama) oluşturun, eşleşen listeyi gözden geçirin ve onaylayın.

Tüm plan sürelerini ekle toplu yenileme seçeneğidir: her abone kendi planından belirtilen sayıda süre kazanır; böylece 7 günlük bir plan periyot başına 7 gün, aylık bir plan ise bir takvim ayı kazanır — listeyi önce plana göre ayırmadan, aynı işlemde gerçekleştirilir. Planının son kullanma süresi olmayan aboneler, tahmin yürütmek yerine atlanır. Sabit bir gün sayısı istediğiniz ve sayaç sıfırlanmasını istemediğiniz durumlar için Gün ekle seçeneği kullanılabilir kalır.

Hız Artırımı

Tüm planların hızını aynı anda belirli bir yüzdeyle artırın veya düşürün — tatil hafta sonlarında iki kat hız veya bir backhaul performans kaybı sırasında acil hız kısıtlaması uygulayın. Değişiklikler; yeni girişler ve halihazırda çevrimiçi olan oturumlar için anında yürürlüğe girer.

KontrolNe işe yarar
YüzdePozitif değerler çarpar, negatif değerler böler: +100% → iki kat hız, −100% → yarı hız, −500% → hızın altıda biri. Hız asla sıfıra ulaşmaz.
Yükseltilecek planlarİstediğiniz sayıda plan seçin; her satır plan ücretini, aktif hız artışını ve şu anki geçerli hızı gösterir.
Şu süreden sonra otomatik olarak geri alBoost'un kendiliğinden sona ermesine kalan saatler. 0, siz manuel olarak sıfırlayana kadar aktif kalmasını sağlar.
Boost, hız penceresinden önceliklidir Artış, plan hızı üzerinden ölçülür ve aktif olduğu sürece mevcut tüm hız pencerelerinin yerini alır — 20M gece penceresine sahip bir plan 40M olmaz, artışın plan hızını getirdiği değere dönüşür. Artış sona erdiği anda Windows devam eder.

Limitini doldurmuş bir abone, boost ile asla tekrar tam hıza yükseltilmez. Aynı nedenle, kısıtlama hedefi olarak kullanılan bir plan, Tümünü seç tarafından atlanır ve bu şekilde etiketlenir; çünkü bu planı boost etmek, tam olarak kısıtladığınız kişilerin hızını artıracaktır. Eğer niyetiniz buysa, planı hâlâ manuel olarak işaretleyebilirsiniz. Her şeyi normale döndür seçeneği tüm boost'ları kaldırır ve aktif oturumları tekrar plan hızlarına döndürür.

Toplu Sil

Filtre ile seçilen birçok aboneyi veya hotspot kartını aynı anda kalıcı olarak silin. Bir aboneyi silmek; kullanım geçmişini, oturumlarını, RADIUS muhasebe kayıtlarını ve faturalarını da kaldırır ve tüm aktif oturumları sonlandırır. İşlem, onay için DELETE tipinde bir onay penceresi ile korunmaktadır.

Sistem

Diller & temalar

Diller

Yönetici ve müşteri portalları tamamen çevrilebilirdir. Sekiz dil yerleşik olarak sunulmaktadır: English, Arabic (sağdan sola), Russian, Persian (sağdan sola), Turkish, French, Spanish ve German. Her kullanıcı dilini üst bardan veya profilinden seçer; seçim hesap bazında hatırlanır.

Bir dili devre dışı bırakın

System → Translations kısmında her dilin bir açma/kapama anahtarı (yalnızca superadmin) bulunur. Kapalı olan bir dil kimse tarafından seçilemez: seçim listelerinde sunulmaz, bu dili seçmiş olan kişiler İngilizce görür ve onlara gönderilen mesajlar İngilizce yazılır. İngilizce her zaman açık kalır. Yeni bir kurulumda tüm diller açık olarak başlar.

Çeviri düzenleyici

Bir superadmin, çevirileri System → Translations üzerinden canlı olarak düzenleyebilir; yeniden başlatma veya dosya düzenleme gerekmez. Düzenleyici ayrıca tamamen yeni diller oluşturabilir ve çeviri çalışma kitaplarını .xlsx olarak içe/dışa aktarabilir, böylece SAMM'ı hizmet verdiğiniz herhangi bir dile yerelleştirebilirsiniz.

Temalar

SAMM, açık ve koyu olmak üzere 16 görsel tema ile birlikte gelir. Her kullanıcı üst bardan bir tema seçer; önizleme anında güncellenir ve hesap bazlı olarak kaydedilir. IT terminolojisi asla çevrilmez, böylece teknik ekranlar her dilde tutarlı kalır.

Sistem

Denetim günlüğü & etkinlik

System → Audit Log tek bir soruyu yanıtlar: ne oldu ve bunu kim yaptı. Bu liste; bir yöneticinin yaptığı tüm değişiklikleri, sistemin otomatik olarak gerçekleştirdiği işlemleri (süre dolumu gibi) ve kullanıcıların portal veya Telegram üzerinden kendi hesaplarında yaptıkları değişiklikleri — plan değişiklikleri, yenilemeler, ödemeler, profil ve şifre düzenlemeleri — kayıt altında tutar.

SütunNeleri gösterir
Ne zamanZaman diliminizdeki saat
KimYönetici, "portalda ali", "Telegram'da ali", bir API token'ı veya Sistem
Ne olduSadece değişen alanların yer aldığı tek bir cümle, eski → yeni — örneğin "Kullanıcı düzenlendi: Bitiş Tarihi: 01 Eki → 15 Eki"
Hedefİşlem yapılan — Kullanıcı · ali, Plan · Gold 20M, Router · Hamra, Yönetici · rami

Kişi ve Dönem ile filtreleyin veya arama kutusuna bir isim yazın. Oturum açmaları ve & dışa aktarmaları göster seçeneğini işaretlemediğiniz sürece oturum açmalar ve dışa aktarmalar gizlenir. Via, İşlem, Kategori, Önem Derecesi ve ID sütun seçicide yer alır. Dışa Aktar veya Yazdır için satırları seçin — dosya, ekrandakiyle aynı sütunlara sahiptir. Bir satırdaki ⓘ düğmesi, tam öncesi ve sonrası tablosunu gösterir.

Kullanıcı zaman çizelgesi

Bir kullanıcıyı açın ve o hesapta gerçekleşen tüm olaylar — oluşturulma, yenilenme, plan değişikliği, askıya alınma, limitlere ulaşma — için Timeline sekmesini seçin; faturalar, ödemeler, cüzdan ve acente ücretleri Tutar sütununda yer alır. Türe, döneme veya yalnızca tutara göre filtreleyin ve CSV veya Excel formatında dışa aktarın. Timeline satırları asla silinmez ve kullanıcı silinse dahi korunur.

Kabul Günlüğü ve Erişim Günlüğü

Overview → Accept Log, router'ların gönderdiği tüm giriş denemelerini ve RADIUS'ın yanıtlarını, en yeni kayıt en üstte olacak şekilde ve her reddedilme nedeni ile birlikte listeler. Bir kullanıcı bağlanamadığında açılması gereken sayfa budur. Tekrarlanan reddetmeler, bir sayaçla birlikte tek bir satırda gösterilir. Overview → Access Log ise RADIUS accounting üzerinden, başlatılan oturumları listeler.

Ayrıca bir komut kuyruğu da bulunur CLI veya API üzerinden kuyruğa alınan sıfırlamalar, plan değişiklikleri ve yenilemeler aynı tabloya yazılır ve samm-radius servisi tarafından bir sonraki döngüde uygulanarak canlı oturum bir CoA ile yenilenir. Yan menüdeki rozet, hâlâ beklemede olanların sayısını gösterir.

Lisanslama

Lisanslama & katmanları

Her SAMM kurulumu cihaz başına lisanslanır — plan o kurulum üzerinde tanımlıdır, böylece her biri kendi katmanında olan birden fazla SAMM sunucusu çalıştırabilirsiniz. Katman, dört sayısal sınır belirler.

KatmanAAA kullanıcılarıHotspot kartlarıNAS / routerlarİzleme
Kayıtsız252513
Ücretsiz1005026
Lite5001,500412
Plus1,0003,000618
Pro2,0006,0001236
Mega5,00015,0002472
Max10,00030,000sınırsızsınırsız
Unlimitedsınırsızsınırsızsınırsızsınırsız

Yeni bir kurulum, minimum seviyede kayıtsız olarak çalışır. Her özellik her planda mevcuttur; planlar yalnızca üst sınırları belirler. Sınır aşıldığında abone, kart veya NAS oluşturulması, yükseltme yapana kadar engellenir; hiçbir veri kaybolmaz.

Monitors, SAMM'nin yalnızca izlediği erişim noktaları ve bağlantılardır. NAS başına üç adet olacak şekilde kendilerine ait bir kotaları vardır; bu nedenle bir erişim noktasını izlemek hiçbir zaman bir router slotu tüketmez.

Etkinleştir & yükselt

  1. System → License yolunu açın.
  2. SecuryTik hesabınızla giriş yaparak etkinleştirin — veya sunucuda şifrenizi yazmadan samm.securytik.com üzerinden onaylayacağınız bir kod gösteren Bu cihazı bağla seçeneğini kullanın. Cihaz Free planında etkinleşir.
  3. Daha üst bir seviyeye geçmek için aynı sayfadan bir plan seçin veya gösterge panelinizden abone olun. Sayfa üzerinden yapılan istekler bir SecuryTik yöneticisi tarafından incelenir ve onaylanır.

Lisans sayfası ayrıca talep üzerine lisansı yeniden kontrol eder ve mevcut kullanımınızı her bir sınırla karşılaştırarak gösterir. Cihaz bağlantısını kes, herhangi bir veriyi silmeden kurulumu kayıt dışı seviyeye geri döndürür.

Ücretli bir lisansın süresi dolarsa

SAMM asla veri silmez. Süresi dolmuş bir lisans kademeli olarak devre dışı kalır:

AşamaNe olur
UyarıHatırlatma banner'ı; her şey çalışmaya devam eder
GraceYeniden etkinleştirme için kısa bir süre; aboneler çevrimiçi kalmaya devam eder
Yumuşak kısıtlamaArka plan servisleri durur; RADIUS yaklaşık 7 gün boyunca kimlik doğrulamaya devam eder
Tam kilitlemeYeniden etkinleştirme sayfası dışındaki servisler durur

Herhangi bir aşamada yeniden etkinleştirme, tüm servisleri otomatik olarak yeniden başlatır — tüm abone verileri ve geçmişi korunur.

Otomatik güncellemeler

Otomatik güncelleme lisanslamadan bağımsızdır — her seviye güncellenir ve süresi dolmuş bir lisans bunu asla engellemez. SAMM, her gün yeni imzalı bir sürüm olup olmadığını kontrol eder. System → License üzerinden notify (varsayılan — Şimdi Uygula butonuna sahip bir banner) ve auto (insansız uygula) arasında geçiş yapabilirsiniz. Her güncelleme doğrulanır, yedeklenir ve yerinde uygulanır. Ayrıca yükleyiciyi istediğiniz zaman yeniden çalıştırabilirsiniz — yükseltme işlemini idempotent olarak gerçekleştirir.

Aboneleriniz için

Müşteri portalı & bot

SAMM, her aboneye — bir web portalı ve bir Telegram botu olmak üzere — iki self-servis arayüzü sunar; böylece aboneler sizinle iletişime geçmeden kullanımlarını kontrol edebilir ve ödeme yapabilirler.

Müşteri portalı

Aboneler, SAMM kullanıcı adı ve şifreleri ile SAMM lokasyon kök dizininde (/) oturum açarlar. Portal şunları içerir:

SayfaAbonenin gördükleri
Genel BakışHesap durumu, plan, sona erme tarihi, bugünkü ve bu ayki kullanım, ödenmemiş faturalar
Kullanım & oturumlarToplam indirilen/yüklenen veri, çalışma süresi bütçesi ve tam oturum geçmişi
PlanlarımMevcut plan ve mevcut planlar kataloğu
FaturalarımTek tıkla PDF indirme özellikli faturalandırma geçmişi
Destek talepleriDestek taleplerini açın ve takip edin
Profilİletişim bilgilerini düzenle, şifreyi değiştir, dil & temasını ayarla, bildirimleri yönet

Profile sekmesinden bir abone Telegram hesabını bağlayabilir, tercih ettiği bildirim kanallarını düzenleyebilir veya bildirimleri tamamen kapatabilir. Şifresini unutursa, kendisine e-posta ile bir OTP kodu gönderilir (bunun için Email sekmesinin yapılandırılmış olması gerekir).

Telegram botu

samm-telegram servisi etkileşimli bir self-servis botu çalıştırır. Bir abone /start komutu gönderir, SAMM kullanıcı adı ve şifresiyle bir kez doğrulama yapar (bot şifre mesajını anında siler) ve ardından tüm işlemleri tamamen sohbet üzerinden gerçekleştirebilir:

  • Planlarını, kotalarını, kullanımlarını ve son geçerlilik tarihlerini kontrol edin
  • Faturaları görüntüleyin ve PDF olarak indirin
  • Profillerini güncelleyin ve şifrelerini değiştirin
  • Destek taleplerini açın ve takip edin

Bot ayrıca Telegram bağlantısı kuran abonelere otomatik bildirimler — yenileme hatırlatıcıları, süre dolum bildirimleri, kota uyarıları ve makbuzlar — iletir.

Süresi dolmuş abone karşılama sayfası

Bir abonelik sona erdiğinde, router (sihirbazın "Expired pool & internet block" ayarıyla yapılandırılmış olan), bağlantının sessizce kopması yerine, kullanıcının tarayıcısını SAMM tarafından port 81 üzerinden sunulan, ISP logonuzun ve portala giriş butonunun bulunduğu kullanıcı dostu bir "subscription expired" sayfasına yönlendirir.

Sistem

REST API

System → API, genel /api/v1 arayüzünü yönetir. API, ilk token'ı oluşturana kadar pasif durumdadır, bu nedenle hiç kullanılmayan bir kurulum herhangi bir risk oluşturmaz. Aşağıdaki tüm bilgiler; dene-ve-gör konsolu ve tam istek/yanıt şemalarıyla birlikte, kendi kurulumunuzdaki /api/v1/docs adresinde etkileşimli OpenAPI dokümantasyonu olarak da mevcuttur.

İnteraktif dokümantasyon (Swagger UI)

Her kurulum /api/v1/docs adresinde canlı bir API konsolu sunar — bu konsola yönetici portalındaki API panelinden doğrudan erişilebilir. Authorize düğmesine tıklayın, bir token yapıştırın ve Try it out ile herhangi bir uç noktayı kendi verilerinizle çalıştırın; her çağrı gerçek yanıtı ve kopyalamaya hazır bir curl komutunu gösterir.

Her uç nokta —hem istek gövdeleri hem de yanıtlar için— eksiksiz ve tiplendirilmiş bir şema beyan eder; böylece alan adları, tipler ve örnekler herhangi bir çağrı yapmaya gerek kalmadan görülebilir. Aynı şema, /api/v1/openapi.json adresinde makine tarafından okunabilir OpenAPI formatında sunulur ve seçtiğiniz dilde tamamen tiplendirilmiş bir istemci oluşturur:

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

samm-openapi.json · SAMM 6.0.0 · 187 uç noktalar

Hızlı başlangıç

  1. System → API (yalnızca superadmin) yolunu açın, New token düğmesine basın, bir isim ve son kullanma tarihi belirleyin ve yalnızca entegrasyonun ihtiyaç duyduğu izinleri (her alan için bir satır olacak şekilde Read veya Write) etkinleştirin.
  2. Sırrı hemen kopyalayın — yalnızca bir kez gösterilir ve sunucuda sadece hash değeri saklanır.
  3. Çalıştığını doğrulayın ve token'ın neler yapabildiğini görün:
curl -H "Authorization: Bearer samm_YOUR_TOKEN" https://YOUR-SAMM/api/v1/me

Aktif aboneleri listeleyin, ardından yeni bir abone oluşturun:

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

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

Kimlik doğrulama, token'lar ve kapsamlar

Her istek Authorization: Bearer <token> başlığı gönderir. Bir token; bir isim, dakika başına hız sınırı, bir son kullanma tarihi (30–360 gün veya süresiz) ve bir dizi kapsam (kaynak başına okuma/yazma yetkileri) içerir; write kapsamı, ilgili read kapsamını otomatik olarak kapsar. Gizli anahtar yalnızca bir kez gösterilir; sunucu yalnızca hash değerini saklar. Bir token iptal edilebilir (çağrılar anında başarısız olur, işlem geri alınabilir) veya tamamen silinebilir.

Yanıtlar belirli bir standart dizisini takip eder: liste uç noktaları limit/offset alır ve {"total", "items"} döndürür; hatalar standart durum kodlarını kullanır — eksik/geçersiz/süresi dolmuş token için 401, eksik kapsam için 403, bulunamadı için 404, yinelenen kayıt için 409, doğrulama hatası için 422 ve hız sınırına isabet edildiğinde 429 (Retry-After ve X-RateLimit-* başlıkları ile).

Ödeme, cüzdan ve webhook verilerindeki tutarlar "12.50" gibi ondalık bir dizedir; zamanlar ise kurulumun ofsetiyle birlikte ISO 8601 formatındadır.

Uç nokta referansı

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

Faturalar, ödemeler, indirimler ve cüzdan

Her para işlemi, tıpkı panelde olduğu gibi, SAMM'ın çift kayıtlı defterleri üzerinden geçer. Bir faturanın borcu total − paid − discount şeklindedir; durumu unpaid/due aşamasından partial ve paid aşamasına (veya yalnızca indirimlerle kapatıldıysa discounted aşamasına) geçer.

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

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

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

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

POST /invoices/{id}/unpay ödenmiş bir faturayı yeniden açar ve DELETE /invoices/{id} bir faturayı doğru şekilde kapatır (kısmen ödenmiş kalan tutar silinir). Kayıtlar GET /accounting/export/{kind} üzerinden JSON veya CSV olarak dışa aktarılır.

Ödeme uygulamaları

Para transferi uygulamaları ve mağaza temsilcileri (Wish Money, Sham Cash…) kendi kapsamlarına, collect:read ve collect:write ile üç çağrıya sahiptir: kullanıcı adıyla kullanıcı sorgulama (maskelenmiş isim, borç tutarı, açık faturalar), ödeme kaydetme ve ödemeyi geri okuma. Bir ödeme, referansına göre idempotent'tır: aynı ödemeyi tekrar göndermek ilk yanıtı döndürür ve yeni bir kayıt oluşturmaz.

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

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

Kuyruğa alınan komutlar

Canlı muhasebe durumunu etkileyen mutasyonlar — sınır sıfırlamaları, kart ve grup etkinleştirme/devre dışı bırakma, geçerlilik uzamaları — istek içinde uygulanmaz. Bu mutasyonlar denetlenen komut kuyruğuna eklenir ve samm-radius tarafından bir tıklamada (birkaç saniye içinde) işlenir, yönetici portalına aynı tıklamaları yapmanız gibi. Bu uç noktalar {"queued": true} yanıt verir; GET /commands sorgulayarak token'ınızın kuyruğundaki komutların applied'e dönüşünü görebilirsiniz.

Webhooks

System → API → Webhooks yolundan veya POST /webhooks ile bir uç nokta URL'si kaydedin ve olayları seçin: tekil olaylar, invoice.* gibi tüm bir grup (bu grubun sonraki olayları da dahildir) veya tüm olaylar için *. İmzalama sırrı, uç noktanın sayfasında görüntülenir ve yenilenebilir.

Her teslimat id, type, api_version, created_at ve data içeren bir JSON'dur. id değeri her uç nokta ve her yeniden deneme için aynıdır: her kimliği yalnızca bir kez işleyin. 10 saniye içinde 2xx yanıtı dönün; diğer tüm durumlar yaklaşık iki saat boyunca üstel bekleme süreli (backoff) yeniden denemeye tabi tutulur ve hata vermeye devam eden bir uç nokta otomatik olarak devre dışı bırakılır. Her teslimat, sunucunuzun döndürdüğü HTTP koduyla günlüğe kaydedilir ve yeniden gönderilebilir.

X-SAMM-Signature-256: t=<unix>,v1=<hex>’yı doğrulayın, t.body’nin HMAC-SHA256’sı önce güvenli bir teslimat için.

import hmac, hashlib, time

def verify(raw: bytes, header: str, secret: bytes) -> bool:
    p = dict(x.split("=", 1) for x in header.split(","))
    if abs(time.time() - int(p["t"])) > 300:      # replay window
        return False
    mac = hmac.new(secret, p["t"].encode() + b"." + raw,
                   hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, p["v1"])
OlayNe zaman
customer.createdA user account was created
customer.updatedA user account was updated
customer.renewedA plan was renewed (expiration extended)
customer.plan_changedA user moved to another plan
customer.expiredA user expired (expiration sweep)
customer.suspendedA user was suspended (by an admin or for not paying)
customer.restoredA suspended user was restored
customer.deletedA user account was deleted
limit.exhaustedA usage limit was exhausted (quota / daily / uptime / expiration)
invoice.createdAn invoice was created
invoice.updatedWhat an invoice owes changed (payment, discount, reversal, write-off)
invoice.paidAn invoice was marked paid
invoice.deletedAn invoice was deleted
payment.receivedA payment was received and posted (online, payment app)
payment.reversedA payment was voided or an invoice reopened
wallet.topupMoney was added to a user's prepaid wallet
addon.addedAn add-on was given to or bought by a user
session.startedA user session started (off unless enabled in settings)
session.stoppedA user session stopped (off unless enabled in settings)
alert.openedAn alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolvedAn alert cleared on its own or was resolved
webhook.testManual test event (sent from the test button)
Portal ile aynı kurallar API mutasyonları, yönetici portalı ile aynı denetlenmiş komut kuyruğu ve servis katmanından geçer — API üzerinden yapılan bir sıfırlama veya plan değişikliği, CoA dahil her şeyiyle UI üzerinden yapılanla tamamen aynı şekilde çalışır.
SAMM bağlantısı kilitli Router-kontrol belirteçleri, SAMM ile router'ın kendisi arasındaki bağlantıya — giriş bilgilerine, API servisine, RADIUS ayarlarına, SAMM'in kendi güvenlik kurallarına veya SAMM'in ona ulaştığı adrese — müdahale edemez. SAMM, her değişiklikten sonra hâlâ giriş yapabildiğini kontrol eder ve her değişiklik veya betik çalıştırılması Yönetici Günlüğü'nde tutulur.

Referans

SAMM Kullanımı

Hemen hemen her şey yönetici portalından yapılır. Bu sayfa, nadiren ihtiyaç duyduğunuz durumlar için shell referansıdır.

Servis yönetimi

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

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

# Validate the FreeRADIUS config after any change
freeradius -CX

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

Yönetici CLI

Kabuktan hızlı abone işlemleri için. Her komut denetim için kuyruğa alınır günlüğe kaydedilir ve sonraki samm-radius onay işaretinde uygulanır; tıpkı kullanıcı arayüzü işlemleri gibi.

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

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

Yapılandırma dosyaları

DosyaBekletmeler
/etc/samm/samm.yamlVeritabanı DSN, bağlantı havuzu boyutları, günlük düzeyi
/etc/samm/api.envPortal oturum sırları ve şifre kurtarma SMTP ayarları
/etc/samm/secret.keyKaydedilen router API şifreleri için şifreleme anahtarı

Bu dosyalar güncellemeler sırasında korunur ve yükleyicinin yeniden çalıştırılmasıyla asla üzerine yazılmaz. Çalışma zamanı ayarları (döngü sıklıkları, günlük sıfırlama zamanı, CoA portları) bunun yerine Ayarlar kısmında yer alır ve yeniden başlatma gerektirmeden uygulanır.

SAMM Güncelleme

SAMM'nin System → License üzerinden kendisini güncellemesine izin verin veya yükleyiciyi yeniden çalıştırın — bkz. Installation → Upgrading. Her iki yol da migrasyonları yeniden uygular ve servisleri yeniden başlatır; yapılandırmanız ve verileriniz korunur.

& yedekleme ve kurtarma

Herhangi bir büyük değişiklikten önce tam bir veritabanı anlık görüntüsü almak için Tools → Backup & Restore menüsünü kullanın. Yeni bir sunucuda yeniden kurulum yapmak için SAMM yükleyin ve ardından yedeği geri yükleyin.

Bakım araçları (harici)

Bazı bakım işlemleri, yanlışlıkla yapılan bir tıklamanın aktif bir işletmeye zarar verebileceği yönetici panelinde yer almayacak kadar risklidir. SAMM bunları bir buton olarak değil, shell üzerinden bilinçli olarak indirip çalıştırdığınız, yalnızca root yetkisiyle çalışan bağımsız betikler olarak tutar. Bu betikler, genel dağıtım deposunda tools/ altında yer alır.

Kilitlenmiş bir yönetici parolasını sıfırlama

Yönetici paneline erişemiyor musunuz? Çalışan bir giriş bilgisine ihtiyaç duymadan, doğrudan veritabanı üzerinden bir superadmin hesabı için yeni bir şifre belirleyin. Bu işlem, hesap devre dışı bırakılmışsa onu yeniden etkinleştirir ve başka hiçbir şeye dokunmaz.

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

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

SAMM sunucusunda root olarak çalıştırın. Birden fazla süper yönetici varsa, birini seçmek için --user <name> parametresini kullanın.

Kayıtları sıfırla (finansal verileri sil)

Tüm abone ve AAA verilerini tamamen korurken, bir ISP'nin muhasebesine sıfırdan başlayabilmesi için tüm finansal işlemleri temizler. Bir kurulumu devralırken veya deneme/test süreci sonrasında, kayıtların operatörün silmek istediği verilerle dolu olduğu ancak müşteri tabanının olduğu gibi kalması gereken durumlar için kullanışlıdır.

Tehlike — geri döndürülemez veri kaybı Bu işlem tüm faturaları, ödemeleri, makbuzları, cüzdan bakiyelerini ve defter geçmişini kalıcı olarak siler. Bu işlemin geri dönüşü yoktur. Geri dönmenin tek yolu veritabanı yedeğidir. Önce yedeklemediğiniz ve doğrulamadığınız bir canlı sistemde bu işlemi asla çalıştırmayın.

Kaldırıldı: faturalar ve kalemleri, çift kayıtlı defter (ödemeler, tahsilatlar, düzeltmeler, cüzdan yüklemeleri ve çekimler), çevrimiçi ödeme işlemleri, giderler, sabit varlıklar ve muhasebe işlem günlüğü. Fatura numaralandırması sıfırlanır, böylece bir sonraki fatura #1'den başlar.

Saklanan: her abone, plan, hız penceresi, limit, kullanım sayacı, plan geçmişi, hotspot kartı, router, oturum ve RADIUS muhasebe kaydı — ayrıca muhasebe yapılandırmanız (hesap planı, kasa hesapları, vergi grupları, ödeme ağ geçitleri). Nakit, cüzdan ve alacak bakiyeleri defterden türetilir, bu nedenle sonrasında sadece sıfır olarak görünürler.

İndirin, okuyun ve ardından çalıştırın. Her zaman önce bir deneme çalıştırması yapın:

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

sudo bash samm-wipe-financials.sh --dry-run   # show what would be deleted, change nothing
sudo bash samm-wipe-financials.sh             # do it
Doğrudan bir shell'e yönlendirmeyin Bunu asla curl … | sudo bash şeklinde çalıştırmayın. Verileri silen bir betiği önce okumak istersiniz; yarım kalmış bir indirme işleminin, silme işlemini kısmen gerçekleştirmesine izin verilmemelidir. Önce indirin, inceleyin ve ardından çalıştırın.

Betik, root olmayan bir kullanıcı ile çalışmayı reddeder, tam olarak neleri sileceğini yazdırır, ardından doğrulanmış bir yedeğiniz olduğunu onaylamak için YES ve devam etmek için WIPE yazmanızı ister. Önce kendi veritabanı dökümünü almayı (/var/backups/samm/ yoluna) teklif eder ve bu döküm başarısız olursa işlemi iptal eder. Silme işlemi tek bir "ya hep ya hiç" işlemi (transaction) olarak yürütülür ve RADIUS kasıtlı olarak bu süre boyunca çalışmaya devam eder, böylece kayıtlar giderilirken aboneler çevrimiçi kalır.

Referans

SSS & sorun giderme

SAMM hangi işletim sistemlerini destekliyor?

Ubuntu 22.04 / 24.04 / 26.04 LTS ve Debian 12 / 13. Yalnızca sunucu sınıfı Linux — masaüstü sürümleri desteklenmez. Yükleyici; systemd, temiz bir PostgreSQL kurulumu (sizin için bir tane yapılandırılır) ve root erişimi gerektirir.

SAMM çalıştırmak için internet bağlantısına ihtiyacım var mı?

Hayır. SAMM tamamen kendi sunucunuzda çalışır ve abonelerin kimlik doğrulamasını RADIUS üzerinden yerel olarak gerçekleştirir. Tek dışa giden trafik, planınızın geçerliliğini koruması için SecuryTik lisans sunucusuna gönderilen periyodik lisans heartbeat sinyalidir.

SAMM'i bulutta çalıştırabilir miyim, yoksa yerleşik (on-prem) mi olması gerekiyor?

Her iki yöntem de çalışır. Çoğu operatör, sistemlerini ana router'larının yanında yerel (on-prem) olarak çalıştırır; bazıları ise geri dönüş için Cloudflare Zero Trust tüneli kullanan küçük bir bulut VM üzerinde çalıştırır. Tek gereksinim, MikroTik router'larının RADIUS portları (1812/1813 UDP) üzerinden SAMM sunucusuna erişebilmesi ve SAMM'ın MikroTik API üzerinden router'lara erişebilmesidir.

Bir router eklediğimde veya kaldırdığımda FreeRADIUS'ı yeniden başlatmam gerekiyor mu?

Hayır. SAMM, NAS istemcilerini veritabanından dinamik olarak çözümlediği için MikroTik → NAS yolunda bir router eklemek, düzenlemek veya kaldırmak herhangi bir yeniden başlatma gerektirmeden etkili olur.

Bir plan değişikliği veya sayaç sıfırlaması ne kadar sürede etkili olur?

Yönetici işlemleri sıraya alınır ve samm-radius servisi tarafından bir sonraki döngüde — varsayılan olarak 30 saniye içinde — uygulanır. Abone çevrimiçiyse, SAMM oturumu yenilemek için canlı bir CoA da gönderir. Daha hassas zamanlama için System → Settings yolundan samm-radius aralığını düşürün.

Ücretli bir lisansın süresi dolduğunda verilerime ne olur?

Hiçbir veri silinmez. Süresi dolan bir lisans sırasıyla uyarı, ek süre, hafif kısıtlama (RADIUS yaklaşık bir hafta boyunca kimlik doğrulamaya devam eder) ve son olarak tam kısıtlama aşamalarına geçer. Herhangi bir aşamada yeniden etkinleştirme işlemi, tüm veriler korunarak her servisi yeniden başlatır.

SAMM ücretsiz mi? Pro sürümü neler sunar?

Free plan sonsuza kadar ücretsizdir ve tüm özellikleri içerir. Ücretli planlar yeni özellikler açmaz; AAA kullanıcıları ve hotspot kartları için limitleri artırır ve router sınırını kaldırır. Lisanslama & katmanları adresine bakın.

Bir abone kimlik doğrulaması yapamıyor — nereden başlamalıyım?

Router'ın RADIUS shared secret değerinin NAS kaydıyla birebir eşleştiğini, router'ın PPP / Hotspot RADIUS için etkinleştirildiğini ve abone hesabının Aktif olduğunu ve süresinin dolmadığını kontrol edin. journalctl -u samm-api -f komutunu ve FreeRADIUS günlüğünü izleyerek router'ın UDP 1812/1813 üzerinden SAMM hostuna erişebildiğini doğrulayın.

Daha fazla yardıma mı ihtiyacınız var?

Bir hata bildirmek veya yeni bir özellik talep etmek için samm@securytik.com adresine e-posta gönderin.