Vane 接入自建 SearXNG让 AI 搜索答案带来源3 步完成外部实例对接【免费下载链接】VaneVane is an AI-powered answering engine.项目地址: https://gitcode.com/GitHub_Trending/pe/VaneVane 是一个跑在你自己硬件上的 AI 问答引擎网络搜索底层依赖 SearXNG。按本文操作你会把一个外部 SearXNG 实例指向 Vane部署、填 URL、验证完成后提问即可获得带来源引用的检索结果。你要解决什么问题默认安装时 Vane 内置一套 SearXNG实例与问答程序绑在一起搜索行为不可单独控制。当你已有自建 SearXNG、或想自己挑引擎、调分类、控流量时内置实例就不够用了。把它指向外部实例后搜索流量全部走你自己的机器来源覆盖、速率、隐私策略都由你决定Vane 侧只需要填一个 URL。动手前核对先确认下面几项都满足能省掉大部分排错时间。核对项怎么确认没准备好怎么办SearXNG 实例可被 Vane 网络访问在 Vane 所在机器上执行curl http://实例地址:端口/search?qtestformatjson能返回 JSON检查防火墙、端口映射容器内访问宿主机注意用宿主机内网 IP已启用 JSON 输出格式打开实例的settings.yml确认search.formats列表里有json加上后重启实例仓库里 searxng/settings.yml 就是启好的例子选定的引擎可用同一台机器curl该接口看results里是否有条目打开 searxng/settings.yml 的engines部分确认目标引擎未被禁用至少配置一个可用的聊天与嵌入模型启动后完成 Vane 的设置向导在设置向导里填入本地 Ollama 或云端服务的模型部署与接通这一节只做两件事拉起 Vane把 URL 填进去。执行部署。已有 SearXNG 时直接用 slim 镜像SEARXNG_API_URL指向你的实例一行命令拉起docker run -d -p 3000:3000 \ -e SEARXNG_API_URLhttp://your-searxng:8080 \ -v vane-data:/home/vane/data --name vane \ itzcrazykns1337/vane:slim-latest没有现成实例的话把仓库自带的配置起一个也行cd searxng docker-compose up -d该目录的 searxng/settings.yml 已启用 JSON 格式可直接复用。填入实例地址。URL 有两个生效入口任选其一环境变量SEARXNG_API_URL上面的命令已用或打开 http://localhost:3000 的设置页在 Search 一栏的 SearXNG URL 字段里填入地址。该字段对应配置键search.searxngURL读取逻辑见 src/lib/config/serverRegistry.ts 的getSearxngURL保存后写进data/config.json无需重启容器。确认请求格式无误。Vane 实际发出的请求固定为{实例地址}/search?formatjson其余参数以查询串追加实现在 src/lib/searxng.ts。所以你的实例只要这个路径能返回 JSON 即可不需要额外网关。验证是否生效两条命令由远及近各验一层。直接验 SearXNGcurl http://your-searxng:8080/search?qvaneformatjson预期返回 JSON 对象包含非空的results数组每项有title、url、content和suggestions数组返回403或空对象说明格式未开启。再验 Vane在界面问一句需要联网的问题回答下方出现来源列表即代表链路通了。接口层面的请求与返回结构参考 docs/API/SEARCH.md。进阶调优可选每次检索可传engines、categories、language、pageno四个可选参数调用 src/lib/searxng.ts 的searchSearxng时在 options 里指定即可数组参数会自动以逗号拼接。想改默认引擎组合编辑实例侧 searxng/settings.yml 的engines部分重启生效Vane 无需改动。生产部署建议更换server.secret_key为随机值该配置同样在 settings.yml 里。出错速查症状常见原因处理办法提问后报 SearXNG search timed out实例不可达、网络延迟大或默认 10 秒超时触发先跑上面的curl验证连通性确认 Vane 与实例间路由和防火墙放行请求返回 403 或 results 为空JSON 格式未开启或所用引擎被禁用打开实例settings.yml核对search.formats含json、目标引擎disabled为 false界面填了 URL 却不生效填错端口、带上了/search路径后缀只填到主机和端口例如http://host:8080路径由代码自动拼接来源有结果但回答质量差聊天或嵌入模型不可用、模型与查询语言不匹配回设置页检查模型配置或在 docs/architecture/WORKING.md 里对照检索与生成流程排查收尾到这里外部 SearXNG 实例已接入 Vane部署时用SEARXNG_API_URL指向实例界面填一次 URL一条curl即可验证。之后引擎与分类的调整都发生在实例侧Vane 这边保持不动。想继续深入看这三处src/lib/searxng.ts 的检索实现、docs/API/SEARCH.md 的接口文档、docs/architecture/WORKING.md 的整体架构说明。【免费下载链接】VaneVane is an AI-powered answering engine.项目地址: https://gitcode.com/GitHub_Trending/pe/Vane创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考