🖥️ KolayDesk

→ Nasıl Çalışır?

KolayDesk WebRTC yerine WebSocket Relay mimarisi kullanır. Tüm trafik senin sunucundan geçer. Bunun avantajları:

Bağlantı Akışı

→ Dosya Yapısı

1 Sunucu Kurulumu (VPS)

SSH ile sunucuna bağlan ve aşağıdaki adımları izle:

Sanal ortam oluştur ve bağımlılıkları yükle

cd /var/www/clients/client1/web4/web/kolaydesk/server

# Sanal ortam
python3 -m venv venv
source venv/bin/activate

# Paketleri yükle
pip install -r requirements.txt

.env dosyasını ayarla

cp .env.example .env
nano .env

.env içeriği şöyle olmalı:

HOST=0.0.0.0
PORT=8765
SECRET_KEY=buraya_cok_guclu_bir_sifre_yaz_degistir

Systemd servisi olarak kur

# Servis dosyasını kopyala
sudo cp kolaydesk.service /etc/systemd/system/

# Etkinleştir ve başlat
sudo systemctl daemon-reload
sudo systemctl enable kolaydesk
sudo systemctl start kolaydesk

# Çalışıyor mu?
sudo systemctl status kolaydesk

# Canlı log izle
journalctl -u kolaydesk -f

Test başlatma (servis kurmadan önce)

# Sanal ortam aktifken:
uvicorn main:app --host 0.0.0.0 --port 8765 --reload

2 Nginx / ISPConfig Ayarı

ISPConfig panelinde şu adımları izle:

1. Sites → desk.stokdental.xyz → Options sekmesi
2. Nginx Directives alanını bul
3. Aşağıdaki kodu yapıştır
4. Save — ISPConfig nginx'i otomatik yeniden yükler

# nginx_ispconfig.txt içeriği — kopyala yapıştır:

location /ws/ {
    proxy_pass http://127.0.0.1:8765;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_read_timeout 86400;
    proxy_send_timeout 86400;
    proxy_buffering off;
}

location /health {
    proxy_pass http://127.0.0.1:8765;
    proxy_set_header Host $host;
}

3 Admin Uygulaması

Bu uygulamayı kendi bilgisayarında çalıştırırsın (Windows/Mac/Linux). Python kurulu olması yeterli.

Kurulum

pip install -r admin/requirements.txt

Çalıştırma

# .env'de SECRET_KEY koyduysan onu da gönder:
# Windows:
set KOLAYDESK_SECRET=buraya_guclu_bir_sifre_yaz_degistir
python admin/admin_app.py

# Linux/Mac:
export KOLAYDESK_SECRET=buraya_guclu_bir_sifre_yaz_degistir
python admin/admin_app.py

Admin arayüzü nasıl kullanılır?

4 Müşteri .exe Oluşturma

Ön koşullar (Windows)

# Python 3.10+ kurulu olmalı
python --version

# PyInstaller ve bağımlılıkları yükle
pip install pyinstaller
pip install -r client/requirements.txt

Sunucu URL'sini kontrol et

client/client_app.py dosyasının 17. satırında SERVER_URL doğru olmalı:

SERVER_URL = "wss://desk.stokdental.xyz"

Yöntem A — .spec dosyasıyla (önerilen)

Gizli import'lar, UPX sıkıştırma ve tüm ayarlar hazır:

cd client
pyinstaller kolaydesk.spec

Yöntem B — Tek satır komut

pyinstaller --onefile --windowed \
  --hidden-import=websockets.legacy.client \
  --hidden-import=mss \
  --hidden-import=pyautogui \
  --name KolayDesk \
  client/client_app.py

Seçenekler

5 Kullanım Akışı

→ Protokol Referansı

WebSocket Mesaj Tipleri

Komut JSON Örnekleri

// Fare taşı
{"type": "mouse_move", "x": 640, "y": 360}

// Sol tık
{"type": "mouse_click", "x": 640, "y": 360, "button": "left", "double": false}

// Çift tık
{"type": "mouse_click", "x": 640, "y": 360, "button": "left", "double": true}

// Sağ tık
{"type": "mouse_click", "x": 640, "y": 360, "button": "right", "double": false}

// Scroll
{"type": "mouse_scroll", "x": 640, "y": 360, "amount": 3}

// Tuş basma
{"type": "key_press", "key": "enter"}
{"type": "key_press", "key": "backspace"}
{"type": "key_press", "key": "f5"}

// Kısayol (Ctrl+C, Ctrl+V vb.)
{"type": "hotkey", "keys": ["ctrl", "c"]}
{"type": "hotkey", "keys": ["ctrl", "alt", "delete"]}
{"type": "hotkey", "keys": ["winleft", "d"]}

// Metin yaz
{"type": "type_text", "text": "merhaba"}