Open WebUI怎么用？从安装到连接本地模型与创建知识库的入门指南
Open WebUI是用于访问和管理大模型的网页界面，本身不等于模型运行服务。本文以本地部署为主线，介绍安装、连接Ollama、选择模型、调整对话参数、创建知识库和排查连接问题的方法，并说明数据目录与网络暴露风险。
Open WebUI可以理解为一个面向大模型的网页操作界面，负责提供聊天、模型选择、文件上传、知识库检索等功能；Ollama等服务则负责下载、运行和管理本地模型。两者是不同层次的组件：安装Open WebUI并不会自动获得一个可用的本地模型，也不代表已经连接了云端模型。
一、安装前的准备
使用前应先准备一台能够运行模型服务的电脑，并确认系统已经安装Docker，或按照项目文档选择其他支持的安装方式。若使用Ollama，需要先让Ollama在本机正常运行，并至少准备一个可调用的模型。模型能否流畅运行，取决于模型大小、量化方式、内存、显存和处理器性能，不能仅凭Open WebUI判断兼容性。
Docker安装时，常见做法是运行Open WebUI容器，并把持久化目录映射到容器内的数据目录。具体镜像名称、参数和端口应以对应项目文档为准。启动后，在浏览器打开部署时映射的地址；许多本地示例使用本机地址加一个Web端口，但实际端口可能因配置而不同。
二、首次登录与连接本地模型
- 创建本地账户：首次打开页面后按提示注册或登录。账户数据、聊天记录和知识库文件通常保存在Open WebUI的数据目录中，因此应提前确认该目录的挂载位置。
- 检查模型服务：先在终端确认Ollama可以独立运行，并能列出或调用已安装模型。如果Ollama本身无法响应，应先处理模型服务问题，而不是反复刷新Open WebUI。
- 配置连接地址：在管理设置中的连接或模型提供商区域填写Ollama服务地址，或者在启动容器时通过环境变量传入。容器访问宿主机上的服务时，不能想当然地把容器内的localhost当成宿主机地址，需要根据操作系统和Docker网络配置选择可达地址。
- 验证连接：保存配置后刷新模型列表，选择一个已安装模型发起简短提问。若列表为空，依次检查地址、端口、防火墙、容器网络和Ollama服务状态。
三、模型选择与对话管理
在新建对话时，可以从模型下拉菜单选择不同模型。较小模型通常更节省资源，较大模型可能需要更多显存或内存；实际速度还会受到上下文长度和并发任务影响。通过不同模型回答同一问题，可以比较响应速度、格式遵循能力和事实准确性，但不要把单次回答当成绝对结论。
对话参数一般包括温度、上下文长度或最大输出长度等，具体名称和可调范围会随模型服务及界面版本变化。需要稳定、格式化的回答时，可适当降低随机性；需要发散创意时，再提高相关参数。调整后应保留测试问题，便于比较设置变化带来的差异。
四、创建文档知识库并进行问答
- 进入知识库或工作区功能，创建一个新知识库，例如“产品文档”。
- 上传产品说明、操作手册或PDF资料，并等待文件解析、分块和索引完成。文档数量较多时，建议按产品、版本或部门分类，避免把无关资料混在一起。
- 在对话中选择该知识库，或使用页面提供的知识库引用方式提问，例如“根据产品文档，列出安装前的准备事项”。
- 核对回答中的引用片段、文件名和页码等来源信息。若答案没有对应原文，或引用内容与问题无关，应回到文档检查文本质量、分段效果和检索范围。
例如，可以把一组PDF操作手册上传到“产品文档”知识库，再询问某功能的配置步骤。若PDF是扫描图片，系统可能无法直接提取文字，需要先进行OCR；表格、复杂排版和加密文件也可能导致解析结果不完整。知识库问答是基于检索内容生成回答，不能替代人工核对原始资料。
五、常见问题排查
- 模型连接失败：确认Ollama进程正在运行、服务地址可从Open WebUI所在环境访问，并检查端口和防火墙设置。
- 端口冲突：若启动提示端口已被占用，更换宿主机映射端口，或停止占用该端口的程序；修改外部端口后，浏览器访问地址也要同步调整。
- 运行缓慢或显存不足：尝试更小的模型、较短的上下文和较低的并发，关闭不必要的任务。显存不足时不要仅依赖界面重试，应查看模型服务日志。
- 文件解析异常：检查文件是否损坏、加密或主要由图片组成，并尝试转换为可复制文本的格式后重新上传。
六、本地部署的安全注意事项
本地服务并不等于天然安全。若把Open WebUI、Ollama或管理端口直接暴露到公网，可能造成未授权访问、资源被滥用或本地资料泄露。建议仅绑定可信网络接口，使用防火墙、反向代理认证或访问控制，并定期检查账户和日志。不要把包含密钥、个人信息或内部资料的文件随意上传到知识库；同时备份数据目录，升级或迁移前先确认聊天记录、索引和原文件的保存位置。
