5分钟快速部署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-server想要为你的ESP32设备搭建专属的智能语音交互系统吗小智ESP32服务器xiaozhi-esp32-server正是你需要的解决方案。这个开源项目专门为ESP32智能硬件提供完整的后端服务通过容器化技术让你在几分钟内就能构建功能强大的语音控制平台。无论你是智能家居开发者、物联网爱好者还是AI语音技术研究者本指南都将带你从零开始轻松掌握ESP32服务器容器化部署的核心技巧。 为什么选择容器化部署在开始之前你可能想知道为什么要选择容器化部署方式。简单来说容器化是现代应用部署的最佳实践特别是对于像小智ESP32服务器这样的复杂系统。通过Docker容器化你可以获得环境一致性开发、测试、生产环境完全一致告别在我电脑上能运行的问题快速部署从下载到运行只需几分钟大幅缩短部署时间易于维护一键更新、回滚和扩展运维工作变得轻松资源隔离避免依赖冲突提高系统稳定性跨平台运行支持x86和arm64架构适应不同硬件环境 两种部署方案总有一款适合你小智ESP32服务器提供了两种部署方式你可以根据自己的技术水平和需求选择最合适的方法。方案一懒人一键脚本推荐新手如果你是第一次接触容器化部署或者希望用最简单的方式快速上手这个一键脚本是你的最佳选择。# 使用root权限执行部署脚本 sudo bash -c $(wget -qO- https://ghfast.top/https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/main/docker-setup.sh)这个脚本会自动完成以下所有操作检查并安装Docker环境配置优化的镜像源下载所有必需的Docker镜像下载语音识别模型文件引导式配置向导服务自动启动与验证上图展示了完整的系统架构包含语音识别(ASR)、大语言模型(LLM)、语音合成(TTS)、设备管理等多个核心模块方案二手动精细部署适合进阶用户如果你希望更精细地控制部署过程或者需要定制化配置可以按照以下步骤手动部署。步骤1准备项目目录首先创建项目目录结构# 创建项目目录 mkdir -p xiaozhi-server/data mkdir -p xiaozhi-server/models/SenseVoiceSmall步骤2下载配置文件进入项目目录并下载必要的配置文件cd xiaozhi-server wget https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/refs/heads/main/main/xiaozhi-server/docker-compose_all.yml wget -O data/.config.yaml https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/refs/heads/main/main/xiaozhi-server/config_from_api.yaml步骤3下载语音识别模型语音识别是小智ESP32服务器的核心功能需要下载SenseVoiceSmall模型方式一从阿里魔搭下载wget -O models/SenseVoiceSmall/model.pt https://modelscope.cn/models/iic/SenseVoiceSmall/resolve/master/model.pt方式二百度网盘下载链接https://pan.baidu.com/share/init?surlQlgM58FHhYv1tFnUT_A8Sg提取码qvna步骤4启动所有服务使用docker compose启动所有服务# 启动所有服务 docker compose -f docker-compose_all.yml up -d # 查看服务状态 docker ps # 查看日志输出 docker logs -f xiaozhi-esp32-server-web简化版部署架构适合资源有限的场景 核心配置详解让系统发挥最佳性能成功部署只是第一步合理的配置才能让系统发挥最佳性能。小智ESP32服务器采用分层配置设计优先级从高到低为用户自定义配置 默认配置文件。关键配置项说明1. 服务器基础配置server: ip: 0.0.0.0 # 监听地址 port: 8000 # WebSocket服务端口 http_port: 8003 # HTTP服务端口2. AI模型提供商选择系统支持多种AI模型你可以根据需求灵活选择功能模块免费方案付费方案推荐特点说明语音识别(ASR)FunASR本地讯飞流式ASR实时识别准确率高大语言模型(LLM)智谱GLM-4阿里百炼Qwen支持长文本理解能力强语音合成(TTS)灵犀流式TTS火山流式TTS音质自然支持多种音色视觉模型(VLLM)智谱ChatGLM阿里百炼Qwen-VL支持图像理解3. 管理API配置manager-api: url: http://xiaozhi-esp32-server-web:8002/xiaozhi secret: your-server-secret-key # 从智控台获取️ 智控台配置三步完成系统初始化部署完成后你需要通过智控台完成系统初始化配置。第一步访问智控台打开浏览器访问http://你的服务器IP:8002你会看到登录界面。第一个注册的用户将自动成为超级管理员拥有所有管理权限。环境配置是成功部署的第一步第二步获取服务器密钥登录智控台后按照以下步骤获取服务器密钥进入参数管理页面找到参数编码server.secret复制参数值到你的配置文件第三步配置WebSocket和OTA地址在参数管理中配置两个关键地址WebSocket地址找到server.websocket输入ws://你的IP:8000/xiaozhi/v1/OTA地址找到server.ota输入http://你的IP:8002/xiaozhi/ota/在手机端配置OTA地址的界面 ESP32设备连接让硬件活起来配置好服务器后接下来要让ESP32设备连接到你的服务器。固件烧录与配置小智ESP32服务器支持两种设备连接方式方式一使用预编译固件推荐下载虾哥编译的1.6.1版本固件通过串口工具烧录到ESP32设备在设备Wi-Fi设置中配置OTA地址方式二自定义编译固件克隆ESP32固件源码修改服务器地址配置使用PlatformIO或Arduino IDE编译烧录设备连接验证配置完成后通过以下命令验证设备连接状态# 查看设备连接状态 docker logs -f xiaozhi-esp32-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请用谷歌浏览器打开test目录下的test_page.html️ 高级功能配置打造个性化语音助手基础功能运行稳定后你可以根据需求进行高级配置打造专属的智能语音助手。语音识别优化配置asr: provider: fun_local # 可选的ASR提供商 model_path: models/SenseVoiceSmall/model.pt language: zh # 支持多语言zh, en, ja, ko, yue大语言模型切换根据你的需求选择合适的LLM提供商llm: provider: openai api_key: your-api-key base_url: https://api.openai.com/v1 model: gpt-4语音合成个性化tts: provider: aliyun_stream voice: zhitian_emo # 语音风格 speed: 1.0 # 语速调整 pitch: 1.0 # 音调调整 监控与维护确保系统稳定运行部署完成后定期的监控和维护是确保系统长期稳定运行的关键。服务状态监控# 查看所有容器状态 docker ps -a # 查看服务日志 docker logs xiaozhi-esp32-server docker logs xiaozhi-esp32-server-web # 查看资源使用情况 docker stats数据备份策略定期备份可以防止数据丢失# 备份数据库 docker exec xiaozhi-esp32-server-db mysqldump -u root -p123456 xiaozhi_esp32_server backup.sql # 恢复数据库 docker exec -i xiaozhi-esp32-server-db mysql -u root -p123456 xiaozhi_esp32_server backup.sql版本升级流程当有新版本发布时按以下步骤安全升级# 停止旧版本服务 docker compose -f docker-compose_all.yml down # 拉取最新镜像 docker pull ghcr.nju.edu.cn/xinnan-tech/xiaozhi-esp32-server:server_latest docker pull ghcr.nju.edu.cn/xinnan-tech/xiaozhi-esp32-server:web_latest # 启动新版本 docker compose -f docker-compose_all.yml up -d 常见问题排查遇到问题不慌张即使按照教程操作也可能遇到一些问题。以下是常见问题的解决方案。问题1服务启动失败症状容器无法启动或立即退出解决方案# 查看详细错误日志 docker logs xiaozhi-esp32-server --tail 100 # 检查端口占用 netstat -tlnp | grep :8000 netstat -tlnp | grep :8002 # 重启Docker服务 sudo systemctl restart docker问题2语音识别不准确症状ASR识别结果错误率高解决方案检查模型文件是否完整下载调整ASR提供商配置检查音频采样率和格式问题3WebSocket连接失败症状ESP32设备无法连接到服务器解决方案确认防火墙设置开放8000端口检查WebSocket地址配置是否正确验证网络连通性更多常见问题请参考官方文档docs/FAQ.md 部署成功验证三步确认一切正常完成所有配置后通过以下三个步骤验证部署是否成功智控台访问测试打开浏览器访问http://你的IP:8002成功登录管理界面WebSocket连接测试使用浏览器打开test/test_page.html测试音频交互功能ESP32设备连接测试配置ESP32设备验证设备连接状态成功配置环境后的终端界面 性能优化建议让系统跑得更快硬件资源配置建议资源类型最低配置推荐配置说明CPU2核4核以上多核有利于并发处理内存4GB8GB以上大内存提升模型加载速度存储10GB50GB以上SSD硬盘性能更佳网络10Mbps100Mbps以上稳定低延迟的网络连接软件优化配置启用GPU加速如有NVIDIA GPU配置CUDA支持调整线程数根据CPU核心数调整并发线程启用缓存合理配置Redis缓存策略数据库优化定期清理历史数据建立合适索引 扩展与定制打造专属智能系统小智ESP32服务器采用模块化设计支持多种扩展方式让你可以根据需求打造专属的智能系统。插件系统开发你可以在plugins_func/functions/目录中添加新的功能模块扩展系统功能。自定义AI模型集成通过修改core/providers/目录下的相应配置文件可以集成新的ASR、LLM、TTS等AI模型。设备协议扩展系统支持MQTTUDP、WebSocket等多种通信协议你可以根据需求扩展新的设备接入协议。 深入学习资源成为ESP32专家官方文档资源完整部署文档docs/Deployment_all.md - 包含所有部署细节常见问题解答docs/FAQ.md - 解决部署过程中的各种问题固件配置指南docs/firmware-setting.md - ESP32设备配置详细说明源码结构理解为了更好地定制系统了解源码结构很有帮助核心服务main/xiaozhi-server/- Python后端服务处理语音识别、自然语言理解等核心功能管理APImain/manager-api/- Java管理接口提供设备管理和用户管理功能Web界面main/manager-web/- Vue.js管理界面可视化配置系统移动端main/manager-mobile/- 移动端应用随时随地管理设备社区与支持GitHub仓库提交问题和功能请求技术交流群关注项目README获取社区联系方式视频教程在B站搜索小智ESP32获取视频教程 总结开启智能语音之旅通过本指南你已经掌握了小智ESP32服务器的完整容器化部署流程。从环境准备到服务配置从设备连接到性能优化每个步骤都为你提供了详细的操作指导。记住成功的部署不仅仅是让服务运行起来更重要的是理解系统架构、掌握配置方法、建立监控机制。随着你对系统的深入了解你将能够根据实际需求进行定制化开发和性能调优。现在你已经拥有了一个功能完整的智能语音交互系统。无论是用于智能家居控制、物联网设备管理还是AI语音技术研究这个系统都能为你提供强大的支持。祝你在智能语音技术的道路上越走越远享受技术带来的便利与乐趣下一步行动建议按照教程完成基础部署连接一个ESP32设备进行测试尝试配置不同的AI模型提供商探索插件开发添加自定义功能加入社区分享你的使用经验开始你的智能语音之旅吧【免费下载链接】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），仅供参考
