跳到主要内容
注意

本教程由社区贡献，未得到 Open WebUI 团队的支持。它仅作为一个如何定制 Open WebUI 以满足特定使用场景的示例。想要贡献？查看贡献教程。

浏览器搜索引擎集成

Open WebUI 允许直接集成到您的网页浏览器中。本教程将指导您将 Open WebUI 设置为自定义搜索引擎，从而能够轻松地通过浏览器地址栏执行查询。

将 Open WebUI 设置为搜索引擎​

前置要求​

开始之前，请确保：

  • 您已安装 Chrome 或其他支持的浏览器。
  • WEBUI_URL 环境变量配置正确，可以通过 Docker 环境变量设置或按照入门指南中的说明在 .env 文件中配置。

步骤 1：设置 WEBUI_URL 环境变量​

设置 WEBUI_URL 环境变量可以确保您的浏览器知道查询的目标地址。

使用 Docker 环境变量​

如果您通过 Docker 运行 Open WebUI，可以在 docker run 命令中设置环境变量：

docker run -d \
  -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  -e WEBUI_URL="https://<your-open-webui-url>" \
  ghcr.io/open-webui/open-webui:main

或者，您可以将该变量添加到 .env 文件中：

WEBUI_URL=https://<your-open-webui-url>

步骤 2：将 Open WebUI 添加为自定义搜索引擎​

针对 Chrome​

  1. 打开 Chrome 并进入 设置。

  2. 从侧边栏选择 搜索引擎，然后点击 管理搜索引擎。

  3. 点击 添加 创建一个新搜索引擎。

  4. 填写以下详细信息：

    • 搜索引擎：Open WebUI Search

    • 关键词：webui（或者任何您喜欢的关键词）

    • 包含 %s 作为查询占位的 URL：

      https://<your-open-webui-url>/?q=%s

  5. 点击 添加 保存配置。

针对 Firefox​

  1. 在 Firefox 中打开 Open WebUI。
  2. 点击地址栏以展开。
  3. 点击展开地址栏底部绿色圆圈内的加号图标。这会将 Open WebUI 的搜索添加到您的搜索引擎首选项中。

或者：

  1. 在 Firefox 中打开 Open WebUI。
  2. 右键单击地址栏。
  3. 从上下文菜单中选择“添加 Open WebUI”（或类似选项）。

可选：使用特定模型​

如果希望使用特定模型进行搜索，可以修改 URL 格式以包含模型 ID：

https://<your-open-webui-url>/?models=<model_id>&q=%s

注意： 模型 ID 需要进行 URL 编码。特殊字符如空格或斜杠需要编码（例如，my model 转换为 my%20model）。

示例用法​

设置完成后，您可以直接从地址栏进行搜索。只需输入您选择的关键词，然后输入查询内容：

webui your search query

该命令会将您重定向到带有查询结果的 Open WebUI 界面。

故障排除​

如果遇到任何问题，请检查以下事项：

  • 确保 WEBUI_URL 配置正确，并指向有效的 Open WebUI 实例。
  • 仔细检查您浏览器设置中搜索引擎的 URL 格式是否正确输入。
  • 确认您的互联网连接正常，并且 Open WebUI 服务正在平稳运行。