Системні вимоги

Перед встановленням HandyCafe у вашому інтернет-кафе, ігровому центрі або кіберспортивній арені перевірте відповідність вашого обладнання та мережі таким вимогам.

Вимоги до серверного ПК

Сервер -- ваша станція управління. Це ПК, на якому працює HandyCafe Server для моніторингу та управління кафе.

Компонент	Мінімальні	Рекомендовані
ОС	Windows 10+ (64-біт), macOS 12 Monterey+, або Linux (64-біт)	Windows 10/11 (64-біт), macOS 12+, або Linux (64-біт)
Процесор	Двоядерний 2.0 ГГц	Чотириядерний 2.5 ГГц+
ОЗП	4 ГБ	8 ГБ+
Диск	500 МБ (додаток)	2 ГБ+ (з записами та знімками)
Дисплей	1280 x 720	1920 x 1080+
Мережа	100 Мбіт/с Ethernet	Гігабітний Ethernet

Примітка: При використанні віддаленого робочого стола з записом сеансів виділіть додатковий дисковий простір для MP4-записів (приблизно 50-200 МБ на годину запису залежно від якості).

Примітка для Linux: HandyCafe побудований на Tauri v2, що використовує WebKit2GTK на Linux. Потрібно встановити пакет libwebkit2gtk-4.1. Підтримуються Ubuntu 22.04+, Fedora 38+ та інші дистрибутиви з еквівалентною версією WebKit2GTK.

Вимоги до клієнтського ПК

Кожен клієнтський ПК для відвідувачів запускає HandyCafe Client, що підключається до сервера через локальну мережу.

Компонент	Мінімальні	Рекомендовані
ОС	Windows 10+ (64-біт), macOS 12 Monterey+, або Linux (64-біт)	Windows 10/11 (64-біт), macOS 12+, або Linux (64-біт)
Процесор	Двоядерний 1.5 ГГц	Чотириядерний 2.0 ГГц+
ОЗП	2 ГБ	4 ГБ+
Диск	200 МБ	500 МБ+
Мережа	100 Мбіт/с Ethernet	Гігабітний Ethernet

Примітка: Це вимоги лише для HandyCafe Client. Вашим ПК потрібні додаткові ресурси для ігор та додатків, що використовуються клієнтами.

Мережеві вимоги

Усі ПК (сервер та клієнти) мають бути в одній локальній мережі (LAN).

Необхідні порти

Порт	Протокол	Напрямок	Призначення
5001	TCP	Сервер: вхідний, Клієнт: вихідний	Команди та відповіді
5002	TCP	Двонаправлений	Передача файлів
5003	TCP	Сервер: вхідний, Клієнт: вихідний	Канал управління віддаленим доступом
5004	UDP	Двонаправлений	Потокове передавання екрану (віддалений робочий стіл)

Важливо: Це порти за замовчуванням. Їх можна змінити в Мережевих налаштуваннях. При зміні на сервері оновіть конфігурацію клієнтів.

Конфігурація брандмауера

Брандмауер Windows: HandyCafe намагається додати правила автоматично при встановленні. При невдачі додайте вхідні правила для вказаних портів вручну.
Брандмауер macOS: Відкрийте Системні налаштування > Мережа > Брандмауер та дозвольте вхідні з'єднання для HandyCafe.
Linux (iptables / ufw): При використанні ufw виконайте sudo ufw allow 5001:5004/tcp та sudo ufw allow 5004/udp.
Сторонні брандмауери: Додайте виняток для серверного бінарника HandyCafe на серверному ПК та клієнтського бінарника на клієнтських ПК.
Маршрутизатор/Комутатор: Для роботи лише в локальній мережі спеціальна конфігурація не потрібна. При наявності VLAN переконайтеся, що сервер та клієнти в одному VLAN.

Виявлення клієнтів

HandyCafe використовує mDNS для автоматичного виявлення клієнтів у локальній мережі. Потрібно:

Усі ПК в одній підмережі
Мультікастовий трафік не заблокований
Якщо mDNS не працює (наприклад, між підмережами), клієнти можуть підключитися, ввівши IP сервера вручну

Пропускна здатність

Функція	Приблизна пропускна здатність
Звичайна робота (на клієнта)	< 1 Кбіт/с
Потокове передавання віддаленого робочого стола	350 - 25 000 Кбіт/с (налаштовуване)
Синхронізація файлів	Обмежена швидкістю мережі
Захоплення знімка екрана	~100 КБ на знімок

Для типового кафе з 20-50 ПК достатньо стандартної мережі 100 Мбіт/с. Гігабітний Ethernet рекомендується при частому одночасному використанні віддаленого робочого стола для кількох ПК.

Вимоги до консолей

При управлінні ігровими консолями (PlayStation, Xbox тощо) консолі мають бути в одній мережі з сервером. Кожна консоль ідентифікується за MAC-адресою та реєструється вручну в Налаштуваннях консолей.