Back to Home
xinnan-tech icon

xiaozhi-esp32-server

Verified Safe

by xinnan-tech

Overview

This project provides a comprehensive backend service for ESP32-based intelligent terminal devices, enabling AI interaction, device control, voice recognition, and managing various smart features through MQTT, Websocket, and custom MCP protocols.

Installation

Run Command
docker-compose up --build -d

Environment Variables

  • VUE_APP_PUBLIC_PATH
  • VUE_APP_USE_CDN
  • VUE_APP_API_BASE_URL
  • VITE_SERVER_BASEURL
  • VITE_UPLOAD_BASEURL
  • VITE_LOGIN_URL
  • XIAOZHI_CONFIG_FILE
  • XIAOZHI_MODEL_DIR
  • OPENAI_API_KEY
  • ALIYUN_ACCESS_KEY_ID
  • TENCENT_SECRET_ID
  • GEMINI_API_KEY
  • COZE_PERSONAL_ACCESS_TOKEN
  • HOME_ASSISTANT_API_KEY

Security Notes

The system demonstrates strong security practices including XSS/SQL injection filtering, Shiro for authentication/authorization, and explicit token generation for WebSocket connections. The use of `JSON.parse` on configuration data retrieved from the backend (which typically requires super admin privileges to modify) and base64 encoding of device IP for internal WebSocket usernames are noted, but do not appear to be critical remote vulnerabilities under normal operating conditions given the existing security layers. Secure handling of API keys for integrated AI services is crucial and expected to be managed via environment variables or secure configuration.

Similar Servers

Stats

Interest Score100
Security Score8
Cost ClassHigh
Avg Tokens800
Stars8321
Forks2843
Last Update2026-01-19

Tags

AI BackendESP32IoTVoice RecognitionMQTTWebsocket