Seafile AI 如何配置

1

seafile配置AI总是不成功，请问下，这个用国内的模型到底选哪一个

2

你有什么模型就配置什么模型，按照格式修改配置文件即可。

3

你好，我配置了模型，但是这个标签功能好像没有起作用

4

请您检查是否部署了元数据扩展服务容器，标签功能依赖于元数据 metadata-server容器，如果缺失此组件，即使 AI 模型配置正确，系统也无法保存或展示标签内容。部署可以参考https://manual.seafile.com/latest/extension/metadata-server/

Seafile AI 标签功能故障排查指南

如果模型已配置但标签功能未起作用，请按照以下步骤逐步核查：

1. 检查基础环境配置

AI 标签功能依赖于 Seafile 13.0+ 版本以及专门的 AI 服务组件。

  • 启用 AI 开关：确保在 .env 文件中设置了 ENABLE_SEAFILE_AI=true。
  • 部署 AI 服务：确认是否已下载并运行 seafile-ai.yml。如果 AI 服务未启动，功能将无法调用。
  • Redis 缓存：AI 组件必须使用 Redis。请检查 .env 中是否配置了 CACHE_PROVIDER=redis 及其连接信息。

2. 检查功能调用路径

AI 标签不是完全静默生成的，通常需要手动触发：

  • 开启“扩展属性”：在资料库或系统设置中，必须先启用“扩展属性”功能。
  • 侧边栏触发：点击文件打开属性侧边栏，在 AI 控件中点击相关按钮手动生成标签。
  • 多维视图调用：在“表格视图”或“看板视图”中，右键点击文件并选择“AI”菜单。

3. 核对模型兼容性（针对自定义模型）

如果你使用的是非内置的 GPT-4o-mini 模型：

  • 多模态支持：生成的标签若包含图像识别（对象、颜色、天气等），所选模型必须支持**多模态（Vision）**功能。
  • API 格式：确保 SEAFILE_AI_LLM_URL 指向正确的 OpenAI 兼容接口地址（通常需包含 /v1），且 SEAFILE_AI_LLM_TYPE 设置为 other。

4. 关键参数核对表

请检查 .env 文件中以下关键变量是否准确：

变量名 推荐值/说明
SEAFILE_AI_LLM_MODEL 确保与你实际部署的模型 ID 一致
SEAFILE_AI_LLM_KEY 确保 API Key 有效且未过期
INNER_SEAHUB_SERVICE_URL AI 服务需能通过此 URL 访问 Seahub
JWT_PRIVATE_KEY 必须与 Seafile 主配置中的密钥完全一致，否则鉴权失败

5. 进一步排查建议

  • 重启服务：修改任何 .env 配置后，必须执行以下命令重启：
    docker compose down
docker compose up -d
  • 查看日志：如果依然无效，请查看 seafile-ai 容器日志或系统目录下的 seafile_ai.log，检查是否有 API 连接超时或认证失败的具体报错。
5

好的，我晚上试下，metadata-server怎么测试是否正常运行

6

查看docker容器日志是否有明显报错即可

7

感谢你的提示，反复检查是路径问题，yml里面需要配置一个路径映射，metadata-server就没有问题了，AI自然也就好了，再次感谢。

1 个赞