시스템 관리_11 리눅스 포트 접속 오류 완벽 정리 "Connection refused" vs "Connection timed out" 원인 및 해결 방법

# 1. 클라이언트 관점: 특정 대상 서버 및 포트 접속 테스트
# Connection refused 예시 (즉각적인 거부 응답)
$ curl -v --connect-timeout 5 http://192.168.1.100:8080
*   Trying 192.168.1.100:8080...
* connect to 192.168.1.100 port 8080 failed: Connection refused
* Failed to connect to 192.168.1.100 port 8080: Connection refused

# Connection timed out 예시 (응답 없이 대기하다 타임아웃 발생)
$ nc -zv -w 5 192.168.1.100 9000
nc: connect to 192.168.1.100 port 9000 (tcp) timed out: Operation now in progress

# 2. 서버 관점: 해당 포트가 정상적으로 Listen 상태인지 확인
# 아무것도 출력되지 않거나 127.0.0.1에만 바인딩되어 있는지 확인
$ sudo ss -tulpn | grep -E ':8080|:9000'
tcp   LISTEN 0      128        127.0.0.1:8080       0.0.0.0:*    users:(("java",pid=1234,fd=14))

# 3. 서버 관점: 방화벽(iptables/firewalld) 정책상 드롭(DROP) 또는 거부(REJECT) 룰 확인
$ sudo iptables -L INPUT -v -n --line-numbers | grep -E 'DROP|REJECT'
3    DROP       all  --  *      *       0.0.0.0/0            0.0.0.0/0

#!/bin/bash
# port_troubleshoot.sh - Check port listening state and firewall rules

TARGET_PORT=${1:-"80"}
echo "=========================================="
echo " [진단 시작] 대상 포트: ${TARGET_PORT}"
echo "=========================================="

# 1. 포트 Listen 상태 및 바인딩 IP 확인
echo -e "\n[1] 로컬 소켓 리스닝 상태 확인:"
LISTENING_INFO=$(ss -tulpn | grep ":${TARGET_PORT} ")

if [ -z "$LISTENING_INFO" ]; then
    echo "  [경고] 포트 ${TARGET_PORT}번을 리스닝하고 있는 프로세스가 없습니다."
    echo "  -> 원인: 서비스가 꺼져있을 확률 높음 (Connection refused 유발)"
else
    echo "  [정상] 프로세스가 바인딩되어 있습니다:"
    echo "  $LISTENING_INFO"
    
    # 127.0.0.1 바인딩 여부 검사
    if echo "$LISTENING_INFO" | grep -q "127.0.0.1:${TARGET_PORT}"; then
        echo "  [주의] 소켓이 루프백(127.0.0.1)에만 바인딩되어 있어 외부 접속 시 거부될 수 있습니다."
    fi
fi

# 2. 서비스 프로세스 상태 체크 (systemd 기반 예시)
echo -e "\n[2] 관련 실패 유닛 확인:"
FAILED_UNITS=$(systemctl --failed --type=service)
if echo "$FAILED_UNITS" | grep -q "0 loaded units listed"; then
    echo "  [정상] 비정상 종료된 systemd 서비스가 없습니다."
else
    echo "  [확인 필요] 비정상 종료된 서비스 목록:"
    echo "$FAILED_UNITS"
fi

# 3. 방화벽 차단 룰 확인 (iptables / UFW / Firewalld)
echo -e "\n[3] 방화벽 DROP / REJECT 규칙 검사:"
if command -v iptables &>/dev/null; then
    BLOCKED=$(sudo iptables -S INPUT | grep -E "(DROP|REJECT)")
    if [ -n "$BLOCKED" ]; then
        echo "  [주의] 방화벽에 DROP/REJECT 규칙이 존재합니다:"
        echo "$BLOCKED"
        echo "  -> DROP 규칙에 의해 패킷이 무시될 경우 'Connection timed out' 발생"
        echo "  -> REJECT 규칙에 의해 패킷이 거절될 경우 'Connection refused' 발생 가능"
    else
        echo "  [정상] 명시적인 DROP/REJECT 규칙이 확인되지 않았습니다."
    fi
fi

echo -e "\n=========================================="
echo " [진단 완료]"
echo "=========================================="