文件同步

文件同步将文件从HandyCafe服务器分发到网络中的客户端PC。使用它可以推送游戏更新、配置文件、软件安装程序和客户端菜单资源，而无需访问每台机器。

它使用基于清单的方法，因此只有更改或新增的文件会通过网络传输，从而保持重复同步的速度。

该页面位于 设置 > 文件同步。

启用客户端同步

页面右上角的切换按钮控制整个功能。当启用客户端同步关闭时，页面会报告客户端同步已暂停，发布和删除操作均被阻止。在发布任何内容之前，请先打开它。

发布同步源

发布同步源部分是创建同步的地方。它需要两个值：

目标路径必须在客户端机器上有效，而不是在服务器上。如果您的客户端将游戏保存在D:盘，而您输入了C:盘路径，同步将落在错误的位置。

一旦两个字段都填写完毕，选择发布同步。内容将直接从源路径提供给客户端。服务器不保留第二份副本。

同步如何工作

基于清单的比较

同步开始时，服务器生成一个文件清单：要同步的每个文件的列表及其校验和。每个客户端将此清单与其本地文件进行比较。

• 客户端上不存在的文件将被标记为下载。
• 校验和不同的文件（即已修改的文件）将被标记为下载。
• 匹配的文件将被完全跳过。

只有服务器和客户端之间的差异会被传输，这使得重复同步速度很快。

基于分块的传输

大文件在通过TCP传输时被分割成较小的块：

• 可靠性。 如果一个块传输失败，只会重试该块而不是整个文件。
• 进度跟踪。 传输进度在块级别报告。
• 网络效率。 块大小针对典型的局域网条件进行了调整。

传输使用来自网络设置的专用文件端口，默认是5002。如果该端口被防火墙阻止，文件将无法到达客户端。

已同步文件夹

已同步文件夹列表显示每个目标路径的一行，每行都有其最近发布的版本。一行报告发布次数、文件数量和总大小。使用刷新重新加载列表。

选择一行以在右侧打开其详细信息。详细信息面板列出该源中的每个条目及其路径、类型（文件或目录）、大小和校验和，以及源根路径、目标路径和发布时间。搜索框按相对或目标路径过滤条目。

删除同步

存在两种不同的删除操作。它们的作用不同：

• 移除已同步文件夹将目标路径从同步列表中移除。服务器上的源文件不受影响。
• 删除条目从服务器上的原始源路径中移除一个项目。这是永久性的，并且也会推送到客户端。HandyCafe会先请求确认。

两种操作都需要启用客户端同步处于开启状态。

使用场景

• 部署游戏更新。 一次性将游戏补丁推送到所有游戏PC，以便每台机器运行相同版本。
• 推送配置文件。 在所有客户端上分发更新的网络设置或应用程序偏好。
• 分发软件。 通过同步安装包或便携式应用程序在客户端PC上安装应用程序。
• 更新客户端菜单资源。 同步客户端菜单使用的新图标、海报或媒体文件。

提示

• 在非高峰时段安排大型同步，以免活跃会话争夺带宽。
• 在发布之前仔细检查目标路径。这是同步看似成功但客户端上没有显示的最常见原因。
• 服务器和客户端必须在同一局域网内。

相关页面

• 网络设置用于文件端口配置。
• 客户端菜单用于您可能想要分发的资产。
• 设置概览了解此页面的位置。