Docker部署Seafile私有云盘核心是用docker-compose.yml协同启动数据库、缓存和主服务；需配置正确目录权限、端口及环境变量，15分钟内可访问首页，502错误多因数据库连接失败导致。
用 Docker 部署 Seafile 私有云盘，核心是把数据库、缓存和主服务三者通过 docker-compose.yml 协同启动，而不是手动拉镜像、连网络、配环境。只要配置合理、目录权限正确、端口不冲突，整个过程 15 分钟内就能访问首页。
准备基础运行环境
确保宿主机已安装 Docker 和 docker-compose（建议 2.0+ 版本）。非 root 用户需加入 docker 组：
-
sudo usermod -aG docker $USER，然后重新登录终端 - 创建统一工作目录，例如
/seafile，并在其下建立data（存文件与数据库）、logs（可选）子目录 - 检查系统时间是否准确，Seafile 对 HTTPS 证书和会话时效敏感，偏差过大可能导致登录失败或 502
编写并启动 docker-compose.yml
使用官方推荐的 seafileltd/seafile-mc 镜像（含 Memcached 支持），关键字段必须按需修改：
-
SEAFILE_ADMIN_EMAIL和SEAFILE_ADMIN_PASSWORD：设置首次登录的管理员账号，密码需满足 8 位以上、含大小写字母+数字 -
ports：建议映射"80:80"或"8000:80"，避免与宿主机 Nginx/Apache 冲突；如需外网 HTTPS，后续再加反向代理 -
volumes：确保./data/seafile-data:/shared路径存在且容器有写入权限（chown -R 1001:1001 ./data可预防权限报错）
保存后执行 docker-compose up -d，等待约 60 秒，运行 docker-compose logs -f seafile 查看初始化日志，出现 seahub is running 表示启动成功。
常见 502 错误排查重点
页面打开显示 502，90% 情况不是 Web 层问题，而是后端连接异常：
- 检查
db容器是否正常运行：docker-compose ps db，若状态为Exit 1，多半是MYSQL_ROOT_PASSWORD不一致或磁盘空间不足 - 确认
seafile容器能否连通数据库：docker-compose exec seafile ping -c 2 db和nc -zv db 3306 - 查看 Seafile 日志中是否有
failed to connect to mysql或can't connect to local MySQL server提示，此时需核对DB_HOST（应为服务名db，不是localhost）和DB_ROOT_PASSWD是否与 db 容器环境变量完全一致
首次访问与基础配置
浏览器打开 http://服务器IP（或你映射的端口），使用初始化时设定的邮箱和密码登录：
- 登录后进入「系统管理 → 设置」，补全
SERVICE_URL（例如https://cloud.example.com），这是客户端同步、邮件通知、WebDAV 的基础地址，务必填写正确且可解析 - 如需启用 HTTPS，不要在容器内配证书，应在宿主机用 Nginx/Caddy 做反向代理，并将
X-Forwarded-Proto: https透传给 Seafile - 安卓/iOS 客户端添加服务器时，填入完整
SERVICE_URL，协议必须匹配（HTTP/HTTPS），端口默认不显示，除非你改了映射
