ggogel/seafile-caddy

Seafile容器化部署方案

基于Docker、Docker Swarm和Kubernetes的Seafile完整容器化部署方案，采用微服务架构实现前后端分离，增强安全性与可维护性。

目录

1. 核心功能
2. 架构结构
3. 快速开始
4. 补充信息

核心功能

• 最佳实践设计：基于容器化最佳实践重新设计官方Docker部署方案，优化架构与安全性。
• 前后端分离：seahub（前端）与seafile-server（后端）运行在独立容器中，通过TCP通信。
• 无专业版集群：无需Seafile专业版即可实现集群部署。
• 独立反向代理：集成Caddy容器作为反向代理，统一入口管理。
• 增强安全性：
  • Caddy反向代理作为唯一外部入口，其他服务运行在隔离网络中。
  • 前端使用Alpine Linux基础镜像，具备主动安全特性，注重安全性设计。
  • 定期更新基础镜像及依赖，解决官方部署中基础镜像过时问题。
• 优化构建：采用多阶段构建的Dockerfile，减小镜像体积，加快构建速度。
• 自动化运维：通过Cron任务调度离线垃圾回收，部署新版本时自动运行升级脚本。
• 完整社区版功能：包含Seafile社区版的全部功能。

架构结构

服务组件

• seafile-server

  • 包含后端组件https://github.com/haiwen/seafile-server%E3%80%82
  • 处理存储、客户端直接访问及seafdav服务。

• seahub

  • 动态前端组件https://github.com/haiwen/seahub%E3%80%82
  • 提供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%E3%80%82
Docker 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文档。

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，将SERVICE_URL和FILE_SERVER_ROOT中的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%E5%8F%AF%E6%8F%90%E4%BA%A4issue%E3%80%82

本项目仅支持符合Compose Specification的工具（如docker compose、podman compose、nerdctl compose及Kubernetes）。不支持podman quadlet、podman play等工具，因其将所有容器运行在同一pod中，导致网络结构改变，此类问题请避免提交issue。