### Bug Fixes

* Auto release on action ([#33](https://github.com/node-modules/address/issues/33)) ([36b30d3](https://github.com/node-modules/address/commit/36b30d3708bd5fb09dd2e9a9d4741dd9112eb890))

[1.2.2](https://github.com/node-modules/address/compare/v1.2.1...v1.2.2) (2022-12-17)

address
=======

[![NPM version][npm-image]][npm-url]
[![Node.js CI](https://github.com/node-modules/address/actions/workflows/nodejs.yml/badge.svg)](https://github.com/node-modules/address/actions/workflows/nodejs.yml)
[![Test coverage][coveralls-image]][coveralls-url]
[![npm download][download-image]][download-url]

[npm-image]: https://img.shields.io/npm/v/address.svg?style=flat-square
[npm-url]: https://npmjs.org/package/address
[coveralls-image]: https://img.shields.io/coveralls/node-modules/address.svg?style=flat-square
[coveralls-url]: https://coveralls.io/r/node-modules/address?branch=master
[download-image]: https://img.shields.io/npm/dm/address.svg?style=flat-square
[download-url]: https://npmjs.org/package/address

Get current machine IP, MAC and DNS servers.

DNS servers receive from `/etc/resolv.conf`.

## Install

```bash
$ npm install address
```

## Usage

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

```js
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

```js
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

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

### Get DNS servers

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

## License

[MIT](LICENSE.txt)



## Contributors

|[<img src="https://avatars.githubusercontent.com/u/156269?v=4" width="100px;"/> fengmk2](https://github.com/fengmk2) |[<img src="https://avatars.githubusercontent.com/u/1147375?v=4" width="100px;"/> alsotang](https://github.com/alsotang) |[<img src="https://avatars.githubusercontent.com/u/10237910?v=4" width="100px;"/> jkelleyrtp](https://github.com/jkelleyrtp) |[<img src="https://avatars.githubusercontent.com/u/1409643?v=4" width="100px;"/> mariodu](https://github.com/mariodu) |[<img src="https://avatars.githubusercontent.com/u/11351322?v=4" width="100px;"/> mathieutu](https://github.com/mathieutu) |[<img src="https://avatars.githubusercontent.com/u/2139038?v=4" width="100px;"/> zhangyuheng](https://github.com/zhangyuheng) |
| :---: | :---: | :---: | :---: | :---: | :---: |
[<img src="https://avatars.githubusercontent.com/u/1400114?v=4" width="100px;"/> coolme200](https://github.com/coolme200) |[<img src="https://avatars.githubusercontent.com/u/5856440?v=4" width="100px;"/> whxaxes](https://github.com/whxaxes) 

This project follows the git-contributor [spec](https://github.com/xudafeng/git-contributor), auto updated at `Tue Sep 13 2022 09:09:11 GMT+0800`.

Get current machine IP, MAC and DNS servers. 

address

Get current machine IP, MAC and DNS servers.

address

1.2.2 (2022-12-17)

Bug Fixes

address

Install

Usage

Get all addresses: IPv4, IPv6 and MAC

Get an interface info with family

Get DNS servers

License

Contributors

Keywords

FAQs

What is address?

Is address popular?

Is address well maintained?