chaosbunker/seafile-pro

Seafile Docker镜像文档

镜像概述和主要用途

Seafile Docker镜像旨在简化Seafile服务器的部署与维护。Docker作为开源容器化技术，相比传统虚拟机更轻量、快速，使Seafile服务器的部署和更新变得更加容易。该镜像包含Seafile团队推荐的优化默认配置，同时针对不同版本采用不同架构：7.x及以上版本采用多容器架构（分离MariaDB和Memcached服务），6.x版本为单容器架构（集成MariaDB和Memcached）。

核心功能和特性

• 容器化部署：通过Docker容器化Seafile服务器，简化部署流程，降低环境依赖。
• 版本架构差异：7.x+采用多容器架构，分离数据库和缓存服务；6.x为单容器集成架构。
• 优化默认配置：内置Seafile团队推荐的最佳配置，确保服务器性能和稳定性。
• 灵活配置选项：支持自定义管理员账号密码、SSL证书（自动申请Let's Encrypt或使用自定义证书）。
• 持久化存储：关键数据（配置、日志、数据库）通过卷挂载实现持久化，容器重建不丢失数据。
• 便捷维护：提供日志查看、配置修改、管理员添加、垃圾回收等运维工具。

使用场景和适用范围

适用于需要快速搭建文件同步与共享服务的场景，包括企业内部文件管理、团队协作平台、个人私有云存储等。7.x版本适合生产环境，多容器架构提升稳定性和可维护性；6.x版本适合简单部署或旧版本迁移需求。

详细使用方法和配置说明

版本差异说明

Seafile 7.x.x

从7.0版本开始，镜像调整为多容器架构，将MariaDB和Memcached服务从Seafile主容器中分离，分别运行在独立容器中。

• 部署文档：https://download.seafile.com/published/seafile-manual/docker/deploy%20seafile%20with%20docker.md
• 从6.3升级到7.0：https://download.seafile.com/published/seafile-manual/docker/6.3%20upgrade%20to%207.0.md

Seafile 6.x.x

快速开始

运行Seafile服务器容器：

sh
docker run -d --name seafile \
  -e SEAFILE_SERVER_HOSTNAME=seafile.example.com \
  -v /opt/seafile-data:/shared \
  -p 80:80 \
  docker.xuanyuan.run/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=me@example.com \
  -e SEAFILE_ADMIN_PASSWORD=a_very_secret_password \
  -v /opt/seafile-data:/shared \
  -p 80:80 \
  docker.xuanyuan.run/seafileltd/seafile:latest

若忘记密码，可添加新管理员账号，然后在系统管理面板重置用户密码。

Let's Encrypt SSL证书

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

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

使用自定义证书：

• 创建目录/opt/seafile-data/ssl，放入证书和私钥
• 证书命名格式：[站点名称].crt（如seafile.example.com.crt）
• 私钥命名格式：[站点名称].key（如seafile.example.com.key）

修改Seafile服务器配置

配置文件位于shared/seafile/conf，可参考https://manual.seafile.com/%E4%BF%AE%E6%94%B9%E3%80%82%E4%BF%AE%E6%94%B9%E5%90%8E%E9%9C%80%E9%87%8D%E5%90%AF%E5%AE%B9%E5%99%A8%EF%BC%9A

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：证书目录（默认不存在，需手动创建）

升级Seafile服务器

升级到最新版本：

sh
docker pull docker.xuanyuan.run/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=me@example.com \
  -e SEAFILE_ADMIN_PASSWORD=a_very_secret_password \
  -v /opt/seafile-data:/shared \
  -p 80:80 \
  -p 443:443 \
  docker.xuanyuan.run/seafileltd/seafile:latest

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

垃圾回收

文件删除后，未被引用的块需通过垃圾回收清理。社区版会停止Seafile服务，完成后自动启动；专业版支持在线回收。执行命令：

sh
docker exec seafile /scripts/gc.sh

故障排除

使用Docker命令排查错误：

sh
# 查看容器日志
docker logs -f seafile
# 进入容器内部
docker exec -it seafile bash