ItzCrazyKns/Vane · 上手攻略

  • 仓库：ItzCrazyKns/Vane
  • 链接：https://github.com/ItzCrazyKns/Vane
  • 分类：ai · rag（answer engine · search · privacy-focused）
  • 作者：Jay
  • 更新：2026-07-12

这是什么

Vane 是一个注重隐私的 AI 问答引擎，运行在你自己的硬件上。它结合了互联网搜索结果和本地 LLM（通过 Ollama）、云端模型（OpenAI、Claude、Gemini、Groq），给出带引用来源的精准答案，所有搜索记录完全本地保存。

类比来说，Vane 是一个可私有部署的 Perplexity，强调： - 不把搜索数据交给第三方 - 支持本地模型（Ollama），完全离线可用 - 多 AI 提供商混用，按需切换 - 内置 SearxNG 隐私搜索

解决什么问题

  • 隐私顾虑：传统 AI 搜索会把查询记录发送到第三方；Vane 的搜索通过自托管 SearxNG 发起，查询不被 Google/Bing 等跟踪
  • 想要私有部署：公司内网数据无法上公网，用 Ollama + Vane 可以搭完全离线的 AI 搜索引擎
  • 多模型切换：有时用 Claude 效果好，有时用 Groq 速度快，Vane 支持混用多个 provider
  • 需要引用来源：学术调研、事实核查等场景，Vane 返回带来源的答案，方便溯源

快速安装

方式一：Docker 安装（推荐）

# 一行启动（包含 SearxNG 搜索后端）
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latest

# 启动后打开浏览器访问
# http://localhost:3000

如果你已有运行中的 SearxNG 实例，使用 slim 版本：

docker run -d -p 3000:3000 \
  -e SEARXNG_API_URL=http://your-searxng-url:8080 \
  -v vane-data:/home/vane/data \
  --name vane itzcrazykns1337/vane:slim-latest

SearxNG 必须开启 JSON 格式输出和 Wolfram Alpha 搜索引擎。

方式二：从源码构建 + Docker

git clone https://github.com/ItzCrazyKns/Vane.git
cd Vane

# 构建 Docker 镜像
docker build -t vane .
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane vane

# 访问 http://localhost:3000

方式三：从源码（无 Docker）—— 需要 SearxNG

# 1. 预装 SearxNG，开启 JSON 输出和 Wolfram Alpha

git clone https://github.com/ItzCrazyKns/Vane.git
cd Vane

# 2. 安装依赖
npm i

# 3. 构建
npm run build

# 4. 启动（需先配置 SEARXNG_API_URL 环境变量）
npm start

环境要求：Node.js（建议 18+），Docker（推荐）， SearxNG 实例（无 Docker 方式必须自备）

核心用法

1. 首次配置（启动后）

打开 http://localhost:3000，首次进入设置向导： - 添加 AI Provider API Key（OpenAI / Claude / Groq 等） - 或配置 Ollama 连接地址（本地模型） - 配置默认搜索模式

2. 三种搜索模式

模式 适用场景 速度
Speed 模式 快速事实查询，实时性要求高 ⚡ 最快
Balanced 模式 日常信息搜索，兼顾速度和质量 ⚖️ 平衡
Quality 模式 深度研究，需要更多来源和更详细的答案 🔬 最全

3. 搜索来源配置

  • Web 搜索：通过 SearxNG（默认），隐私保护
  • 学术搜索：可搜索学术论文（配置中启用）
  • 讨论区搜索：Reddit、StackOverflow 等社区内容
  • 指定域名搜索：限制在特定网站内搜索，适合技术文档检索

4. 上传文件提问

支持上传 PDF、文本文件、图片，Vane 会基于文件内容回答问题，适合本地文档检索场景。

5. Widgets（小部件）

搜索结果页面会自动展示相关 Widget： - 🌤️ 天气 - 📈 股票价格 - 🧮 计算器 - 其他快速查询

6. Discover（发现）

首页展示当日热门文章和趋势内容，不需要主动搜索也能浏览信息。

7. 搜索历史

所有查询本地保存，可随时回溯，适合研究过程中的反复查阅。

典型适用场景

场景 价值
企业内网 AI 搜索 接入内网文档 + Ollama，完全私有化，不泄露搜索数据
学术文献调研 Quality 模式搜索论文，附带引用来源，可信度高
隐私敏感查询 避免传统搜索引擎的追踪和广告定向
本地知识库问答 上传本地 PDF/文档，基于内容回答，不依赖云端
快速事实核查 Balanced 模式，多源交叉验证，带来源链接

坑与注意

  1. SearxNG 配置有门槛：无 Docker 方式需要手动配置 SearxNG，开启 JSON 格式和 Wolfram Alpha，对新手不友好
  2. Ollama 需要自行安装：本地模型支持依赖 Ollama 已运行，ollama serve 必须先启动
  3. 中文搜索体验：Vane 主要面向英语环境，中文查询和中文来源的质量可能不如英文
  4. 更新频率：card 显示最近提交为 2026-04-11（数据截至 2026-07-09），相对沉寂，需要关注是否有活跃维护
  5. API Key 安全：如果通过 Docker 部署，本地数据卷 vane-data 包含历史记录，注意容器权限控制
  6. 多模型同时使用：Vane 支持混用，但多个 provider 同时请求会增加延迟和费用，需合理配置

与同类对比

工具 定位 优势 劣势
Vane 私有 AI 问答引擎 完全本地化、隐私保护、多模型混用 SearxNG 配置复杂、中文支持弱
Perplexity 云端 AI 搜索 体验成熟、来源丰富、实时性强 数据上云、隐私风险、无私有部署
Felo.ai AI 搜索引擎 多语言支持、思维导图展示 无本地部署选项
SearxNG + LLM DIY 方案 完全可控、成本低 需要自己搭前端、无 Widget、无多模式
Khoj 本地知识库 AI 支持 Obsidian/Notion 深度集成 搜索能力弱于 Vane

一句话结论

Vane 是隐私优先用户和需要私有化 AI 搜索场景的最佳选择——如果你接受 Docker 部署的稍高门槛、重视查询不上云，它能提供一个完全自托管、可混用多模型、带来源引用的 Perplexity 替代方案。

来源：GitHub README（ItzCrazyKns/Vane）、hub.docker.com、GitHub ItzCrazyKns/Vane