안녕하세요. Point-Checks입니다.
이번 포스팅에서는 AWS EC2 인스턴스를 VSCode(Visual Studio Code)에 연결하는 방법을 소개하겠습니다.
EC2 인스턴스를 사용하면 원격 서버에서 애플리케이션을 실행하고 관리할 수 있는데, VSCode를 사용하면 더욱 편리하게 개발할 수 있습니다.
그럼 하나씩 알아볼까요?
AWS EC2를 VSCode에 연결하는 이유
EC2 인스턴스를 원격 개발 환경으로 활용하면, 로컬 컴퓨터 성능에 영향을 받지 않고 고성능 서버에서 직접 코드를 실행할 수 있습니다.
VSCode의 Remote – SSH 확장을 사용하면 터미널에서 명령어를 입력하지 않아도 원격 서버에 접속하여 개발할 수 있습니다.
✅ AWS EC2를 VSCode와 연결하면 좋은 점
- 편리한 원격 개발 환경 구축
- 코드를 직접 EC2에서 실행 가능
- 로컬 컴퓨터의 리소스 사용 최소화
- 파일 편집 및 코드 실행이 쉬워짐
AWS EC2를 VSCode에 연결하는 방법
AWS EC2 인스턴스를 VSCode에 연결하려면 다음 4단계를 따라가면 됩니다.
1️⃣ AWS EC2 인스턴스 생성 및 설정
2️⃣ SSH 키 및 보안 그룹 설정 확인
3️⃣ VSCode에서 Remote – SSH 확장 설치
4️⃣ VSCode를 통해 EC2에 원격 접속
각 단계를 자세히 살펴보겠습니다.
1단계: AWS EC2 인스턴스 생성 및 설정
먼저, AWS EC2 인스턴스를 생성해야 합니다.
✅ EC2 인스턴스 생성 방법
- AWS 콘솔 로그인
- AWS Management Console에 로그인한 후, 상단 검색창에서 EC2를 입력하고 이동합니다.
- 인스턴스 시작(Launch Instance) 클릭
- 운영 체제(AMI) 선택
- “Amazon Linux 2” 또는 “Ubuntu 22.04 LTS”를 선택하는 것이 일반적입니다.
- 인스턴스 유형 선택
- “t2.micro”(프리 티어 무료) 또는 원하는 사양 선택
- 키 페어 생성 또는 기존 키 페어 선택
- 보안 그룹 설정
- SSH(포트 22)를 내 IP만 허용하도록 설정
💡 중요!
EC2 인스턴스를 만들 때 퍼블릭 IP 주소를 활성화해야 합니다.
기본적으로 퍼블릭 IP가 없으면 외부에서 접속이 불가능합니다.
2단계: SSH 키 및 보안 그룹 설정 확인
✅ SSH 키 확인 (키 페어 .pem 파일 저장)
EC2 인스턴스를 생성할 때, **키 페어(.pem 파일)**를 다운로드했을 것입니다.
이 파일이 있어야 VSCode에서 EC2에 연결할 수 있습니다.
- 키 페어 파일 위치 확인 – 새 키페어 생성 누르면 자동으로 다운 됩니다.
✅ 보안 그룹에서 SSH(22번 포트) 열기
AWS 콘솔에서 EC2 > 보안 그룹으로 이동하여 **SSH(포트 22)**가 열려 있는지 확인하세요.
- 소스 IP를
"내 IP"로 설정하면 보안이 강화됩니다.
3단계: VSCode에서 Remote – SSH 확장 설치
이제 VSCode에서 AWS EC2 인스턴스에 연결할 준비를 합니다.
✅ Remote – SSH 확장 프로그램 설치
- VSCode 실행
- 확장(Extensions) 메뉴로 이동 (
Ctrl + Shift + X또는Cmd + Shift + X) - “Remote – SSH” 검색 후 설치
💡 Remote – SSH 확장은 VSCode에서 원격 서버와 연결하여 작업할 수 있도록 도와줍니다.
4단계: VSCode에서 EC2에 원격 접속
이제 VSCode에서 AWS EC2 인스턴스에 접속해보겠습니다.
✅ SSH 구성 파일 수정하기
SSH 설정을 저장해두면 매번 명령어를 입력하지 않아도 간편하게 접속할 수 있습니다.
- VSCode 명령 팔레트 열기 (
Ctrl + Shift + P또는Cmd + Shift + P) - “Remote-SSH: Open SSH Configuration File” 선택
- 설정 파일에 다음 내용 추가
Host my-aws-ec2
HostName <EC2의 퍼블릭 IP 주소>
User ec2-user # Ubuntu는 'ubuntu', Amazon Linux는 'ec2-user'
IdentityFile ~/.ssh/your-key.pem #키가 저장되어 있는 경로
ex)
Host my-aws-ec2
HostName 13.125.125.41
User ec2-user
IdentityFile "C:\Users\유저명\Downloads\test-key.pem"
- 파일 저장 (Ctrl + S 또는 Cmd + S)
💡 HostName에는 EC2 인스턴스의 퍼블릭 IP를 입력하세요.
퍼블릭 IP는 AWS EC2 콘솔에서 확인할 수 있습니다.
✅ SSH 접속 테스트
이제 설정한 SSH 정보를 이용해 VSCode에서 EC2에 연결합니다.
- VSCode 명령 팔레트 열기 (
Ctrl + Shift + P) - “Remote-SSH: Connect to Host” 선택
- “my-aws-ec2” 클릭 (Linux -> 계속 선택)
- 터미널에서 연결 성공 메시지 확인
✅ 정상적으로 접속되었다면, VSCode 터미널에서 서버에 명령어를 입력할 수 있습니다.
EC2 연결 후 주의할 점
✅ 퍼블릭 IP는 변경될 수 있음
- EC2를 재시작하면 퍼블릭 IP가 바뀌므로, 접속이 안 된다면 새 IP를 확인 후 SSH 설정을 수정해야 합니다.
- 고정된 IP가 필요하면 Elastic IP를 할당하세요.
✅ SSH 키 파일 관리
.pem파일은 분실하면 복구가 어렵습니다.- 깃허브 또는 클라우드 스토리지에 업로드하지 마세요!