rbonghi/dropbox

docker-dropbox-app

🐳 基于Dropbox令牌应用的Docker同步容器，实现本地文件夹与Dropbox云端的实时文件同步。

https://hub.docker.com/r/rbonghi/dropbox https://hub.docker.com/r/rbonghi/dropbox https://github.com/rbonghi/docker-dropbox-app/actions/workflows/build.yml https://github.com/rbonghi/docker-dropbox-app/actions/workflows/github-code-scanning/codeql

容器就绪后，所有文件和文件夹将实时同步。 watchdog会监控文件/文件夹的创建、删除或修改，并更新Dropbox文件夹。若在根目录添加.dropboxignore文件，可排除指定类型的文件/文件夹（类似Git的忽略规则）。

镜像概述

本镜像提供了一个轻量级的Docker环境，用于快速部署Dropbox同步服务，支持通过Dropbox开发者应用的令牌进行身份验证，无需手动登录，适用于服务器、开发环境等场景的文件同步需求。

核心功能

1. 实时同步：监控本地文件夹变化并同步至Dropbox，或从Dropbox同步至本地
2. 忽略规则：通过.dropboxignore文件排除不需要同步的文件/文件夹
3. 灵活同步方向：支持本地覆盖云端（--fromLocal）或云端覆盖本地（--fromDropbox）
4. 可配置同步间隔：自定义从Dropbox拉取文件的间隔时间（默认10秒）
5. 详细日志：--verbose参数可输出调试信息，便于问题排查

使用场景

• 服务器文件自动备份至Dropbox
• 多设备间通过Docker容器同步共享文件
• 开发环境中代码或资源文件的云端同步
• 需要自动化同步的企业或个人文件管理场景

配置说明

环境变量

命令行参数

部署示例

Docker Run方式

1. 在Dropbox开发者控制台创建应用（链接）
2. 使用init_dropbox_refreshToken.sh脚本生成刷新令牌
3. 拉取镜像：

   console
   docker pull rbonghi/dropbox
   

4. 运行容器：

   console
   docker run \
   -e DROPBOX_APP_KEY=<你的App Key> \
   -e DROPBOX_APP_SECRET=<你的App Secret> \
   -e DROPBOX_REFRESH_TOKEN=<你的刷新令牌>  \
   -v <本地同步文件夹路径>:/dropbox rbonghi/dropbox
   

Docker Compose方式

1. 完成上述步骤1-2
2. 创建docker-compose.yml文件：

   yml
   version: '3'
   services:
     dropbox:
       image: rbonghi/dropbox:latest
       environment:
         - PYTHONUNBUFFERED=1
         - DROPBOX_APP_KEY=<你的App Key>
         - DROPBOX_APP_SECRET=<你的App Secret>
         - DROPBOX_REFRESH_TOKEN=<你的刷新令牌>
       volumes:
         - <本地同步文件夹路径>:/dropbox
   

3. 启动容器：

   console
   docker-compose up
   

自定义同步参数示例

若需要从Dropbox同步至本地并设置30秒间隔：

console
docker run \
-e DROPBOX_APP_KEY=<你的App Key> \
-e DROPBOX_APP_SECRET=<你的App Secret> \
-e DROPBOX_REFRESH_TOKEN=<你的刷新令牌>  \
-v <本地同步文件夹路径>:/dropbox rbonghi/dropbox --fromDropbox -i 30

或在Compose中添加命令参数：

yml
version: '3'
services:
  dropbox:
    image: rbonghi/dropbox:latest
    command: ["--fromDropbox", "-i", "30"]
    environment:
      - PYTHONUNBUFFERED=1
      - DROPBOX_APP_KEY=<你的App Key>
      - DROPBOX_APP_SECRET=<你的App Secret>
      - DROPBOX_REFRESH_TOKEN=<你的刷新令牌>
    volumes:
      - <本地同步文件夹路径>:/dropbox