78/xiaozhi-mqtt-gateway

├── app.js                # 主应用入口
├── mqtt-protocol.js      # MQTT协议实现
├── ecosystem.config.js   # PM2配置文件
├── package.json          # 项目依赖
├── .env                  # 环境变量配置
├── utils/
│   ├── config-manager.js # 配置管理工具
│   ├── mqtt_config_v2.js # MQTT配置验证工具
│   └── weixinAlert.js    # 微信告警工具
└── config/               # 配置文件目录

git clone <仓库地址>
cd mqtt-websocket-bridge

npm install

mkdir -p config
cp config/mqtt.json.example config/mqtt.json

{
  "debug": false,
  "development": {
    "mac_addresss": ["aa:bb:cc:dd:ee:ff"],
    "chat_servers": ["wss://dev-chat-server.example.com/ws"]
  },
  "production": {
    "chat_servers": ["wss://chat-server.example.com/ws"]
  }
}

MQTT_PORT=1883       # MQTT服务器端口
UDP_PORT=8884        # UDP服务器端口
PUBLIC_IP=your-ip    # 服务器公网IP

# 直接运行
node app.js

# 调试模式运行
DEBUG=mqtt-server node app.js

# 安装PM2
npm install -g pm2

# 启动服务
pm2 start ecosystem.config.js

# 查看日志
pm2 logs xz-mqtt

# 监控服务
pm2 monit

{
  "type": "hello",
  "version": 3,
  "audio_params": { ... },
  "features": { ... }
}

{
  "type": "hello",
  "version": 3,
  "session_id": "uuid",
  "transport": "udp",
  "udp": {
    "server": "server-ip",
    "port": 8884,
    "encryption": "aes-128-ctr",
    "key": "hex-encoded-key",
    "nonce": "hex-encoded-nonce"
  },
  "audio_params": { ... }
}

# 启用所有调试输出
DEBUG=* node app.js

# 只启用MQTT服务器调试
DEBUG=mqtt-server node app.js