우분투 20.04 LTS에 Visual Studio Code - 서버 IDE 설치하는 방법

Code-server는 서버에서 원격으로 실행할 수 있으며 웹 브라우저를 통해 접근할 수 있는 Visual Studio (VS) Code입니다. 이를 통해 언제 어디서나 접근할 수 있는 일관된 개발 환경을 만들 수 있습니다.

이 튜토리얼에서는 최신 우분투 20.04 서버에서 Nginx를 리버스 프록시로 사용하고 SSL Letsencrypt를 설정하여 Code-server를 설치하는 방법을 보여줍니다.

전제 조건

이 가이드에서는 4GB의 RAM, 25GB의 여유 디스크 공간 및 2개의 CPU를 갖춘 우분투 20.04 서버에 Visual Code Server를 설치합니다.

우리가 할 일:

• Visual Code Server 패키지 다운로드 및 설치
• Visual Code Server 인증 설정
• SSL Letsencrypt 생성
• Nginx를 리버스 프록시로 설치 및 구성
• 테스트

1단계 - Visual Code Server 패키지 다운로드 및 설치

먼저, 우분투 FocalFossa용 Visual Code Server의 최신 버전을 다운로드하여 시스템에 설치합니다.

기본적으로 코드 서버 패키지는 여러 운영 체제에서 사용할 수 있습니다. 다음 링크를 사용하여 GitHub에서 코드 서버 릴리스 페이지를 확인할 수 있습니다.

https://github.com/cdr/code-server/releases

이제 아래의 wget 명령을 사용하여 우분투용 Visual Code Server 패키지를 다운로드합니다.

wget -q https://github.com/cdr/code-server/releases/download/3.4.1/code-server_3.4.1_amd64.deb

그 후, 아래의 dpkg 명령을 사용하여 Visual Code Server 패키지를 설치합니다.

sudo dpkg -i code-server_3.4.1_amd64.deb

설치가 완료되면 코드 서버 서비스를 시작하고 시스템 부팅 시 자동으로 시작되도록 추가합니다.

systemctl --user start code-server  
systemctl --user enable code-server

Visual Code Server가 실행 중입니다. 아래 명령을 사용하여 확인합니다.

ss -plnt  
systemctl --user status code-server

아래는 얻을 수 있는 결과입니다.

보시다시피, Visual Code Server는 기본적으로 로컬 IP 주소 ‘127.0.0.1’에서 TCP 포트 ‘8080’으로 실행됩니다.

2단계 - Visual Code Server 인증 설정

기본적으로 Visual Code Server는 인증이 활성화된 상태로 실행됩니다.

Visual Code Server의 비밀번호 인증은 기본적으로 ‘~/.config/code-server/config.yaml’ 파일에 생성됩니다.

아래 명령을 사용하여 Visual Code Server 구성을 확인합니다.

cat ~/.config/code-server/config.yaml

다음과 같은 구성을 얻을 수 있습니다.

bind-addr: 127.0.0.1:8080  
auth: password  
password: 58403006a03529a2d26c08af  
cert: false

세부 구성:

• ‘bind-addr’는 코드 서버가 실행될 IP 주소와 포트를 정의하는 데 사용되는 옵션입니다.
• ‘auth’ 옵션은 Visual Code Server의 인증 방법으로, 기본적으로 ‘password’ 인증 방법이 사용됩니다.
• ‘password’ 옵션은 Visual Code Server 접근을 위한 비밀번호를 정의하는 데 사용되며, 강력한 비밀번호를 사용하는 것이 좋습니다.

Visual Code Server의 바인드 주소, 포트 및 비밀번호를 변경하려면 기본 구성 ‘~/.config/code-server/config.yaml’을 필요에 따라 변경하십시오.

3단계 - SSL Letsencrypt 생성

이 단계에서는 certbot 도구를 사용하여 코드 서버를 보호하기 위해 SSL letsencrypt를 생성합니다.

아래의 apt 명령을 사용하여 certbot 도구를 설치합니다.

sudo apt install certbot -y

설치가 완료되면 아래의 certbot 명령을 사용하여 SSL letsencrypt를 생성합니다.

certbot certonly --standalone --agree-tos -m [email protected] -d vscode.hakase-labs.io

완료되면 인증서는 ‘/etc/letsencrypt/live/vscode.hakase-labs.io/‘ 디렉토리에 위치하게 됩니다.

ls -lah /etc/letsencrypt/live/vscode.hakase-labs.io/

이제 certbot 도구를 사용하여 코드 서버 설치를 보호하기 위한 SSL Letsencrypt를 생성했습니다.

4단계 - Nginx를 리버스 프록시로 설정

이 단계에서는 Nginx 웹 서버를 설치하고 SSL이 활성화된 상태에서 코드 서버를 위한 리버스 프록시로 설정합니다.

아래의 apt 명령을 사용하여 Nginx 패키지를 설치합니다.

sudo apt install nginx -y

설치가 완료되면 ‘/etc/nginx/sites-available’ 디렉토리로 이동하여 새로운 가상 호스트 구성 ‘code-server’를 생성합니다.

cd /etc/nginx/sites-available/  
vim code-server

이제 도메인 이름과 SSL 경로를 자신의 것으로 변경하고 구성을 붙여넣습니다.

server {  
 listen 80;  
 server_name vscode.hakase-labs.io;  
 # enforce https  
 return 301 https://$server_name:443$request_uri;  
}  
  
server {  
 listen 443 ssl http2;  
 server_name vscode.hakase-labs.io;  
  
 ssl_certificate /etc/letsencrypt/live/vscode.hakase-labs.io/fullchain.pem;  
 ssl_certificate_key /etc/letsencrypt/live/vscode.hakase-labs.io/privkey.pem;  
  
 location / {  
 proxy_pass http://127.0.0.1:8080/;  
 proxy_set_header Host $host;  
 proxy_set_header Upgrade $http_upgrade;  
 proxy_set_header Connection upgrade;  
 proxy_set_header Accept-Encoding gzip;  
 }  
}

저장하고 닫습니다.

이제 ‘code-server’ 가상 호스트를 활성화하고 nginx 구성을 테스트하여 오류가 없는지 확인합니다.

ln -s /etc/nginx/sites-available/code-server /etc/nginx/sites-enabled/  
nginx -t

그 후, nginx 서비스를 재시작하고 시스템 부팅 시 자동으로 시작되도록 추가합니다.

systemctl restart nginx  
systemctl enable nginx

이제 Nginx 서비스가 코드 서버를 위한 리버스 프록시로 실행되고 있습니다. 아래 명령을 사용하여 확인합니다.

netstat -plntu  
systemctl status nginx

그리고 아래와 같은 결과를 얻을 수 있습니다.

Nginx 서비스는 HTTP 및 HTTPS 포트가 활성화된 상태로 우분투 20.04 서버에서 실행되고 있습니다.

5단계 - 테스트

웹 브라우저를 열고 코드 서버 설치의 URL을 입력합니다.

https://vscode.hakase-labs.io/

코드 서버 서비스 파일에서 구성한 비밀번호로 로그인합니다.

비밀번호가 올바르면 웹 브라우저에서 아래와 같은 VS Code 편집기를 얻을 수 있습니다.

결과적으로, Nginx를 리버스 프록시로 사용하고 SSL Letsencrypt로 코드 서버 설치를 보호하여 우분투 20.04 서버에 코드 서버를 설치했습니다.

참고

• https://github.com/cdr/code-server