跳到主要内容

快速开始

要求​

要求最低配置推荐配置
Node.js22.22+最新 LTS
RAM8 GB16 GB+
磁盘5 GB模型需要 20 GB+
GPU可选8 GB+ VRAM，可实现快速本地推理
Docker可选Work 任务必需

Libre WebUI 可以仅通过 CPU 运行 Ollama，但较小的模型更适合 CPU。云提供商插件只需要相应的 API 密钥。

聊天、文档、制品和提供商支持的功能不需要 Docker。Work 则需要：运行 Libre WebUI 后端的机器必须安装 Docker， 并允许后端进程调用它。npx libre-webui 不会安装 Docker。如果 Docker 不可用，Libre WebUI 的其余部分仍会运行， 而 Work 显示运行时不可用；系统绝不会改为直接在主机上执行模型命令。

启动 Libre WebUI​

npx libre-webui@latest

打开 http://localhost:8080。创建的第一个账户将成为管理员。除非明确设置 ENABLE_SIGNUP=true，否则后续公开注册保持关闭。

打包启动器将持久状态保存在 ~/.libre-webui。可通过绝对路径 DATA_DIR 选择其他位置；相对值从运行 npx 的目录解析。

安装 Ollama​

安装 Ollama，然后拉取一个小型通用模型：

ollama pull gemma4:12b

其他优秀选择包括 gemma4:26b（MoE）、gemma4:31b（dense）和 qwen3.8:27b。可在模型管理器中查看已安装模型、实时搜索 Ollama 库并直接拉取模型。

文档 Embedding

要使用文档语义搜索，还应安装 Embedding 模型：

ollama pull nomic-embed-text

添加云提供商​

云提供商是可选的。在设置 → API 密钥中按用户添加密钥，或在 backend/.env 中为整个服务器添加密钥 （之后重启后端），再在设置中启用提供商：

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...

应用会在提供商支持时刷新模型列表，无需打开文档来查找最新模型名称。

启动第一个 Work 任务​

Work 为每项任务提供持久对话和独立的容器文件系统，仅向已认证管理员开放。

  1. 在后端主机上安装并启动 Docker。
  2. 通过侧边栏标题中的 Work、标签栏 + 菜单、主页或 Cmd/Ctrl + Shift + U 创建任务。
  3. 选择支持工具调用的模型。
  4. 描述要创建或修改的内容，然后选择运行。
  5. 在文件、活动、Git、终端和预览中查看结果。

任务会保留在侧边栏，方便以后返回同一对话和文件。停止运行或预览会保留工作区；删除任务会永久删除工作区。

Work 可使用已安装的 Ollama 模型、Ollama Cloud 模型或已配置的聊天/补全插件。选择远程提供商时，Libre WebUI 会提前说明：提供商将收到对话、工具定义和模型请求的工具结果。自主运行可能发起多次付费调用。

有关运行时、持久性、网络、预览和安全边界，请参阅 Work：隔离工作区。

Docker​

git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d

在浏览器中创建第一个管理员；无需注册标志或重启，后续公开注册默认关闭。

如果 Ollama 已在主机或其他机器上运行：

docker compose -f docker-compose.external-ollama.yml up -d

使用仓库提供的 GPU Compose 文件启用 NVIDIA 加速。

仓库 Compose 文件挂载主机 Docker Socket，因此安装 Docker 后即可使用 Work。这会授予应用等同 root 的主机控制权， 请先阅读 Work：隔离工作区。Linux 上应在 .env 中将 DOCKER_GID 设为 Socket 所属组。不需要 Work 时移除挂载。

内置 Ollama 也只在内部可用。仅当其他主机进程需要其 API 时添加 -f docker-compose.ollama-host.yml；覆盖配置默认绑定 Loopback。

熟悉界面​

主页包含开始（新聊天、隐身聊天、新 Work 任务）、继续（最近对话和任务）和探索（笔记、日历、自动化、 模型、Persona、Imagine）。侧边栏和命令面板（Cmd/Ctrl + K）提供相同入口，并可模糊搜索聊天、Work 任务、应用操作， 以及全文搜索消息、笔记和文档。

  • 日历 — 每用户日历和重复事件。
  • 自动化 — 以聊天会话交付的计划 AI 运行。

键盘快捷键​

快捷键操作
Cmd/Ctrl + K命令面板
Cmd/Ctrl + Shift + O新建聊天
Cmd/Ctrl + Shift + U新建 Work 任务
Cmd/Ctrl + B切换侧边栏
Cmd/Ctrl + ,设置
Cmd/Ctrl + D切换主题
?打开快捷键设置
Esc关闭设置
Enter发送消息
Shift + Enter换行

后续步骤​