Sign inSign up

akashchouhan16/traceip

By akashchouhan16

•Updated about 3 years ago

🧬 A Go based CLI for geolocation lookups on IP addresses.

Image
0

253

akashchouhan16/traceip repository overview

⁠🧬 TraceIP

A Command line tool built with Go⁠ to perform geolocation lookups for IP addresses.

Retrieve information such as host, country, region, city, latitude, longitude and associated organisation with an IP address.

$ traceip

⁠📜 Quick Setup

Learn more about go workspace and installation here⁠.

  • Clone the GitHub repo: 
    • $ git clone https://github.com/akashchouhan16/traceip.git

    • $ cd traceip
  • Install and compile traceip binary: 
    • $ go install && go build
  • Run traceip: 
    • $ traceip
  • System Prerequisites: Go 1.17 or above installed.

⁠🐋 Run with Docker

  • Pull the base image for traceip from docker hub. 
    • $ docker pull akashchouhan16/traceip
  • Run as docker container. 
    • $ docker run akashchouhan16/traceip
  • System Prerequisite: Docker runtime installed locally.

    Note: Incase any issue is faced with the setup, make sure the GOPATH is set to pwd and go version is updated. Refer the Go compilation guide⁠.

⁠🧬 Preview: GO build & Run the traceip binary

$ go build && traceip

   ======================================================
  | ████████╗██████╗  █████╗  ██████╗███████╗ ██╗██████╗  |
  | ╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██╔════╝ ██║██╔══██╗ |
  |    ██║   ██████╔╝███████║██║     █████╗   ██║██████╔╝ |
  |    ██║   ██╔══██╗██╔══██║██║     ██╔══╝   ██║██╔═══╝  |
  |    ██║   ██║  ██║██║  ██║╚██████╗███████╗ ██║██║      |
  |    ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚══════╝ ╚═╝╚═╝      |
   ======================================================
  A command line tool for geolocation lookups on IP addresses.


  Usage:
    traceip [command]

  Available Commands:
    completion  Generate the autocompletion script for the specified shell
    help        Help about any command
    trace       Geo locate an IPv4 or IPv6 with the trace command.

  Flags:
    -h, --help   help for traceip
    -4, --ipv4   Enforce IPv4 geo tracing only {wip}
    -6, --ipv6   Enforce IPv6 geo tracing only {wip}

  Use "traceip [command] --help" for more information about a command.

build-and-run Preview

⁠🧬 Preview: traceip trace <IPv4 | IPv6>

$ traceip trace 45.32.39.145

Locating IP...
==============================
      - IP: 45.32.39.145
      - CITY: Ōi
      - REGION: Saitama
      - COUNTRY :JP
      - LOCATION :35.6090,139.7302
      - TIMEZONE:Asia/Tokyo
      - POSTAL: 140-8508
      - Org: AS20473 The Constant Company, LLC
==============================

⁠🔖 Contributing

⁠Author

Reach out with questions or ideas for traceip.

⁠License

Copyright (c) Akash Chouhan. All rights reserved. Released under the MIT License⁠

Tag summary

Content type

Image

Digest

sha256:f8268fe83…

Size

124.9 MB

Last updated

about 3 years ago

docker pull akashchouhan16/traceip