ai_fwt_pro/deployments/single-server-api

目标

在腾讯云（Ubuntu 22.04 x86_64）上仅部署 xiaozhi-esp32-server 的 Server 模块：

• ASR：百度（API）
• LLM：DeepSeek（API）
• TTS：EdgeTTS（无需 key）
• 无域名：直接使用 ws://公网IP:8000 和 http://公网IP:8003

注意：不要把任何真实 API Key/Secret 提交到公网仓库；也不要把 key 发到聊天里。

---

1) 服务器侧安全组/防火墙

放行端口：

• 8000/tcp（WebSocket）
• 8003/tcp（HTTP：OTA/视觉接口）

强烈建议：先只允许你自己的公网出口 IP（而不是全网开放）。

---

2) 拷贝文件到服务器

把本目录下这两个文件上传到服务器，例如：

• /opt/xiaozhi-server/docker-compose.yml
• /opt/xiaozhi-server/data/.config.yaml

目录结构应为：

/opt/xiaozhi-server
  docker-compose.yml
  data/
    .config.yaml

---

3) 修改配置

编辑 /opt/xiaozhi-server/data/.config.yaml：

• 把 PUBLIC_IP 改成你的公网 IP
• 填上百度 ASR、DeepSeek 的密钥

---

4) 启动/查看日志

在服务器执行：

cd /opt/xiaozhi-server
docker compose up -d
docker logs -f xiaozhi-esp32-server

---

5) ESP32 需要填的地址

• WebSocket：ws://PUBLIC_IP:8000/xiaozhi/v1/
• OTA：http://PUBLIC_IP:8003/xiaozhi/ota/

---

6) 排查命令（把输出贴出来即可）

docker ps
docker logs --tail 120 xiaozhi-esp32-server
ss -lntp | grep -E '(:8000|:8003)'
curl -sS -D- http://127.0.0.1:8000/ | head
curl -sS -D- http://127.0.0.1:8003/xiaozhi/ota/ | head