HandyCafe Docs
it-admin

Pierwsze kroki: Administrator IT

Ten przewodnik obejmuje konfigurację techniczną HandyCafe. Pod koniec będziesz miał zainstalowany serwer i klientów, skonfigurowaną sieć, utworzone menu aplikacji i przetestowane zdalne zarządzanie.

Czas realizacji: 5 minut (plus czas wdrażania klientów)

Krok 1: Zainstaluj serwer i klientów

Instalacja serwera:

  1. Sprawdź czy komputer serwerowy spełnia wymagania systemowe.
  2. Pobierz i zainstaluj HandyCafe Server na komputerze zarządzającym.
  3. Uruchom serwer i ukończ Kreator pierwszej konfiguracji, aby utworzyć konto administratora.
  4. Zanotuj lokalny adres IP komputera serwerowego. Klienci będą go potrzebować do połączenia.

Instalacja klienta (powtórz dla każdego komputera):

  1. Pobierz HandyCafe Client na każdy komputer dla klientów.
  2. Zainstaluj i uruchom klienta.
  3. Klient wyszukuje serwer w sieci lokalnej za pomocą odkrywania mDNS.
  4. Jeśli serwer nie zostanie znaleziony automatycznie, wprowadź adres IP serwera ręcznie w ustawieniach klienta.
  5. Po połączeniu klient pojawia się w Panelu administracyjnym serwera.

Wskazówka: Użyj funkcji automatycznego nazewnictwa serwera (Ustawienia > Klienci), aby automatycznie nazywać klientów z prefiksem jak "PC #1", "PC #2" itp. Nazwy wyświetlane możesz dostosować później.

Szczegółowe kroki znajdziesz w Instalacji serwera i Instalacji klienta.

Krok 2: Skonfiguruj ustawienia sieci

Przejdź do Ustawienia > Sieć na serwerze.

HandyCafe używa czterech portów do komunikacji:

Port Domyślny Przeznaczenie
Port TCP 5001 Komunikacja komend i odpowiedzi
Port plików 5002 Transfery plików między serwerem a klientami
Port zdalnego zarządzania 5003 Sterowanie strumieniowaniem zdalnego pulpitu
Port UDP 5004 Dane strumieniowania ekranu

Konfiguracja:

  1. Ustaw porty (domyślne działają dla większości konfiguracji).
  2. Ustaw Klucz połączenia. To wspólny sekret używany do uwierzytelniania HMAC-SHA256. Wszyscy klienci muszą używać tego samego klucza.
  3. Kliknij Zapisz.

Reguły zapory sieciowej:

Upewnij się, że te porty są otwarte zarówno na serwerze, jak i komputerach klienckich:

  • TCP: 5001, 5002, 5003 (wchodzący na serwerze, wychodzący na klientach)
  • UDP: 5004 (dwukierunkowy dla strumieniowania ekranu)

Ważne: Wszystkie komputery muszą być w tej samej sieci lokalnej (podsieci). HandyCafe używa mDNS do odkrywania klientów, co wymaga połączenia LAN.

Wszystkie opcje sieciowe znajdziesz w Ustawieniach sieci.

Krok 3: Skonfiguruj menu klienta

Menu klienta to launcher aplikacji widoczny klientom na pulpicie. Przejdź do Ustawienia > Klienci > zakładka Zawartość.

  1. Utwórz kategorie. Grupuj aplikacje według typu (np. Gry, Przeglądarki, Media społecznościowe, Narzędzia).
  2. Dodaj aplikacje do każdej kategorii:
    • Ustaw nazwę aplikacji i opis.
    • Wybierz rodzaj aplikacji: Gra, Przeglądarka, Link, Plik lub Aplikacja.
    • Ustaw ścieżkę pliku wykonywalnego lub URI uruchomienia.
    • Prześlij ikonę i opcjonalnie plakat dla karty aplikacji.
  3. Zmień kolejność kategorii i aplikacji za pomocą uchwytów przeciągania.
  4. Przełączaj widoczność, aby pokazywać lub ukrywać elementy.
  5. Kliknij Zapisz.

Zmiany są przesyłane do wszystkich podłączonych klientów automatycznie w czasie rzeczywistym przez TCP.

Wskazówka: Użyj integracji IGDB, aby automatycznie wyszukiwać metadane i ikony gier.

Pełną dokumentację budowania menu znajdziesz w Menu klienta.

Krok 4: Skonfiguruj ekran bezczynności i wygląd

Ekran bezczynności (Ustawienia > Klienci > zakładka Ekran bezczynności):

Ekran bezczynności to widok wyświetlany klientom, gdy żadna sesja nie jest aktywna (ekran blokady).

  1. Włącz pokaz slajdów ekranu bezczynności.
  2. Dodaj obrazy lub filmy (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Ustaw czas trwania per element i efekt przejścia (zanikanie, przesuwanie, powiększanie).
  4. Opcjonalnie włącz nakładkę zegara i wyświetlanie nazwy kafejki z niestandardowymi kolorami.
  5. Kliknij Zapisz.

Wygląd (Ustawienia > Klienci > zakładka Wygląd):

Konfiguruj wygląd pulpitu online używanego przez klientów podczas sesji.

  1. Wybierz motyw: Neon Arena, Crimson Pulse lub Emerald Depth.
  2. Wybierz układ: Split Classic, Hero Wide Top, Catalog Wide Bottom lub Compact Focus.
  3. Skonfiguruj tło: jednolity kolor, gradient, obraz lub wideo z ustawieniami nakładki i rozmycia.
  4. Dostosuj gęstość kart (Duża, Średnia, Kompaktowa) i efekty najechania.
  5. Kliknij Zapisz.

Wszystkie opcje znajdziesz w Ekranie bezczynności klienta i Wyglądzie klienta.

Krok 5: Przetestuj zdalny pulpit i zrzuty ekranu

Sprawdź działanie zdalnego zarządzania:

Zrzuty ekranu:

  1. W Panelu administracyjnym wybierz dowolną kartę podłączonego klienta.
  2. Kliknij Zrzut ekranu na karcie klienta.
  3. Zrzut ekranu klienta pojawia się w przeglądarce.
  4. Możesz pobrać lub odświeżyć zrzut ekranu.

Zdalny pulpit:

  1. Wybierz kartę podłączonego klienta i kliknij Zdalny pulpit.
  2. Otwiera się okno zdalnego pulpitu ze strumieniowaniem H.264 na żywo.
  3. Możesz sterować myszą i klawiaturą na zdalnym komputerze.
  4. Synchronizacja schowka działa między serwerem a klientem.

Uwaga: Zdalny pulpit używa strumieniowania UDP. Jeśli obraz jest opóźniony, sprawdź przepustowość sieci i upewnij się, że port UDP 5004 nie jest blokowany. Możesz również dostosować szybkość transmisji w ustawieniach strumienia (350-25 000 kbps).

Wszystkie funkcje zdalne znajdziesz w Zdalnym pulpicie i Zrzutach ekranu.

Przegląd architektury sieciowej

Komputer serwerowy (zarzadzanie)
    |
    |--- TCP (5001) --- Komendy/odpowiedzi (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Transfery plikow
    |--- TCP (5003) --- Sterowanie zdalnym zarzadzaniem
    |--- UDP (5004) --- Strumieniowanie ekranu (H.264)
    |--- mDNS ------- Odkrywanie klientow (automatyczne)
    |
    +-- Komputer kliencki 1
    +-- Komputer kliencki 2
    +-- Komputer kliencki 3
    +-- ...

Co dalej