otherguy/dropbox

Dropbox Docker镜像

概述和主要用途

该镜像提供在Docker容器中运行Dropbox的功能，支持本地主机文件夹挂载或通过--volumes-from进行容器间链接，实现文件同步与数据管理。请注意，macOS用户当前无法挂载Dropbox数据文件夹，具体限制详见相关说明。

核心功能和特性

• 在Docker容器中运行Dropbox服务，实现跨环境文件同步
• 支持本地文件夹挂载，确保数据持久化存储
• 支持容器间卷链接（--volumes-from），便于多容器数据共享
• 可配置用户ID（UID）和组ID（GID），解决文件权限问题
• 支持时区设置，避免因主机与容器时区差异导致的文件时间戳问题
• 支持LAN同步功能，提升本地网络内文件传输效率
• 可自定义状态轮询间隔，优化系统资源占用

使用场景和适用范围

• 个人用户在Docker环境中部署Dropbox进行文件同步
• 团队环境中需要统一管理Dropbox数据卷的场景
• 需要隔离Dropbox运行环境的服务器部署
• 注意：macOS用户因文件系统限制，暂不支持挂载数据文件夹

详细使用方法和配置说明

快速启动

以下命令包含完整配置，可直接启动Dropbox容器：

bash
$ docker run --detach -it --restart=always --name=dropbox \
  --net="host" \
  -e "TZ=$(readlink /etc/localtime | sed 's#^.*/zoneinfo/##')" \
  -e "DROPBOX_UID=$(id -u)" \
  -e "DROPBOX_GID=$(id -g)" \
  -e "POLLING_INTERVAL=20" \
  -v "/path/to/local/settings:/opt/dropbox/.dropbox" \
  -v "/path/to/local/dropbox:/opt/dropbox/Dropbox" \
  otherguy/dropbox:latest

检查Dropbox版本

容器内直接运行dropbox version会返回错误信息，正确查看版本的方法：

bash
$ docker exec -it dropbox cat /opt/dropbox/bin/VERSION

数据持久化

挂载本地文件夹时，需设置与主机文件所有者匹配的UID和GID，避免权限错误：

bash
$ docker run --name=dropbox \
  -e "DROPBOX_UID=$(id -u)" \  # 当前用户ID
  -e "DROPBOX_GID=$(id -g)" \  # 当前用户组ID
  -v "/path/to/local/settings:/opt/dropbox/.dropbox" \  # 配置文件卷
  -v "/path/to/local/dropbox:/opt/dropbox/Dropbox" \    # 数据文件卷
  otherguy/dropbox:latest

时区设置

为避免文件时间戳差异导致同步问题，建议配置时区：

通过环境变量（适用于macOS和Linux）

bash
$ docker run --name=dropbox \
  -e "TZ=$(readlink /etc/localtime | sed 's#^.*/zoneinfo/##')" \
  otherguy/dropbox:latest

通过挂载文件（仅适用于Linux）

bash
$ docker run --name=dropbox \
  -v "/etc/timezone:/etc/timezone" \
  -v "/etc/localtime:/etc/localtime" \
  otherguy/dropbox:latest

启用LAN同步

使用--net="host"参数启用本地LAN同步功能：

bash
$ docker run --name=dropbox \
  --net="host" \
  otherguy/dropbox:latest

链接Dropbox账户

启动容器后，通过日志获取认证URL：

bash
$ docker logs --follow dropbox

复制日志中的URL在浏览器中打开，登录Dropbox账户完成关联，成功后会显示：This computer is now linked to Dropbox. Welcome [your name]

管理Dropbox设置

通过docker exec在容器内执行dropbox命令管理设置：

bash
# 查看帮助命令
$ docker exec -it dropbox gosu dropbox dropbox help

# 查看同步状态
$ docker exec -it dropbox gosu dropbox dropbox status

# 设置同步排除项
$ docker exec -it dropbox gosu dropbox dropbox exclude add /opt/dropbox/Dropbox/unwanted_folder

配置参数说明

环境变量

暴露卷

• /opt/dropbox/Dropbox：存放同步文件的Dropbox主目录
• /opt/dropbox/.dropbox：存储账户配置和应用设置，不挂载则需每次重启后重新链接账户

常见问题

Linux下监控超过10,000个文件夹

Linux版Dropbox默认限制监控10,000个文件夹，超过此数量将无法同步。解决方法：

bash
echo fs.inotify.max_user_watches=100000 | sudo tee -a /etc/sysctl.conf; sudo sysctl -p

该命令将系统监控文件夹上限提高到100,000，执行后Dropbox将恢复正常同步。