1. JetLinks物联网平台入门指南第一次听说JetLinks简单来说它就像物联网界的乐高积木让你能快速搭建属于自己的物联网系统。作为国内开源的物联网平台JetLinks分为社区版和企业版我们今天要玩转的就是完全免费的社区版。我去年接手公司物联网项目时花了整整两周才把开发环境搭好。现在回想起来要是当时有这份指南至少能省下10天时间。JetLinks社区版虽然免费但功能一点都不含糊——设备管理、规则引擎、数据可视化这些核心功能全都有特别适合中小型物联网项目。2. 开发环境准备2.1 硬件与基础软件要求我的老款MacBook Pro16GB内存跑JetLinks完全没问题但建议至少满足8GB以上内存Elasticsearch比较吃内存20GB可用磁盘空间JDK 17重要JetLinks 2.1版本必须Node.js 16前端需要最近帮学弟配环境时发现Windows用户要特别注意路径不要有中文和空格管理员权限运行命令行关闭杀毒软件实时防护编译时经常误报2.2 数据库选型与安装JetLinks默认用PostgreSQL但国内开发者更习惯MySQL。我实测MySQL 8.0.28最稳定安装时注意# 创建数据库时一定要加这个参数 CREATE DATABASE jetlinks CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;配置文件修改有个坑r2dbc的连接字符串要这样写url: r2dbc:mysql://localhost:3306/jetlinks?sslfalseserverZoneIdAsia/Shanghai那个符号在YAML里要写成amp;否则启动直接报错。3. 后端项目部署实战3.1 代码获取与目录解析推荐用Gitee镜像仓库速度更快git clone https://gitee.com/jetlinks/jetlinks-community.git cd jetlinks-community git checkout v2.1.0 # 切换到稳定版项目结构很有意思jetlinks-standalone是单体启动模块jetlinks-components包含各种功能组件jetlinks-examples有现成的示例代码重点看jetlinks-standalone/src/main/resources/application.yml这是所有配置的核心。3.2 关键配置详解Redis配置有个性能优化技巧redis: host: 127.0.0.1 lettuce: pool: max-active: 32 # 根据你的并发量调整 max-wait: 500msElasticsearch新手建议先用内置的elasticsearch: embedded: enabled: true >yarn config set registry https://registry.npmmirror.com4.2 代理配置关键点修改vite.config.tsserver: { proxy: { /api: { target: http://localhost:8080, // 后端地址 changeOrigin: true } } }最近发现个隐藏功能启动时加--host参数可以让局域网访问yarn dev --host 0.0.0.04.3 常见编译问题遇到jetlinks-ui-components报错时先更新组件库yarn add jetlinks-ui-componentslatest强制重新构建yarn dev:force5. 平台初始化与验证启动成功后访问http://localhost:3000用默认账号admin/admin登录。第一次进入会提示初始化系统创建管理员账号建议修改配置邮件服务器可选设置系统基本信息在设备管理菜单新建一个虚拟设备试试设备类型选模拟设备添加一个温度属性在规则引擎里创建告警规则我去年做智能农业项目时就是先用这个模拟设备测试了整个业务流程再接入真实传感器省去了很多调试时间。6. 进阶配置与优化6.1 数据库连接池调优生产环境建议调整HikariCP配置spring: r2dbc: pool: max-size: 50 max-idle-time: 30m6.2 日志配置技巧在logback-spring.xml中添加logger nameorg.jetlinks levelDEBUG/这样可以看到更详细的业务日志。6.3 性能监控配置开启Actuator端点management: endpoints: web: exposure: include: *访问/actuator/metrics可以看到系统运行指标。7. 开发环境日常维护建议每天结束工作时停掉前端服务CtrlC后端服务可以保持运行定期清理Elasticsearch数据目录遇到奇怪的问题时试试这个清理组合拳mvn clean rm -rf node_modules rm -rf yarn.lock