public-ip

What is public-ip?

The public-ip npm package allows you to get your public IP address (IPv4 or IPv6) from different services. It supports both IPv4 and IPv6, and it can be used in Node.js environments.

What are public-ip's main functionalities?

Get IPv4 Address

This feature allows you to get your public IPv4 address. The code sample demonstrates how to use the public-ip package to fetch and log the IPv4 address.

const publicIp = require('public-ip');
(async () => {
    console.log(await publicIp.v4());
})();

Get IPv6 Address

This feature allows you to get your public IPv6 address. The code sample demonstrates how to use the public-ip package to fetch and log the IPv6 address.

const publicIp = require('public-ip');
(async () => {
    console.log(await publicIp.v6());
})();

Get IP Address with Options

This feature allows you to get your public IP address with additional options. The code sample demonstrates how to use the public-ip package to fetch the IPv4 address using only HTTPS services.

const publicIp = require('public-ip');
(async () => {
    console.log(await publicIp.v4({ onlyHttps: true }));
})();

Other packages similar to public-ip

ipify

The ipify package is another tool to get your public IP address. It is similar to public-ip but focuses on using the ipify service to fetch the IP address. It supports both IPv4 and IPv6.

external-ip

The external-ip package provides a way to get your public IP address by querying multiple services and returning the first successful response. It offers more flexibility in terms of service selection compared to public-ip.

public-ip-cli

The public-ip-cli package is a command-line interface for the public-ip package. It allows you to fetch your public IP address directly from the command line, making it convenient for quick checks without writing code.

README

public-ip

Get your public IP address - very fast!

In Node.js, it queries the DNS records of OpenDNS which has an entry with your IP address.

In browsers, it uses the excellent icanhaz service through HTTPS.

Install

$ npm install --save public-ip

Usage

const publicIp = require('public-ip');

publicIp.v4().then(ip => {
	console.log(ip);
	//=> '46.5.21.123'
});

publicIp.v6().then(ip => {
	console.log(ip);
	//=> 'fe80::200:f8ff:fe21:67cf'
});

API

publicIp.v4([options])

publicIp.v6([options])

Returns a Promise which resolves to your public IPv4 or IPv6 address. Will reject on error or timeout. A .cancel() method is available on the promise, which can be used to cancel the request.

options

Type: Object

https

Type: boolean
Default: false

Use a HTTPS check using the icanhazip.com service instead of the DNS query. This check is much more secure and tamper-proof, but also a lot slower. This option is only available in the Node.js version.

timeout

Type: number
Default: 5000

The time in milliseconds until a request is considered timed out.

Maintainers

• silverwind

Related

• public-ip-cli - CLI for this module
• internal-ip - Get your internal IP address

License

MIT © Sindre Sorhus