跳到主要内容MiGPT GUI 部署小爱音箱接入 AI 及内网穿透配置 | 极客日志Shell / BashAI
MiGPT GUI 部署小爱音箱接入 AI 及内网穿透配置
介绍如何使用 MiGPT GUI 将小爱音箱接入 AI 大模型,包括 Docker 部署、小米账号与 TTS 配置、登录问题修复及人设设置。同时结合 cpolar 内网穿透工具,实现局域网服务的公网远程访问,提升小爱音箱的交互灵活性与实用性。
GopherDev27 浏览 
MiGPT GUI 是一款专为小爱音箱打造的图形化工具,核心功能是将小爱音箱接入 DeepSeek V3.2 等大模型,支持自定义人设、切换豆包 TTS 音色,同时兼容 Windows、Mac、Linux 多系统,零基础也能通过 Docker 一键部署,适配小爱音箱 Pro、mini 等多款设备。
使用 MiGPT GUI 时需注意配置小米账号时要准确填写设备 ID(需和米家 APP 一致),AI 大模型 API 密钥和 TTS 参数填写错误会导致功能失效,且首次部署后建议先测试语音配置。默认部署在本地局域网内,无法远程操作,可通过内网穿透工具解决这一问题。

1 什么是 MiGPT GUI?

MiGPT GUI 是一个图形化工具,旨在让用户轻松将小爱音箱接入人工智能大模型。它通过可视化界面简化了配置和部署流程:
- 接入 MiGPT 大模型,让小爱音箱获得更智能的对话能力;
- 自定义人设和对话风格,让音箱的回答更符合个人需求;
- 支持 TTS(文本转语音),实现自然语音输出;
- 安全快速部署,可在本地或 Docker 环境运行;
- 设备兼容性:
| 支持类型 | 设备 1 | 设备 2 | 设备 3 | 设备 4 | 设备 5 | 设备 6 |
|---|
| ✅ 支持连续对话 | 小爱音箱 Pro | 小爱音箱 mini | 小爱音箱 Play(2019) | 万能遥控版 | 小米 AI 音箱(1&2 代) | 小爱智能家庭屏 10 |
| ⚠️ 不支持连续对话 | 小爱音箱 | 小爱音箱 Play | Play 增强版 | 智能家庭屏 6 | Redmi 触屏音箱 Pro 8 | 小爱音箱 Art |
| ❌ 无法运行 | 小米小爱音箱 HD | 小爱蓝牙音箱随身版 | - | - | - | - |
简单来说,MiGPT GUI 就是小爱音箱接入大模型的'可视化桥梁'。
2 Docker 一键部署 migpt-server
本教程将以 Windows 系统上的 Docker 部署 migpt-server 作为演示。
首先,电脑按 Win+R 键,输入 cmd 回车,打开命令提示符窗口。然后输入如下命令一键部署migpt-server服务:
docker run -d --name migpt-server -p36592:36592 lmk123/migpt-server
执行完成后,可以使用如下命令查看 Docker 容器状态:
可以看到 status(状态) 显示为 UP,端口为 36592,代表正常运行。接着,浏览器访问如下地址:
这样,你就成功的部署好了migpt-server啦。
3 配置 migpt-server
3.1 配置小米账号及小爱设备
回到MiGPT 控制面板页面,下拉找到音箱部分,选择你的音箱型号:
我这里是小爱音箱 Pro,所以我就选择的它。接着小米账号 ID 部分,访问如下地址登录你的小米账号:
https://account.xiaomi.com/fe/service/account/profile
将小米 ID复制下来,填写到MiGPT 控制面板中的小米账号 ID列中,以及填写好你的小米账号密码:
接着,设备 ID 这儿,可以访问你的米家 APP中显示的名称,注意空格也要正确填写,比如我的显示为Xiaomi 智能音箱 Pro:
3.2 配置接入 AI 大模型
这里以阿里云百炼的 API 作为演示,阿里云百炼的新用户登录即有每个模型 100 万免费 tokens:
https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.60907980OAftBf&tab=model
点击页面上的创建API-KEY按钮,选择你的归属账号,然后点击确认:
确认后即可创建成功,点击页面上的API-Key 列的复制按钮即可复制你的 Api-Key 密钥:
复制好以后回到MiGPT 控制面板页面,在接口地址中填写如下链接:
密钥部分填写刚才复制下来的 Api-Key 密钥,模型部分这里以 DeepSeek 最新的 V3.2 为例,填写:
3.3 配置语音 TTS 服务
前面已经配置好了 AI 服务,接下来我们来配置一下语音服务,让你的小爱同学能够使用其他的音色来回答你的问题!
可以看到 TTS 引擎显示为默认,默认为小爱同学音色,点击可以切换引擎,这里以豆包为例:
切换后,会有 4 个参数,首先是对外地址,对外地址需要填写局域网地址或者部署在公网填写公网地址(比如我的电脑局域网 IP 为):
接下来是APP ID和Access Token,首先需要登录火山引擎控制台:
登录上以后,点击左上角 3 条杠,然后搜索语音合成,点击豆包语音进入:
接着在侧边栏的语音合成里面,就能看到你的APP ID和Access Token 了:
将其粘贴至MiGPT 控制面板中即可,然后点击测试语音配置,就可以试听一下是否配置成功了,默认是使用的灿灿音色:
如果想要换其他音色,可以参考火山引擎 TTS 音色列表,如下为我在 gitee 中开源的一个小页面,可以自行部署填写APP ID和Access Token即可:
4 登录问题修复及效果演示
4.1 登录问题修复
然后可以回到 cmd 终端,输入如下命令查看 migpt-server 运行日志(用户查看对话):
docker logs -f migpt-server
可以看到控制台提示了小米异地登录安全验证机制,这个问题即使访问链接登录了也不好使,如下为我整理出来的解决方法步骤如下:
1. 进入容器内部,进入 migptgui 容器的交互式 shell
2. 创建配置文件目录,创建 .migptgui/default 目录
3. 登录小米账号,在浏览器中访问小米账户获取授权或信息
4. 创建并写入 .mi.json 文件,在容器内创建文件并写入 Mina 和 Miiot 的 passToken
5. 验证文件是否创建成功,查看 .mi.json 是否存在并显示内容
6. 退出容器内部
我们按照步骤执行,首先需要进入到migpt-server的容器内部,执行命令 (记得用ctrl +c 停止之前查看日志的占用):
docker exec -it migpt-server /bin/sh
mkdir -p /root/.migptgui/default
然后登录小米账号官网,获取到你的 passToken:
获取到passToken后,在 docker 容器内部执行如下命令 (注意替换上你的passToken):
cat > /root/.migptgui/default/.mi.json <<'EOF'
{
"mina": {
"pass": {
"passToken": "你的小米账号 Token"
}
},
"miiot": {
"pass": {
"passToken": "你的小米账号 Token"
}
}
}
EOF
然后验证是否成功创建**.mi.json**文件:
ls -la /root/.migptgui/default/
4.2 效果演示
修复登录问题后,输入如下命令启动容器(由于前面账号登录问题,容器其实停止了):
docker start migpt-server
然后可以回到 cmd 终端,输入如下命令再次查看migpt-server运行日志(用户对话查看):
docker logs -f migpt-server
可以看到,现在服务成功启动了,在前面可以看到单次对话调用 AI 的关键词配置的为请、你、傻妞:
可以看到成功回答了,而且使用的我们配置的音色进行回答的!个别音箱还支持连续对话,可以通过关键词召唤:
可以看到成功的都调用 AI 进行回复啦。这样你的小爱音箱就已经支持 AI 啦!
5 设置人设
前面我们已经完美的配置好了小爱音箱接入大模型DeepSeekV3.2,并且配置上了豆包的音色,本期将带你更换默认人设傻妞。
可以看到已经插入了默认的模板,我们需要修改成自己喜欢的角色人物,比如这里以猫娘为例(为了省事,直接用 AI 生成了一个人设):
可以看到,我们设置的人设已经生效了!现在你的小爱音箱已经变身为一个具备个性化人设的 AI 智能助手,快去和它聊聊天吧!
6 下载安装 cpolar
到这里,MiGPT GUI 已经在本地跑起来了,但问题也随之而来——每次想换个人设、调整 TTS 音色、或者切换大模型 API,都得守在电脑前操作。有了 cpolar 内网穿透,这些烦恼就迎刃而解了。只需简单配置,就能随时随地通过公网访问 MiGPT GUI 管理面板,远程调参、切换模型、更新人设,统统不在话下。
6.1 什么是 cpolar?
- cpolar 是一款内网穿透工具,可以将你在局域网内运行的服务(如本地 Web 服务器、SSH、远程桌面等)通过一条安全加密的中间隧道映射至公网,让外部设备无需配置路由器即可访问。
- 广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台,并提供一键安装脚本方便部署。
6.2 下载 cpolar
下来下来是一个压缩包,解压后执行目录种的应用程序,一路默认安装即可,安装完成后,打开 cmd 窗口输入如下命令确认安装:
6.3 注册及登录 cpolar web ui 管理界面
访问 cpolar 官网,点击免费注册按钮,进行账号注册
注册完成后,在浏览器中输入如下地址访问 web ui 管理界面:
输入刚才注册好的 cpolar 账号登录即可进入后台页面:
7 穿透 MiGPT GUI 实现公网访问
7.1 随机域名方式 (免费方案)
随机域名方式适合预算有限的用户。使用此方式时,系统会每隔 24 小时 左右自动更换一次域名地址。对于长期访问的不太友好,但是该方案是免费的,如果您有一定的预算,可以查看大纲 7.2 的固定域名方式,且访问更稳定。
点击左侧菜单栏的隧道管理,展开进入隧道列表页面,页面下默认会有 2 个隧道:
- remoteDesktop 隧道,指向 3389 端口,tcp 协议
- website 隧道,指向 8080 端口,http 协议(http 协议默认会生成 2 个公网地址,一个是 http,另一个 https,免去配置 ssl 证书的繁琐步骤)
点击编辑 website 的隧道,修改成我们 MiGPT GUI 需要的信息:
接着,点击左侧菜单的状态菜单,接着点击在线隧道列表菜单按钮,可以看到有 2 个migpt的隧道,一个为 http 协议,另一个为 https 协议:
接下来在浏览器中访问migpt隧道生成的公网地址(http 和 https 皆可),这里以 https 为例:
7.2 固定域名方式
通过前面的配置,我们已经成功实现了MiGPT GUI的远程访问,但免费随机域名方案的局限性也逐渐显现:每24 小时左右自动更换域名地址,意味着你需要频繁更新书签、重新分享链接,甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生,能够让你拥有一个永久不变的专属地址。
选择预留菜单,即可看到保留二级子域名项,填写其中的地区、名称、描述(可不填)项,然后点击保留按钮,操作步骤图如下:
- 地区:显示为
China Top。
- 二级域名:显示为
migpt。
注:二级域名是唯一的,每个账号都不相同,请以自己设置的二级域名保留的为主
接着,进入侧边菜单栏的隧道管理下的隧道列表,可以看到名为migpt的隧道,点击编辑按钮进入编辑页面:
修改域名类型为二级子域名,然后填写前面配置好的子域名,点击更新按钮:
接着,来到状态菜单下的在线隧道列表可以看到隧道名称为migpt的公网地址已经变更为二级子域名 + 固定域名主体及后缀的形式了:
访问成功!这样一来,你就拥有了一个永久不变的专属域名,再也不用担心 24 小时域名更换的问题啦!
总结
MiGPT GUI 丰富了小爱音箱的交互体验,搭配 cpolar 内网穿透后,彻底摆脱局域网束缚,远程管理更便捷。简单配置就能让小爱音箱拥有智能对话和个性化人设,日常使用省心又实用。
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- 随机西班牙地址生成器
随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online