文章目录
- 1、系统环境配置
- 2、源码下载
- 2.1 github源码地址下载
- 3、环境启动
- 3.1 后端环境
- 3.2 前端环境
- 4、问题
- 4.1 浏览器跨域问题
- 4.2 all-MiniLM-L6-v2模型文件下载失败问题
- 4.3 单独部署backend启动报错问题
1、系统环境配置
操作系统：windows/linux/macos
Python版本: Python 3.11+ (建议安装3.11版本，3.12及以上版本可能出现不兼容)
Nodejs版本：22.10.0 (建议安装22.11及以上版本)
2、源码下载
2.1 github源码地址下载
git clone https://github.com/open-webui/open-webui.git
3、环境启动
3.1 后端环境
进入 open-webui\backend 目录下，执行以下命令进行依赖安装
pip install -r requirements.txt
如果是本地测试，需修改open-webui\backend\open_webui\config.py文件中的CORS_ALLOW_ORIGIN参数，否则可能会出现跨域问题
# CORS_ALLOW_ORIGIN = os.environ.get("CORS_ALLOW_ORIGIN", "*").split(";")
CORS_ALLOW_ORIGIN = os.environ.get("CORS_ALLOW_ORIGIN", "http://localhost:5173").split(";")
windows环境下运行start_windows.bat 文件，Linux环境下执行sh start.sh命令
3.2 前端环境
进入 open-webui根目录下，创建环境配置文件
重命名.env.example 为.env
修改模型仓库地址：
OLLAMA_BASE_URL=‘此处替换为要使用的仓库地址，例如：http://10.57.149.9:11434’
最后执行以下命令
npm install
npm run dev
浏览器中访问http://localhost:5173/即可
4、问题
由于部分依赖需要从外网环境下载，因此部署前尽量解决网络问题
4.1 浏览器跨域问题
使用chrome进行测试时可能会出现logo之类静态文件无法加载问题，可以在谷歌应用商店中安装Allow-Control-Allow-Origin，打开之后即可解决，firefox浏览器没有此类问题
4.2 all-MiniLM-L6-v2模型文件下载失败问题
执行脚本命令后，会自动从huggingface.co下载sentence-transformers模型文件all-MiniLM-L6-v2，服务器在国外，无法下载，所以先从国内镜像网站上(https://hf-mirror.com/)将模型和配置文件下载到本地。
修改open_webui/retrieval/utils.py文件
# model_repo_path = snapshot_download(**snapshot_kwargs)
# 替换为本地文件路径
model_repo_path = r'D:\code\code\arkham\all-MiniLM-L6-v2'
4.3 单独部署backend启动报错问题
启动backend时会去当前执行脚本所在目录的上一级去读取CHANGELOG.md（CHANGELOG.md文件在下载源码包的根目录下）文件，文件读取不到则会去当前工作目录下backend/open-webui/寻找，还是找不到则会抛异常，解决方法是将CHANGELOG.md拷贝到backend/open-webui/目录下即可
