Misc. bug: Homebrew’s llama.cpp 0.5.0 has no web UI

这个报错通常出现在 macOS 上通过 Homebrew 安装 llama.cpp 并运行 llama serve 或 llama-server 的场景:浏览器访问根路径 / 返回 404,因为该构建没有打包 Web UI。优先确认 Homebrew 安装的 llama.cpp 版本,并升级到已修复

快速结论:这个报错通常出现在 macOS 上通过 Homebrew 安装 llama.cpp 并运行 llama serve 或 llama-server 的场景:浏览器访问根路径 / 返回 404,因为该构建没有打包 Web UI。优先确认 Homebrew 安装的 llama.cpp 版本,并升级到已修复的版本。

适用环境:macOS;受影响模块为 llama-server;已确认触发问题的版本为 Homebrew llama.cpp 0.5.0;0.4.1 版本正常;0.6.0 版本已验证不再出现该问题。

最快修复方案:升级 Homebrew 的 llama.cpp 到 0.6.0 或更高版本,然后重新运行服务。

注意事项:该问题本身是构建产物缺 Web UI,并非用户配置错误。若仍停留在 0.5.0,仅改启动参数或端口通常无效。

问题场景

用户在 macOS 上通过 Homebrew 安装 llama.cpp 0.5.0,并运行 llama serve / llama-server。服务进程可以启动,但访问根路径 / 时无法加载 Web UI,而是返回 File Not Found 404。同一台机器上此前的 0.4.1 构建带有 Web UI,因此表现为升级后 UI 消失。

报错原文

Misc. bug: Homebrew's llama.cpp 0.5.0 has no web UI

llama serve answers / with a File Not Found 404

The Homebrew build of llama.cpp 0.5.0 ships without the web UI.

原因分析

最可能的原因是 Homebrew 的构建方式发生变化:Homebrew 现在在没有网络访问的环境中构建(Homebrew/homebrew-core#311973),导致构建过程无法下载 Web UI 所需资源。构建只打印警告后继续完成,最终产出的 0.5.0 包因此不包含 Web UI。Issue 中还提到,这可能是部分 Llama app 用户遇到的相关问题。

环境排查

  • 确认操作系统:macOS。
  • 确认 llama.cpp 来源:Homebrew。
  • 确认 Homebrew llama.cpp 版本:0.5.0 会复现;0.4.1 正常;0.6.0 已修复。
  • 确认受影响模块:llama-server。
  • 确认访问路径:访问 / 是否返回 File Not Found 404。
  • 如需确认修复后的构建信息,可在升级后检查版本输出,例如 0.6.0 显示为 build 11429、commit d81235049。

解决步骤

  1. 先检查当前 Homebrew 安装的 llama.cpp 版本,确认是否仍为 0.5.0。
  2. 通过 Homebrew 升级 llama.cpp 到 0.6.0 或更高版本。
  3. 升级完成后重新启动 llama serve 或 llama-server,避免旧进程继续占用端口。
  4. 在浏览器重新访问服务根路径 /,确认 Web UI 能正常加载。
  5. 如果仍返回 404,确认实际运行的可执行文件是否来自 Homebrew 新版本,而不是旧路径或旧进程残留。

验证方法

升级后再次运行 Homebrew 安装的 llama.cpp,并确认版本为 0.6.0 或更高;启动服务后访问根路径 /,若可正常显示 Web UI 而不再返回 File Not Found 404,即表示问题已解决。Issue 评论中已有人通过 brew install llama.cpp 进行全新安装,验证 0.6.0 不再出现该问题。

参考来源

ggml-org/llama.cpp #29849

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 28308

发表回复

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