项目地址：xiaozhi-esp32-server

通过运行xiaozhitest中的html来测试
也可以用网页 http://xiaozhi.nbzch.cn:5008/ 来测试，不过需要允许不安全的语音

1. 打开Chrome/edge浏览器，输入以下地址：

chrome/edge://flags/#unsafely-treat-insecure-origin-as-secure

1. 将“unsafely-treat-insecure-origin-as-secure”选项设置为“Enabled”。
2. 在输入框中输入需要访问的地址，多个地址使用逗号隔开。
3. 点击右下角弹出的“Relaunch”按钮，浏览器将自动重启。

小智ESP32服务器部署指南

一、环境准备

系统要求

• Windows：需安装 Git Bash/WSL/PowerShell/CMD
• Linux/macOS：需终端环境
• 注意：确保可访问 GitHub 和 Docker Hub

二、一键部署脚本

# 下载部署脚本
curl -L -o docker-setup.sh https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/main/docker-setup.sh

# 执行脚本（按系统选择）
## Windows（Git Bash/WSL）
sh docker-setup.sh

## Windows（PowerShell/CMD）
.\docker-setup.sh

## Linux/macOS
chmod +x docker-setup.sh && ./docker-setup.sh

脚本自动执行：

1. 创建目录结构
2. 下载语音识别模型
3. 获取配置文件
4. 文件完整性校验

三、核心配置说明

1. API密钥配置

部署完成后按提示配置ChatGLM密钥（官网注册）

2. 模块配置（.config.yaml）

selected_module:
  VAD: SileroVAD       # 语音活动检测
  ASR: FunASR          # 语音识别
  LLM: ChatGLMLLM      # 大语言模型（默认免费版）
  TTS: EdgeTTS         # 文本转语音
  Memory: nomem        # 记忆模块（默认关闭）
  Intent: nointent     # 意图识别（默认关闭）

3. LLM模块切换

建议：默认使用免费版glm-4-flash，如需更高性能可切换付费方案

四、服务启动

# 启动容器
docker-compose up -d

# 查看实时日志
docker logs -f xiaozhi-esp32-server

成功标志：日志显示Application startup complete

五、版本升级流程

1. 配置备份

   cp data/.config.yaml config_backup.yaml

2. 清理旧版本

   docker stop xiaozhi-{server,server-web} && docker rm xiaozhi-{server,server-web}
   docker rmi ghcr.nju.edu.cn/xinnan-tech/xiaozhi-esp32-server:{server_latest,web_latest}

3. 重新部署

   ./docker-setup.sh && docker-compose up -d

六、常见问题

Q：脚本执行报错Permission denied
A：执行chmod +x *.sh添加执行权限

Q：Docker镜像拉取失败
A：检查镜像源配置或尝试docker login ghcr.nju.edu.cn

Q：ChatGLM接口报错401
A：确认API密钥已正确配置到.config.yaml