799953468/cloudreve-mac
网络与通讯把 Cloudreve 站点文件夹双向同步到 Mac 本地,让文件可直接在 Finder 和离线状态下使用,无需 WebDAV。
项目介绍
Cloudreve Mac 是面向 Cloudreve 站点的非官方 macOS 桌面客户端。它把站点上的某个文件夹与 Mac 本地文件夹配对,文件出现在 Finder 中,并且可以离线打开,不需要 WebDAV 或挂载网络驱动器。主要能力包括文件与空文件夹的双向同步、多个盘符各自独立的本地目录和忽略规则、菜单栏传输面板,以及在后端支持时按分块续传 README。桌面端用 C# + Avalonia 编写,仓库里另有独立的本地目录工具 Cloudreve.Sync,桌面应用本身不调用它 桌面应用源码。
安装并连接盘符
客户端要求 Cloudreve 站点版本 4.12.0 或更高。打包版本在 Releases 页面提供 Cloudreve-osx-arm64.zip(Apple Silicon)或 Cloudreve-osx-x64.zip(Intel),解压后打开 Cloudreve.app 即可,包内自带 .NET 运行时。
从源码构建时,先安装 .NET 11 SDK 和 Xcode 命令行工具(xcode-select --install),然后执行:
git clone https://github.com/799953468/cloudreve-mac.git
cd cloudreve-mac
rid=osx-arm64 # Intel Mac 请改为 osx-x64。
dotnet publish src/Cloudreve.Desktop -c Release -r "$rid" \
--self-contained true -p:MacBundle=true
open "artifacts/$rid/Cloudreve.app"
打开应用后进入 Add Drive,填写站点根地址(如 https://drive.example.com),点 Connect,在浏览器里登录并授权要同步的远程文件夹,再回到应用给盘符命名、选择一个空的本地文件夹并完成设置。第一次同步随即开始,可通过菜单栏图标查看进度;应用不会索要站点密码 连接指南。
同步规则
- 两侧同时修改同一文件会报冲突,保留两份副本,需要手动处理。
- 站点端删除或替换文件时,旧的本地副本会保留在配对目录下的
.cloudreve-recovery/中,按Command+Shift+.可在 Finder 里看到。 - 从设置中移除盘符会停止同步,本地和远端文件都保留,也不会撤销站点上的授权。
- 在 Finder 里删除已同步文件并不能释放本地空间:应用会同时请求把远端未改动的副本移入站点回收站 同步行为。
使用约束
- Finder 中显示的是完整本地副本,不是按需占位文件,因此配对的远程文件夹必须能放进 Mac 磁盘。
- 不支持整目录的重命名和移动;单个文件在可识别的情况下会直接应用移动而不重新上传。
~/Library/Application Support/Cloudreve/下的会话文件以明文保存 access token 和 refresh token,没有放进 Keychain,同用户的其他程序可以读取;反馈问题时不要分享drives.json和folder-pairs传输缓存 README。- 项目自行构建的版本为临时签名,未经 Apple 公证。
- 仓库目前没有覆盖整个项目的许可证;第三方图标、上游翻译和 Roboto 字体分别带有各自的授权说明 README。
测试与贡献
在仓库根目录运行 dotnet test --solution CloudreveMac.slnx -c Release 可跑测试,测试使用临时目录和模拟的服务端响应,不连接真实 Cloudreve 账号 测试目录。CI 通过 测试工作流运行 Release 测试套件,并在打标签或手动触发时用 发布工作流打包两种 Mac 架构。
HotRepo 点评
这是一个单人维护的小项目。HotRepo 只有 2026-11-21 的一条快照:项目当天出现在新项目榜记录中,首个统计窗口内获得 107 星、0 fork,GitHub 全部语言日榜没有名次记录。README 对冲突处理、恢复目录和令牌存储写得比较具体,读者可以据此判断客户端的行为;现有记录无法说明采用率或发布成熟度。安装说明只在 Releases 有包时才引导下载,因此选择下载版还是源码构建前,应先确认该页面是否有对应架构的压缩包。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。