基于 webui 部署 ollama 可视化对话界面

模型与算力

讲清给 Ollama 配一个可视化对话界面并在局域网内让同事或手机访问,包括选界面、改监听地址、放行端口和连不上时的排查顺序。

本地用命令行跑 Ollama 还行,但一旦想让同屋的同事、自己的手机或另一台机器用上这个模型,就会卡在几件事上:装哪个界面、为什么别的机器打开是空白、局域网里搜不到服务。这篇不评估模型好坏,只把「部署一个 Web 界面 + 让局域网内其他设备能访问」这条路走通,并给出连不上时按顺序排查的方法。

本地命令行跑 Ollama 做试验没问题,但一旦想让同屋同事、自己的手机或另一台笔记本用上这个模型,卡点就来了:装哪个界面、为什么别的机器打开是空白页、局域网里根本搜不到服务。这篇只解决「部署一个 Web 可视化界面 + 让局域网内其他设备能访问」这一条路,模型本身好不好不在讨论范围内。

整条路其实就四步:按用途选界面、把监听地址和端口打通、连不上时按层排查、多人用之前想清楚并发与安全。下面逐段说做法,遇到判断类的地方也会写清什么情况下不适用。

先选界面:你要的到底是哪一种

市面上的 Ollama 图形界面大致分三类:纯对话型、带知识库与多用户的平台型、桌面客户端型。选之前先问自己一句——只是自己用,还是要发给别人用?这一个问题就能砍掉一大半选项。

  • 纯对话型:单人或小范围分享够用,部署轻,通常没有账号体系
  • 平台型:带多用户、知识库、访问记录,适合长期给一个小团队用
  • 桌面客户端型:装在某台个人电脑上,天然不适合当服务器给别的设备访问
  • 选型看三件事:要不要账号隔离、要不要挂本地文件做知识库、要不要跑在服务器而不是个人电脑上

拿不准同类方案怎么分叉,可以到 /models/deploy 和 /ai-nav/category/ai-model-platform 看分支说明,别只凭界面截图好不好看下决定。

让它能被别的机器看到:监听地址与端口这两件事

默认配置只监听本机回环地址,也就是只有这台机器自己能连。别的设备打不开,八成卡在这里。要让局域网可达,得同时搞定两层:模型服务本身的对外暴露,以及 Web 界面进程的端口映射。

  1. 改模型服务监听地址把服务监听的地址从回环改成对所有网卡生效,改完重启服务,在本机确认服务正常监听
  2. 确认端口映射Web 界面如果是容器或独立进程,检查它的端口是否映射到宿主机对外可达的端口,只映射到回环同样会被拦
  3. 本机先访问一次用那台机器的浏览器访问一次界面,确认服务本身是活的,再交给别的设备测
  4. 换设备验证从另一台机器或手机访问,地址里填宿主机的局域网 IP,不要填 localhost

跨机访问时,请求或配置里出现的地址一律用那台机器的局域网 IP,用 localhost 会被解析成「访问者自己」,这是新手最常踩的坑。

局域网里搜不到,多半不是模型的问题

连不上时别反复重启服务,按网络层、端口层、服务层、应用层这个顺序查,比乱试有效得多。每一层都能单独验证,分清了再动手。

表现先查哪层常见原因
本机能开、别机打不开服务层与端口层监听地址仍是回环,或端口只映射到本机
两台设备互相 ping 不通网络层Wi-Fi 与有线不同网段、路由器开了客户端隔离
IP 能通但界面空白应用层请求地址填了 localhost 或旧 IP
时快时慢、像连不上链路层带宽或延迟问题,不是服务配置错误

用同一台机器的浏览器先访问一次,确认服务活着;再从另一台设备访问,就能区分是服务没起来还是网络不通。公司网络限制设备互访、路由器隔离,这几种表现都像「连不上」,但和你的配置无关。

想排除是链路慢而不是真连不上,可以顺手在 /tools/speed-test 量一下基线,别把「慢」当成「断」处理。

多人同时用之前,先想清楚两件事

一个人调得动,不代表五个人同时上还稳。并发上去以后显存和响应速度会明显下降,先想清楚这套环境是给自己用,还是给一个小团队共用,别默认「能连上就等于能扛住」。

  • 部署前定使用范围:单机、几台设备、还是整个小组,范围决定选哪类界面
  • 局域网暴露意味着同网段的人都能调你的模型,敏感数据、内网资料别放进这套环境跑
  • 需要账号隔离、访问记录或长期多人用,选带用户体系的平台型界面,纯对话型上限低
  • 先按最保守的网络范围配,确认需求再放宽,不要一步开到最大

什么情况下不适用:只是临时演示给对面工位看一眼,就不必上多用户方案,把监听地址、端口和 IP 对上就行。要对比不同部署方案和同级服务的能力差异,可以到 /sites 和 /rankings 看整理好的条目,具体能力与性能数字以页面当时显示的为准;这一类判断别凭印象,到站内核对当期数据更靠谱。

下一步界面选型、监听配置和排查顺序都有现成条目可对照,先去部署与平台分类页把可选方案过一遍,再回来看自己的网络范围该配到哪一档。

常见问题

为什么本机浏览器能打开,同一个局域网里的手机却打不开?

最常见的是服务只监听了本机回环地址,或者界面端口没有映射出来,其次是系统防火墙/安全软件拦了端口、路由开了客户端隔离。按「本机先能开 → 换成局域网 IP 再试 → 换另一台设备试」的顺序走,一般两层里必有一层没通。

局域网访问时地址该填什么,为什么填 localhost 不行?

localhost 在每台设备上都指它自己,手机填 localhost 等于让手机访问手机。跨设备访问要填运行模型那台机器的局域网 IP,且端口要和实际监听端口一致。IP 变了之后旧地址就会失效,最好在路由器上给这台机器做地址绑定。

多人同时用需要额外做什么准备?

先算清并发后的显存和响应时间,再决定要不要限制同时在线人数;界面侧建议选带账号和多用户隔离的平台型方案,方便管权限和记录;数据层面把敏感内容单独隔离,不要把内网资料直接丢进这套环境。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。