尧图网页设计 
Open WebUI自托管AI平台与本地大模型前端快速启动完全指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是什么、能替你解决什么问题Open WebUI 是一个自托管的本地大模型前端跑在 Ollama 或任何 OpenAI 兼容 API 之上把聊天框、文件上传、知识库、用户管理、工具调用这些原本要各找一套零散工具拼起来的能力收敛进一个容器里。最典型的使用场景把公司内网的一台 Ollama 机器变成团队共用的对话入口成员用浏览器登录即用数据不出内网。全文按一条命令启动 → 配置三档 → 三个高频能力 → 报错反查 → 团队化路线推进对着做即可。动手前环境确认与一条命令启动前提条件WebUI 本身很轻重活都在模型端主机已装好 DockerLinux/macOS/Windows 均可一台跑着 Ollama 的机器同机或内网可达或任意 OpenAI 兼容端点宿主机 2 核 4G 起步端口 3000 空闲浏览器能访问http://localhost:3000一条命令启动 CPU 版docker run -d -p 3000:8080 -v open-webui:/app/backend/data \ --name open-webui --restart always ghcr.io/open-webui/open-webui:main判断标准浏览器打开http://localhost:3000看到登录/注册页即跑通——注意第一个注册的账号会自动成为管理员后面所有管理操作都靠它。镜像标签差异点适用人群:mainCPU版最通用RAG 嵌入等计算走 CPU默认选它模型在别处跑:cudaGPU版需加--gpus all嵌入/转写等吃 GPU本机有 NVIDIA 卡且装了 nvidia-container-toolkit:ollama集成版内置 Ollama加-v ollama:/root/.ollama挂载模型目录不想维护第二个容器单机全栈配置分层最小可用到生产级零配置直接跑三个默认值已经够用数据库用 SQLiteDATABASE_URL默认指向data/webui.db同机 Ollama 会自动发现 11434 端口第一个注册账号即管理员。什么都不填就能聊。改 3 个变量让体验更顺参数一行释义推荐值OLLAMA_BASE_URL模型服务器地址模型不在 WebUI 同机时必须改http://模型机IP:11434OPENAI_API_KEY接入 OpenAI 兼容服务密钥在服务商控制台创建获取你的控制台密钥WEBUI_SECRET_KEY会话 JWT 签名密钥改了会让所有旧登录失效首次启动会自动生成升级前手动固化为长随机串读取逻辑集中在 env.py改完后docker restart open-webui生效。上生产前必改项数据库换 PostgreSQL设置DATABASE_URL格式postgresql://账号:密码主机:5432/库名账号密码换成真实数据库凭证SQLite 扛不住多人并发写WEBUI_AUTH保持 trueWEBUI_SESSION_COOKIE_SECUREtrue走 HTTPS 时端口不暴露公网用反向代理挂在https之后DATA_DIR指向备份过的持久卷三个高频能力的实操拆解文档问答RAG接入步骤入口左侧边栏 Knowledge 页管理知识库或在对话框输入框直接附加 PDF/Word/网页链接。关键参数分块大小默认 500 字符长文档调到 300–800 之间与嵌入模型Admin → Settings 里指定默认复用 Ollama 上的嵌入模型。验收提问后答案下方出现来源引用点引用能展开原文片段——引用出现说明检索链路通了引用内容答非所问则优先调小分块。检索与向量库的实现在 retrieval/。多模型切换入口对话框顶部标题旁的模型下拉框随时切换无需刷新。关键参数Admin → Settings → Connections 里可同时挂多个 Ollama 地址和 OpenAI 端点每个端点独立测试连通。验收两个会话分别选中不同模型回复风格与模型名标识随之变化历史消息互不串扰。工具与插件扩展入口左侧边栏 Tools 页添加、启停工具Admin 面板管理 Function 与 Pipeline。关键参数工具的enabled开关和参数级阀门Valves即每个工具自带的配置项。验收让模型查一下当前时间对话中出现工具调用过程块且结果正确返回说明调用闭环成立。内置工具源码见 tools/。踩坑清单从报错信息反查原因症状大概率原因一步验证方法启动后模型列表为空模型服务不在同机/端口不通curl http://host:11434/api/tags通了再设OLLAMA_BASE_URL3000 端口被占、容器反复重启其他服务已绑定该端口改映射-p 3001:8080重启:cuda镜像起不来缺 NVIDIA 驱动或 nvidia-container-toolkitnvidia-smi报错就换:main跑 CPU首次登录慢或 500首启在跑数据库迁移初始化docker logs open-webui \| tail -50确认初始化日志跑完重启后全员掉线 401WEBUI_SECRET_KEY被动过旧会话失效密钥恢复原值再重启容器传文档报嵌入错误RAG 嵌入模型未连接或不可达Admin → Settings 核对嵌入服务地址这里有个坑Open WebUI 自身日志很干净模型侧的错下载超时、显存不足只会以流中断形式出现先分清是 WebUI 的问题还是 Ollama 的问题。以上都没命中时优先检查容器日志最后 50 行。从个人玩到团队用的升级路径个人单节点 → 多人共享在 Admin → Users 批量建账号用 Groups 按部门分组授权把注册改为管理员邀请制关闭公开注册解决谁来用、用什么权限。引入 PostgreSQL Redis改DATABASE_URL与REDIS_URL解决 SQLite 并发写瓶颈并为 WebSocket 通知与查询缓存提供后端。接入监控LOG_FORMATjson输出结构化日志喂给采集器UVICORN_WORKERS调 2 以上配 docker healthcheck解决坏了没人知道。多副本高可用共享存储挂载DATA_DIR前置 Nginx 反向代理做负载均衡数据库与 Redis 独立成服务解决单点宕机。能力边界要心里有数Open WebUI 不负责模型推理性能70B 模型的生成速度取决于你的 Ollama 机器强实时音视频场景不在它的舒适区Pipeline 与工具生态仍在快速迭代生产环境建议锁定版本号再部署。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Open WebUI：自托管AI平台与本地大模型前端快速启动完全指南
Open WebUI自托管AI平台与本地大模型前端快速启动完全指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是什么、能替你解决什么问题Open WebUI 是一个自托管的本地大模型前端跑在 Ollama 或任何 OpenAI 兼容 API 之上把聊天框、文件上传、知识库、用户管理、工具调用这些原本要各找一套零散工具拼起来的能力收敛进一个容器里。最典型的使用场景把公司内网的一台 Ollama 机器变成团队共用的对话入口成员用浏览器登录即用数据不出内网。全文按一条命令启动 → 配置三档 → 三个高频能力 → 报错反查 → 团队化路线推进对着做即可。动手前环境确认与一条命令启动前提条件WebUI 本身很轻重活都在模型端主机已装好 DockerLinux/macOS/Windows 均可一台跑着 Ollama 的机器同机或内网可达或任意 OpenAI 兼容端点宿主机 2 核 4G 起步端口 3000 空闲浏览器能访问http://localhost:3000一条命令启动 CPU 版docker run -d -p 3000:8080 -v open-webui:/app/backend/data \ --name open-webui --restart always ghcr.io/open-webui/open-webui:main判断标准浏览器打开http://localhost:3000看到登录/注册页即跑通——注意第一个注册的账号会自动成为管理员后面所有管理操作都靠它。镜像标签差异点适用人群:mainCPU版最通用RAG 嵌入等计算走 CPU默认选它模型在别处跑:cudaGPU版需加--gpus all嵌入/转写等吃 GPU本机有 NVIDIA 卡且装了 nvidia-container-toolkit:ollama集成版内置 Ollama加-v ollama:/root/.ollama挂载模型目录不想维护第二个容器单机全栈配置分层最小可用到生产级零配置直接跑三个默认值已经够用数据库用 SQLiteDATABASE_URL默认指向data/webui.db同机 Ollama 会自动发现 11434 端口第一个注册账号即管理员。什么都不填就能聊。改 3 个变量让体验更顺参数一行释义推荐值OLLAMA_BASE_URL模型服务器地址模型不在 WebUI 同机时必须改http://模型机IP:11434OPENAI_API_KEY接入 OpenAI 兼容服务密钥在服务商控制台创建获取你的控制台密钥WEBUI_SECRET_KEY会话 JWT 签名密钥改了会让所有旧登录失效首次启动会自动生成升级前手动固化为长随机串读取逻辑集中在 env.py改完后docker restart open-webui生效。上生产前必改项数据库换 PostgreSQL设置DATABASE_URL格式postgresql://账号:密码主机:5432/库名账号密码换成真实数据库凭证SQLite 扛不住多人并发写WEBUI_AUTH保持 trueWEBUI_SESSION_COOKIE_SECUREtrue走 HTTPS 时端口不暴露公网用反向代理挂在https之后DATA_DIR指向备份过的持久卷三个高频能力的实操拆解文档问答RAG接入步骤入口左侧边栏 Knowledge 页管理知识库或在对话框输入框直接附加 PDF/Word/网页链接。关键参数分块大小默认 500 字符长文档调到 300–800 之间与嵌入模型Admin → Settings 里指定默认复用 Ollama 上的嵌入模型。验收提问后答案下方出现来源引用点引用能展开原文片段——引用出现说明检索链路通了引用内容答非所问则优先调小分块。检索与向量库的实现在 retrieval/。多模型切换入口对话框顶部标题旁的模型下拉框随时切换无需刷新。关键参数Admin → Settings → Connections 里可同时挂多个 Ollama 地址和 OpenAI 端点每个端点独立测试连通。验收两个会话分别选中不同模型回复风格与模型名标识随之变化历史消息互不串扰。工具与插件扩展入口左侧边栏 Tools 页添加、启停工具Admin 面板管理 Function 与 Pipeline。关键参数工具的enabled开关和参数级阀门Valves即每个工具自带的配置项。验收让模型查一下当前时间对话中出现工具调用过程块且结果正确返回说明调用闭环成立。内置工具源码见 tools/。踩坑清单从报错信息反查原因症状大概率原因一步验证方法启动后模型列表为空模型服务不在同机/端口不通curl http://host:11434/api/tags通了再设OLLAMA_BASE_URL3000 端口被占、容器反复重启其他服务已绑定该端口改映射-p 3001:8080重启:cuda镜像起不来缺 NVIDIA 驱动或 nvidia-container-toolkitnvidia-smi报错就换:main跑 CPU首次登录慢或 500首启在跑数据库迁移初始化docker logs open-webui \| tail -50确认初始化日志跑完重启后全员掉线 401WEBUI_SECRET_KEY被动过旧会话失效密钥恢复原值再重启容器传文档报嵌入错误RAG 嵌入模型未连接或不可达Admin → Settings 核对嵌入服务地址这里有个坑Open WebUI 自身日志很干净模型侧的错下载超时、显存不足只会以流中断形式出现先分清是 WebUI 的问题还是 Ollama 的问题。以上都没命中时优先检查容器日志最后 50 行。从个人玩到团队用的升级路径个人单节点 → 多人共享在 Admin → Users 批量建账号用 Groups 按部门分组授权把注册改为管理员邀请制关闭公开注册解决谁来用、用什么权限。引入 PostgreSQL Redis改DATABASE_URL与REDIS_URL解决 SQLite 并发写瓶颈并为 WebSocket 通知与查询缓存提供后端。接入监控LOG_FORMATjson输出结构化日志喂给采集器UVICORN_WORKERS调 2 以上配 docker healthcheck解决坏了没人知道。多副本高可用共享存储挂载DATA_DIR前置 Nginx 反向代理做负载均衡数据库与 Redis 独立成服务解决单点宕机。能力边界要心里有数Open WebUI 不负责模型推理性能70B 模型的生成速度取决于你的 Ollama 机器强实时音视频场景不在它的舒适区Pipeline 与工具生态仍在快速迭代生产环境建议锁定版本号再部署。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考