Song's Blog

外观

在 Ubuntu 上使用 OneDrive

约 787 字大约 3 分钟

Ubuntu

2026-04-22

OneDrive 没有官方的 Linux 客户端，但可以使用开源项目 abraunegg/onedrive 在 Ubuntu 上同步 OneDrive 文件。

安装

该项目的推荐安装方式是安装预编译包（pre-built package）, 具体请查看 Install。Ubuntu\Debian 用户可以查看 Ubuntu/Debian 章节。

移除老版本

许多互联网上的“帮助”页面在如何安装 OneDrive Linux 客户端方面提供的细节不尽相同且具有误导性。 不少网站仍旧引导用户通过 yann1ck PPA 存储库进行安装，但事实上该 PPA 已不再存在，不应再被使用。如果你之前配置过或尝试添加过这个 PPA，则需要将其删除。 要删除 yann1ck PPA 存储库，请执行以下操作：

sudo add-apt-repository --remove ppa:yann1ck/onedrive
sudo apt remove onedrive

添加 OBS 仓库并安装

许多互联网上的“帮助”页面在如何安装 OneDrive Linux 客户端方面提供的细节并不一致。 许多这类网站继续建议用户在未先配置 OpenSuSE 构建服务 (OBS) 存储库的情况下，直接运行 sudo apt install onedrive 进行安装。 如果你在不使用 OBS 的情况下进行安装，你安装的将是一个过时的客户端版本，其中包含一些已知但已在后续版本中修复的漏洞。 此外，该软件包还包含一个错误的 systemd 服务（见下文），会影响客户端在后台的正常运行。 添加 OBS 仓库并安装（以 Ubuntu 24.04 为例）：

wget -qO - https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_24.04/Release.key | gpg --dearmor | sudo tee /usr/share/keyrings/obs-onedrive.gpg > /dev/null
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/obs-onedrive.gpg] https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_24.04/ ./" | sudo tee /etc/apt/sources.list.d/onedrive.list
sudo apt-get update
sudo apt install --no-install-recommends --no-install-suggests onedrive

安装后版本为 onedrive v2.5.10。

授权登录

首次使用需要通过浏览器授权：

onedrive

程序会输出一个授权链接，在浏览器中打开并登录 Microsoft 账号，授权后将页面跳转的 URL 粘贴回终端即可完成认证。认证信息保存在 ~/.config/onedrive/refresh_token。

配置

配置文件位于 ~/.config/onedrive/config，可以设置跳过不需要同步的目录：

skip_dir = "Notability|Zotero"

多个目录用 | 分隔。这里跳过了 Notability 和 Zotero，因为这两个目录由各自的应用程序管理同步。

选择性同步

通过 ~/.config/onedrive/sync_list 可以指定只同步哪些目录（白名单模式）：

Reading
Wallpapers

这样只有 Reading 和 Wallpapers 两个目录会被同步到本地 ~/OneDrive/。

手动同步

# 执行一次同步
onedrive --sync
# 或
onedrive -s
# 查看将要同步的内容（不实际下载）
onedrive -s --dry-run

同步结果

本地 ~/OneDrive/ 目录结构：

~/OneDrive/
├── Reading/        # 论文和书籍（同步）
│   ├── Books/
│   ├── FEM/
│   ├── Literature/
│   └── ...
├── Wallpapers/     # 壁纸（同步）
├── Notability/     # 跳过（由 Notability 管理）
└── Zotero/         # 跳过（由 Zotero 管理）

版权归属：Guisong Wu

许可证：署名 4.0 国际 (CC-BY-4.0)