rclone 是一个跨平台命令行工具,可以把常见网盘(OneDrive、Google Drive、Dropbox 等)当作“远程磁盘”来管理:上传/下载、双向整理、做增量备份,甚至挂载成系统里的一个盘符/目录。
本教程以 OneDrive / Google Drive 为例,目标是:安装 → 授权 → 挂载/同步 → 自动化 → 故障排查,全程可照做。
Windows
1)访问 rclone 官网下载 Windows 版本(zip)。
2)解压后将 rclone.exe 放到固定目录(例如 C:\Tools\rclone\)。
3)把该目录加入系统 PATH(环境变量),重新打开终端后执行:rclone version 确认可用。
macOS
推荐用 Homebrew:brew install rclone,安装后执行 rclone version。
Linux
多数发行版可用包管理器安装,或用官网脚本安装。安装后同样用 rclone version 验证。
1)运行:rclone config,选择 n 新建一个 remote。
2)给 remote 起名(例如:onedrive 或 gdrive)。
3)在类型列表里选择对应网盘(OneDrive 或 Google Drive)。
4)大多数情况下直接回车使用默认配置;当出现“是否自动打开浏览器授权”时,选择自动授权(有图形界面环境更省事)。
5)浏览器登录网盘账号并授权,回到终端,看到配置完成提示。
6)用命令快速验证 remote 是否可用:rclone lsd onedrive: 或 rclone lsd gdrive:
先看区别:copy 只增不删;sync 会让目标与源保持一致(会删除目标多余文件),更适合“备份镜像”。
1)列出目录:rclone ls onedrive: 或 rclone ls onedrive:Documents
2)把本地文件夹复制到网盘:rclone copy "D:/Backup" onedrive:Backup --progress
3)做镜像同步(先 dry-run):rclone sync "D:/Backup" onedrive:Backup --dry-run --progress
4)确认无误后去掉 --dry-run 再执行一次。
实用参数:--transfers 8(并发)、--checkers 16(校验并发)、--exclude/--include(过滤规则)。
重要提示:挂载更适合日常浏览与轻量操作;大量写入/频繁小文件读写时,建议优先用 sync/copy 做批量同步,速度更稳。
Windows(盘符挂载)
1)先准备一个空盘符(例如 X:)。
2)执行示例:rclone mount onedrive: X: --vfs-cache-mode writes --dir-cache-time 72h --poll-interval 1m
3)保持窗口运行;需要后台运行可用计划任务/服务工具(见下一节)。
macOS / Linux(目录挂载)
1)创建挂载点目录:例如 ~/mnt/onedrive
2)执行:rclone mount onedrive: ~/mnt/onedrive --vfs-cache-mode writes
3)macOS 某些场景需要安装 macFUSE;Linux 需要 fuse3(不同发行版包名略有差异)。
Windows 任务计划程序
1)新建基本任务 → 触发器选“每天” → 操作为“启动程序”。
2)程序填写 rclone.exe 的完整路径;参数示例:sync "D:/Backup" onedrive:Backup --log-file "D:/rclone/rclone.log" --log-level INFO
3)建议先手动运行一次确认无报错,再开启定时。
macOS/Linux(cron)
用 crontab 定时执行 rclone sync,并把日志输出到文件,出问题更好定位。
1)授权失败/401/403:多数是账号未完成授权或 token 过期。重新执行 rclone config,编辑该 remote 重新授权。
2)同步很慢:先确认网络与网盘限速;适当提高 --transfers,并避免同时跑多个同步任务。
3)挂载后写入报错/文件变 0KB:检查是否加了 --vfs-cache-mode writes;大量写入更建议用 sync/copy 方式。
4)路径/文件名问题:某些平台对特殊字符或路径长度有限制,先尝试在本地规范命名,再同步到网盘。
5)空间不足/配额提示:这是网盘端限制,需清理空间或更换存储策略(不要尝试任何违规绕过)。
1)先 rclone config 配好 remote(onedrive/gdrive)。
2)用 rclone sync 本地目录 remote:目标目录 --dry-run 检查变更。
3)确认无误后去掉 --dry-run 正式同步。
4)把命令放进任务计划/cron,每天跑一次,并保留日志。