「Mac畅玩AIGC与多模态30」部署篇04 - 在本地部署 SearxNG 搜索引擎

本篇介绍如何在 macOS 系统中本地部署 SearxNG 搜索引擎服务，为后续在 Dify 工作流中集成自主搜索能力奠定基础。SearxNG 是一个开源、可自托管的元搜索引擎，支持聚合 Google、Bing、DuckDuckGo、Wikipedia、GitHub 等多种搜索源，具备隐私保护、接口统一、可定制性强等特点。

二、环境准备

部署前需准备以下环境与工具：

macOS 系统（支持 Intel 和 Apple Silicon 芯片）
已安装 Docker 与 Docker Compose
推荐使用终端工具：iTerm2 或 macOS 自带终端

可通过以下命令验证安装是否成功：

docker --version
docker compose version

三、配置服务并启动容器

1. 创建项目目录

mkdir ~/searxng && cd ~/searxng

2. 创建配置文件 settings.yml

use_default_settings: true
general:
  debug: true
search:
  formats:
    - html
    - json
engines:
  - name: baidu
    baidu_category: general
    categories: [general]
    engine: baidu
    shortcut: bd
    disabled: false
  - name: bing
    disabled: false
  - name: bilibili
    engine: bilibili
    shortcut: bil
    disabled: false
  - name: duckduckgo
    engine: duckduckgo
    disabled: true
  - name: github
    engine: github
    shortcut: gh
    disabled: true
  - name: wikipedia
    engine: wikipedia
    disabled: true
ui:
  static_use_hash: true

保存路径为：~/searxng/settings.yml

3. 创建 docker-compose.yml 文件

version: '3.7'
services:
  searxng:
    image: searxng/searxng:latest
    container_name: searxng
    ports:
      - "8090:8080"
    volumes:
      - ./settings.yml:/etc/searxng/settings.yml
    environment:
      - BASE_URL=http://localhost:8090
    restart: unless-stopped

4. 启动服务

docker compose up -d

5. 验证运行状态

在浏览器中访问：

http://localhost:8090

如正常显示搜索界面，则部署成功。

四、接口测试（支持 JSON 输出）

使用浏览器测试 JSON 接口

http://localhost:8090/search?q=HarmonyOS&format=json

使用 curl 命令测试

curl "http://localhost:8090/search?q=HarmonyOS&format=json"

返回结果应为包含搜索结果的 JSON 数据结构，便于作为第三方插件集成。

五、说明与补充

启用 JSON 格式支持需在 settings.yml 中添加：

search:
  formats:
    - html
    - json

若需支持国内搜索引擎，请手动启用如 baidu、bilibili 等插件
可自定义禁用部分默认国外引擎以提升国内响应速度
无需 API Key，接口直接可调用
远程部署时需开放端口或配置反向代理服务
推荐使用 Chrome、Edge 浏览器访问界面，避免 Safari 缓存问题

六、处理初始设置提示

首次部署后访问 SearxNG 页面时，如出现提示“Invalid settings, please edit your preferences”，可按以下方式完成初始化：

点击页面右上角齿轮图标（⚙️）进入 Preferences 设置界面。
不做任何修改，直接滚动至页面底部，点击「Save」按钮。
返回首页，提示将自动消除。

该操作将保存一份默认本地配置，无需修改 settings.yml 文件或重启容器。

本篇完整介绍了如何在 macOS 环境下部署支持 JSON 格式输出的 SearxNG 搜索引擎服务，具备可供 Dify 等系统集成的能力，为构建自主检索工具提供基础。

文章来源于互联网:「Mac畅玩AIGC与多模态30」部署篇04 – 在本地部署 SearxNG 搜索引擎

相关推荐: 手把手教你学Simulink——基于经典PID控制的并网逆变器场景实例：单相并网逆变器的PI电流控制仿真

目录手把手教你学Simulink 一、背景介绍二、系统结构设计三、建模与仿真流程详解第一步：创建 Simulink 项目并导入基础模块第二步：设置直流电源参数配置示例第三步：构建单相全桥逆变器参数配置示例第四步：添加LC滤波器参数配置示例 …