본문 바로가기
개발 노트

서버에 Code Server 설치로 원격 개발 환경 구성

by LeeInGyu 2025. 11. 19.

서버에 Code Server 설치로 원격 개발 환경 구성

서론

  • 서론에서는 Code Server의 필요성과 장점을 나열한다.

Code Server의 필요성

  • SSH로 작업하는 것에는 한계가 있음
  • 새로운 컴퓨터에서는 개발환경을 새로 설정해야 함
  • 노트북 같은 환경에서는 데스크탑의 성능을 낼 수 없음

Code Server 장점

  • Code Server는 웹 상에 vscode를 띄우는 것
  • GUI가 지원되는 vscode로 작업 가능
  • 새로 개발환경을 세팅할 필요 없음
  • 처리에 대한 모든 부하를 서버 컴퓨터 받아서 어디서든 동일한 성능을 낼 수 있음

본론

  • 본론에서는 Code Server 설치 후 실행, 간단한 설정까지 안내한다.

Code Server Install

curl -fsSL https://code-server.dev/install.sh | sh
  • 공식 페이지에서 해당 명령어로 설치 가능
  • 해당 명령어를 복사해서 리눅스 환경의 서버에 붙여넣기
curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run

만약 서버에 어떤 영향을 주는지 미리 시뮬레이션 하고 싶으면, 해당 명령어를 입력한다.

Code Server 실행

code-server
  • 해당 명령어를 실행 후, 에러가 뜨지 않는다면, 정상적으로 실행되는 것이다.

IP 설정 및 비밀번호 설정

vim /home/{USER}/.config/code-server/config.yaml
  • 위의 명령어를 실행하면, 설정 파일이 열린다.
  • code-server의 설정파일은 config.yaml 이다.
bind-addr: {아이피}:{포트}
auth: password
password: {비밀번호}
cert: false
  • 외부에서 접속되도록 아이피를 0.0.0.0 으로 변경
  • 비밀번호는 원하는 비밀번호로 설정하면 된다.

비밀번호 관련 사항

  • 비밀번호는 기본적으로 평문으로 저장한다.
  • 만약 암호문으로 저장하고 싶으면, Can I Store my Password Hashed 를 참고한다.

시스템 프로세스 재실행 후 접속

sudo systemctl restart code-server@{USER}
  • 마지막에 유저명을 입력하고, 프로세스를 재실행시킨다.
sydo systemctl status code-server@{USER}
  • 해당 명령어 입력시, Active: active 가 뜨면 성공
  • 이전에 작성했던 IP에 방문 후, 설정했던 비밀번호를 입력하면 끝
  • 확장팩을 설정하거나 테마를 설정하면 유지가 된다!

결론

  • Code Server를 설정하면, 동일한 개발환경에서 동기(Sync)되는 코드를 여러 개발자가 함께 작성할 수 있어 좋다.