扩展协议支持

TCP

• nginx 配置

stream{

    upstream tcpserver {
        server 0.0.0.0:3333; # 实例端口
        server 0.0.0.0:3332;
    }
    server {
        listen 22122;
        proxy_pass tcpserver;
    }
}

识别码建立过程

1. 执行如下指令完成TCP链接建立

nc -v 127.0.0.1 22122

2. 发送uid:开头的数据，用于确认具体的设备唯一编码
3. 发送实际数据进行处理

• 完整TCP请求案例

nc -v 127.0.0.1 22122
Connection to 127.0.0.1 port 22122 [tcp/*] succeeded!
1
请发送uid:xxx格式的消息进行设备ID映射。
uid:1:username:password
成功识别设备编码.
datadata
数据已处理.

注意： 账号密码不能常出现冒号 :

HTTP

1. 账号密码认证模式 basicc auth

2. 请求头中需要标注设备id。键名为device_id

3. 请求体结构为

{
    "data":"字符串"
}

COAP

1. 与coap服务建立链接，发送数据到/auth地址，数据报文如下

	auth := Auth{
		Username: "admin",
		Password: "admin",
		DeviceId: "1234567890",
	}
	marshal, _ := json.Marshal(auth)
	req := coap.Message{
		Type:      coap.Confirmable,
		Code:      coap.GET,
		MessageID: 12345,
		Payload:   marshal,
	}

2. 认证通过后发送数据到 /data地址，数据报文如下

	req := coap.Message{
		Type:      coap.Confirmable,
		Code:      coap.GET,
		MessageID: 12345,
		Payload:   []byte("test"),
	}

	path := "/data"

Websocket

1. 使用 http base auth 进行登录认证 ， 会返回标识码

curl --location --request GET 'http://127.0.0.1:13332/auth' \
--header 'Accept: application/json, text/plain, */*' \
--header 'Accept-Language: zh-CN,zh;q=0.9' \
--header 'Cache-Control: no-cache' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/json' \
--header 'Origin: http://192.168.3.107:5958' \
--header 'Pragma: no-cache' \
--header 'Referer: http://192.168.3.107:5958/' \
--header 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36' \
--header 'pls: pls' \
--header 'device_id: 123' \
--header 'Authorization: Basic YWRtaW46YWRtaW4=' \
--data '{}'

返回值结构:

{
    "message": "认证通过",
    "uid": "123@f57f814e-4d59-11ef-be14-acde48001122"
}

uid: @前是设备id，@后是客户端id

2. websocket 链接： ws://127.0.0.1:13332/ws?id=uid