agentic_huge_data_base / wiki
页面 Open WebUI · 18 管理面板与分析·DeepWiki 中文全文译文
DeepWiki 中文译文 / Open WebUI / 18

18 · 管理面板与分析（Admin Panel and Analytics）

多模型对话工作台与知识应用入口 · 本章是 Open WebUI DeepWiki 中文译文的独立章节页，保留原始链接、源码锚点、模块标签和章节层级。

项目Open WebUI 章节18 状态全文译文 模块可观测性与治理、系统架构、工具、记忆与模型调用、界面与交互
项目要点页2.5 参考项目 项目章节目录Open WebUI DeepWiki 原始章节Admin Panel and Analytics 上一章17.4 下一章18.1
源码线索
  • src/lib/components/admin/Evaluations.svelte
  • src/lib/components/admin/Settings.svelte
  • src/lib/components/admin/Users.svelte
  • src/lib/components/icons/PagePlus.svelte
  • src/lib/components/notes/utils.ts
  • Settings.svelte
  • Users.svelte
  • Evaluations.svelte
  • Analytics.svelte
  • Functions.svelte
模块标签
  • 可观测性与治理
  • 系统架构
  • 工具、记忆与模型调用
  • 界面与交互
  • 频道、笔记与协作

中文译文

管理面板与分析（中文译文）

原始 DeepWiki 页面：https://deepwiki.com/open-webui/open-webui/18-admin-panel-and-analytics
翻译时间：2026-06-09T16:12:12.277Z
翻译模型：deepseek-chat
原文字符数：8038
项目：Open WebUI (open-webui)

---

管理面板与分析

相关源文件

以下文件为本 wiki 页面的生成提供了上下文：

  • src/lib/components/admin/Evaluations.svelte
  • src/lib/components/admin/Settings.svelte
  • src/lib/components/admin/Users.svelte
  • src/lib/components/icons/PagePlus.svelte
  • src/lib/components/notes/utils.ts
  • src/routes/(app)/admin/+layout.svelte/admin/+layout.svelte)
  • src/routes/(app)/admin/+page.svelte/admin/+page.svelte)
  • src/routes/(app)/admin/evaluations/+page.svelte/admin/evaluations/+page.svelte)
  • [src/routes/(app)/admin/evaluations/[tab]/+page.svelte](src/routes/(app)/admin/evaluations/[tab]/+page.svelte)
  • src/routes/(app)/admin/users/+page.svelte/admin/users/+page.svelte)
  • [src/routes/(app)/admin/users/[tab]/+page.svelte](src/routes/(app)/admin/users/[tab]/+page.svelte)
  • src/routes/(app)/home/+layout.svelte/home/+layout.svelte)
  • src/routes/(app)/notes/+page.svelte/notes/+page.svelte)
  • [src/routes/(app)/notes/[id]/+page.svelte](src/routes/(app)/notes/[id]/+page.svelte)
  • src/routes/(app)/notes/new/+page.svelte/notes/new/+page.svelte)
  • src/routes/(app)/playground/+layout.svelte/playground/+layout.svelte)
  • src/routes/(app)/workspace/+layout.svelte/workspace/+layout.svelte)

管理面板是 Open WebUI 的核心控制平面，为管理员提供用户管理、系统性能监控、模型质量评估以及全局应用配置等工具。只有拥有 admin 角色的用户才能访问，系统通过前端路由守卫和后端中间件共同实施访问控制 src/routes/(app)/admin/+layout.svelte:16-18。

管理架构

管理界面按功能域划分为多个模块，每个模块由特定的 Svelte 组件处理，并由专用的 FastAPI 路由器提供后端支持。Settings.svelte 组件作为系统级配置的中央编排器 src/lib/components/admin/Settings.svelte:73-247。

组件与路由映射
管理域前端组件主路由
用户管理Users.svelte src/lib/components/admin/Users.svelte:9-10/admin/users
评估Evaluations.svelte src/lib/components/admin/Evaluations.svelte:6-7/admin/evaluations
系统设置Settings.svelte src/lib/components/admin/Settings.svelte:11-24/admin/settings
使用分析Analytics.svelte/admin/analytics
函数Functions.svelte/admin/functions

来源： src/routes/(app)/admin/+layout.svelte:62-103, src/lib/components/admin/Settings.svelte:35-55

管理数据流

下图展示了配置和用户数据的管理请求如何从 UI 通过后端服务流向持久化层。

管理配置流程

graph TD
    subgraph "前端 (SvelteKit)"
        UI["Settings.svelte"]
        Store["config Store"]
        API["getBackendConfig"]
    end

    subgraph "后端 (FastAPI)"
        Router["Admin Router"]
        Auth["Admin Role Check"]
        PConfig["PersistentConfig"]
    end

    subgraph "存储"
        DB[("SQL 数据库")]
        ENV["环境变量"]
    end

    UI --> API
    API -- "认证请求" --> Auth
    Auth --> Router
    Router --> PConfig
    PConfig --> DB
    PConfig -.-> ENV
    Store -.-> UI

来源： src/lib/components/admin/Settings.svelte:7-8, src/routes/(app)/admin/+layout.svelte:16-18

用户管理

用户管理部分允许管理员管理用户的完整生命周期。它分为两个主要视图：用户概览和群组管理 src/lib/components/admin/Users.svelte:14-19。

  • 用户概览： 列出并编辑个人用户资料、角色和权限 src/lib/components/admin/Users/UserList.svelte:9。
  • 群组： 管理用户的层级或逻辑分组，以便批量授权 src/lib/components/admin/Users/Groups.svelte:10。

详情请参见用户管理。

评估与排行榜

Open WebUI 包含一个内置评估系统，用于根据实际使用情况和用户反馈衡量模型性能 src/lib/components/admin/Evaluations.svelte:11-16。

  • Elo 排行榜： 基于"竞技场"式比较和用户直接评分计算模型性能的排名系统 src/lib/components/admin/Evaluations/Leaderboard.svelte:6。
  • 反馈历史： 用户提交反馈的详细日志，包括特定聊天快照和评分 src/lib/components/admin/Evaluations/Feedbacks.svelte:7。

详情请参见评估与排行榜。

使用分析仪表板

分析系统提供系统利用率和令牌消耗的可视化信息。访问权限由 enable_admin_analytics 功能开关控制 src/routes/(app)/admin/+layout.svelte:70-78。

  • 使用统计： 活跃用户、热门模型和消息量的可视化展示。
  • 指标： 跟踪不同提供商的令牌消耗和 API 延迟。

分析实体关系

erDiagram
    "用户" ||--o{ "聊天" : "拥有"
    "聊天" ||--o{ "消息" : "包含"
    "消息" ||--o| "反馈" : "接收"
    "消息" {
        string model_id
        json usage_tokens
        timestamp created_at
    }
    "反馈" {
        int rating
        string comment
    }

来源： src/lib/components/admin/Evaluations.svelte:83-107, src/lib/components/admin/Settings.svelte:129-133

详情请参见使用分析仪表板。

SCIM 配置

Open WebUI 支持实验性的 SCIM 2.0 实现，适用于企业环境。该功能允许从 Okta 或 Microsoft Entra ID 等身份提供商自动同步用户和群组。系统还支持 LDAP/Active Directory 集成以实现用户配置 src/lib/components/admin/Settings.svelte:89-90。

详情请参见SCIM 配置。

系统设置

管理设置面板提供整个实例的全局配置，通过 Settings.svelte 编排器进行管理 src/lib/components/admin/Settings.svelte:73-247。

  • 连接： 配置 Ollama 和 OpenAI 提供商的 API 密钥和基础 URL src/lib/components/admin/Settings.svelte:97-111。
  • 模型： 全局模型管理，包括拉取新模型和配置 GGUF 导入 src/lib/components/admin/Settings.svelte:113-127。
  • 文档与 RAG： 配置向量数据库、嵌入模型以及 Tika、Docling 或 Unstructured 等文档处理器 src/lib/components/admin/Settings.svelte:141-161。
  • 网络搜索： 集成搜索引擎（Google、SearXNG、Tavily、Perplexity 等）以实现实时信息检索 src/lib/components/admin/Settings.svelte:163-182。
  • 音频与图像： 配置 STT/TTS（Whisper、ElevenLabs）和图像生成（ComfyUI、DALL-E、Stable Diffusion）src/lib/components/admin/Settings.svelte:205-234。
  • 管道： 管理中间件过滤器、阀门和自定义请求处理工作流 src/lib/components/admin/Settings.svelte:236-240。
  • 数据库： 系统级数据库操作，包括导出、导入和备份 src/lib/components/admin/Settings.svelte:241-246。

来源： src/lib/components/admin/Settings.svelte:38-54, src/lib/components/admin/Settings.svelte:73-247