xiaozhi-esp32-server Docker部署入门在Ubuntu服务器上启动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 系列智能设备的后端服务它承担语音活动检测、语音识别、大模型对话与语音合成的完整链路设备通过 WebSocket 接入服务端模型与设备信息都可以在管理后台中维护。本文演示最常见的部署路径——在 x86 的 Ubuntu/Debian 服务器上运行项目根目录的安装脚本 docker-setup.sh并说明到哪些算完成镜像拉取、容器启动、拿到智控台地址、验证主要服务端口。先判断部署方式适合什么场景与系统先给结论目标是 x86 架构的 Ubuntu/Debian 服务器时项目自带安装脚本是最省事的路径否则应改选手动部署或源码部署。系统脚本仅支持 Debian/Ubuntu其他发行版未测试配套 Docker 镜像只支持 x86 架构权限需要 root 权限运行脚本检测到权限不足会直接退出网络需能访问国内 apt/Docker 镜像源与魔搭模型仓库场景适合从零搭建设备后端脚本会自检是否已安装已安装时会提示走升级流程升级前会备份旧配置如果你的是 ARM 服务器或只想在本地 Python 环境运行核心服务请参考 docs/Deployment.md 中的手动部署与源码部署章节环境准备脚本替你完成的检查清单环境不需要你提前全部备好脚本会逐项检查并补齐下面列出它的动作和应关注的结果检查项脚本行为预期结果基础依赖apt 安装 whiptail、curl 等终端能弹出菜单式选择Docker未安装时经阿里云 apt 源安装已安装则跳过docker --version有版本输出镜像源提供轩辕、腾讯云、中科大、网易、华为云、阿里云、自定义等选项原有 daemon.json 先备份后续容器镜像拉取速度可接受目录创建 /opt/xiaozhi-server 及 data、models 子目录配置与模型有存放位置模型文件下载 SenseVoiceSmall 的 model.pt 到 models/SenseVoiceSmall默认离线语音识别可用最小化部署三步启动服务第一步获取源码并准备脚本git clone https://gitcode.com/gh_mirrors/xia/xiaozhi-esp32-server cd xiaozhi-esp32-server chmod x docker-setup.sh第二步以 root 权限运行脚本./docker-setup.sh第三步按菜单提示选择镜像源等待镜像拉取与容器启动。全量版本包含核心服务、管理后台、数据库、缓存等多个容器脚本会自动等待管理后台容器打印启动成功日志后才继续。预期结果脚本最后弹出管理后台、OTA、WebSocket 等地址清单说明服务已运行。如何确认服务已启动先打开智控台浏览器访问http://服务器IP:8002第一个注册的账号是超级管理员之后注册的都是普通用户建议注册时就用好长期使用的账号。再查核心服务日志docker logs -f xiaozhi-esp32-server日志中出现以“OTA接口是”“Websocket地址是”开头的行核心服务即启动成功。注意 docker 日志里的 IP 是容器内网地址对外地址以服务器实际局域网 IP 为准。然后在设备端填入服务地址脚本结尾会列出WebSocket 地址ws://服务器IP:8000/xiaozhi/v1/OTA 地址http://服务器IP:8002/xiaozhi/ota/管理后台http://服务器IP:8002视觉分析接口http://服务器IP:8003/mcp/vision/explain云服务器需要在安全组放行 8000、8001、8002 端口。另外安装过程中脚本会引导你登录智控台在“参数字典 → 参数管理”找到参数编码 server.secret 并粘贴密钥脚本会写入配置并重启核心服务当时若留空跳过之后可按同样方式补配。常见卡点按顺序排查出问题时建议按“容器状态 → 日志 → 网络 → 配置”的顺序推进避免盲目重装。脚本提示系统或权限错误先确认是 Ubuntu/Debian 且当前为 root 用户。镜像拉取超时脚本会提示更换镜像源重新执行并另选一个或手动修改 /etc/docker/daemon.json 调整 registry-mirrors。模型下载失败检查到魔搭仓库的连通性重新执行脚本即可已存在的文件会被跳过、只补下载缺失部分。管理后台长时间没起来脚本最多等 300 秒可用docker logs xiaozhi-esp32-server-web单独查看管理后台容器的日志。浏览器打不开 8002先用docker ps确认各容器都在运行再检查防火墙或安全组是否放行。后续入口配置位置与扩展文档服务跑起来之后配置主要有两个入口服务端配置文件/opt/xiaozhi-server/data/.config.yaml用于修改模型选择、API 密钥等内容智控台“参数字典 → 参数管理”管理 server.secret 等参数更多能力从以下文档进入docs/Deployment.md 手动部署与版本升级流程docs/FAQ.md 常见问题docs/firmware-setting.md 固件端配置服务器地址docs/mqtt-gateway-integration.md 开启 MQTTUDP 通道docs/voiceprint-integration.md 与 docs/ali-sms-integration.md 分别对应声纹识别与手机号注册docs/performance_tester.md 用于测试各组件速度。【免费下载链接】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），仅供参考