在 Linux 上掛載 SharePoint — NetDrive 的實驗性版本

閱讀時間 6 分鐘 provider-guide sharepoint linux
Steve
SteveSenior Engineer
使用 NetDrive 的 Linux 實驗性版本,將 SharePoint 文件庫掛載為 Ubuntu 掛載點。涵蓋 OAuth 登入、非同步列表載入與驗證步驟。

某工程團隊的建置伺服器與半數開發用工作站都跑在 Ubuntu 上,但公司其餘部門使用 Windows,並把架構文件、供應商合約與新人培訓資料存放在 SharePoint 文件庫中。目前,若要在 Linux 主機上查看一份規格文件,就得開瀏覽器分頁手動下載檔案,或是拜託用 Windows 的同事把內容貼到 Slack。NetDrive 的 Linux 版本能把同一個 SharePoint 文件庫掛載為一般的 Ubuntu 掛載點,讓 catless 或腳本中的 open() 呼叫都能直接讀取這份即時文件。

NetDrive drive manager showing Google Drive, S3 and pCloud mounted as drive lettersMounted clouds appearing as native drives in Windows File Explorer

在 Linux 上掛載你的 SharePoint 文件庫

NetDrive 讓 Google Drive、OneDrive、S3、SFTP、WebDAV 等在 Windows 與 macOS 上顯示為原生磁碟機 — 不需同步,也不需完整下載。

  • SharePoint 文件庫會顯示為一般的 Ubuntu 掛載點
  • 檔案隨選串流 — 不需要同步用戶端,也不用先完整下載
  • 支援個人 SharePoint 網站與 SharePoint for Business
WindowsmacOS
下載適用於 Linux 的 NetDrive →

免費試用。提供終身與訂閱方案。

為什麼用掛載而不是瀏覽器分頁

SharePoint 原生的工作流程假設你會使用瀏覽器,或是在 Windows 上使用會先下載整個文件庫的同步用戶端。這兩者都不適合只需要一次讀取一個檔案的 Linux 開發主機。NetDrive 透過掛載點直接對 SharePoint 網站解析讀取要求,因此建置腳本開啟一份設定範本時,能拿到目前版本,而不需要手動匯出。

SharePoint 支援自 NetDrive 3.16.589 版(2022 年 3 月)起就已存在。NetDrive 3.17.799 加入了非同步目錄列表功能,這點在此處相當重要:過去若 SharePoint 網站的單一文件庫內有數千個檔案,初次讀取資料夾會很慢,而非同步列表可避免這種阻塞。磁碟機容量顯示則是在 3.16.667 版加入的,因此你可以在同一個磁碟機檢視畫面中看到該網站儲存空間配額的使用情況。

NetDrive 將雲端儲存帳戶掛載為本機磁碟機 — 這正是 Linux 版本在掛載點所提供的核心互動方式

在 Ubuntu 上安裝 NetDrive

NetDrive for Linux 並未收錄在 Ubuntu 的套件庫中,因此安裝需透過 GitHub 進行:

  1. 前往 github.com/NetDrive/installer,下載對應你 Ubuntu 版本的發行版本。
  2. 依照該儲存庫的發行說明操作 — NetDrive 必須先安裝驅動元件,才能開始掛載任何內容。
  3. 安裝 NetDrive 套件本身。
  4. 啟動 NetDrive。首次執行會載入驅動元件,過程中可能會要求輸入 sudo

最低支援版本為 Ubuntu 16.04。更新是以 GitHub 發行版本的形式提供,而非透過 apt upgrade,這點值得記在任何相關的操作手冊中。Linux 版本與 NetDrive 自家比較頁面上其他版本一樣,全面標示為實驗性功能 — Windows 與 macOS 承擔了大部分的測試工作,因此在未經自行測試前,應把 Linux 上的 SharePoint 掛載視為適合開發主機或 CI 執行環境使用,而非可信賴的正式生產管線。

逐步操作:在 Ubuntu 上連接 SharePoint

  1. 開啟 NetDrive 的 Drive Manager,點擊 + Add Drive
  2. 從連線類型清單中選擇 SharePoint — 同一個項目同時涵蓋個人 SharePoint 網站與 SharePoint for Business。

NetDrive 磁碟機連線清單中顯示的 SharePoint 供應商圖示

  1. 透過預設瀏覽器開啟的 OAuth 流程使用 Microsoft 帳號登入。若是沒有安裝瀏覽器的無圖形介面 Ubuntu 主機,可使用 X-forwarding 連線,或在登入同一帳號的另一台機器上完成一次性授權。
  2. 輸入你的 SharePoint 網站網址 — 格式類似 https://yourcompany.sharepoint.com/sites/LegalOps。可在瀏覽器中檢視該網站時,從網址列複製。
  3. 設定掛載點 — 例如 /mnt/sharepoint 這樣的路徑,或任何你有寫入權限的空目錄。
  4. 點擊 Connect。 NetDrive 會完成驗證,並將文件庫掛載到該路徑。

在依賴掛載之前先驗證

不要只信任圖形介面,從終端機確認掛載是否真的成功:

# Confirm the mount is listed
mount | grep sharepoint

# Or just try listing it
ls /mnt/sharepoint

確認雲端磁碟機掛載成功

如果第一次列出目錄時是空的,先別急著認定掛載失敗 — 若 SharePoint 網站的文件庫較大,即使啟用了非同步列表,根目錄仍可能需要幾秒鐘才能填入內容。若過一段時間後仍是空的,請先檢查 OAuth 步驟;瀏覽器流程中斷是無圖形介面主機上 SharePoint 連線失敗最常見的原因。

Linux 版本需要留意的事項

  • 獨立的發行節奏 — Linux 驅動元件依自己的排程維護,因此在 Windows 或 macOS 上發布的修正,不會自動在同一週內釋出到 Linux。
  • 沒有 apt 整合 — 安裝與更新都透過 GitHub 發行版本進行,而非 Ubuntu 預設的套件管理員。
  • Windows 與 macOS 是經過強化的目標平台 — NetDrive 自身的指引將它們視為可用於正式環境;Linux 則標示為實驗性。開發用工作站或偶爾讀取檔案的 CI 執行環境是合理的使用情境。若無人值守的正式作業依賴 SharePoint 存取,建議先在自己的硬體上充分測試。

總結

在 Ubuntu 上掛載 SharePoint,讓 Linux 主機能透過位於 GitHub(而非 apt)的安裝程式,取得與 NetDrive 在 Windows 及 macOS 上相同的磁碟機式存取體驗。若想了解同一個供應商在測試更完整平台上的用法,可參考 在 Windows 上使用 NetDrive 掛載 SharePoint在 macOS 上使用 NetDrive 掛載 SharePoint。若想了解更完整的 Linux 概況,可參考 在 Ubuntu Linux 上使用 NetDrive

— Steve, NetDrive