安装Open WebUI网页界面(Python版)

为什么要用Python版而不是Docker版？ 在国内网络环境下，Docker拉取GHCR镜像很容易失败，而Python版可以用国内PyPI镜像，下载速度快且稳定。

1 安装Python 3.11

Open WebUI对Python版本有要求，必须使用Python 3.11：

# 添加 deadsnakes PPA

sudo apt update

sudo apt install software-properties-common -y

sudo add-apt-repository ppa:deadsnakes/ppa -y

sudo apt update

# 安装 Python 3.11

sudo apt install python3.11 python3.11-venv python3.11-dev -y

# 验证

python3.11 --version

2 创建虚拟环境

cd ~

mkdir openwebui-python

cd openwebui-python

python3.11 -m venv venv

source venv/bin/activate

# 提示符前面会出现 (venv)

3 安装Open WebUI

# 升级pip

pip install--upgrade pip

# 用国内镜像安装

pip install-i https://pypi.tuna.tsinghua.edu.cn/simple open-webui

4 配置Hugging Face镜像（关键！）

Open WebUI启动时会从Hugging Face下载一个embedding模型，必须设置国内镜像：

# 设置环境变量

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

为了永久生效，可以加到bashrc：

echo'export HF_ENDPOINT=https://hf-mirror.com'>> ~/.bashrc

source ~/.bashrc

5 启动Open WebUI

# 设置Ollama连接地址

export OLLAMA_BASE_URL=http://192.168.31.16:11434

# 启动服务（指定监听所有网络接口和端口）

open-webui serve --host0.0.0.0 --port8081

如果提示“端口已被占用”，可以换成其他端口如8082。

6 首次访问

在局域网内任何一台电脑的浏览器中输入：

http://192.168.31.16:8081

第一次访问会看到注册页面，创建一个管理员账号（数据只保存在你的服务器上）。登录后，在左上角选择 qwen3.5:4b 模型，就可以开始聊天了！

配置联网搜索（让AI能查实时天气）

本地模型的知识截止到训练日期，不知道实时信息。但我们可以给Open WebUI开启联网搜索功能。

最简单：使用DuckDuckGo（无需API密钥）

1. 登录Open WebUI，点击左下角头像 → 「管理员面板」

2. 进入 「设置」→「联网搜索」

3. 开启「启用联网搜索」开关

4. 「搜索引擎」选择 「DDGS」

5. 点击「保存」

现在回到聊天界面，输入框下方会出现「启用联网搜索」复选框，勾选后提问“今天苏州天气怎么样？”，模型就会先去搜索再回答。

8.2 更精准：使用Bocha（博查）API

1. 访问 博查AI开放平台 注册

2. 进入「API Key管理」→ 创建密钥，复制 sk-xxxxxx

3. 在Open WebUI的「联网搜索」设置中，选择「Bocha」，粘贴API密钥

博查对中文搜索结果优化更好。

9️⃣ 开机自启设置

为了让服务器重启后，Open WebUI也能自动启动，我们需要创建systemd服务。

9.1 创建服务文件

sudo nano /etc/systemd/system/open-webui.service

粘贴以下内容（注意修改成你的实际路径和端口）：

[Unit]

Description=Open WebUI Service

After=network.target ollama.service

[Service]

Type=simple

User=root

WorkingDirectory=/root/openwebui-python

Environment="PATH=/root/openwebui-python/venv/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"

Environment="HF_ENDPOINT=https://hf-mirror.com"

Environment="OLLAMA_BASE_URL=http://192.168.31.16:11434"

ExecStart=/root/openwebui-python/venv/bin/open-webui serve --host 0.0.0.0 --port 8081

Restart=always

[Install]

WantedBy=multi-user.target

保存退出。

9.2 启用服务

sudo systemctl daemon-reload

sudo systemctl enable open-webui

sudo systemctl start open-webui

sudo systemctl status open-webui  

# 确认是 active (running)

9.3 验证开机自启

现在你可以重启服务器测试：

sudo reboot

重启后，等一两分钟，浏览器访问 http://192.168.31.16:8081，应该能正常打开界面。

🔍 常用命令速查

❓ 常见问题与解决

Q1：浏览器无法访问 http://192.168.31.16:8081

可能原因：

• Open WebUI服务没运行 → systemctl status open-webui 查看

• 防火墙阻挡 → sudo ufw allow 8081 开放端口

• IP地址变了 → 用 ip a 查看新IP，修改访问地址

Q2：Open WebUI界面看不到模型

解决方法：

• 检查Ollama是否运行：systemctl status ollama

• 检查Ollama连接地址：curl http://192.168.31.16:11434/api/tags

• 确认环境变量：OLLAMA_BASE_URL 设置是否正确

Q3：联网搜索失败

解决方法：

• 检查是否勾选了「启用联网搜索」复选框

• 尝试更换搜索引擎（如从DuckDuckGo换成Bocha）

• 检查网络连接：ping 8.8.8.8

恭喜你！现在你已经拥有了一台完全属于自己的、免费的、私密的AI服务器！你可以：

• ✅ 在电脑、手机、平板上随时访问

• ✅ 不限次数、不限流量

• ✅ 所有数据只保存在本地

• ✅ 可以自由更换任何开源模型

🚀 进阶玩法推荐

1. 添加更多模型：

   ollama pull qwen2.5:7b   # 更强的推理能力

   ollama pull llama3.2:3b  # 轻量快速

   ollama pull deepseek-r1:7b # 深度求索

2. 上传文档提问：Open WebUI支持上传PDF、Word、Excel、PPT等文件，让模型帮你总结分析。

3. 从外网访问：如果想在外面也能用，可以搭配内网穿透工具（如frp、ngrok），但要注意安全。

4. 配置多个用户：Open WebUI支持多用户注册，可以分享给家人朋友使用。