oznu/onedrive

Docker OneDrive同步镜像

本Docker镜像基于https://github.com/skilion/onedrive%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E6%9C%AC%E5%9C%B0%E5%8D%B7%E4%B8%8EOneDrive%E4%B9%8B%E9%97%B4%E7%9A%84%E9%AB%98%E6%95%88%E6%95%B0%E6%8D%AE%E5%90%8C%E6%AD%A5%E8%83%BD%E5%8A%9B%E3%80%82

核心功能

• 状态缓存：减少重复同步操作，提升效率
• 文件监控：实时检测本地文件变化并同步
• 可恢复上传：中断后可继续未完成的上传任务
• 多版本支持：兼容OneDrive个人版与商业版

使用场景

• 个人文件的云端备份与跨设备同步
• 小型团队的文件共享与协作
• 服务器数据定期同步至OneDrive实现灾备

配置说明

首次运行（账户认证）

首次启动需通过Microsoft账户认证，需使用交互模式：

shell
docker run -it \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  -v </本地配置目录>:/config \
  -v </本地文件目录>:/documents \
  oznu/onedrive

按提示打开链接登录账户，复制空白页URI回容器完成认证。认证后停止容器，以非交互模式重启。

常规运行命令

shell
docker run \
  -e PUID=<用户ID> -e PGID=<组ID> \
  -e TZ=Asia/Shanghai \
  -v </本地配置目录>:/config \
  -v </本地文件目录>:/documents \
  oznu/onedrive

参数说明

• -v /config：存储OneDrive客户端配置文件的目录
• -v /documents：需同步至OneDrive的本地文件夹
• -e TZ：时区设置（如Asia/Shanghai）
• -e PGID/PUID：与本地文件所有者匹配的组/用户ID
• -e DEBUG=1：开启详细日志模式

Docker Compose示例

yml
version: '2'
services:
  onedrive:
    image: oznu/onedrive
    restart: always
    environment:
      - TZ=Asia/Shanghai
      - PGID=1000
      - PUID=1000
    volumes:
      - ./config:/config
      - /home/user/documents:/documents

首次认证：docker-compose run onedrive
后台运行：docker-compose up -d