ggogel/seahub

Seafile容器化部署方案

Seafile的全容器化部署，适用于Docker、Docker Swarm和Kubernetes环境，遵循容器化最佳实践设计。

目录

1. 核心功能
2. 架构结构
3. 快速开始
4. 常见问题
5. 高级配置与故障排除

核心功能

• 基于官方Docker部署方案的彻底重构，遵循容器化最佳实践
• 前后端分离部署：seahub（前端）和seafile server（后端）运行在独立容器中，通过TCP通信
• 支持社区版集群部署，无需专业版许可
• 独立Caddy容器作为反向代理，统一入口管理
• 增强安全性：
  • Caddy反向代理作为唯一外部入口，其他服务运行在隔离网络中
  • 前端使用Alpine Linux基础镜像，具备主动安全特性
  • 定期更新基础镜像和依赖项（官方部署使用过时依赖）
• 多阶段构建优化Dockerfile，减小镜像体积并加速构建
• 支持通过cron任务调度离线垃圾回收
• 部署新版本镜像时自动运行升级脚本
• 包含Seafile社区版全部功能

架构结构

服务组件

• seafile-server
  • 包含后端组件https://github.com/haiwen/seafile-server
  • 处理存储、客户端直接访问和seafdav协议
• seahub
  • 动态前端组件https://github.com/haiwen/seahub
  • 提供Web用户界面
  • 与seafile-server通信
• seahub-media
  • 提供静态网站内容、用户头像和自定义logo
• db
  • 供seafile-server和seahub使用的数据库服务
• memcached
  • seahub的数据库缓存服务
• seafile-caddy
  • 反向代理，将请求转发至seafile-server、seahub或seahub-media
  • 作为部署的唯一外部入口

数据卷

• seafile-data
  • seafile-server和seahub的共享数据卷
  • 包含配置文件和日志文件
• seafile-mariadb
  • db服务的数据卷，存储数据库数据
• seahub-custom
  • 存储自定义logo，由seahub管理、seahub-media提供访问
• seahub-avatars
  • 存储用户头像，由seahub管理、seahub-media提供访问

注意：官方Docker部署中，自定义内容和头像由nginx提供服务，而seahub本身无法直接提供这些内容，因此需要独立卷。

网络

• seafile-net
  • 内部隔离网络，用于各服务间通信

快速开始

前提条件

需安装Docker和docker-compose。Kubernetes部署请参考https://github.com/ggogel/seafile-containerized/wiki/Kubernetes%EF%BC%8CDocker Swarm部署注意事项请参考https://github.com/ggogel/seafile-containerized/wiki/Docker-Swarm%E3%80%82

获取compose文件

以官方compose文件为基础进行配置：

bash
wget https://raw.githubusercontent.com/ggogel/seafile-containerized/master/compose/docker-compose.yml

设置环境变量

重要：环境变量仅在首次部署时生效，卷中已存在的配置不会被覆盖。如需修改配置，请参考Seafile文档或通过Web界面的"系统管理"进行。

seafile-server

• DB_HOST=db：mariadb服务的Docker内部主机名
• DB_ROOT_PASSWD=db_dev：mariadb root用户密码，需与MYSQL_ROOT_PASSWORD一致
• TIME_ZONE=Europe/Berlin：Seafile使用的时区
• SEAFILE_URL=seafile.mydomain.com：用于SERVICE_URL和FILE_SERVER_ROOT，后续需通过Web界面修改
• HTTPS=false：若使用HTTPS反向代理，设为true以替换URL中的http为https

seahub

• SEAFILE_ADMIN_EMAIL=me@example.com：初始管理员***/用户名
• SEAFILE_ADMIN_PASSWORD=asecret：初始管理员密码

db

• MYSQL_ROOT_PASSWORD=db_dev：mariadb root用户密码，需与DB_ROOT_PASSWD一致
• MYSQL_LOG_CONSOLE=true：启用控制台日志

反向代理配置（可选）

部署中集成的Caddy反向代理暴露80端口，可将现有反向代理指向该端口。本部署默认不包含HTTPS和Let's Encrypt功能（与官方部署不同），因为Docker用户通常已有专用反向代理解决方案。

部署步骤

Docker Compose部署

完成上述配置后执行：

bash
docker-compose -p seafile up -d

Docker Swarm部署

完成上述配置后执行：

bash
docker stack deploy -c docker-compose.yml seafile

常见问题

Seafile无法连接LDAP、OAuth、SMTP等外部服务

所有服务默认连接至seafile-net内部网络，该网络默认阻止外部连接。解决方案请参考https://github.com/ggogel/seafile-containerized/wiki/LDAP%E3%80%82

高级配置与故障排除

高级配置和故障排除请参考https://github.com/ggogel/seafile-containerized/wiki%E3%80%82%E5%A6%82%E9%81%87bug%E6%88%96%E5%8A%9F%E8%83%BD%E9%9C%80%E6%B1%82%EF%BC%8C%E6%AC%A2%E8%BF%8E%E6%8F%90%E4%BA%A4issue%E3%80%82

本项目仅支持兼容Compose Specification的工具（如docker compose、podman compose、nerdctl compose）及Kubernetes。不支持不完全符合标准的部署方式（如podman quadlet或podman play），这些工具会将所有容器运行在同一pod中，导致网络结构完全不同，相关问题将不予处理。