go-stun

Go implementation of STUN, TURN and ICE Protocols

Features

• [x] STUN Encoder/Decoder
• [x] STUN Client/Server
• [x] STUN Authorization
• [x] STUN Transactions
• [x] STUN Multiplexing
• [ ] STUN Redirection
• [ ] NAT Behavior Discovery
• [x] ICE Messages
• [ ] ICE Agent
• [ ] ICE Gathering
• [ ] ICE Lite
• [x] TURN Messages
• [x] TURN Client
• [ ] TURN Server
• [ ] ...

Installation

go get github.com/pixelbender/go-stun/...

STUN: Server reflexive transport address discovery

package main

import (
	"github.com/pixelbender/go-stun/stun"
	"fmt"
)

func main() {
    conn, addr, err := stun.Discover("stun:stun.l.google.com:19302")
	if err != nil {
    	fmt.Println(err)
    	return
    }
    defer conn.Close()
	fmt.Printf("Local address: %v, Server reflexive address: %v", conn.LocalAddr(), addr)
}

TURN: Relayed transport address allocation

package main

import (
	"github.com/pixelbender/go-stun/turn"
	"fmt"
)

func main() {
	conn, err := turn.Allocate("turn:username:[email protected]")
	if err != nil {
		fmt.Println(err)
		return
	}
	defer conn.Close()
	fmt.Printf("Local address: %v, Relayed transport address: %v", conn.LocalAddr(), conn.RelayedAddr())
}

Specifications

• RFC 5389: STUN
• RFC 5780: NAT Behavior Discovery Using STUN
• RFC 7064: URI Scheme for STUN
• RFC 5766: TURN: Relay Extensions to STUN
• RFC 5245: ICE: A Protocol for NAT for Offer/Answer Protocols
• RFC 6062: TURN Extensions for TCP Allocations
• RFC 7065: TURN URI
• RFC 6544: TCP Candidates with ICE