发布日期: 2026-03-09
版本号: v0.8.10

此次更新包含以下主要改进：在功能方面，新增了允许管理员配置自定义OIDC登出URL的选项，以支持如AWS Cognito等需要特定端点的提供商；引入了MariaDB Vector作为新的向量数据库后端；支持对发送至任务模型的消息进行截断以减少资源消耗；同时进行了多项性能与安全增强，并扩展了多种语言的翻译支持。在稳定性方面，修复了管道过滤器在HTTP错误时的数据损坏问题、更新知识文件后残留旧数据的问题、文件列表排序不稳定导致崩溃的问题、Teams Webhook在用户数据缺失时的崩溃问题，以及多个进程异常处理不完善（如在OAuth认证或关闭时）导致的终止问题。此外，还解决了Docker部署启动失败、非管理员用户无法查看工具、YAML文件处理错误、时间范围月份显示语言异常、OAuth错误URL编码问题、工具内部方法意外暴露、Azure TTS语言代码使用不当、Azure语音转写错误信息不友好、分析数据未按用户组过滤、网页搜索图标加载失败、自定义模型回退失效、待发送消息中图片显示空白以及文件元数据序列化错误等众多影响用户体验和系统可靠性的问题。

更新内容 （中文）

新增内容

  • 🔐 自定义OIDC登出端点。 管理员现在可以通过OPENID_END_SESSION_ENDPOINT配置自定义的OpenID Connect登出URL，从而支持需要自定义端点的OIDC提供商（如AWS Cognito）的登出功能。提交记录
  • 🗄️ MariaDB Vector社区支持。 新增MariaDB Vector作为向量数据库后端，可通过设置VECTOR_DB=mariadb-vector进行部署；支持余弦和欧几里得距离策略，并可配置HNSW索引。#21931
  • 📝 任务消息截断。 发送给任务模型以生成标题和标签的聊天消息，现在可通过提示模板中的过滤器进行截断，从而减少长对话中的令牌使用量和处理时间。#21499
  • 🔄 总体改进。 应用程序实施了多项改进，以增强性能、稳定性和安全性。
  • 🌐 增强并扩展了葡萄牙语（巴西）、西班牙语和马来语的翻译。

修复内容

  • 🔗 Pipeline过滤器HTTP错误。 修复了当Pipeline入口/出口过滤器中发生HTTP错误时，会静默损坏用户聊天负载的错误；现在会在解析响应前正确抛出错误。#22445
  • 📚 知识文件嵌入更新。 修复了更新知识文件后，旧的嵌入向量仍留在数据库中的错误，导致搜索结果包含重复和过时的数据。#20558
  • 📁 文件列表稳定性。 修复了文件列表排序，改为使用created_at作为主排序，id作为次排序，以确保排序一致并防止在管理大量文件时页面崩溃。#21879
  • 📨 Teams webhook崩溃。 修复了当事件负载中缺少用户数据时，Teams webhook处理器中的TypeError崩溃问题。#22444
  • 🛠️ 进程关闭处理。 修复了主进程中阻止正常关闭的裸except语句；已替换为正确的异常处理。#22423
  • 🐳 Docker部署启动。 Docker部署现在能正常启动；添加了缺失的OpenTelemetry系统指标依赖。#22447, #22401
  • 🛠️ 非管理员用户的工具访问。 修复了阻止非管理员用户查看工具的NameError；缺失的has_access函数现在已正确导入。#22393
  • 🔐 OAuth错误处理。 修复了裸except语句静默捕获SystemExit和KeyboardInterrupt，导致OAuth认证期间无法正常关闭进程的错误。#22420
  • 🛠️ 异常错误消息。 修复了三处因异常抛出方式不正确，导致显示令人困惑的TypeError消息而非正确错误描述的错误，使调试更加容易。#22446
  • 📄 YAML文件处理。 修复了在启用Docling时上传YAML文件出错的问题；YAML和YML文件现在被正确识别为文本文件并处理。#22399, #22263
  • 📅 时间范围月份名称。 修复了当操作系统区域设置与浏览器语言不同时，时间范围标签中的月份名称显示为错误语言的问题；月份名称现在统一显示为英文。#22454
  • 🔐 OAuth错误URL编码。 修复了包含特殊字符的OAuth错误消息导致重定向URL格式错误的问题；错误消息现在已正确进行URL编码。#22415
  • 🛠️ 内部工具方法过滤。 工具不再向大语言模型暴露以下划线开头的内部方法，减少了干扰并提高了准确性。#22408
  • 🔊 Azure TTS语言环境提取。 修复了Azure文本转语音在SSML中使用不完整语言环境代码的问题；现在正确使用完整的语言环境（如"en-US"）而非仅"en"。#22443
  • 🎤 Azure语音转录错误。 改进了Azure AI Speech的错误处理，现在显示用户友好的消息而非通用的连接错误；空转录、未识别语言以及其他Azure特定错误现在会显示清晰的描述。#20485
  • 📊 分析组过滤。 修复了令牌使用量分析未按用户组过滤的问题；查询现在与其他分析指标一样，正确遵循组过滤器。#22167
  • 🔍 网页搜索Favicon回退。 修复了当无法从外部来源加载网站图标时，网页搜索源显示损坏图像图标的问题；现在回退到默认的Open WebUI网站图标。#21897
  • 🔄 自定义模型回退。 修复了当基础模型不可用时，自定义模型回退功能失效的问题；现在从模型信息而非空参数中正确获取基础模型ID。#22456
  • 🖼️ 待处理消息图片显示。 修复了队列中消息的图片显示为空白的问题；图片缩略图现在在待处理消息队列中正确显示。#22256
  • 🛠️ 文件元数据清理。 修复了当元数据包含不可序列化对象（如可调用函数）时，文件上传因JSON序列化错误失败的问题；元数据现在在插入数据库前已进行清理。#20561

更新内容 （原始）

Added

  • 🔐 Custom OIDC logout endpoint. Administrators can now configure a custom OpenID Connect logout URL via OPENID_END_SESSION_ENDPOINT, enabling logout functionality for OIDC providers that require custom endpoints like AWS Cognito. Commit
  • 🗄️ MariaDB Vector community support. Added MariaDB Vector as a new vector database backend, enabling deployments with VECTOR_DB=mariadb-vector; supports cosine and euclidean distance strategies with configurable HNSW indexing. #21931
  • 📝 Task message truncation. Chat messages sent to task models for title and tag generation can now be truncated using a filter in the prompt template, reducing token usage and processing time for long conversations. #21499
  • 🔄 General improvements. Various improvements were implemented across the application to enhance performance, stability, and security.
  • 🌐 Translations for Portuguese (Brazil), Spanish, and Malay were enhanced and expanded.

Fixed

  • 🔗 Pipeline filter HTTP errors. Fixed a bug where HTTP errors in pipeline inlet/outlet filters would silently corrupt the user’s chat payload; errors are now properly raised before parsing the response. #22445
  • 📚 Knowledge file embedding updates. Fixed a bug where updating knowledge files left old embeddings in the database, causing search results to include duplicate and stale data. #20558
  • 📁 Files list stability. Fixed the files list ordering to use created_at with id as secondary sort, ensuring consistent ordering and preventing page crashes when managing many files. #21879
  • 📨 Teams webhook crash. Fixed a TypeError crash in the Teams webhook handler when user data is missing from the event payload. #22444
  • 🛠️ Process shutdown handling. Fixed bare except clauses in the main process that prevented clean shutdown; replaced with proper exception handling. #22423
  • 🐳 Docker deployment startup. Docker deployments now start correctly; the missing OpenTelemetry system metrics dependency was added. #22447, #22401
  • 🛠️ Tool access for non-admin users. Fixed a NameError that prevented non-admin users from viewing tools; the missing has_access function is now properly imported. #22393
  • 🔐 OAuth error handling. Fixed a bug where bare except clauses silently caught SystemExit and KeyboardInterrupt, preventing clean process shutdown during OAuth authentication. #22420
  • 🛠️ Exception error messages. Fixed three locations where incorrect exception raising caused confusing TypeError messages instead of proper error descriptions, making debugging much easier. #22446
  • 📄 YAML file processing. Fixed an error when uploading YAML files with Docling enabled; YAML and YML files are now properly recognized as text files and processed correctly. #22399, #22263
  • 📅 Time range month names. Fixed month names in time range labels appearing in the wrong language when OS regional settings differ from browser language; month names now consistently display in English. #22454
  • 🔐 OAuth error URL encoding. Fixed OAuth error messages with special characters causing malformed redirect URLs; error messages are now properly URL-encoded. #22415
  • 🛠️ Internal tool method filtering. Tools no longer expose internal methods starting with underscore to the LLM, reducing clutter and improving accuracy. #22408
  • 🔊 Azure TTS locale extraction. Fixed Azure text-to-speech using incomplete locale codes in SSML; now correctly uses full locale like “en-US” instead of just “en”. #22443
  • 🎤 Azure speech transcription errors. Improved Azure AI Speech error handling to display user-friendly messages instead of generic connection errors; empty transcripts, no language identified, and other Azure-specific errors now show clear descriptions. #20485
  • 📊 Analytics group filtering. Fixed token usage analytics not being filtered by user group; the query now properly respects group filters like other analytics metrics. #22167
  • 🔍 Web search favicon fallback. Fixed web search sources showing broken image icons when favicons couldn’t be loaded from external sources; now falls back to the default Open WebUI favicon. #21897
  • 🔄 Custom model fallback. Fixed custom model fallback not working when the base model is unavailable; the base model ID is now correctly retrieved from model info instead of empty params. #22456
  • 🖼️ Pending message image display. Fixed images in queued messages appearing blank; image thumbnails are now properly displayed in the pending message queue. #22256
  • 🛠️ File metadata sanitization. Fixed file uploads failing with JSON serialization errors when metadata contained non-serializable objects like callable functions; metadata is now sanitized before database insertion. #20561

下载链接