欢迎使用联犀物联网平台！本部分将帮助您快速上手，从安装部署到设备接入的完整流程。

📋 目录概览

安装教程

• Docker Compose模式 - 推荐方式，一键部署
  • MariaDB完整性能模式
  • PostgreSQL完整性能模式
  • 最少依赖模式（企业版）
• 源码安装模式 - 开发环境部署
  • 环境准备和依赖安装
  • 配置修改和运行
  • GoLand调试方法

产品开发

• 创建第一个产品
• 配置物模型
• 设置设备认证方式
• 产品参数配置

设备接入指引

• 设备接入流程
• 认证方式选择
• 数据上报格式
• 设备控制方法

监控告警

• 系统监控配置
• 告警规则设置
• 通知方式配置
• 监控面板使用

EMQX配置方法

• EMQX安装配置
• 认证插件配置
• 集群部署配置
• 性能优化建议

🎯 新手入门路径

第一步：环境准备

1. 选择部署方式

   • 生产环境：推荐Docker Compose模式
   • 开发环境：推荐源码安装模式
   • 体验环境：推荐最少依赖模式

2. 系统要求

   • 操作系统：Linux/Windows/macOS
   • 内存：最低2GB，推荐8GB+
   • 存储：最低20GB，推荐100GB+
   • 网络：需要访问外网下载依赖

第二步：平台部署

1. 下载代码

   git clone https://gitee.com/unitedrhino/things.git
   cd things

2. 选择安装方式

   • Docker方式：cd deploy/docker/run-all && docker compose up -d
   • 源码方式：按照安装教程操作

3. 验证部署

   • 访问：http://localhost:7777
   • 账号：administrator
   • 密码：iThings666

第三步：创建产品

1. 登录管理后台
2. 创建租户和项目
3. 创建产品并配置物模型
4. 创建设备并获取认证信息

第四步：设备接入

1. 根据设备类型选择接入方式
2. 配置设备认证信息
3. 实现数据上报和控制逻辑
4. 验证设备连接和数据传输

💡 常见问题

安装问题

• Docker镜像拉取失败：配置代理或使用国内镜像源
• 端口冲突：检查7777、3306、6379等端口是否被占用
• 内存不足：至少需要2GB内存，推荐8GB以上

配置问题

• 数据库连接失败：检查数据库服务是否启动
• MQTT连接失败：检查EMQX配置和网络连接
• 设备认证失败：检查设备密钥和产品ID配置

开发问题

• Go模块下载失败：配置GOPROXY代理
• 前端编译失败：检查Node.js版本和依赖
• API调用失败：检查接口地址和认证信息

🔧 开发工具

推荐工具

• IDE：GoLand、VSCode
• API测试：Postman、Insomnia
• MQTT测试：MQTTX、MQTT Explorer
• 数据库管理：Navicat、DBeaver

调试技巧

• 使用GoLand调试后端服务
• 查看日志文件排查问题
• 使用MQTT客户端测试设备连接
• 通过API文档测试接口功能

---

提示

建议新手从Docker Compose模式开始，这样可以快速体验平台功能，后续再根据需要选择其他部署方式。

注意

生产环境部署前，请仔细阅读安全配置和性能优化相关文档。