跳到主要内容
警告

本教程由社区贡献，不获得 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 搜索

    • 关键词：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 服务运行顺畅。