本地安装Open Web UI(非docker)
环境准备
-
安装 Python
-
下载并安装 Python 3.11.9,建议安装路径中不要包含中文字符,并勾选“Add Python 3.11 to Path”选项。
-
安装完成后,在命令提示符中输入 python,若显示 Python 版本信息,则表示安装成功。
-
安装 Node.js 和 npm
-
访问 Node.js 中文网,下载并安装较新版本的 Node.js(如 v22.10.0),安装过程中会自动安装 npm。
-
在命令提示符中输入 npm -v,若显示 npm 版本信息,则表示安装成功。
-
-
项目安装与启动
-
克隆 OpenWebUI 项目
-
使用以下命令克隆 OpenWebUI 项目,或直接下载 OpenWebUI GitHub 仓库 的 zip 文件:
bash复制
git clone https://github.com/open-webui/open-webui.git
-
导航到 OpenWebUI 项目目录
-
打开命令提示符,导航到 OpenWebUI 项目目录:
bash复制
cd open-webui
-
安装 npm 依赖
-
在项目根目录下运行以下命令,安装前端所需的 npm 依赖:
bash复制
npm install
-
安装 Python 依赖
-
进入 backend 目录:
bash复制
cd backend
-
执行以下命令,安装后端所需的 Python 依赖:
bash复制
pip install -r requirements.txt
-
-
-
-
后端启动
-
启动后端服务
进入 backend 目录
-
macOS 用户:
-
运行 dev.sh 脚本:
用途:用于在开发环境中快速启动 Open Web UI 的后端服务。
功能:
1.设置默认端口为 8080(可以通过环境变量 PORT 覆盖)。
2.使用 uvicorn 启动 FastAPI 应用程序(open_webui.main:app)。
3.启用热重载(--reload),方便开发时自动重启服务。
4.允许所有 IP 地址访问(--forwarded-allow-ips '*')。
-
bash复制
bash dev.sh
-
或运行 start.sh 脚本:
用途:用于启动 Open Web UI 的完整服务,包括一些额外的配置和依赖检查。
功能:
-
检查是否需要安装 Playwright 浏览器(用于网页抓取)。
-
检查是否需要生成随机的 WEBUI_SECRET_KEY。
-
如果启用了 Ollama 或 CUDA,会进行相应的配置。
-
如果设置了 SPACE_ID,会配置 HuggingFace Space 部署。
-
最终使用 uvicorn 启动 FastAPI 应用程序。
-
bash复制
bash start.sh
-
选择适合您的脚本运行。
如果你是开发者,正在进行代码修改和调试:
-
推荐运行 dev.sh。
这个脚本会启用热重载(--reload),当你修改代码时,服务会自动重启,非常适合开发环境。
-
如果你希望启动完整的生产环境服务:
运行 start.sh。
这个脚本会进行更多的配置检查,包括 Playwright、Ollama、CUDA 等,适合完整的生产环境部署。
-
Windows 用户:
-
将项目目录下的 start_windows.bat 文件双击运行,或者在命令提示符(CMD)中导航到项目目录并运行以下命令:
cmd复制
start_windows.bat
-
后端访问地址为:http://localhost:8080/
-
-
-
-
-
前端启动
-
启动前端服务
回到 OpenWebUI 项目根目录,执行以下命令启动前端开发服务器:-
bash复制
npm run dev
-
前端访问地址为:http://localhost:5173/
-
可能会出现跨域,添加下ip可简单过滤: