AWS EC2 인스턴스 연결 (AWS 콘솔, SSH)

AWS 콘솔 내 연결

EC2 인스턴스를 가장 간단하게 연결하려면, 먼저 AWS 콘솔에서 인스턴스 정보를 확인한다.

인스턴스 요약 우측 상단의 [연결] 버튼을 클릭한다.

[연결] 버튼을 클릭하면 EC2 인스턴스 연결 탭이 열린다.
별도 설정을 변경하지 않았다면, 사용자 이름은 기본값인 ubuntu로 되어 있다.
오른쪽 하단의 [연결] 버튼을 클릭해 인스턴스에 연결한다.

정상적으로 연결되면 위와 같은 화면이 나타난다.

SSH 연결

CLI 연결

연결 탭에서는 SSH 접속을 위한 명령어도 함께 제공된다.

-i: 사용할 pem 키 파일의 경로
ubuntu@...: 사용자 이름 + EC2 퍼블릭 DNS

ssh -i "/your/path/to/example-server-key.pem" ubuntu@ec2-xx-xx-xx-xx.ap-northeast-2.compute.amazonaws.com

명령어를 입력하면 아래와 같은 경고가 출력된다.

이 메시지는 로컬 PC의 known_hosts 파일에 해당 서버 정보가 저장되지 않은 경우 나타나는 보안 경고다.

yes: 접속 및 fingerprint 저장 (다음 접속부터는 묻지 않음)
no: 접속하지 않음
[fingerprint]: 지문 전체 입력으로 접속 (일반적으로 사용하지 않음)

yes를 입력하면 접속이 시도되지만, 다음과 같은 에러가 발생할 수 있다.

이 에러는 pem 키 파일의 권한이 너무 open되어 있을 때 발생한다.
보안을 위해 SSH는 권한이 제한된 키 파일만 사용을 허용한다.

해결 방법

Mac / Linux

chmod 400 example-server-key.pem

Windows (CMD 기준)

icacls "C:\your\path\to\example-server-key.pem" /inheritance:r
icacls "C:\your\path\to\example-server-key.pem" /grant:r "%USERNAME%:R"

위 명령어를 입력해도 안될 경우, icacls "C:\your\path\to\example-server-key.pem" /reset를 입력 후, 위 명령어를 다시 입력하면 된다.

권한 수정 후 다시 아래 명령어를 입력한다.

ssh -i C:\your\path\to\example-server-key.pem ubuntu@ec2-xx-xx-xx-xx.ap-northeast-2.compute.amazonaws.com

정상적으로 EC2 인스턴스에 접속할 수 있다.

VSCode로 SSH 연결하기

1. VSCode에서 SSH 확장 설치

Remote - SSH 확장을 설치하면 좌측 사이드바에 Remote Explorer 탭이 생긴다.

탭 상단이 REMOTE EXPLORER / Remotes (Tunnels/SSH)로 되어 있는지 확인한다.

2. SSH config 파일 등록

톱니바퀴 버튼을 클릭해 SSH config 파일을 연다.

Windows 기준 기본 경로는 C:\Users\Username\.ssh\config이다.

아래와 같은 형식으로 내용을 작성한다.

Host example-server
    HostName ec2-xx-xx-xx-xx.ap-northeast-2.compute.amazonaws.com
    User ubuntu
    IdentityFile C:/your/path/to/example-server-key.pem

Host: 접속 시 사용할 별칭 (예: ssh example-server)
HostName: 퍼블릭 DNS 또는 IP
User: EC2 사용자 이름
IdentityFile: pem 키 경로

3. VSCode에서 접속하기

등록된 Host 이름을 클릭하면 해당 서버로 연결된다.
-> 버튼을 누르면 현재 창에서, + 버튼을 누르면 새 창에서 접속할 수 있다.

터미널에서 바로 접속

SSH config를 설정해두었다면 아래와 같이 간단한 명령어로 접속 가능하다.

ssh example-server