使用searxng打造私有聚合搜索引擎：免费、高效、支持API调用

luler · 3 天前

一、简介

searxng 是一个免费的互联网搜索引擎，它具有以下特点：

汇总了来自超过 70 个搜索服务的结果
保护用户隐私且不追踪用户行为
支持docker一键部署
支持web页面访问、API接口调用
免费开源，开源地址：https://github.com/searxng/searxng

二、安装

新建docker-compose.yml文件，配置内容如下：

version: '3'
services:
  searxng:
    image: searxng/searxng:latest
    ports:
      - 8080:8080
    volumes:
      - ./searxng:/etc/searxng:rw
    restart: always

一键启动

docker-compose up -d

注意，要searxng接口支持json格式，需要调整启动后自动生成searxng/settings.yml文件，然后重启

修改searxng/settings.yml如下：

重新启动即可生效

docker-compose restart

三、使用示例

1. 访问web页面使用

访问：http://127.0.0.1:8080，页面如下

搜索使用样例

2. API接口调用

提供请求接口：GET http://127.0.0.1:8080/search

参数简介：

参数名称	是否必填	说明
`q`	是	查询内容，例如：`AI领域最新进展`
`format`	否	返回格式，默认 `html`，支持：`html`、`json`、`csv`、`rss`。注意searxng/settings.yml文件中默认配置仅支持html，需要修改重启服务，如上。
`engines`	否	指定搜索引擎，默认综合搜索，常用值：`google`、`bing`、`duckduckgo`、`qwant`、`yahoo`。更多引擎参考：SearXNG 引擎文档
`time_range`	否	按时间范围过滤结果，可选值：`day`（一天）、`week`（一周）、`month`（一个月）。示例：`time_range=week`
`categories`	否	指定搜索类别，默认 `general`，可选值：`general`（通用）、`images`（图片）、`videos`（视频）、`news`（新闻）
`pageno`	否	搜索结果页码，默认 `1`
`safesearch`	否	安全级别过滤，可选值：`0`（不过滤）、`1`（适度过滤）、`2`（严格过滤）
`language`	否	设置搜索结果语言，使用语言代码，例如：`en`（英语）、`zh`（中文）
...	...	...

请求示例
postman请求示例：

参数结构：

{
    "query": "AI领域最新进展",
    "number_of_results": 3320000,  //搜索到的结果数量
    "results": [ //返回结果集合，多个
        {
            "url": "https://www.aibase.com/zh/daily", //网页链接地址
            "title": "AI日报 - 每天三分钟关注AI行业趋势_AIbase", //标题
            "content": "AI日报为您提供最新的人工智能行业资讯，每天仅需三分钟，全面掌握AI技术发展、行业动态和市场趋势。 关注AI日报，紧跟未来科技步伐，获取独家分析与深度解读。", //内容
            "engine": "bing",
            "template": "default.html",
            "parsed_url": [
                "https",
                "www.aibase.com",
                "/zh/daily",
                "",
                "",
                ""
            ],
            "engines": [
                "bing"
            ],
            "positions": [
                1
            ],
            "score": 1.0,
            "category": "general"
        }
        
        //..... 此处省略多个结果 .....
    ],
    "answers": [],
    "corrections": [],
    "infoboxes": [],
    "suggestions": [],
    "unresponsive_engines": [ //有些引擎国内无法访问，有必要可以走代理解决
        [
            "duckduckgo",
            "Suspended: timeout"
        ]
    ]
}

四、总结

部署简便：通过docker一键部署，配置简单，易于上手
功能完善：聚合多种搜索引擎，搜索功能强大且灵活，支持页面访问和API调用
应用场景：当做自己的私人搜索助手，或者集成到AI应用中，增加AI联网功能