Nanobrowser本地部署教程:无需联网也能运行的AI浏览器工具
你还在为AI工具依赖云端服务而烦恼吗?想在没有网络的环境下也能使用智能浏览器自动化功能?本文将带你一步步完成Nanobrowser的本地部署,让你完全掌控数据隐私与使用场景,即使在断网环境下也能享受AI驱动的浏览器自动化体验。
读完本文后,你将能够:
- 在本地计算机上完整部署Nanobrowser浏览器扩展
- 配置本地LLM模型实现完全离线运行
- 掌握扩展的加载与调试技巧
- 解决常见部署问题
关于Nanobrowser
Nanobrowser是一款开源的多智能体浏览器自动化工具,作为Chrome扩展运行,提供了灵活的LLM选项和多智能体系统。与其他需要云端支持的工具不同,Nanobrowser可以在本地环境完全运行,保护你的数据隐私并确保在无网络环境下的可用性。
Nanobrowser的核心优势包括:
- 100%免费 - 无订阅费用或隐藏成本,仅需支付你使用的API费用
- 隐私优先 - 所有操作在本地浏览器中运行,凭证不会共享给任何云服务
- 灵活的LLM选项 - 可连接到你偏好的LLM提供商,为不同智能体选择不同模型
- 完全开源 - 浏览器自动化的完整透明度,无黑盒或隐藏流程
准备工作
在开始部署前,请确保你的系统满足以下要求:
硬件要求
- 至少4GB内存(推荐8GB以上,用于本地LLM运行)
- 至少1GB可用磁盘空间
- 互联网连接(仅用于初始下载,部署后可离线运行)
软件要求
- Google Chrome浏览器或基于Chromium的浏览器(如Edge)
- Node.js(v22.12.0或更高版本)
- pnpm(v9.15.1或更高版本)
获取源码
首先,克隆Nanobrowser仓库到本地:
git clone https://gitcode.com/GitHub_Trending/na/nanobrowser.git
cd nanobrowser
安装步骤
1. 安装依赖
进入项目目录后,安装所需的依赖包:
pnpm install
2. 构建扩展
执行构建命令生成可安装的扩展文件:
pnpm build
构建完成后,扩展文件将生成在dist目录中。
3. 安装到Chrome浏览器
- 打开Chrome浏览器,访问
chrome://extensions/ - 启用右上角的"开发者模式"
- 点击"加载已解压的扩展程序"
- 选择项目中的
dist目录
4. 配置本地模型
为了实现完全离线运行,需要配置本地LLM模型:
- 点击Chrome工具栏中的Nanobrowser图标打开侧边栏
- 点击右上角的"设置"图标
- 在设置页面中,导航到"LLM提供商"部分
- 选择"Ollama"或其他本地LLM选项
- 配置本地模型端点和相关参数
本地模型推荐配置
Nanobrowser允许为每个智能体配置不同的LLM模型,以平衡性能和资源消耗。以下是推荐的本地模型配置:
高性能配置
- 规划器(Planner): Qwen3-30B-A3B-Instruct-2507
- 更好的推理和规划能力
- 导航器(Navigator): Falcon3 10B
- 高效的网页导航任务处理
- 性能和资源消耗的良好平衡
资源友好配置
- 规划器(Planner): Qwen 2.5 Coder 14B
- 合理的性能,资源消耗较低
- 导航器(Navigator): Mistral Small 24B
- 轻量级且资源效率高
- 适合基本导航任务
离线使用验证
安装完成后,可以通过以下步骤验证离线功能:
- 断开网络连接
- 打开Nanobrowser侧边栏
- 输入简单指令,如"总结当前页面内容"
- 验证Nanobrowser是否能在无网络环境下完成任务
常见问题解决
扩展加载失败
如果Chrome无法加载扩展,请检查:
- 是否启用了开发者模式
dist目录是否存在且包含正确的构建文件- Chrome版本是否支持Manifest V3扩展
本地模型无法连接
如果无法连接到本地LLM模型:
- 确保本地模型服务正在运行
- 检查模型端点URL和端口配置
- 验证防火墙设置是否允许连接
性能问题
在运行本地模型时遇到性能问题:
- 尝试使用较小的模型
- 关闭其他占用资源的应用程序
- 增加系统内存或升级硬件
总结
通过本教程,你已成功在本地部署了Nanobrowser,实现了无需联网也能运行的AI浏览器工具。现在你可以:
- 在保护隐私的前提下使用AI浏览器自动化功能
- 避免依赖云端服务和网络连接
- 根据你的硬件配置优化模型选择
- 享受开源工具带来的灵活性和透明度
Nanobrowser的完整文档和更多使用技巧,请参考项目的官方文档。如有任何问题或建议,欢迎参与社区讨论。
相关资源
- 官方文档: README.md
- 贡献指南: CONTRIBUTING.md
- 安全策略: SECURITY.md
- 扩展源码: chrome-extension/
- 存储模块: packages/storage/
- 用户界面组件: packages/ui/
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



