跳到正文
零樱钰
返回

Open WebUI 自部署笔记:给自己的大模型入口做一个像样的界面

如果你已经在本地或服务器上跑了大模型接口,只缺一个顺手的 Web 页面,那 Open WebUI 基本就是最省事的选择之一。
它的定位很直接:给你一个能聊天、管理模型连接、保存历史记录的前端界面。对于不想每次都写 API 请求的人来说,这一步很关键,因为“能不能长期用下去”,很多时候取决于入口是否足够顺手。

它适合放在哪一层

Open WebUI 更像“应用入口”,不是模型本体。
通常做法是把它挂在已有的反向代理后面,再连接你自己的推理服务、OpenAI 兼容接口或局域网里的模型网关。
这样职责更清晰:Open WebUI 负责交互,后端接口负责推理,代理层负责域名和 HTTPS。

compose 示例

你给的最小配置如下:

services:
  open-webui:
    image: ghcr.nju.edu.cn/open-webui/open-webui:main
    container_name: open-webui
    volumes:
      - open-webui_data:/app/backend/data
    networks:
      - proxy-network

volumes:
  open-webui_data:

这里的重点是数据卷 open-webui_data,它负责保存账号、配置和聊天记录。proxy-network 则表示这个服务准备接入已有代理网络,比如和 Nginx Proxy Manager 放到同一个网络里。

部署命令

如果你的代理网络已经存在,可以这样启动:

docker network create proxy-network
mkdir -p ~/apps/open-webui
cd ~/apps/open-webui
docker compose up -d

如果你只是先本机测试,也可以临时给它加一个端口映射,例如 3000:8080。等确认流程没问题,再接入反向代理。

初次上线建议

第一次使用时,建议优先做三件事:

  1. 先确认数据卷已经持久化,不要把聊天记录留在临时容器里。
  2. 再确认它连接的模型接口是否稳定,避免把“界面问题”和“模型服务问题”混在一起排查。
  3. 最后再加域名、HTTPS、外部访问控制。

很多人一上来就把所有环节绑死,结果任何一个地方有问题都会一起报错,排查会很痛苦。

需要注意的边界

Open WebUI 虽然好用,但它通常承载的是聊天记录、模型配置,甚至可能包含内部提示词和业务数据。
所以我的建议是:即使你已经做了公网访问,也最好配合单点登录、访问白名单,或者至少设置强密码和额外认证。
对个人知识库和团队内部助手来说,入口方便很重要,但边界更重要。

如果你已经有模型接口,只差一个“大家都愿意打开用”的入口,Open WebUI 是非常合适的第一步。


分享到:

下一篇
Nginx Proxy Manager 入门:给自部署服务统一配域名和 HTTPS