HandyCafe Docs
it-admin

Pierwsze kroki: Administrator IT

Ten przewodnik obejmuje konfiguracje techniczna HandyCafe. Pod koniec bedziesz mial zainstalowany serwer i klientow, skonfigurowana siec, utworzone menu aplikacji i przetestowane zdalne zarzadzanie.

Czas realizacji: 5 minut (plus czas wdrazania klientow)

Krok 1: Zainstaluj serwer i klientow

Instalacja serwera:

  1. Sprawdz czy komputer serwerowy spelnia wymagania systemowe.
  2. Pobierz i zainstaluj HandyCafe Server na komputerze zarzadzajacym.
  3. Uruchom serwer i ukoncz Kreator pierwszej konfiguracji, aby utworzyc konto administratora.
  4. Zanotuj lokalny adres IP komputera serwerowego. Klienci beda go potrzebowac do polaczenia.

Instalacja klienta (powtorz dla kazdego komputera):

  1. Pobierz HandyCafe Client na kazdy komputer dla klientow.
  2. Zainstaluj i uruchom klienta.
  3. Klient wyszukuje serwer w sieci lokalnej za pomoca odkrywania mDNS.
  4. Jesli serwer nie zostanie znaleziony automatycznie, wprowadz adres IP serwera recznie w ustawieniach klienta.
  5. Po polaczeniu klient pojawia sie w Panelu administracyjnym serwera.

Wskazowka: Uzyj funkcji automatycznego nazewnictwa serwera (Ustawienia > Klienci), aby automatycznie nazywac klientow z prefiksem jak "PC #1", "PC #2" itp. Nazwy wyswietlane mozesz dostosowac pozniej.

Szczegolowe kroki znajdziesz w Instalacji serwera i Instalacji klienta.

Krok 2: Skonfiguruj ustawienia sieci

Przejdz do Ustawienia > Siec na serwerze.

HandyCafe uzywa czterech portow do komunikacji:

Port Domyslny Przeznaczenie
Port TCP 5001 Komunikacja komend i odpowiedzi
Port plikow 5002 Transfery plikow miedzy serwerem a klientami
Port zdalnego zarzadzania 5003 Sterowanie strumieniowaniem zdalnego pulpitu
Port UDP 5004 Dane strumieniowania ekranu

Konfiguracja:

  1. Ustaw porty (domyslne dzialaja dla wiekszosci konfiguracji).
  2. Ustaw Klucz polaczenia. To wspolny sekret uzywany do uwierzytelniania HMAC-SHA256. Wszyscy klienci musza uzywac tego samego klucza.
  3. Kliknij Zapisz.

Reguly zapory sieciowej:

Upewnij sie, ze te porty sa otwarte zarowno na serwerze, jak i komputerach klienckich:

  • TCP: 5001, 5002, 5003 (wchodzacy na serwerze, wychodzacy na klientach)
  • UDP: 5004 (dwukierunkowy dla strumieniowania ekranu)

Wazne: Wszystkie komputery musza byc w tej samej sieci lokalnej (podsieci). HandyCafe uzywa mDNS do odkrywania klientow, co wymaga polaczenia LAN.

Wszystkie opcje sieciowe znajdziesz w Ustawieniach sieci.

Krok 3: Skonfiguruj menu klienta

Menu klienta to launcher aplikacji widoczny klientom na pulpicie. Przejdz do Ustawienia > Klienci > zakladka Zawartosc.

  1. Utworz kategorie. Grupuj aplikacje wedlug typu (np. Gry, Przegladarki, Media spolecznosciowe, Narzedzia).
  2. Dodaj aplikacje do kazdej kategorii:
    • Ustaw nazwe aplikacji i opis.
    • Wybierz rodzaj aplikacji: Gra, Przegladarka, Link, Plik lub Aplikacja.
    • Ustaw sciezke pliku wykonywalnego lub URI uruchomienia.
    • Przeslij ikone i opcjonalnie plakat dla karty aplikacji.
  3. Zmien kolejnosc kategorii i aplikacji za pomoca uchwytow przeciagania.
  4. Przelaczaj widocznosc, aby pokazywac lub ukrywac elementy.
  5. Kliknij Zapisz.

Zmiany sa przesylane do wszystkich podlaczonych klientow automatycznie w czasie rzeczywistym przez TCP.

Wskazowka: Uzyj integracji IGDB, aby automatycznie wyszukiwac metadane i ikony gier.

Pelna dokumentacje budowania menu znajdziesz w Menu klienta.

Krok 4: Skonfiguruj ekran bezczynnosci i wyglad

Ekran bezczynnosci (Ustawienia > Klienci > zakladka Ekran bezczynnosci):

Ekran bezczynnosci to widok wyswietlany klientom, gdy zadna sesja nie jest aktywna (ekran blokady).

  1. Wlacz pokaz slajdow ekranu bezczynnosci.
  2. Dodaj obrazy lub filmy (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Ustaw czas trwania per element i efekt przejscia (zanikanie, przesuwanie, powiekszanie).
  4. Opcjonalnie wlacz nakladke zegara i wyswietlanie nazwy kafejki z niestandardowymi kolorami.
  5. Kliknij Zapisz.

Wyglad (Ustawienia > Klienci > zakladka Wyglad):

Konfiguruj wyglad pulpitu online uzywanego przez klientow podczas sesji.

  1. Wybierz motyw: Neon Arena, Crimson Pulse lub Emerald Depth.
  2. Wybierz uklad: Split Classic, Hero Wide Top, Catalog Wide Bottom lub Compact Focus.
  3. Skonfiguruj tlo: jednolity kolor, gradient, obraz lub wideo z ustawieniami nakladki i rozmycia.
  4. Dostosuj gestosc kart (Duza, Srednia, Kompaktowa) i efekty najechania.
  5. Kliknij Zapisz.

Wszystkie opcje znajdziesz w Ekranie bezczynnosci klienta i Wygladzie klienta.

Krok 5: Przetestuj zdalny pulpit i zrzuty ekranu

Sprawdz dzialanie zdalnego zarzadzania:

Zrzuty ekranu:

  1. W Panelu administracyjnym wybierz dowolna karte podlaczonego klienta.
  2. Kliknij Zrzut ekranu na karcie klienta.
  3. Zrzut ekranu klienta pojawia sie w przegladarce.
  4. Mozesz pobrac lub odswiezyc zrzut ekranu.

Zdalny pulpit:

  1. Wybierz karte podlaczonego klienta i kliknij Zdalny pulpit.
  2. Otwiera sie okno zdalnego pulpitu ze strumieniowaniem H.264 na zywo.
  3. Mozesz sterowac mysza i klawiatura na zdalnym komputerze.
  4. Synchronizacja schowka dziala miedzy serwerem a klientem.

Uwaga: Zdalny pulpit uzywa strumieniowania UDP. Jesli obraz jest opozniony, sprawdz przepustowosc sieci i upewnij sie, ze port UDP 5004 nie jest blokowany. Mozesz rowniez dostosowac szybkosc transmisji w ustawieniach strumienia (350-25 000 kbps).

Wszystkie funkcje zdalne znajdziesz w Zdalnym pulpicie i Zrzutach ekranu.

Przeglad 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