golang ping go-ping库简介

骑猪看日落 2021-09-07 06:20 676阅读 0赞

**目录**

实例

安装

支持的操作系统

Linux

Windows

--------------------

go-ping库地址：[https://github.com/go-ping/ping][https_github.com_go-ping_ping]

受[go-fastping][]启发，一个简单但功能强大的Go Go的ICMP回显（ping）库 。

## 实例 ##

这是一个非常简单的示例，该示例发送和接收三个数据包：

pinger, err := ping.NewPinger("www.google.com")
    if err != nil {
    	panic(err)
    }
    pinger.Count = 3
    err = pinger.Run() // Blocks until finished.
    if err != nil {
    	panic(err)
    }
    stats := pinger.Statistics() // get send/receive/duplicate/rtt stats

这是一个模拟传统UNIX ping命令的示例：

pinger, err := ping.NewPinger("www.google.com")
    if err != nil {
    	panic(err)
    }
    
    // Listen for Ctrl-C.
    c := make(chan os.Signal, 1)
    signal.Notify(c, os.Interrupt)
    go func() {
    	for _ = range c {
    		pinger.Stop()
    	}
    }()
    
    pinger.OnRecv = func(pkt *ping.Packet) {
    	fmt.Printf("%d bytes from %s: icmp_seq=%d time=%v\n",
    		pkt.Nbytes, pkt.IPAddr, pkt.Seq, pkt.Rtt)
    }
    
    pinger.OnDuplicateRecv = func(pkt *ping.Packet) {
    	fmt.Printf("%d bytes from %s: icmp_seq=%d time=%v ttl=%v (DUP!)\n",
    		pkt.Nbytes, pkt.IPAddr, pkt.Seq, pkt.Rtt, pkt.Ttl)
    }
    
    pinger.OnFinish = func(stats *ping.Statistics) {
    	fmt.Printf("\n--- %s ping statistics ---\n", stats.Addr)
    	fmt.Printf("%d packets transmitted, %d packets received, %v%% packet loss\n",
    		stats.PacketsSent, stats.PacketsRecv, stats.PacketLoss)
    	fmt.Printf("round-trip min/avg/max/stddev = %v/%v/%v/%v\n",
    		stats.MinRtt, stats.AvgRtt, stats.MaxRtt, stats.StdDevRtt)
    }
    
    fmt.Printf("PING %s (%s):\n", pinger.Addr(), pinger.IPAddr())
    err = pinger.Run()
    if err != nil {
    	panic(err)
    }

它发送ICMP Echo Request数据包，并等待Echo Reply作为响应。如果收到响应，它将调用`OnRecv`回调，除非已经接收到具有该序列号的数据包，在这种情况下，它将调用`OnDuplicateRecv`回调。完成后，它将调用`OnFinish`回调。

对于全平示例，请参阅 [CMD /平/ ping.go][CMD _ ping.go]。

## 安装`` ##

go get -u github.com/go-ping/ping

要安装本地Go ping可执行文件，请执行以下操作：

go get -u github.com/go-ping/ping/...
    $GOPATH/bin/ping

## 支持的操作系统 ##

### Linux ###

该库尝试通过UDP发送“非特权” ping。在Linux上，必须使用以下sysctl命令启用它：``

sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"

如果您不想这样做，则可以调用`pinger.SetPrivileged(true)` 代码，然后在二进制文件上使用setcap使其绑定到原始套接字（或仅以root身份运行）：``

setcap cap_net_raw=+ep /path/to/your/compiled/binary

有关更多详细信息，请参[见此博客][Link 1] 和Go [x / net / icmp][x _ net _ icmp]软件包。

### Windows ###

您必须使用`pinger.SetPrivileged(true)`，否则您将收到以下错误：``

> `socket: The requested protocol has not been configured into the system, or no implementation for it exists.`

尽管使用了方法名称，但该方法无需提升特权即可工作，并且已在Windows 10上进行了测试。请注意，由于Go x / net / ipv4和x / net / ipv6程序包中的限制，因此不支持访问数据包TTL值。 。

[https_github.com_go-ping_ping]: https://github.com/go-ping/ping
[go-fastping]: https://github.com/tatsushid/go-fastping
[CMD _ ping.go]: https://github.com/go-ping/ping/blob/master/cmd/ping/ping.go
[Link 1]: https://sturmflut.github.io/linux/ubuntu/2015/01/17/unprivileged-icmp-sockets-on-linux/
[x _ net _ icmp]: https://godoc.org/golang.org/x/net/icmp