一、准备工作：三位一体的配置#

在开始之前，除了硬件，我们最核心的是要准备好三个关键的配置文件。

1. 访问配置生成网站

   • 在电脑浏览器中打开 MiGPT GUI 配置生成器。

2. 生成并导出 .migpt.js 和 .env

   • 在网站上，详细填写你的小米账号、选择音箱、设置AI角色和唤醒词等。
   • 在AI配置部分，填入你的大模型提供商的 API Key、Model Name 和 Base URL。
   • 全部完成后，点击页面底部的 “生成配置”。
   • 接着，分别点击 “导出JS” 和 “导出ENV” 按钮。
   • 现在，你的电脑上应该有两个下载好的文件：.migpt.js 和 .env。

3. 手动创建 .mi.json 文件

   • 为了防止因IP变动等原因导致的小米账号登录失败，我们需要创建一个包含 passToken 的 .mi.json 文件。
   • 在你的电脑上新建一个名为 .mi.json 的文本文件，将以下内容粘贴进去，并把 passToken 替换为你自己的值。（获取 passToken 的方法请参考这篇文章）

   1
   {
   2
     "mina": {
   3
       "pass": {
   4
         "passToken": "把你获取的passToken填到这里"
   5
       }
   6
     },
   7
     "miiot": {
   8
       "pass": {
   9
         "passToken": "把你获取的passToken填到这里"
   10
       }
   11
     }
   12
   }
   

准备工作小结： 到此，你手上应该有 .migpt.js 和 .mi.json 两个文件，并且用记事本打开了 .env 文件备用。

二、第一步：刷入 Armbian 系统#

这一步是将你的玩客云变成一台功能强大的小型 Linux 服务器。详细的短接、烧录过程，请直接参考我之前发布的保姆级教程。

➡️ 参考详细的玩客云刷机教程

刷机成功后，将玩客云插上电源和网线启动。通过路由器后台找到它的IP地址，并使用SSH工具（如 FinalShell）登录（默认用户名 root，密码 1234）。

三、第二步：安装 Docker#

Docker 是一个容器化平台，可以让我们非常方便地部署和管理应用。

1. 登录到玩客云的 Armbian 系统后，执行以下命令安装 Docker。

   推荐使用国内镜像源（速度更快，更稳定）： 由于直接从官网 get.docker.com 下载脚本可能因网络问题导致缓慢或失败，强烈建议使用博主提供的国内镜像地址进行一键安装：

   1
   curl -fsSL http://static.lerio.cn/get_docker.sh -o get-docker.sh
   2
   sudo sh get-docker.sh
   

2. 等待安装完成，运行 docker --version 来验证 Docker 是否安装成功。如果能看到版本号输出，说明安装成功。

四、第三步：配置并运行 Mi-GPT#

这是最激动人心的部分。我们将把配置文件和镜像都准备好，然后一键启动。

1. 在玩客云上创建配置目录

   1
   mkdir -p /root/mi-gpt
   

2. 上传配置文件（.migpt.js 和 .mi.json）

   • 推荐使用 FinalShell 拖拽上传：在 FinalShell 中，导航到你刚刚创建的 /root/mi-gpt 目录，然后直接从电脑中将 .migpt.js 和 .mi.json 两个文件拖拽进去即可。

3. 拉取 Mi-GPT 镜像 (关键一步)

   • 由于网络原因，直接从 Docker Hub 官方仓库拉取镜像可能会非常缓慢或失败。我们强烈推荐使用国内的 1ms.run 镜像站来加速下载。
   • 在SSH终端执行以下命令：

     1
     docker pull docker.1ms.run/idootop/mi-gpt:latest
     

   • 看到镜像成功拉取的提示后，我们就可以进行最后一步了。

4. 注入环境变量并用 Docker 运行 Mi-GPT

   • 回到玩客云的SSH终端，准备执行最终的启动命令。请先将下面命令中的 <...> 部分，替换为你从 .env 文件中看到的值！
   • 执行下面这行 Docker 命令来启动 mi-gpt 服务：

     1
     docker run -d \
     2
       --name migpt \
     3
       --restart=always \
     4
       -v /root/mi-gpt/.migpt.js:/app/.migpt.js \
     5
       -v /root/mi-gpt/.mi.json:/app/.mi.json \
     6
       -e OPENAI_API_KEY="<你的API Key>" \
     7
       -e OPENAI_MODEL="<你的模型名称>" \
     8
       -e OPENAI_BASE_URL="<你的Base URL>" \
     9
       --net=host \
     10
       docker.1ms.run/idootop/mi-gpt:latest
     

   • 注意：我们运行的镜像是刚刚从国内镜像站拉取 docker.1ms.run/idootop/mi-gpt:latest。

5. 验证服务是否正常运行

   • 运行 docker ps，你应该能看到名为 migpt 的容器正在 Up 状态。
   • 运行 docker logs migpt，可以查看服务的实时日志。如果一切正常，这里会显示成功初始化、连接小米和AI服务的日志。

五、见证奇迹的时刻#

现在，所有配置都已完成。走到你的小爱音箱前，用你在 GUI 网站上设置的关键词来提问，享受拥有了真正 AI 大脑的智能音箱吧！