📁 文件管理

Open WebUI 提供了一套完整的文件管理系统，让你可以在知识库、RAG 等多种功能场景中上传、整理并使用自己的文档。

集中文件管理器

集中式文件管理器 提供统一界面，用于查看、搜索和管理你在 Open WebUI 实例中上传的所有文件——无论它们是直接上传到聊天里，还是添加进知识库。

进入文件管理器

1. 点击左下角的用户名或头像
2. 在菜单中选择 设置
3. 进入 数据控制 标签
4. 找到 管理文件 这一行并点击 管理 按钮

核心功能

文件管理弹窗提供了多种强大的数据维护能力：

• 全局搜索：通过内置搜索栏按文件名快速查找任意文件
• 高级排序：你可以按以下方式整理文件列表：
  • 文件名：按字母顺序排序，便于查找特定文档
  • 创建时间：查看最新上传文件或回溯较旧文件
• 文件详情：一眼查看重要信息，包括：
  • 文件大小：查看每个文档占用的空间大小（如 KB、MB）
  • 上传日期：跟踪文件何时被添加到实例中
• 内置查看器：点击任意文件即可打开 文件条目查看器，显示文件元数据和详细信息（如大小、类型）
• 安全删除：轻松移除不再需要的文件
  • :::info 知识库清理 当你通过文件管理器删除文件时，Open WebUI 会自动执行深度清理：它会将该文件从所有关联知识库中移除，并删除对应的向量嵌入，从而保持数据库整洁高效。 :::

在 Open WebUI 中使用文件

文件是平台高级能力的核心组成部分：

1. Retrieval Augmented Generation（RAG）

通过上传文档（PDF、Word、文本文件等），你可以让 AI 的回答建立在你自己的数据之上。

• 聊天上传：直接将文件拖拽到聊天中，或点击上传图标
• 知识库：把文件加入结构化集合，实现更持久、更有组织的检索

2. 文件元数据

每个文件都会携带元数据，帮助你和 AI 理解其上下文，包括内容类型、原始文件名和大小等。

最佳实践

• 命名规范：使用清晰、描述性强的文件名。这能提升文件管理器搜索准确率，也便于你识别具体文档
• 定期清理：定期使用 管理文件 面板删除旧文件或重复文档。这既能节省磁盘 / 数据库存储空间，也能通过保留更相关的数据来提升系统性能

FAQ

Q：如果我删除一个文件，它也会从聊天中消失吗？
A： 会。通过文件管理器删除文件会把它从系统中完全移除。任何曾通过 RAG 引用该文件的聊天，此后都无法再从中提取信息。

Q：我能从文件管理器把文件再下载回来吗？
A： 目前文件管理器重点支持元数据查看和管理（删除）。如果你要下载文件，通常应从最初使用它的聊天或知识库中访问。

Q：可管理的文件数量有限制吗？
A： Open WebUI 本身没有硬编码上限。可扩展性取决于你的存储系统（磁盘 / S3）以及向量数据库（如 ChromaDB、PGVector）。

Q：管理文件需要管理员权限吗？
A： 普通用户可以管理自己上传的文件；管理员则在 Admin Panel 中拥有更多全局文件和配置管理能力。