1. 安装依赖环境

安装 Python 3.11

OpenWebUI 需要 Python 3.11 环境,可以使用以下命令安装:

sudo apt install python3.11 -y

安装 Node.js 和 npm

OpenWebUI 的前端部分需要 Node.js 和 npm 来构建,可以使用以下命令安装:

sudo apt install nodejs npm -y

2. 获取 OpenWebUI 源码

使用 Git 克隆 OpenWebUI 的源码:

git clone GitHub - open-webui/open-webui: User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

npm install -g cnpm --registry=https://registry.npmmirror.com    

cnpm install

创建并激活 Python 虚拟环境,然后安装后端依赖:

cd backend

virtualenv venv -p python3.11

source venv/bin/activate

pip install -r requirements.txt -i Simple Index

配置环境变量(根目录下)

cp .env.example .env

npm run build

运行OpenWebUI:
open-webui serve
报错解决

卸载该模块

sudo apt-get remove --purge python-apt

重新安装
sudo apt-get install python3-apt --reinstall

验证安装
cd /usr/lib/python3/dist-packages/

ls apt_pkg*
接下来执行以下命令:
软链接,确保python能够识别到apt_pkg库
sudo ln -s apt_pkg.cpython-310-x86_64-linux-gnu.so apt_pkg.so

没报apt_pkg模块不存在错误后,出现新的问题,没找到openwebui,这时候我们pip list |grep open-webui查看发现库不存在,执行pip install open-webui安装库

安装完成后运行:open-webui serve

在浏览器中访问:

这边我采用的是阿里云的服务器的公网地址:


自此部署完成

存在问题:

问题分析,OpenWebUI 需要的 Node.js 版本是 >=18.13.0 <=22.x.x,而你当前的 Node.js 版本是 v12.22.9,不满足要求。而我这边 npm 版本是 8.5.1,虽然满足要求,但 Node.js 版本过低导致整个安装失败。

解决方法

1. 升级 Node.js

将 Node.js 升级到 OpenWebUI 要求的版本范围(>=18.13.0 <=22.x.x)。以下是具体步骤:

安装 NVM:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

安装完成后,重新加载终端或运行以下命令:source ~/.bashrc

安装符合要求的 Node.js 版本:nvm install 18.20.4

切换到新安装的 Node.js 版本:nvm use 18.20.4

Logo

技术共进,成长同行——讯飞AI开发者社区

更多推荐