scumbug/seafile

关于

• Docker 是一个开源项目，用于打包、分发和运行任何Linux应用，相比传统虚拟机，容器更轻量、启动更快。
• Docker极大简化了https://github.com/haiwen/seafile%E7%9A%84%E9%83%A8%E7%BD%B2%E5%92%8C%E6%9B%B4%E6%96%B0%E6%B5%81%E7%A8%8B%E3%80%82
• 该基础镜像采用Seafile团队推荐的最佳默认配置。

若不熟悉Docker命令，请参考Docker文档。

Seafile 7.x.x 版本说明

从7.0版本开始，seafile-docker镜像调整为多容器架构。旧版镜像将MariaDB-Server和Memcached与Seafile服务器运行在同一容器中，新版则将这两个服务剥离，分别运行在独立容器中。

• 若计划部署Seafile 7.0，请参考部署文档。
• 若计划从6.3版本升级至7.0版本，请参考升级文档。

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

若使用自有SSL证书：

• 创建文件夹/opt/seafile-data/ssl，并将证书和私钥放入该目录。
• 假设站点名称为seafile.example.com，证书文件名必须为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。

添加新管理员

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

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/var-log/nginx/。
  • /shared/logs/seafile：Seafile服务器进程的日志目录，例如seaf-server日志位于shared/logs/seafile/seafile.log。
• /shared/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=me@example.com \
  -e SEAFILE_ADMIN_PASSWORD=a_very_secret_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

垃圾回收

文件删除后，其数据块不会立即删除（可能被其他文件引用，因去重机制）。需通过Seafile的垃圾回收流程清理未使用的块（注意：技术原因，无法保证删除所有孤立块）。

容器内/scripts目录包含所需脚本，执行以下命令进行垃圾回收：docker exec seafile /scripts/gc.sh。社区版会停止Seafile服务器，完成后自动重启；专业版支持在线垃圾回收。

故障排除

可使用以下Docker命令排查错误：

sh
docker logs -f seafile
# 或
docker exec -it seafile bash