一、简介
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文件，然后重启
三、使用示例
1. 访问web页面使用
- 搜索使用样例
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联网功能
