revzim/gongrok

golang ngrok wrapper

gongrok

golang ngrok wrapper

• Secure introspectable tunnels to local host

Install

• ngrok binary is required for use

  • download the binary
  • place binary within your working directory
  • default: ./ngrok_bin/

• go get github.com/revzim/gongrok

Example

• WEB APP EXAMPLE
  • place ngrok binary download in ngrok path ./ngrok_bin/
  • build or run
    • go run main.go | go build main.go
    • server starts
      • client web app located at http://localhost:8080/client
  • The example provided is a simple webapp that allows for the user to input:
    • tunnel name - the name identifier of the tunnel you would like to open
    • host - local server addr that you would like to expose with ngrok
    • port - port of the local server
    • protocol - 0 - HTTP | 1 - TCP | 2 - TLS

About

• An iOS app I was working on allows for the user to host a web server from their iOS device that acts as a simple web/chat server.
• I wanted to figure out a way to allow others that are outside of the local network to connect and chat if the device's network is protected by a strict firewall.
• I've used ngrok for a few other projects and figured it would be a decent place to start to test out the capabilities of whether or not web servers hosted on iOS devices on a local network could be exposed to the World Wide Web, which ended up being easy to test and implement correctly.

PkgGoDev & GoDoc

Workflow

  * INIT CLIENT
  
  * INIT TUNNEL(S)

  * RUN NGROK BINARY W/ OPTIONS

  * ADD TUNNEL(S) TO CLIENT

  * CONNECT ALL CLIENT SERVER TUNNELS

  * TUNNELS STAY OPEN UNTIL CLOSE

Author

• revzim

Credits

inspired by:

• Node NGROK Wrapper
• gonnel

gongrok's Issues

Nil pointer exception gongrok.go:162

If e.g. the path to the ngrok executable is wrong (which I tested intentionally) there is a nil pointer panic.
It points on line 162 in gongrok.go, where it doesn't check if logging is configured before logging.
As I didn't initialize logging, the Logger is nil at that spot.

I would have made a pull request but then thought that might me too less of a change ;)

Ngrok service in program

Hello, i am designing an emulator in golang and i need ngrok services in it. I want to start service of go-lang as soon as I call a function with argument port number in it, later i wana use that port for ngrok tunnel, I don't wanna use that localhost:8080/client to provide port host and protocol to program, I hope you get my point, Is it possible ?