hosts 에 있는 이름이 nslookup 에선 NXDOMAIN, ping 은 되는 이유Why a Name in hosts Gives NXDOMAIN in nslookup but Works with ping
hosts 에 든 이름이 nslookup 에서 NXDOMAIN 으로 나오는 이유를 알고 확인 도구를 가리게 한다.
맥에서 localhost 한 이름을 놓고 ping·dscacheutil·파이썬·node dns.lookup·curl 은 hosts 의 주소를 받았고 dig·nslookup·host·node dns.resolve4 는 DNS 서버에 물어 NXDOMAIN 또는 ENOTFOUND 를 받았다.
hosts 를 확인할 때는 nslookup 대신 ping·dscacheutil 을 쓰고, 스크립트에는 dig 말고 시스템 해석 경로(ping·curl·dns.lookup)를 쓴다.
한 줄 요약: 이 맥에서 nslookup·dig·host 는 hosts 를 읽지 않고 DNS 서버에만 물어 NXDOMAIN 이 나왔다. hosts 에 든 이름은
ping이나dscacheutil로 본다.
바로 할 것: 터미널에서 nslookup localhost 와 dscacheutil -q host -a name localhost 를 차례로 친다. 앞은 NXDOMAIN, 뒤는 127.0.0.1 이 나온다. 같은 hosts 줄을 두 도구가 서로 다르게 읽은 것이다. 내가 적은 이름으로 보려면 두 명령에서 localhost 만 그 이름으로 바꿔 똑같이 비교하면 된다(이 글은 기존 줄로만 확인했다).
NXDOMAIN 은 DNS 서버가 “그런 이름은 모른다”고 답했다는 뜻이다. 이 맥의 /etc/hosts 에 원래 들어 있는 localhost 로 확인한 화면은 이랬다(macOS 26.6.2).
$ nslookup localhost
Server: <DNS-IP>
Address: <DNS-IP>#53
** server can't find localhost: NXDOMAIN
같은 이름을 ping localhost 로 보내면 127.0.0.1 로 나간다. 둘 다 맞는 결과다. 서로 다른 곳에 물어서 답이 다를 뿐이다.
누가 hosts 를 읽고 누가 안 읽나
한 이름(localhost)을 도구별로 물어 본 결과다.
| 도구 | 결과 | 어디에 묻나(결과 차이로 세운 분류) |
|---|---|---|
ping -c1 localhost |
127.0.0.1 로 전송 | 시스템 해석기(hosts 를 거쳐 푸는 OS 의 기본 경로) |
dscacheutil -q host -a name localhost |
::1 과 127.0.0.1 |
시스템 해석기 |
파이썬 socket.getaddrinfo |
127.0.0.1, ::1 |
시스템 해석기 |
node dns.lookup |
127.0.0.1, ::1 |
시스템 해석기 |
curl http://localhost:5878/ |
200, 접속 IP 127.0.0.1 | 시스템 해석기 |
dig localhost |
status: NXDOMAIN |
DNS 서버만 |
nslookup localhost |
server can't find localhost: NXDOMAIN |
DNS 서버만 |
host localhost |
Host localhost not found: 3(NXDOMAIN) |
DNS 서버만 |
node dns.resolve4 |
ENOTFOUND |
DNS 서버만 |
curl 행은 다른 터미널에서 python3 -m http.server 5878 --bind 127.0.0.1 로 서버를 먼저 띄워 두고 시험했다.
dig 의 맨페이지는 “dig will try each of the servers listed in /etc/resolv.conf” 라고 적는다. 즉 DNS 서버를 순서대로 물어볼 뿐 hosts 파일은 목록에 없다. nslookup 이 물은 DNS 서버는 출력의 Server 줄에 나온 주소였고, 그 서버가 localhost 를 모른다고 답했다.
broadcasthost 도 같았다. dscacheutil 은 255.255.255.255 를 냈고 dig broadcasthost 는 NXDOMAIN 이었다. 반대로 진짜 도메인 example.com 은 dig +short 가 2줄을 냈고 파이썬 getaddrinfo 도 풀었다. 시험한 이름에서는 DNS 에 있는 이름(example.com)은 두 경로 모두 풀렸고, hosts 에만 있는 이름(localhost·broadcasthost)은 시스템 경로에서만 풀렸다. 서로 다른 두 이름이 같은 방향으로 갈렸으니, 이름이 아니라 도구가 결과를 가른 것으로 읽힌다(이 글의 해석).
시스템 경로 확인 명령은 이렇게 생겼다
시스템이 이름을 어떤 주소로 푸는지 보는 명령은 둘 중 하나면 된다. ping 은 이름 해석을 보는 용도이고, 상대가 응답하느냐는 별개다.
$ dscacheutil -q host -a name localhost
name: localhost
ipv6_address: ::1
name: localhost
ip_address: 127.0.0.1
$ ping -c1 localhost
PING localhost (127.0.0.1): 56 data bytes
스크립트에서 이걸 모르고 쓰면
확인 도구를 스크립트에 넣을 때 세 가지가 조용히 틀어진다.
dig +short 이름은 NXDOMAIN 이어도 출력이 없고 종료 코드가 0 이었다(시험에서[rc=0]).if dig +short ...로 존재 여부를 가르면 시험에서처럼 NXDOMAIN 도 성공으로 읽는다(DNS 서버에 닿지 못해 시간이 초과된 경우는 별개다.+short없이dig @127.0.0.1 localhost를 시험했더니 종료 코드 9 였다). 같은 상황에서nslookup과host는 종료 코드 1 이었다.dscacheutil은 존재하지 않는 이름(no-such-name.invalid)에 출력 0바이트에 종료 코드 0 이었다. 종료 코드로 존재를 가를 수 없고 출력이 비었는지를 봐야 한다.- node 에서 hosts 의 이름을 풀어야 하는데
dns.resolve4를 쓰면ENOTFOUND가 난다.dns.lookup은 풀린다. 이름이 비슷해서 헷갈리지만 둘의 경로가 다르다.
hosts 에 개발용 이름을 적어 두는 환경이라면 스크립트의 확인에는 ping -c1, curl, dns.lookup, 파이썬 getaddrinfo 같은 시스템 경로를 쓴다. 진짜 DNS 레코드를 보려고 할 때만 dig 를 쓴다.
시험 범위와 한계
- 환경은 macOS 26.6.2, DiG 9.10.6, node v26.7.0, 파이썬 3.14.7, curl 8.7.1 이다. 시험 스크립트를 두 번 실행해 출력이 같았다.
- 모든 시험은 이 맥의 /etc/hosts 에 이미 들어 있는
localhost·broadcasthost줄로 했다. 이 글은 ’어느 도구가 hosts 를 읽는가’를 다루며, 줄을 새로 적어 넣는 시험은 하지 않았다. - 시험하지 않은 것: 리눅스·윈도, VPN·/etc/resolver 설정.
- 검색 결과는 요약만 보았고 본문은 열지 않았다. 맨페이지는 로컬에서 직접 읽었다.
세 줄 요약
- 이름이 hosts 에만 있으면 nslookup·dig·host 는 NXDOMAIN 을, 시스템 경로 도구는 주소를 낸다.
dig +short와dscacheutil은 이름이 없어도 종료 코드 0 이라 스크립트의 판정에 못 쓴다.- node 는
dns.lookup이 hosts 를 거치고dns.resolve4는 거치지 않는다.
Help a reader who sees NXDOMAIN from nslookup for a name that is in hosts understand why and choose the right checking tool.
On the Mac, for the single name localhost, ping, dscacheutil, Python, node dns.lookup and curl received the address from hosts, while dig, nslookup, host and node dns.resolve4 asked a DNS server and got NXDOMAIN or ENOTFOUND.
To check a hosts entry, use ping or dscacheutil instead of nslookup, and in scripts use system-path tools (ping, curl, dns.lookup) instead of dig.
Contents
One-line summary: On this Mac, nslookup, dig and host do not read hosts and ask only a DNS server, so NXDOMAIN is normal. Check a name in hosts with
pingordscacheutil.
Do this now: In a terminal, run nslookup localhost and then dscacheutil -q host -a name localhost. The first gives NXDOMAIN and the second gives 127.0.0.1. The two tools read the same hosts line differently. To see it with a name you wrote yourself, swap localhost for that name in both commands and compare the same way (this article checked only the existing lines).
NXDOMAIN means a DNS server answered “I don’t know that name”. The screen below came from localhost, which was already in this Mac’s /etc/hosts (macOS 26.6.2).
$ nslookup localhost
Server: <DNS-IP>
Address: <DNS-IP>#53
** server can't find localhost: NXDOMAIN
Sending the same name with ping localhost goes to 127.0.0.1. Both results are correct. They simply asked different places.
Who reads hosts and who does not
This is what happened when one name (localhost) was looked up with each tool.
| Tool | Result | Where it asks (grouping inferred from the differing results) |
|---|---|---|
ping -c1 localhost |
sent to 127.0.0.1 | system resolver (the OS default path, which goes through hosts) |
dscacheutil -q host -a name localhost |
::1 and 127.0.0.1 |
system resolver |
Python socket.getaddrinfo |
127.0.0.1, ::1 |
system resolver |
node dns.lookup |
127.0.0.1, ::1 |
system resolver |
curl http://localhost:5878/ |
200, connected IP 127.0.0.1 | system resolver |
dig localhost |
status: NXDOMAIN |
DNS server only |
nslookup localhost |
server can't find localhost: NXDOMAIN |
DNS server only |
host localhost |
Host localhost not found: 3(NXDOMAIN) |
DNS server only |
node dns.resolve4 |
ENOTFOUND |
DNS server only |
The curl row was tested with a server started first in another terminal: python3 -m http.server 5878 --bind 127.0.0.1.
The dig man page says “dig will try each of the servers listed in /etc/resolv.conf”. So it just asks the DNS servers in order, and the hosts file is not on that list. The DNS server nslookup asked was the address on the Server line of its output, and that server answered that it did not know localhost.
broadcasthost behaved the same. dscacheutil returned 255.255.255.255 and dig broadcasthost returned NXDOMAIN. In contrast, for the real domain example.com, dig +short printed 2 lines and Python getaddrinfo resolved it too. For the names tested, a name that exists in DNS (example.com) resolved through both paths, while names only in hosts (localhost, broadcasthost) resolved only through the system path. Two different names split the same way, so it looks like the tool, not the name, decides the result (this article’s interpretation).
What the system-path check commands look like
Either of these two shows what address the system resolves a name to. ping is here to show name resolution; whether the other side replies is a separate matter.
$ dscacheutil -q host -a name localhost
name: localhost
ipv6_address: ::1
name: localhost
ip_address: 127.0.0.1
$ ping -c1 localhost
PING localhost (127.0.0.1): 56 data bytes
What goes wrong silently in scripts
Three things go quietly wrong when you put these tools in a script.
dig +short nameprinted nothing for NXDOMAIN and the exit code was 0 ([rc=0]in the test). If you decide existence withif dig +short ..., you read NXDOMAIN as success, as in the test (a timeout because no DNS server could be reached is different:dig @127.0.0.1 localhostwithout+shortgave exit code 9). In the same situationnslookupandhostexited with 1.- For a nonexistent name (
no-such-name.invalid),dscacheutilprinted 0 bytes with exit code 0. You cannot tell existence from the exit code; look at whether the output is empty. - In node, if you must resolve a name from hosts and use
dns.resolve4, you getENOTFOUND.dns.lookupresolves it. The names look alike, but they take different paths.
If your environment keeps development names in hosts, use system paths such as ping -c1, curl, dns.lookup or Python getaddrinfo for checks in scripts. Use dig only when you want the actual DNS records.
Test scope and limits
- The environment was macOS 26.6.2, DiG 9.10.6, node v26.7.0, Python 3.14.7 and curl 8.7.1. The test script was run twice and the outputs were the same.
- All tests used the
localhostandbroadcasthostlines already in this Mac’s /etc/hosts. This article covers “which tool reads hosts”, and I did not test writing a new line. - Not tested: Linux, Windows, VPN and /etc/resolver settings.
- Only search result summaries were viewed, not the pages themselves. The man page was read locally.
Three-line summary
- If a name is only in hosts, nslookup, dig and host return NXDOMAIN while system-path tools return an address.
dig +shortanddscacheutilexit with 0 even when the name is missing, so they cannot be used for decisions in scripts.- In node,
dns.lookupgoes through hosts anddns.resolve4does not.