HandyCafe Docs
owner it-admin

Wymagania systemowe

Przed instalacją HandyCafe w kafejce internetowej, centrum gamingowym lub na arenie e-sportowej upewnij się, że Twój sprzęt i sieć spełniają poniższe wymagania.

Wymagania komputera serwera

Serwer to Twoja stacja zarządzania. Na tym komputerze uruchamiasz HandyCafe Server do monitorowania i kontrolowania całej kafejki.

Komponent Minimum Zalecane
System operacyjny Windows 10+ (64-bit), macOS 12 Monterey+ lub Linux (64-bit) Windows 10/11 (64-bit), macOS 12+ lub Linux (64-bit)
Procesor Dwurdzeniowy 2,0 GHz Czterordzeniowy 2,5 GHz+
RAM 4 GB 8 GB+
Przestrzeń dyskowa 500 MB (aplikacja) 2 GB+ (z nagraniami i zrzutami ekranu)
Wyświetlacz 1280 x 720 1920 x 1080+
Sieć 100 Mbps Ethernet Gigabit Ethernet

Uwaga: Jeśli korzystasz ze zdalnego pulpitu z nagrywaniem sesji, zarezerwuj dodatkową przestrzeń dyskową na nagrania MP4 (około 50-200 MB na godzinę nagrywania w zależności od jakości).

Uwaga o Linux: HandyCafe jest zbudowany na Tauri v2, które na Linuxie wykorzystuje WebKit2GTK. Musisz zainstalować pakiet runtime libwebkit2gtk-4.1 przed uruchomieniem aplikacji. Obsługiwane dystrybucje to Ubuntu 22.04+, Fedora 38+ oraz inne dystrybucje dostarczające równoważną wersję WebKit2GTK.

Wymagania komputera klienckiego

Każdy komputer przeznaczony dla klientów uruchamia HandyCafe Client, który łączy się z serwerem przez sieć lokalną.

Komponent Minimum Zalecane
System operacyjny Windows 10+ (64-bit), macOS 12 Monterey+ lub Linux (64-bit) Windows 10/11 (64-bit), macOS 12+ lub Linux (64-bit)
Procesor Dwurdzeniowy 1,5 GHz Czterordzeniowy 2,0 GHz+
RAM 2 GB 4 GB+
Przestrzeń dyskowa 200 MB 500 MB+
Sieć 100 Mbps Ethernet Gigabit Ethernet

Uwaga: To są wymagania wyłącznie dla oprogramowania HandyCafe Client. Twoje komputery będą potrzebowały dodatkowych zasobów na gry i aplikacje z których korzystają klienci.

Wymagania sieciowe

Wszystkie komputery (serwer i klienty) muszą znajdować się w tej samej sieci lokalnej (LAN).

Wymagane porty

Port Protokół Kierunek Przeznaczenie
5001 TCP Serwer: przychodzący, Klient: wychodzący Komunikacja poleceń i odpowiedzi
5002 TCP Dwukierunkowy Transfery plików
5003 TCP Serwer: przychodzący, Klient: wychodzący Kanał sterowania zdalnym zarządzaniem
5004 UDP Dwukierunkowy Strumieniowanie ekranu (zdalny pulpit)

Ważne: To są domyślne porty. Możesz je zmienić w Ustawieniach sieciowych. Jeśli zmienisz porty na serwerze, zaktualizuj konfigurację klienta.

Konfiguracja zapory sieciowej

  • Zapora Windows: HandyCafe próbuje automatycznie dodać reguły zapory podczas instalacji. Jeśli automatyczna konfiguracja nie powiedzie się, ręcznie dodaj reguły przychodzące dla portów wymienionych powyżej.
  • Zapora macOS: Otwórz Ustawienia systemowe > Sieć > Zapora i zezwól na połączenia przychodzące dla HandyCafe. Alternatywnie dodaj porty wymienione powyżej do listy dozwolonych zapory.
  • Linux (iptables / ufw): Jeśli używasz ufw, uruchom sudo ufw allow 5001:5004/tcp i sudo ufw allow 5004/udp. Dla surowych iptables dodaj równoważne reguły INPUT ACCEPT dla portów TCP 5001-5003 i portu UDP 5004.
  • Zapory firm trzecich: Dodaj wyjątki dla pliku binarnego serwera HandyCafe na komputerze serwera i pliku binarnego klienta HandyCafe na komputerach klienckich.
  • Router/Switch: Specjalna konfiguracja nie jest wymagana dla pracy wyłącznie w sieci LAN. Jeśli masz VLAN-y, upewnij się, że serwer i wszyscy klienci są w tym samym VLAN-ie lub że routing pozwala na wymagane porty.

Wykrywanie klientów

HandyCafe używa mDNS (multicast DNS) do automatycznego wykrywania klientów w sieci lokalnej. Wymaga to:

  • Wszystkich komputerów w tej samej podsieci
  • Ruchu multicast nie blokowanego przez switche ani routery
  • Jeśli mDNS nie działa (np. między podsieciami), klienty mogą się połączyć wpisując adres IP serwera ręcznie

Wymagania dotyczące przepustowości

Funkcja Przybliżona przepustowość
Normalna praca (na klienta) < 1 Kbps
Strumieniowanie zdalnego pulpitu 350 - 25 000 Kbps (konfigurowalne)
Transfer synchronizacji plików Ograniczony prędkością sieci
Przechwytywanie zrzutu ekranu ~100 KB na zrzut

Dla typowej kafejki z 20-50 komputerami standardowa sieć LAN 100 Mbps jest wystarczająca. Gigabit Ethernet jest zalecany jeśli często korzystasz ze zdalnego pulpitu dla wielu komputerów jednocześnie.

Wymagania konsol

Jeśli zarządzasz konsolami do gier (PlayStation, Xbox itp.), konsole muszą być w tej samej sieci co serwer. Każda konsola jest identyfikowana po adresie MAC i rejestrowana ręcznie w Ustawieniach konsol.