HandyCafe Docs
it-admin

Başlarken: BT Yöneticisi

Bu rehber HandyCafe'nin teknik kurulumunu kapsar. Sonunda sunucu ve istemcileri kurmuş, ağı yapılandırmış, uygulama menüleri oluşturmuş ve uzak yönetimi test etmiş olacaksınız.

Tamamlama süresi: 5 dakika (istemci dağıtım süresi hariç)

Adım 1: Sunucu ve İstemcileri Kurun

Sunucu kurulumu:

  1. Sunucu bilgisayarınızın sistem gereksinimlerini karşıladığını doğrulayın.
  2. HandyCafe Sunucu'yu yönetim bilgisayarınıza indirip kurun.
  3. Sunucuyu başlatın ve yönetici hesabını oluşturmak için İlk Kurulum Sihirbazı'nı tamamlayın.
  4. Sunucu bilgisayarınızın yerel IP adresini not edin. İstemcilerin bağlanması için buna ihtiyaç duyulacak.

İstemci kurulumu (her bilgisayar için tekrarlayın):

  1. Her müşteri bilgisayarına HandyCafe Client indirin.
  2. Kurup başlatın.
  3. İstemci, mDNS keşfini kullanarak yerel ağdaki sunucuyu arar.
  4. Sunucu otomatik olarak bulunamazsa sunucu IP adresini istemci ayarlarından elle girin.
  5. Bağlandığında istemci sunucunun Yönetim Paneli'nde görünür.

İpucu: İstemcileri "PC #1", "PC #2" gibi bir ön ekle otomatik adlandırmak için sunucunun otomatik adlandırma özelliğini (Ayarlar > İstemciler) kullanın. Görünen adları daha sonra özelleştirebilirsiniz.

Ayrıntılı adımlar için Sunucu Kurulumu ve İstemci Kurulumu sayfalarını inceleyin.

Adım 2: Ağ Ayarlarını Yapılandırın

Sunucuda Ayarlar > Ağ bölümüne gidin.

HandyCafe iletişim için dört port kullanır:

Port Varsayılan Amaç
TCP Port 5001 Komut ve yanıt iletişimi
Dosya Portu 5002 Sunucu ve istemciler arası dosya transferleri
Uzak Yönetim Portu 5003 Uzak masaüstü akış kontrolü
UDP Port 5004 Ekran akış verileri

Yapılandırma:

  1. Portları ayarlayın (varsayılanlar çoğu kurulum için çalışır).
  2. Bağlantı Anahtarı'nı belirleyin. Bu HMAC-SHA256 kimlik doğrulaması için kullanılan paylaşılan bir gizli anahtardır. Tüm istemciler aynı anahtarı kullanmalıdır.
  3. Kaydet'e tıklayın.

Güvenlik duvarı kuralları:

Bu portların hem sunucu hem de istemci bilgisayarlarda açık olduğundan emin olun:

  • TCP: 5001, 5002, 5003 (sunucuda gelen, istemcilerde giden)
  • UDP: 5004 (ekran akışı için çift yönlü)

Önemli: Tüm bilgisayarlar aynı yerel ağda (alt ağda) olmalıdır. HandyCafe istemci keşfi için mDNS kullanır. Bu yerel ağ bağlantısı gerektirir.

Tüm ağ seçenekleri için Ağ Ayarları sayfasına bakın.

Adım 3: İstemci Menüsünü Ayarlayın

İstemci menüsü müşterilerin masaüstlerinde gördüğü uygulama başlatıcısıdır. Ayarlar > İstemciler > İçerik sekmesine gidin.

  1. Kategoriler oluşturun. Uygulamaları türe göre gruplayın (örneğin Oyunlar, Tarayıcılar, Sosyal Medya, Araçlar).
  2. Her kategoriye uygulama ekleyin:
    • Uygulama adı ve açıklama belirleyin.
    • Uygulama türünü seçin: Oyun, Tarayıcı, Bağlantı, Dosya veya Uygulama.
    • Çalıştırılabilir dosya yolunu veya başlatma URI'sini ayarlayın.
    • Uygulama kartı için bir simge ve isteğe bağlı bir poster görseli yükleyin.
  3. Kategorileri ve uygulamaları sürükleme tutamaçlarıyla yeniden sıralayın.
  4. Ögeleri göstermek veya gizlemek için görünürlüğü değiştirin.
  5. Kaydet'e tıklayın.

Değişiklikler TCP üzerinden tüm bağlı istemcilere otomatik olarak gerçek zamanlı iletilir.

İpucu: Oyun meta verilerini ve simgeleri otomatik olarak aramak için IGDB entegrasyonunu kullanın.

Tam menü oluşturucu dokümantasyonu için İstemci Menüsü sayfasına bakın.

Adım 4: Boşta Ekranı ve Görünümü Yapılandırın

Boşta Ekranı (Ayarlar > İstemciler > Boşta Ekranı sekmesi):

Boşta ekranı, aktif oturum olmadığında müşterilerin gördüğü ekrandır (kilit ekranı).

  1. Boşta ekranı slayt gösterisini etkinleştirin.
  2. Görsel veya video ekleyin (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Öge başına süre ve geçiş efektini (soldurma, kaydırma, yakınlaştırma) ayarlayın.
  4. İsteğe bağlı olarak özel renklerle saat kaplaması ve kafe adı gösterimini etkinleştirin.
  5. Kaydet'e tıklayın.

Görünüm (Ayarlar > İstemciler > Görünüm sekmesi):

Müşterilerin oturumlar sırasında kullandığı çevrimiçi masaüstünün görünümünü yapılandırın.

  1. Bir tema seçin: Neon Arena, Crimson Pulse veya Emerald Depth.
  2. Bir yerleşim şablonu seçin: Split Classic, Hero Wide Top, Catalog Wide Bottom veya Compact Focus.
  3. Arka planı yapılandırın: düz renk, gradyan, görsel veya video ile kaplama ve bulanıklık ayarları.
  4. Kart yoğunluğunu (Büyük, Orta, Kompakt) ve üzerine gelme efektlerini ayarlayın.
  5. Kaydet'e tıklayın.

Tüm seçenekler için İstemci Boşta Ekranı ve İstemci Görünümü sayfalarına bakın.

Adım 5: Uzak Masaüstü ve Ekran Görüntüsünü Test Edin

Uzak yönetimin çalıştığını doğrulayın:

Ekran Görüntüleri:

  1. Yönetim Paneli'nde çevrimiçi herhangi bir istemci kartını seçin.
  2. İstemci kartındaki Ekran Görüntüsü düğmesine tıklayın.
  3. İstemcinin ekranının görüntüsü görüntüleyicide görünür.
  4. Görüntüyü indirebilir veya yenileyebilirsiniz.

Uzak Masaüstü:

  1. Çevrimiçi bir istemci kartı seçin ve Uzak Masaüstü düğmesine tıklayın.
  2. Canlı H.264 akışıyla bir uzak masaüstü penceresi açılır.
  3. Uzak bilgisayarda fareyi ve klavyeyi kontrol edebilirsiniz.
  4. Pano senkronizasyonu sunucu ve istemci arasında çalışır.

Not: Uzak masaüstü UDP akışı kullanır. Video gecikmeli ise ağ bant genişliğinizi kontrol edin ve UDP port 5004'ün engellenmediğinden emin olun. Akış ayarlarında bit hızını da ayarlayabilirsiniz (350-25.000 kbps).

Tüm uzak erişim özellikleri için Uzak Masaüstü ve Ekran Görüntüleri sayfalarına bakın.


Ağ Mimarisi Genel Bakış

Sunucu Bilgisayar (Yönetim)
    |
    |--- TCP (5001) --- Komut/Yanıt (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Dosya Transferleri
    |--- TCP (5003) --- Uzak Yönetim Kontrolü
    |--- UDP (5004) --- Ekran Akışı (H.264)
    |--- mDNS ------- İstemci Keşfi (otomatik)
    |
    +-- İstemci Bilgisayar 1
    +-- İstemci Bilgisayar 2
    +-- İstemci Bilgisayar 3
    +-- ...

Sonraki Adımlar