一个轻量级 macOS 菜单栏应用，使用 rclone bisync 在后台双向同步任意云存储。
A lightweight macOS menu bar app for bidirectional cloud sync powered by rclone.
| Provider | Type | Setup |
|---|---|---|
| OneDrive (个人版 / 商业版) | OAuth | 浏览器自动授权 |
| Google Drive | OAuth | 浏览器自动授权 |
| Dropbox | OAuth | 浏览器自动授权 |
| Amazon S3 (及 MinIO, 阿里云 OSS 等) | Key | Access Key + Secret |
| WebDAV (Nextcloud, ownCloud, 坚果云) | Password | URL + 用户名密码 |
| SFTP (任何 SSH 服务器) | SSH | 主机 + 用户名 |
| 70+ 其他服务 | 各异 | 通过 rclone config |
- 🔄 双向同步 — 基于
rclone bisync，本地和云端双向实时同步 - ☁️ 多云存储 — 同时同步多个云存储（OneDrive + Google Drive + ...），独立状态跟踪
- 📊 实时状态 — 菜单栏常驻图标，每个云存储独立显示同步状态和下次同步倒计时
- 📡 分别控制 — 对单个或全部云存储执行立即同步、预览同步、清除缓存
- 📋 同步规则 — 为不同子目录指定同步到哪些云存储（如 Documents → OneDrive, Photos → Google Drive）
- ⏰ 定时自动同步 — 可自定义间隔（5 分钟 ~ 2 小时），多 remote 自动交错避免并发
- 🛡️ 安全保护 — 单次同步最大删除文件数限制，防止误删
- ⚔️ 冲突策略可配 — 以较新/较旧/较大/本地/远程文件为准
- 🌐 代理支持 — SOCKS5 代理，可在 UI 中设置
- 🔒 进程管理 — PID 追踪、锁文件互斥、进程树清理，杜绝重复同步
- 🔐 一键设置 — 自动安装 rclone、交互式云存储授权
- 🚀 开机自启 — 通过
SMAppService注册为登录项，重启后自动运行 - 🏗️ 源码分发 — 在用户机器上编译，无需签名证书
- macOS 14.0+ (Sonoma 或更高)
- Homebrew（推荐，用于安装 rclone）
git clone https://github.com/havvk/rclone-sync-mac.git
cd rclone-sync-mac
./install.sh安装脚本会自动完成以下步骤：
- ✅ 检查/安装 rclone
- ✅ 交互式选择云存储服务，引导授权
- ✅ 创建本地同步目录
- ✅ 检查/安装 Xcode Command Line Tools
- ✅ 编译 SwiftUI 菜单栏应用
- ✅ 安装到
/Applications/AIIA-RcloneSync.app - ✅ 配置 launchd 定时任务（默认每 30 分钟同步一次）
- ✅ 注册为登录项（开机自动启动菜单栏应用）
- ✅ 启动菜单栏应用
首次使用：安装后点击菜单栏图标 → 「🔄 重新初始化同步」→「先预览」确认同步内容。
./uninstall.sh # 卸载（保留数据和日志）
./uninstall.sh --purge # 卸载并删除所有数据编辑 config.env 或通过菜单栏应用的 ⚙️ 设置 菜单直接修改：
| 参数 | 默认值 | 说明 |
|---|---|---|
LOCAL_PATH |
$HOME/OneDrive |
本地同步目录 |
REMOTES |
onedrive: |
要同步的 remote（空格分隔，支持多个） |
SYNC_INTERVAL |
1800 |
同步间隔（秒） |
CONFLICT_RESOLVE |
newer |
冲突策略 |
MAX_DELETE_PCT |
50 |
单次同步最大删除文件数（超过则中止） |
SOCKS5_PROXY |
(空) | SOCKS5 代理地址 |
在 config.env 中设置多个 remote（空格分隔）：
REMOTES="onedrive: gdrive:" # 同时同步 OneDrive 和 Google Drive
LOCAL_PATH="$HOME/OneDrive" # 所有 remote 共享同一个本地目录也可以在菜单栏应用的 ☁️ 云存储 菜单中勾选/取消勾选来启用或禁用特定 remote。
多云存储时，可以通过菜单栏的 📋 同步规则 为不同子目录指定同步到哪些云存储：
| 路径模式 | 同步到 |
|---|---|
Documents/ |
仅 OneDrive |
Photos/ |
仅 Google Drive |
Projects/ |
OneDrive + Google Drive |
未配置规则的目录默认同步到所有已启用的云存储。
默认排除 .git/、node_modules/、__pycache__/、.DS_Store 等不需要同步的目录和文件。可根据需要编辑。
./sync.sh # 同步所有已配置的 remote
./sync.sh --remote=onedrive: # 同步指定 remote
./sync.sh --dry-run # 预览模式（不实际传输）
./sync.sh --resync # 重新初始化基准线
./sync.sh --force # 忽略 max-delete 保护
./sync.sh --remote=gdrive: --dry-run # 组合使用┌──────────────────────────────────────────┐
│ AIIA-RcloneSync.app (SwiftUI) │
│ ┌─────────┐ ┌────────┐ ┌──────────┐ │
│ │状态监控 │ │菜单控制 │ │设置管理 │ │
│ │(per- │ │(per- │ │(config + │ │
│ │ remote) │ │ remote)│ │ rules) │ │
│ └────┬────┘ └───┬────┘ └────┬─────┘ │
│ ▼ ▼ ▼ │
│ status-*.json sync.sh config.env │
└───────────────────┬──────────────────────┘
│
┌───────▼───────┐
│ sync.sh │
│ (锁文件/日志) │
│ (PID 追踪) │
└───────┬───────┘
│ per-remote 并发
┌───────▼───────┐
│ rclone bisync │◄── filters.txt
└──┬─────────┬──┘ sync_rules.json
│ │
┌─────▼──┐ ┌───▼──────┐
│ 本地 │ │ 云存储 ×N │
│ 目录 │ │ (remotes)│
└────────┘ └──────────┘
⏰ 内置定时器 → 交错触发各 remote 的 sync.sh
rclone-sync-mac/
├── README.md
├── LICENSE # MIT
├── .gitignore
├── config.env # 用户配置
├── filters.txt # rclone 过滤规则
├── sync.sh # 核心同步引擎
├── setup.sh # 环境初始化（安装 rclone + 授权云存储）
├── install.sh # 一键安装
├── uninstall.sh # 卸载脚本
├── com.rclone.sync-mac.plist # launchd 定时任务
└── StatusBarApp/
├── AIIARcloneSyncApp.swift # SwiftUI 菜单栏应用源码
├── AppIcon.icns # 应用图标
└── AppIcon.png # 应用图标 (PNG)
首次同步报错怎么办？
首次同步需要建立基准线。点击菜单栏 → 「🔄 重新初始化同步」→「直接执行」。
为什么不需要 Apple 签名证书？
应用在用户本机通过 swiftc 编译，macOS 自动信任本地编译的二进制文件。
如何在新电脑上使用？
克隆仓库后运行 ./install.sh，脚本会引导完成 rclone 安装和云存储授权。也可以在应用内点击「🛠️ 配置云存储连接」。
同步冲突如何处理？
默认以较新的文件为准。被覆盖的文件会带编号后缀保留（如 file.conflict1.txt）。可在设置中修改策略。
支持 OneDrive 商业版 / SharePoint 吗？
支持。在 setup.sh 授权时选择 OneDrive，登录商业账号即可，rclone 会自动识别驱动器类型。
多云存储同步时会不会冲突？
每个 remote 使用独立的锁文件和状态跟踪，不同 remote 的同步互不影响。定时器自动交错触发，避免同时进行大量同步。可通过同步规则进一步控制哪些目录同步到哪些云存储。
清除缓存和重新初始化有什么区别？
- 🧹 清除缓存：仅删除 bisync 缓存文件，下次同步时自动 resync。适合日常维护。
- 🔄 重新初始化同步：清除缓存 + 立即执行 resync。适合首次使用或同步严重异常时。
- rclone — 强大的云同步工具，支持 70+ 种存储服务