Misc. bug:

用户在使用 llama-server 启动模型服务后,通过浏览器访问内置的 WebUI(PWA)界面时,界面完全损坏(fully broken),无法正常显示和操作。该问题在浏览器端复现(Firefox 和 Chromium 均受影响),且与 llama-server 版本有关。

Misc. bug:

Misc. bug:

快速结论:该报错通常发生在 llama-server 内置 PWA(渐进式 Web 应用)界面完全无法正常渲染时,表现为页面布局错乱、空白或样式问题。优先排查最近的 commit 是否引入了静态资源加载或路由变化,并尝试回退到旧版本(如 b9704)确认。

问题场景

用户在使用 llama-server 启动模型服务后,通过浏览器访问内置的 WebUI(PWA)界面时,界面完全损坏(fully broken),无法正常显示和操作。该问题在浏览器端复现(Firefox 和 Chromium 均受影响),且与 llama-server 版本有关。

报错原文

GUI(PWA) is fully broken, here is a photo

The built-in Web UI is broken for me as well. Reproduced in both Firefox and Chromium.

原因分析

可能原因:在最近 3 天的 commit 中(从 b9704 到 b9724),某次提交修改了内置 WebUI 的静态资源(如 HTML、CSS、JavaScript 文件)的路由或打包方式,导致浏览器无法正确加载或解析页面资源。该问题与模型文件、服务器参数(-c-ngl 等)无关,仅与 llama-server 的 WebUI 前端代码变更有关。

环境排查

  • llama-server 版本:确认当前版本号(如 b9724,commit e2e7a9b2d04e0404131e551243d4bd399ccfe606)
  • 浏览器类型:Firefox、Chromium 或其他 Blink 内核浏览器
  • 操作系统:Linux(Arch Linux 或其他发行版)

解决步骤

  1. 回退版本:将 llama-server 从 b9724 降级至 b9704(即提交 3 天前的版本),并重新测试 WebUI。
  2. 确认回退后问题消失:使用相同命令行参数(如上文中的 -m-c-ngl 等)启动旧版本 llama-server,验证 WebUI 是否正常加载。
  3. 检查更新上游修复:追踪 Issue #24879(已提交修复 PR),拉取包含修正的最新代码,或等待下一个发布版本。
  4. 临时替代方案:如果无法升级,可在旧版本中使用;或尝试通过 REST API 直接调用(如使用 curl 或其他客户端)绕过 WebUI。

验证方法

启动 llama-server 后,在浏览器中访问 http://localhost:8080(或指定端口),查看页面是否正常渲染。如果页面显示正常、布局完整、交互可用,则问题已解决。

参考来源

ggml-org/llama.cpp #24808

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

celebrityanime
celebrityanime
文章: 13156

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注