HandyCafe Docs
it-admin

Начало работы: IT-администратор

Это руководство охватывает техническую настройку HandyCafe. По завершении у вас будут установлены сервер и клиенты, настроена сеть, созданы меню приложений и протестировано удаленное управление.

Время на изучение: 5 минут (плюс время на развертывание клиентов)

Шаг 1: Установите сервер и клиенты

Установка сервера:

  1. Убедитесь, что ваш серверный ПК соответствует системным требованиям.
  2. Загрузите и установите HandyCafe Server на управляющий ПК.
  3. Запустите сервер и пройдите мастер первоначальной настройки для создания аккаунта администратора.
  4. Запишите локальный IP-адрес серверного ПК. Клиентам потребуется этот адрес для подключения.

Установка клиента (повторите для каждого ПК):

  1. Загрузите HandyCafe Client на каждый пользовательский ПК.
  2. Установите и запустите клиент.
  3. Клиент ищет сервер в локальной сети с помощью обнаружения mDNS.
  4. Если сервер не обнаружен автоматически, введите IP-адрес сервера вручную в настройках клиента.
  5. После подключения клиент появляется в панели администрирования сервера.

Совет: Используйте функцию автоименования сервера (Настройки > Клиенты) для автоматического присвоения имен клиентам с префиксом типа "ПК #1", "ПК #2" и т.д. Отображаемые имена можно изменить позже.

Подробнее см. Установка сервера и Установка клиента.

Шаг 2: Настройте сетевые параметры

Перейдите в Настройки > Сеть на сервере.

HandyCafe использует четыре порта для связи:

Порт По умолчанию Назначение
TCP-порт 5001 Обмен командами и ответами
Порт файлов 5002 Передача файлов между сервером и клиентами
Порт удаленного управления 5003 Управление трансляцией удаленного рабочего стола
UDP-порт 5004 Данные трансляции экрана

Конфигурация:

  1. Задайте порты (значения по умолчанию подходят для большинства конфигураций).
  2. Задайте ключ подключения. Это общий секрет для аутентификации HMAC-SHA256. Все клиенты должны использовать тот же ключ.
  3. Нажмите Сохранить.

Правила файрвола:

Убедитесь, что эти порты открыты на серверном и клиентских ПК:

  • TCP: 5001, 5002, 5003 (входящие на сервере, исходящие на клиентах)
  • UDP: 5004 (двусторонний для трансляции экрана)

Важно: Все ПК должны находиться в одной локальной сети (подсети). HandyCafe использует mDNS для обнаружения клиентов, что требует подключения к локальной сети.

Подробнее см. Сетевые настройки.

Шаг 3: Настройте меню клиента

Меню клиента - лаунчер приложений, который клиенты видят на рабочем столе. Перейдите в Настройки > Клиенты > вкладка "Контент".

  1. Создайте категории. Сгруппируйте приложения по типу (например, Игры, Браузеры, Социальные сети, Инструменты).
  2. Добавьте приложения в каждую категорию:
    • Задайте название и описание приложения.
    • Выберите тип: Игра, Браузер, Ссылка, Файл или Приложение.
    • Задайте путь к исполняемому файлу или URI запуска.
    • Загрузите иконку и при необходимости изображение постера для карточки приложения.
  3. Измените порядок категорий и приложений с помощью перетаскивания.
  4. Переключайте видимость для показа или скрытия элементов.
  5. Нажмите Сохранить.

Изменения автоматически передаются всем подключенным клиентам в реальном времени через TCP.

Совет: Используйте интеграцию с IGDB для автоматического поиска метаданных игр и иконок.

Подробнее см. Меню клиента.

Шаг 4: Настройте экран ожидания и внешний вид

Экран ожидания (Настройки > Клиенты > вкладка "Экран ожидания"):

Экран ожидания - то, что клиенты видят, когда сессия не активна (экран блокировки).

  1. Включите слайд-шоу экрана ожидания.
  2. Добавьте изображения или видео (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Задайте длительность для каждого элемента и эффект перехода (затухание, сдвиг, масштаб).
  4. При необходимости включите наложение часов и отображение названия кафе с настраиваемыми цветами.
  5. Нажмите Сохранить.

Внешний вид (Настройки > Клиенты > вкладка "Внешний вид"):

Настройка оформления рабочего стола, который клиенты используют во время сессий.

  1. Выберите тему: Neon Arena, Crimson Pulse или Emerald Depth.
  2. Выберите предустановку раскладки: Split Classic, Hero Wide Top, Catalog Wide Bottom или Compact Focus.
  3. Настройте фон: сплошной цвет, градиент, изображение или видео с наложением и размытием.
  4. Настройте плотность карточек (Крупные, Средние, Компактные) и эффекты наведения.
  5. Нажмите Сохранить.

Подробнее см. Экран ожидания клиента и Внешний вид клиента.

Шаг 5: Протестируйте удаленный рабочий стол и снимки экрана

Проверьте работу удаленного управления:

Снимки экрана:

  1. В панели администрирования выберите любую карточку подключенного клиента.
  2. Нажмите Снимок экрана на карточке клиента.
  3. Снимок экрана клиента появляется в просмотрщике.
  4. Вы можете загрузить или обновить снимок.

Удаленный рабочий стол:

  1. Выберите карточку подключенного клиента и нажмите Удаленный рабочий стол.
  2. Открывается окно удаленного рабочего стола с потоковым видео H.264 в реальном времени.
  3. Вы можете управлять мышью и клавиатурой на удаленном ПК.
  4. Синхронизация буфера обмена работает между сервером и клиентом.

Примечание: Удаленный рабочий стол использует UDP-трансляцию. При задержках видео проверьте пропускную способность сети и убедитесь, что UDP-порт 5004 не заблокирован. Также можно настроить битрейт в параметрах трансляции (350-25000 кбит/с).

Подробнее см. Удаленный рабочий стол и Снимки экрана.

Обзор сетевой архитектуры

Серверный ПК (Управляющий)
    |
    |--- TCP (5001) --- Команды/Ответы (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Передача файлов
    |--- TCP (5003) --- Управление удаленным доступом
    |--- UDP (5004) --- Трансляция экрана (H.264)
    |--- mDNS ------- Обнаружение клиентов (автоматическое)
    |
    +-- Клиентский ПК 1
    +-- Клиентский ПК 2
    +-- Клиентский ПК 3
    +-- ...

Что делать дальше