Debian 13 강좌 / 연결 실패 진단: DNS·포트·HTTP 구분
Debian 13에서 서버에 연결되지 않을 때는 주소와 경로, 이름 조회, 수신 포트, HTTP 응답을 차례로 확인하면 원인을 좁힐 수 있습니다. 서버 내부에서 접속된다는 사실만으로 외부 접속까지 보장되지는 않으며, HTTP 404가 돌아왔다면 해당 요청은 이미 HTTP 서버까지 도착한 상태입니다.
어느 구간의 연결을 검사하는지 먼저 정하기
이 강좌는 VirtualBox NAT(Network Address Translation, 네트워크 주소 변환)에 연결한 Debian 13 가상 머신과 Windows 호스트를 사용합니다. 게스트 주소는 10.0.2.15, 게이트웨이는 10.0.2.2인 단일 NAT 어댑터 구성입니다. 실제 환경의 주소는 아래 조회 결과로 확인하고, 다른 네트워크에 예제 주소를 그대로 적용하지 마세요.
ip -br address
ip route
ip route get 10.0.2.2
getent ahostsv4 deb.debian.org
sudo ss -lntp
ip route get은 지정한 목적지로 보낼 때 커널이 선택하는 경로·인터페이스·출발지 주소를 조회합니다. 패킷이 실제 목적지에 도착했음을 검사하는 명령은 아닙니다. getent는 시스템의 이름 조회 설정을 이용하며, 조회된 CDN 주소는 시점에 따라 달라질 수 있습니다. ss의 -l은 수신 대기, -n은 숫자 주소·포트, -t는 TCP, -p는 프로세스 정보를 뜻합니다.
| 검사 결과 | 우선 확인할 대상 |
|---|---|
| 이름을 주소로 바꾸지 못함 | 이름 오타, DNS와 시스템 이름 조회 설정 |
| 목적지로 가는 경로가 없음 | 인터페이스 주소, 연결 경로와 기본 게이트웨이 |
| 게스트 내부만 성공함 | 수신 주소, 포트 전달 대상, 방화벽 |
| HTTP 404 응답 | URL 경로, 파일 위치, 가상 호스트와 애플리케이션 라우팅 |
| 접속 시간 초과 | 목적지·포트·경로·필터링을 추가 확인; 이 결과만으로 한 원인 확정 불가 |
호스트의 127.0.0.1과 게스트의 127.0.0.1은 서로 다른 컴퓨터의 루프백 주소입니다. NAT 게스트에 일반적인 호스트 연결을 받으려면 포트 전달 등의 경로가 필요합니다. 기존 SSH 전달 규칙은 유지한 채 HTTP 실습용 규칙을 별도로 추가합니다. 관리 도구 판별은 네트워크와 DNS 설정 주체 확인, 주소 변경은 고정 IPv4·DNS 설정과 복구의 조건을 따릅니다.
테스트 파일과 내부 전용 서버 준비
Debian 터미널 두 개와 호스트 PowerShell을 준비합니다. Python HTTP 서버는 연결 확인용으로만 사용하며 운영용 웹 서버로 사용하지 않습니다. 기존 서비스가 8080 포트를 사용한다면 중지하지 말고 빈 실습 포트를 정하여 이후 모든 명령과 전달 규칙에 일관되게 반영하세요.
sudo ss -lntp 'sport = :8080'
sudo apt update
sudo apt install --no-install-recommends python3 curl
python3 --version
curl --version
ss에 헤더 외 수신 행이 없으면 해당 TCP 포트에서 현재 수신하는 프로세스가 없다는 뜻입니다. 패키지 설치는 의존성과 변경 목록을 검토한 후 승인합니다. 이 실습의 게스트는 Python 3.13.5와 curl 8.14.1을 사용했습니다. 보안 업데이트에 따라 세부 버전은 달라질 수 있습니다.
일반 사용자 터미널 A에서 아래를 실행합니다. mkdir는 같은 이름의 폴더가 있으면 실패하도록 작성했습니다. 기존 폴더를 덮어쓰지 말고 그 내용을 먼저 확인하세요.
mkdir "$HOME/lf-net-demo" &&
printf 'debian-network-lab\n' > "$HOME/lf-net-demo/probe.txt" &&
python3 -m http.server 8080 --bind 127.0.0.1 --directory "$HOME/lf-net-demo"
폴더 생성에 실패했다면 서버 명령을 실행하지 않습니다. 정상 시작하면 터미널 A는 서버 실행 상태로 유지됩니다. 문서 루트를 전용 폴더로 제한했으므로 홈 디렉터리 전체를 제공하지 않습니다. 8080은 일반 사용자가 바인딩할 수 있는 포트이므로 서버 실행에 sudo가 필요하지 않습니다.
게스트 터미널 B에서 다음을 실행합니다. 서버가 시작 메시지를 출력한 뒤 요청하세요.
sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8081/probe.txt
첫 요청은 debian-network-lab을 출력합니다. ss의 로컬 주소는 127.0.0.1:8080입니다. 8081에 다른 서비스가 없다면 두 번째 요청은 접속 실패가 됩니다. 실습에서는 curl 종료 코드 7을 확인했습니다. 이 비교는 실행 중인 서비스의 포트가 중요함을 보여 주며, 실패할 것이라 예상한 포트에도 서비스가 있을 수 있으므로 자신의 조회 결과를 우선합니다.
--noproxy '*'는 이번 요청이 프록시 환경 변수를 우회하도록 합니다. --connect-timeout은 연결 단계의 제한, --max-time은 전체 작업 시간의 제한입니다. 네트워크 경로가 원래 필요한 조직 프록시 설정을 전역으로 삭제하지 않습니다.
호스트 실패와 수신 주소 차이 비교
VirtualBox에서 대상 VM의 설정 → 네트워크 → NAT 어댑터 → 고급 → 포트 포워딩을 엽니다. UI의 표기 위치는 버전에 따라 달라질 수 있습니다. 아래 새 규칙만 추가하고 기존 SSH 규칙은 그대로 둡니다. 호스트의 18080 포트가 사용 중이면 빈 포트를 선택하세요.
| 항목 | 설정 |
|---|---|
| 이름 / 프로토콜 | lf-debian13-http15 / TCP |
| 호스트 IP / 포트 | 127.0.0.1 / 18080 |
| 게스트 IP / 포트 | 단일 NAT 게스트의 기본 주소를 쓰면 IP 빈 값 / 8080 |
게스트 주소를 명시한다면 현재 게스트 주소와 같아야 합니다. 이 실습은 기본 NAT 주소 10.0.2.15를 사용하는 구성이며, 주소를 변경한 VM은 전달 대상도 재검토해야 합니다. 호스트 IP를 루프백으로 제한하여 LAN의 다른 컴퓨터에서 실습 서버로 들어오는 경로를 만들지 않습니다. 자세한 동작은 VirtualBox NAT와 포트 전달 공식 설명을 참고하세요.
호스트 PowerShell에서 실행합니다. Windows PowerShell의 별칭과 구분하기 위해 curl.exe를 명시합니다.
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:18080/probe.txt
$LASTEXITCODE
게스트 내부 요청은 성공했지만 호스트 요청은 실패합니다. NAT가 전달하는 게스트 NIC 주소에서 서버가 수신하지 않기 때문입니다. 실습에서는 연결 재설정과 종료 코드 56이 관찰되었습니다. 가상화 제품·버전·연결 상태에 따라 오류 코드나 시간 초과 여부는 달라질 수 있으므로 정확히 56이 나와야 정상이라는 뜻은 아닙니다.
이제 게스트 터미널 A에서 Ctrl+C로 서버를 종료하고, 같은 파일·같은 포트·같은 전달 규칙을 유지한 채 바인딩 주소만 바꿉니다.
python3 -m http.server 8080 --bind 0.0.0.0 --directory "$HOME/lf-net-demo"
서버 시작 메시지를 확인한 뒤 게스트 B에서 수신 주소와 NIC 주소를 통한 요청을 확인합니다.
sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://10.0.2.15:8080/probe.txt
0.0.0.0:8080은 모든 로컬 IPv4 주소에서 수신한다는 뜻입니다. IPv6 수신까지 자동으로 보장하지는 않습니다. 게스트 주소 요청이 성공한 다음 호스트에서 동일한 curl.exe 명령을 다시 실행하면 파일 내용과 종료 코드 0을 확인할 수 있습니다. 시작 직후 실패했다면 프로세스 종료 여부와 수신 행을 먼저 확인한 후 요청하세요.
이 결과로 수신 주소 차이를 확인할 수 있습니다. 반대로 자신의 환경에서 계속 실패한다면 방화벽을 무조건 해제하지 말고 전달 규칙, 게스트 주소, 수신 행과 필터 규칙을 확인합니다. ping만 실패하는 상황도 ICMP 정책의 영향일 수 있으므로 TCP 서비스 전체가 실패했다고 단정하지 않습니다.
HTTP 오류와 curl 실행 실패 구분
서버가 모든 IPv4 주소에서 실행 중인 상태로 호스트 PowerShell에서 존재하지 않는 파일을 요청합니다. -w는 응답 코드를 출력하고, -o NUL은 Windows에서 본문을 버립니다.
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --fail -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
첫 요청의 HTTP 코드는 404이지만 curl 종료 코드는 0입니다. curl은 기본적으로 HTTP 오류 상태 자체를 전송 실패로 처리하지 않습니다. 두 번째 요청은 동일한 HTTP 404를 받고 --fail 때문에 종료 코드 22를 반환합니다. 자동 점검에서는 종료 코드만 볼지, HTTP 상태도 판정할지 목적에 맞게 정해야 합니다. 리디렉션·인증·실제 응답 내용을 확인해야 하는 운영 점검을 단순히 200 여부로 모두 대체하지는 마세요.
404는 서버와 HTTP 대화가 이루어졌다는 증거입니다. 이 단계에서는 DNS나 케이블을 바꾸기보다 URL 경로와 문서 루트를 확인합니다. 터미널 A의 요청 로그에 GET /missing.txt와 404가 남는지도 비교하세요. curl 공식 설명서는 옵션과 종료 코드의 의미를 구분하여 설명합니다.
DNS만 실패하도록 만들고 한 요청에서 우회하기
RFC 6761의 특수 용도 이름 규정에 따라 .invalid는 이 실습에서 정상 DNS 응답을 기대하지 않는 테스트 이름에 사용합니다. 서버와 포트 전달은 그대로 두고 호스트에서 이름만 바꾸어 요청합니다.
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --resolve "lf-debian13-net15.invalid:18080:127.0.0.1" http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
일반 조회 경로에서 첫 요청은 이름 조회 실패와 종료 코드 6을 반환합니다. 두 번째 요청은 해당 호스트명·포트의 주소를 이번 curl 실행에만 지정하므로 파일을 받고 종료 코드 0을 반환합니다. --resolve는 DNS 서버나 hosts 파일을 수정하지 않으며 URL의 호스트명을 유지합니다. HTTPS에서는 URL 호스트명에 대한 인증서 검증도 여전히 필요하므로 이 옵션을 인증서 검증 생략과 혼동하지 마세요.
두 번째 요청만 성공한다면 지정한 주소로의 전송 경로는 작동하고 원래 이름 조회 경로를 더 살펴볼 근거가 됩니다. 실제 서비스에서 올바른 IP인지 확인하지 않은 채 임의의 주소를 지정하면 다른 서버를 검사할 수 있습니다. 특정 프로그램의 프록시·캐시·이름 조회 방식이 시스템 getent 결과와 같다고 가정해서도 안 됩니다.
결과 정리와 실습 원상 복구
- 게스트 터미널 A에서 Ctrl+C로 HTTP 서버를 종료합니다.
- VirtualBox 포트 전달 표에서 이번에 만든
lf-debian13-http15규칙만 삭제합니다. SSH 규칙은 유지합니다. - 게스트에서 아래 수신 상태와 파일을 확인하고 이번에 생성한 파일·빈 폴더만 삭제합니다.
sudo ss -lntp 'sport = :8080'
cat "$HOME/lf-net-demo/probe.txt"
rm -- "$HOME/lf-net-demo/probe.txt"
rmdir -- "$HOME/lf-net-demo"
서버 수신 행이 없어지고 호스트의 실습 HTTP 요청도 더 이상 성공하지 않아야 합니다. rmdir가 실패하면 폴더 안에 다른 파일이 있는지 확인하고 강제로 재귀 삭제하지 마세요. 설치한 curl·Python은 다른 관리 작업에도 사용할 수 있으므로 필요 여부를 확인하지 않은 일괄 제거는 하지 않습니다.
문제를 기록할 때는 검사 위치(호스트/게스트), 요청 URL, 실제 목적지 주소·포트, 수신 주소, curl 종료 코드와 HTTP 코드를 함께 남기면 좋습니다. 주소·경로 조회는 Debian 13 ip-route 설명서, 수신 소켓은 ss 설명서, 테스트 서버 옵션은 Python 3.13 http.server 문서에서 확인할 수 있습니다.




