athea

Repositories Projects Packages

address (1.2.2)

Published 2026-02-24 13:52:34 +00:00 by atheaadmin

Installation

Setup this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install address@1.2.2

or add it to the package.json file:

"address": "1.2.2"

For more information on the npm registry, see the documentation.

About this package

address

Get current machine IP, MAC and DNS servers.

DNS servers receive from /etc/resolv.conf.

Install

$ npm install address

Usage

Get IP is sync and get MAC is async for now.

const address = require('address');

// default interface 'eth' on linux, 'en' on osx.
address.ip();   // '192.168.0.2'
address.ipv6(); // 'fe80::7aca:39ff:feb0:e67d'
address.mac(function (err, addr) {
  console.log(addr); // '78:ca:39:b0:e6:7d'
});

// local loopback
address.ip('lo'); // '127.0.0.1'

// vboxnet MAC
address.mac('vboxnet', function (err, addr) {
  console.log(addr); // '0a:00:27:00:00:00'
});

Get all addresses: IPv4, IPv6 and MAC

address((err, addrs) => {
  console.log(addrs.ip, addrs.ipv6, addrs.mac);
  // '192.168.0.2', 'fe80::7aca:39ff:feb0:e67d', '78:ca:39:b0:e6:7d'
});

address('vboxnet', (err, addrs) => {
  console.log(addrs.ip, addrs.ipv6, addrs.mac);
  // '192.168.56.1', null, '0a:00:27:00:00:00'
});

Get an interface info with family

address.interface('IPv4', 'eth1');
// { address: '192.168.1.1', family: 'IPv4', mac: '78:ca:39:b0:e6:7d' }

Get DNS servers

address.dns((err, addrs) => {
  console.log(addrs);
  // ['10.13.2.1', '10.13.2.6']
});

License

MIT

Contributors

fengmk2	alsotang	jkelleyrtp	mariodu	mathieutu	zhangyuheng
coolme200	whxaxes

This project follows the git-contributor spec, auto updated at Tue Sep 13 2022 09:09:11 GMT+0800.

Dependencies

Development Dependencies

ID	Version
@types/node	14
egg-bin	^5.6.1
eslint	^8.30.0
eslint-config-egg	^12.1.0
git-contributor	^1.1.0
mm	*
runscript	^1.4.0
typescript	4

Keywords

address ip ipv4 mac

Details

npm

2026-02-24 13:52:34 +00:00

1

fengmk2

Project Site

MIT

latest

4.4 KiB

Assets (1)

address-1.2.2.tgz 4.4 KiB

Versions (1) View all

1.2.2 2026-02-24