Beni Oku (Türkçe) | Readme (English)

My Network Scanner (MyNeS), "Ailenizin Kullanıcı Dostu Ağ Tarayıcısı" mottosu ile geliştirilmiş, yerel ağınızdaki tüm cihazları (Router/Modem, Laptop, Tablet, Desktop, Server, IP Camera, Gaming Console, Smart Home Appliances, .....) tarayıp, tespit ettiği cihazlar ile ilgili detaylı bilgileri kullanıcı dostu ve kolay bir arayüz üzerinden kolaylıkla yönetebilmenizi sağlayan profesyonel bir uygulamadır.

Modern ve kullanıcı dostu web arayüzü ile ağ yönetimini kolaylaştırır. Gelişmiş ve detaylı tarama, AI destekli cihaz tanıma ve güvenlik özellikleri sunar.

Bu uygulama tümüyle AI destekli olarak (Agentic Mode) Claude Code, Github Copilot ve Visual Studio Code kullanılarak Open-Source olarak geliştirilmiştir.

• 🌐 Web-based Interface - Modern, kullanıcı dostu Web tabanlı arayüz
• 🔍 Otomatik Ağ Keşfi: Yerel ağ aralığını otomatik olarak belirler
• 🔬 ARP Taraması: Hızlı cihaz keşfi için ARP protokolü kullanır
• 🔌 Gelişmiş Port Taraması: 1000+ port ile kapsamlı servis tespiti
• 🖥️ Cihaz Tipi Tespiti: Router, bilgisayar, telefon, kamera vb. otomatik tespit
• 🐳 Docker Entegrasyonu: Container ve virtual network tespiti
• 🔐 Multi-Protocol Analiz: SSH, FTP, HTTP, SNMP desteği
• 📝 Cihaz Yönetini: Cihaz bilgilerini elle değiştirebilme, yeni bilgiler ekleyebilme
• 🎛️ Yedekleme ve Aktarım: JSON tabanalı basit ve kolay cihaz bilgilerini yedekleme ve geri yükleme
• 📊 Geçmiş Tarama Analizi: Geçmiş tarama sonuçlarını ve istatistiklerini takip edebilme
• 🌍 Çoklu Dil Desteği - Türkçe ve İngilizce dil desteği

• IP Adresleri: IPv4 adresleri
• MAC Adresleri: Fiziksel ağ adresleri
• Hostname: Cihaz isimleri
• Üretici Bilgisi: IEEE OUI veritabanı ve online API'ler ile gelişmiş vendor tespiti
• Açık Portlar: Aktif servisler ve port numaraları
• Cihaz Tipi: Otomatik cihaz kategorilendirmesi
• Sistem Bilgileri: İşletim sistemi, donanım özellikleri
• Güvenlik Analizi: Zafiyetler ve güvenlik durumu
• Docker Bilgileri: Container durumu ve network mapping

• Multi-Source IEEE Desteği: OUI, MA-M, OUI-36, IAB, CID kayıtlarını destekler
• Otomatik Güncellemeler: IEEE kaynaklarından güncel veritabanı indirme
• Online API Fallback: Bilinmeyen MAC'ler için otomatik online arama
• 37,000+ Üretici Kaydı: Kapsamlı vendor veritabanı
• Akıllı Vendor Temizleme: Organizasyon isimlerini normalize etme

Uygulama aşağıdaki bilgileri kullanarak cihaz tipini otomatik olarak belirler:

• Hostname Analizi: Cihaz isimlerinden pattern tanıma
• Üretici Firma Bilgisi: Vendor tabanlı sınıflandırma
• Açık Port Analizi: Servis tabanlı tespit
• Bilinen Cihaz İmzaları: Makine öğrenmesi ile güven skorları
• Akıllı İsimlendirme: Otomatik alias ve isim üretimi
• Kategori Sınıflandırması: IoT, Sunucu, Router vb. kategoriler

• Şifreli Credential Depolama: Fernet simetrik şifreleme
• Çok Protokol Desteği: SSH, FTP, HTTP, SNMP credential'ları
• Güvenli Dosya İzinleri: Gizli dosyalar için kısıtlı erişim
• Hassas Veri Temizleme: Export sırasında otomatik temizleme

• Container Tespiti: Çalışan Docker container'ları bulma
• Network Mapping: Docker network'leri ve IP atamaları
• Virtual Interface: Docker sanal arayüzleri tespiti
• Container Detayları: Metadata ve yapılandırma bilgileri

Bu container imajı amd64 ve arm64 mimarilerinin tümünü destekler.

services:
  my-network-scanner:
    image: fxerkan/my_network_scanner:latest
    container_name: my-network-scanner
    ports:
      - "5883:5883"
    volumes:
      - ./data:/app/data
      - ./config:/app/config
    environment:
      - FLASK_ENV=production
      - LAN_SCANNER_PASSWORD=your-secure-password
    restart: unless-stopped
    cap_add:
      - NET_ADMIN
      - NET_RAW
    privileged: true

# Pull and run the container
docker run -d \
  --name my-network-scanner \
  --privileged \
  --cap-add=NET_ADMIN \
  --cap-add=NET_RAW \
  -p 5883:5883 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/config:/app/config \
  -e LAN_SCANNER_PASSWORD=your-secure-password \
  fxerkan/my_network_scanner:latest

# Access the application
open http://localhost:5883

• Python 3.7+
• Nmap (sistem seviyesinde kurulu olmalı)
• Root/Administrator yetkileri (port taraması için)
• Docker (opsiyonel - container tespiti için)
• SSH/FTP/SNMP araçları (gelişmiş analiz için)

macOS:

brew install nmap

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install nmap

CentOS/RHEL:

sudo yum install nmap

1. Kodu klonla:

git clone https://github.com/fxerkan/my_network_scanner.git
cd my_network_scanner

2. Sanal Ortam oluşturun

3. python -m venv .venv
   
   source .venv/bin/activate

4. Bağımlılıkları yükleyin:

pip install -r requirements.txt

3. Uygulamayı çalıştırın:

python app.py
# or use the startup script
./start.sh

4. Web arayüzü erişimi: http://localhost:5883 adresinden uygulama arayüzüne erişebilirsiniz.

# Standart Ağ taraması başlatmak için (CLI)
python lan_scanner.py

# Ana şifreyi Ortam değişki olarak atamak için
export LAN_SCANNER_PASSWORD="your_master_password"

# Flask uygulama ayarları
export FLASK_SECRET_KEY="your_secret_key"

lan_scanner/
├── app.py                      # Flask web uygulaması
├── lan_scanner.py              # Ana tarama modülü
├── enhanced_device_analyzer.py # Gelişmiş cihaz analizi
├── smart_device_identifier.py  # AI destekli cihaz tanıma
├── unified_device_model.py     # Birleşik veri modeli
├── credential_manager.py       # Güvenli credential yönetimi
├── docker_manager.py           # Docker container tespiti
├── version.py                  # Dinamik versiyon yönetimi
├── data_sanitizer.py           # Güvenli veri temizleme
├── oui_manager.py              # OUI veritabanı yönetimi
├── config.py                   # Yapılandırma yönetimi
├── requirements.txt            # Python bağımlılıkları
├── config/
│   ├── config.json            # Ana yapılandırma
│   ├── device_types.json      # Cihaz tipi tanımları
│   ├── oui_database.json      # OUI veritabanı
│   ├── .salt                  # Şifreleme salt'ı (gizli)
│   └── .key_info              # Anahtar türetme bilgisi (gizli)
├── data/
│   ├── lan_devices.json       # Cihaz verileri (birleşik model)
│   └── scan_history.json      # Tarama geçmişi
├── locales/<language_code>/
│   ├── translations.json        # Dil bazlı çeviri tanımları
│   └── device_types.json        # dillere göre cihaz tipi tanımları
├── templates/
│   └── index.html             # Web arayüzü template
├── static/                    # CSS/JS dosyaları
└── README.md                  # Bu dosya

• Root Yetkileri: Port taraması için yönetici yetkileri gerekebilir
• Güvenlik Duvarı: Bazı güvenlik duvarları taramayı engelleyebilir
• Etik Kullanım: Sadece kendi ağınızı tarayın
• Performans: Büyük ağlarda tarama uzun sürebilir
• Credential Güvenliği: Tüm giriş bilgileri AES-256 ile şifrelenir
• Veri Temizleme: Export sırasında hassas veriler otomatik temizlenir
• Güvenli Erişim: SSH anahtar tabanlı kimlik doğrulama önerilir

sudo python app.py

Nmap'in sistem PATH'inde olduğundan emin olun:

nmap --version

• Güvenlik duvarı ayarlarını kontrol edin
• Yönetici yetkileri ile çalıştırın
• Antivirüs yazılımını geçici olarak devre dışı bırakın

• Port 5883'ün kullanımda olmadığından emin olun
• Güvenlik duvarı kurallarını kontrol edin
• http://127.0.0.1:5883 adresini deneyin

• Çevre değişkeni doğru ayarlandı mı kontrol edin
• Salt dosyalarının (.salt, .key_info) var olduğundan emin olun
• Dosya izinlerini kontrol edin (600 olmalı)

• Docker servisinin çalıştığını kontrol edin: docker info
• Kullanıcının Docker grubunda olduğundan emin olun
• Docker socket'inin erişilebilir olduğunu kontrol edin

• Master password doğru girildiğinden emin olun
• Config dizininin yazılabilir olduğunu kontrol edin
• Encryption key dosyalarını silin ve yeniden oluşturun

• ✅ AI destekli cihaz tanıma sistemi
• ✅ Gelişmiş cihaz analizi (SSH, FTP, HTTP, SNMP)
• ✅ Güvenli credential yönetimi (AES-256 şifreleme)
• ✅ Docker container tespiti ve network mapping
• ✅ Birleşik veri modeli ve tutarlılık
• ✅ Veri temizleme ve güvenlik özellikleri
• ✅ Dinamik versiyon yönetimi
• ✅ 1000+ port ile kapsamlı tarama
• ✅ Güvenlik analizi ve zafiyet tespiti
• ✅ Raspberry Pi özel tespiti

• ✅ İlk sürüm
• ✅ ARP ve port taraması
• ✅ Web arayüzü
• ✅ Cihaz tipı tespiti
• ✅ JSON veri depolama
• ✅ Import/Export özelliği

Bu proje MIT lisansı altında lisanslanmıştır.

• GitHub Repository: https://github.com/fxerkan/my_network_scanner
• Documentation: CLAUDE.md
• Turkish README: README.md

• Claude Code: AI-assisted development
• GitHub Copilot: Code assistance
• IEEE: OUI database
• Nmap: Network scanning engine
• Flask: Web framework
• Python: Libraries and tools

fxerkan tarafında sevgi ve yapay zekas desteği ile geliştirilmiştir - Made with ❤️ & 🤖 by fxerkan

Not: Bu araç sadece eğitim amacıyla ve sadece kendi ağınızdaki cihazlar hakkında bilgi sahibi olmak amacıyla kullanılmalıdır.

Başkalarının ağlarını izinsiz taramak yasalara aykırıdır, My Network Scanner (MyNeS) bu tip kullanımları önermez ve desteklemez.