企业官网建设流程全解析

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

【免费下载链接】onedriveOneDrive Client for Linux项目地址: https://gitcode.com/gh_mirrors/onedri/onedrive

OneDrive Client for Linux（项目名onedrive）是一款免费、开源且持续维护的OneDrive 同步客户端，支持个人版、企业版和 SharePoint 文档库，兼容主流 Linux 发行版、FreeBSD/OpenBSD，也可以运行在 Docker / Podman 容器中。本教程将带你用最简单的方式完成安装、首次授权并跑通第一次同步。

📌 先选对安装方式：3种途径一分钟看懂

⚠️重要提醒：Ubuntu、Debian、Linux Mint、Raspbian 等发行版默认软件源里的onedrive包已过时且不受支持，请勿直接apt install onedrive！应使用下文推荐的 openSUSE Build Service（OBS）官方维护源。

完整的官方安装文档可参考 docs/install.md，Debian/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 步：清理旧包（如果你曾装过默认源的版本或已下线的 PPA）

sudo add-apt-repository --remove ppa:yann1ck/onedrive # 如未添加过会自动跳过 sudo apt remove onedrive

第 2 步：确认你的发行版版本（用于选择正确的软件源）

lsb_release -a

第 3 步：添加 OBS 官方源密钥和源（以 Ubuntu 24.04 为例，其他版本只需替换 URL 中的xUbuntu_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

第 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_13；Ubuntu 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

⚡ 其他发行版快速安装命令速查

🔐 首次运行：授权你的 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:edge

3. 授权成功后用守护模式重启

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 name=onedrive # 查看运行状态 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-dev

2. 安装 D 语言编译器（DMD / LDC / GDC 三选一，各发行版依赖列表见 docs/install.md）

curl -fsS https://dlang.org/install.sh | bash -s dmd source ~/dlang/dmd-*/activate

3. 克隆、配置、编译、安装

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 服务，避免新旧二进制混跑

❓ 新手常见问题（FAQ）

Q1：为什么不能直接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