xiaozhi-esp32-server 部署指南：10 分钟一键搭建 ESP32 设备控制服务器

xiaozhi-esp32-server 部署指南10 分钟一键搭建 ESP32 设备控制服务器【免费下载链接】xiaozhi-esp32-server本项目为xiaozhi-esp32提供后端服务帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.项目地址: https://gitcode.com/gh_mirrors/xia/xiaozhi-esp32-serverxiaozhi-esp32-server 是 xiaozhi-esp32 智能硬件的后端服务负责设备接入、语音识别与大模型调用。项目自带一键安装脚本零基础也能在 10 分钟内完成整套服务端部署全程不用读代码。装完之后是什么样现在你想让 xiaozhi-esp32 设备说话、听话得自己配 Python、Docker、数据库和模型新手很容易中途卡住。跑完本文脚本后一台完整的服务端就在你机器上运行8000 端口接入设备、8003 端口提供视觉分析接口、8002 端口是智控台设备管理、模型配置都在网页里完成。动手前先自查这 4 件事检查项要求操作系统Debian 或 UbuntuX86 架构其他系统不支持运行权限root 权限网络能访问国内镜像源云服务器建议提前在安全组放行 8000、8001、8002 端口硬件至少 2GB 内存、10GB 左右可用磁盘部署主线从获取到完成第一步获取项目源码git clone https://gitcode.com/gh_mirrors/xia/xiaozhi-esp32-server cd xiaozhi-esp32-server第二步运行一键安装脚本chmod x docker-setup.sh ./docker-setup.sh弹出确认窗口选继续。安装脚本会自动检测环境缺 Docker 就用国内阿里云源帮你装好。第三步按提示选镜像源脚本会列出可选的 Docker 镜像源拿不准就选第一项选项说明轩辕镜像1推荐国内下载速度快腾讯云镜像源2稳定性好适合企业环境阿里云镜像源6覆盖范围广中科大 / 网易 / 华为云3/4/5备选自定义7/ 跳过8自己填地址或不配置第四步等待下载与启动脚本接着会下载 SenseVoiceSmall 语音识别模型、拉取服务镜像并启动服务端、智控台、MySQL、Redis 共 4 个容器。过程以下载为主耐心等即可。脚本自带 5 分钟启动状态检测看到安装完成和地址列表弹窗就是装好了。部署后验证两个动作确认成功打开智控台浏览器访问http://你的IP:8002注册账号。第一个注册的账号是超级管理员之后注册的是普通用户。登录后可在 参数字典 → 参数管理 找到server.secret参数按脚本提示把值填进去完成密钥配置。看容器日志执行docker logs -f xiaozhi-esp32-server-web出现Started AdminApplication in说明管理服务正常主服务用docker logs -f xiaozhi-esp32-server查看。常用地址IP 换成你的服务器地址WebSocketws://IP:8000/xiaozhi/v1/OTAhttp://IP:8002/xiaozhi/ota/视觉分析接口http://IP:8003/mcp/vision/explain常见问题速查现象处置拉镜像超时提示启动失败换个镜像源重新运行脚本即可脚本支持重复执行和升级服务启动超时5 分钟无响应用docker logs xiaozhi-esp32-server-web定位报错通常是网络问题换源重跑别的设备访问 8002 打不开云服务器在安全组放行 8000、8001、8002本机网络则检查防火墙中途按了 Esc 中断没有残留风险直接重新运行脚本已完成的步骤会自动跳过写在最后xiaozhi-esp32-server 的定位就是拿来即用的设备后端部署完直接接设备再进智控台配置 ASR、TTS 和大模型。后续想接入数字人、Home Assistant 或声纹识别参考部署文档按需扩展。【免费下载链接】xiaozhi-esp32-server本项目为xiaozhi-esp32提供后端服务帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.项目地址: https://gitcode.com/gh_mirrors/xia/xiaozhi-esp32-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考