Shell / BashAI算法
MiGPT GUI 让小爱音箱变身个性化 AI 助手并支持远程管理
如何使用 MiGPT GUI 将小爱音箱接入 DeepSeek 等大模型，实现个性化 AI 助手功能。内容包括 Docker 一键部署、小米账号及设备 ID 配置、阿里云百炼 API 接入、火山引擎 TTS 语音服务配置，以及解决小米异地登录问题的方法。此外，还详细说明了如何通过内网穿透工具将本地服务映射到公网，实现远程管理和人设切换，从而提升小爱音箱的交互体验和灵活性。
如何使用 MiGPT GUI 将小爱音箱接入 DeepSeek 等大模型，实现个性化 AI 助手功能。内容包括 Docker 一键部署、小米账号及设备 ID 配置、阿里云百炼 API 接入、火山引擎 TTS 语音服务配置，以及解决小米异地登录问题的方法。此外，还详细说明了如何通过内网穿透工具将本地服务映射到公网，实现远程管理和人设切换，从而提升小爱音箱的交互体验和灵活性。
MiGPT GUI 是一款专为小爱音箱打造的图形化工具，核心功能是将小爱音箱接入 DeepSeek V3.2 等大模型，支持自定义人设、切换豆包 TTS 音色，同时兼容 Windows、Mac、Linux 多系统，零基础也能通过 Docker 一键部署，适配小爱音箱 Pro、mini 等多款设备。
使用 MiGPT GUI 时，配置小米账号需准确填写设备 ID（需和米家 APP 一致），AI 大模型 API 密钥和 TTS 参数填写错误会导致功能失效。首次部署后建议先测试语音配置，避免后续使用中出现音色异常的情况。
默认部署在本地局域网内，这带来了明显局限：在家外想调整小爱音箱的人设、切换音色，只能等回到家操作。通过内网穿透工具将本地的 MiGPT GUI 服务映射到公网，无需折腾路由器端口映射，在外用手机、电脑就能访问控制面板，让使用场景更灵活。
MiGPT GUI 是一个图形化工具，旨在让用户轻松将小爱音箱接入人工智能大模型。它通过可视化界面简化了配置和部署流程，即使没有深厚的编程基础，也能快速完成以下操作：
| 支持类型 | 设备 1 | 设备 2 | 设备 3 | 设备 4 | 设备 5 | 设备 6 |
|---|---|---|---|---|---|---|
| ✅ 支持连续对话 | 小爱音箱 Pro | 小爱音箱 mini | 小爱音箱 Play（2019） | 万能遥控版 | 小米 AI 音箱（1&2 代） | 小爱智能家庭屏 10 |
| ⚠️ 不支持连续对话 | 小爱音箱 | 小爱音箱 Play | Play 增强版 | 智能家庭屏 6 | Redmi 触屏音箱 Pro 8 | 小爱音箱 Art |
| ❌ 无法运行 | 小米小爱音箱 HD | 小爱蓝牙音箱随身版 | - | - | - | - |
简单来说，MiGPT GUI 就是小爱音箱接入大模型的'可视化桥梁'，把复杂的配置和接口调用都封装在图形界面里，让家庭自建 AI 助手变得轻松可行。
本教程将以 Windows 系统上的 Docker 部署 migpt-server 作为演示。首先，电脑按 Win+R 键，输入 cmd 回车，打开命令提示符窗口。然后输入如下命令一键部署 migpt-server 服务：
docker run -d --name migpt-server -p 36592:36592 lmk123/migpt-server
执行完成后，可以使用如下命令查看 Docker 容器状态：
docker ps
可以看到 status(状态) 显示为 UP，端口为 36592，代表正常运行。接着，浏览器访问如下地址：
http://localhost:36592
这样，你就成功部署好了 migpt-server。
前面我们已经成功部署好了 migpt-server 并确认服务正常运行，接下来就可以进行配置，让小爱音箱顺利接入 MiGPT。
回到 MiGPT 控制面板 页面，下拉找到音箱部分，选择你的 音箱型号。
我这里是 小爱音箱 Pro，所以我就选择的它。接着小米账号 ID 部分，访问如下地址登录你的小米账号：
https://account.xiaomi.com/fe/service/account/profile
将 小米 ID 复制下来，填写到 MiGPT 控制面板 中的 小米账号 ID 列中，以及填写好你的小米账号密码。
接着，设备 ID 这儿，可以访问你的 米家 APP 中显示的名称，注意空格也要正确填写，比如我的显示为 Xiaomi 智能音箱 Pro。 就将该名字填写至设备 ID 这一列中。
阿里云百炼官网：https://bailian.console.aliyun.com/#/home
这里以 阿里云百炼 的 API 作为演示，阿里云百炼的 新用户 登录即有 每个模型 100 万 免费 tokens。
登录好以后，进入到密钥管理页面：
https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.60907980OAftBf&tab=model#/api-key
点击页面上的创建 API-KEY 按钮，选择你的 归属账号，然后点击 确认。
确认后即可创建成功，点击页面上的 API-Key 列 的复制按钮即可复制你的 Api-Key 密钥。
复制好以后回到 MiGPT 控制面板 页面，在接口地址中填写如下链接：
https://dashscope.aliyuncs.com/compatible-mode/v1
密钥部分填写刚才复制下来的 Api-Key 密钥，模型部分这里以 DeepSeek 最新的 V3.2 为例，填写：
deepseek-v3.2
这样就配置好，接入好 AI 了！
前面已经配置好了 AI 服务，接下来我们来配置一下语音服务，让你的小爱同学能够使用其他的音色来回答你的问题！
滚动到下方的语音服务项：
可以看到 TTS 引擎显示为 默认，默认为小爱同学音色，点击可以切换引擎，这里以豆包为例。
切换后，会有 4 个参数，首先是 对外地址，对外地址需要填写 局域网地址 或者部署在公网填写 公网地址 (比如我的电脑局域网 IP 为)：
http://192.168.50.149:36592
接下来是 APP ID 和 Access Token，首先需要登录 火山引擎控制台：
https://console.volcengine.com/home
登录上以后，点击左上角 3 条杠，然后搜索 语音合成，点击 豆包语音 进入。
进入以后，点击 创建应用。
然后勾选上语音合成，点击确定即可。
接着在侧边栏的 语音合成 里面，就能看到你的 APP ID 和 Access Token 了。
将其粘贴至 MiGPT 控制面板 中即可，然后点击 测试语音配置，就可以试听一下是否配置成功了，默认是使用的 灿灿 音色。
如果想要换其他音色，可以参考 火山引擎 TTS 音色列表。
配置完成后，点击页面上的启动按钮，即可启动。
然后可以回到 cmd 终端，输入如下命令查看 migpt-server 运行日志（用户查看对话）：
docker logs -f migpt-server
可以看到控制台提示了 小米异地登录安全验证机制，这个问题即使访问链接登录了也不好使，解决方法步骤如下：
我们按照步骤执行，首先需要进入到 migpt-server 的容器内部，执行命令 (记得用 ctrl + c 停止之前查看日志的占用)：
docker exec -it migpt-server /bin/sh
接着，在容器内创建配置文件目录，执行如下命令：
mkdir -p /root/.migptgui/default
然后登录小米账号官网，获取到你的 passToken：
https://account.xiaomi.com
获取到 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/
成功，执行如下命令退出容器即可：
exit
修复登录问题后，输入如下命令启动容器（由于前面账号登录问题，容器其实停止了）：
docker start migpt-server
再次点击页面上的启动按钮，即可启动。
然后可以回到 cmd 终端，输入如下命令再次查看 migpt-server 运行日志（用户对话查看）：
docker logs -f migpt-server
可以看到，现在服务成功启动了，在前面可以看到单次对话调用 AI 的关键词配置的为 请、你、傻妞。
这里询问一下，如：
小爱同学，你是谁？
可以看到成功回答了，而且使用的我们配置的音色进行回答的！个别音箱还支持连续对话，可以通过关键词召唤。
这里使用如下指令唤醒连续对话：
召唤 为什么地球是方的？那为什么地球是圆的？
可以看到成功的都调用 AI 进行回复啦。这样你的小爱音箱就已经支持 AI 啦！
前面我们已经完美的配置好了小爱音箱接入大模型 DeepSeekV3.2,并且配置上了 豆包的音色，本期将带你更换默认人设 傻妞。
首先，滚动到最顶部，可以看到如下：
我们点击 自定义 按钮，然后点击写入默认模板。
可以看到已经插入了默认的模板，我们需要修改成自己喜欢的角色人物，比如这里以 猫娘 为例（为了省事，直接用 AI 生成了一个人设）。
将 人设 覆盖之前的模板，然后重新点击 启动 按钮即可。
让我们询问一下小爱同学看看：
小爱同学，你是谁？
可以看到，我们设置的人设已经生效了！现在你的小爱音箱已经变身为一个具备个性化人设的 AI 智能助手，快去和它聊聊天吧！
到这里，MiGPT GUI 已经在本地跑起来了，但问题也随之而来——每次想 换个人设、调整 TTS 音色、或者 切换大模型 API，都得守在电脑前操作。万一人在外面，家里的小爱音箱突然 "抽风" 或者想临时改个设定，那就只能干着急。
有了 内网穿透工具，这些烦恼就迎刃而解了。只需简单配置，就能随时随地通过公网访问 MiGPT GUI 管理面板，远程调参、切换模型、更新人设，统统不在话下。
打开内网穿透工具的官网下载页面，点击下载按钮，下载安装包。
下来下来是一个压缩包，解压后执行目录种的应用程序，一路默认安装即可，安装完成后，打开 cmd 窗口输入如下命令确认安装：
tunnel version
出现如上版本即代表安装成功!
访问内网穿透工具官网，点击免费注册按钮，进行账号注册。
注册完成后，在浏览器中输入如下地址访问 web ui 管理界面：
http://127.0.0.1:9200
输入刚才注册好的内网穿透工具账号登录即可进入后台页面。
随机域名方式适合预算有限的用户。使用此方式时，系统会每隔 24 小时 左右自动更换一次域名地址。对于长期访问的不太友好，但是该方案是免费的，如果您有一定的预算，可以查看 固定域名方式，且 访问更稳定。
点击左侧菜单栏的 隧道管理，展开进入 隧道列表 页面，页面下默认会有 2 个隧道：
点击编辑 website 的隧道，修改成我们 MiGPT GUI 需要的信息：
接着，点击左侧菜单的 状态 菜单，接着点击 在线隧道列表 菜单按钮，可以看到有 2 个 migpt 的隧道，一个为 http 协议，另一个为 https 协议:
注意：每个用户创建的隧道显示的公网地址都不一样！
接下来在浏览器中访问 migpt 隧道生成的公网地址（http 和 https 皆可），这里以 https 为例：
可以看到成功访问啦!
通过前面的配置，我们已经成功实现了 MiGPT GUI 的远程访问，但 免费随机域名方案 的局限性也逐渐显现：每 24 小时左右 自动更换域名地址，意味着你需要频繁更新书签、重新分享链接，甚至可能因为忘记更新而无法访问。固定域名方案 正是为了解决这些痛点而生，能够让你拥有一个 永久不变的专属地址。
好啦，接下来开始固定保留二级子域名教程！
首先，进入官网的预留页面：
https://dashboard.tunnel.com/reserved
选择 预留 菜单，即可看到 保留二级子域名 项，填写其中的 地区、名称、描述（可不填） 项，然后点击保留按钮，操作步骤图如下：
列表中显示了一条已保留的二级子域名记录：
China Top。migpt。注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主
接着，进入侧边菜单栏的 隧道管理 下的 隧道列表，可以看到名为 migpt 的隧道，点击 编辑 按钮进入编辑页面：
修改域名类型为 二级子域名，然后填写前面配置好的子域名，点击更新按钮：
接着，来到 状态 菜单下的 在线隧道列表 可以看到隧道名称为 migpt 的公网地址已经变更为 二级子域名 + 固定域名主体及后缀 的形式了：
这里以 https 协议做访问测试:
访问成功！这样一来，你就拥有了一个 永久不变的专属域名，再也不用担心 24 小时域名更换的问题啦！
MiGPT GUI 丰富了小爱音箱的交互体验，搭配内网穿透工具后，彻底摆脱局域网束缚，远程管理更便捷。简单配置就能让小爱音箱拥有智能对话和个性化人设，日常使用省心又实用。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online