# IOT Manager

**Repository Path**: cccc3412/iot-manager

## Basic Information

- **Project Name**: IOT Manager
- **Description**: 使用cursor ai实现的IOT mqtt管理服务端，包含前端和后端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-09-07
- **Last Updated**: 2025-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IoT Manager 项目

## 快速部署指南

### 使用Docker一键部署

1. 创建环境配置文件（如需自定义端口）
   ```bash
   cp .env.example .env
   ```

2. 修改.env文件中的端口配置（可选）

3. 赋予部署脚本执行权限
   ```bash
   chmod +x deploy.sh
   ```

4. 运行部署脚本
   ```bash
   ./deploy.sh
   ```

5. 访问服务
   - 前端: http://<服务器IP>:${PORT_FRONTEND:-80}
   - 后端API: http://<服务器IP>:${PORT_BACKEND:-3001}
   - MQTT: tcp://<服务器IP>:${PORT_MQTT:-1883}

## 端口配置指南

### 验证方法
```bash
# 检查服务状态
docker-compose ps

# 测试API访问
curl http://localhost:3002/api/health
```

> 注意：修改配置后需确保防火墙开放对应端口，并更新监控系统中的端口配置

## MQTT连接指南

### 连接参数
- **协议**: MQTT 3.1.1/5.0
- **地址**: tcp://<服务器IP>:${PORT_MQTT:-1883}
- **WebSocket地址**: ws://<服务器IP>:${PORT_MQTT_WEBSOCKET:-8083}

### 主题规则
| 主题类型 | 格式示例 |
|---------|----------|
| 设备数据 | `device/data/{deviceId}` |
| 控制指令 | `device/control/{deviceId}` |

### 客户端示例
```bash
# 订阅设备数据
mosquitto_sub -h <服务器IP> -p ${PORT_MQTT:-1883} -t "device/data/+" -v
```

### 安全建议
1. 启用TLS加密（配置见`mosquitto.conf`）
2. 限制IP白名单
3. 避免通配符订阅`/#`

## 环境变量说明
| 变量名            | 默认值  | 说明                  |
|-------------------|---------|-----------------------|
| PORT_FRONTEND     | 80      | 前端服务端口          |
| PORT_BACKEND      | 3001    | 后端服务端口          |
| PORT_MQTT         | 1883    | MQTT服务端口          |
| PORT_MQTT_WEBSOCKET | 8083  | MQTT WebSocket端口    |
| PORT_MONGODB      | 27017   | MongoDB服务端口       |