高级主题

超越默认设置：扩展、调试和开发用于生产和贡献的 Open WebUI。

Open WebUI 开箱即用，非常适合个人使用，但实际生产部署需要更多：生产数据库、水平扩展、结构化日志、可观测性。本节涵盖了从“在我的笔记本电脑上运行”到“为我的整个组织提供服务”之间的所有内容。

---

为什么需要高级主题？

超越单个容器的扩展

默认的 SQLite 数据库和单 Worker 设置最多只能满足小团队的使用需求。了解如何无缝更换为 PostgreSQL，添加 Redis 以共享状态，在负载均衡器后面运行多个副本，以及选择外部向量数据库——所有这些都无需重构您的部署。

从容调试

在大规模运行中，当出现问题时，第一个问题通常是“日志说了什么？”配置日志级别，为日志收集器启用结构化 JSON 输出，并连接 OpenTelemetry 以实现跨整个技术栈的端到端追踪。

为项目贡献力量

设置本地开发环境，支持前端和后端的实时热重载，了解贡献工作流，并开始提交 Pull Request。

---

包含的内容

🚀 扩展 Open WebUI	从 SQLite 迁移到 PostgreSQL，添加 Redis，运行多个副本，配置外部向量数据库，并设置共享存储与可观测性
🪵 Open WebUI 日志记录	配置日志级别，启用调试输出，并切换到结构化 JSON 日志记录以供生产日志收集器使用
🛠️ 开发 Open WebUI	克隆仓库，并行运行前端和后端，在其他设备上测试，并提交 Pull Request
🔒 Open WebUI 安全加固	锁定生产部署中的身份验证、密钥、CORS、安全响应头、审计日志和网络访问