Windows下部署LobeChat并实现公网访问
在智能对话系统日益普及的今天,越来越多用户不再满足于使用现成的AI聊天工具,而是希望拥有一个完全可控、可定制、界面美观且支持多模型切换的私有化AI助手。如果你正在寻找这样的解决方案,那么LobeChat可能正是你想要的答案。
它不像传统开源项目那样晦涩难懂,反而以现代化的交互设计和极简的部署流程,让即使是非专业开发者也能快速上手。更关键的是,你可以将它运行在自己的Windows电脑上,数据本地保存,隐私更有保障——这在当前这个“数据即资产”的时代显得尤为珍贵。
而真正的亮点还不止于此。通过配合内网穿透工具,哪怕你没有公网IP或云服务器,也能轻松实现跨网络远程访问,手机、平板甚至团队成员都可以随时连接你的AI助手。整个过程无需复杂配置,也不用掏钱买VPS,成本几乎为零。
接下来,我们就从零开始,一步步带你完成 LobeChat 的本地部署,并借助 Cpolar 实现稳定可靠的公网访问能力。
为什么是 LobeChat?不只是“长得像ChatGPT”
提到开源聊天前端,很多人第一反应可能是“又一个模仿者”。但 LobeChat 并非简单的UI复刻,它的核心价值在于灵活性与扩展性。
基于 Next.js 构建的架构让它具备出色的性能表现,同时支持接入多种主流大语言模型——无论是 OpenAI、Gemini 还是 Claude,只需填写API密钥即可无缝切换。更重要的是,它还支持与本地运行的大模型联动,比如通过 Ollama 调用 Llama 3,真正做到“本地推理 + 高颜值前端”。
除此之外,它的功能生态也足够丰富:
- 角色预设系统:内置程序员、翻译官、写作导师等模板,还能自定义提示词(System Prompt),精准控制AI行为风格。
- 插件机制:可集成天气查询、网页摘要、代码解释等功能,极大拓展使用场景。
- 文件上传与多模态处理:支持PDF、Word、TXT等文档解析;结合 GPT-4 Vision 等视觉模型,甚至能分析图片内容。
- 语音交互(TTS/STT):文字转语音、语音转文字双加持,让对话更自然流畅。
- 文生图能力:对接 DALL·E 3、MidJourney 或 Pollinations API,在聊天中直接生成图像。
- 数据本地化存储:所有会话记录默认保存在浏览器本地,敏感信息不会上传至第三方服务器。
换句话说,LobeChat 不只是一个聊天界面,更像是一个模块化的AI工作台,适合个人知识管理、团队协作辅助、教育测试等多种用途。
GitHub 上持续活跃的更新频率和完善的中文文档,也让它的入门门槛大大降低。无论你是想搭建私人AI助理,还是为企业内部构建轻量级客服系统,它都是一个极具性价比的选择。
开始前的准备:确保你的Windows环境就绪
要在本地顺利运行 LobeChat,我们需要先准备好几个基础开发工具。别担心,这些都不是什么高深的技术组件,安装过程也非常直观。
所需组件清单
| 组件 | 版本要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10 / 11(推荐64位专业版) | 家庭版也可用,但建议关闭防火墙干扰 |
| Node.js | v18.x 或 v20.x(LTS版本优先) | JavaScript 运行环境 |
| pnpm | 最新版 | 包管理器,比 npm 更快更省空间 |
| Git | 最新版 | 用于克隆项目源码 |
⚠️ 温馨提醒:部分杀毒软件可能会误判某些依赖包为风险程序,建议临时关闭安全防护,避免安装失败。
安装步骤详解
1. 安装 Node.js
前往 Node.js 官网 下载 Windows Installer (.msi) 文件,选择 64 位版本(除非你的设备特别老旧)。
安装时务必勾选“Add to PATH”选项,这样后续才能在命令行中直接调用node和npm。
安装完成后,打开 PowerShell 或 CMD 输入以下命令验证是否成功:
node -v npm -v如果返回类似v20.12.2和10.x.x的版本号,说明安装无误。
2. 全局安装 pnpm
虽然 npm 是默认包管理器,但 LobeChat 官方推荐使用pnpm,因为它采用硬链接机制,能显著减少磁盘占用并提升安装速度。
执行以下命令进行全局安装:
npm install -g pnpm安装完毕后检查版本:
pnpm -v看到输出结果即表示成功。
3. 安装 Git
前往 Git 官方下载页,下载适用于 Windows 的安装包。
安装过程中保持默认设置即可,完成后你可以在任意文件夹右键选择“Git Bash Here”,也可以在 CMD 中直接使用git命令。
验证安装:
git --version只要能显示版本信息就没问题。
部署 LobeChat:三步走策略
环境准备好之后,真正的部署其实非常简单,总共只需要三个动作:克隆代码 → 安装依赖 → 启动服务。
第一步:获取项目源码
打开 PowerShell 或 Git Bash,执行以下命令:
git clone https://github.com/lobehub/lobe-chat.git这个命令会从 GitHub 将整个项目拉取到本地,生成一个名为lobe-chat的文件夹。
如果你在国内网络环境下遇到下载缓慢或中断的问题,可以尝试更换为国内镜像源:
git clone https://ghproxy.com/https://github.com/lobehub/lobe-chat.git第二步:进入项目目录并安装依赖
切换路径:
cd lobe-chat然后安装所需依赖包:
pnpm install首次安装可能需要几分钟时间,具体取决于网络状况。期间可能出现一些警告信息(如 peer dependencies 提示),只要不出现红色错误,都可以忽略。
💡 如果依赖下载失败,很可能是 registry 被墙。可以手动切换为国内镜像:
shell pnpm config set registry https://registry.npmmirror.com设置后再重新运行
pnpm install即可。
第三步:启动本地服务
一切就绪后,运行开发服务器:
pnpm dev启动成功后,终端会出现如下提示:
> Ready on http://localhost:3010这意味着 LobeChat 已经在你本机的 3010 端口运行起来了!
访问与初步配置:打造你的第一个AI助手
现在打开浏览器(推荐 Chrome 或 Firefox),访问地址:
http://localhost:3010你会看到一个简洁优雅的欢迎界面,支持中文语言切换。
初次使用需要完成几个基本设置:
- 选择语言:点击左下角齿轮图标 → Settings → Language → 中文(简体)
- 创建助手:首页点击“新建助手”,可选用预设角色,例如“编程助手”或“写作教练”
- 配置模型凭证:以 OpenAI 为例:
- 进入 Settings → Model Providers → OpenAI
- 添加新的 API Key(需提前在 OpenAI Platform 注册获取)
- 保存后即可在会话中选择 GPT-3.5 或 GPT-4 模型进行对话
此时你已经拥有了一个功能完整的 AI 聊天门户。不过目前只能在本机访问,换台设备就看不到了。要想实现随时随地使用,还得让它“走出局域网”。
让本地服务走向公网:Cpolar 内网穿透实战
这是最关键的一步。我们知道,家庭宽带通常不具备公网 IP,路由器也没有开放端口权限。因此,外部网络无法直接访问你电脑上的localhost:3010。
解决办法就是使用内网穿透工具,而其中最简单易用的就是Cpolar。
什么是 Cpolar?
Cpolar 是一款零配置的内网穿透服务,无需懂网络原理,也不用改路由器设置,只需登录账号、创建隧道,就能把本地服务暴露到互联网,获得一个可公开访问的 HTTPS 地址。
官网地址:https://www.cpolar.com
部署流程
1. 注册账号并下载客户端
访问 Cpolar 官网,点击【免费使用】注册账户。登录后下载 Windows 版本的.exe安装包。
安装过程一路“下一步”即可,安装完成后会自动启动本地管理后台。
2. 登录管理界面
打开浏览器,访问:
http://localhost:9200使用注册账号登录,进入仪表盘。
3. 创建隧道映射
在左侧菜单选择【隧道管理】→【创建隧道】
填写以下信息:
| 字段 | 值 |
|---|---|
| 隧道名称 | 如lobechat-public |
| 协议类型 | http |
| 本地地址 | 3010 |
| 域名类型 | 免费随机域名 |
| 地区 | China Top(推荐) |
点击【创建】后,Cpolar 会分配一个公网 HTTPS 地址,形如:
https://xxxxx.cpolar.cn4. 测试公网访问
复制该链接,在手机或其他设备的浏览器中打开。
🎉 成功!你现在可以从任何联网设备访问你本地运行的 LobeChat 实例了。
🔒 安全提示:此链接由系统随机生成,有效期通常为24小时,且无密码保护。仅建议用于测试或短期分享,请勿用于生产环境。
固定域名:告别每次重启都变地址
如果你打算长期使用,或者要分享给团队成员协作,显然不能每次都换新链接。幸运的是,Cpolar 支持保留固定二级子域名,只需升级到专业版即可实现永久可用地址。
如何配置固定地址?
步骤一:预留子域名
- 登录 Cpolar 云端仪表盘
- 点击左侧【预留】→【保留二级子域名】
- 填写信息:
- 地区:China Top
- 子域名:输入你喜欢的名字,如mylobechat
- 备注:可选 - 点击【保留】
成功后你会得到一个固定的公网地址,例如:
https://mylobechat.cpolar.cn步骤二:绑定到现有隧道
回到本地 Cpolar 客户端管理页面(http://localhost:9200):
- 找到之前创建的 LobeChat 隧道
- 点击【编辑】
- 修改配置:
- 域名类型 → 二级子域名
- Sub Domain → 输入你保留的名称(如mylobechat) - 点击【更新】
刷新页面后,公网地址就会变成你设定的固定域名。
从此以后,无论重启多少次,地址都不会再变了。你可以把它加入书签、嵌入工作流,甚至做成二维码贴在办公室墙上供大家扫码使用。
结语:低成本搭建属于你的AI门户
整个部署过程其实并不复杂,总结下来就是四件事:
- 准备好 Node.js、pnpm 和 Git;
- 克隆项目并启动本地服务;
- 使用 Cpolar 实现公网访问;
- 配置固定域名,提升可用性。
这套组合拳的优势非常明显:零硬件成本、零运维压力、高自由度、强隐私保护。即使你不是程序员,只要按步骤操作,也能在半小时内拥有一个媲美 ChatGPT 的个性化AI聊天门户。
未来,你还可以进一步深化应用:
- 接入本地大模型(如 Ollama + Llama 3),彻底摆脱对云端API的依赖;
- 开发自定义插件,对接企业内部系统(如CRM、ERP);
- 将服务容器化,部署到 Docker 中实现开机自启;
- 结合企业微信或钉钉机器人,实现消息自动推送。
AI 技术的民主化,从来不是一句空话。当每一个普通人都能轻松部署、掌控和扩展自己的智能助手时,真正的创造力才刚刚开始释放。
所以,别再只是围观了——现在就动手部署你的第一个 LobeChat,迈出构建专属AI生态的第一步吧。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考