Open WebUI VPS 部署教程：给 Ollama 配一个网页聊天界面

Ollama 装好了，但每次都在终端里敲命令聊天，既不直观也不方便。Open WebUI 就是给 Ollama 套上一个网页聊天界面，支持多轮对话、历史记录、文件上传、代码高亮，还能挂载本地知识库。这篇 Open WebUI VPS 部署教程 会手把手教你在 VPS 上跑起来，全程用 Docker 搞定，不需要手动配 Python 环境。

部署前准备：一台 VPS 和 Docker

你手里的 VPS 建议至少 2 核 4G 内存，如果 Ollama 还要跑 7B 模型，内存最好 8G 以上。系统推荐 Ubuntu 22.04 或 Debian 12。先确认 Docker 已安装：

docker –version # 没输出就装一下

没装 Docker 的话，一行搞定：

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER # 把当前用户加入 docker 组，避免每次 sudo
newgrp docker # 刷新组权限

Docker 部署 Open WebUI

官方推荐用 Docker Compose 或直接 `docker run`。这里用最简洁的 `docker run` 方式，适合快速验证。

拉取镜像并启动容器

docker run -d -p 3000:8080 \
–name open-webui \
–restart always \
-v open-webui:/app/backend/data \
ghcr.io/open-webui/open-webui:main

解释一下参数：

• `-d`：后台运行

• `-p 3000:8080`：宿主机的 3000 端口映射到容器的 8080 端口

• `–name`：容器名，方便管理

• `–restart always`：VPS 重启后自动拉起

• `-v open-webui:/app/backend/data`：持久化数据卷，聊天记录和配置不会丢

启动后访问 `http://你的VPS公网IP:3000`，应该能看到注册页面。第一次注册的账号默认成为管理员。

连接本地 Ollama

如果 Ollama 和 Open WebUI 在同一台 VPS 上，默认配置会自动检测到 `http://localhost:11434`。但如果你用了 Docker 部署 Ollama，或者想连接远程 Ollama 实例，需要在 Open WebUI 的设置里手动填写 Ollama 地址。

进入 Open WebUI 后台 → 设置 → 连接 → Ollama Base URL，填 `http://宿主机IP:11434` 或 `http://host.docker.internal:11434`（Windows/Mac Docker Desktop 专用）。Linux 下用宿主机IP更稳。

Nginx 反向代理（可选但推荐）

直接暴露 3000 端口不太安全，建议用 Nginx 反代加上域名和 HTTPS。先装 Nginx：

sudo apt install nginx -y

然后创建配置文件 `/etc/nginx/sites-available/open-webui`：

nginx
server {
listen 80;
server_name your-domain.com;

location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}

启用站点并重载 Nginx：

sudo ln -s /etc/nginx/sites-available/open-webui /etc/nginx/sites-enabled/
sudo nginx -t # 检查配置
sudo systemctl reload nginx

之后用 Certbot 申请免费 SSL 证书，一步到位：

sudo apt install certbot python3-certbot-nginx -y
sudo certbot –nginx -d your-domain.com

常见问题排查

页面空白或一直转圈

八成是 Ollama 没启动或者 Open WebUI 连不上 Ollama。先检查 Ollama 服务状态：

systemctl status ollama # 或者 docker ps | grep ollama
curl http://localhost:11434/api/tags # 看能不能返回模型列表

如果 Ollama 正常但 Open WebUI 连不上，去设置里检查 Ollama Base URL 是否写对了。

上传文件报错

默认文件上传大小限制是 10MB，如果 Ollama 模型支持大文件，可以改环境变量。重新创建容器时加上 `-e MAX_FILE_SIZE=100`（单位 MB）。或者修改 Nginx 的 `client_max_body_size` 指令。

内存不足导致容器退出

用 `docker logs open-webui` 查看日志，看到 `Killed` 或 OOM 字样就是内存不够。要么升级 VPS，要么限制容器内存：

docker run -d –memory="4g" –memory-swap="4g" … # 限制最大4G

老鸟叮嘱

1.不要用 root 跑容器。虽然 Docker 默认需要 root 权限，但容器内应用不要以 root 运行。官方镜像默认用了非 root 用户，放心。
2.端口别裸奔。3000 端口暴露公网后，建议用防火墙只放行 Nginx 的 80/443，或者用 ufw 限制来源 IP。
3.定期备份数据卷。`docker volume inspect open-webui` 可以看数据卷路径，定期把那个目录 tar 打包走。
4.升级前先备份。`docker pull ghcr.io/open-webui/open-webui:main` 拉新镜像后，停掉旧容器、删掉、用新镜像启动，数据卷里的内容不会丢。

FAQ

Q1：Open WebUI 必须和 Ollama 在同一台 VPS 上吗？
不一定。Open WebUI 可以连接远程 Ollama 服务器，只要网络互通，在设置里填远程地址即可。但延迟会高一些。

Q2：部署后注册页面加载很慢怎么办？
检查 VPS 网络是否通畅，首次加载需要拉取前端静态资源。如果用国内 VPS，可以考虑给 Docker 配置国内镜像加速，或者把镜像提前拉好。

Q3：我想用 GPU 加速，怎么配置？
如果 VPS 有 NVIDIA GPU，需要安装 nvidia-docker2 并加上 `–gpus all` 参数。但大部分云 VPS 不带 GPU，这样配置意义不大。Open WebUI 本身不跑模型，GPU 加速是 Ollama 的事。

Q4：如何重置管理员密码？
删除容器数据卷里的 `auth.db` 文件（在数据卷路径下），重启容器后重新注册即可成为新管理员。更稳妥的做法是进入容器用 SQLite 命令行修改。

Q5：Open WebUI 支持多用户吗？
支持。注册页面任何人都能注册，管理员可以在后台管理用户权限。默认注册即用，生产环境建议关闭公开注册，只允许管理员邀请。

Q6：能不能用 Docker Compose 同时部署 Ollama 和 Open WebUI？
可以，官方仓库有 docker-compose.yml 示例。但如果你只想给已有的 Ollama 加界面，单容器更轻量。

给 Ollama 配一个网页聊天界面，Open WebUI 是目前最成熟的选择。Docker 部署十分钟就能跑起来，配合 Nginx 反代加 HTTPS，日常聊天、调试模型都很顺手。如果你在 VPS 上折腾 AI 工具，这套组合值得一试。

—

**相关阅读：**

– [VPS 部署 AI 工具需要哪些基础？Linux、Docker、Nginx 和域名配置入门](https://www.zhujixuan.com/jishujiaocheng/9747.html)
– [Hermes Agent VPS 部署教程：Docker Compose 安装和初始化配置](https://www.zhujixuan.com/jishujiaocheng/9872.html)
– [AI 知识库部署常见问题：内存、磁盘、模型 API 和数据安全](https://www.zhujixuan.com/jishujiaocheng/9890.html)