2019-11-09 10:07:49 +08:00
|
|
|
# Introduction
|
|
|
|
|
|
|
|
|
|
Pingme is ping probe command line tool, supporting ICMP, TCP and HTTP protocols.
|
|
|
|
|
|
|
|
|
|
You can also use it to query IP information from third-party api provider (currently we use [https://ip-api.com](https://ip-api.com)).
|
|
|
|
|
|
|
|
|
|
# Features
|
|
|
|
|
|
|
|
|
|
- Support ICMP/TCP/HTTP protocols
|
|
|
|
|
- Query basic IP information
|
|
|
|
|
|
|
|
|
|
# Installation
|
|
|
|
|
|
|
|
|
|
1. Download latest [release](https://github.com/noobly314/pingme/releases/latest) (recommend)
|
|
|
|
|
|
|
|
|
|
2. Use go get
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
go get -u github.com/noobly314/pingme
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
3. Build on your own
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
git clone https://github.com/noobly314/pingme.git
|
|
|
|
|
cd pingme
|
|
|
|
|
go build
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# Usage
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
-h string
|
|
|
|
|
HTTP Ping
|
|
|
|
|
-i string
|
|
|
|
|
ICMP Ping
|
|
|
|
|
-m string
|
|
|
|
|
MTR Trace
|
|
|
|
|
-q string
|
|
|
|
|
Query ip information
|
|
|
|
|
-t string
|
|
|
|
|
TCP Ping
|
|
|
|
|
-v Version
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# Examples
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ pingme -h https://www.google.com
|
|
|
|
|
Proxy : false
|
|
|
|
|
Scheme : https
|
|
|
|
|
Host : www.google.com
|
|
|
|
|
DNS Lookup: 2.05 ms
|
|
|
|
|
TCP : 2.41 ms
|
|
|
|
|
TLS : 68.92 ms
|
|
|
|
|
Process : 29.28 ms
|
|
|
|
|
Transfer : 0.19 ms
|
|
|
|
|
Total : 103.06 ms
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ pingme -i www.google.com
|
|
|
|
|
ICMP OPEN 74.125.200.147 2.2 ms
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ pingme -t www.google.com:443
|
|
|
|
|
TCP OPEN www.google.com:443
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ pingme -q www.google.com
|
|
|
|
|
IP : 172.217.194.103
|
|
|
|
|
City : Queenstown Estate
|
|
|
|
|
Country: Singapore
|
|
|
|
|
ISP : Google LLC
|
|
|
|
|
AS : AS15169 Google LLC
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# Note
|
|
|
|
|
|
|
|
|
|
Root permission is required when running ICMP ping, since it needs to open raw socket.
|
|
|
|
|
|
|
|
|
|
You can either use sudo command, or set setuid bit for pingme.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
// Use sudo for one-time ping
|
|
|
|
|
$ sudo pingme -i google.com
|
|
|
|
|
|
|
|
|
|
// Set setuid bit
|
|
|
|
|
$ sudo chown root:root pingme
|
|
|
|
|
$ sudo chmod u+s pingme
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# License
|
|
|
|
|
|
|
|
|
|
See the [LICENSE](https://github.com/noobly314/pingme/blob/master/LICENSE.md) file for license rights and limitations (MIT).
|
|
|
|
|
|
|
|
|
|
# Acknowledgements
|
|
|
|
|
|
|
|
|
|
[https://ip-api.com](https://ip-api.com)
|
|
|
|
|
|
|
|
|
|
[lmas/icmp_ping.go](https://gist.github.com/lmas/c13d1c9de3b2224f9c26435eb56e6ef3)
|
|
|
|
|
|
|
|
|
|
[sparrc/go-ping](https://github.com/sparrc/go-ping)
|
|
|
|
|
|
|
|
|
|
[davecheney/httpstat](https://github.com/davecheney/httpstat)
|
