#ip #http #cli

app ip-server

simple server that returns client ip address

13 releases

0.1.13 Nov 26, 2021
0.1.12 Nov 25, 2021

#1656 in Command line utilities

Unlicense

10KB
176 lines

ip-server

similar to icanhazip.com

Example

$ ip-server
listening on 0.0.0.0:8000

Now that the server is running on port 8000, we can connect via ip-server or an HTTP client with a GET request

$ ip-server --client localhost:8000
127.0.0.1
$ curl localhost:8000
127.0.0.1
$ firefox localhost:8000

firefox

Usage

-h, --help

print help

-v, --version

print version

-c, --client <address>

run as client, connect to address client will print remote address to stdout with a newline

make sure to use fully qualified hostname and port (e.g. localhost:8000 instead of localhost)

-s, --server <address>

run as server, bind to address (default 0.0.0.0:8000)

server will handle both ip-server -c and HTTP GET requests (like from curl)

server will also print client addresses to stdout with a newline

Installation

via cargo

$ cargo install ip-server

make sure the cargo install directory is in your $PATH

$ ip-server
listening on 0.0.0.0:8000
$ ip-server --client localhost:8000
127.0.0.1

via docker

$ docker run -p 8000:8000 stzups/ip-server:latest
listening on 0.0.0.0:8000
$ docker run --network=host stzups/ip-server:latest --client localhost:8000
172.17.0.1

in a Dockerfile

FROM whatever can rust a simple rust binary
COPY --from=stzups/ip-server:latest /ip-server /usr/local/bin/ip-server
ENTRYPOINT ["ip-server"]

via your favorite package manager

coming soon :)

Dependencies

~140KB