Skip to main content
warning

这篇教程是社区贡献的，不属于 Open WebUI 官方团队的支持范围。它仅作为如何针对您的特定用例自定义 Open WebUI 的演示。想要贡献？请查看贡献教程。

浏览器搜索引擎集成

Open WebUI 允许您直接集成到 Web 浏览器中。本教程将指导您如何将 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
note

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

使用示例​

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

webui your search query

此命令将引导您进入 Open WebUI 界面并显示您的搜索结果。

故障排除​

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

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