SearXNG 本地部署与配置

CherryStudio 支持通过 SearXNG 进行网络搜索，SearXNG 是一个可本地部署的开源项目，所以与其他需要 API 提供商的配置方式略有不同。

SearXNG 项目链接：SearXNG

SearXNG 的优势：

• 开源免费，无需 API

• 隐私性相对较高

• 可高度定制化

本地部署

SearXNG 的部署方式既可以通过服务器部署也可以进行本地部署，为方便使用，本文档以最简单快捷的本地部署为例以满足最低使用门槛需求。

一、Docker 直接部署

由于 SearXNG 不需要复杂的环境配置，可以不用 docker compose，只需要简单提供一个空闲端口即可部署，所以最快捷的方式可以使用 Docker 直接拉取镜像进行部署。

1. 下载安装并配置 docker

安装后选择一个镜像存储路径：

2. 搜索并拉取 SearXNG 镜像

搜索栏输入 searxng ：

拉取镜像：

3. 运行镜像

拉取成功后来到 images 页面：

选择拉取的镜像点击运行：

打开设置项进行配置：

以 8085 端口为例：

运行成功后点击链接即可打开 SearXNG 的前端界面：

出现这个页面说明部署成功：

Cherry Studio 相关配置

SearXNG 本地部署成功，接下来是 CherryStudio 的相关配置。

来到网络搜索设置页面，选择 Searxng ：

直接输入本地部署的链接发现验证失败，此时不用担心：

因为直接部署后默认并没有配置 json 返回类型，所以无法获取数据，需要修改配置文件。

回到 Docker，来到 Files 标签页找到镜像中找到带标签的文件夹：

展开后继续往下翻，会发现另一个带标签的文件夹：

继续展开，找到 settings.yml 配置文件：

点击打开文件编辑器：

找到 78 行，可以看到类型只有一个 html

添加 json 类型后保存，重新运行镜像

重新回到 Cherry Studio 进行验证，验证成功：

地址既可以填写本地： http://localhost : 端口号 也可以填写 docker 地址：http://host.docker.internal : 端口号

其他配置

此时 SearXNG 已具备默认联网搜索能力，如需定制搜索引擎需要自行进行配置

需要注意的是此处首选项并不能影响大模型调用时的配置

如需配置需要大模型调用的搜索引擎，需在配置文件中设置：

配置语言参考：

若内容太长直接修改不方便，可将其复制到本地 IDE 中，修改后粘贴到配置文件中即可。

验证失败常见原因

返回格式未添加 json 格式

在配置文件中将返回格式加上 json：

未正确配置搜索引擎

Cherry Studio 会默认选取 categories 同时包含 web general 的引擎进行搜索，默认情况下会选中 google 等引擎，由于大陆无法直接访问 google 等网站导致失败。增加以下配置使得 searxng 强制使用 baidu 引擎，即可解决问题：

use_default_settings:
  engines:
    keep_only:
      - baidu
engines:
  - name: baidu
    engine: baidu 
    categories: 
      - web
      - general
    disabled: false

访问速率过快

searxng 的 limiter 配置阻碍了 API 访问，请尝试将其在设置中设为 false：