史上最简单Open-webui安装教程,小白也能轻松上手

 更新时间:2026年10月02日 11:13:57   作者:xianfianpan  
还在为Open-webui安装发愁?本文手把手教你从零开始,搞定Python3.11环境配置、pip换源加速,以及Open-webui和Ollama的集成运行,遇到cannot connect错误也不怕,附赠离线模型下载和Docker部署方案,让你轻松拥有自己的AI聊天界面

一、安装python3.11

这里需要注意,python版本必须为3.11否则无法安装Open-webui

Open-webui现已支持python3.11到3.12,但强烈建议安装python3.11

1、到清华镜像源下载python3.11
链接:

https://mirrors.tuna.tsinghua.edu.cn/python/3.11.9/python-3.12.9.exe

2.双击安装包,开始安装,注意勾选[Add python 3.11 to Path]选项!!

3.选择Customize install选项,建议把安装路径改为其他盘(注意!安装路径中不能有中文)

Tips:若已安装python,但版本不为3.11到3.13之间,按以下操作:

1、下载python3.11压缩包:

https://mirrors.tuna.tsinghua.edu.cn/python/3.11.9/python-3.11.9-embed-amd64.zip

2、解压:

这里我解压到D盘,可自行根据需求解压到其他盘

在解压后的文件夹中右键,选择在终端中打开

输入:

python -V

应输出 Python 3.11.9

3、安装pip:
前往以下网址:
https://bootstrap.pypa.io/get-pip.py

复制所有内容,在解压后的python文件目录新建文本文档,打开后粘贴上一步复制的内容,保存,并重命名为get-pip.py

在解压后的文件夹中右键,选择打开终端,输入以下命令:

python get-pip.py

4、在解压后的目录中右键打开python311._pth编辑:

去掉 #import site 的#号

3、之后操作中若要打开cmd,请在解压后的文件目录中右键,选择打开终端

4、之后操作中若要使用pip,请把pip替换为python -m pip

二、测试python

1、按下win+r打开运行框,输入cmd,回车

2、在命令提示符中输入python

3、如果显示如下,那么恭喜你,成功安装了Python!


3、输入exit()退出python

4、输入pip list,显示:


 

三、pip换源

在cmd中输入:

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple

四、安装open-webui

1、打开cmd,输入:

pip install open-webui

等待安装完成~~

2、等待过程结束后,输入:

open-webui serve

Tips:若已安装python,但版本不为3.11到3.13之间,按以下操作:
打开cmd,输入:

cd Scripts
open-webui serve

五、解决can not connet问题

Tips:如果没有出现任何问题,可直接跳到第六章

1、打开cmd,输入

set HF_ENDPOINT=https://hf-mirror.com
pip install open-webui==0.2.0


再输入:

open-webui serve


随后经历漫长的等待,可以先泡杯咖啡,大约需等15分钟左右

Tips:若已安装python,但版本不为3.11到3.13之间,按以下操作:
打开cmd,输入:

set HF_ENDPOINT=https://hf-mirror.com
python -m pip install open-webui==0.2.0
cd Scripts
open-webui serve

Tips:如果有huggingface.co的镜像,也可以按如下操作:

此方法无需科学上网

1、下载model.safetensors:

https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2/resolve/main/model.safetensors

或在文章顶部下载

2、复制到缓存文件夹:

打开
C:\Users\你的用户名\ .cache\huggingface\hub\models–sentence-transformers–all-MiniLM-L6-v2\snapshots

例如:

在cmd中运行 open-webui serve,会生成一个随机名称文件夹


等到cmd出现这个界面时

快速把刚下载的model.safetensor复制到随机名称文件夹中

如果显示如下就代表成功了:
打开Open-Webui网页

Tips:

每次运行open-webui时记得先输入

set HF_ENDPOINT=https://hf-mirror.com

六、升级open-webui

打开cmd,输入:

pip install open-webui --upgrade

七、运行ollama+open-webui

1、打开cmd,输入:

ollama serve


2、打开另一个cmd,输入:

open-webui serve

3、访问链接:

open-webui

网站截图:


登陆界面截图:


 

八、docker安装open-webui

1.如果您的计算机上安装了Ollama,可以使用以下命令:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.nju.edu.cn/open-webui/open-webui:main

2.如果Ollama在另一台服务器上,请使用以下命令:
连接到另一台服务器上的Ollama时,请将OLLAMA_BASE_URL更改为服务器的URL:

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always  ghcr.nju.edu.cn/open-webui/open-webui:main

要使用Nvidia GPU支持运行Open WebUI,请使用以下命令:

docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always  ghcr.nju.edu.cn/open-webui/open-webui:cuda

3.带有捆绑Ollama支持的Open WebUI安装
此安装方法使用一个单独的容器映像,将Open WebUI与Ollama捆绑在一起,通过单个命令实现简化设置。根据您的硬件设置选择适当的命令:

使用GPU支持:通过运行以下命令利用GPU资源

docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always  ghcr.nju.edu.cn/open-webui/open-webui:ollama 

4.如果内存>16GB,推荐使用docker,如果内存<=16GB,推荐使用python+open-webui

到此这篇关于史上最简单Open-webui安装教程,小白也能轻松上手的文章就介绍到这了,更多相关Open-webui安装教程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 使用Python将图片转正方形的两种方法实例代码详解

    使用Python将图片转正方形的两种方法实例代码详解

    这篇文章主要介绍了使用Python将图片转正方形的两种方法,本文通过实例代码给大家给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-04-04
  • python except异常处理之后不退出,解决异常继续执行的实现

    python except异常处理之后不退出,解决异常继续执行的实现

    这篇文章主要介绍了python except异常处理之后不退出,解决异常继续执行的实现,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-04-04
  • 利用matplotlib实现两张子图分别画函数图

    利用matplotlib实现两张子图分别画函数图

    这篇文章主要介绍了利用matplotlib实现两张子图分别画函数图问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-08-08
  • python爬虫的一个常见简单js反爬详解

    python爬虫的一个常见简单js反爬详解

    这篇文章主要介绍了python爬虫的一个常见简单js反爬详解我们在写爬虫是遇到最多的应该就是js反爬了,今天分享一个比较常见的js反爬,我把js反爬分为参数由js加密生成和js生成cookie等来操作浏览器这两部分,需要的朋友可以参考下
    2019-07-07
  • 一文带你了解Python中Scikit-learn库的使用

    一文带你了解Python中Scikit-learn库的使用

    Scikit-learn是Python的一个开源机器学习库,它支持监督和无监督学习,本文主要来深入探讨一下Scikit-learn的更高级的特性,感兴趣的小伙伴可以了解下
    2023-07-07
  • Python并发编程之IO模型

    Python并发编程之IO模型

    本文详细讲解了Python并发编程之IO模型,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-06-06
  • Python中访问类变量与实例变量的完整步骤

    Python中访问类变量与实例变量的完整步骤

    在Python中,类变量和实例变量的访问方式有所不同,理解它们的区别和正确访问方法很重要,所以本文给大家详细介绍了Python访问类变量与实例变量的完整步骤,需要的朋友可以参考下
    2025-10-10
  • Python 切分数组实例解析

    Python 切分数组实例解析

    这篇文章主要介绍了Python 切分数组实例解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-11-11
  • 打包FlaskAdmin程序时关于static路径问题的解决

    打包FlaskAdmin程序时关于static路径问题的解决

    近期写了个基于Flask-admin的数据库管理程序,通过pyinstaller打包,给别人用,经过几次尝试,打包的数据一直找不到static里面的样式文件,查阅资料后,最总把问题搞定了。写下处理流程,供后来人参考
    2021-09-09
  • Python3中将字符串转换为字节的三种方法

    Python3中将字符串转换为字节的三种方法

    在Python 3中,字符串(str)和字节(bytes)是两种不同的数据类型,在处理文件、网络传输等场景时,经常需要将字符串转换为字节,Python提供了多种方法来实现这一转换,本文将详细介绍这些方法及其区别,需要的朋友可以参考下
    2025-06-06

最新评论