第29章 Cloudreve 桌面同步客户端详解
第29章：桌面同步客户端
Cloudreve 为 Windows 提供了官方桌面同步客户端，支持本地机器与 Cloudreve 服务器之间无缝的双向文件同步。
功能特点
实时双向同步：任一侧的更改会自动同步 按需文件访问：文件仅在访问时下载，节省本地存储空间 Windows 资源管理器集成：支持原生右键菜单、缩略图和状态指示器 多存储提供商支持：适用于 Cloudreve 服务器配置的所有存储策略
系统要求
Windows 10 版本 1903（build 18362）或更高版本 一个 Cloudreve Pro 服务器实例
下载
源代码：GitHub
占位文件
桌面客户端使用 Windows Cloud Files API 创建“占位文件”。这些文件在 Windows 资源管理器中看似普通文件，但其内容可能未存储在本地。这允许你浏览整个云端存储，而无需占用本地磁盘空间。
文件状态
占位文件有三种主要状态，在 Windows 资源管理器中通过状态图标表示：
仅在线：云图标。文件元数据在本地可用，但内容仍保留在服务器上。打开文件时会自动下载。 本地可用：绿色对勾。文件内容已下载并在本地可用。当存储空间不足时，系统可能自动移除本地内容以释放空间。 始终可用：带对勾的实心绿色圆圈。文件被固定为始终保留本地内容。系统不会自动移除本地内容。
管理文件状态
你可以右键点击文件来更改其状态：
释放空间：移除本地内容，仅保留占位符（变为仅在线状态） 始终保留在此设备上：固定文件，确保本地内容始终可用
文件同步
实时变更检测
正常运行时，桌面客户端通过服务器发送事件（Server-Sent Events, SSE）实时接收文件变更通知。当服务器上的文件被创建、修改、重命名或删除（通过 Web 界面、移动应用或其他客户端操作）时，你的本地视图会立即更新。
故障排除
如果实时更新未正常工作： 检查 Web 服务器（如 Nginx、Apache 等）是否已禁用 SSE 端点的缓冲 确保反向代理的超时设置足够长，以支持持久连接 验证 Cloudreve 服务器可正常访问且响应正常
强制同步
在极少数同步状态不一致的情况下（例如网络中断或系统崩溃后），你可以触发手动全量同步：
在 Windows 资源管理器中右键点击文件或文件夹 选择 Cloudreve > 立即同步
这将协调本地状态与服务器状态，解决任何差异。
冲突解决
当本地文件版本与云端发生冲突时，客户端会弹出通知询问如何解决冲突：
你可以右键点击冲突文件，选择 Cloudreve > 解决冲突 来重新打开冲突解决对话框。
与 WebDAV 的对比
虽然 Cloudreve 也支持 WebDAV 进行文件访问，但桌面同步客户端具有显著优势：
功能 | 桌面客户端 | WebDAV 系统要求 | Windows 10 1903+ | 任何支持 WebDAV 客户端的操作系统 按需文件 | 支持（占位文件） | 不支持（必须下载完整文件） 实时同步 | 支持（SSE 推送） | 不支持（需手动刷新） 上传方式 | 直接上传到存储提供商 | 必须通过 Cloudreve 服务器中继 分块上传 | 支持（并行分块） | 不支持（单一流） 大文件支持 | 优秀 | 受 WebDAV 客户端限制 离线访问 | 固定文件可离线访问 | 仅缓存文件 资源管理器集成 | 完整（状态图标、右键菜单） | 基础（挂载驱动器）
何时使用 WebDAV
WebDAV 在以下场景中仍然有用：
非 Windows 平台（macOS、Linux、移动端） 需要直接文件路径访问的应用程序 无需同步功能的简单文件访问
