driveone/onedrive

Linux版OneDrive客户端

概述

全功能、免费且活跃维护的Microsoft OneDrive客户端，无缝支持OneDrive个人版、OneDrive商业版、Microsoft 365（原Office 365）及SharePoint文档库。设计注重灵活性和可靠性，这款高度可配置的客户端适用于所有主流Linux发行版和FreeBSD，也可通过Docker或Podman部署在容器环境中。支持单向和双向同步模式，提供安全高效的文件同步功能，适用于桌面和服务器环境。

项目背景

本项目源于2018年初对skilion客户端的分叉，当时多项改进和错误修复提议（包括https://github.com/skilion/onedrive/pulls?q=author%3Aabraunegg%EF%BC%89%E6%9C%AA%E8%A2%AB%E5%90%88%E5%B9%B6%EF%BC%8C%E4%B8%94skilion%E5%AE%A2%E6%88%B7%E7%AB%AF%E5%BC%80%E5%8F%91%E6%B4%BB%E5%8A%A8%E5%9F%BA%E6%9C%AC%E5%81%9C%E6%BB%9E%E3%80%822020%E5%B9%B4%EF%BC%8C%E5%8E%9F%E5%BC%80%E5%8F%91%E8%80%85%E7%A1%AE%E8%AE%A4%E6%97%A0%E6%84%8F%E7%BB%B4%E6%8A%A4%E8%AF%A5%E9%A1%B9%E7%9B%AE%EF%BC%88https://github.com/skilion/onedrive/issues/518#issuecomment-717604726%EF%BC%89%EF%BC%8C%E5%85%B6%E4%BB%93%E5%BA%93%E4%BA%8E2024%E5%B9%B412%E6%9C%88%E6%AD%A3%E5%BC%8F%E5%BD%92%E6%A1%A3%E4%B8%BA%E5%8F%AA%E8%AF%BB%E3%80%82

根据GNU通用公共许可证（GPL），本项目作为衍生作品保留GPLv3许可，持续开发并重构原代码库，解决长期存在的错误，添加新功能以更好地支持Linux和FreeBSD平台与Microsoft OneDrive的交互。

核心功能与特性

• 兼容OneDrive个人版和商业版，包括访问Microsoft SharePoint库
• 支持跨账户无缝访问共享文件夹和文件
• 支持单租户和多租户应用及Intune单点登录（SSO）认证
• 支持OAuth2设备授权流程和国家云部署（美国***云、德国云、中国Azure等）
• 提供客户端过滤规则，防止配置变更导致的数据丢失
• 支持干运行测试、文件传输验证和同步状态缓存
• 使用inotify实时监控本地文件，通过网络钩子同步远程更新
• 多线程传输提升同步速度，支持速率限制和中断上传恢复
• 通过libnotify发送桌面通知

缺失功能

• 文件上传/下载时的实时加密/解密功能
• Windows"按需下载"功能（仅在本地访问时下载文件）

外部增强工具

• 配置管理GUI：https://github.com/bpozdena/OneDriveGUI
• 彩色日志输出：https://github.com/zzzdeb/dotfiles/blob/master/scripts/tools/onedrive_log
• 系统托盘图标：https://github.com/DanielBorgesOliveira/onedrive_tray

常见问题

参考https://github.com/abraunegg/onedrive/wiki/Frequently-Asked-Questions

有疑问

如需澄清，可提交新讨论帖https://github.com/abraunegg/onedrive/discussions

基本故障排除步骤

遇到问题时，请先执行以下步骤：

1. 检查应用版本：onedrive --version，确保使用最新https://github.com/abraunegg/onedrive/releases%E6%88%96master%E5%88%86%E6%94%AF%E6%9E%84%E5%BB%BA%E7%89%88%E6%9C%AC
2. 配置仅使用IPv4网络连接后重试
3. 配置仅使用HTTP/1.1和IPv4后重试
4. 升级curl至最新版本（参考curl发布说明）

报告问题或错误

[!IMPORTANT] 请确保错误报告确为软件漏洞。安装问题、依赖项问题请通过https://github.com/abraunegg/onedrive/discussions%E8%A7%A3%E5%86%B3%E3%80%82

提交漏洞报告前请：

1. 使用https://github.com/abraunegg/onedrive/issues/new?template=bug_report.md%E5%A1%AB%E5%86%99%E6%8A%A5%E5%91%8A
2. 按https://github.com/abraunegg/onedrive/wiki/Generate-debug-log-for-support%E7%94%9F%E6%88%90%E8%B0%83%E8%AF%95%E6%97%A5%E5%BF%97%EF%BC%88%E6%95%8F%E6%84%9F%E6%95%B0%E6%8D%AE%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E6%B5%8B%E8%AF%95%E8%B4%A6%E6%88%B7%E5%A4%8D%E7%8E%B0%EF%BC%89
3. 将日志上传至pastebin或归档发送至***（敏感数据可加密并通过带外方式提供密码）

已知问题

参考https://github.com/abraunegg/onedrive/blob/master/docs/known-issues.md

文档与配置帮助

安装与构建

参考https://github.com/abraunegg/onedrive/blob/master/docs/install.md

配置与使用

参考https://github.com/abraunegg/onedrive/blob/master/docs/usage.md

商业版共享项配置

参考https://github.com/abraunegg/onedrive/blob/master/docs/business-shared-items.md

SharePoint/Office 365共享库配置

参考https://github.com/abraunegg/onedrive/blob/master/docs/sharepoint-libraries.md

国家云配置

参考https://github.com/abraunegg/onedrive/blob/master/docs/national-cloud-deployments.md

Docker支持

参考https://github.com/abraunegg/onedrive/blob/master/docs/docker.md

Podman支持

参考https://github.com/abraunegg/onedrive/blob/master/docs/podman.md