从 Seafile 13 升级到 14 时需要迁移的配置
在删除旧配置前，请备份 .env 文件和 conf/ 目录下的配置文件，并先迁移需要保留的配置值。下载最新版 替换已有部署文件。具体升级步骤请参阅从 Seafile 13.0 升级到 14.0（Docker）。
seafdav.conf
将以下 [WEBDAV] 配置迁移到 Seafile 服务器的 .env 文件，然后从 seafdav.conf 中删除这些旧配置：
旧配置项
.env 中的替代配置项
enabled
ENABLE_SEAFDAV（默认值：false）
workers
SEAFDAV_WORKERS（默认值：5）
seahub_settings.py
删除或迁移以下配置：
旧配置项
处理方式
DISABLE_ADFS_USER_PWD_LOGIN、ENABLE_CHANGE_PASSWORD、ENABLE_SSO_USER_CHANGE_PASSWORD
删除这些配置。若需要禁止通过外部身份提供方认证的用户使用本地密码登录，以及修改或重置本地密码，设置 DISABLE_SSO_USER_LOCAL_PWD_LOGIN = True。
ENABLE_METADATA_MANAGEMENT
移至 Seafile 服务器的 .env；设为 True 以启用元数据管理功能。
METADATA_SERVER_URL
移至 .env，并改名为 INNER_METADATA_SERVER_URL。同机部署时默认地址为 http://seafile-md-server:8084；独立部署时应设置可访问的服务器地址。
ENABLE_VIDEO_THUMBNAIL
删除。Seafile 14.0 默认启用视频缩略图。若要使用可选的 Thumbnail Server，设置 ENABLE_THUMBNAIL_SERVER = True。
AI_PRICES
将模型价格配置移至 seafile_ai_config.yaml 中的 global.LLM_MODELS[].price。
DISABLE_SSO_USER_LOCAL_PWD_LOGIN 默认值为 False，仅适用于通过外部身份提供方认证的用户，不能直接替代旧版面向所有用户的密码修改开关。
AI 模型价格现在按每 1,000,000 个 Token 计费，分别使用 input_tokens 和 output_tokens 字段。旧配置中的 input_tokens_1k、output_tokens_1k 是按每 1,000 个 Token 计价的，迁移时应将旧价格乘以 1,000，并核对自定义计价单位。同时检查 monthly_ai_credit_per_user：Seafile 14.0 中，每个货币单位对应 100 个积分。详情请参阅 Seafile AI 扩展。
每月流量配额
在 ENABLED_ROLE_PERMISSIONS 的每个角色中，按照下表替换旧配置项，并保留原有数值：
旧角色权限
新角色权限
monthly_rate_limit
monthly_download_traffic_limit
monthly_rate_limit_per_user
monthly_download_traffic_limit_per_user
每月上传流量配额分别通过 monthly_upload_traffic_limit 和 monthly_upload_traffic_limit_per_user 设置。详细说明请参阅从 Seafile 13.0 升级到 14.0：每月流量配额配置。
seafevents.conf（仅专业版）
将以下配置迁移到 Seafile 服务器的 .env 文件，然后删除对应的旧配置项：
配置段
旧配置项
.env 中的替代配置项
[INDEX FILES]
enabled
ENABLE_SEARCH 和 SEARCH_ENGINE=elasticsearch
[SEASEARCH]
enabled
ENABLE_SEARCH 和 SEARCH_ENGINE=seasearch
上述任一配置段
index_office_pdf、enable_full_text_search
ENABLE_FULL_TEXT_SEARCH
[SEASEARCH]
seasearch_url
SEASEARCH_URL
[SEASEARCH]
seasearch_token
SEASEARCH_TOKEN
[INDEX FILES]
scheme
ELASTICSEARCH_SCHEME
[INDEX FILES]
es_host
ELASTICSEARCH_HOST
[INDEX FILES]
es_port
ELASTICSEARCH_PORT
[INDEX FILES]
username
ELASTICSEARCH_USER
[INDEX FILES]
password
ELASTICSEARCH_PASSWORD
在 Seafile 14.0 专业版中，ENABLE_SEARCH 和 ENABLE_FULL_TEXT_SEARCH 的默认值均为 true，SEARCH_ENGINE 默认值为 seasearch。如果升级前未启用搜索，需要设置 ENABLE_SEARCH=false，以保持禁用状态；如果仅需要文件名搜索，设置 ENABLE_FULL_TEXT_SEARCH=false。继续使用 Elasticsearch 时，需设置 SEARCH_ENGINE=elasticsearch。
修改全文索引设置后，需要清除并重建搜索索引。
对应的环境变量优先级高于原配置文件中的全文搜索和 Elasticsearch 连接设置。interval、highlight、office_file_size_limit、cafile 和自定义索引名称等高级配置项仍应保留。详情请参阅 SeaSearch 或 Elasticsearch。
.env
Seafile AI 模型
将以下环境变量迁移至 $SEAFILE_VOLUME/seafile/conf/seafile_ai_config.yaml 中的 global.LLM_MODELS：
旧环境变量
模型配置字段
SEAFILE_AI_LLM_TYPE
type
SEAFILE_AI_LLM_URL
url
SEAFILE_AI_LLM_KEY
key
SEAFILE_AI_LLM_MODEL
model
保留 ENABLE_SEAFILE_AI 和 SEAFILE_AI_SERVER_URL。按照 Seafile 14.0 AI 扩展文档重新部署 Seafile AI。若 Seafile AI 独立部署，需要确保两台服务器上的模型配置文件保持一致。
人脸识别
Seafile 14.0 已移除人脸识别功能。请从 Seafile、Seafile AI 和人脸嵌入服务的部署配置中删除以下变量：
ENABLE_FACE_RECOGNITION=FACE_EMBEDDING_IMAGE=FACE_EMBEDDING_SERVICE_URL=FACE_EMBEDDING_SERVICE_KEY=FACE_EMBEDDING_VOLUME=同时从 .env 中的 COMPOSE_FILE 配置移除 face-embedding.yml。保留 JWT_PRIVATE_KEY，因为其他服务仍需要该配置。
独立部署的 Metadata Server
删除 MD_DATA，改用 SEAFILE_VOLUME 指定宿主机数据目录，且保留原有的数据路径。
独立部署的 Seafile AI
从独立部署 Seafile AI 所使用的.env 文件中删除 SEAFILE_SERVER_PROTOCOL 和 SEAFILE_SERVER_HOSTNAME，改为配置 INNER_SEAHUB_SERVICE_URL。
Seafile 服务器自身的 .env 以及其他仍需要上述变量的部署配置，应继续保留 SEAFILE_SERVER_PROTOCOL 和 SEAFILE_SERVER_HOSTNAME。
