Skip to content

JoeysephDJ/react-native-lan-port-scanner

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

react-native-lan-port-scanner

A simple port scanner for react native.

npm version npm MIT
Platform - Android Platform - iOS

Installation

This package requires react-native-tcp as dependency. Please follow below steps to install:

yarn add gajjartejas/react-native-tcp react-native-lan-port-scanner

or

npm install gajjartejas/react-native-tcp react-native-lan-port-scanner

after you have to install pods

npx pod-install

For Android

You have to add below permission to AndroidManifest.xml file

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

For iOS

Make a sure you have to add NSExceptionAllowsInsecureHTTPLoads to localhost in case of insecure connection info.plist.

<dict>
	<key>NSExceptionDomains</key>
	<dict>
		<key>localhost</key>
		<dict>
			<key>NSExceptionAllowsInsecureHTTPLoads</key>
			<true/>
		</dict>
	</dict>
</dict>

Usage

Scan network's hosts with specific ports

import LanPortScanner, { LSConfig } from 'react-native-lan-port-scanner';

//Returns `LSNetworkInfo`
const networkInfo = await LanPortScanner.getNetworkInfo();

let config: LSConfig = {
  networkInfo: networkInfo,
  ports: [80, 8085], //Specify port here
  timeout: 1000, //Timeout for each thread in ms
  threads: 150, //Number of threads
};
LanPortScanner.startScan(
  config,
  (totalHosts: number, hostScanned: number) => {
    console.log(hostScanned / totalHosts); //Show progress
  },
  (result) => {
    console.log(result); //This will call after new ip/port found.
  },
  (results) => {
    console.log(results); // This will call after scan end.
  }
);

To scan specific host with port

//Returns `LSSingleScanResult`
let result = await LanPortScanner.scanHost('192.168.1.1', 80, 1000);

To get network info

//Returns `LSNetworkInfo`
const networkInfo = await LanPortScanner.getNetworkInfo();

API

Types

LSConfig

Used to scan multiple hosts/ports.

Property Type Description
networkInfo LSNetworkInfo Contains ip address and subnet mask to scan.
ports number[] or undefined Ports to scan, default: [80, 443]
timeout number or undefined Timeout for each thread in ms, default: 1000 ms
threads number or undefined Number of threads, default: 150
logging boolean Enable or disable logging, default: false

LSNetworkInfo

Used to generate ip ranges for scanning.

Property Type Description
ipAddress string IP Address
subnetMask string Subnet mask

LSNetworkInfoExtra

Contains ip ranges for scanning purpose.

Property Type Description
ipAddress string IP Address
subnetMask string Subnet mask.
subnetConv string A CIDR prefix length for a valid IPv4 netmask or null if the netmask is not valid.
firstHost string The network address for a given IPv4 interface and netmask in CIDR notation.
lastHost string The broadcast address for a given IPv4 interface and netmask in CIDR notation.
firstHostHex string First host address in hex representation.
lastHostHex string Last host address in hex representation.
ipRange string[] Array of ip addresses.

LSSingleScanResult

Returns after host/port found.

Property Type Description
ip string IP Address
port number Subnet mask

LSScanResult

Returns after scan complete.

Property Type Description
ip string IP Address
ports number[] Subnet mask

Methods

getNetworkInfo()

Returns LSNetworkInfo object.

Example:

const networkInfo = await LanPortScanner.getNetworkInfo();

getNetworkInfo()

Takes LSNetworkInfo and scan all hosts for specified ports.

generateIPRange()

Takes LSNetworkInfo, generates ip address, ports array and return LSNetworkInfoExtra object.

Example:

const networkInfo = await LanPortScanner.getNetworkInfo();
const ipRangeInfo = generateIPRange(config.networkInfo);

scanHost()

Scan single host with port, returns LSSingleScanResult

Example:

let result = await LanPortScanner.scanHost('192.168.1.1', 80, 1000);

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT

Credits

Shift8 Web for awsome tutorial.

react-native-netinfo by The React Native Community

Local area icons created by Eucalyp - Flaticon

About

Fix the react-native-lan-port-scanner to do custom IP ranges.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 35.3%
  • Java 33.7%
  • Objective-C 13.4%
  • Ruby 8.3%
  • JavaScript 6.0%
  • Objective-C++ 3.3%