Ubuntu 手动安装 Open WebUI 完整指南

前提条件

在安装 Open WebUI 之前，请确保您的系统满足以下要求：

• Ubuntu 22.04 LTS 或更高版本
• Python 3.10+
• Node.js 18+
• Git
• 至少 4GB 内存
• 足够的磁盘空间（推荐 20GB 以上）

安装步骤

1. 更新系统包

sudo apt update
sudo apt upgrade -y

2. 安装必要的依赖

# 安装 Python 和 Node.js
sudo apt install -y python3 python3-pip nodejs npm git curl

# 安装 Python 虚拟环境工具
sudo apt install -y python3-venv

3. 安装 Ollama（AI 后端）

# 下载并安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 启动 Ollama 服务
sudo systemctl enable ollama
sudo systemctl start ollama

4. 克隆 Open WebUI 仓库

# 创建安装目录
mkdir -p ~/open-webui
cd ~/open-webui

# 克隆仓库
git clone https://github.com/open-webui/open-webui.git
cd open-webui

5. 设置 Python 虚拟环境

# 创建虚拟环境
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate

# 安装 Python 依赖
pip install -r backend/requirements.txt

6. 安装前端依赖

# 安装 Node.js 依赖
npm install

# 构建前端
npm run build

7. 配置环境变量

# 创建 .env 文件
cp .env.example .env

# 编辑 .env 文件
nano .env

在 .env 文件中，至少配置以下关键参数：

OLLAMA_BASE_URL=http://localhost:11434
WEBUI_SECRET_KEY=your_unique_secret_key

8. 启动 Open WebUI

开发模式

# 启动后端
cd backend
python3 -m uvicorn main:app --host 0.0.0.0 --port 8080

# 在另一个终端启动前端
cd frontend
npm run dev

生产模式

# 使用 Gunicorn 启动后端
cd backend
gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app

# 使用 Nginx 托管静态文件

9. 创建系统服务

# 创建后端服务文件
sudo nano /etc/systemd/system/open-webui-backend.service

添加以下内容：

[Unit]
Description=Open WebUI Backend
After=network.target

[Service]
Type=simple
User=your_username
WorkingDirectory=/home/your_username/open-webui/open-webui/backend
ExecStart=/home/your_username/open-webui/open-webui/venv/bin/gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app
Restart=on-failure

[Install]
WantedBy=multi-user.target

# 启动并启用服务
sudo systemctl daemon-reload
sudo systemctl enable open-webui-backend
sudo systemctl start open-webui-backend

访问 Open WebUI

• 打开浏览器，访问 http://localhost:8080
• 首次访问需要创建管理员账户

安全建议

配置防火墙

sudo ufw allow 8080/tcp

其他安全措施

• 使用 Nginx 反向代理
• 配置 HTTPS
• 设置强密码
• 定期更新

故障排除

常见问题

• 依赖冲突：使用虚拟环境
• 端口被占用：更改 .env 中的端口配置
• 权限问题：检查文件权限

查看日志

# 查看后端服务日志
journalctl -u open-webui-backend

更新

cd ~/open-webui/open-webui

# 拉取最新代码
git pull

# 更新依赖
source venv/bin/activate
pip install -r backend/requirements.txt
npm install

# 重新构建
npm run build

# 重启服务
sudo systemctl restart open-webui-backend

卸载

# 停止服务
sudo systemctl stop open-webui-backend
sudo systemctl disable open-webui-backend

# 删除服务文件
sudo rm /etc/systemd/system/open-webui-backend.service

# 删除安装目录
rm -rf ~/open-webui