安装教程
docker-compose模式安装
docker模式需要提前安装好docker
docker安装(已安装跳过)
linux环境下安装说明-建议ubuntu及root权限(win或其他环境自行参考): docker安装(如果安装不上可以百度对应的系统的安装方式):
curl -sSL https://get.daocloud.io/docker | sh
sudo systemctl start docker联犀安装
- 首先
git clone https://gitee.com/unitedrhino/things.git获取最新的联犀 cd things/deploy/docker/run-all进入安装文件夹- 执行以下命令(二选一执行,win下可以在git bash中执行):
# mariadb模式
docker compose up -d
# pgsql模式
docker compose -f docker-compose-pg.yml up -d- 访问
127.0.0.1:7777体验联犀吧~
账号: administrator 密码: iThings666
源码安装模式
视频教程:
代码拉取
# 共享库(不修改可以不clone)
git clone https://gitee.com/unitedrhino/share.git
# 中台模块
git clone https://gitee.com/unitedrhino/core.git
# 物联网模块
git clone https://gitee.com/unitedrhino/things.gitgolang安装
参考: golang安装教程
注意: 安装的版本需要大于1.21
第三方依赖安装
后端组件
物理机安装方式需要自行安装以下组件:
- 高性能缓存:redis
- 高性能消息队列:nats
- 关系型数据库:mysql(请使用mariaDB或mysql5.7)或pgsql
- 微服务注册中心:etcd
- 云原生轻量级对象存储:minio
- 开源、高性能、云原生,极简的时序数据处理平台:tdengine
- 大规模可弹性伸缩的云原生分布式物联网MQTT消息服务器:emqx(默认配置支持5.x)
docker-compose安装:
cd things/docker/run-env进入安装文件夹- 执行以下命令(二选一执行,win下可以在git bash中执行):
# mariadb模式
docker compose up -d
# pgsql模式
docker compose -f docker-compose-pg.yml up -d配置修改
emqx配置修改
参考: emqx配置方法
运行
后端
# 运行core服务
cd core/server/apisvr
go mod download
go run .
# 另开一个窗口
# 运行物联网模块
cd things/server/apisvr
go mod download
go run .开发的时候涉及到多个库联动的时候建议使用go work来操作
- 在项目根路径下执行
go work init - 添加go的项目进go.work中,如下示例
go 1.21.4
use (
./core
./protocol-aliyun
./protocol-tencent
./protocol-wumei
./share
./things
)- 同步依赖
go work sync
这样就可以不使用replace就能修改依赖的仓库了
前端
开源版本前端运行
- 下载 前端压缩包
- 复制到静态文件的目录
mkdir -p core/service/apisvr/dist/app
cd core/service/apisvr/dist/app
tar -xvzf frontFile_latest.tgz
rm frontFile_latest.tgz
cd -体验
访问 127.0.0.1:7777 体验联犀吧~
goland调试方法
在goland中直接运行服务会报找不到配置文件,我们需要做一个配置,参考下图,点击上面的按钮,然后点击编辑配置,会出现下面的页面,将工作目录修改为服务的main函数所在的位置即可正常启动
视频教程
fqa
- 产品及设备创建报错:
- 请检查数据库是否创建成功
- 联犀请求tdengine是通过http的方式请求,参考官方文档检查td的服务是否启动: https://docs.taosdata.com/connector/rest-api/
- 设备在线状态在服务器上不正确或设备可以订阅任何topic:检查
emqx_auth_http.conf这个文件配置的ip是否正确 - 联犀启动不起来,报mqtt连接不上:同样需要检查
emqx_auth_http.conf这个文件配置的ip是否正确,emqx需要通过http来请求联犀进行认证 - docker镜像拉取不下来: 这种情况一般是网络原因导致的,需要配置代理,简单的方式是可以安装1panel来一键配置代理
- 运行不起来,things服务报错tdengine没有ithings数据库,检查run-env下的init-db.sh的换行格式,如果是win的,需要换成linux的才可以执行
- 在拉取things模块的时候报core的包拉不下来 执行
go env -w GOPRIVATE=gitee.com
