DeskVNCServer - Rehber

Başlarken

1. Parola Belirleyin

Ayarlar'ı (dişli simgesi, alt araç çubuğu) açın ve şunu doldurun: VNC parolası. Standart VNC istemcileri RFB DES sınamasını kullanır; bu yöntem yalnızca ilk 8 ASCII uyumlu baytı kabul eder — en fazla 8 karakterlik bir parola seçin.

2. Sunucuyu Başlatın

1. Ana pencerede şuna tıklayın: Başlat. Durum göstergesi şuna dönüşür: Çalışıyor.
2. Dört dinleyici aynı anda açılır: VNC 5900, QREX kontrol 5911, QREX medya 4010ve dosya API'si 8766.
3. Tıklayın Bilgileri Kopyala ile ana makineyi, portları ve geçerli PIN'i içeren tek satırı panonuza kopyalayın.

3. Bir İstemci Bağlayın

Standart bir VNC görüntüleyici için (macOS Ekran Paylaşımı, RealVNC, TightVNC, mobil VNC uygulamaları):

1. Görüntüleyiciyi açın ve şunu girin: vnc://<mac-ip-adresiniz>:5900 adres olarak
2. 1. adımda belirlediğiniz VNC parolasını yazın
3. Mac'inizi hemen kontrol edin — klavye, fare, RFB üzerinden kopyala/yapıştır

QuickRemote uygulaması için:

1. Telefon veya tablette QuickRemote'u açın, şunu seçin: Mac Ekle
2. DeskVNCServer'ın gösterdiği 6 haneli eşleştirme PIN'ini girin (QuickRemote sürümünüz destekliyorsa QR kodunu tarayın)
3. QuickRemote, döndürülen Bearer token'ı saklar ve genişletilmiş özellikleri açar — IME, ses, pano eşitleme ve dosya aktarımı

Arayüze Genel Bakış

Durum Satırı

Eylem Düğmeleri

• Başlat — Dört dinleyicinin tümünü açar.
• Durdur — Tüm dinleyicileri kapatır ve etkin oturumların bağlantısını keser.
• Bilgileri Kopyala — Kolayca istemciyle paylaşmak için kısa bir bağlantı özetini (ana makine, VNC portu, kontrol portu, PIN) panoya kopyalar.

Bağlantı Paneli

Bağlama ana makinesini, portları, geçerli Sunucu Kimliğini ve etkin eşleştirme PIN'ini gösterir. Ayarlar değiştiğinde metin otomatik yenilenir.

QuickRemote API Paneli

Sunucunun konuştuğu protokoller için hızlı başvuru. QuickRemote'un (veya kendi istemcinizin) nelerin kullanılabildiğini bilmesi için desteklenen RFB sürümlerini, QREX uç nokta biçimlerini ve IME komut kümesini listeler.

Protokoller ve Portlar

Kimlik Doğrulama

• VNC istemcileri — RFB DES parolası (yapılandırılmış parolanın ilk 8 ASCII uyumlu baytı).
• QREX istemcileri — İlk 6 haneli PIN değişimi şu adreste: POST /qr/v1/pair Bir Bearer token döndürür. Sonraki her QREX HTTP çağrısı ve WebSocket çerçevesi şunu içermelidir: Authorization: Bearer <token>.
• VNC parolası boşsa, sunucu standart RFB kimlik doğrulamasız modu duyurur. Yalnızca güvenilir LAN kesimleri için kullanışlıdır.

QREX uç nokta hızlı başvurusu

GET  /qr/v1/capabilities    # herkese açık, desteklenen özellikleri döndürür
POST /qr/v1/pair            # herkese açık, PIN'i Bearer token ile değiştirir
GET  /qr/v1/ws              # WebSocket, kimlik doğrulama gerekir
POST /qr/v1/ime/get         # kimlik doğrulama gerekir, etkin IME'yi sorgular
POST /qr/v1/ime/list        # kimlik doğrulama gerekir, kullanılabilir IME'leri listeler
POST /qr/v1/ime/set         # kimlik doğrulama gerekir, IME değiştirir
POST /qr/v1/ime/toggle      # kimlik doğrulama gerekir, IME'yi açar/kapatır
POST /qr/v1/ime/commit      # kimlik doğrulama gerekir, bir metin dizgesi gönderir

Ayarlar

İstemci Örnekleri

macOS Ekran Paylaşımı

1. Finder → Git → Sunucuya Bağlan
2. Şunu yazın: vnc://<mac-ip-adresiniz>:5900
3. VNC parolasını girin

cURL — yetenekleri keşfedin

curl http://<mac-ip-adresiniz>:5911/qr/v1/capabilities

cURL — eşleştirin ve IME köprüsünü çağırın

# 1. PIN'i Bearer token ile değiştirin
TOKEN=$(curl -s http://<mac-ip-adresiniz>:5911/qr/v1/pair \
  -H "Content-Type: application/json" \
  -d '{"pin":"123456"}' | jq -r .token)

# 2. IME köprüsü üzerinden metin gönderin
curl http://<mac-ip-adresiniz>:5911/qr/v1/ime/commit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from remote"}'

İpuçları

• Yavaş bir Wi-Fi bağlantısındaysanız veya bağlantıyı VPN üzerinden yönlendiriyorsanız kare hızını ve azami kare boyutlarını düşürün.
• Her cihazı bir kez eşleştirin. İlk PIN değişiminden sonra Bearer token yeniden başlatmalardan sonra da kalır; böylece QuickRemote sessizce yeniden bağlanır.
• Şunu kullanın: Bilgileri Kopyala bağlantı ayrıntılarını sohbet veya e-postayla göndermenin hızlı bir yolu olarak — istemcinin gereksindiği her şeyi içerir.
• Şunu Dosya değişikliklerini etkinleştir yüklemelere gerçekten ihtiyacınız olmadıkça kapalı tutun. Salt okunur mod, ekran görüntülerine, notlara veya indirmelere göz atmak için yeterlidir.
• Kullanmadığınızda ses API'sini devre dışı bırakın. Boştaki codec'ler bile kodlama yolunda az miktarda CPU harcar.

Sorun Giderme

Sunucu başlamıyor

• Başka bir VNC sunucusu (ör. macOS Ekran Paylaşımı) 5900 portunu zaten kullanıyor olabilir. Sistem Ayarları → Genel → Paylaşım'dan durdurun veya DeskVNCServer ayarlarında portu değiştirin.
• 5911 / 4010 / 8766 portlarının tümü boş olmalıdır. Şununla denetleyin: lsof -i :5911 ve benzerleri.

VNC istemcileri kimlik doğrulamada başarısız oluyor

• Parolanın en fazla 8 ASCII uyumlu bayt olduğundan emin olun. Çok baytlı karakterler veya daha uzun dizgeler RFB DES kimlik doğrulaması tarafından sessizce kesilir.
• Kasıtlı olarak parola istemiyorsanız alanı boş bırakın ve VNC kimlik doğrulamasız modunu destekleyen bir görüntüleyiciyle bağlanın.

QuickRemote eşleştirilemiyor

• Telefonun veya tabletin Mac ile aynı Wi-Fi ağına bağlı olduğunu doğrulayın.
• Bağlantı panelini açıp PIN'i yeniden okuyun. PIN, Ayarlar'dan yeniden oluşturulabilir.
• macOS güvenlik duvarı ayarlarını denetleyin — QREX portlarındaki gelen bağlantılara izin verilmelidir.

Uzaktan kontrol gecikmeli hissettiriyor

• Ayarlarda kare hızını ve azami kare boyutlarını düşürün.
• Kullanmadığınız özellikleri (ses, pano, IME) devre dışı bırakarak CPU'yu boşaltın.

Dosyalar aktarılmıyor

• Şunun açık olduğunu doğrulayın: Dosya aktarımını etkinleştir . Salt okunur listeler, şu olmadan çalışır: Dosya değişikliklerini etkinleştir.
• Yüklemeler başarısızsa şunu da etkinleştirin: Dosya değişikliklerini etkinleştir. Aksi halde dosya API'si yalnızca okuma isteklerine yanıt verir.

Gizlilik

• Tüm oturumlar doğrudan istemci ile Mac'iniz arasında çalışır. Bulut aktarması, telemetri veya analiz yoktur.
• VNC parolası, QREX Bearer token, eşleştirme PIN'i ve kalıcı Sunucu Kimliği yalnızca yerel uygulama ayarlarında saklanır.
• Dosya değişiklikleri varsayılan olarak kapalıdır. Siz açıkça yazma erişimi vermedikçe uzak istemciler yalnızca okuyabilir.
• Herhangi bir uzantıyı (ses, pano, dosya aktarımı, IME, uzak giriş) istediğiniz zaman devre dışı bırakarak bu yeteneği hemen iptal edin.
• Sunucuyu Mac'inizde yerel tutmak istiyorsanız bağlama ana makinesini şuna ayarlayın: 127.0.0.1.