警告

本教程由社区贡献，不受 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

打开 Chrome 并导航至设置。
从侧边栏选择 搜索引擎，然后点击 管理搜索引擎。
点击添加创建一个新的搜索引擎。
按如下方式填写详细信息
- 搜索引擎：Open WebUI Search
- 关键词：webui（或您喜欢的任何关键词）
- URL 中使用 %s 替代查询内容:
```
https://<your-open-webui-url>/?q=%s
```
点击添加保存配置。

对于 Firefox

在 Firefox 中访问 Open WebUI。
点击地址栏展开它。
点击展开的地址栏底部的绿色圆圈中的加号图标。这会将 Open WebUI 的搜索添加到您的偏好设置中的搜索引擎列表。

或者

在 Firefox 中访问 Open WebUI。
右键点击地址栏。
从上下文菜单中选择“添加 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 服务运行顺畅。

将 Open WebUI 设置为搜索引擎​

前提条件​

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

使用 Docker 环境变量​

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

对于 Chrome​

对于 Firefox​

可选：使用特定模型​

使用示例​

故障排除​