| 1. 📊 Özet & Canlı Metrikler (Overview) | 2. ⚡ Süreçler & CPU / Disk (Processes) |
|---|---|
![]() |
![]() |
| 3. ⚙️ Servis Yönetimi (Services) | 4. 👥 Kullanıcılar & Yetkiler (Users) |
|---|---|
![]() |
![]() |
| 5. 💻 Uzak Terminal Konsolu (Terminal) | 6. 🌐 Ayarlar & Çoklu Sunucu (Settings) |
|---|---|
![]() |
![]() |
Bu proje, Debian Linux sunucularınızı arka planda çalışan görünmez, ultra hafif bir C++ servisi (linux-server-helper) üzerinden izlemenizi ve Windows cihazınızdaki sistem tepsisinde (System Tray) yer alan modern Fluent flyout/pencere kontrol paneli ile yönetmenizi sağlar.
Hem Linux servisi hem de Windows istemcisi C++ (C++17) ile derlenmiştir, aşırı hafiftir (~3-5 MB RAM Linux, ~340 KB Windows ikili boyutu) ve yerel performans sunar.
-
🌐 Çoklu Sunucu Yönetimi & Hızlı Geçiş:
- Birden fazla Linux sunucusunu (Ad, IP, Port, Token) kaydetme.
- Başlık çubuğundaki (Titlebar) Sunucu Seçim Açılır Menüsü (Dropdown) ile tek tıkla sunucular arasında anında geçiş yapma.
- Ayarlar sekmesinde sunucu ekleme, düzenleme ve silme.
-
🚨 Kritik Anormallik İzleme & Özel Uyarı Penceresi (Dedicated Alert Window):
- Tüm Sunucuları Arka Planda Tarama: Yalnızca aktif sunucuyu değil, kayıtlı tüm sunucuları arka planda periyodik olarak kontrol eder.
- Özel Win32 Bildirim Penceresi: Standart kaybolan bildirimler yerine, ekranın sağ alt köşesinde açılan ve kullanıcı onay vermeden kapanmayan özel bir uyarı penceresi.
- Tek Seferde Toplu Raporlama: Tespit edilen tüm anormallikler (örn: Sunucu 1'de CPU %94, Sunucu 2'de Sıcaklık 82 °C) tek bir raporda toplanarak iletilir.
- 1 Dakika Spam Koruması: Ekranda spam oluşmaması için en fazla 60 saniyede bir bildirim tetiklenir.
- Ayarlanabilir Eşikler: Ayarlar sekmesinden CPU, RAM, Disk doluluğu ve Sıcaklık alarm eşiklerini dilediğiniz gibi belirleme.
-
📊 Süreçler Tablosunda CPU %, RAM ve Disk I/O:
- Canlı İşlemci (CPU %): Her sürecin anlık CPU kullanım yüzdesi ve dinamik renk kodlaması.
- RAM (MB & %): Sürecin harcadığı bellek MB ve toplam sisteme oranı (%) ile mini grafik çubuğu.
- Disk Kullanımı (I/O): Linux
/proc/[pid]/iosayacından sürecin diske yazdığı (Write) ve diskten okuduğu (Read) toplam bayt miktarları. - Gelişmiş Sıralama: Süreçleri CPU %, RAM, Disk I/O, PID veya Ada göre sıralama.
-
🌡️ Anlamlı Donanım Sıcaklıkları:
- Ham sensör kodları (
x86_pkg_temp,BAT0,acpitz,nvme0) yerine:- ⚡ İşlemci (CPU)
- 🔋 Batarya (Pil)
- 💾 NVMe SSD Depolama
- 🖥️ Anakart (ACPI)
- 📡 Kablosuz Ağ (Wi-Fi)
- Özel SVG simgeleri ve otomatik durum rozetleri: İdeal (<45°C), Normal (45-70°C), Yüksek (>70°C).
- Ham sensör kodları (
-
🌐 Çift Dil Desteği (Türkçe & English):
- Sağ üstteki
TR | ENbutonuyla tüm arayüzü tek tıkla İngilizce veya Türkçe'ye çevirme. - Windows sistem tepsisi menüsü (Open / Show, Switch to Window Mode, Exit) ve Uyarı penceresi dahil tam entegrasyon.
- Sağ üstteki
-
Systemd Servis Yönetimi (Services):
- Debian servislerini (
systemctl) anlık listeleme ve durum filtreleme (Tümü, Aktif, Hatalı). - Servisleri Yeniden Başlatma (
restart), Durdurma (stop), Başlatma (start).
- Debian servislerini (
-
Kullanıcılar ve Yetki Yönetimi (Users & Permissions):
- Sistem kullanıcılarını, UID/GID, kabuklarını ve gruplarını görüntüleme.
- Tek tıkla kullanıcıya Sudo (Yönetici) Yetkisi Verme (
usermod -aG sudo) veya Kaldırma (gpasswd -d ... sudo). - Kullanıcı hesabını kilitleme (
lock) veya kilidi açma (unlock). - Kullanıcının varsayılan kabuğunu (shell) değiştirme.
-
Uzak Terminal & Güç Yönetimi:
- Linux sunucusuna anında komut gönderme (
df -h,docker ps,apt updatevb.) ve renkli terminal çıktısı. - Sunucuyu uzaktan güvenle Yeniden Başlatma (
reboot) ve Kapatma (shutdown).
- Linux sunucusuna anında komut gönderme (
-
Genişletilmiş Windows Arayüz Modları:
- Flyout Modu (Varsayılan): Görev çubuğu simgesine basıldığında sağ altta (
680 x 750 px) açılan şık kontrol paneli. - Pencere Modu: Tek tıkla serbestçe taşınabilen ve boyutlandırılabilen bağımsız pencereye (
1050 x 780 px) dönüşebilme.
- Flyout Modu (Varsayılan): Görev çubuğu simgesine basıldığında sağ altta (
linux-server-helper/
├── linux-helper/ # Debian Arka Plan Servisi (C++)
│ ├── src/
│ │ ├── main.cpp # REST API sunucusu, daemon döngüsü
│ │ ├── metrics.hpp # CPU, RAM, Disk, Ağ ve Sıcaklık toplayıcı
│ │ ├── process_manager.hpp # Süreç listeleme (CPU%, RAM%, Disk I/O) ve kill
│ │ ├── service_manager.hpp # Systemd servis kontrolü
│ │ ├── user_manager.hpp # Kullanıcı ve yetki (sudo/shell) yönetimi
│ │ ├── command_executor.hpp # Shell komut çalıştırıcı
│ │ ├── power_manager.hpp # Reboot / Shutdown
│ │ └── config.hpp # Yapılandırma ve Token yöneticisi
│ ├── include/
│ │ ├── httplib.h # Header-only HTTP sunucu
│ │ └── json.hpp # nlohmann/json
│ ├── config.json.example # Örnek konfigürasyon
│ ├── linux-server-helper.service # Systemd unit dosyası
│ ├── Makefile # Derleme ve yükleme talimatları
│ └── install.sh # Tek komutla otomatik Debian kurulumu (UFW port açma dahil)
│
├── windows-client/ # Windows Masaüstü İstemcisi (C++ Win32 & WebView2)
│ ├── bin/
│ │ ├── LinuxServerHelper.exe # Derlenmiş hazır çalıştırılabilir dosya (~340 KB)
│ │ ├── WebView2Loader.dll
│ │ ├── resources/
│ │ └── ui/ # Fluent Dark Arayüz (HTML, CSS, JS, tam i18n)
│ ├── src/
│ │ ├── main.cpp # Win32 Tray, Flyout, Dedicated Alert Window (/utf-8)
│ │ └── ui/ # Arayüz kaynak kodları
│ ├── packages/WebView2/ # Microsoft WebView2 SDK
│ └── build.bat # Tek tıkla Windows C++ derleme scripti (/utf-8)
│
├── test_mock_server.py # Yerel test & geliştirme simülatörü
└── README.md
Debian sunucunuza linux-helper klasörünü kopyalayın ve tek bir komut çalıştırın:
cd linux-helper
sudo bash install.shbuild-essential(g++, make) kurulu değilse otomatik yükler.- C++ kaynak kodlarını
-O3optimizasyonuyla derler. - Binary'yi
/usr/local/bin/linux-server-helperkonumuna yerleştirir. /etc/linux-server-helper/config.jsondosyasına rastgele 32 karakterlik güçlü bir API Token üretir.- Systemd servisini (
linux-server-helper.service) kurupsystemctl enable --nowile arka planda sessizce başlatır. - Eğer Debian'da
ufwgüvenlik duvarı aktifse8765/tcpportunu otomatik açar. - Kurulum bittiğinde ekrana Windows programına girmeniz gereken IP Adresi, Port ve API Token'ı renkli kutucuk içinde yazdırır.
# Servis durumunu kontrol etme:
sudo systemctl status linux-server-helper
# Canlı logları izleme:
sudo journalctl -u linux-server-helper -f
# Servisi yeniden başlatma:
sudo systemctl restart linux-server-helper
# Servisi durdurma:
sudo systemctl stop linux-server-helperwindows-client/bin/LinuxServerHelper.exedosyasını çalıştırın.- Program görev çubuğunda (sağ altta, saat yanında) bir sunucu simgesi olarak yerleşir.
- Simgeye tıkladığınızda kontrol paneli açılır.
- Sol üstteki
+butonuna veya Ayarlar (Settings) sekmesine gidin:- Sunucu Adı: Örn.
Debian Ana Sunucu - IP Adresi: Debian sunucunuzun yerel IP'si (örn.
192.168.1.150). - Port:
8765 - API Token:
install.shçıktısında size verilen gizli anahtar. - Kaydet butonuna basın.
- Sunucu Adı: Örn.
- Birden fazla sunucu eklediğinizde, başlık çubuğundaki açılır listeden dilediğiniz sunucuya anında geçiş yapabilirsiniz.
- Pencerenin sağ üstündeki
TR | ENbutonuna basarak tüm arayüzü, tablo sütunlarını ve bildirimleri saniyeler içinde İngilizce veya Türkçe yapabilirsiniz.
- Sağ üstteki pencere simgesine basarak veya görev çubuğu simgesine sağ tıklayıp "Pencere Moduna Geç" diyerek istediğiniz zaman tam boyutlandırılabilir bağımsız pencereye dönüştürebilirsiniz.
Kendi scriptlerinizden veya cURL'den sunucunuza doğrudan istek atabilirsiniz. X-API-Key: <TOKEN> başlığı gereklidir.
# 1. Ping / Health
curl http://SUNUCU_IP:8765/api/ping
# 2. Canlı Metrikler (CPU, RAM, Disk, Ağ, Sıcaklık)
curl -H "X-API-Key: TOKEN" http://SUNUCU_IP:8765/api/metrics
# 3. Süreçleri Listeleme & Kill
curl -H "X-API-Key: TOKEN" http://SUNUCU_IP:8765/api/processes?limit=150
curl -X POST -H "X-API-Key: TOKEN" -H "Content-Type: application/json" -d '{"pid": 1234, "signal": 15}' http://SUNUCU_IP:8765/api/processes/kill
# 4. Servis Yönetimi
curl -H "X-API-Key: TOKEN" http://SUNUCU_IP:8765/api/services
curl -X POST -H "X-API-Key: TOKEN" -H "Content-Type: application/json" -d '{"service": "nginx.service", "action": "restart"}' http://SUNUCU_IP:8765/api/services/action
# 5. Kullanıcı Yönetimi & Sudo
curl -H "X-API-Key: TOKEN" http://SUNUCU_IP:8765/api/users
curl -X POST -H "X-API-Key: TOKEN" -H "Content-Type: application/json" -d '{"username": "ahmet", "action": "grant_sudo"}' http://SUNUCU_IP:8765/api/users/action
# 6. Uzak Komut Konsolu
curl -X POST -H "X-API-Key: TOKEN" -H "Content-Type: application/json" -d '{"command": "uname -a && uptime"}' http://SUNUCU_IP:8765/api/exec
# 7. Güç Yönetimi
curl -X POST -H "X-API-Key: TOKEN" http://SUNUCU_IP:8765/api/power/reboot
curl -X POST -H "X-API-Key: TOKEN" http://SUNUCU_IP:8765/api/power/shutdownThis project allows you to monitor and manage Debian Linux servers via an invisible, ultra-lightweight C++ background daemon (linux-server-helper) paired with a modern Windows 11 Fluent Taskbar Flyout / Resizable Window desktop client.
Both the Linux daemon and Windows client are compiled with C++ (C++17), offering near-zero overhead (~3-5 MB RAM on Linux, ~340 KB executable size on Windows) and high native performance.
-
🌐 Multi-Server Management & Quick Switching:
- Register and manage multiple Linux servers (Name, IP, Port, Token).
- Instant 1-click switching directly from the Titlebar Dropdown Selector.
- Add, edit, or delete servers easily from the Settings tab.
-
🚨 Critical Anomaly Monitoring & Dedicated Native Alert Window:
- Background Scanning Across All Servers: Monitors all saved servers in the background, not just the active one.
- Dedicated Win32 Alert Window: Replaces disappearing notifications with a dedicated window anchored at the bottom-right corner of your screen that requires user acknowledgment to close.
- Aggregated Incident Reporting: All simultaneous issues across servers (e.g. Server 1: CPU 94%, Server 2: Temp 82 °C) are presented in a single, consolidated alert.
- 1-Minute Spam Protection: Enforces a 60-second cooldown so your desktop is never flooded with alerts.
- Configurable Thresholds: Easily customize warning limits for CPU, RAM, Disk fill rate, and Hardware temperatures.
-
📊 Process Management with CPU %, RAM & Disk I/O:
- Live CPU %: Real-time processor usage calculated from
/proc/[pid]/statwith dynamic load color indicators. - RAM Usage (MB & %): Exact memory footprint with percentage of total system RAM and a mini bar chart.
- Disk I/O (Read & Write): Real-time cumulative disk read/write metrics parsed directly from
/proc/[pid]/io. - Sorting: Sort processes instantly by CPU %, RAM, Disk I/O, PID, or Name.
- Live CPU %: Real-time processor usage calculated from
-
🌡️ Human-Friendly Hardware Temperatures:
- Translates raw sensor labels (
x86_pkg_temp,BAT0,acpitz,nvme0) into clear names:- ⚡ Processor (CPU)
- 🔋 Battery
- 💾 NVMe SSD Storage
- 🖥️ Motherboard (ACPI)
- 📡 Wireless Network (Wi-Fi)
- Custom SVG hardware icons and automatic health badges: Optimal (<45°C), Normal (45-70°C), High (>70°C).
- Translates raw sensor labels (
-
🌐 Full Dual-Language Support (English & Turkish):
- Click the
TR | ENtoggle in the top-right corner to translate the entire UI, table headers, and dialogues instantaneously. - Fully synced with native Windows context menus (Open / Show, Switch to Window Mode, Exit) and Alert window buttons.
- Click the
-
Systemd Service Management (Services):
- List and filter Debian services (
systemctl) by status (All, Active Only, Failed). - Restart (
restart), Stop (stop), or Start (start) any service with a single click.
- List and filter Debian services (
-
User & Permission Management (Users & Permissions):
- View system users, UID/GID, default shell, and group memberships.
- One-click Grant Sudo (Admin) (
usermod -aG sudo) or Revoke Sudo (gpasswd -d ... sudo). - Lock/unlock user accounts and modify default login shells.
-
Remote Terminal & Power Control:
- Execute shell commands remotely (
df -h,docker ps,apt update, etc.) with terminal output and execution duration. - Safely Reboot (
reboot) or Shut Down (shutdown) the server remotely.
- Execute shell commands remotely (
-
Adaptive Windows UI Modes:
- Flyout Mode (Default): Opens smoothly above the taskbar in the bottom-right corner (
680 x 750 px). Auto-hides on click outside. - Window Mode: Convert to a freely movable, resizable standard desktop window (
1050 x 780 px) with title bar controls.
- Flyout Mode (Default): Opens smoothly above the taskbar in the bottom-right corner (
Copy the linux-helper directory to your Debian machine and run:
cd linux-helper
sudo bash install.sh- Installs
build-essential(g++, make) if missing. - Compiles the C++ source code with
-O3optimizations. - Installs the binary to
/usr/local/bin/linux-server-helper. - Generates a secure 32-character random API Token in
/etc/linux-server-helper/config.json. - Creates and enables the systemd service (
linux-server-helper.service) to run quietly on boot. - Automatically opens port
8765/tcpif UFW firewall is active. - Prints your server's Local IP, Port, and API Token in a formatted banner.
# Check service status:
sudo systemctl status linux-server-helper
# View live service logs:
sudo journalctl -u linux-server-helper -f
# Restart service:
sudo systemctl restart linux-server-helper
# Stop service:
sudo systemctl stop linux-server-helper- Launch
windows-client/bin/LinuxServerHelper.exe. - The application sits quietly in your System Tray (bottom-right next to the clock).
- Click the tray icon to open the control panel flyout.
- Click the
+button in the header or go to the Settings tab:- Server Name: e.g.,
Production Debian - IP Address: Server's IP address (e.g.,
192.168.1.150). - Port:
8765 - API Token: The secret token generated by
install.sh. - Click Save.
- Server Name: e.g.,
- When multiple servers are added, switch between them instantly using the top-left dropdown.
- Click the
EN/TRpill button in the top-right header to toggle the entire application language immediately.
- Click the maximize/window icon on the title bar or right-click the system tray icon and select "Switch to Window Mode".
Pass authentication via X-API-Key: <TOKEN> or Authorization: Bearer <TOKEN>.
# 1. Ping / Health check
curl http://SERVER_IP:8765/api/ping
# 2. Live Metrics (CPU, RAM, Disk, Network, Temps)
curl -H "X-API-Key: YOUR_TOKEN" http://SERVER_IP:8765/api/metrics
# 3. List Processes & Kill Process
curl -H "X-API-Key: YOUR_TOKEN" http://SERVER_IP:8765/api/processes?limit=150
curl -X POST -H "X-API-Key: YOUR_TOKEN" -H "Content-Type: application/json" -d '{"pid": 1234, "signal": 15}' http://SERVER_IP:8765/api/processes/kill
# 4. Service Actions (start, stop, restart, reload, status)
curl -H "X-API-Key: YOUR_TOKEN" http://SERVER_IP:8765/api/services
curl -X POST -H "X-API-Key: YOUR_TOKEN" -H "Content-Type: application/json" -d '{"service": "nginx.service", "action": "restart"}' http://SERVER_IP:8765/api/services/action
# 5. User Management & Permissions
curl -H "X-API-Key: YOUR_TOKEN" http://SERVER_IP:8765/api/users
curl -X POST -H "X-API-Key: YOUR_TOKEN" -H "Content-Type: application/json" -d '{"username": "john", "action": "grant_sudo"}' http://SERVER_IP:8765/api/users/action
# 6. Remote Shell Execution
curl -X POST -H "X-API-Key: YOUR_TOKEN" -H "Content-Type: application/json" -d '{"command": "uname -a && uptime"}' http://SERVER_IP:8765/api/exec
# 7. Power Management
curl -X POST -H "X-API-Key: YOUR_TOKEN" http://SERVER_IP:8765/api/power/reboot
curl -X POST -H "X-API-Key: YOUR_TOKEN" http://SERVER_IP:8765/api/power/shutdownTo test the Windows client locally without a live Debian machine:
python test_mock_server.pyThis starts a mock server at http://127.0.0.1:8765 with token TEST_TOKEN_12345.





