driveone/onedrive Docker 镜像 - 轩辕镜像

Linux版OneDrive客户端

概述

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

项目背景

本项目源于2018年初对skilion客户端的分叉，当时多项改进和错误修复提议（包括Pull Requests #82和#314）未被合并，且skilion客户端开发活动基本停滞。2020年，原开发者确认无意维护该项目（参考），其仓库于2024年12月正式归档为只读。

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

核心功能与特性

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

缺失功能

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

外部增强工具

• 配置管理GUI：Linux版OneDrive客户端GUI
• 彩色日志输出：Linux版OneDrive客户端彩色日志输出
• 系统托盘图标：Linux版OneDrive客户端系统托盘图标

常见问题

参考常见问题

有疑问

如需澄清，可提交新讨论帖此处

基本故障排除步骤

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

1. 检查应用版本：onedrive --version，确保使用最新发布版或master分支构建版本
2. 配置仅使用IPv4网络连接后重试
3. 配置仅使用HTTP/1.1和IPv4后重试
4. 升级curl至最新版本（参考curl发布说明）

报告问题或错误

[!IMPORTANT] 请确保错误报告确为软件漏洞。安装问题、依赖项问题请通过讨论解决。

提交漏洞报告前请：

1. 使用问题模板填写报告
2. 按流程生成调试日志（敏感数据建议使用测试账户复现）
3. 将日志上传至pastebin或归档发送至***（敏感数据可加密并通过带外方式提供密码）

已知问题

参考docs/known-issues.md

文档与配置帮助

安装与构建

参考docs/install.md

配置与使用

参考docs/usage.md

商业版共享项配置

参考docs/business-shared-items.md

SharePoint/Office 365共享库配置

参考docs/sharepoint-libraries.md

国家云配置

参考docs/national-cloud-deployments.md

Docker支持

参考docs/docker.md

Podman支持

参考docs/podman.md