HandyCafe Docs
it-admin

Синхронизация файлов

Синхронизация файлов распределяет файлы с сервера HandyCafe на клиентские ПК по сети. Используйте ее для отправки обновлений игр, конфигурационных файлов, установщиков программ и элементов меню клиентов без необходимости посещать каждую машину.

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

Страница находится в Настройки > Синхронизация файлов.

Включение синхронизации клиентов

Переключатель в правом верхнем углу страницы управляет всей функцией. Пока Включить синхронизацию клиентов выключено, страница сообщает, что синхронизация клиентов приостановлена, и действия публикации и удаления заблокированы. Включите его перед публикацией.

Публикация источника синхронизации

Раздел Публикация источника синхронизации это место, где создается синхронизация. Он требует два значения:

Поле Что это
Путь к источнику Файл или папка на сервере, которые вы хотите распределить. Используйте Выбрать файл или Выбрать папку для выбора, или введите путь напрямую.
Целевой путь на клиентах Абсолютный путь, куда контент должен быть доставлен на каждом клиенте. Это обязательное поле. Пример: C:\Games\SteamLibrary\common\Game или /opt/apps/game.

Целевой путь должен быть действительным на клиентских машинах, а не на сервере. Если ваши клиенты хранят игры на D:, а вы вводите путь C:, синхронизация попадет не туда.

Выберите Публиковать синхронизацию, когда оба поля заполнены. Контент передается клиентам напрямую из пути источника. Сервер не хранит вторую копию.

Как работает синхронизация

Сравнение на основе манифеста

Когда начинается синхронизация, сервер генерирует манифест файлов: список всех файлов для синхронизации вместе с их контрольными суммами. Каждый клиент сравнивает этот манифест со своими локальными файлами.

  • Файлы, которых нет на клиенте, помечаются для загрузки.
  • Файлы, чьи контрольные суммы отличаются (то есть они были изменены), помечаются для загрузки.
  • Файлы, которые совпадают, полностью пропускаются.

Передается только дельта между сервером и клиентом, что делает повторные синхронизации быстрыми.

Передача на основе чанков

Большие файлы разбиваются на меньшие чанки для передачи по TCP:

  • Надежность. Если чанк не удается передать, повторяется только этот чанк, а не весь файл.
  • Отслеживание прогресса. Прогресс передачи сообщается на уровне чанков.
  • Эффективность сети. Размеры чанков настроены для типичных условий LAN.

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

Синхронизированные папки

Список Синхронизированные папки показывает одну строку на каждый целевой путь, каждую с ее последним опубликованным выпуском. Строка сообщает количество выпусков, количество файлов и общий размер. Используйте Обновить, чтобы перезагрузить список.

Выберите строку, чтобы открыть ее детали справа. Панель деталей перечисляет каждую запись в этом источнике с ее путем, типом (файл или директория), размером и контрольной суммой, а также корневым путем источника, целевым путем и временем публикации. Поле поиска фильтрует записи по относительному или целевому пути.

Удаление синхронизации

Существуют два разных действия удаления. Они делают разные вещи:

  • Удалить синхронизированную папку убирает целевой путь из списка синхронизации. Ваши исходные файлы на сервере не затрагиваются.
  • Удалить запись удаляет элемент из исходного пути на сервере. Это действие необратимо и также передается клиентам. HandyCafe сначала запрашивает подтверждение.

Оба действия требуют, чтобы Включить синхронизацию клиентов было включено.

Примеры использования

  • Развертывание обновлений игр. Отправляйте патчи игр на все игровые ПК одновременно, чтобы каждая машина работала на одной версии.
  • Отправка конфигурационных файлов. Распространяйте обновленные сетевые настройки или предпочтения приложений на всех клиентов.
  • Распределение программного обеспечения. Устанавливайте приложения на клиентские ПК, синхронизируя установочные пакеты или портативные приложения.
  • Обновление элементов меню клиентов. Синхронизируйте новые иконки, постеры или медиафайлы, используемые в меню клиентов.

Советы

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

Связанные страницы