Skip to content
A health check/port detect tool for small or medium cluster using syn-scan and raw socket
C++ Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Nurse is a multithread health check/port detect tool for small/medium cluster using tcp syn-scan(syn, syn-ack, rst), for those unstable ports, it can send Alert message via DingTalk Robot Api.

Why Nurse?

Health check is common in many tools, like Load Balancing or Service Discovery, even some Monitor Systems. But most of them are too heavy to use, sometimes we(OP/Devops) just want a simple monitor tool which can alert us when the server crashed and when it recoverd, to help us decide whether further operations needed, especially for small teams with no well-established monitor systems. That's why Nurse is introduced here.

It's simple, only one main file with three header files, no complex dependency.

It's easy, combined with naming service and crontab it can adjust targets automatically.

It's rapid, only few milliseconds needed for hundreds targets, and alert immediately


Linux env, gcc version > 4.8, curl-devel


cd nusrse && make, if no error, nurse will be generated in the same directory.


./nurse -h
Usage: ./nurse -[frh]
	-f	file contains detect target with format:[ip:port\tserv_name], ie.:	test
	-r	dingding robot url
	-h	print this help message
For any questions pls feel free to contact

NOTICE: It requires root privilege to run because using raw socket. For how does Nurse work, you can refer Using raw socket to do port scan(1) and Using raw socket to do port scan(2)

To get a DingTalk Robot url you can refer DingTalk Open Api. After adding a robot you can get an url, using as an example.

Detecting targets are organized in a text file, for example:

cat detect_host.txt  classify  rnncn

To run nurse, using:

./nurse -f ./detect_host.txt -r > log.txt 2>&1 &

If every thing is ok, it will log like this:

Nurse log

If some ports are unstable, nurse will send alert message like this:

Nurse alert


Now Nurse is just a simple health monitor tool on single server with little configuration for hundreds targets, if needed, it can be extended for larger cluster and support more alert methods.

You can’t perform that action at this time.