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

源码安装模式

视频教程:
bilibili (opens new window)

代码拉取

# 共享库(不修改可以不clone)
git clone https://gitee.com/unitedrhino/share.git
# 中台模块
git clone https://gitee.com/unitedrhino/core.git
# 物联网模块
git clone https://gitee.com/unitedrhino/things.git

golang安装

参考: golang安装教程 (opens new window)
注意: 安装的版本需要大于1.21

第三方依赖安装

后端组件

物理机安装方式需要自行安装以下组件:

1. 高性能缓存:redis (opens new window)
2. 高性能消息队列:nats (opens new window)
3. 关系型数据库:mysql(请使用mariaDB或mysql5.7)或pgsql (opens new window)
4. 微服务注册中心:etcd
5. 云原生轻量级对象存储:minio (opens new window)
6. 开源、高性能、云原生,极简的时序数据处理平台:tdengine (opens new window)
7. 大规模可弹性伸缩的云原生分布式物联网MQTT消息服务器:emqx(默认配置支持5.x) (opens new window)

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来操作

1. 在项目根路径下执行 go work init
2. 添加go的项目进go.work中,如下示例

go 1.21.4

use (
	./core
	./protocol-aliyun
	./protocol-tencent
	./protocol-wumei
	./share
	./things
)

3. 同步依赖 go work sync

这样就可以不使用replace就能修改依赖的仓库了

前端

开源版本前端运行

1. 下载 前端压缩包
2. 复制到静态文件的目录

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

1. 产品及设备创建报错:
   1. 请检查数据库是否创建成功
   2. 联犀请求tdengine是通过http的方式请求,参考官方文档检查td的服务是否启动: https://docs.taosdata.com/connector/rest-api/
2. 设备在线状态在服务器上不正确或设备可以订阅任何topic:检查emqx_auth_http.conf这个文件配置的ip是否正确
3. 联犀启动不起来,报mqtt连接不上:同样需要检查emqx_auth_http.conf这个文件配置的ip是否正确,emqx需要通过http来请求联犀进行认证
4. docker镜像拉取不下来: 这种情况一般是网络原因导致的,需要配置代理,简单的方式是可以安装1panel (opens new window)来一键配置代理
5. 运行不起来,things服务报错tdengine没有ithings数据库,检查run-env下的init-db.sh的换行格式,如果是win的,需要换成linux的才可以执行
6. 在拉取things模块的时候报core的包拉不下来 执行 go env -w GOPRIVATE=gitee.com