前言

本文主要介绍如何本地部署LocalGPT并实现远程访问，由于localGPT只能通过本地局域网IP地址+端口号的形式访问，实现远程访问还需搭配cpolar内网穿透。

LocalGPT这个项目最大的亮点在于：

1.使用LLM的力量，无需互联网连接，就可以向你的文档提问。100%私密，任何数据都不会离开你的执行环境。你可以摄取文档并提问，无需互联网连接！

2.使用LangChain和Vicuna-7B以及InstructorEmbeddings构建。可以借助LangChain构建更高级能力的pipeline。

环境准备

• windows10
• Git
• python3.11.4
• C++编译器

下载安装依赖过程中需要C++编译器,我们先提前安装C++编译器,进入微软官方下载vs2022工具:

https://visualstudio.microsoft.com/visual-cpp-build-tools/

下载后打开进行安装,我们勾选第一个C++桌面开发,然后点击右下角安装,接下来等待安装完成即可

1. localGPT部署

localGPT在Github 上面开源了,我们可以在里面复制克隆地址,把项目克隆到本地

GitHub 地址: https://github.com/PromtEngineer/localGPT

通过Git 把项目克隆到本地windows目录,在目录中打开Powershall,执行:

git clone https://github.com/PromtEngineer/localGPT.git

即可看到克隆下来的localGPT

进入localGPT目录

cd localGPT

下载安装依赖,然后等待完成即可

pip install -r requirements.txt

2. 启动和使用

打开localGPT目录,可以看到一个文件夹,叫:SOURCE_DOCUMENTS,我们只需把文档放到该目录下

这里测试,放入一个java编程思想文档

然后打开我们刚刚的命令行,下面命令提取数据,此处如果出现错误,可以尝试开启科学上网!

python ingest.py

没有报错表示正常

然后运行localGPT_API,运行会有点慢.可以稍等一下,这里运行的时候可以指定使用电脑GPU运行服务端,这样可以加快执行速度,详细可以参考Github上文档

python run_localGPT_API.py

启动后我们可以看到api 接口端口号和地址,注意,这个窗口不能关闭,需保持运行,因为web ui 界面需要和这个api 接口保持通信

接下来启动web ui 服务,重新在localGPT目录打开一个新的Powershell命令行窗口,然后进入localGPTUI目录

cd localGPTUI

进入后执行启动web ui 界面命令

python localGPTUI.py

启动后可以看到访问的地址和端口号,端口号是:5111

我们打开浏览器,输入上面的web ui 服务地址和端口号,即可看到操作的web ui 界面

在输入框中,输入需要对你文档提问的信息,然后点击search

即可看到返回我们上传的文档里面内容,到了这里,启动安装即完成了,下面设置远程访问

3. 安装cpolar 内网穿透

cpolar内网穿透工具，永久免费且不限制流量，支持http/https/tcp协议，无需公网IP，也不用设置路由器，使用简单。

cpolar官网：https://www.cpolar.com/

访问cpolar官网，注册一个账号，然后下载并安装客户端，具体安装教程可以参考官网文档教程。

• windows系统：在官网下载安装包后，双击安装包一路默认安装即可。
• linux系统：支持一键自动安装脚本，详细请参考官网文档——入门指南

cpolar安装成功后，在浏览器上访问本地9200端口【http://localhost:9200】，使用cpolar账号登录。

4. 创建公网地址

点击左侧仪表盘的隧道管理——创建隧道，创建一个我们上面的localGPT 的web ui 的5111隧道

• 隧道名称：可自定义命名，注意不要与已有的隧道名称重复
• 协议：选择http
• 本地地址：5111
• 域名类型：免费选择随机域名
• 地区：选择China vip

点击创建

隧道创建成功后，点击左侧的状态——在线隧道列表,查看所生成的公网地址，有两种访问方式,一种是http 和https

5. 公网地址访问

我们使用http公网地址访问,可以看到,我们访问到了localGPT web UI 界面,这样一个公网地址访问就创建好了

6. 固定公网地址

由于以上使用cpolar所创建的隧道使用的是随机公网地址，24小时内会随机变化，不利于长期远程访问。因此我们可以为其配置二级子域名，该地址为固定地址，不会随机变化【ps：cpolar.cn已备案】

注意需要将cpolar套餐升级至基础套餐或以上，且每个套餐对应的带宽不一样。【cpolar.cn已备案】

登录cpolar官网，点击左侧的预留，选择保留二级子域名，地区选择china vip top ,然后设置一个二级子域名名称，填写备注信息,点击保留

保留成功后复制保留的二级子域名地址

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China VIP

点击更新

更新完成后,打开在线隧道列表,此时可以看到随机的公网地址已经发生变化,地址名称也变成了保留和固定的二级子域名名称

最后,我们使用固定的公网地址访问localGPT webui 界面可以看到访问成功,一个永久不会变化的远程访问方式即设置好了