croc/onedrive

OneDrive同步Docker镜像

镜像概述和主要用途

基于skilion的免费OneDrive客户端构建的Docker镜像，用于在Docker环境中实现OneDrive文件的同步。支持配置文件持久化存储、数据目录映射、选择性同步指定文件/文件夹及忽略特定内容等功能，适用于无图形界面的Linux系统或服务器环境。

核心功能和特性

• 基于skilion免费OneDrive客户端，实现OneDrive文件同步
• 支持Docker环境部署，简化依赖管理
• 配置文件持久化（通过挂载config目录）
• 数据目录映射，本地文件与OneDrive云端双向同步
• 选择性同步：通过配置文件指定需同步的文件/文件夹
• 忽略列表：通过配置文件排除无需同步的文件/文件夹
• 可自定义同步文件的用户ID（USER_ID）和组ID（GROUP_ID）
• 支持后台运行模式，持续监控并同步文件变更

使用场景和适用范围

适用于需要在Docker环境中管理OneDrive文件同步的用户，尤其适合：

• 无图形界面的Linux服务器
• 需要隔离OneDrive客户端依赖的环境
• 需持久化保存同步配置和数据的场景
• 需要精细化控制同步范围（如仅同步特定文件夹）的需求

详细使用方法和配置说明

构建镜像

使用以下命令构建本地镜像：

bash
docker build -t croc/onedrive .

运行容器

首次配置（Base Config）

首次运行需进行Microsoft账户授权，需交互操作，请勿使用后台模式。执行命令：

bash
docker run -ti --rm --name onedrive -v $PWD/config:/home/app/.config -v $PWD/data:/onedrive croc/onedrive

授权步骤：

1. 容器启动后会输出授权URL，复制并在浏览器中打开
2. 完成Microsoft账户登录（按页面提示操作）
3. 登录后浏览器可能显示空白页，但地址栏会有包含code的长URL，复制该URL
4. 返回容器终端，粘贴该URL作为“响应URI”（Enter the response uri）
5. 授权成功后，容器会自动创建同步目录并初始化同步

示例：

bash
docker run -ti --rm --name onedrive -v $PWD/config:/home/app/.config -v $PWD/data:/onedrive croc/onedrive 

Authorize this app visiting:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=22c49a0d-d21c-4792-aed1-8f163c982546&scope=files.readwrite%20files.readwrite.all%20offline_access&response_type=code&redirect_uri=https://login.microsoftonline.com/common/oauth2/nativeclient

Enter the response uri: https://login.microsoftonline.com/common/oauth2/nativeclient?code=M9d34df5b-d304-9606-9f06-38fd6afb76e0 
Creating directory: ./Documents
Creating directory: ./Pictures
...

授权完成并确认同步启动后，按CTRL-C停止容器，准备后台运行配置。

后台运行（Run）

使用以下命令停止临时容器并以后台模式重新运行（保留原config目录以复用授权配置）：

bash
docker rm -v -f onedrive
docker run -tid --name onedrive -v $PWD/config:/home/app/.config -v $PWD/data:/onedrive croc/onedrive

权限调整（如需）：若需调整同步文件的所有者权限，执行：

bash
usr="<youruser>"; chown -R $usr /home/$usr/Documents/onedrive

使用docker-compose：通过docker-compose简化部署（需提前准备docker-compose.yml文件）：

bash
docker-compose up -d

可选参数

通过环境变量自定义容器行为，支持以下参数：

• GROUP_ID：同步文件的默认组ID（默认：1000）
• USER_ID：同步文件的默认用户ID（默认：1000）
• SYNC_LIST：指定需同步的文件夹/文件（格式：逗号分隔，示例："work,my stuff,Sync1"）
• VERBOSITY：增加日志输出详细程度
• MODE：运行模式（默认：同步；可选：monitor，监控模式）
• EXTRA_PARAMS：额外运行参数（如--monitor-interval，使用--help查看所有选项）

示例：

bash
docker run -tid --name onedrive --restart always \
  -v $HOME/Documents/onedrive/config:/home/app/.config \
  -v $HOME/Documents/onedrive/data:/onedrive \
  -e GROUP_ID=1005 -e USER_ID=1005 -e SYNC_LIST="work,my stuff,Sync1" \
  croc/onedrive

配置说明

选择性同步（Selective sync）

在config目录下创建sync_list文件，指定需同步的文件/文件夹，每行一个条目。示例： config/sync_list:

Backup
Documents/latest_report.docx
Work/ProjectX
notes.txt

忽略列表（Skip list）

在config目录下创建skip_file文件，指定需忽略的文件/文件夹，每行一个条目。示例： config/skip_file:

MyOldStuff
Photos
Movies
Verylarge_stuff

已知问题

• 本地文件更新后，同步至云端可能存在1-2分钟延迟，需耐心等待同步完成。