OneDrive Client for Linux 安装教程：Ubuntu、Arch、Docker等全平台安装方法一次讲清

OneDrive Client for Linux 安装教程Ubuntu、Arch、Docker等全平台安装方法一次讲清【免费下载链接】onedriveOneDrive Client for Linux项目地址: https://gitcode.com/gh_mirrors/onedri/onedriveOneDrive Client for Linux项目名onedrive是一款免费、开源且持续维护的OneDrive 同步客户端支持个人版、企业版和 SharePoint 文档库兼容主流 Linux 发行版、FreeBSD/OpenBSD也可以运行在 Docker / Podman 容器中。本教程将带你用最简单的方式完成安装、首次授权并跑通第一次同步。 先选对安装方式3种途径一分钟看懂安装方式适合人群推荐指数发行版软件包 / OBS 软件源绝大多数桌面用户Ubuntu、Debian、Arch、Fedora 等⭐⭐⭐⭐⭐Docker / Podman 容器服务器、NAS 备份场景⭐⭐⭐⭐源码编译无官方包的发行版、ARM 设备、尝鲜 master 分支⭐⭐⚠️重要提醒Ubuntu、Debian、Linux Mint、Raspbian 等发行版默认软件源里的onedrive包已过时且不受支持请勿直接apt install onedrive应使用下文推荐的 openSUSE Build ServiceOBS官方维护源。完整的官方安装文档可参考 docs/install.mdDebian/Ubuntu 详细步骤见 docs/ubuntu-package-install.md。 Ubuntu / Debian 一键安装步骤OBS 官方源这是最常见的安装场景适用于Ubuntu 22.04 / 24.04 / 26.04、Debian 11 / 12 / 13、Linux Mint及其衍生版Kubuntu、Pop!_OS、Zorin 等。第 1 步清理旧包如果你曾装过默认源的版本或已下线的 PPAsudo add-apt-repository --remove ppa:yann1ck/onedrive # 如未添加过会自动跳过 sudo apt remove onedrive第 2 步确认你的发行版版本用于选择正确的软件源lsb_release -a第 3 步添加 OBS 官方源密钥和源以 Ubuntu 24.04 为例其他版本只需替换 URL 中的xUbuntu_24.04wget -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第 4 步更新缓存并安装sudo apt-get update sudo apt install --no-install-recommends --no-install-suggests onedrive第 5 步验证安装onedrive --version 版本对照Debian 11/12/13 使用 URL 中的Debian_11、Debian_12、Debian_13Ubuntu 22.04 用xUbuntu_22.04依此类推。包支持 x86_64、ARMHF、AARCH64 架构。 Arch / Manjaro 安装AUR 一键构建Arch 系用户通过 AUR 安装即可自动跟随最新版本sudo pacman -S --needed base-devel # AUR 构建前置依赖仅需装一次 pamac build onedrive-abraunegg # 或 yay -S onedrive-abraunegg构建时注意如询问d-runtime/d-compiler提供者请选择liblphobos和ldc系统至少需要1GB 内存 1GB 交换空间需要追踪 master 分支则使用onedrive-abraunegg-git⚡ 其他发行版快速安装命令速查发行版安装命令Fedora / CentOS Stream / RHEL需 EPELsudo dnf install onedriveopenSUSEsudo zypper install onedriveGentoosudo emerge net-misc/onedriveAlpine Linux (Edge)apk add onedriveFreeBSDpkg install onedriveNixOSnix-env -iA nixpkgs.onedriveSolussudo eopkg install onedrive 首次运行授权你的 Microsoft 账户安装完成后直接运行onedrive即可进入授权流程这是所有安装方式共用的关键一步。桌面环境自动打开浏览器客户端会检测图形会话自动在默认浏览器中打开 Microsoft 登录页并在本地127.0.0.1:53100临时监听授权回调仅认证期间存在认证完即关闭全程无需手动复制粘贴。无桌面 / SSH / 容器环境手动复制粘贴终端会显示一个授权 URL在任意浏览器打开并完成登录后把浏览器地址栏中的完整跳转地址复制回终端即可粘贴后终端会提示授权成功客户端即完成绑定 企业账户提示部分组织要求先在 Microsoft MyApps 门户中申请添加此应用无图形界面的服务器还支持 OAuth2 设备码流程与 Intune SSO。详见 docs/usage.md 的授权章节。 Docker 容器安装服务器/备份场景Docker 方式开箱即得一个持续监控的同步服务支持 Alpine、Debian、Fedora 三种基础镜像跨 x86_64 与 ARM64。完整文档见 docs/docker.md。1. 创建配置卷与数据目录docker volume create onedrive_conf export ONEDRIVE_DATA_DIR${HOME}/OneDrive mkdir -p ${ONEDRIVE_DATA_DIR}2. 首次运行并完成账户授权容器内同样走浏览器授权流程docker run -it --name onedrive -v onedrive_conf:/onedrive/conf \ -v ${ONEDRIVE_DATA_DIR}:/onedrive/data \ -e ONEDRIVE_UID$(id -u) -e ONEDRIVE_GID$(id -g) \ driveone/onedrive:edge3. 授权成功后用守护模式重启docker rm -f onedrive docker run -d --name onedrive --restart unless-stopped \ -v onedrive_conf:/onedrive/conf -v ${ONEDRIVE_DATA_DIR}:/onedrive/data \ -e ONEDRIVE_UID$(id -u) -e ONEDRIVE_GID$(id -g) \ driveone/onedrive:edge常用管理命令docker ps -f nameonedrive # 查看运行状态 docker logs onedrive # 查看同步日志 docker stop onedrive docker start onedrive # 停止 / 启动 标签选择edge包含最新修复推荐生产使用latest为固定发布版。Podman 用户方法完全相同见 docs/podman.md。容器启动入口脚本位于 contrib/docker/entrypoint.sh可自行构建镜像如 contrib/docker/Dockerfile-debian。 源码编译安装进阶用户仅当你的发行版没有现成软件包、需要 ARM 定制或要测试最新代码时才建议源码编译。1. 安装构建依赖以 Ubuntu/Debian 为例sudo apt install build-essential libcurl4-openssl-dev libsqlite3-dev pkg-config git curl systemd-dev libdbus-1-dev libnotify-dev2. 安装 D 语言编译器DMD / LDC / GDC 三选一各发行版依赖列表见 docs/install.mdcurl -fsS https://dlang.org/install.sh | bash -s dmd source ~/dlang/dmd-*/activate3. 克隆、配置、编译、安装git clone https://gitcode.com/gh_mirrors/onedri/onedrive cd onedrive ./configure # 可加 --enable-notifications / --enable-completions 启用通知与补全 make clean; make sudo make install源码核心为 D 语言编写主入口在 src/main.d同步逻辑在 src/sync.d。⬆️ 升级与卸载软件包安装随系统升级自动更新apt upgrade/dnf upgrade卸载用apt remove onedrive等对应命令源码安装在项目目录执行sudo make uninstall如需彻底清除配置与同步状态再删除~/.config/onedrive升级前记得先停止正在运行的 systemd 服务避免新旧二进制混跑❓ 新手常见问题FAQQ1为什么不能直接apt install onedrive默认源里的版本陈旧、不受支持还会附带一个错误的用户级 systemd 服务导致onedrive application is already running报错。Q2安装后文件放在哪里默认同步目录为~/OneDrive配置与状态文件在~/.config/onedrive随时可用onedrive --display-running-config查看当前运行配置。Q3没有图形界面能用吗可以。客户端在服务器、终端环境下通过设备码授权完成认证核心同步功能完全无头headless可用。Q4同步出问题先做什么先onedrive --version确认是最新版再用onedrive --verbose观察详细日志多数问题可参考 docs/usage.md 排障章节解决。 至此你已完成OneDrive Client for Linux在 Ubuntu、Arch、Docker 等平台的安装与授权。接下来可阅读 docs/application-config-options.md 了解全部配置项或查看 docs/advanced-usage.md 学习双账户同步、systemd 后台服务等进阶玩法。【免费下载链接】onedriveOneDrive Client for Linux项目地址: https://gitcode.com/gh_mirrors/onedri/onedrive创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考