prestontao / upnp

A simple implements UPnP protocol for Go(Golang) library. Add port mapping for NAT devices. 在内网中搜索网关设备，检查网关是否支持upnp协议，若支持，添加端口映射。

upnp protocol

====

A simple implements UPnP protocol for Golang library. Add port mapping for NAT devices.

在内网中搜索网关设备，检查网关是否支持upnp协议，若支持，添加端口映射。

====

example:

1. add a port mapping

mapping := new(upnp.Upnp)
if err := mapping.AddPortMapping(55789, 55789, "TCP"); err == nil {
	fmt.Println("success !")
	// remove port mapping in gatway
	mapping.Reclaim()
} else {
	fmt.Println("fail !")
}

2. search gateway device.

upnpMan := new(upnp.Upnp)
err := upnpMan.SearchGateway()
if err != nil {
	fmt.Println(err.Error())
} else {
	fmt.Println("local ip address: ", upnpMan.LocalHost)
	fmt.Println("gateway ip address: ", upnpMan.Gateway.Host)
}

3. get an internet ip address in gatway.

upnpMan := new(upnp.Upnp)
err := upnpMan.ExternalIPAddr()
if err != nil {
	fmt.Println(err.Error())
} else {
	fmt.Println("internet ip address: ", upnpMan.GatewayOutsideIP)
}

upnp's Issues

upnp模块报错了 runtime error: invalid memory address or nil pointer dereference

Hi

I'm using your libraries for one of my projects, and I get this error from the libraries:

upnp模块报错了 runtime error: invalid memory address or nil

To riproduce it, I just run this code:

mapping_http := new(upnp.Upnp)
log.Printf("[INFO] UPnP on TCP %d...", ClusterPort)
if err := mapping_http.AddPortMapping(ClusterPort, ClusterPort, "TCP"); err == nil {
    log.Printf("[INFO] UPnP redirect TCP %d successful", ClusterPort)
} else {
    log.Printf("[WARNING] No UPnP on TCP %d: network UPnP-agnostic", ClusterPort)
}

log.Printf("[INFO] UPnP on UDP %d...", ClusterPort)

if err := mapping_http.AddPortMapping(ClusterPort, ClusterPort, "UDP"); err == nil {
    log.Printf("[INFO] UPnP redirect UDP %d successful", ClusterPort)
} else {
    log.Printf("[WARNING] No UPnP on UDP %d: network UPnP-agnostic", ClusterPort)
}

The complete log of this piece of code is:

2015/04/30 20:34:35 [INFO] UPnP on TCP 21000...
2015/04/30 20:35:05 upnp模块报错了 runtime error: invalid memory address or nil pointer dereference
2015/04/30 20:35:05 [INFO] UPnP redirect TCP 21000 successful
2015/04/30 20:35:05 [INFO] UPnP on UDP 21000...
2015/04/30 20:35:35 upnp模块报错了 runtime error: invalid memory address or nil pointer dereference
2015/04/30 20:35:35 [INFO] UPnP redirect UDP 21000 successful

as you can see, the port is opened and it returns no error. But it logs the message mentioned.