Test if a port on a remote system is reachable (without telnet)

369

173

In the old days, we used telnet to see if a port on a remote host was open: telnet hostname port would attempt to connect to any port on any host and give you access to the raw TCP stream.

These days, the systems I work on do not have telnet installed (for security reasons), and all outbound connections to all hosts are blocked by default. Over time, it's easy to lose track of which ports are open to which hosts.

Is there another way to test if a port on a remote system is open – using a Linux system with a limited number of packages installed, and telnet is not available?

Steve HHH

Posted 2013-07-19T16:54:10.383

Reputation: 5 590

Related: check status of one port on remote host at SO

– kenorb – 2015-12-30T14:50:25.863

I was having this same issue. The answer by @Subhranath Chunder below helped. However, I then found out that installing Telnet was a small matter of running brew install telnet. So I expect Linux users can do the same with yum and apt-get. – Mig82 – 2019-09-26T09:22:16.183

Answers

297

Bash has been able to access TCP and UDP ports for a while. From the man page:

/dev/tcp/host/port
    If host is a valid hostname or Internet address, and port is an integer port number
    or service name, bash attempts to open a TCP connection to the corresponding socket.
/dev/udp/host/port
    If host is a valid hostname or Internet address, and port is an integer port number
    or service name, bash attempts to open a UDP connection to the corresponding socket.

So you could use something like this:

xenon-lornix:~> cat < /dev/tcp/127.0.0.1/22
SSH-2.0-OpenSSH_6.2p2 Debian-6
^C pressed here

Taa Daa!

lornix

Posted 2013-07-19T16:54:10.383

Reputation: 9 633

This also seems to work in MinGW. For instance, a remote VNC server on 192.168.2.100 responds with "RFB 003.008" by using "cat < /dev/tcp/192.168.2.100/5900".

– Peter Mortensen – 2015-07-21T11:26:08.983

However on ports that were not open it timed out after 22 seconds (tried on Ubuntu 14.04 (Trusty Tahr) for a remote server). Interestingly, the timeout period is much shorter than the one for nc (see thnee's answer).

– Peter Mortensen – 2015-07-21T13:00:02.547

// , Ohhh, this is one of those days I love this site. Here's the part of the bash manual for this answer: https://www.gnu.org/software/bash/manual/bashref.html#Redirections

– Nathan Basanese – 2016-01-23T05:31:10.133

@lornix, can you please tell me, why nc works on my box, but your solution not working: $ cat < /dev/tcp/10.0.xx.xx/1433 cat: -: Connection reset by peer $ nc -zv -w5 10.0.xx.xx 1433 Connection to 10.0.xx.xx 1433 port [tcp/ms-sql-s] succeeded! – Alexandr – 2016-06-10T07:40:15.770

@Alexandr, perhaps you're connecting in a different way. Your nc command includes the -z flag, indicating 'zero-I/O-mode'. cat may be connecting and requesting some sort of I/O, whereas the nc (with -z) usage just strokes the port to see if it's alive. – lornix – 2016-06-10T08:33:31.020

1@lornix, ok, but in this case I have to get the same result with use nc without -z option, but it still does not work: # nc -v -w5 127.0.0.1 18080 Connection to 127.0.0.1 18080 port [tcp/*] succeeded! # cat < /dev/tcp/127.0.0.1/18080 Just hangs without any result. Just want to understand when I can use "/dev/tcp/host/port" option – Alexandr – 2016-06-14T07:09:40.103

5@Alexandr... actually, "hangs without any result" is pretty much expected behavior. cat is waiting for input. nc has extra smarts to enable it to sense no-data pending and stops trying. cat isn't quite as smart. Try cat < /dev/tcp/localhost/22, you should get your sshd header. Evidently, your process on port 18080 waits for something to come in, before sending anything. Port 22 (ssh) greets you with it's version and whatnot. Try it out! – lornix – 2016-06-14T08:44:44.530

1@lornix, thank you very much for explanation! Now the restriction is clear. I think using nc should be a preferred way to check ports. – Alexandr – 2016-06-14T14:29:35.137

Not working on Ubuntu 16.04.1 – Daniel Andrei Mincă – 2016-10-12T07:42:41.777

@MincăDanielAndrei Make sure you're using bash. No idea if this works on other shells, Ubuntu may have substituted a different shell as your default, depending on the whims of The Mark. – lornix – 2016-10-12T09:45:59.247

@lornix I'm using GNU bash, version 4.3.46(1)-release (x86_64-pc-linux-gnu). The problem is that /dev/tcp/ does not exist. I got /dev everything except /tcp and /udp . – Daniel Andrei Mincă – 2016-10-12T11:06:25.007

Bash emulates the /dev/tcp and /dev/udp paths when used in redirections. (From Bash Man Page v4.4.0, line 1344. Should be in similar location in yours). Those paths don't exist for other programs or even as files. So 'cat /dev/tcp/localhost/22' will error out, while 'cat < /dev/tcp/localhost/22' will show your SSH server header. – lornix – 2016-10-13T02:08:17.597

Pow, this is the way to test Ansible's wait_for command on the command line => http://docs.ansible.com/ansible/wait_for_module.html

– Elijah Lynn – 2017-06-16T07:43:01.447

doesn't work under CentOS. – Scott Chu – 2017-07-19T04:03:50.130

2This was incredibly helpful when working with a docker container that had nothing installed. Was able to quickly verify that the container had access to non-containerized DB via DNS. Example: cat < /dev/tcp/hostname/5432 – Michael Hobbs – 2018-10-24T14:09:52.267

Look further down in the "answers" and @sim has a great example of applying this answer. His bash fu is strong. (btw - this does work under CentOS.) – Beege – 2019-03-17T18:39:48.523

418

Nice and verbose! From the man pages.
Single port:

nc -zv 127.0.0.1 80

Multiple ports:

nc -zv 127.0.0.1 22 80 8080

Range of ports:

nc -zv 127.0.0.1 20-30

Subhranath Chunder

Posted 2013-07-19T16:54:10.383

Reputation: 4 281

7Seems to be far the bestest answer, thanks. ;-) – lpapp – 2014-11-26T15:42:35.040

2Perfect! This outputs a clear connection succeeded/failed message with just the one line. Note that multiple ranges don't appear to work for my nc version; only the first range is tested. – davidjb – 2015-05-18T03:42:07.917

6

This hanged when tried on Ubuntu 14.04 (Trusty Tahr) for a remote server (same LAN) for closed ports (it timed out after 127 seconds) - thus not very suitable in scripts. It did work though for a service that had a port open. Using option "-w2" could be the solution.

– Peter Mortensen – 2015-07-21T12:36:25.123

6Use -u option for UDP ports. – Efren – 2016-09-21T00:10:05.153

8On version 6.4 of ncat -z is not recognized. I was able to do without z – smishra – 2017-04-06T17:18:58.330

5You can check multiple ranges with: nc -zv 127.0.0.1 22,80,8080,20-30,443-446 (nc Version: 1.107-4). – bobbel – 2017-07-06T16:55:25.650

1I like how the man page for nc says The nc (or netcat) utility is used for just about anything under the sun involving TCP, UDP, or UNIX-domain sockets. – A Child of God – 2018-03-23T21:35:25.577

Doesn't seem to be bundled with Centos v6 – Janac Meena – 2019-02-05T21:34:02.393

2that's great, but only if nc is actually installed :P the accepted answer via bash works almost everywhere, more GNU/Linux servers have bash than nc – Petr – 2019-07-26T10:49:20.847

104

Netcat is a useful tool:

nc 127.0.0.1 123 &> /dev/null; echo $?

Will output 0 if port 123 is open, and 1 if it's closed.

thnee

Posted 2013-07-19T16:54:10.383

Reputation: 1 551

2

This hanged when tried on Ubuntu 14.04 (Trusty Tahr) for a remote server (same LAN) for closed ports (it timed out after about 127 seconds) - thus not very suitable in scripts. It did work though for a service that had a port open, returning 0. Using option "-w2" could be the solution.

– Peter Mortensen – 2015-07-21T13:06:26.867

1I think -G 2 would be more appropriate for TCP timeout – A B – 2015-08-24T21:45:27.690

@PeterMortensen Connection timeout is a generic network problem, nothing particular to netcat. Configure your desired timeout with the -w flag. – thnee – 2015-10-20T18:24:46.640

@thnee -w doesn't seem to work for connections. See here and here. Quote -w # => Timeout after # seconds. Note that -w also sets the network inactivity timeout. This does not have any effect until standard input closes […] This works for final net reads but not for connections.

– 1.61803 – 2016-01-14T12:27:05.867

For those who don't know bash well, what does the &> /dev/null; echo $? do? I noticed that without that addition, the command produces no output. – connorbode – 2016-01-14T14:52:14.403

&> /dev/null redirects all output so it wont show up, and echo $? shows the resulting status code of the previous command executed. – thnee – 2016-01-18T08:35:05.140

How to use this statement for a conditional -like if- operator? if[ WhatGoesHere == 1] – İsmail Yavuz – 2016-12-20T13:22:27.157

This is a far more elegant and scriptable answer than my own. It is unfortunate for me that the security-conscious sysadmins who withheld telnet also withheld nc (though – strangely – not curl or wget). – Steve HHH – 2013-07-19T19:51:12.330

Yes that is completely arbitrary and silly. – thnee – 2013-07-19T20:10:09.050

3Let the FOR statements begin! – Chad Harrison – 2013-07-19T21:37:35.217

61

The simplest method, without making use of another tool, such as socat, is as described in @lornix's answer above. This is just to add an actual example of how one would make use of the psuedo-device /dev/tcp/... within Bash if you wanted to, say, test if another server had a given port accessible via the command line.

Examples

Say I have a host on my network named skinner.

$ (echo > /dev/tcp/skinner/22) >/dev/null 2>&1 \
    && echo "It's up" || echo "It's down"
It's up

$ (echo > /dev/tcp/skinner/222) >/dev/null 2>&1 && \
    echo "It's up" || echo "It's down"
It's down

The reason you want to wrap the echo > /dev/... in parentheses like this, (echo > /dev/...) is because if you don't, then with tests of connections that are down, you'll get these types of messages showing up.

$ (echo > /dev/tcp/skinner/223) && echo hi
bash: connect: Connection refused
bash: /dev/tcp/skinner/223: Connection refused

These can't simply be redirected to /dev/null since they're coming from the attempt to write out data to the device /dev/tcp. So we capture all that output within a sub-command, i.e. (...cmds...) and redirect the output of the sub-command.

slm

Posted 2013-07-19T16:54:10.383

Reputation: 7 449

1This is excellent. Wish it would get voted up to the top. I only read this far down the page because I accidentally scrolled before closing it. – Still.Tony – 2015-02-12T13:44:31.100

@Okuma.Tony - yes that's always an issue with Q's that have many answers 8-). Thanks for the feedback though, it's appreciated. – slm – 2015-02-12T14:26:28.977

48

I found that curl may get the job done in a similar way to telnet, and curl will even tell you which protocol the listener expects.

Construct an HTTP URI from the hostname and port as the first argument to curl. If curl can connect, it will report a protocol mismatch and exit (if the listener isn't a web service). If curl cannot connect, it will time out.

For example, port 5672 on host 10.0.0.99 is either closed or blocked by a firewall:

$ curl http://10.0.0.99:5672
curl: (7) couldn't connect to host

However, from a different system, port 5672 on host 10.0.0.99 can be reached, and appears to be running an AMQP listener.

$ curl http://10.0.0.99:5672
curl: (56) Failure when receiving data from the peer
AMQP

It's important to distinguish between the different messages: the first failure was because curl could not connect to the port. The second failure is a success test, though curl expected an HTTP listener instead of an AMQP listener.

Steve HHH

Posted 2013-07-19T16:54:10.383

Reputation: 5 590

This may be incorrect. I am havng a tomcat service running, but getting 404 error.

curl -k https://192.168.194.4:6443

<html><head><title>Apache Tomcat/7.0.34 - Error report</title><style><!--H1 --- HR {color : #525D76;}--></style> </head><body><h1>HTTP Status 404 - /</h1><HR size="1" noshade="noshade"><p><b>type</b> Status report</p><p><b>message</b> <u>/</u></p><p><b>description</b> <u>The requested resource is not available.</u></p><HR size="1" noshade="noshade"><h3>Apache Tomcat/7.0.34</h3></body></html>

– Mohammad Shahid Siddiqui – 2015-06-02T06:30:50.477

See my post with similar approach.

– kenorb – 2015-12-30T14:49:27.993

5If curl isn't available, wget might be. wget -qS -O- http://ip.add.re.ss:port should effectively do the same thing. – a CVn – 2013-07-19T17:52:09.300

4This even works with a hostname, ex. curl myhost:22. – 에이바 – 2014-02-25T16:17:58.623

13

[admin@automation-server 1.2.2]# nc -v -z -w2 192.168.193.173 6443
nc: connect to 192.168.193.173 port 6443 (tcp) failed: Connection refused

[admin@automation-server 1.2.2]# nc -v -z -w2 192.168.194.4 6443
Connection to 192.168.194.4 6443 port [tcp/sun-sr-https] succeeded!

Hope it solves your problem :)

Mohammad Shahid Siddiqui

Posted 2013-07-19T16:54:10.383

Reputation: 271

1Yes, this is better - timing out almost immediately for closed ports. – Peter Mortensen – 2015-07-21T12:38:49.040

1Does this always use TCP or is there a way to get it to check UDP? – kmoe – 2016-01-02T17:09:50.823

11

Here is one-liner:

</dev/tcp/localhost/11211 && echo Port is open || echo Port is closed

using Bash syntax explained in @lornix answer.

For more info, check: Advanced Bash-Scripting Guide: Chapter 29. /dev and /proc.

kenorb

Posted 2013-07-19T16:54:10.383

Reputation: 16 795

what is the timeout for closed ports? – Tilo – 2018-12-12T17:42:26.287

8

I was struggling for a whole day because none of these answers seemed to work for me. The problem is that the most recent version of nc no longer has the -z flag, whereas direct access via TCP (as according to @lornix and @slm) fails when the host is not reachable. I eventually found this page, where I finally found not one but two working examples:

  1. nc -w1 127.0.0.1 22 </dev/null

    (the -w flag takes care of the timeout, and the </dev/null replaces the -z flag)

  2. timeout 1 bash -c '(echo > /dev/tcp/127.0.0.1/22) >/dev/null 2>&1'

    (the timeout command takes care of the timeout, and the rest is from @slm)

Then, simply use && and/or || (or even $?) to extract the result. Hopefully, somebody will find this information useful.

Azukikuru

Posted 2013-07-19T16:54:10.383

Reputation: 81

6

Combining the answers from @kenorb and @Azukikuru you could test port open/closed/firewalled.

timeout 1 bash -c '</dev/tcp/127.0.0.1/22 && echo Port is open || echo Port is closed' || echo Connection timeout

Another approach with curl for reaching any port

curl telnet://127.0.0.1:22

Miguel Ferreira

Posted 2013-07-19T16:54:10.383

Reputation: 161

4

Here's a function that will pick one of the methods depending on what's installed on your system:

# Check_port <address> <port> 
check_port() {
if [ "$(which nc)" != "" ]; then 
    tool=nc
elif [ "$(which curl)" != "" ]; then
     tool=curl
elif [ "$(which telnet)" != "" ]; then
     tool=telnet
elif [ -e /dev/tcp ]; then
      if [ "$(which gtimeout)" != "" ]; then  
       tool=gtimeout
      elif [ "$(which timeout)" != "" ]; then  
       tool=timeout
      else
       tool=devtcp
      fi
fi
echo "Using $tool to test access to $1:$2"
case $tool in
nc) nc -v -G 5 -z -w2 $1 $2 ;;
curl) curl --connect-timeout 10 http://$1:$2 ;;
telnet) telnet $1 $2 ;;
gtimeout)  gtimeout 1 bash -c "</dev/tcp/${1}/${2} && echo Port is open || echo Port is closed" || echo Connection timeout ;;
timeout)  timeout 1 bash -c "</dev/tcp/${1}/${2} && echo Port is open || echo Port is closed" || echo Connection timeout ;;
devtcp)  </dev/tcp/${1}/${2} && echo Port is open || echo Port is closed ;;
*) echo "no tools available to test $1 port $2";;
esac

}
export check_port

Robert Boyd

Posted 2013-07-19T16:54:10.383

Reputation: 41

why would you set tool, only to use it later in the case statement. isn't it simpler to check which tool is available and use it immediately in the if block? – Mark Lybarger – 2019-11-05T15:46:54.513

2

It shouldn't be available on your box, but try with nmap.

peperunas

Posted 2013-07-19T16:54:10.383

Reputation: 801

4nmap is a good tool, but not available on these systems. Rather than download nmap, compile it, install it to my home directory, then copy it to all the other systems, I was hoping to find a way using existing tools available in most Linux installations. – Steve HHH – 2013-07-19T17:16:58.400

1

for reference, expanding on @peperunas' answer:

the way to use nmap to test, is:

nmap -p 22 127.0.0.1

(example above uses localhost for demonstration purposes)

user138278

Posted 2013-07-19T16:54:10.383

Reputation: 265

0

If you've to test more than on system you may use our test tool dda-serverspec (https://github.com/DomainDrivenArchitecture/dda-serverspec-crate) for such tasks. You may define your expectation

{:netcat [{:host "mywebserver.com" :port "443"}
          {:host "telnet mywebserver.com" :port "80"}
          {:host "telnet mywebserver.com" :port "8443"}]}

and test these expectation either against localhost or against remote hosts (connect by ssh). For remote tests you've to define a targets:

{:existing [{:node-name "test-vm1"
             :node-ip "35.157.19.218"}
            {:node-name "test-vm2"
             :node-ip "18.194.113.138"}]
 :provisioning-user {:login "ubuntu"}}

You may run the test with java -jar dda-serverspec.jar --targets targets.edn serverspec.edn

Under the hood we're using netcat as proprosed above ...

jerger

Posted 2013-07-19T16:54:10.383

Reputation: 1