code-server는 Microsoft의 Visual Studio Code (VSCode)를 브라우저에서 실행할 수 있게 해주는 도구입니다. 이를 사용하면 웹 브라우저를 통해 어디서든 VSCode 환경을 사용할 수 있어, 클라우드 기반 개발 환경을 구축할 수 있습니다. 이번 포스트에서는 우분투에 code-server를 설치하는 방법을 단계별로 설명하겠습니다.
1. 시스템 업데이트
먼저, 우분투 시스템을 최신 상태로 업데이트합니다. 터미널을 열고 아래 명령어를 실행하세요.
sudo apt update && sudo apt upgrade -y
이 명령어는 패키지 목록을 업데이트하고, 설치된 패키지를 최신 버전으로 업그레이드합니다.
2. 필수 패키지 설치
code-server를 설치하기 위해 필요한 의존성 패키지들이 있습니다. 이를 설치하려면 아래 명령어를 입력합니다.
sudo apt install -y curl apt-transport-https
3. code-server 설치
code-server를 설치하려면 curl을 사용하여 설치 스크립트를 다운로드하고 실행해야 합니다. 아래 명령어를 입력합니다.
curl -fsSL https://code-server.dev/install.sh | sh
위 명령어는 code-server의 최신 버전 설치 스크립트를 다운로드하여 실행합니다. 설치가 완료되면, code-server가 자동으로 시스템에 설치됩니다.
4. code-server 실행
설치가 완료된 후, code-server를 실행하려면 아래 명령어를 입력합니다.
code-server
기본적으로 code-server는 8080 포트를 사용합니다. code-server가 실행되면, 터미널에 다음과 비슷한 출력이 나타납니다.
info Server listening on http://127.0.0.1:8080
이제 브라우저에서 http://127.0.0.1:8080 주소로 접속하면, code-server가 실행된 웹 기반 VSCode 환경을 사용할 수 있습니다.
5. 비밀번호 설정 (선택 사항)
기본적으로 code-server는 비밀번호 없이 접근이 가능합니다. 보안을 강화하려면 비밀번호를 설정하는 것이 좋습니다. 비밀번호를 설정하려면, 아래 명령어를 사용하여 설정 파일을 엽니다.
nano ~/.config/code-server/config.yaml
설정 파일에서 password 항목을 찾고, 원하는 비밀번호를 입력합니다.
password: "your_password_here"
비밀번호를 설정한 후, code-server를 다시 시작하면 비밀번호를 입력해야만 접속할 수 있습니다.
6. code-server를 서비스로 설정 (선택 사항)
매번 code-server를 수동으로 실행하는 것이 번거롭다면, systemd를 사용해 자동으로 시작하도록 설정할 수 있습니다.
- code-server용 systemd 서비스를 설정하려면, 아래 명령어로 서비스 파일을 생성합니다.
sudo nano /etc/systemd/system/code-server.service
- 다음 내용을 입력하여 서비스 파일을 저장합니다.
[Unit]
Description=code-server
Documentation=https://github.com/coder/code-server
After=nginx.service
[Service]
Type=simple
ExecStart=/usr/bin/code-server
User=your_user
WorkingDirectory=/home/your_user
Restart=always
Environment=PASSWORD=your_password_here
[Install]
WantedBy=multi-user.target
- 서비스 파일을 저장하고 닫은 후, 아래 명령어로 서비스를 활성화하고 시작합니다.
sudo systemctl enable --now code-server
이제 우분투 시스템이 시작될 때마다 자동으로 code-server가 실행됩니다.
7. 방화벽 설정 (선택 사항)
만약 방화벽이 활성화되어 있다면, 8080 포트를 열어주어야 외부에서 접근할 수 있습니다. ufw를 사용하여 8080 포트를 열려면 아래 명령어를 실행합니다.
sudo ufw allow 8080
8. HTTPS 설정 (선택 사항)
브라우저에서 code-server를 사용할 때 보안을 강화하기 위해 HTTPS를 설정하는 것이 좋습니다. HTTPS 설정은 nginx와 Let's Encrypt를 통해 가능하며, 이 부분은 별도의 설정이 필요합니다.
마무리
이제 우분투에 code-server를 설치하여, 웹 브라우저에서 언제 어디서든 Visual Studio Code 환경을 사용할 수 있게 되었습니다.