EC2 인스턴스와 SSH를 연결하려고 시도할 때 "Connection refused" 또는 "Connection timed out" 오류가 발생합니다. 문제를 해결하려면 어떻게 해야 하나요?

최종 업데이트 날짜: 2021년 10월 8일

SSH를 사용하여 Amazon EC2(Amazon Elastic Compute Cloud) 인스턴스에 연결하려고 할 때 "Connection refused" 또는 "Connection timed out" 오류가 발생합니다. 문제를 해결하려면 어떻게 해야 하나요?

간략한 설명

오류 메시지: "ssh: connect to host ec2-X-X-X-X.compute-1.amazonaws.com port 22: Connection timed out". 이 오류 메시지는 SSH 클라이언트에서 발생합니다. 이 오류는 서버가 클라이언트에 응답하지 않고 클라이언트 프로그램이 포기했음을 나타냅니다(시간 초과). 이 오류의 일반적인 원인은 다음과 같습니다.

  • 보안 그룹 또는 네트워크 ACL이 액세스를 허용하지 않습니다.
  • 인스턴스의 운영 체제에 방화벽이 있습니다.
  • 클라이언트와 서버 사이에 방화벽이 있습니다.
  • 호스트가 존재하지 않습니다.

오류 메시지: "ssh: connect to host ec2-X-X-X-X.compute-1.amazonaws.com port 22: Connection refused". 이 메시지는 호스트에서 원격으로 전송됩니다. 이 오류의 일반적인 원인은 다음과 같습니다.

  • 호스트가 인스턴스에 도달했지만 SSH 포트에서 수신 대기 중인 서비스가 없습니다.
  • 방화벽이 패키지를 차단했으며 패키지를 삭제하는 대신 거부하도록 설정되었습니다.

해결 방법

다음을 확인합니다.

이러한 작업을 수행하는 방법으로는 다음 네 가지가 있습니다.

방법 1: EC2 직렬 콘솔 사용

Linux용 EC2 직렬 콘솔을 설정한 경우 이 콘솔을 사용하여 지원되는 Nitro 기반 인스턴스 유형의 문제를 해결할 수 있습니다. 직렬 콘솔을 사용하면 부팅 문제, 네트워크 구성 및 SSH 구성 문제를 해결할 수 있습니다. 직렬 콘솔은 작동 중인 네트워크 연결 없이 인스턴스에 연결됩니다. Amazon EC2 콘솔 또는 AWS 명령줄 인터페이스(AWS CLI)를 사용하여 직렬 콘솔에 액세스할 수 있습니다.

직렬 콘솔을 사용하기 전에 계정 수준에서 액세스 권한을 부여합니다. 그런 다음 IAM 사용자에게 액세스 권한을 부여하는 AWS Identity and Access Management(IAM) 정책을 생성합니다. 또한 직렬 콘솔을 사용하는 모든 인스턴스에는 암호 기반 사용자가 한 명 이상 포함되어야 합니다. 인스턴스에 연결할 수 없고 직렬 콘솔에 대한 액세스를 구성하지 않은 경우 방법 2, 3 또는 4의 지침을 따릅니다. Linux용 EC2 직렬 콘솔 구성에 대한 자세한 내용은 EC2 직렬 콘솔에 대한 액세스 구성을 참조하세요.

참고: AWS CLI 명령을 실행할 때 오류가 발생하는 경우 최신 버전의 AWS CLI를 사용하고 있는지 확인하세요.

방법 2: AWS Systems Manager Session Manager 사용

참고: 이 방법을 사용하려면 SSM 에이전트가 필요합니다. Session Manager에 대한 자세한 내용과 전체 사전 조건 목록은 Session Manager 설정하기를 참조하십시오.

1.    AWS Systems Manager 콘솔을 엽니다.

2.    세션을 시작합니다.

3.    규칙 테이블의 맨 위에 다음 줄을 추가하고 SSH 서비스를 다시 시작합니다.

$ sudo iptables -I INPUT 1 -p tcp --dport 22 -j ACCEPT
$ sudo service sshd restart

또는 방화벽을 비활성화할 수 있습니다. 방화벽이 아닌 보안 그룹을 사용하는 것이 가장 좋습니다.

방화벽을 비활성화하려면 운영 체제에 따라 다음 명령 집합 중 하나를 사용합니다.

복잡하지 않은 방화벽을 사용하는 Ubuntu

$ sudo iptables -F
$ sudo iptables -P INPUT ACCEPT
$ sudo ufw disable

firewalld를 사용하는 배포판(예: Red Hat 또는 CentOS)

$ sudo iptables -F
$ sudo iptables -P INPUT ACCEPT
$ sudo systemctl disable firewalld

참고: 위의 명령은 모든 주요 iptables 규칙을 플러시하고 수신되는 SSH 연결을 허용하는 규칙을 추가합니다. 설정에 필요한 다른 규칙이 있을 수 있으므로 이러한 명령을 실행하기 전에 이 사항을 고려하세요. 인스턴스에 대한 액세스 권한을 다시 얻은 후 방화벽 구성(예: UFW, firewalld, iptables)을 검토합니다.

4.    SSH가 실행 중인지 확인하고 SSH TCP 포트(22)가 수신 대기 상태인지 확인합니다.

$ sudo systemctl restart sshd
$ sudo ss -tpln | grep -E '22|ssh'
LISTEN 0 128 *:22 *:* users:(("sshd",pid=1901,fd=3))
LISTEN 0 128 [::]:22 [::]:* users:(("sshd",pid=1901,fd=4))

참고: 시스템에 ss 명령이 없는 경우 이전 예제와 동일한 구문을 사용하여 레거시 netstat 명령을 사용할 수 있습니다.

5.    세션을 종료합니다.

6.    SSH를 사용하여 인스턴스에 연결합니다.

방법 3: AWSSupport-TroubleshootSSH Automation 문서 실행

AWSSupport-TroubleshootSSH Automation 문서는 인스턴스에 Amazon EC2Rescue 도구를 설치합니다. 이 도구는 SSH를 통해 Linux 시스템에 연결할 때 원격 연결 오류를 일으키는 몇 가지 문제를 확인하고 수정합니다. 자세한 내용은 SSH를 사용하여 EC2 인스턴스에 연결하려고 할 때 오류가 발생합니다. AWSSupport-TroubleshootSSH 자동화 워크플로를 사용하여 SSH 연결 문제를 해결하려면 어떻게 해야 합니까?를 참조하세요.

방법 4: 사용자 데이터 스크립트 사용

중요

  • 이 절차를 수행하려면 EC2 인스턴스를 중지했다가 다시 시작해야 합니다. 사용하는 인스턴스가 인스턴스 스토어 지원 인스턴스이거나 인스턴스에 데이터가 포함된 인스턴스 스토어 볼륨이 있으면 인스턴스 중지 시 데이터가 손실됩니다. 자세한 내용은 인스턴스의 루트 디바이스 유형 확인을 참조하세요.
  • 인스턴스가 Amazon EC2 Auto Scaling 그룹의 일부이거나 Amazon EMR, AWS CloudFormation, AWS Elastic Beanstalk 등과 같이 AWS Auto Scaling을 사용하는 서비스에서 인스턴스를 시작한 경우 인스턴스를 중단하면 인스턴스가 종료될 수 있습니다. 이 시나리오에서 인스턴스 종료는 Auto Scaling 그룹에 대한 인스턴스 확장 보호 설정에 따라 달라집니다. 인스턴스가 Auto Scaling 그룹의 일부인 경우, 문제 해결 단계를 시작하기 전에 Auto Scaling 그룹에서 일시적으로 인스턴스를 제거합니다.
  • 인스턴스를 중지하고 다시 시작하면 인스턴스의 퍼블릭 IP 주소가 변경됩니다. 모범 사례로서 외부 트래픽을 인스턴스로 라우팅할 때는 퍼블릭 IP 주소 대신 탄력적 IP 주소를 사용하는 것이 좋습니다.

1.    EC2 인스턴스 콘솔 로그를 확인합니다. UFW가 켜지면 EC2 인스턴스 콘솔 로그에 다음의 항목이 표시됩니다.

systemd[1] : starting Uncomplicated Firewall
Starting Uncomplicated firewall...

2.    Amazon EC2 콘솔을 엽니다.

3.    탐색 창에서 [인스턴스]를 선택한 다음, 연결하려는 인스턴스를 선택합니다.

4.    인스턴스를 중지합니다.

5.    [작업(Actions)], [인스턴스 설정(Instance Settings)], [사용자 데이터 편집(Edit User Data)]을 선택합니다.

6.    다음의 사용자 데이터 스크립트를 사용자 데이터 편집(Edit User Data) 대화 상자에 복사하고 저장(Save)을 선택합니다.

Content-Type: multipart/mixed; boundary="//"
MIME-Version: 1.0

--//
Content-Type: text/cloud-config; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="cloud-config.txt"

#cloud-config
cloud_final_modules:
- [scripts-user, always]

--//
Content-Type:
    text/x-shellscript; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="userdata.txt"

#!/bin/bash
iptables -F
service sshd restart
--//

참고: 앞의 명령은 포트 22에 대한 규칙 뿐만 아니라 모든 기본 iptables 규칙을 플러시합니다. 인스턴스에 대한 액세스 권한을 다시 얻은 후 방화벽 구성(예: UFW, firewalld, iptables)을 검토합니다.

7.    SSH를 사용하여 인스턴스에 연결합니다.

8.    앞의 사용자 데이터 스크립트는 인스턴스를 재부팅할 때마다 실행되도록 설정되어 있습니다. 인스턴스에 대한 액세스 권한을 다시 얻은 후 사용자 데이터 스크립트를 제거합니다.

사용자 데이터를 제거하려면 다음을 수행합니다.

1.    방법 4: 사용자 데이터 스크립트 사용 섹션의 1~4단계를 완료합니다.

2.    [사용자 데이터 편집(Edit User Data)] 대화 상자에서 사용자 데이터 스크립트를 삭제합니다.