go-stream

基于go实现长连接的处理，把长连接数据按照使用的协议转切分为请求(request)， 与后端服务器使用短连接通讯，完全兼容后端http协议。后端服务器使用推送协议可以 很方便的把数据推送到客户端。

Net

MaxConnections 设置最大连接数，-1表示不限制
TLS 是否使用TLS, 如果设置为true，则必须设置TlsFile，使用PEM格式的证书文件格式

HeartBeat_s

设置心跳，在握手协议中，此设置会同步给客户端。单位：秒

其它设置

默认 config 文件中没有输出，可以直接手动添加

• MaxConcurrentPerConnection 单个连接上的同时并发数，默认为5
• FrameTimeout_s 对于一帧数据(比如http的一个请求数据或者一个响应数据，或者一次推送) 需要分多段传输时，段与段之间的最大时间间隔，单位：秒，默认值为 10
• MaxBytesPerFrame 每一帧数据的最大byte数，(比如请求，响应，推送)，默认值为 4 * 1024 * 1024

proxy

Headers

• Key 按照标准的Http头的格式配置，内部会自动转换为标准的格式(首字母大学，其他字母小写)
• Value 支持使用变量
• 所有客户端在请求时填写的头信息都会自动填充在Proxy的Headers中
• 自动添加 Stream-Max-Response 的 key 在 Headers 中，对应的值为 config中配置的 MaxBytesPerFrame

Url

后端服务的地址，支持使用变量

push

push server

接收后端应用服务器向客户端推送的数据。 后端应用服务器需要的推送相关的数据，可以通过proxy Headers 传递给后端服务器。

push client sdk

• push sdk中url的必须是 host:ip/pushtoken 的格式，host与ip必须与push服务中配置的一样，pushtoken是变量的值。 host:ip可以是xtcp 中支持的任何地址协议
• 直接 require 本模块，使用pushc.PushData(xxx) or pushc.Close(xxx) 即可

websocket

• Origin 设置允许发起websocket请求的源，如果源与请求的Host相同时，无论Origin设置什么都允许访问。
  支持* 通配符，比如："*"，允许所有的源请求；"*.adc.com"，允许.adc.com结尾的域名发起访问

变量

• 在支持变量的配置中，由${xxx}格式表示一个变量xxx，变量的值会根据当前的请求或者连接而获取
• 基于连接的变量：在同一连接上的所有请求在获取基于连接的变量值时，都是同一个值

pushtoken 供推送时使用
remote_addr 远端地址
local_addr 本地地址

• 基于请求的变量：

fhttp_xxx xxx是客户端请求时，添加的头信息的key

client

• 2.x 在 swift kotlin typescript
• 对应的client sdk(1.x) 在 这儿
• go-stream >= v0.1.2 兼容 client 1.x 与 2.x

go-client

go版本的client与push sdk 在 这儿

sever

使用此库实现的独立服务在 这儿，此服务支持http协议的推送

push demo

go版本的push demo