fmadsen/dropbox

镜像概述

本镜像基于Debian系统构建，提供带有Web控制界面的Dropbox后端服务，解决Linux环境下Dropbox安装及多字节文件名处理问题，支持通过浏览器管理同步任务，适合在服务器上部署和维护Dropbox服务。

核心功能

• Dropbox文件同步：支持多字节文件名处理，适配不同语言环境；
• Web控制界面：通过浏览器管理同步文件夹的包含/排除规则；
• LAN同步：同一局域网内的Dropbox实例可通过本地网络快速同步；
• 多实例部署：同一主机可运行多个独立Dropbox实例，配置互不干扰；
• 权限控制：通过环境变量设置同步文件的用户/组权限。

使用场景

• 个人用户在Linux服务器上部署Dropbox，实现文件云同步；
• 小型团队利用LAN同步功能减少互联网带宽占用，快速共享文件；
• 需要可视化管理Dropbox同步任务的场景。

配置说明

环境变量

• DBOX_UID：同步文件的用户ID，建议使用当前用户ID（id -u $USER）；
• DBOX_GID：同步文件的组ID，建议使用当前用户组ID（id -g $USER）；
• LOCALE：区域设置，支持多字节文件名（如zh_CN为中文）。

端口映射

• 9001:80：Web控制界面端口，建议绑定本地地址（127.0.0.1:9001:80）保障安全；
• 17500:17500：LAN同步端口，同一主机仅能暴露一个实例的此端口。

卷挂载

• ~/.dropbox:/dbox/.dropbox:z：映射Dropbox配置目录；
• ~/Dropbox:/dbox/Dropbox:z：映射同步目录，需确保目录所在文件系统为ext4。

Docker部署示例

启动脚本

bash
#!/bin/bash
docker run -d \
-p 127.0.0.1:9001:80 \
-p 17500:17500 \
--name=dropbox \
--restart=unless-stopped \
-e DBOX_UID=$(id -u $USER) \
-e DBOX_GID=$(id -g $USER) \
-e LOCALE=zh_CN \
-v ~/.dropbox:/dbox/.dropbox:z \
-v ~/Dropbox:/dbox/Dropbox:z \
fmadsen/dropbox

查看容器日志

bash
docker logs dropbox -f

首次启动步骤

1. 创建~/.dropbox和~/Dropbox目录，确保所有者/组ID与DBOX_UID/DBOX_GID一致；
2. 执行启动脚本；
3. 通过日志获取Dropbox账户连接链接，复制到浏览器完成绑定；
4. 访问http://localhost:9001进入Web控制界面。

Web控制界面

界面为Dropbox CLI的前端工具，可管理同步规则。自定义界面步骤：

1. 提取默认代码：docker cp dropbox:/dbox/dcontrol dcontrol；
2. 修改后，启动时添加卷挂载：-v ~/dcontrol:/dbox/dcontrol:z覆盖默认界面。

致谢

本镜像使用以下开源项目：

• Debian基础镜像：https://hub.docker.com/_/debian/
• Dropbox开源组件：[***]
• Dumb-init：https://github.com/Yelp/dumb-init
• Python 3.6、Nginx、PHP 7.3（Debian仓库）