HandyCafe Docs
owner it-admin

Системные требования

Перед установкой 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. Для iptables добавьте эквивалентные правила INPUT ACCEPT для TCP-портов 5001-5003 и UDP-порта 5004.
  • Сторонние файрволы: добавьте исключения для бинарного файла HandyCafe Server на серверном ПК и HandyCafe Client на клиентских ПК.
  • Маршрутизатор/Коммутатор: для работы только в LAN специальная настройка не требуется. При наличии VLAN убедитесь, что сервер и все клиенты находятся в одном VLAN или маршрутизация разрешает нужные порты.

Обнаружение клиентов

HandyCafe использует mDNS (multicast DNS) для автоматического обнаружения клиентов в локальной сети. Для этого необходимо:

  • Все ПК в одной подсети
  • Multicast-трафик не блокируется коммутаторами или маршрутизаторами
  • Если mDNS не работает (например, между подсетями), клиенты могут подключиться вводом IP-адреса сервера вручную

Требования к пропускной способности

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

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

Требования к консолям

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