30分钟搭建本地智能搜索引擎：search_with_lepton私有化部署指南

你还在担心云端搜索引擎的隐私泄露问题？想拥有一个完全掌控的智能搜索工具却苦于技术门槛？本文将带你用不到500行代码构建专属的对话式搜索引擎，无需专业背景，全程可视化操作。读完你将获得：

• 本地化部署的隐私保护方案
• 支持GPT类模型的智能问答功能
• 可自定义的美观搜索界面
• 多引擎切换（Bing/Google）的灵活配置

项目概览

search_with_lepton是一个轻量级智能搜索解决方案，核心特点包括：

• 内置LLM（大语言模型）支持，实现搜索结果智能摘要
• 多搜索引擎无缝切换（Bing/Google）
• 响应式UI设计，适配各种设备
• 结果缓存与分享功能

项目架构采用前后端分离设计：

• 前端：基于Next.js的React应用 web/
• 后端：Python服务 search_with_lepton.py
• 核心组件：搜索框(search.tsx)、结果展示(result.tsx)、流式处理(fetch-stream.ts)

环境准备

基础依赖安装

# 安装Python依赖
pip install -U leptonai openai && lep login

# 安装Node.js依赖
cd web && npm install

API密钥准备

服务类型	获取途径	环境变量
Bing搜索	Bing Web Search API	BING_SEARCH_V7_SUBSCRIPTION_KEY
Google搜索	SearchApi/Serper/Google可编程搜索	SEARCHAPI_API_KEY/SERPER_API_KEY
Lepton AI	Lepton AI控制台	LEPTON_WORKSPACE_TOKEN

注意：Lepton AI提供免费额度，适合个人使用。登录后在"设置>令牌"页面获取工作区令牌

部署步骤

1. 配置环境变量

# 设置Bing搜索密钥
export BING_SEARCH_V7_SUBSCRIPTION_KEY=你的密钥

# 设置Lepton AI令牌
export LEPTON_WORKSPACE_TOKEN=你的令牌

2. 构建前端应用

cd web && npm run build

构建过程会生成优化后的静态资源，位于web/.next目录下。主要编译文件包括：

• 页面组件：page.tsx、search/page.tsx
• 全局样式：globals.css
• 类型定义：relate.ts、source.ts

3. 启动服务

根据搜索引擎选择对应命令启动：

# 使用Bing后端
BACKEND=BING python search_with_lepton.py

# 使用Google SearchApi后端
BACKEND=SEARCHAPI python search_with_lepton.py

# 使用Google Serper后端
BACKEND=SERPER python search_with_lepton.py

服务启动后，访问 http://localhost:8000 即可使用搜索界面。

功能定制

界面个性化

修改全局样式文件定制主题：

/* web/src/app/globals.css */
:root {
  --primary-color: #3b82f6; /* 修改主色调 */
  --search-bg: #f8fafc; /* 修改搜索框背景 */
  --result-hover: #f1f5f9; /* 修改结果悬停效果 */
}

主要视觉组件位置：

• Logo: logo.tsx
• 页脚: footer.tsx
• 加载动画: skeleton.tsx

搜索预设配置

编辑预设查询文件添加常用搜索模板：

// web/src/app/components/preset-query.tsx
const presetQueries = [
  { label: "今日科技新闻", query: "latest technology news today" },
  { label: "Python教程", query: "best Python tutorials 2025" },
  // 添加自定义预设...
];

高级使用

切换搜索引擎

修改启动命令的BACKEND参数即可无缝切换搜索引擎：

# Google SearchApi
export SEARCHAPI_API_KEY=你的密钥
BACKEND=SEARCHAPI python search_with_lepton.py

# Google Serper
export SERPER_SEARCH_API_KEY=你的密钥
BACKEND=SERPER python search_with_lepton.py

结果优化

通过修改LLM提示词调整回答质量：

# search_with_lepton.py 中调整prompt
def generate_prompt(question, sources):
    return f"""基于以下搜索结果回答问题：{question}
    来源：{sources}
    要求：简洁明了，不超过200字，引用来源序号。
    """

常见问题

服务启动失败

1. 检查端口占用情况：lsof -i:8000
2. 验证环境变量是否正确设置：printenv | grep BING
3. 查看日志文件：tail -f lepton.log

搜索结果为空

1. 检查API密钥有效性
2. 确认网络连接正常
3. 尝试更换搜索引擎后端

界面显示异常

1. 重新构建前端：cd web && npm run build
2. 清除缓存：npm run clean
3. 检查浏览器控制台错误信息

项目结构速览

search_with_lepton/
├── search_with_lepton.py        # 后端服务
├── web/                         # 前端应用
│   ├── src/app/
│   │   ├── components/          # UI组件
│   │   ├── interfaces/          # 类型定义
│   │   ├── utils/               # 工具函数
│   │   ├── page.tsx             # 主页
│   │   └── search/page.tsx      # 搜索结果页
│   └── public/                  # 静态资源
└── lepton_template/             # 模板文件

通过本指南，你已成功部署了私有化的智能搜索引擎。该方案不仅保护你的搜索隐私，还可根据需求扩展功能，如添加本地知识库、自定义过滤规则等。项目源码完全开放，欢迎贡献代码或提出改进建议。