3步搞定Open WebUI部署Docker一键、源码手动、GPU加速10分钟上线私有AI聊天平台【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是开源自托管 AI 聊天界面把 Ollama、OpenAI 兼容 API 接进同一套 Web 应用一次部署搞定登录、模型管理和知识库。适合能看懂命令行、想快速部署私有 AI 平台的开发者只调 API 不需要界面的场景不必用。它能帮你干什么你可以把它当成团队的统一 AI 入口接上 Ollama 或任意 OpenAI 兼容服务同事打开浏览器就能聊天、传文档提问不用再各自折腾客户端。离线跑本地模型接任意OpenAI兼容接口上传文档做RAG问答多用户分组管理先选路3种Open WebUI部署路径怎么挑你的情况走哪条路想最快出效果不想碰源码路径ADocker Compose 一键部署自带 Ollama要改源码、做二次开发路径B手动源码部署有 NVIDIA 显卡要加速推理路径CGPU 加速版不关心的路径直接跳过去。路径ADocker Compose 一键部署Open WebUI前置条件机器上装好 Docker 和 Docker ComposeDocker Desktop 自带Python、Node 都不用装。第1步克隆仓库。这条命令把代码拉到本地并进入目录git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui看到仓库文件docker-compose.yaml 等即成功。第2步起服务。下面这条命令会拉起 Ollama 和 Open WebUI 两个容器docker compose up -d首次会拉镜像、本地构建几分钟到十几分钟docker compose ps看到两个容器都是 Up 状态即成功。第3步浏览器打开 http://localhost:3000 看到注册页 ✅ ——第一个注册的账号自动成为管理员。路径B手动源码部署Open WebUI前置条件Python 3.11~3.12、Node.js 18、Git。第1步克隆仓库复用路径A第1步。第2步装前后端依赖。这一条命令同时装好两边pip install -r backend/requirements.txt npm install无报错输出即成功。第3步构建前端。FastAPI 会直接把构建产物当静态页面托管省掉单独起前端服务npm run build看到 build 目录生成即成功。第4步启动后端。首次启动会自动建库并迁移cd backend uvicorn open_webui.main:app --host 0.0.0.0 --port 8080浏览器打开 http://localhost:8080 出现登录页即成功。路径CGPU加速版Open WebUI启动命令前置条件NVIDIA 显卡 nvidia-container-toolkit让容器能摸到 GPU 的驱动层。克隆步骤同上启动时叠上 GPU 覆盖文件docker compose -f docker-compose.yaml -f docker-compose.gpu.yaml up -dollama ps能看到 GPU 占用、拉模型速度明显变快 即成功。让Open WebUI真正跑起来接上你的第一个模型路径A自带 Ollama容器内已默认指向http://ollama:11434登录后在模型页选模型就能聊。想改指向远程 Ollama或干脆换成 OpenAI 兼容服务OpenAI、Groq、Mistral 都行在项目根目录的.env文件里改这三项OLLAMA_BASE_URLhttp://localhost:11434 OPENAI_API_BASE_URLhttps://api.openai.com/v1 OPENAI_API_KEYsk-your-key改完重启容器或后端服务模型页出现对应模型即生效。锁住注册入口第一个账号是管理员之后的自助注册建议关掉.env里加一行ENABLE_SIGNUPfalse再重启注册入口就收口到管理员手动建号。收紧API密钥权限要开放/api/v1/chat这类接口给外部调用别用账号密码用 API 密钥并限制它能碰的端点ENABLE_API_KEY_ENDPOINT_RESTRICTIONStrue API_KEYS_ALLOWED_ENDPOINTS/api/v1/chat,/api/v1/models重启后密钥只能访问白名单里的端点越权请求直接拒绝。出问题了怎么办⚠️ 三个高频问题按症状 → 排查 → 修复走连不上 Ollama症状是模型页报错。跑docker compose ps确认 ollama 容器 Upcompose 部署下OLLAMA_BASE_URL已默认注入若你是docker run单容器方式改用 host 网络模式细节见 TROUBLESHOOTING.md。长回复中途断掉默认 5 分钟超时。在.env调大AIOHTTP_CLIENT_TIMEOUT单位秒重启即可。页面打不开先docker compose logs open-webui看后端有没有起来首次构建慢耐心等完再刷新端口冲突就用OPEN_WEBUI_PORT换端口。日常运维速查操作Docker 部署手动部署启动docker compose up -dcd backend uvicorn open_webui.main:app --host 0.0.0.0 --port 8080停止docker compose downCtrlC或pkill -f uvicorn日志docker compose logs -f open-webui终端输出即日志更新git pull docker compose up -dgit pull npm run build后重启后端备份docker cp open-webui:/app/backend/data ./backup-datacp -r backend/data ./backup-data到这里你的平台已经可以接私活了。遇到问题先去仓库 Issues 区搜一遍或到官方 Discord 社区提问。相关文件后端配置源码、compose编排文件【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 3步搞定Open WebUI部署：Docker一键、源码手动、GPU加速，10分钟上线私有AI聊天平台
3步搞定Open WebUI部署Docker一键、源码手动、GPU加速10分钟上线私有AI聊天平台【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是开源自托管 AI 聊天界面把 Ollama、OpenAI 兼容 API 接进同一套 Web 应用一次部署搞定登录、模型管理和知识库。适合能看懂命令行、想快速部署私有 AI 平台的开发者只调 API 不需要界面的场景不必用。它能帮你干什么你可以把它当成团队的统一 AI 入口接上 Ollama 或任意 OpenAI 兼容服务同事打开浏览器就能聊天、传文档提问不用再各自折腾客户端。离线跑本地模型接任意OpenAI兼容接口上传文档做RAG问答多用户分组管理先选路3种Open WebUI部署路径怎么挑你的情况走哪条路想最快出效果不想碰源码路径ADocker Compose 一键部署自带 Ollama要改源码、做二次开发路径B手动源码部署有 NVIDIA 显卡要加速推理路径CGPU 加速版不关心的路径直接跳过去。路径ADocker Compose 一键部署Open WebUI前置条件机器上装好 Docker 和 Docker ComposeDocker Desktop 自带Python、Node 都不用装。第1步克隆仓库。这条命令把代码拉到本地并进入目录git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui看到仓库文件docker-compose.yaml 等即成功。第2步起服务。下面这条命令会拉起 Ollama 和 Open WebUI 两个容器docker compose up -d首次会拉镜像、本地构建几分钟到十几分钟docker compose ps看到两个容器都是 Up 状态即成功。第3步浏览器打开 http://localhost:3000 看到注册页 ✅ ——第一个注册的账号自动成为管理员。路径B手动源码部署Open WebUI前置条件Python 3.11~3.12、Node.js 18、Git。第1步克隆仓库复用路径A第1步。第2步装前后端依赖。这一条命令同时装好两边pip install -r backend/requirements.txt npm install无报错输出即成功。第3步构建前端。FastAPI 会直接把构建产物当静态页面托管省掉单独起前端服务npm run build看到 build 目录生成即成功。第4步启动后端。首次启动会自动建库并迁移cd backend uvicorn open_webui.main:app --host 0.0.0.0 --port 8080浏览器打开 http://localhost:8080 出现登录页即成功。路径CGPU加速版Open WebUI启动命令前置条件NVIDIA 显卡 nvidia-container-toolkit让容器能摸到 GPU 的驱动层。克隆步骤同上启动时叠上 GPU 覆盖文件docker compose -f docker-compose.yaml -f docker-compose.gpu.yaml up -dollama ps能看到 GPU 占用、拉模型速度明显变快 即成功。让Open WebUI真正跑起来接上你的第一个模型路径A自带 Ollama容器内已默认指向http://ollama:11434登录后在模型页选模型就能聊。想改指向远程 Ollama或干脆换成 OpenAI 兼容服务OpenAI、Groq、Mistral 都行在项目根目录的.env文件里改这三项OLLAMA_BASE_URLhttp://localhost:11434 OPENAI_API_BASE_URLhttps://api.openai.com/v1 OPENAI_API_KEYsk-your-key改完重启容器或后端服务模型页出现对应模型即生效。锁住注册入口第一个账号是管理员之后的自助注册建议关掉.env里加一行ENABLE_SIGNUPfalse再重启注册入口就收口到管理员手动建号。收紧API密钥权限要开放/api/v1/chat这类接口给外部调用别用账号密码用 API 密钥并限制它能碰的端点ENABLE_API_KEY_ENDPOINT_RESTRICTIONStrue API_KEYS_ALLOWED_ENDPOINTS/api/v1/chat,/api/v1/models重启后密钥只能访问白名单里的端点越权请求直接拒绝。出问题了怎么办⚠️ 三个高频问题按症状 → 排查 → 修复走连不上 Ollama症状是模型页报错。跑docker compose ps确认 ollama 容器 Upcompose 部署下OLLAMA_BASE_URL已默认注入若你是docker run单容器方式改用 host 网络模式细节见 TROUBLESHOOTING.md。长回复中途断掉默认 5 分钟超时。在.env调大AIOHTTP_CLIENT_TIMEOUT单位秒重启即可。页面打不开先docker compose logs open-webui看后端有没有起来首次构建慢耐心等完再刷新端口冲突就用OPEN_WEBUI_PORT换端口。日常运维速查操作Docker 部署手动部署启动docker compose up -dcd backend uvicorn open_webui.main:app --host 0.0.0.0 --port 8080停止docker compose downCtrlC或pkill -f uvicorn日志docker compose logs -f open-webui终端输出即日志更新git pull docker compose up -dgit pull npm run build后重启后端备份docker cp open-webui:/app/backend/data ./backup-datacp -r backend/data ./backup-data到这里你的平台已经可以接私活了。遇到问题先去仓库 Issues 区搜一遍或到官方 Discord 社区提问。相关文件后端配置源码、compose编排文件【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考