
一、简介
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
- 修改searxng/settings.yml如下:
三、使用示例
1. 访问web页面使用
- 访问:http://127.0.0.1:8080,页面如下

- 搜索使用样例

2. API接口调用
- 提供请求接口:
GEThttp://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=weekcategories否 指定搜索类别,默认 general,可选值:general(通用)、images(图片)、videos(视频)、news(新闻)pageno否 搜索结果页码,默认 1safesearch否 安全级别过滤,可选值: 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联网功能




