macOS rclone 挂载网盘终极指南.md 8.9 KB


notion-id: 335ca4d7-cb7b-80f9-8ab7-d51ff9bc0d

一、 环境准备(核心驱动与权限)

由于 macOS 的安全机制,挂载磁盘需要安装底层驱动并放开系统限制。

  1. 安装 macFUSE:Bash brew install --cask macfuse
  2. 解锁内核扩展(M1/M2/M3/M4 芯片必做):
    • 关机 -> 长按电源键进入恢复模式 -> 启动安全性实用工具
    • 选择 降低安全性 -> 勾选 允许用户管理来自被认可开发者的内核扩展
  3. 系统授权:
    • 重启进入系统,在 系统设置 > 隐私与安全性 中,点击底部的 允许 (Benjamin Fleischer) 并再次重启。

二、 rclone 的正确安装与配置

注意: 请勿使用 brew install rclone(该版本在 Mac 上不支持 mount 挂载)。

  1. 安装官方全功能版: sudo -v ; curl https://rclone.org/install.sh | sudo bash
  2. 配置 WebDAV (连接 CD2):
    • 输入 rclone config,选 n 新建,起名 CD2
    • 类型选 webdav,URL 填 http://局域网IP:1167/dav
    • Vendor 选 other (8),输入 CD2 的用户名和密码。

三、 挂载命令:实现“看片不下载”

在桌面创建一个文件夹(如 ~/Desktop/CD2),然后执行以下经过深度优化的命令:

rclone mount CD2: ~/Desktop/CD2 \
--vfs-cache-mode writes \
--vfs-read-chunk-size 128M \
--vfs-read-chunk-size-limit off \
--vfs-read-ahead 128M \
--buffer-size 128M \
--vfs-cache-max-age 30m \
--vfs-cache-max-size 20G \
--dir-cache-time 24h \
--attr-timeout 24h \
--no-checksum \
--no-modtime \
--volname "CloudDrive" \
--low-level-retries 10 \
--daemon

🔹 参数详解 (核心精髓)

分类 参数 建议值 核心功能与收益
流媒体播放 --vfs-read-chunk-size 64M 秒开关键。按需读取分块大小,越大拖动越稳,越小首开越快。
--vfs-read-chunk-size-limit off 禁用分块翻倍逻辑,防止后台因为预读产生过大流量。
--vfs-read-ahead 128M 在当前播放位置提前预读,增加视频播放的“护城河”,防卡顿。
--buffer-size 32M 内存缓冲区大小。不占硬盘,仅在 RAM 中缓冲数据,提升丝滑度。
缓存与上传 --vfs-cache-mode writes RaiDrive 模式核心。读取不强制全量下载,但保证上传文件极其稳定。
--vfs-cache-max-age 30m 缓存过期时间。文件上传完或看片完后,多久自动删除本地临时文件。
--vfs-cache-max-size 20G 缓存总体积上限。防止网盘内容把你的 Mac 本地硬盘塞满。
Finder 响应 --dir-cache-time 24h 缓存文件夹列表的时间。开启后,再次进入同一个文件夹几乎瞬开。
--attr-timeout 24h 缓存文件属性(大小、日期等)的时间。减少 Finder 的“转圈圈”。
--no-modtime (无值) 不读取修改时间。大幅提升处理成千上万个文件时的响应速度。
稳定性与兼容 --no-checksum (无值) 跳过校验和检查。WebDAV 环境下上传大文件建议开启,防止报错。
--low-level-retries 10 底层重试次数。网络波动时自动重连,不至于让挂载直接断开。
系统集成 --volname "CloudDrive" 设置磁盘在 Mac 桌面上显示的名称(自定义你喜欢的名字)。
--daemon (无值) 后台运行。执行后终端可关闭,挂载进程依然在后台工作。

四、 如何卸载与管理

1. 正常卸载

直接在 Finder 里点击磁盘旁边的“弹出”按钮,或者在终端输入: Bash umount ~/Desktop/CD2

2. 强制停止 (如果磁盘卡死)

如果磁盘图标消失但依然无法再次挂载,说明后台进程还在: Bash # 找到进程并杀死 pgrep -f "rclone mount" | xargs kill -9


五、 避坑小贴士 (必读)

  1. 播放器选择: 必须使用 IINAInfuse。千万不要用 QuickTime 或按空格键预览,否则系统会强行下载整个视频。
  2. Finder 查看模式: 挂载盘内建议使用 “列表模式”。不要开“图标模式”,否则 Finder 会为了生成视频缩略图而疯狂读取数据。
  3. Spotlight 隐私: 建议在 系统设置 > Siri 与 Spotlight > Spotlight 隐私 中,把挂载的文件夹拖进去,防止系统后台建立索引导致卡顿。

现在,你可以把这段代码存进你的备忘录里。下次重启电脑后,只需要运行 第三部分 的那段长命令,你的云端片库就立刻“搬”到桌面上了!

1. 为什么需要 umount

通常在以下情况你会用到它:

  • 网络卡死: 发现网盘文件打不开了,先 umount 强行断开,再重新挂载。
  • 修改了配置: 比如你在 rclone config 里改了密码或地址。
  • 下班关机: 虽然直接关机也没事,但手动 umount 能确保缓存安全写回。

2. 偷懒神器:设置“别名” (Alias)

那串挂载命令太长了,没人想天天复制粘贴。你可以把它变成一个简单的短命令(比如就叫 mount-cd2)。 设置方法:

  1. 在终端输入:nano ~/.zshrc
  2. 在文件最后面添加这一行(把你的用户名改对):Bash alias mount-cd2='rclone mount CD2: ~/Desktop/CD2 --vfs-cache-mode writes --vfs-read-chunk-size 64M --buffer-size 32M --no-modtime --daemon'
  3. Ctrl+O 保存,回车确认,按 Ctrl+X 退出。
  4. 输入 source ~/.zshrc 使其生效。

以后想挂载时: 只需要在终端输入 mount-cd2 即可,秒杀!


3. 进阶:开机自动挂载?

如果你希望每次开机这台 Mac Mini 自动就挂载好网盘,不需要开终端,可以利用 macOS 自带的 “自动操作” (Automator)

  1. 打开 Automator (在启动台里找)。
  2. 选择 “运行状况” (Application)“全局操作”
  3. 在左侧搜索 “运行 Shell 脚本” (Run Shell Script)。
  4. 把那串 rclone mount ... 命令粘贴进去。
  5. 保存为 Mount_CD2.app 放在应用程序里。
  6. 系统设置 > 通用 > 登录项,把这个 app 加进去。

⚠️ 特别提醒

如果在执行 umount 时提示 target is busy(目标正忙),说明你的 IINA 播放器 或者 Finder 窗口 还开着那个盘里的文件。

  • 解决: 先关掉播放器,退出该文件夹,再执行 umount
  • 强行弹出: 如果还是不行,用 diskutil unmount force ~/Desktop/CD2

方法一:使用“自动操作 (Automator)”创建启动 App(最简单)

这种方法不需要写复杂的配置文件,适合大多数用户。

  1. 打开 Automator: 在启动台搜索并打开 “自动操作 (Automator)”
  2. 新建: 选择 “应用程序 (Application)”
  3. 添加脚本: 在左侧搜索框输入“运行 Shell 脚本”,然后双击将其添加到右侧。
  4. 粘贴命令: 把你之前运行成功的那串长命令粘贴进去(注意: 去掉最后的 -daemon,因为 Automator 本身就在后台运行它)。Bash /usr/local/bin/rclone mount CD2: ~/Desktop/CD2 \ --vfs-cache-mode writes \ --vfs-read-chunk-size 64M \ --vfs-read-chunk-size-limit off \ --buffer-size 32M \ --no-modtime *(注意:建议使用 rclone 的绝对路径 */usr/local/bin/rclone*)*
  5. 保存:Command + S 保存,取名为 Mount_CD2,保存到“应用程序”文件夹。
  6. 设置自启: * 前往 系统设置 > 通用 > 登录项
    • 点击 “+” 号,把刚才创建的 Mount_CD2.app 加进去。

方法二:使用 launchd 创建守护进程(更专业)

这种方法完全在系统底层运行,不需要显示任何图标,非常稳定。

  1. 创建配置文件: 打开终端,输入以下命令创建配置文件(注意把 你的用户名 换成真实的):Bash nano ~/Library/LaunchAgents/com.zhensolid.rclone.plist
  2. 粘贴内容: 将以下内容粘贴进去(请确认路径正确):XML <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.zhensolid.rclone</string> <key>ProgramArguments</key> <array> <string>/usr/local/bin/rclone</string> <string>mount</string> <string>CD2:</string> <string>/Users/你的用户名/Desktop/CD2</string> <string>--vfs-cache-mode</string> <string>writes</string> <string>--vfs-read-chunk-size</string> <string>64M</string> <string>--buffer-size</string> <string>32M</string> </array> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/> </dict> </plist>
  3. 加载任务:Bash launchctl load ~/Library/LaunchAgents/com.zhensolid.rclone.plist