操作场景
小智 AI 服务端基于小智通信协议，为开源智能硬件项目 xiaozhi-esp32提供后端技术支撑。该服务端支持 AI 推理服务与 API 应用的快速部署，可为 xiaozhi-esp32硬件项目提供稳定可靠的运行保障，确保其全链路高效顺畅运作。
该应用模板预置了 xiaozhi-esp32-server，基于 Ubuntu 24.04 LTS 64bit 操作系统构建。
部署小智 AI 服务端
创建小智 AI 服务端实例
1. 登录 轻量应用服务器控制台，在服务器页面单击新建。或直接访问 轻量应用服务器购买页。
2. 在轻量应用服务器购买页面，选择所需配置完成轻量应用服务器购买。
应用创建方式：选择为使用应用模板 > 小智 AI 服务端，建议购买内存配置 4GB 及以上，其他参数可参见 购买方式 进行配置。
地域：建议优先选择小智 AI 服务端使用者当前所在地或网络环境最优的区域，以降低网络延迟、提升本地访问速度。
可用区：默认勾选随机分配，也可自行选择可用区。
注意:
推荐您选择“随机分配”可用区，同一地域不同可用区间的实例可通过内网互访。同地域下不同可用区间可实现故障隔离，若您的应用对于容灾能力有极高的要求，则可将不同实例部署在同一地域下的不同可用区内。但需注意不同实例跨可用区通信的时延较同一可用区会有一定增加。
实例创建成功后，不支持更换可用区。
实例套餐：产品组合售卖方式（包含套餐类型、套餐规格），不同套餐包含不同规格 CPU、内存、SSD 云硬盘、带宽或峰值带宽、流量包的组合。详情请参见 基础套餐。
服务器名称：自定义实例名称，若不填则默认使用所选镜像名称。批量创建实例时，连续命名后缀数字自动升序。例如，填入名称为 LH，数量选择3，则创建的3个实例名称为 LH1、LH2、LH3。
登录方式：您可通过该项设置实例的登录方式。
密码登录：
自动生成密码：自动生成的密码将会以站内信方式发送。
自定义密码：自定义设置实例的登录密码。
SSH密钥：为 Linux 实例绑定 SSH 密钥。
扫码登录：设置后支持通过微信扫码免密码登录 Linux 实例。
自动续费：按照实际需求配置即可。
共享存储：您可以选择实例创建过程中购买共享存储超值资源包，将自动挂载默认对象存储桶，详情请参见 介绍。注意事项如下：
2023年10月17日之后购买的实例，可以选择是否购买共享存储超值资源包，之前购买的实例可在 对象存储控制台 购买套餐包。
当前地域下已有生效共享存储超值资源包，后续购买实例时您可直接选择一键挂载存储桶，不会再提供共享存储超值资源包。
目前仅应用模板和操作系统镜像中的 Linux 镜像支持共享存储。
时长：表示轻量应用服务器的使用时长。
说明:
台数：表示需购买轻量应用服务器的数量。
3. 单击立即购买，并根据页面提示提交订单完成支付。
4. 返回轻量应用服务器控制台。
5. 待实例创建完成后，单击实例卡片，进入该实例的详情页，即可进行后续操作。
配置小智 AI 服务端
1. 选择应用管理页签，单击访问智控台地址 (端口8002已默认放通)。
2. 单击新用户注册，进入注册页面，输入用户信息后单击立即注册。
3. 注册成功后，页面会自动跳转至登录界面，输入刚刚注册的用户名和密码，输入验证码，单击登录。
4.
在顶部菜单栏选择参数字典 > 参数管理，在列表中找到参数编码 server.secret，复制参数值。
5. 返回轻量应用服务器控制台，登录目标服务器实例。详细登录步骤您可以参见 使用 OrcaTerm 登录 Linux 实例。
6. 单击左上角
/home/lighthouse/xiaozhi-server/data，单击进入。说明：
本文档使用 OrcaTerm 进行操作，您也可以选择其他方式登录终端。
7. 单击右上角
.config.yaml。单击文件名打开文件。
8. 将
.config.yaml中的 secret 修改为 步骤4 中复制的参数值，将 URL 改为 http://xiaozhi-esp32-server-web:8002/xiaozhi。
9. 登录智控台，在顶部菜单栏单击模型配置，在左侧选择大语言模型，在智谱 AI 右侧单击修改， 将 API 密钥改为您自己注册的智谱 AI 密钥，单击保存。
说明：
小智 AI 服务端支持接入智谱 AI、DeepSeek、豆包、通义千问等大模型，本文档以智谱 AI 为例。
如果您尚未获取智谱 AI 密钥，请访问 智谱 AI 开放平台 获取。
如果您选择其他大语言模型，您可以前往对应模型的官网获取 API Key。
10. 在服务器终端/命令行中输入并执行以下命令，用于重启 xiaozhi-esp32-server 并查看容器日志。
docker restart xiaozhi-esp32-serverdocker logs -f xiaozhi-esp32-server
当输出以下格式信息时，表示 Server 启动成功。
25-02-23 12:01:09[core.websocket_server] - INFO - Websocket地址是 ws://xxx.xx.xx.xx:8000/xiaozhi/v1/25-02-23 12:01:09[core.websocket_server] - INFO - =======上面的地址是websocket协议地址，请勿用浏览器访问=======25-02-23 12:01:09[core.websocket_server] - INFO - 如想测试websocket请用谷歌浏览器打开test目录下的test_page.html25-02-23 12:01:09[core.websocket_server] - INFO - =======================================================
11. 在服务器页面中，选择并进入服务器实例详情页。
12. 选择防火墙页签，单击添加规则后放通8000端口。如下图所示：
13. 登录智控台，在顶部菜单栏单击参数字典 > 参数管理，在参数编码 server.websocket 的右侧单击编辑，将参数值修改为
ws://实例公网IP:8000/xiaozhi/v1/，单击保存。
14. 在参数编码 server.ota 的右侧单击编辑，将参数值修改为
http://实例公网IP:8002/xiaozhi/ota/，单击保存。
15. 访问 小智 AI 官方 GitHub 仓库，单击 libopus.js 和 test_page.html，将这两个文件下载到本地，并放到同一路径下。
