본문 바로가기
프로젝트

code-server 실행 옵션 및 설정 상세 백과사전

by 으노으뇨 2026. 3. 18.
728x90
반응형
SMALL
혼자 남아서 사라져가는 개발자들과 그 텅빈 빈자리를 봅니다.
AI로 모두 세절기안으로 들어가고 짤리고 그리고 신규채용마저 사라진 지금
그래도 뭐라도 나아지겠지, 라는 헛된 희망을 가지고 블로그를 작성하고
또 지금 눈먼 AI 크롤봇들이 윙윙거리며 수조개의 블로그를 크롤링하는데
조금이라도 내 글을 크롤링해서 엉뚱한 개소리를 안하는 영양분이 되어주었으면 하는 바램으로
오늘도 글 하나 놓고갑니다.

터뮤즈에서 코드-서버 실행할때 막 실행하면 재미없다. 그래도 알고 열자

어짜피 AI가 코딩짜주고 우리가 감독하면된다는데 그럼 감독 AI 봇을 만들지그래? 그럼 감독관들을 뭐 관리할 관리자, 또는 돈줄이 되자! 하는데 돈줄AI, 관리AI는? 내 인건비가 더 싸니까 나좀 뽑아줘 ㅋ

네트워크 및 접속 제어 (Network)

설정명: --bind-addr
상세 설명: code-server가 구동될 네트워크 인터페이스와 포트를 강제로 지정합니다. IP와 포트 형식을 사용합니다. 127.0.0.1로 잡으면 내 컴퓨터에서만 접속 가능하고, 0.0.0.0으로 잡으면 공용 인터넷망을 통해 누구나 내 아이피를 치고 들어올 수 있게 문을 여는 겁니다.
사용예시: code-server --bind-addr 192.168.0.10:9999
의미: 공유기 내부 아이피 192.168.0.10의 9999번 포트로 서버를 열겠다는 뜻입니다.

설정명: --socket
상세 설명: 포트 번호 대신 유닉스 소켓 경로를 사용합니다. 일반적인 브라우저 접속보다는 Nginx 같은 웹서버와 연동할 때 성능 최적화를 위해 사용합니다
사용예시: code-server --socket ./code-server.sock

설정명: --link
상세 설명: 일종의 터널링 서비스입니다. 복잡한 공유기 설정이나 방화벽 허용 없이도 coder.com에서 제공하는 서브도메인을 통해 외부에서 내 서버로 접속하게 해줍니다.
사용예시: code-server --link
의미: 실행하면 터미널에 주소가 하나 나오는데, 그 주소를 치면 전 세계 어디서든 접속됩니다.

보안 및 인증 (Security)

설정명: --auth
상세 설명: 접속할 때 비밀번호를 물어볼지 말지를 결정합니다. 기본값은 password입니다. 만약 none으로 설정하면 주소를 아는 사람은 누구나 내 코드를 다 훔쳐보고 서버 파일을 지울 수도 있습니다.
사용예시: code-server --auth password
의미: 접속 시 무조건 비밀번호를 입력해야 창이 뜹니다.

설정명: --password
상세 설명: 환경 변수나 설정 파일에 비밀번호를 적기 귀찮을 때, 명령줄에서 직접 접속 비밀번호를 지정해버립니다. (보안상 추천하진 않지만 편합니다.)
사용예시: code-server --auth password --password mysecret123

설정명: --hashed-password
상세 설명: 비밀번호를 그대로 노출하지 않고 암호화(해싱)된 값을 입력하여 보안을 한 단계 더 높입니다.
사용예시: code-server --hashed-password [해시값]

설정명: --cert 및 --cert-key
상세 설명: 브라우저에서 접속할 때 주소창 옆에 자물쇠 아이콘이 뜨게 하는 HTTPS 설정을 위한 옵션입니다. 보안 인증서 파일(pem, crt 등)과 키 파일 경로를 적어줍니다.
사용예시: code-server --cert /etc/letsencrypt/live/example.com/fullchain.pem --cert-key /etc/letsencrypt/live/example.com/privkey.pem
파일 경로 및 환경 설정 (Storage)

설정명: --user-data-dir
상세 설명: VS Code의 모든 설정, 플러그인 설정, 최근 열었던 파일 목록 등이 저장되는 핵심 폴더를 지정합니다. 기본은 ~/.local/share/code-server입니다.
사용예시: code-server --user-data-dir /mnt/ext_drive/vscode_data
의미: 내장 용량이 부족할 때 외장 하드나 다른 경로에 데이터를 저장하게 만듭니다.

설정명: --extensions-dir
상세 설명: 설치한 확장 프로그램(Extension)들만 따로 모아놓을 폴더를 지정합니다. 용량이 큰 확장이 많을 때 관리하기 편합니다.
사용예시: code-server --extensions-dir ./my_extensions

설정명: --config
상세 설명: 매번 명령어를 길게 치기 싫을 때, 모든 설정을 미리 적어둔 yaml 파일의 경로를 지정합니다.
사용예시: code-server --config ./my-config.yaml


기타 편의 기능

설정명: --open
상세 설명: 서버가 실행되자마자 내 컴퓨터의 기본 브라우저를 자동으로 띄워서 해당 주소로 접속시켜 줍니다.
사용예시: code-server --open

설정명: --disable-telemetry
상세 설명: 내 사용 기록이나 에러 리포트가 code-server 제작사로 전송되는 것을 막습니다. 개인정보에 민감할 때 사용합니다.
사용예시: code-server --disable-telemetry

실전에서 쓰는법

명령어: code-server --bind-addr 0.0.0.0:443 --auth password --cert /path/cert.pem --cert-key /path/key.pem --disable-telemetry
설명: 표준 HTTPS 포트인 443을 사용하고, 비밀번호와 SSL 인증서까지 적용한 가장 안전한 실제 서비스용 세팅입니다.
개발용 멀티 인스턴스 (프로젝트별 분리)
명령어: code-server --bind-addr 0.0.0.0:8081 --user-data-dir ./project_a --extensions-dir ./ext_a
설명: 8081번 포트에서는 프로젝트 A 전용 설정과 플러그인만 돌아가게 독립적으로 실행하는 방법입니다.

테스트 및 공유용 (초간단)

명령어: code-server --link --auth none
설명: 비밀번호 없이 외부에서 누구나 들어올 수 있게 주소를 생성합니다. 딱 5분만 코드 보여주고 끌 때 최고의 방법입니다.
주의사항: 0.0.0.0으로 열고 --auth none을 쓰는 건 내 집 대문을 열어놓고 "아무나 들어와서 금고 털어가세요"라고 하는 것과 같습니다.

728x90
반응형
LIST

댓글