3.7 KiB
3.7 KiB
SearXNG 联网搜索（Web Search）
微语提供独立的联网搜索 compose 文件 compose/compose-searxng.yaml（一镜像一文件），包含 SearXNG（开源元搜索引擎，聚合 Google/Bing/DuckDuckGo 等结果），通过关键字 searxng 按需启动，自动接入 bytedesk-network。
企业版高级功能：应用侧联网搜索代码位于
enterprise/ai模块（com.bytedesk.ai.searxng包），仅企业版/平台版可用，社区版发布镜像中不包含此功能。
- 官方文档：https://docs.searxng.org/admin/installation-docker.html
- 镜像：https://hub.docker.com/r/searxng/searxng
启动 SearXNG
start.sh / stop.sh 支持关键字 searxng（别名 search），用于启停 compose/compose-searxng.yaml：
cd deploy/docker
# 方式 A（推荐）：在启动中间件/应用栈时附带 SearXNG
./start.sh middleware searxng
./start.sh all obs searxng # # 线上全量 + 观测栈 + 联网搜索
./stop.sh stop middleware searxng
./stop.sh down middleware searxng
# 方式 B：仅 SearXNG（需先确保 bytedesk-network 存在；在 deploy/docker 目录执行）
docker compose --env-file .env -f compose/compose-searxng.yaml up -d
# 方式 C：与现有 compose 组合
docker compose --env-file .env -f compose/compose-searxng.yaml up -d
访问地址
| 服务 | 地址 | 说明 |
|---|---|---|
| SearXNG 搜索页面 | http://127.0.0.1:18888 | 浏览器可直接使用 |
| SearXNG JSON API | http://127.0.0.1:18888/search?q=bytedesk&format=json | 供应用调用 |
| SearXNG 健康检查 | http://127.0.0.1:18888/healthz | 容器 healthcheck 同款 |
启用应用侧联网搜索
SearXNG 启动后，还需在应用侧打开开关（默认关闭，不影响正常启动）：
# .env 中配置（docker 全量启动时生效，容器内通过容器名访问）
BYTEDESK_AI_SEARXNG_ENABLED=true
BYTEDESK_AI_SEARXNG_BASE_URL=http://searxng-bytedesk:8080
# 或源码本地运行时，在 properties 中配置（宿主机端口）
# bytedesk.ai.searxng.enabled=true
# bytedesk.ai.searxng.base-url=http://127.0.0.1:18888
测试接口（bytedesk.debug=true 时可用）
# 1. 服务状态与连通性检查
curl http://127.0.0.1:9003/spring/ai/api/v1/searxng/status
# 2. 联网搜索（返回原始结果）
curl "http://127.0.0.1:9003/spring/ai/api/v1/searxng/search?query=bytedesk&maxResults=5"
# 3. 联网搜索 + 大模型总结回答
curl -X POST http://127.0.0.1:9003/spring/ai/api/v1/searxng/chat \
-H 'Content-Type: application/json' \
-d '{"message": "微语bytedesk是什么", "query": "bytedesk 微语", "maxResults": 5}'
说明
- 自定义配置位于
compose/searxng/settings.yml（已开启 JSON 输出格式并关闭 limiter，否则 JSON API 会返回 403）。 - 实例密钥通过
.env中的SEARXNG_SECRET注入，生产环境务必修改。 - 应用侧相关参数：
bytedesk.ai.searxng.enabled（开关）、base-url、timeout-ms、max-results、language、categories、safe-search。 - 部分搜索引擎在国内网络可能不可用，可在
searxng/settings.yml中调整 engines。