444

I have a simple Node.js program running on my machine and I want to get the local IP address of a PC on which my program is running. How do I get it with Node.js?

2

46 Answers 46

586

This information can be found in os.networkInterfaces(), — an object, that maps network interface names to its properties (so that one interface can, for example, have several addresses):

'use strict';

const { networkInterfaces } = require('os');

const nets = networkInterfaces();
const results = Object.create(null); // Or just '{}', an empty object

for (const name of Object.keys(nets)) {
    for (const net of nets[name]) {
        // Skip over non-IPv4 and internal (i.e. 127.0.0.1) addresses
        // 'IPv4' is in Node <= 17, from 18 it's a number 4 or 6
        const familyV4Value = typeof net.family === 'string' ? 'IPv4' : 4
        if (net.family === familyV4Value && !net.internal) {
            if (!results[name]) {
                results[name] = [];
            }
            results[name].push(net.address);
        }
    }
}
// 'results'
{
  "en0": [
    "192.168.1.101"
  ],
  "eth0": [
    "10.0.0.101"
  ],
  "<network name>": [
    "<ip>",
    "<ip alias>",
    "<ip alias>",
    ...
  ]
}
// results["en0"][0]
"192.168.1.101"
17
  • 20
    var _ = require('underscore'); var ip = _.chain(require('os').networkInterfaces()).flatten().filter(function(val){ return (val.family == 'IPv4' && val.internal == false) }).pluck('address').first().value(); console.log(ip) Commented Sep 9, 2013 at 15:27
  • 4
    @CarterCole you need an extra call to .values() before flatten.
    – Guido
    Commented Mar 4, 2015 at 9:41
  • 5
    What if I wanted to retrieve just the active interface's IP address?
    – Tejas
    Commented Aug 2, 2015 at 6:54
  • 28
    one-liner without lodash for node >= 7.0.0: Object.values(require('os').networkInterfaces()).reduce((r, list) => r.concat(list.reduce((rr, i) => rr.concat(i.family==='IPv4' && !i.internal && i.address || []), [])), [])
    – som
    Commented Jan 17, 2019 at 0:15
  • 24
    "Underscore" "lowdash" "one liner" - gross.
    – B T
    Commented Jun 12, 2020 at 15:43
261

Here's what I use.

const dns = require('node:dns');
const os = require('node:os');

const options = { family: 4 };

dns.lookup(os.hostname(), options, (err, addr) => {
  if (err) {
    console.error(err);
  } else {
    console.log(`IPv4 address: ${addr}`);
  }
});

This will return your first network interface's IPv4 address. It might also have an IPv6, so in order to get "whatever is listed first" you can use family:0 (or don't pass any options at all) or to explicitly get the IPv6, use family:6 as option instead.

12
  • 5
    @HermannIngjaldsson: This is not a very thoroughly informative criticism. Could you be more specific? Maybe take the example code and put it into a new question providing more details and asking why it doesn't work?
    – Xedecimal
    Commented Nov 7, 2012 at 20:11
  • 14
    It is not always a good idea to use the DNS lookup, as it can return wrong information (i.e. cached data). Using 'os.networkInterfaces' is a better idea in my opinion.
    – Guido
    Commented Feb 28, 2013 at 19:55
  • 5
    Using DNS works if your server has a dns entry somewhere. However in a lot of applications there isn't a dns entry (e.g. my laptop). os.networkInterfaces() is probably the way to go. Commented Feb 6, 2015 at 20:54
  • 2
    Note that this uses the OS lookup, which doesn't necessarily do DNS lookups and should know its own primary IP address...
    – w00t
    Commented Sep 3, 2015 at 10:09
  • what if i get the DNS address of each interface
    – taha027
    Commented Jan 25, 2016 at 9:58
244

https://github.com/indutny/node-ip

var ip = require("ip");
console.dir ( ip.address() );
13
  • 2
    documentation for this package is unclear... can i also get the broadcast address, or do i have to supply it myself?
    – Michael
    Commented Jan 29, 2017 at 21:33
  • 26
    @majidarif i don't recognize that as a valid excuse for poor documentation
    – Michael
    Commented Feb 15, 2017 at 15:11
  • 9
    This works incredibly well. Getting the IP address is literally a one-liner. Excellent. Commented Jul 25, 2017 at 20:41
  • 7
    It doesn't give you the IP address of all the adapters. If you have Docker installed, it gives the vEthernet docker address instead of your actual Ethernet address
    – TetraDev
    Commented Dec 19, 2017 at 21:52
  • 2
    This module is 416 lines and 10Kb just to get an IP address... way overkill Commented Nov 16, 2021 at 20:53
78

Any IP address of your machine you can find by using the os module - and that's native to Node.js:

var os = require('os');

var networkInterfaces = os.networkInterfaces();

console.log(networkInterfaces);

All you need to do is call os.networkInterfaces() and you'll get an easy manageable list - easier than running ifconfig by leagues.

5
  • 11
    Awesome answer. var ip = networkInterfaces['eth0'][0]['address']
    – Natus Drew
    Commented Dec 11, 2014 at 8:13
  • while this seems great because its simple, its actual effectiveness probably depends on your network configuration. For example, there's no eth0 on the default configuration of OS X, it's en0.
    – ccnokes
    Commented Jan 2, 2015 at 19:49
  • 3
    Works for me. var address = networkInterfaces['venet0:0'][0].address
    – Anthony
    Commented Oct 2, 2015 at 20:24
  • 1
    weird. on SunOS 5.11 this call returns an empty object
    – Michael
    Commented Jan 29, 2017 at 21:34
  • This is literally best answer. os.networkInterfaces() returns a simple JSON object to work with ;)
    – chankruze
    Commented Sep 16, 2020 at 15:52
49

Here's my utility method for getting the local IP address, assuming you are looking for an IPv4 address and the machine only has one real network interface. It could easily be refactored to return an array of IP addresses for multi-interface machines.

function getIPAddress() {
  var interfaces = require('os').networkInterfaces();
  for (var devName in interfaces) {
    var iface = interfaces[devName];

    for (var i = 0; i < iface.length; i++) {
      var alias = iface[i];
      if (alias.family === 'IPv4' && alias.address !== '127.0.0.1' && !alias.internal)
        return alias.address;
    }
  }
  return '0.0.0.0';
}
2
  • Coffee version: getLocalIP = (interfaceName = "en0",version = "IPv4")-> iface = require('os').networkInterfaces()[interfaceName] for alias in iface if (alias.family == version && !alias.internal) return alias.address return "0.0.0.0"
    – Jay
    Commented Mar 24, 2015 at 20:58
  • If there are multiple interfaces, is there a way to know which is the "best"/more accurate one to return for getting the IP
    – rasen58
    Commented Jun 24 at 3:57
42

Install a module called ip like:

npm install ip

Then use this code:

var ip = require("ip");
console.log(ip.address());
5
42

Use the npm ip module:

var ip = require('ip');

console.log(ip.address());

> '192.168.0.117'
3
  • 10
    I dont know, how to tell to users who land on this page now that this is the only suitable option in current context.
    – Gagan
    Commented Nov 17, 2019 at 5:39
  • Thanks @Gagan Your appreciation. Commented Nov 17, 2019 at 14:29
  • 1
    yeah thats it right there.
    – yeahdixon
    Commented Apr 7, 2022 at 7:45
34

Here is a snippet of Node.js code that will parse the output of ifconfig and (asynchronously) return the first IP address found:

(It was tested on Mac OS X v10.6 (Snow Leopard) only; I hope it works on Linux too.)

var getNetworkIP = (function () {
    var ignoreRE = /^(127\.0\.0\.1|::1|fe80(:1)?::1(%.*)?)$/i;

    var exec = require('child_process').exec;
    var cached;
    var command;
    var filterRE;

    switch (process.platform) {
        // TODO: implement for OSes without the ifconfig command
        case 'darwin':
             command = 'ifconfig';
             filterRE = /\binet\s+([^\s]+)/g;
             // filterRE = /\binet6\s+([^\s]+)/g; // IPv6
             break;
        default:
             command = 'ifconfig';
             filterRE = /\binet\b[^:]+:\s*([^\s]+)/g;
             // filterRE = /\binet6[^:]+:\s*([^\s]+)/g; // IPv6
             break;
    }

    return function (callback, bypassCache) {
        // Get cached value
        if (cached && !bypassCache) {
            callback(null, cached);
            return;
        }

        // System call
        exec(command, function (error, stdout, sterr) {
            var ips = [];
            // Extract IP addresses
            var matches = stdout.match(filterRE);

            // JavaScript doesn't have any lookbehind regular expressions, so we need a trick
            for (var i = 0; i < matches.length; i++) {
                ips.push(matches[i].replace(filterRE, '$1'));
            }

            // Filter BS
            for (var i = 0, l = ips.length; i < l; i++) {
                if (!ignoreRE.test(ips[i])) {
                    //if (!error) {
                        cached = ips[i];
                    //}
                    callback(error, ips[i]);
                    return;
                }
            }
            // Nothing found
            callback(error, null);
        });
    };
})();

Usage example:

getNetworkIP(function (error, ip) {
    console.log(ip);
    if (error) {
        console.log('error:', error);
    }
}, false);

If the second parameter is true, the function will execute a system call every time; otherwise the cached value is used.


Updated version

Returns an array of all local network addresses.

Tested on Ubuntu 11.04 (Natty Narwhal) and Windows XP 32

var getNetworkIPs = (function () {
    var ignoreRE = /^(127\.0\.0\.1|::1|fe80(:1)?::1(%.*)?)$/i;

    var exec = require('child_process').exec;
    var cached;
    var command;
    var filterRE;

    switch (process.platform) {
        case 'win32':
        //case 'win64': // TODO: test
            command = 'ipconfig';
            filterRE = /\bIPv[46][^:\r\n]+:\s*([^\s]+)/g;
            break;
        case 'darwin':
            command = 'ifconfig';
            filterRE = /\binet\s+([^\s]+)/g;
            // filterRE = /\binet6\s+([^\s]+)/g; // IPv6
            break;
        default:
            command = 'ifconfig';
            filterRE = /\binet\b[^:]+:\s*([^\s]+)/g;
            // filterRE = /\binet6[^:]+:\s*([^\s]+)/g; // IPv6
            break;
    }

    return function (callback, bypassCache) {
        if (cached && !bypassCache) {
            callback(null, cached);
            return;
        }

        // System call
        exec(command, function (error, stdout, sterr) {
            cached = [];
            var ip;
            var matches = stdout.match(filterRE) || [];
            //if (!error) {
            for (var i = 0; i < matches.length; i++) {
                ip = matches[i].replace(filterRE, '$1')
                if (!ignoreRE.test(ip)) {
                    cached.push(ip);
                }
            }
            //}
            callback(error, cached);
        });
    };
})();

Usage Example for updated version

getNetworkIPs(function (error, ip) {
console.log(ip);
if (error) {
    console.log('error:', error);
}
}, false);
7
  • Tested just now on OSX Lion, perfect. Thanks so much!
    – T3db0t
    Commented May 3, 2012 at 21:49
  • I had to remove the hyphen after the word "IP" in your Windows regexp, because my output didn't have the hyphen (I'm using Windows XP 32-bit). I don't know if that was a typo or if your Windows version really outputs a hyphen after "IP", but just to be on the safe side, I suppose it can be made optional: filterRE = /\bIP-?[^:\r\n]+:\s*([^\s]+)/g;. Aside from that, great script, a true lifesaver. Many thanks! Commented Jul 6, 2012 at 18:14
  • @jSepia: That's probably a localization thing. German Windows prints "IP-Adresse" ;) Commented Jul 6, 2012 at 18:19
  • Fair enough, but now you broke it again :p My ipconfig output doesn't include "v4" nor "v6", that seems to be a Vista/7 thing (see technet.microsoft.com/en-us/library/bb726952.aspx ) Commented Jul 6, 2012 at 23:40
  • There is no reason for such a hack. We have os.networkInterfaces() now.
    – Brad
    Commented May 18, 2013 at 2:56
24

Calling ifconfig is very platform-dependent, and the networking layer does know what IP addresses a socket is on, so best is to ask it.

Node.js doesn't expose a direct method of doing this, but you can open any socket, and ask what local IP address is in use. For example, opening a socket to www.google.com:

var net = require('net');
function getNetworkIP(callback) {
  var socket = net.createConnection(80, 'www.google.com');
  socket.on('connect', function() {
    callback(undefined, socket.address().address);
    socket.end();
  });
  socket.on('error', function(e) {
    callback(e, 'error');
  });
}

Usage case:

getNetworkIP(function (error, ip) {
    console.log(ip);
    if (error) {
        console.log('error:', error);
    }
});
4
  • In case you're wondering - this does not necessarily get the public IP address that the world sees.
    – artur
    Commented Sep 21, 2011 at 16:05
  • Would be a nice solution if it didn't depend on internet connection and its speed..
    – Jacob Rask
    Commented Nov 1, 2011 at 10:21
  • In my instance this solution is perfect, as I need to know the IP of the interface a particular request goes out on.
    – radicand
    Commented Oct 18, 2013 at 5:05
  • This is the only thing that worked to grab my local IP address reliably, without needing the user to specify the interface name, thank you!
    – Sv443
    Commented Feb 14, 2022 at 20:18
19

Your local IP address is always 127.0.0.1.

Then there is the network IP address, which you can get from ifconfig (*nix) or ipconfig (win). This is only useful within the local network.

Then there is your external/public IP address, which you can only get if you can somehow ask the router for it, or you can setup an external service which returns the client IP address whenever it gets a request. There are also other such services in existence, like whatismyip.com.

In some cases (for instance if you have a WAN connection) the network IP address and the public IP are the same, and can both be used externally to reach your computer.

If your network and public IP addresses are different, you may need to have your network router forward all incoming connections to your network IP address.


Update 2013:

There's a new way of doing this now. You can check the socket object of your connection for a property called localAddress, e.g. net.socket.localAddress. It returns the address on your end of the socket.

The easiest way is to just open a random port and listen on it, and then get your address and close the socket.


Update 2015:

The previous doesn't work anymore.

3
  • Does that mean that to get the network address in nodejs you need to make a system call to ifconfig or ipconfig and parse the response string? Commented Sep 18, 2010 at 8:38
  • @Pumbaa80 - Pretty much, unless your network card has some drivers you can call. Also if you have several network cards (or adapters, like hamachi), there is no way you can just call a function of sorts and get one IP which is THE IP. So parsing it and interpreting the output of of ifconfig is pretty much the only way.
    – Tor Valamo
    Commented Sep 18, 2010 at 17:25
  • It looks like net.socket returns undefined as of 2015, so the "new way of doing this" doesn't work anymore. There is a net.Socket, but it does not have a localAddress property.
    – trysis
    Commented Apr 9, 2015 at 16:40
15

I probably came late to this question, but in case someone wants to a get a one liner ES6 solution to get array of IP addresses then this should help you:

Object.values(require("os").networkInterfaces())
    .flat()
    .filter(({ family, internal }) => family === "IPv4" && !internal)
    .map(({ address }) => address)

As

Object.values(require("os").networkInterfaces())

will return an array of arrays, so flat() is used to flatten it into a single array

.filter(({ family, internal }) => family === "IPv4" && !internal)

Will filter the array to include only IPv4 Addresses and if it's not internal

Finally

.map(({ address }) => address)

Will return only the IPv4 address of the filtered array

so result would be [ '192.168.xx.xx' ]

you can then get the first index of that array if you want or change filter condition

OS used is Windows

1
  • Very nice. What if I need to get the gateway info?
    – Mendes
    Commented Jun 16, 2023 at 19:37
12

The correct one-liner for both Underscore.js and Lodash is:

var ip = require('underscore')
    .chain(require('os').networkInterfaces())
    .values()
    .flatten()
    .find({family: 'IPv4', internal: false})
    .value()
    .address;
1
  • 3
    You can use: .find({family: 'IPv4', internal: false}) as well for a shorter more elegant code
    – dcohenb
    Commented Mar 27, 2016 at 11:16
11

Here's what might be the cleanest, simplest answer without dependencies & that works across all platforms.

const { lookup } = require('dns').promises;
const { hostname } = require('os');

async function getMyIPAddress(options) {
  return (await lookup(hostname(), options))
    .address;
}
9

All I know is I wanted the IP address beginning with 192.168.. This code will give you that:

function getLocalIp() {
    const os = require('os');

    for(let addresses of Object.values(os.networkInterfaces())) {
        for(let add of addresses) {
            if(add.address.startsWith('192.168.')) {
                return add.address;
            }
        }
    }
}

Of course you can just change the numbers if you're looking for a different one.

2
  • What if the address does not start with 192.168 ?
    – anu
    Commented Aug 7, 2019 at 3:31
  • @anu Either change the prefix to the one you're looking for, or use one of the many other solutions that people have posted here :-) My local IP always start with 192.168. which is why I chose that.
    – mpen
    Commented Aug 7, 2019 at 17:52
9

Here's a simplified version in vanilla JavaScript to obtain a single IP address:

function getServerIp() {

  const os = require('os');
  const ifaces = os.networkInterfaces();
  let values = Object.keys(ifaces).map(function(name) {
    return ifaces[name];
  });
  values = [].concat.apply([], values).filter(function(val){
    return val.family == 'IPv4' && val.internal == false;
  });

  return values.length ? values[0].address : '0.0.0.0';
}
8

I was able to do this using just Node.js.

As Node.js:

var os = require( 'os' );
var networkInterfaces = Object.values(os.networkInterfaces())
    .reduce((r,a) => {
        r = r.concat(a)
        return r;
    }, [])
    .filter(({family, address}) => {
        return family.toLowerCase().indexOf('v4') >= 0 &&
            address !== '127.0.0.1'
    })
    .map(({address}) => address);
var ipAddresses = networkInterfaces.join(', ')
console.log(ipAddresses);

As Bash script (needs Node.js installed)

function ifconfig2 ()
{
    node -e """
        var os = require( 'os' );
        var networkInterfaces = Object.values(os.networkInterfaces())
            .reduce((r,a)=>{
                r = r.concat(a)
                return r;
            }, [])
            .filter(({family, address}) => {
                return family.toLowerCase().indexOf('v4') >= 0 &&
                    address !== '127.0.0.1'
            })
            .map(({address}) => address);
        var ipAddresses = networkInterfaces.join(', ')
        console.log(ipAddresses);
    """
}
7

I wrote a Node.js module that determines your local IP address by looking at which network interface contains your default gateway.

This is more reliable than picking an interface from os.networkInterfaces() or DNS lookups of the hostname. It is able to ignore VMware virtual interfaces, loopback, and VPN interfaces, and it works on Windows, Linux, Mac OS, and FreeBSD. Under the hood, it executes route.exe or netstat and parses the output.

var localIpV4Address = require("local-ipv4-address");

localIpV4Address().then(function(ipAddress){
    console.log("My IP address is " + ipAddress);
    // My IP address is 10.4.4.137 
});
2
  • shame it doesn't work on windows when the language is not set to english :(
    – Javier G.
    Commented Apr 14, 2017 at 13:22
  • 1
    Thanks for reporting this bug, @JavierG! I have published version 0.0.2 which should fix it. Commented Apr 22, 2017 at 9:31
7

For Linux and macOS uses, if you want to get your IP addresses by a synchronous way, try this:

var ips = require('child_process').execSync("ifconfig | grep inet | grep -v inet6 | awk '{gsub(/addr:/,\"\");print $2}'").toString().trim().split("\n");
console.log(ips);

The result will be something like this:

['192.168.3.2', '192.168.2.1']
0
7

One liner for macOS first localhost address only.

When developing applications on macOS, and you want to test it on the phone, and need your app to pick the localhost IP address automatically.

require('os').networkInterfaces().en0.find(elm => elm.family=='IPv4').address

This is just to mention how you can find out the ip address automatically. To test this you can go to terminal hit

node
os.networkInterfaces().en0.find(elm => elm.family=='IPv4').address

output will be your localhost IP address.

5

For anyone interested in brevity, here are some "one-liners" that do not require plugins/dependencies that aren't part of a standard Node.js installation:

Public IPv4 and IPv6 address of eth0 as an array:

var ips = require('os').networkInterfaces().eth0.map(function(interface) {
    return interface.address;
});

First public IP address of eth0 (usually IPv4) as a string:

var ip = require('os').networkInterfaces().eth0[0].address;
2
  • Keep in mind that these one-liners are platform specific. On OS X, I have en0 and en1 for ethernet and wifi. On Windows, I have Local Area Connection and Wireless Network Connection.
    – xverges
    Commented Jul 29, 2013 at 10:39
  • If you want to know about your public remote IP (On OS X), use: var ip = require('os').networkInterfaces().en0[1].address; Commented Apr 26, 2016 at 13:47
3

Similar to other answers but more succinct:

'use strict';

const interfaces = require('os').networkInterfaces();

const addresses = Object.keys(interfaces)
  .reduce((results, name) => results.concat(interfaces[name]), [])
  .filter((iface) => iface.family === 'IPv4' && !iface.internal)
  .map((iface) => iface.address);
1
  • 1
    just want to mention that you can replace Object.keys(interfaces).reduce(...) with Object.values(interfaces).flat() and it would be the same thing.
    – kimbaudi
    Commented Jul 13, 2019 at 22:55
3

The following solution works for me

const ip = Object.values(require("os").networkInterfaces())
        .flat()
        .filter((item) => !item.internal && item.family === "IPv4")
        .find(Boolean).address;
1
  • 2
    Very nice. Slight tweak in case none is found: const ip = Object.values(require("os").networkInterfaces()).flat().reduce((ip, {family, address, internal}) => ip || !internal && family === 'IPv4' && address, '');
    – x0a
    Commented Nov 8, 2020 at 19:03
3

Google directed me to this question while searching for "Node.js get server IP", so let's give an alternative answer for those who are trying to achieve this in their Node.js server program (may be the case of the original poster).

In the most trivial case where the server is bound to only one IP address, there should be no need to determine the IP address since we already know to which address we bound it (for example, the second parameter passed to the listen() function).

In the less trivial case where the server is bound to multiple IP addresses, we may need to determine the IP address of the interface to which a client connected. And as briefly suggested by Tor Valamo, nowadays, we can easily get this information from the connected socket and its localAddress property.

For example, if the program is a web server:

var http = require("http")

http.createServer(function (req, res) {
    console.log(req.socket.localAddress)
    res.end(req.socket.localAddress)
}).listen(8000)

And if it's a generic TCP server:

var net = require("net")

net.createServer(function (socket) {
    console.log(socket.localAddress)
    socket.end(socket.localAddress)
}).listen(8000)

When running a server program, this solution offers very high portability, accuracy and efficiency.

For more details, see:

3

Based on a comment, here's what's working for the current version of Node.js:

var os = require('os');
var _ = require('lodash');

var ip = _.chain(os.networkInterfaces())
  .values()
  .flatten()
  .filter(function(val) {
    return (val.family == 'IPv4' && val.internal == false)
  })
  .pluck('address')
  .first()
  .value();

The comment on one of the answers above was missing the call to values(). It looks like os.networkInterfaces() now returns an object instead of an array.

1
  • 1
    I <3 lodash. Especially lodash golf! The _.chain(..) can be re-written as _(...), the .filter(..) can be re-written as .where({family: 'IPv4', internal: false}), and you can drop the final value() because .first() does it for you when chaining. Commented Jun 17, 2015 at 22:38
3

Here is a variation of the previous examples. It takes care to filter out VMware interfaces, etc. If you don't pass an index it returns all addresses. Otherwise, you may want to set it default to 0 and then just pass null to get all, but you'll sort that out. You could also pass in another argument for the regex filter if so inclined to add.

function getAddress(idx) {

    var addresses = [],
        interfaces = os.networkInterfaces(),
        name, ifaces, iface;

    for (name in interfaces) {
        if(interfaces.hasOwnProperty(name)){
            ifaces = interfaces[name];
            if(!/(loopback|vmware|internal)/gi.test(name)){
                for (var i = 0; i < ifaces.length; i++) {
                    iface = ifaces[i];
                    if (iface.family === 'IPv4' &&  !iface.internal && iface.address !== '127.0.0.1') {
                        addresses.push(iface.address);
                    }
                }
            }
        }
    }

    // If an index is passed only return it.
    if(idx >= 0)
        return addresses[idx];
    return addresses;
}
3

If you're into the whole brevity thing, here it is using Lodash:

var os = require('os');
var _ = require('lodash');
var firstLocalIp = _(os.networkInterfaces()).values().flatten().where({ family: 'IPv4', internal: false }).pluck('address').first();

console.log('First local IPv4 address is ' + firstLocalIp);

3
var ip = req.headers['x-forwarded-for'] || req.socket.remoteAddress 
1
  • thanks the OP asked for the local IP, but i was looking for this not the local IP so thanks.
    – Takis
    Commented Nov 18, 2021 at 19:21
2

Here's my variant that allows getting both IPv4 and IPv6 addresses in a portable manner:

/**
 * Collects information about the local IPv4/IPv6 addresses of
 * every network interface on the local computer.
 * Returns an object with the network interface name as the first-level key and
 * "IPv4" or "IPv6" as the second-level key.
 * For example you can use getLocalIPs().eth0.IPv6 to get the IPv6 address
 * (as string) of eth0
 */
getLocalIPs = function () {
    var addrInfo, ifaceDetails, _len;
    var localIPInfo = {};
    //Get the network interfaces
    var networkInterfaces = require('os').networkInterfaces();
    //Iterate over the network interfaces
    for (var ifaceName in networkInterfaces) {
        ifaceDetails = networkInterfaces[ifaceName];
        //Iterate over all interface details
        for (var _i = 0, _len = ifaceDetails.length; _i < _len; _i++) {
            addrInfo = ifaceDetails[_i];
            if (addrInfo.family === 'IPv4') {
                //Extract the IPv4 address
                if (!localIPInfo[ifaceName]) {
                    localIPInfo[ifaceName] = {};
                }
                localIPInfo[ifaceName].IPv4 = addrInfo.address;
            } else if (addrInfo.family === 'IPv6') {
                //Extract the IPv6 address
                if (!localIPInfo[ifaceName]) {
                    localIPInfo[ifaceName] = {};
                }
                localIPInfo[ifaceName].IPv6 = addrInfo.address;
            }
        }
    }
    return localIPInfo;
};

Here's a CoffeeScript version of the same function:

getLocalIPs = () =>
    ###
    Collects information about the local IPv4/IPv6 addresses of
      every network interface on the local computer.
    Returns an object with the network interface name as the first-level key and
      "IPv4" or "IPv6" as the second-level key.
    For example you can use getLocalIPs().eth0.IPv6 to get the IPv6 address
      (as string) of eth0
    ###
    networkInterfaces = require('os').networkInterfaces();
    localIPInfo = {}
    for ifaceName, ifaceDetails of networkInterfaces
        for addrInfo in ifaceDetails
            if addrInfo.family=='IPv4'
                if !localIPInfo[ifaceName]
                    localIPInfo[ifaceName] = {}
                localIPInfo[ifaceName].IPv4 = addrInfo.address
            else if addrInfo.family=='IPv6'
                if !localIPInfo[ifaceName]
                    localIPInfo[ifaceName] = {}
                localIPInfo[ifaceName].IPv6 = addrInfo.address
    return localIPInfo

Example output for console.log(getLocalIPs())

{ lo: { IPv4: '127.0.0.1', IPv6: '::1' },
  wlan0: { IPv4: '192.168.178.21', IPv6: 'fe80::aa1a:2eee:feba:1c39' },
  tap0: { IPv4: '10.1.1.7', IPv6: 'fe80::ddf1:a9a1:1242:bc9b' } }
2

Many times I find there are multiple internal and external facing interfaces available (example: 10.0.75.1, 172.100.0.1, 192.168.2.3) , and it's the external one that I'm really after (172.100.0.1).

In case anyone else has a similar concern, here's one more take on this that hopefully may be of some help...

const address = Object.keys(os.networkInterfaces())
    // flatten interfaces to an array
    .reduce((a, key) => [
        ...a,
        ...os.networkInterfaces()[key]
    ], [])
    // non-internal ipv4 addresses only
    .filter(iface => iface.family === 'IPv4' && !iface.internal)
    // project ipv4 address as a 32-bit number (n)
    .map(iface => ({...iface, n: (d => ((((((+d[0])*256)+(+d[1]))*256)+(+d[2]))*256)+(+d[3]))(iface.address.split('.'))}))
    // set a hi-bit on (n) for reserved addresses so they will sort to the bottom
    .map(iface => iface.address.startsWith('10.') || iface.address.startsWith('192.') ? {...iface, n: Math.pow(2,32) + iface.n} : iface)
    // sort ascending on (n)
    .sort((a, b) => a.n - b.n)
    [0]||{}.address;
2

Use:

var os = require('os');
var networkInterfaces = os.networkInterfaces();
var arr = networkInterfaces['Local Area Connection 3']
var ip = arr[1].address;
2
  • npm install ip // install the module var ip = require('ip'); // require the module ip.address() // my ip address Commented May 11, 2015 at 17:46
  • An explanation would be in order. Commented Dec 21, 2020 at 19:12

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.