Repository files navigation

基于Xiaozhi ESP32 项目开发的 Java 版本服务端，包含完整前后端管理平台
为智能硬件设备提供强大的后端支持和直观的管理界面

反馈问题 ·部署文档 ·更新日志

如果这个项目对您有帮助，请考虑给它一个 ⭐ Star！
您的支持是我们持续改进的动力！

Xiaozhi ESP32 Server Java 是基于Xiaozhi ESP32 项目开发的 Java 版本服务端，包含完整的前后端管理平台。该项目旨在为用户提供一个功能丰富、操作便捷的管理界面，帮助用户更好地管理设备、配置等。

考虑到企业级应用场景的需求，Java 作为一种成熟的企业级开发语言，具备更完善的生态系统支持和更强大的并发处理能力，因此我们选择开发这个 Java 版本的服务端，为项目提供更多可能性和扩展空间。

• 后端框架：Spring Boot + Spring MVC
• 前端框架：Vue.js + Ant Design
• 数据存储：MySQL + Redis
• 全局响应式：适配各种设备及分辨率

如果您已经购买了 ESP32 相关硬件，且希望通过一个功能完善、界面友好的管理平台来控制和管理您的设备，那么本项目非常适合您。特别适合：

• 需要企业级稳定性的用户
• 个人开发者，希望快速搭建使用的用户
• 希望有完整前端管理界面的用户
• 需要更强大数据管理和分析能力的用户
• 对系统扩展性有较高要求的用户
• 需要支持大量设备并发连接的场景
• 对实时数据处理有高要求的应用场景

设备管理 - 全面管理和监控所有连接设备	消息记录 - 查看和搜索历史对话内容
音色克隆 - 克隆自己的声音，实现个性化语音助手	MCP服务 - SSE MCP服务管理，管理MCP工具

登录界面	仪表盘	智能体	模型配置	固件升级	角色管理
MCP工具	会员管理	权益管理	语音识别	语音合成

_{💡 点击缩略图查看大图}

我们提供了多种部署方式，以满足不同用户的需求：

• Windows部署文档 - 适合Windows环境开发和测试
• CentOS部署文档 - 适合Linux服务器环境部署

成功运行后，控制台会输出 OTA 和 WebSocket 连接地址，根据固件编译文档使设备接入服务使用。

• Docker部署文档 - 快速容器化部署方案

• 固件编译文档 - 详细的固件编译和烧录过程

烧录成功且联网成功后，通过唤醒词唤醒小智，留意后端控制台输出的信息。

我们开发了专门的 WebSocket 并发测试工具Xiaozhi Concurrent，用于评估系统的性能和稳定性。测试工具支持模拟大量设备同时连接，测试完整的 WebSocket 通信流程，并生成详细的性能报告和可视化图表。

📖 测试工具的详细使用说明、安装步骤和参数配置请查看：Xiaozhi Concurrent 仓库

以下测试数据基于腾讯云服务器（8核8G，100M按量付费带宽） 环境，100个设备、100并发连接、持续5轮 对话测试：

并发测试数据可视化 - 时延分布与性能指标统计

我们接受各种项目开发，如果您有特定需求或对商业版本感兴趣，欢迎通过微信联系洽谈。

欢迎任何形式的贡献！如果您有好的想法或发现问题，请通过以下方式联系我们：

欢迎加入我们的Wechat群一起交流讨论

欢迎加入我们的QQ群一起交流讨论，QQ群号：790820705

本项目仅提供技术实现代码，不提供任何媒体内容。用户在使用相关功能时应确保拥有合法的使用权或版权许可，并遵守所在地区的版权法律法规。

项目中可能涉及的示例内容或资源均来自网络或由用户投稿提供，仅用于功能演示和技术测试。如有任何内容侵犯了您的权益，请立即联系我们，我们将在核实后立即采取删除等处理措施。

本项目开发者不对用户使用本项目代码获取或播放的任何内容承担法律责任。使用本项目即表示您同意自行承担使用过程中的全部法律风险和责任。