在 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
WindowsmacOS
下载 Linux 版 NetDrive →

免费试用。提供终身与订阅方案。

为何挂载优于浏览器标签页

SharePoint 自身的工作流程假定用户要么使用浏览器,要么在 Windows 上使用会先下载整个文档库的同步客户端,才能开始操作其中的内容。这两种方式都不适合只需读取单个文件的 Linux 开发主机。NetDrive 通过挂载点直接对 SharePoint 站点进行读取解析,因此构建脚本打开配置模板时,无需手动导出即可获取当前版本。

自 3.16.589 版(2022 年 3 月)起,NetDrive 就已支持 SharePoint。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 的驱动器管理器,然后点击 + Add Drive
  2. 从连接类型列表中 选择 SharePoint——同一个条目同时涵盖个人版 SharePoint 站点和商业版 SharePoint。

NetDrive 驱动器连接列表中显示的 SharePoint 提供商图标

  1. 通过默认浏览器打开的 OAuth 流程 使用 Microsoft 账户登录。在没有安装浏览器的无头 Ubuntu 主机上,可以使用 X 转发会话,或在另一台已登录同一账户的机器上完成一次性授权。
  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 主机获得了与 NetDrive 在 Windows 和 macOS 上相同的驱动器式访问体验,安装程序托管在 GitHub 上而非通过 apt 分发。若要了解同一提供商在测试更充分的平台上的使用方式,请参阅 在 Windows 上使用 NetDrive 挂载 SharePoint在 macOS 上使用 NetDrive 挂载 SharePoint。若想了解更广泛的 Linux 使用情况,请参阅 NetDrive 在 Ubuntu Linux 上的使用

— Steve, NetDrive