파일 동기화

파일 동기화는 HandyCafe 서버에서 네트워크의 클라이언트 PC로 파일을 배포합니다. 게임 업데이트, 설정 파일, 소프트웨어 설치 프로그램 및 클라이언트 메뉴 자산을 각 기기를 방문하지 않고도 푸시할 수 있습니다.

매니페스트 기반 접근 방식을 사용하여 변경되거나 새로운 파일만 전송되므로 반복 동기화가 빠르게 진행됩니다.

이 페이지는 설정 > 파일 동기화에 있습니다.

클라이언트 동기화 활성화

페이지 오른쪽 상단의 토글로 전체 기능을 제어합니다. 클라이언트 동기화 활성화가 꺼져 있으면 페이지는 클라이언트 동기화가 일시 중지되었다고 보고하며, 게시 및 삭제 작업이 차단됩니다. 게시하기 전에 켜십시오.

동기화 소스 게시 섹션에서 동기화를 생성합니다. 두 가지 값을 입력해야 합니다:

필드	설명
소스 경로	배포하려는 서버의 파일 또는 폴더입니다. 파일 선택 또는 폴더 선택을 사용하여 선택하거나 경로를 직접 입력하세요.
클라이언트의 대상 경로	콘텐츠가 각 클라이언트에 도착해야 하는 절대 경로입니다. 필수 항목입니다. 예: `C:\Games\SteamLibrary\common\Game` 또는 `/opt/apps/game`.

대상 경로는 서버가 아닌 클라이언트 기기에서 유효해야 합니다. 클라이언트가 D:에 게임을 저장하고 C: 경로를 입력하면 동기화가 잘못된 위치에 도착합니다.

두 필드를 모두 채운 후 동기화 게시를 선택하세요. 콘텐츠는 소스 경로에서 직접 클라이언트로 제공됩니다. 서버는 두 번째 복사본을 보관하지 않습니다.

동기화가 시작되면 서버는 파일 매니페스트를 생성합니다: 동기화할 모든 파일 목록과 그 체크섬입니다. 각 클라이언트는 이 매니페스트를 자신의 로컬 파일과 비교합니다.

서버와 클라이언트 간의 델타만 전송되므로 반복 동기화가 빠릅니다.

큰 파일은 TCP를 통해 전송하기 위해 작은 청크로 나뉩니다:

전송은 네트워크 설정의 전용 파일 포트를 사용하며, 기본값은 5002입니다. 해당 포트가 방화벽에 의해 차단되면 파일이 클라이언트에 도달하지 않습니다.

동기화된 폴더 목록은 각 대상 경로에 대해 하나의 행을 표시하며, 각 행에는 가장 최근에 게시된 릴리스가 포함됩니다. 행은 릴리스 수, 파일 수 및 총 크기를 보고합니다. 새로 고침을 사용하여 목록을 다시 로드하세요.

행을 선택하면 오른쪽에 세부 정보가 열립니다. 세부 정보 패널은 소스의 각 항목을 경로, 종류(파일 또는 디렉토리), 크기 및 체크섬과 함께 소스 루트 경로, 대상 경로 및 게시 시간과 함께 나열합니다. 검색 상자는 상대 경로나 대상 경로로 항목을 필터링합니다.

두 가지 다른 삭제 작업이 있습니다. 각각 다른 작업을 수행합니다:

동기화된 폴더 제거는 대상 경로를 동기화 목록에서 제거합니다. 서버의 소스 파일은 변경되지 않습니다.
항목 삭제는 서버의 원본 경로에서 항목을 제거합니다. 이는 영구적이며 클라이언트에도 푸시됩니다. HandyCafe는 먼저 확인을 요청합니다.

두 작업 모두 클라이언트 동기화 활성화가 켜져 있어야 합니다.

대규모 동기화는 비혼잡 시간대에 예약하여 활성 세션이 대역폭을 경쟁하지 않도록 합니다.
게시하기 전에 대상 경로를 두 번 확인하세요. 이는 동기화가 성공한 것처럼 보이지만 클라이언트에 아무것도 나타나지 않는 가장 일반적인 원인입니다.
서버와 클라이언트는 동일한 LAN에 있어야 합니다.