ggogel/seahub-media

容器化Seafile部署

基于Docker、Docker Swarm和Kubernetes的完全容器化Seafile部署方案。

目录

1. 特性
2. 架构
3. 快速开始
4. 附加信息

特性

• 基于官方Docker部署进行全新设计，融入容器化最佳实践。
• 将seahub（前端）和seafile server（后端）运行在独立容器中，通过TCP相互通信。
• 无需专业版即可实现集群部署。
• 独立Caddy容器作为反向代理。
• 增强安全性：
  • Caddy反向代理作为栈的单一入口点，其他服务运行在隔离网络中。
  • 前端基于Alpine Linux镜像构建，该系统专为安全性设计，具备主动安全特性。
  • 官方Seafile Docker部署使用完全过时的基础镜像和依赖，本方案定期更新基础镜像和依赖。
• 改进的Dockerfile采用多阶段构建，实现更小的镜像体积和更快的构建速度。
• 通过cron任务调度离线垃圾回收。
• 部署新版本镜像时自动运行升级脚本。
• 包含Seafile社区版的所有功能。

架构

服务

• seafile-server
  • 包含名为https://github.com/haiwen/seafile-server%E7%9A%84%E5%90%8E%E7%AB%AF%E7%BB%84%E4%BB%B6
  • 处理存储、客户端直接访问和seafdav
• seahub
  • 名为https://github.com/haiwen/seahub%E7%9A%84%E5%8A%A8%E6%80%81%E5%89%8D%E7%AB%AF%E7%BB%84%E4%BB%B6
  • 提供Web UI服务
  • 与seafile-server通信
• seahub-media
  • 提供静态网站内容、头像和自定义徽标服务
• db
  • seafile-server和seahub使用的数据库
• memcached
  • seahub的数据库缓存
• seafile-caddy
  • 反向代理，将请求路径转发到正确的端点（seafile-server、seahub或seahub-media）
  • 作为部署的单一外部入口点

卷

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

注意：在官方Docker部署中，自定义内容和头像由nginx提供服务。由于某些原因，Seahub无法单独提供这些服务，因此需要独立卷。

网络

• seafile-net
  • 服务间通信使用的隔离本地网络

快速开始

1. 前提条件

需安装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

2. 获取compose文件

使用以下compose文件作为起点：

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

3. 设置环境变量

重要：环境变量仅在首次部署时生效。卷中已存在的配置不会被覆盖。

首次部署时，需仔细设置这些值。后续修改可能比较复杂，请参考Seafile文档了解如何更改配置值。

seafile-server

• MariaDB服务的名称（自动作为Docker内部主机名）

  - DB_HOST=db 
  

• MariaDB root用户密码，必须与MYSQL_ROOT_PASSWORD一致

  - DB_ROOT_PASSWD=db_dev
  

• Seafile使用的时区

  - TIME_ZONE=Europe/Berlin
  

• 用于SERVICE_URL和FILE_SERVER_ROOT的URL

  重要：后续在配置文件中修改这些值无效，因为它们已写入数据库。这些值优先于配置文件。如需更改，请通过Web UI的"系统管理"部分操作。文件上传问题通常与此配置错误有关。

  - SEAFILE_URL=seafile.mydomain.com 
  

• 如计划使用HTTPS反向代理，设为true。这将在SERVICE_URL和FILE_SERVER_ROOT中用https替换http

  - HTTPS=false
  

seahub

• 第一个管理员用户的用户名/电子***

  - SEAFILE_ADMIN_EMAIL=me@example.com
  

• 第一个管理员用户的密码

  - SEAFILE_ADMIN_PASSWORD=asecret
  

db

• MariaDB root用户密码，必须与DB_ROOT_PASSWD一致

  - MYSQL_ROOT_PASSWORD=db_dev
  

• 启用控制台日志

  - MYSQL_LOG_CONSOLE=true
  

4. （可选）反向代理

部署中集成的Caddy反向代理暴露80端口。可将现有反向代理指向此端口。

与官方部署不同，本部署设计上不包含支持HTTPS和Let's Encrypt的反向代理，因为Docker用户通常已部署此类基于Docker的反向代理解决方案。

5. 部署

Docker Compose

完成上述步骤并正确配置后，运行：

docker-compose -p seafile up -d

Docker Swarm

完成上述步骤并正确配置后，运行：

docker stack deploy -c docker-compose.yml seafile

常见问题

1. Seafile无法使用Docker Compose部署连接LDAP、OAuth、SMTP或其他外部服务

所有服务都连接到默认配置为internal的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%87%E5%88%B0bug%E6%88%96%E6%9C%89%E5%8A%9F%E8%83%BD%E8%AF%B7%E6%B1%82%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4issue%E3%80%82

本项目仅支持兼容Compose规范的工具，如docker compose、podman compose和nerdctl compose，以及Kubernetes。不支持不完全符合这些标准的部署方法，如podman quadlet或podman play。目前这些工具将所有容器运行在同一个pod中，创建了完全不同的网络结构。请不要为此类问题提交issue。