커뮤니티 솔루션

BigBearCasaOS에서 CasaOS에 code-server 설치하기: 최신 이미지, 영구 작업 공간, PUID/PGID 및 웹 보안

A November 2023 Community post pointing to a BigBearCasaOS tutorial for browser-based VS Code. The forum body does not preserve the installation configuration. BigBearCasaOS still maintains code-server today using the LinuxServer.io image, so the current package and upstream documentation are the durable sources.

2023년 포럼 게시물은 완전한 설치 기록이라기보다 외부 BigBearCasaOS 튜토리얼을 안내하는 내용에 가깝습니다. 다행히 기반 패키지는 여전히 유지 관리되고 있습니다. BigBearCasaOS는 계속해서 LinuxServer.io 이미지를 사용하는 code-server를 등록하고 있습니다.

현재 배포에서는 영구 구성 및 작업 공간, 마운트된 프로젝트 폴더에 사용할 올바른 사용자/그룹 ID, 인증에 중점을 두어야 합니다. code-server는 브라우저를 통해 파일에 대한 셸 및 편집기 접근을 제공하므로, 이를 공개 인터넷에 아무런 보호 없이 노출하는 것은 읽기 전용 미디어 대시보드를 노출하는 것보다 위험이 훨씬 큽니다.

BigBearCasaOS는 여전히 code-server를 유지 관리합니다

현재 BigBear 패키지는 영구 구성 및 프로젝트 폴더를 연결하고, 호스트 포트를 통해 LinuxServer code-server WebUI를 노출합니다.

현재 BigBear code-server 패키지를 참조하세요.

/config를 영구 저장소로 유지하기

현재 LinuxServer code-server 이미지는 관련 구성을 /config 아래에 저장합니다. 사용자 설정, SSH 구성, 확장 프로그램 및 작업 공간 상태가 컨테이너를 다시 생성한 후에도 유지되도록 해당 디렉터리를 CasaOS AppData 또는 다른 영구 저장 위치에 두세요.

실제 프로젝트 폴더를 신중하게 연결하기

BigBear는 프로젝트 볼륨도 노출합니다. 소스 코드가 이미 NAS 공유 폴더나 저장 장치에 있다면, NAS 전체에 광범위한 쓰기 권한을 부여하기보다 code-server에 실제로 필요한 폴더 트리만 연결하세요.

실제 PUID와 PGID 사용하기

현재 LinuxServer 이미지는 PUIDPGID를 지원하므로, 브라우저 편집기를 통해 생성된 파일이 호스트의 소유권 체계와 일치하도록 할 수 있습니다.

항상 1000이 올바른 값이라고 가정하지 말고, 일반적인 CasaOS Linux 호스트에서 id username을 실행해 사용자 및 그룹을 확인하세요.

정상적으로 사용하기 전에 인증 설정하기

LinuxServer는 PASSWORD 또는 HASHED_PASSWORD를 지원합니다. 둘 다 설정하지 않으면 WebUI가 인증 없이 실행될 수 있습니다.

현재 code-server 컨테이너 안내를 참조하세요.

강력한 선택 기능인 SUDO_PASSWORD를 신중하게 다루기

구성에 따라 이미지 내부에서 sudo를 사용할 수 있습니다. 오래된 튜토리얼에 해당 입력란이 나온다는 이유만으로 활성화하지 마세요. sudo가 가능한 브라우저 접근형 개발 컨테이너는 일반적인 권한 없는 편집기보다 더 민감합니다.

LAN, VPN 또는 보안이 강화된 리버스 프록시 사용하기

code-server에 원격으로 접근해야 한다면, 인증된 VPN/오버레이 네트워크 또는 신중하게 구성한 HTTPS 리버스 프록시를 사용하세요. 작업 공간에 저장된 SSH 키, Git 자격 증명, 터미널 및 소스 코드를 보호해야 합니다.

이미지 내부를 수정하지 말고 컨테이너를 다시 생성하여 업데이트하기

LinuxServer는 새 이미지를 가져온 다음 동일한 영구 /config 매핑을 사용해 컨테이너를 다시 생성할 것을 권장합니다. 이렇게 하면 사용자 상태는 컨테이너 외부에 유지하면서 컨테이너를 언제든 폐기할 수 있습니다.

CasaOS의 code-server FAQ

2023년 포럼 게시물 자체가 현재의 완전한 설치 안내서인가요?

아니요. 외부 BigBear 튜토리얼을 안내하는 내용입니다.

BigBearCasaOS는 여전히 code-server를 유지 관리하나요?

예. 현재 BigBear 카탈로그에도 LinuxServer code-server 패키지가 포함되어 있습니다.

가장 중요한 영구 저장 경로는 무엇인가요?

/config와 컨테이너에 의도적으로 연결한 별도의 프로젝트/작업 공간 폴더입니다.