跳到主要内容

浏览器搜索引擎集成

注意

本教程由社区贡献，不受 Open WebUI 团队支持。它仅作为如何针对特定用例自定义 Open WebUI 的演示。想要做出贡献？请查看贡献教程。

Open WebUI 允许您直接将其集成到您的 Web 浏览器中。本教程将引导您完成将 Open WebUI 设置为自定义搜索引擎的过程，以便您可以轻松地从浏览器的地址栏中执行查询。

Setting Up Open WebUI as a Search Engine​

Prerequisites​

在开始之前，请确保：

  • 您已安装 Chrome 或其他支持的浏览器。
  • WEBUI_URL 环境变量已正确设置（可以使用 Docker 环境变量或如 快速入门 (Getting Started) 指南中所述在 .env 文件中设置）。

Step 1: Set the WEBUI_URL Environment Variable​

设置 WEBUI_URL 环境变量可确保您的浏览器知道将查询重定向到何处。

Using Docker Environment Variables​

如果您使用 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>

Step 2: Add Open WebUI as a Custom Search Engine​

For Chrome​

  1. 打开 Chrome 浏览器并导航至 设置。

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

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

  4. 如下填写详细信息：

    • 搜索引擎 (Search engine)：Open WebUI Search

    • 快捷字 (Keyword)：webui（或您喜欢的任何其他关键字）

    • 网址以 %s 代替查询 (URL with %s in place of query)：

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

  5. 点击 添加 以保存配置。

For Firefox​

  1. 在 Firefox 浏览器中访问 Open WebUI。
  2. 点击地址栏将其展开。
  3. 点击展开后的地址栏底部带绿色圆圈的加号图标。这会将 Open WebUI 搜索添加到您首选项的搜索引擎中。

或者：

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

Optional: Using Specific Models​

如果您希望在搜索时使用特定模型，请修改 URL 格式以包含模型 ID：

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

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

Example Usage​

一旦设置好搜索引擎，您就可以直接从地址栏执行搜索。只需输入您选择的关键字，然后输入您的查询内容即可：

webui 您的搜索查询内容

此命令将把您重定向到包含您搜索结果的 Open WebUI 界面。

Troubleshooting​

如果您遇到任何问题，请检查以下内容：

  • 确保 WEBUI_URL 已正确配置并指向一个有效的 Open WebUI 实例。
  • 仔细检查浏览器设置中输入的搜索引擎 URL 格式是否正确。
  • 确认您的互联网连接正常，且 Open WebUI 服务运行顺畅。
This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.