跳到主要内容

🖥️ 桌面应用

Libre WebUI 桌面应用将 Web 界面封装在 macOS、Windows 和 Linux 原生窗口中。它连接同一计算机上运行的 Libre WebUI 服务器，或你指定的任意服务器。

应用在独立仓库中开发；每个版本的安装程序附在主仓库的 GitHub 版本中。

📦 下载与安装​

从最新版本下载对应平台的程序包：

  • macOS（Apple Silicon）：Libre-WebUI-Desktop-{version}-mac-arm64.dmg 或 .zip，或运行 brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows：Libre-WebUI-Desktop-Setup-{version}.exe（安装版）或 Libre-WebUI-Desktop-{version}.exe（便携版）
  • Linux：Libre-WebUI-Desktop-{version}.AppImage 或 Libre-WebUI-Desktop-{version}-{arch}.deb

更名前的版本以 Libre-WebUI-Frontend 前缀发布这些文件，应用包名为 Libre WebUI Frontend.app。

macOS 将应用标记为已损坏​

Libre WebUI 暂时为 macOS 构建使用临时签名。该签名能保持应用包结构有效，但无法向 Apple 标识发布者，也不能公证。将应用复制到“应用程序”后，在 系统设置 → 隐私与安全性 → 仍要打开 中批准。

若 macOS 不提供该选项，请先确认应用来自 Libre WebUI 官方版本，再移除隔离属性：

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

不要全局禁用 Gatekeeper。顺畅分发仍需要 Developer ID Application 证书和 Apple 公证。

🔌 连接服务器​

应用是客户端，需要 Libre WebUI 服务器。首次启动时，欢迎页提供两种选择：

  • 本地：应用探测本机服务器（端口 3001，Docker 映像和 npx libre-webui 的默认值），健康检查响应后连接。
  • 远程：输入任意可访问的 Libre WebUI 服务器 URL，例如家庭实验室或团队部署。应用会先验证再连接。

选择会被记住。之后可从菜单栏使用 Libre WebUI → 切换服务器…。若已保存的服务器停止响应，应用会返回欢迎页，而不是显示空白窗口。

运行本地服务器请参阅快速入门：Docker Compose、npx libre-webui 和 Homebrew 均可使用。

🧰 桌面应用中的 Work​

桌面程序包不包含后端、Docker 或 Work 容器运行时。Work 是否可用由所连接的服务器决定：

  • 能运行 docker info 的原生后端可以创建任务专属 Work 容器和命名卷；
  • 仓库标准 Compose 部署通过挂载宿主机 Docker 套接字提供基于 Docker 的 Work；没有可访问运行时的自定义容器部署会报告 Work 不可用；
  • Helm Chart 以 work.enabled=true 安装时，Kubernetes 服务器通过 Pod/PVC 提供 Work；
  • Work 不可用时，应用仍支持 Chat。

Work 文件位于服务器的 Docker 宿主机或 Kubernetes 存储中，而不在桌面应用内。预览通过 Libre WebUI 的同源签名代理传输，因此只要服务器反向代理保留 HTTP 和 WebSocket 流量，本地和远程桌面客户端都能使用。

🎨 桌面集成​

  • 包含应用、编辑、视图、窗口和帮助菜单的原生菜单栏
  • 自定义 macOS 标题栏（hiddenInset），窗口按钮位于侧边栏
  • 深色模式跟随系统偏好
  • 外部链接始终在默认浏览器中打开，而不在应用内打开
  • 渲染器启用上下文隔离，不启用 Node 集成

🚧 限制​

  • macOS 架构：当前 macOS 包仅支持 Apple Silicon（arm64）
  • 需要服务器：应用不包含后端
  • Work 取决于服务器运行时：不包含 Docker 或 Kubernetes 运行时
  • 无自动更新：更新需要下载新程序包

有关运行时、提供商、存储和预览安全性的详情，请参阅 Work：隔离工作区。