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
