跳至主要内容

在 RcloneView 中修復 Rclone 掛載與 FUSE 錯誤

· 閱讀時間約 13 分鐘
Tayson
Tayson
Senior Engineer

將雲端儲存掛載為本機磁碟是 rclone 最強大的功能之一，但 FUSE 相依性與作業系統特有的問題可能會導致惱人的錯誤。本指南將逐一說明常見的掛載失敗情況及其修復方法。

Rclone 的掛載功能讓你可以像存取本機資料夾或磁碟機一樣存取遠端雲端儲存。RcloneView 透過其掛載管理員讓這件事變得簡單，但在幕後，掛載仰賴必須在你的作業系統上正確安裝與設定的 FUSE（使用者空間檔案系統）層。當出現問題時，錯誤訊息通常令人費解。本指南涵蓋你在 Windows、macOS 和 Linux 上最常遇到的掛載與 FUSE 錯誤，並針對每一種提供逐步修復方法。

RcloneView 應用程式預覽

在同一處管理與同步所有雲端

RcloneView 是 rclone 的跨平台 GUI。透過清爽的視覺化介面比較資料夾、傳輸或同步檔案，並自動化多雲工作流程。

  • 一鍵作業：複製 · 同步 · 比較
  • 排程器與歷史記錄，打造可靠的自動化
  • 支援 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
WindowsmacOSLinux
免費開始使用 →

核心功能免費。Plus 提供自動化功能。

了解 Rclone 掛載的運作方式​

在深入了解修復方法之前，先了解一下架構會有幫助。當你在 RcloneView 中掛載遠端時，rclone 會建立一個虛擬檔案系統，將檔案操作（開啟、讀取、寫入、列出）轉換為對你雲端服務供應商的 API 呼叫。這個虛擬檔案系統透過 FUSE 驅動程式暴露給你的作業系統：

  • Windows 使用 WinFsp（Windows File System Proxy）。
  • macOS 使用 macFUSE（前身為 OSXFUSE）。
  • Linux 使用核心 FUSE 模組（fuse 或 fuse3）。

如果 FUSE 驅動程式遺失、過時或設定錯誤，掛載會在 rclone 甚至還來不及開始提供檔案之前就失敗。VFS（虛擬檔案系統）快取層位於其上，負責處理快取、緩衝與預先讀取——即使 FUSE 本身運作正常，這一層自身的問題也可能造成困擾。

Configure a mount from Mount Manager

Windows 上缺少或未偵測到 WinFsp​

症狀​

  • 錯誤訊息：mount helper not found 或 cannot find WinFsp。
  • 掛載命令立即結束，且沒有出現磁碟機代號。
  • RcloneView 顯示掛載失敗通知。

修復步驟​

  1. 下載並安裝 WinFsp，前往 winfsp.dev。選擇最新的穩定版本（.msi 安裝程式）。
  2. 以系統管理員身分執行安裝程式——WinFsp 會安裝一個需要提升權限的核心模式驅動程式。
  3. 安裝後重新啟動。雖然並非總是必要，但重新啟動可確保驅動程式完全載入。
  4. 驗證安裝，開啟命令提示字元並執行： 
    dir "C:\Program Files (x86)\WinFsp"
    你應該會看到包含 bin、lib 及其他資料夾的 WinFsp 目錄。
  5. 檢查 PATH——WinFsp 的 bin 目錄必須位於系統 PATH 中。安裝程式通常會自動加入，但如果你持續遇到錯誤，請手動將 C:\Program Files (x86)\WinFsp\bin 加入系統環境變數。
  6. 在 RcloneView 的掛載管理員中再次嘗試掛載。

如果你使用的是較舊版本的 WinFsp，請升級至最新版本。某些 rclone 版本需要較新的 WinFsp 功能，版本不相容可能導致無聲的失敗。

macOS 上找不到 macFUSE​

症狀​

  • 錯誤：FUSE library not found 或 mount helper not found。
  • 掛載無聲失敗，或以代碼 1 結束。
  • 在 macOS Ventura 或更新版本上，你可能會看到系統延伸功能遭封鎖的警告。

修復步驟​

  1. 下載 macFUSE，前往 osxfuse.github.io。安裝最新的穩定版本。
  2. 允許系統延伸功能——安裝完成後，前往系統設定 > 隱私權與安全性並核准 macFUSE 核心延伸功能。在 Apple Silicon Mac 上，這可能需要重新開機進入救援模式（Recovery Mode）以啟用核心延伸功能。
  3. 核准延伸功能後重新啟動你的 Mac。
  4. 驗證，在終端機中執行： 
    ls /Library/Filesystems/macfuse.fs
    如果目錄存在，表示 macFUSE 已正確安裝。
  5. 檢查 Gatekeeper——如果 macOS 以安全性警告封鎖掛載，請前往隱私權與安全性設定並點選「仍要允許」。

對於執行 macOS Sonoma 或更新版本的 Apple Silicon Mac，你可能需要在救援模式中將安全性層級降低至「較低安全性」，才能允許第三方核心延伸功能。這是 macOS 的要求，並非 rclone 的限制。

mount from remote explorer

Linux 上未安裝 FUSE​

症狀​

  • 錯誤：fusermount: command not found 或 fuse: device not found。
  • 掛載失敗並出現 mount helper program not found。
  • 存取 /dev/fuse 時權限被拒。

修復步驟​

安裝 FUSE：

# Debian/Ubuntu
sudo apt install fuse3

# Fedora/RHEL
sudo dnf install fuse3

# Arch Linux
sudo pacman -S fuse3

# Alpine
sudo apk add fuse3

啟用 FUSE 核心模組：

sudo modprobe fuse

若要讓其在重新開機後仍持續生效，請將 fuse 加入 /etc/modules-load.d/fuse.conf。

修復 /dev/fuse 的權限：

sudo chmod 666 /dev/fuse

或將你的使用者加入 fuse 群組：

sudo usermod -aG fuse $USER

登出並重新登入，讓群組變更生效。

允許非 root 使用者掛載：

編輯 /etc/fuse.conf 並取消以下這一行的註解：

user_allow_other

如果你想使用 --allow-other 旗標，這是必要的，此旗標可讓其他使用者（以及系統服務）存取已掛載的檔案系統。

權限被拒錯誤​

權限問題在每個作業系統上的表現方式不同，但根本原因通常相同：執行 rclone 的使用者沒有建立或存取掛載所需的權限。

Windows​

  • 如果要掛載到系統層級的路徑，以系統管理員身分執行 RcloneView。
  • 確認掛載點（磁碟機代號或資料夾）尚未被其他程式使用中。
  • 檢查你的防毒軟體是否封鎖了 WinFsp 或 rclone。

macOS​

  • 如果你看到 operation not permitted，請檢查 rclone 與 RcloneView 是否已在系統設定 > 隱私權與安全性 > 完整磁碟取用權中取得完整磁碟取用權。
  • 確認掛載點目錄存在，且你的使用者具有寫入權限。

Linux​

  • 驗證你的使用者是否能存取 /dev/fuse： 
    ls -la /dev/fuse
  • 如果以服務方式（systemd）執行 rclone，請確認服務檔中包含 User=youruser，且該使用者已加入 fuse 群組。
  • SELinux 或 AppArmor 政策可能會封鎖 FUSE 掛載。請使用 ausearch -m avc（SELinux）或 dmesg（AppArmor）檢查日誌，並加入適當的例外規則。
Open multiple cloud remotes in RcloneView

掛載點忙碌或殘留掛載​

當 rclone 意外結束（當機、被強制終止、系統睡眠）但掛載點仍在作業系統中保持註冊狀態時，就會發生殘留掛載。任何存取該路徑或重新掛載的嘗試都會失敗，並顯示「transport endpoint is not connected」（Linux）、「resource busy」（macOS），或造成檔案總管視窗無回應（Windows）。

Linux 修復方式​

# 強制卸載殘留的掛載
fusermount -uz /path/to/mount

# 如果 fusermount 失敗，使用延遲卸載
sudo umount -l /path/to/mount

macOS 修復方式​

# 卸載殘留路徑
diskutil unmount force /path/to/mount

# 或使用 umount
sudo umount -f /path/to/mount

Windows 修復方式​

  • 開啟工作管理員並結束任何仍在執行中的 rclone.exe 處理程序。
  • 如果磁碟機代號卡住，請以系統管理員身分開啟命令提示字元並執行： 
    net use X: /delete
    將 X: 替換為卡住的磁碟機代號。
  • 如果磁碟機代號仍未消失，從工作管理員重新啟動 Windows 檔案總管。

清除殘留掛載後，從 RcloneView 的掛載管理員重試掛載。

VFS 快取目錄問題​

Rclone 的 VFS 快取會儲存正在讀取或寫入之檔案的暫存副本。如果快取目錄空間不足、權限不正確，或位於速度緩慢的檔案系統上，掛載將會失敗或行為異常。

常見問題​

  • 磁碟空間不足——預設的快取位置位於使用者的暫存目錄中，該目錄可能位於較小的系統分割區上。
  • 權限被拒——快取目錄由其他使用者所有，或設有限制性權限。
  • 快取磁碟速度緩慢——將快取放在網路磁碟或機械式硬碟上會導致掛載效能不佳。

修復方式​

變更快取目錄至具有充足高速儲存空間的位置：

rclone mount remote: /mnt/cloud --cache-dir /path/to/fast/ssd/cache

在 RcloneView 中，你可以在掛載設定選項中設定快取目錄。

設定快取大小限制，避免快取佔用所有可用空間：

--vfs-cache-max-size 10G
--vfs-cache-max-age 1h

檢查快取目錄的權限：

ls -la /path/to/cache
# 確保你的使用者擁有該目錄
chown -R $USER:$USER /path/to/cache
job history

重新開機後掛載消失​

預設情況下，rclone 掛載並非永久性的——系統重新啟動後不會保留。如果你需要掛載能夠自動恢復，有幾種選擇。

使用 RcloneView 工作排程​

RcloneView 可讓你建立排程工作，在系統啟動時重新建立掛載。設定一個掛載工作，並將其排程設為在登入或開機時執行。

Linux systemd 服務​

建立一個 systemd 使用者服務：

[Unit]
Description=Rclone Mount - Remote
After=network-online.target
Wants=network-online.target

[Service]
Type=notify
ExecStart=/usr/bin/rclone mount remote: /mnt/cloud --vfs-cache-mode full
ExecStop=/bin/fusermount -uz /mnt/cloud
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

使用以下指令啟用：

systemctl --user enable rclone-mount.service
systemctl --user start rclone-mount.service

Windows 工作排程器​

建立一個在登入時執行的排程工作，執行帶有你所需參數的 rclone mount。RcloneView 的工作排程器也能為你處理這件事。

macOS launchd​

在 ~/Library/LaunchAgents/ 中建立一個 plist，以便在登入時啟動掛載。

create job schedule

開始使用​

  1. 下載 RcloneView，前往 rcloneview.com。
  2. 安裝適用於你作業系統的 FUSE 驅動程式——WinFsp（Windows）、macFUSE（macOS）或 fuse3（Linux）。
  3. 開啟 RcloneView 中的掛載管理員，以設定並啟動你的第一個掛載。
  4. 設定符合你儲存空間與網路速度的 VFS 快取選項。

大多數掛載錯誤都歸結於 FUSE 驅動程式遺失或設定錯誤。為你的平台安裝正確的驅動程式、驗證權限，你將在幾分鐘內擁有可靠運作的雲端掛載。

相關指南：

支援的雲端服務商

Local Files
WebDAV
FTP
SFTP
HTTP
SMB / CIFS
Google Drive
Google Photos
Google Cloud Storage
OneDrive
Dropbox
Box
MS Azure Blob
MS File Storage
S3 Compatible
Amazon S3
pCloud
Wasabi
Mega
Backblaze B2
Cloudflare R2
Alibaba OSS
Ceph
Swift (OpenStack)
IBM Cloud Object Storage
Oracle Cloud Object Storage
IDrive e2
MinIO
Storj
DigitalOcean Spaces
查看所有服務商 →
連接您的雲端 →
所有文章 →
所有文章 →