AWS EC2에 VSCode 서버 설치 및 실행

 

AWS EC2에 VSCode 서버 설치 및 실행 – 명령어별 상세 해설

클라우드에서 코드 작업을 원격으로 할 수 있게 해주는 code-server는 Visual Studio Code의 웹 버전입니다. 아래는 AWS EC2 인스턴스에 code-server를 설치하고 설정하는 방법과 그에 대한 자세한 설명입니다.

---

1. 설치 파일 다운로드 및 설치

curl -fsSL https://code-server.dev/install.sh | sh

🔍 설명:

• curl : 인터넷에서 데이터를 가져오는 명령어입니다.
• -f : 요청 실패 시 에러 메시지 출력
• -s : 진행 상황을 출력하지 않음 (silent)
• -S : 에러가 있을 경우 메시지 출력
• -L : 리다이렉션을 따라감
• https://code-server.dev/install.sh : 설치 스크립트 파일의 주소입니다.
• | sh : 다운로드된 스크립트를 즉시 셸에서 실행합니다.

➡️ 즉, 위 명령어는 code-server 공식 사이트에서 설치 스크립트를 받아 즉시 실행하여 설치를 진행합니다.

---

2. VSCode 서버 실행 및 자동 시작 설정

sudo systemctl enable --now code-server@ubuntu

🔍 설명:

• sudo : 관리자 권한으로 명령 실행
• systemctl : 시스템 서비스(데몬)를 제어하는 명령어
• enable : 부팅 시 자동 실행되도록 설정
• --now : 설정과 동시에 바로 실행
• code-server@ubuntu : code-server 서비스 중에서 ubuntu 사용자용 인스턴스를 지정

➡️ 이 명령은 현재 로그인한 사용자의 이름(ubuntu)을 기반으로 code-server를 즉시 실행하고, 재부팅 후에도 자동 실행되도록 설정합니다.

---

3. 설정 파일(config.yaml) 수정

sudo nano ~/.config/code-server/config.yaml

🔍 설명:

• nano : 리눅스에서 자주 사용하는 텍스트 편집기
• ~/.config/code-server/config.yaml : code-server 설정 파일의 경로입니다. ~는 현재 사용자 홈 디렉토리를 의미합니다.

해당 파일의 주요 항목은 다음과 같습니다:

bind-addr: 0.0.0.0:8080
auth: password
password: 패스워드
cert: false

• bind-addr: 0.0.0.0:8080
  • 0.0.0.0은 모든 IP 주소에서 접근 허용을 의미합니다.
  • 8080 포트는 code-server가 열어둘 웹 포트입니다.
• auth: password
  • 사용자 인증 방식을 비밀번호로 설정합니다.
• password: mypassword
  • 로그인 시 사용할 실제 비밀번호입니다. 보안을 위해 복잡한 비밀번호로 변경하는 것이 좋습니다.
• cert: false
  • SSL 인증서를 사용하지 않겠다는 뜻입니다. 즉, HTTP 프로토콜로 동작하게 됩니다. 보안이 중요한 경우 cert: true로 바꾸고 인증서를 설정해야 합니다.

✍️ 저장 방법:

• Ctrl + O → 저장
• Enter → 확인
• Ctrl + X → 편집기 종료

---

4. 서버 재시작 (설정 반영)

sudo systemctl restart code-server@ubuntu

🔍 설명:

• restart는 서비스를 중단 후 다시 시작합니다.
• 변경된 config.yaml 설정이 적용되려면 반드시 재시작해야 합니다.

➡️ 위 명령을 실행하면 설정한 IP 주소와 포트(예: 0.0.0.0:8080)로 접속할 수 있는 VSCode 웹 인터페이스가 실행됩니다.

---

🔒 보안 그룹 확인 (중요)

EC2의 보안 그룹에서 TCP 8080 포트가 열려 있어야 외부에서 접속이 가능합니다.

1. AWS EC2 대시보드 → 인스턴스 선택
2. 하단 보안 탭 → 보안 그룹 클릭
3. 인바운드 규칙 편집 → TCP 8080 허용 추가

---

🌐 접속 방법

웹 브라우저에서 다음 주소로 접속합니다:

http://<EC2 퍼블릭 IP>:8080

비밀번호 입력 화면이 나오면, 아까 설정한 mypassword를 입력하여 접속합니다.

---

마무리

이 과정을 완료하면 웹 브라우저만으로도 언제 어디서든 코드 작업을 할 수 있는 개발 환경(code-server)이 구성됩니다. 특히 가벼운 서버나 터미널 기반 개발 환경에서도 VSCode를 사용할 수 있어 매우 유용합니다.