版本：13.0 LTS 适用平台：Ubuntu 24.04 LTS 目标读者：系统管理员、运维工程师、企业IT负责人

重要声明：Seafile 13.0 社区版不再支持二进制包部署，官方推荐使用 Docker 进行部署。专业版仍支持二进制部署，但 Docker 同样是推荐方式。本文档以 Docker 部署为主。

第一篇基础环境

第1章 Seafile 13.0 概述

1.1 版本定位

Seafile 13.0 是一个里程碑版本，将 Seafile 从单纯的同步分享工具转变为更智能、更协作、AI 增强的文件平台。

1.2 13.0 重大新特性

1. 元数据服务器（Metadata Server） 全新的元数据服务器组件，允许为每个文件定义结构化属性——如项目阶段、负责人、状态、到期日期或任何自定义字段。元数据可被搜索、过滤、分组和排序。

2. 多视图显示 支持表格视图、看板视图、画廊视图、地图视图、卡片视图和统计视图。

3. 层级标签管理 支持多级标签层级结构，可表达标签之间的从属关系。

4. 实时 UI 更新 启用通知服务器后，当其他用户添加或删除文件时，Web 界面实时更新。

5. 专用缩略图服务器 新增缩略图服务器组件，提升缩略图生成性能，支持视频缩略图。

6. Seafile AI AI 可提取文件详情和文本、生成描述和标签、检测人脸等。

7. SeaSearch 1.0 生产级全文搜索。

8. SeaDoc 2.0 块编辑器、AI 辅助、白板（Excalidraw）。

9. Wiki 基于块的编辑、评论、Ask AI、sdoc/Markdown 导入导出。

1.3 系统要求

部署场景	CPU	内存	磁盘
社区版（Docker）	2核（>2GHz）	2GB+	50GB+
专业版（Docker）	4核（>2GHz）	4GB+	50GB+

生产环境建议：4核 CPU + 8GB 内存 + 100GB+ 磁盘。

1.4 架构变化

Seafile 13.0 引入了以下架构变化：

数据库和 Memcache 配置移至 .env 文件，推荐使用环境变量配置数据库和缓存
Redis 推荐作为 Memcache 服务器
S3 配置可通过环境变量完成，大幅简化
ElasticSearch 拥有独立的 yml 文件
Docker 镜像中的 Nginx 不再从映射卷读取配置

1.5 破坏性变更

变更项	说明
二进制部署（社区版）	不再支持
WebDAV LDAP 登录	因安全原因不再支持，LDAP 用户需在个人资料页生成 WebDAV Token
旧文件标签	旧标签功能不再可用，界面提供升级通知迁移到新标签系统

从 12.0 升级的用户：必须先迁移到 Docker 部署，再升级到 13.0。

第2章系统初始化

2.1 Ubuntu 24.04 基础配置

# 更新系统
sudo apt update && sudo apt upgrade -y
 
# 安装基础工具
sudo apt install -y curl wget gnupg ca-certificates \
    net-tools htop iotop sysstat vim git unzip \
    build-essential pkg-config
 
# 设置时区
sudo timedatectl set-timezone Asia/Shanghai
 
# 启用 NTP 同步
sudo timedatectl set-ntp true
sudo systemctl enable --now systemd-timesyncd

2.2 安装 Docker 和 Docker Compose

# 安装 Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
 
# 将当前用户加入 docker 组
sudo usermod -aG docker $USER
 
# 安装 Docker Compose（独立版本）
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
 
# 验证
docker --version
docker-compose --version

2.3 防火墙配置（UFW）

sudo ufw --force enable
sudo ufw default deny incoming
sudo ufw default allow outgoing
 
sudo ufw allow 22/tcp comment 'SSH'
sudo ufw allow 80/tcp comment 'HTTP'
sudo ufw allow 443/tcp comment 'HTTPS'
 
# 如需 OnlyOffice/Collabora
sudo ufw allow 9980/tcp comment 'Collabora Online'
 
sudo ufw status numbered

第二篇 Seafile 13.0 Docker 部署

第3章下载与配置

3.1 创建目录并下载配置文件

# 创建 Seafile 目录
sudo mkdir -p /opt/seafile
cd /opt/seafile
 
# 下载 Docker Compose 配置文件[reference:29]
sudo wget -O .env https://manual.seafile.com/13.0/repo/docker/ce/env
sudo wget https://manual.seafile.com/13.0/repo/docker/ce/seafile-server.yml
sudo wget https://manual.seafile.com/13.0/repo/docker/seadoc.yml
sudo wget https://manual.seafile.com/13.0/repo/docker/caddy.yml

3.2 配置 .env 文件

编辑 .env 文件，配置以下关键参数：

sudo nano .env

必须配置的参数：

变量	说明	示例
`SEAFILE_VOLUME`	Seafile 数据卷目录	`/opt/seafile-data`
`SEAFILE_MYSQL_VOLUME`	MySQL 数据卷目录	`/opt/seafile-mysql/db`
`SEAFILE_CADDY_VOLUME`	Caddy 证书存储目录	`/opt/seafile-caddy`
`INIT_SEAFILE_MYSQL_ROOT_PASSWORD`	MySQL root 密码（首次部署必需）	`your_strong_password`
`SEAFILE_MYSQL_DB_PASSWORD`	Seafile 数据库用户密码	`your_db_password`
`SEAFILE_SERVER_HOSTNAME`	服务器域名	`cloud.your-domain.com`

13.0 新增配置：

# 存储后端类型（13.0 新增）[reference:31][reference:32]
# 留空使用 seafile.conf 中的旧配置方式
SEAF_SERVER_STORAGE_TYPE=
 
# 缓存配置（13.0 推荐使用 Redis）[reference:33]
CACHE_PROVIDER=redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=
 
# 或使用 Memcached
# CACHE_PROVIDER=memcached
# MEMCACHED_HOST=memcached
# MEMCACHED_PORT=11211

3.3 启动 Seafile

cd /opt/seafile
 
# 首次启动（会自动拉取镜像并初始化）
sudo docker-compose -f seafile-server.yml up -d
 
# 查看运行状态
sudo docker-compose -f seafile-server.yml ps
 
# 查看日志
sudo docker-compose -f seafile-server.yml logs -f

3.4 创建管理员账户

# 进入 Seafile 容器
sudo docker exec -it seafile /bin/bash
 
# 在容器内创建管理员
cd /opt/seafile/seafile-server-latest
./seahub.sh python-env manage.py createsuperuser

3.5 验证部署

访问 https://your-domain.com，使用管理员账户登录。

如果使用 Let's Encrypt 自动证书（通过 Caddy），确保域名 DNS 解析正确。

第4章部署 SeaDoc（文档协作）

4.1 SeaDoc 2.0 概述

SeaDoc 在 13.0 中升级到 2.0 版本，支持 sdoc 文档和白板（Excalidraw）。

4.2 启动 SeaDoc

cd /opt/seafile
 
# 启动 SeaDoc 服务
sudo docker-compose -f seadoc.yml up -d
 
# 查看状态
sudo docker-compose -f seadoc.yml ps

4.3 配置 Nginx/Caddy 代理

如果使用 Caddy（默认），SeaDoc 会自动配置路由。如需手动配置 Nginx：

location /seadoc/ {
    proxy_pass http://127.0.0.1:8080/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

第5章部署缩略图服务器（13.0 新增）

5.1 概述

13.0 新增专用缩略图服务器组件，提升缩略图生成性能，并支持视频缩略图。

5.2 启用缩略图服务器

缩略图服务器默认随 Seafile 主容器启动。如需独立配置：

# 检查缩略图服务状态
sudo docker exec -it seafile ps aux | grep thumbnail
 
# 查看缩略图日志
sudo docker exec -it seafile cat /opt/seafile/logs/thumbnail-server.log

5.3 缩略图配置

在 seafile.conf 中可配置缩略图参数：

[thumbnail]
# 最大缩略图大小（像素）
max_size = 1024
# 缩略图质量（1-100）
quality = 85
# 支持的视频格式
video_formats = mp4,avi,mov,wmv,flv,mkv

第6章部署元数据服务器（13.0 新增）

6.1 概述

元数据服务器是 13.0 的核心新功能，允许为文件定义结构化属性。

6.2 启用元数据服务

元数据服务器默认随 Seafile 主容器启动。在 Web 界面中：

进入资料库
点击"元数据"选项卡
启用元数据功能
定义自定义属性（如：负责人、状态、到期日期、项目阶段等）

6.3 元数据 API

# 获取文件的元数据
curl -H "Authorization: Token YOUR_API_TOKEN" \
    https://your-domain.com/api/v2.1/repos/REPO_ID/metadata/FILE_ID/

第7章部署通知服务器（13.0 新增）

7.1 概述

通知服务器支持实时 UI 更新——当其他用户在同一资料库同一文件夹中添加或删除文件时，界面自动更新，无需手动刷新。

7.2 启用通知服务

通知服务器随 Seafile 主容器自动启动。确认配置：

# 检查通知服务
sudo docker exec -it seafile ps aux | grep notification

在 seafile.conf 中可配置：

[notification]
enabled = true
# 通知轮询间隔（秒）
polling_interval = 5

第8章部署 Seafile AI（13.0 新增）

8.1 概述

Seafile AI 为日常文件工作带来实用自动化：

提取文件详情和文本
生成文件描述
自动生成标签
人脸检测

8.2 启用 Seafile AI

Seafile AI 需要元数据服务启用后使用。

确保元数据服务已启用
在系统管理 → AI 设置中配置 AI 服务
配置 AI 模型 API（如 OpenAI API 或本地模型）

8.3 AI 配置示例

[ai]
# AI 服务提供商
provider = openai
# API Key
api_key = your_api_key
# 模型
model = gpt-4
# 启用功能
enable_extract = true
enable_description = true
enable_tagging = true
enable_face_detection = true

第三篇扩展插件部署

第9章 Collabora Online（LibreOffice 在线编辑）

9.1 概述

Seafile 支持集成 Collabora Online 进行在线预览和编辑 Office 文档。

9.2 部署 Collabora Online（Docker）

# 拉取 Collabora 镜像
docker pull collabora/code
 
# 启动容器
docker run -t -d -p 127.0.0.1:9980:9980 \
    -e "aliasgroup1=https://your-domain.com:443" \
    -e "username=admin" \
    -e "password=your_password" \
    --name collabora --restart always \
    collabora/code

9.3 配置 Seafile

在 Seafile 容器的 seahub_settings.py 中：

# 启用 Collabora Online
OFFICE_SERVER_TYPE = 'CollaboraOffice'
OFFICE_SERVER_URL = 'https://collabora.your-domain.com'

重启 Seafile：

sudo docker restart seafile

9.4 Nginx 代理配置

location ^~ /browser {
    proxy_pass https://127.0.0.1:9980;
    proxy_set_header Host $http_host;
}
 
location ~ ^/cool/(.*)/ws$ {
    proxy_pass https://127.0.0.1:9980;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_read_timeout 36000s;
}

第10章 OnlyOffice 集成

10.1 部署 OnlyOffice Document Server

docker run -i -t -d -p 6233:80 \
    -e JWT_ENABLED=true \
    -e JWT_SECRET=your_secret_key \
    --restart=always \
    --name onlyoffice-document-server \
    onlyoffice/documentserver

10.2 配置 Seafile

# seahub_settings.py
ENABLE_ONLYOFFICE = True
ONLYOFFICE_APIJS_URL = 'http://127.0.0.1:6233/web-apps/apps/api/documents/api.js'
ONLYOFFICE_FILE_EXTENSION = ('doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'odt', 'ods', 'odp')
ONLYOFFICE_EDIT_FILE_EXTENSION = ('docx', 'xlsx', 'pptx')

第四篇管理运维

第11章日常管理

11.1 Docker 服务管理

cd /opt/seafile
 
# 启动所有服务
sudo docker-compose -f seafile-server.yml up -d
 
# 停止所有服务
sudo docker-compose -f seafile-server.yml down
 
# 重启服务
sudo docker-compose -f seafile-server.yml restart
 
# 查看日志
sudo docker-compose -f seafile-server.yml logs -f --tail=100
 
# 进入容器
sudo docker exec -it seafile /bin/bash

11.2 服务状态检查

# 查看所有容器状态
sudo docker-compose -f /opt/seafile/seafile-server.yml ps
 
# 查看 Seafile 服务状态（容器内）
sudo docker exec -it seafile /opt/seafile/seafile-server-latest/seafile.sh status

11.3 管理员面板

通过 Web 界面：登录 → 右上角头像 → 系统管理

功能包括：

用户管理
资料库管理
系统设置
日志查看
元数据管理（13.0 新增）

第12章用户管理

12.1 创建用户

Web 界面：系统管理 → 用户 → 添加用户

命令行：

sudo docker exec -it seafile /bin/bash
cd /opt/seafile/seafile-server-latest
./seahub.sh python-env manage.py createuser user@example.com

12.2 LDAP/AD 集成

Seafile 13.0 中 WebDAV 不再支持 LDAP 登录，LDAP 用户需在个人资料页生成 WebDAV Token。

配置 seahub_settings.py：

ENABLE_LDAP = True
LDAP_SERVER_URL = 'ldap://ldap.your-domain.com'
LDAP_BASE_DN = 'dc=your-domain,dc=com'
LDAP_ADMIN_DN = 'cn=admin,dc=your-domain,dc=com'
LDAP_ADMIN_PASSWORD = 'admin_password'
LDAP_USER_ATTR_MAP = {
    'uid': 'mail',
    'name': 'displayName',
    'email': 'mail'
}

第13章日志管理

13.1 日志位置

日志类型	位置（容器内）
Seafile 服务	`/opt/seafile/logs/seafile.log`
Seahub	`/opt/seafile/logs/seahub.log`
CCnet	`/opt/seafile/logs/ccnet.log`
缩略图服务器	`/opt/seafile/logs/thumbnail-server.log`
SeaDoc	`/opt/seafile/logs/sdoc.log`

13.2 查看日志

# 查看 Seafile 日志
sudo docker exec -it seafile tail -100 /opt/seafile/logs/seafile.log
 
# 查看 Seahub 日志
sudo docker exec -it seafile tail -100 /opt/seafile/logs/seahub.log

第14章备份与恢复

14.1 备份内容

Seafile Docker 部署需要备份：

数据卷：/opt/seafile-data/
MySQL 数据卷：/opt/seafile-mysql/
配置文件：/opt/seafile/.env 和 *.yml

14.2 备份脚本

#!/bin/bash
# /opt/scripts/backup-seafile.sh
 
BACKUP_DIR="/backup/seafile"
DATE=$(date +%Y%m%d_%H%M%S)
SEAFILE_DIR="/opt/seafile"
 
mkdir -p $BACKUP_DIR
 
# 停止服务
cd $SEAFILE_DIR
sudo docker-compose -f seafile-server.yml down
 
# 备份数据卷
sudo tar -czf $BACKUP_DIR/seafile-data-$DATE.tar.gz /opt/seafile-data/
sudo tar -czf $BACKUP_DIR/seafile-mysql-$DATE.tar.gz /opt/seafile-mysql/
 
# 备份配置
sudo tar -czf $BACKUP_DIR/seafile-config-$DATE.tar.gz \
    $SEAFILE_DIR/.env \
    $SEAFILE_DIR/*.yml
 
# 启动服务
sudo docker-compose -f seafile-server.yml up -d
 
# 保留最近30天备份
find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete

14.3 恢复步骤

# 1. 停止并移除现有容器
cd /opt/seafile
sudo docker-compose -f seafile-server.yml down
 
# 2. 恢复数据卷
sudo tar -xzf /backup/seafile/seafile-data-20260101.tar.gz -C /
sudo tar -xzf /backup/seafile/seafile-mysql-20260101.tar.gz -C /
 
# 3. 恢复配置
sudo tar -xzf /backup/seafile/seafile-config-20260101.tar.gz -C /
 
# 4. 启动服务
sudo docker-compose -f seafile-server.yml up -d

第15章升级

15.1 从 12.0 升级到 13.0

重要：Seafile 13.0 社区版不再支持二进制部署。如果使用 12.0 二进制部署，必须先迁移到 Docker 部署，再升级到 13.0。

迁移路径：

在 12.0 版本先将二进制部署迁移到 Docker 部署
再按照 Docker 升级流程升级到 13.0

15.2 Docker 升级步骤（13.0.x 小版本）

cd /opt/seafile
 
# 1. 停止服务
sudo docker-compose -f seafile-server.yml down
 
# 2. 备份当前配置
cp .env .env.bak
cp seafile-server.yml seafile-server.yml.bak
 
# 3. 更新 .env 中的镜像版本
# SEAFILE_IMAGE=seafileltd/seafile-mc:13.0-latest
 
# 4. 如从 12 升级，下载新的 compose 文件[reference:44]
wget -O seafile-server.yml https://manual.seafile.com/13.0/repo/docker/ce/seafile-server.yml
 
# 5. 更新 .env 配置（13.0 新增）[reference:45]
# 添加缓存配置
echo "CACHE_PROVIDER=redis" >> .env
echo "REDIS_HOST=redis" >> .env
echo "REDIS_PORT=6379" >> .env
 
# 6. 启动服务
sudo docker-compose -f seafile-server.yml up -d
 
# 7. 运行升级脚本（容器内）
sudo docker exec -it seafile /bin/bash
cd /opt/seafile/seafile-server-latest
./upgrade/upgrade_12_13.sh

15.3 升级注意事项

升级前需执行：

清理数据库表：运行升级脚本前清理

安装新系统库和 Python 库：

apt-get install -y python3 python3-dev python3-setuptools python3-pip \
    python3-ldap python3-rados libmysqlclient-dev ldap-utils \
    libldap2-dev python3.12-venv default-libmysqlclient-dev
 
pip3 install --timeout=3600 boto3 oss2 twilio configparser pytz \
    sqlalchemy==2.0.* pymysql==1.1.* jinja2 django-pylibmc pylibmc redis

第16章垃圾回收（GC）

16.1 运行 GC

sudo docker exec -it seafile /bin/bash
cd /opt/seafile/seafile-server-latest
 
# 预览模式
./seaf-gc.sh --dry-run
 
# 执行 GC
./seaf-gc.sh

社区版：运行 GC 前需停止 Seafile 服务。 专业版：支持在线 GC。

第17章性能优化

17.1 使用 Redis 缓存（13.0 推荐）

从 Seafile 13.0 开始，Redis 被推荐作为主要缓存服务器，以支持新功能。

在 .env 中配置：

CACHE_PROVIDER=redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=your_redis_password

17.2 数据库优化

在 seafile.conf 中：

[database]
# 连接池大小
pool_size = 20
# 最大连接数
max_connections = 100

17.3 缩略图性能（13.0 新增）

专用缩略图服务器大幅提升缩略图生成性能。配置：

[thumbnail]
# 并发生成线程数
threads = 4
# 缓存大小（MB）
cache_size = 1024

第五篇故障排查

第18章常见错误与解决方案

E001：Docker 容器无法启动

现象：

Error response from daemon: Conflict. The container name "/seafile" is already in use

解决方案：

sudo docker-compose -f /opt/seafile/seafile-server.yml down
sudo docker-compose -f /opt/seafile/seafile-server.yml up -d

E002：数据库连接失败

现象：

Can't connect to MySQL server on 'db'

原因：MySQL 容器未就绪或密码配置错误

解决方案：

# 检查 MySQL 容器状态
sudo docker ps | grep mysql
 
# 查看 MySQL 日志
sudo docker logs seafile-mysql
 
# 检查 .env 中的数据库密码

E003：Let's Encrypt 证书申请失败

现象：

Failed to obtain certificate

原因：域名 DNS 解析未指向服务器，或 80/443 端口被占用

解决方案：

# 确认域名解析
dig your-domain.com
 
# 确认端口开放
sudo netstat -tlnp | grep -E "80|443"

E004：SeaDoc 无法加载

现象：

Failed to load SeaDoc

解决方案：

# 检查 SeaDoc 容器状态
sudo docker-compose -f /opt/seafile/seadoc.yml ps
 
# 查看 SeaDoc 日志
sudo docker-compose -f /opt/seafile/seadoc.yml logs

E005：缩略图不显示（13.0）

现象：图片或视频缩略图无法生成

解决方案：

# 检查缩略图服务器状态
sudo docker exec -it seafile ps aux | grep thumbnail
 
# 查看缩略图日志
sudo docker exec -it seafile cat /opt/seafile/logs/thumbnail-server.log

E006：迁移旧标签失败（13.0）

现象：升级后旧标签不可用

原因：13.0 不再支持旧标签系统

解决方案：Web 界面会显示升级通知，点击迁移数据到新标签系统。

E007：WebDAV 认证失败（13.0）

现象：

WebDAV authentication failed

原因：13.0 不再支持 LDAP 账户直接登录 WebDAV

解决方案：LDAP 用户在个人资料页生成 WebDAV Token，使用 Token 认证。

E008：磁盘空间不足

解决方案：

# 运行 GC
sudo docker exec -it seafile /opt/seafile/seafile-server-latest/seaf-gc.sh
 
# 清理 Docker 无用数据
sudo docker system prune -f

E009：元数据服务不可用（13.0）

现象：无法启用元数据功能

解决方案：

# 检查元数据服务
sudo docker exec -it seafile ps aux | grep metadata
 
# 检查 seafile.conf 配置
sudo docker exec -it seafile cat /opt/seafile/conf/seafile.conf | grep metadata

第19章日志位置汇总（Docker）

组件	日志位置（容器内）
Seafile 服务	`/opt/seafile/logs/seafile.log`
Seahub	`/opt/seafile/logs/seahub.log`
CCnet	`/opt/seafile/logs/ccnet.log`
控制器	`/opt/seafile/logs/controller.log`
SeaDoc	`/opt/seafile/logs/sdoc.log`
缩略图服务器（13.0）	`/opt/seafile/logs/thumbnail-server.log`
元数据服务器（13.0）	`/opt/seafile/logs/metadata-server.log`
通知服务器（13.0）	`/opt/seafile/logs/notification-server.log`
MySQL	`docker logs seafile-mysql`
Caddy	`docker logs seafile-caddy`

附录

附录 A：13.0 新特性速查

新特性	说明	文档章节
元数据服务器	文件自定义属性管理	第6章
多视图显示	表格/看板/画廊/地图/卡片/统计	第1章
层级标签	多级标签层级结构	第1章
实时 UI 更新	通知服务器支持	第7章
缩略图服务器	视频缩略图支持	第5章
Seafile AI	AI 文件处理	第8章
SeaSearch 1.0	生产级全文搜索	第1章
SeaDoc 2.0	块编辑器 + 白板	第4章
Wiki	块编辑 + AI	第1章

附录 B：常用命令速查

# ============================================
# Docker 服务管理
# ============================================
cd /opt/seafile
sudo docker-compose -f seafile-server.yml up -d      # 启动
sudo docker-compose -f seafile-server.yml down       # 停止
sudo docker-compose -f seafile-server.yml restart    # 重启
sudo docker-compose -f seafile-server.yml ps         # 状态
sudo docker-compose -f seafile-server.yml logs -f    # 日志
 
# ============================================
# 进入容器
# ============================================
sudo docker exec -it seafile /bin/bash
 
# ============================================
# 用户管理（容器内）
# ============================================
cd /opt/seafile/seafile-server-latest
./seahub.sh python-env manage.py createuser email@example.com
./seahub.sh python-env manage.py listusers
 
# ============================================
# 垃圾回收（容器内）
# ============================================
./seaf-gc.sh --dry-run    # 预览
./seaf-gc.sh              # 执行
 
# ============================================
# 查看 Seafile 13.0 版本
# ============================================
sudo docker exec -it seafile /opt/seafile/seafile-server-latest/seafile.sh version

附录 C：参考文档

Seafile 官方手册：https://manual.seafile.com/
Seafile 13.0 Docker 部署：https://manual.seafile.com/13.0/setup/setup_ce_by_docker/
Seafile 13.0 升级说明：https://manual.seafile.com/14.0/upgrade/upgrade_notes_for_13.0.x/
Seafile 博客（13.0 发布）：https://blog.seafile.com/seafile-13-0-is-ready-470c5e75f6fc
Seafile 社区论坛：https://forum.seafile.com/
Collabora Online：https://www.collaboraoffice.com/
OnlyOffice 文档服务器：https://www.onlyoffice.com/document-server.aspx

本文档基于 Seafile 13.0 LTS 编写，适用于 Ubuntu 24.04 LTS 生产环境部署。

第一篇 基础环境

第1章 Seafile 13.0 概述

1.1 版本定位

1.2 13.0 重大新特性

1.3 系统要求

1.4 架构变化

1.5 破坏性变更

第2章 系统初始化

2.1 Ubuntu 24.04 基础配置

2.2 安装 Docker 和 Docker Compose

2.3 防火墙配置（UFW）

第二篇 Seafile 13.0 Docker 部署

第3章 下载与配置

3.1 创建目录并下载配置文件

3.2 配置 .env 文件

3.3 启动 Seafile

3.4 创建管理员账户

3.5 验证部署

第4章 部署 SeaDoc（文档协作）

4.1 SeaDoc 2.0 概述

4.2 启动 SeaDoc

4.3 配置 Nginx/Caddy 代理

第5章 部署缩略图服务器（13.0 新增）

5.1 概述

5.2 启用缩略图服务器

5.3 缩略图配置

第6章 部署元数据服务器（13.0 新增）

6.1 概述

6.2 启用元数据服务

6.3 元数据 API

第7章 部署通知服务器（13.0 新增）

7.1 概述

7.2 启用通知服务

第8章 部署 Seafile AI（13.0 新增）

8.1 概述

8.2 启用 Seafile AI

8.3 AI 配置示例

第三篇 扩展插件部署

第9章 Collabora Online（LibreOffice 在线编辑）

9.1 概述

9.2 部署 Collabora Online（Docker）

9.3 配置 Seafile

9.4 Nginx 代理配置

第10章 OnlyOffice 集成

10.1 部署 OnlyOffice Document Server

10.2 配置 Seafile

第四篇 管理运维

第11章 日常管理

11.1 Docker 服务管理

11.2 服务状态检查

11.3 管理员面板

第12章 用户管理

12.1 创建用户

12.2 LDAP/AD 集成

第13章 日志管理

13.1 日志位置

13.2 查看日志

第14章 备份与恢复

14.1 备份内容

14.2 备份脚本

14.3 恢复步骤

第15章 升级

15.1 从 12.0 升级到 13.0

15.2 Docker 升级步骤（13.0.x 小版本）

15.3 升级注意事项

第16章 垃圾回收（GC）

16.1 运行 GC

第17章 性能优化

17.1 使用 Redis 缓存（13.0 推荐）

17.2 数据库优化

17.3 缩略图性能（13.0 新增）

第五篇 故障排查

第18章 常见错误与解决方案

E001：Docker 容器无法启动

E002：数据库连接失败

E003：Let's Encrypt 证书申请失败

E004：SeaDoc 无法加载

E005：缩略图不显示（13.0）

E006：迁移旧标签失败（13.0）

E007：WebDAV 认证失败（13.0）

第一篇基础环境

第2章系统初始化

第3章下载与配置

第4章部署 SeaDoc（文档协作）

第5章部署缩略图服务器（13.0 新增）

第6章部署元数据服务器（13.0 新增）

第7章部署通知服务器（13.0 新增）

第8章部署 Seafile AI（13.0 新增）

第三篇扩展插件部署

第四篇管理运维

第11章日常管理

第12章用户管理

第13章日志管理

第14章备份与恢复

第15章升级

第16章垃圾回收（GC）

第17章性能优化

第五篇故障排查

第18章常见错误与解决方案

第19章日志位置汇总（Docker）