====== SearXNG ======
**SearXNG** 是一个开源的元搜索引擎,聚合来自 Google、Bing、Brave、DuckDuckGo、百度、B站 等 **279 个搜索服务**((https://docs.searxng.org/|SearXNG 官方文档)) 的搜索结果,去重后统一展示。项目在 GitHub 上有 **33.5K 星标**((https://github.com/searxng/searxng|SearXNG GitHub)),Docker 镜像下载超 **5000 万次**((https://hub.docker.com/r/searxng/searxng|Docker Hub)),是社区最活跃的元搜索引擎之一。
===== Docker Compose 配置 =====
name: searxng
services:
core:
container_name: searxng
image: docker.io/searxng/searxng:latest
restart: unless-stopped
ports:
- "127.0.0.1:8080:8080"
environment:
- UWSGI_WORKERS=1
volumes:
- ./config:/etc/searxng:rw
- ./data:/var/cache/searxng:rw
mcp:
container_name: searxng-mcp
image: knucklessg1/searxng-mcp:latest
restart: unless-stopped
depends_on:
- core
ports:
- "127.0.0.1:4445:8000"
environment:
- SEARXNG_URL=http://core:8080
command: searxng-mcp -t streamable-http -H 0.0.0.0 -p 8000
配置要点:
* 所有端口绑定 **127.0.0.1**,仅限本地访问
* %%UWSGI_WORKERS=1%% 降低内存占用
* MCP 环境变量用 %%SEARXNG_URL%% 而非 %%SEARXNG_BASE_URL%%
* 无需 Redis/Valkey
===== 初始化 =====
**1. 创建配置目录**
mkdir -p searxng/config searxng/data
**2. 启用 JSON API**
SearXNG 默认只返回 HTML,需要在 %%config/settings.yml%% 中启用 JSON 格式((https://docs.searxng.org/admin/settings/settings.yml.html#search|设置文档)):
use_default_settings: true
search:
formats:
- html
- json
server:
secret_key: "<生成随机密钥>"
image_proxy: true
**3. 启动并测试**
docker compose up -d
curl 'http://localhost:8080/search?q=树莓派&format=json'
===== MCP 客户端接入 =====
MCP 桥接容器 knucklessg1/searxng-mcp((https://pypi.org/project/searxng-mcp/|PyPI)) 将 SearXNG 的 JSON API 转换为 MCP 协议,供 LLM 客户端调用。
SSH 隧道转发(端口绑定 127.0.0.1):
ssh -L 4445:127.0.0.1:4445 -f -N root@
客户端 MCP 配置:
{
"searxng": {
"url": "http://localhost:4445/",
"timeout": 120
}
}
===== 硬件占用 =====
^ 容器 ^ 内存 ^ CPU ^
| searxng (core) | ~127MB | <0.1% 空闲,<1% 搜索时 |
| searxng-mcp | ~40MB | <0.1% |
| 总计 | **~167MB** | |
一次搜索在 7 个引擎同时查询,耗时约 1-2 秒。
===== 内置引擎 =====
SearXNG 自带 279 个内置引擎((https://docs.searxng.org/admin/engines/configured_engines.html|引擎列表)),包括:
* **通用搜索**:Google、Bing、Brave、DuckDuckGo、百度、搜狗、360
* **学术搜索**:Google Scholar、arXiv、PubMed、Semantic Scholar、Crossref
* **视频**:YouTube、Bilibili、Niconico、Vimeo、Dailymotion
* **图片**:Google Images、Bing Images、Pixabay、Unsplash、Flickr
* **社交**:Reddit、Hacker News、Mastodon、Lemmy
* **开发**:GitHub、GitLab、PyPI、npm、Docker Hub、Stack Exchange
* **百科**:Wikipedia、Wikidata、百度百科
===== 安全 =====
* 所有端口绑定 127.0.0.1,不对外暴露
* %%settings.yml%% 中需设置 %%secret_key%%
* 可通过 Tor 匿名化搜索请求((https://docs.searxng.org/|官方文档))
* Valkey(Redis)非必需,可不部署