cli

README

SurgeMQ Standalone Server

下面未更新，不要使用，采用配置文件的方式配置了

Build

• go build

Usage

Command line options

• -help : Shows complete list of supported options
• -auth string: Authenticator Type (default "mockSuccess")
• -keepalive int: Keepalive (sec) (default 300)
• -sessions string: Session Provider Type (default "mem")
• -topics string: Topics Provider Type (default "mem")
• -wsaddr string: HTTP websocket listener address, (eg. ":8080") (default none)
• -wssaddr string: HTTPS websocket listener address, (eg. ":8443") (default none)
• -wsscertpath string: HTTPS listener public key file, (eg. "certificate.pem") (default none)
• -wsskeypath string: HTTPS listener private key file, (eg. "key.pem") (default none)

Websocket listener

1. In addition to listening for MQTT traffic on port 1883, the standalone server can be configured to listen for websocket over HTTP or HTTPS.
2. mq -wsaddr :8080 will start the server to listen for Websocket on port 8080

Self-signed Websocket listener

The following steps will setup the server to use a self-signed certificate.

1. Generate a self-signed TLS certificate: openssl genrsa -out key.pem 2048; openssl req -new -key key.pem -out csr.pem; openssl req -x509 -days 365 -key key.pem -in csr.pem -out certificate.pem

2. Start standalone server: surgemq.exe -wssaddr :8443 -wsscertpath certificate.pem -wsskeypath key.pem

3. For self-signed certificate, add a security exception to the browser (eg: http://www.poweradmin.com/help/sslhints/firefox.aspx)

Testing

Websocket support has been tested with the HiveMQ websocket client at http://www.hivemq.com/demos/websocket-client/

Documentation

Index

• func AddWebsocketHandler(urlPattern string, uri string) error
• func BuffConfigInit()
• func DefaultListenAndServeWebsocket() error
• func ListenAndServeWebsocket(addr string) error
• func ListenAndServeWebsocketSecure(addr string, cert string, key string) error
• func Run()
• func WebsocketTcpProxy(ws *websocket.Conn, nettype string, host string) error

Functions

func AddWebsocketHandler

func AddWebsocketHandler(urlPattern string, uri string) error

转发websocket的数据到tcp处理中去

func BuffConfigInit

func BuffConfigInit()

buff 配置设置

func DefaultListenAndServeWebsocket

func DefaultListenAndServeWebsocket() error

func ListenAndServeWebsocket

func ListenAndServeWebsocket(addr string) error

start a listener that proxies websocket <-> tcp

func ListenAndServeWebsocketSecure

func ListenAndServeWebsocketSecure(addr string, cert string, key string) error

starts an HTTPS listener

func Run

func Run()

func WebsocketTcpProxy

func WebsocketTcpProxy(ws *websocket.Conn, nettype string, host string) error

handler that proxies websocket <-> unix domain socket