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-25 000 кбіт/с).

Детальніше у розділах Віддалений робочий стіл та Знімки екрана.

Огляд мережевої архітектури

Серверний ПК (Управління)
    |
    |--- TCP (5001) --- Команди/Відповіді (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Передача файлів
    |--- TCP (5003) --- Управління віддаленим доступом
    |--- UDP (5004) --- Потокове передавання екрану (H.264)
    |--- mDNS ------- Виявлення клієнтів (автоматичне)
    |
    +-- Клієнтський ПК 1
    +-- Клієнтський ПК 2
    +-- Клієнтський ПК 3
    +-- ...

Наступні кроки