shiftinv/seafile

Seafile Docker镜像文档

镜像概述和主要用途

Seafile Docker镜像旨在简化Seafile服务器的部署与更新流程。Seafile是一款开源的文件同步与共享服务器，通过Docker容器化部署，相比传统虚拟机更轻量、快速。该镜像包含Seafile团队推荐的最佳默认配置，7.0及以上版本采用多容器架构（分离MariaDB和Memcached服务），6.x版本则为单容器模式（集成数据库和缓存服务），适用于快速搭建私有云存储服务。

核心功能和特性

• 灵活部署模式：7.x+版本支持多容器架构（分离数据库和缓存服务），6.x版本提供单容器集成部署
• 最佳默认配置：预配置Seafile官方推荐的优化参数，简化初始化流程
• SSL支持：可自动申请Let's Encrypt证书，或使用自定义SSL证书
• 持久化存储：关键数据（配置、日志、数据库）通过卷挂载实现持久化，容器重建不丢失数据
• 便捷管理：支持自定义管理员账户、日志查看、容器内命令执行及配置修改
• 版本升级：通过拉取新镜像和重启容器即可完成服务器升级
• 垃圾回收：内置脚本支持Seafile存储的垃圾回收，清理未使用数据块释放空间

使用场景和适用范围

适用于个人用户、中小企业或团队搭建私有云存储服务，尤其适合需要简化服务器部署和维护流程的场景。可用于个人文件同步、团队协作共享、企业文档管理等需求，提供稳定高效的文件存储与访问解决方案。

详细使用方法和配置说明

版本说明

Seafile 7.x.x及以上

自7.0版本起，镜像调整为多容器架构，将MariaDB和Memcached服务分离到独立容器。

• 部署指南：部署文档
• 从6.3升级：升级文档

Seafile 6.x.x

以下为6.x版本的详细使用说明。

快速开始

运行Seafile服务器容器：

sh
docker run -d --name seafile \
  -e SEAFILE_SERVER_HOSTNAME=seafile.example.com \
  -v /opt/seafile-data:/shared \
  -p 80:80 \
  seafileltd/seafile:latest

首次初始化需等待几分钟，之后访问http://seafile.example.com即可打开Seafile Web界面。本地服务器的/opt/seafile-data目录会挂载到容器，日志和数据文件可在此目录下查看。

高级配置选项

自定义管理员账户和密码

默认管理员账户为me@example.com，密码为asecret。可通过环境变量设置自定义账户：

sh
docker run -d --name seafile \
  -e SEAFILE_SERVER_HOSTNAME=seafile.example.com \
  -e SEAFILE_ADMIN_EMAIL=admin@example.com \
  -e SEAFILE_ADMIN_PASSWORD=your_secure_password \
  -v /opt/seafile-data:/shared \
  -p 80:80 \
  seafileltd/seafile:latest

若忘记管理员密码，可添加新管理员账户后通过系统管理面板重置密码。

Let's Encrypt SSL证书

设置SEAFILE_SERVER_LETSENCRYPT=true可自动申请Let's Encrypt SSL证书：

sh
docker run -d --name seafile \
  -e SEAFILE_SERVER_LETSENCRYPT=true \
  -e SEAFILE_SERVER_HOSTNAME=seafile.example.com \
  -e SEAFILE_ADMIN_EMAIL=admin@example.com \
  -e SEAFILE_ADMIN_PASSWORD=your_secure_password \
  -v /opt/seafile-data:/shared \
  -p 80:80 \
  -p 443:443 \
  seafileltd/seafile:latest

使用自定义SSL证书：

• 创建目录/opt/seafile-data/ssl，将证书和私钥放入该目录
• 证书文件命名为seafile.example.com.crt，私钥文件命名为seafile.example.com.key（替换为实际域名）

修改Seafile服务器配置

配置文件位于shared/seafile/conf，可根据Seafile手册修改配置。修改后需重启容器：

sh
docker restart seafile

查看日志

• Seafile日志：容器内shared/logs/seafile或本地/opt/seafile-data/logs/seafile
• 系统日志：容器内shared/logs/var-log或本地/opt/seafile-data/logs/var-log（如Nginx日志在shared/logs/var-log/nginx/）

添加新管理员

确保容器运行中，执行以下命令：

sh
docker exec -it seafile /opt/seafile/seafile-server-latest/reset-admin.sh

根据提示输入用户名和密码，即可创建新管理员账户。

目录结构

/shared

用于挂载共享卷，存储持久化数据：

• /shared/db：MySQL数据库数据目录
• /shared/seafile：Seafile服务器配置和数据目录
• /shared/logs：日志目录
  • /shared/logs/var-log：容器内/var/log的挂载目录（如Nginx日志）
  • /shared/logs/seafile：Seafile服务器进程日志（如seafile.log）
• /shared/ssl：SSL证书目录（默认不存在，需手动创建）

升级Seafile服务器

升级到最新版本：

sh
docker pull seafileltd/seafile:latest
docker rm -f seafile
docker run -d --name seafile \
  -e SEAFILE_SERVER_LETSENCRYPT=true \
  -e SEAFILE_SERVER_HOSTNAME=seafile.example.com \
  -e SEAFILE_ADMIN_EMAIL=admin@example.com \
  -e SEAFILE_ADMIN_PASSWORD=your_secure_password \
  -v /opt/seafile-data:/shared \
  -p 80:80 \
  -p 443:443 \
  seafileltd/seafile:latest

早期使用launcher脚本的用户，请参考https://github.com/haiwen/seafile-docker/blob/master/upgrade_from_old_format.md%E6%96%87%E6%A1%A3%E3%80%82

垃圾回收

文件删除后，因重复数据删除机制，相关块不会立即移除。需运行垃圾回收清理未使用块：

sh
docker exec seafile /scripts/gc.sh

社区版会停止Seafile服务，完成后自动重启；专业版支持在线垃圾回收。

故障排除

使用以下命令排查问题：

sh
# 查看容器日志
docker logs -f seafile

# 进入容器内部
docker exec -it seafile bash