본문으로 건너뛰기

CasaOS 대시보드

CasaOS는 PCS 위에서 동작하는 사용자 친화적인 인터페이스입니다. 관리자 패널이 시스템 수준 설정을 관리하는 반면, CasaOS는 일상적으로 앱과 파일을 다루는 곳입니다.

접속 주소: https://casaos-<yourdomain>.nsl.sh/ (예: https://casaos-demo.nsl.sh/)

개요​

CasaOS 대시보드는 다음을 제공합니다:

  • 앱 스토어 — 원클릭으로 애플리케이션을 탐색하고 설치
  • 설치된 앱 — 실행 중인 애플리케이션을 실행, 중지, 관리
  • 파일 관리자 — PCS의 파일을 탐색, 업로드, 다운로드, 관리
  • 시스템 위젯 — CPU, RAM, 디스크, 네트워크를 한눈에 모니터링
  • 사용자 관리 — 비밀번호와 프로필 설정 변경

로그인​

  1. CasaOS URL로 이동합니다.
  2. PCS 설치 시 설정한 사용자 이름과 비밀번호를 입력합니다.
    • 기억나지 않으면 관리자 패널 → 시스템 정보 → 기본 사용자에서 확인하세요.
  3. 로그인을 클릭합니다.

앱 스토어​

앱 스토어는 PCS에 새로운 애플리케이션을 추가하는 가장 쉬운 방법입니다.

앱 탐색​

  1. CasaOS 대시보드에서 앱 스토어 아이콘(또는 "+" 버튼)을 클릭합니다.
  2. 카테고리별로 탐색하거나 이름으로 검색합니다.
  3. 각 앱에는 설명, 필요한 리소스, 스크린샷이 표시됩니다.

앱 설치​

  1. 원하는 앱을 찾아 클릭합니다.
  2. 앱 세부 정보를 확인하고 설치를 클릭합니다.
  3. CasaOS가:
    • Docker 이미지를 다운로드합니다
    • /DATA/AppData/ 아래에 데이터 디렉토리를 생성합니다
    • 네트워크를 구성하고 자체 서브도메인에 앱을 노출합니다
  4. 설치가 완료되면 대시보드에 앱이 나타나고 https://<앱>-<yourdomain>.nsl.sh/에서 접근할 수 있습니다.

커스텀 앱 설치​

앱 스토어에 없는 앱의 경우 커스텀 Docker 컨테이너를 설치할 수 있습니다:

  1. "+" 버튼을 클릭하고 커스텀 설치(또는 사용자 정의 앱 설치)를 선택합니다.
  2. Docker 이미지, 포트, 볼륨, 환경 변수를 입력합니다.
  3. 설치를 클릭하여 배포합니다.

이것은 docker-compose.yml을 작성하는 것과 같지만 그래픽 인터페이스를 사용합니다.

설치된 앱 관리​

시작과 중지​

  • 대시보드에서 앱 아이콘을 마우스 오른쪽 클릭하여 옵션을 확인합니다.
  • 시작, 중지, 재시작 또는 제거를 선택합니다.
  • 앱을 중지하면 데이터를 삭제하지 않고 시스템 리소스를 해제합니다.

앱 업데이트​

  • 업데이트가 가능하면 앱 아이콘에 알림 배지가 표시됩니다.
  • 마우스 오른쪽 클릭 후 업데이트를 선택하여 최신 버전을 받습니다.
  • 업데이트 중에 데이터는 보존됩니다.
팁

업데이트 전에 관리자 패널 → 앱에서 백업을 생성하세요. 업데이트에 문제가 생기면 복원할 수 있습니다.

앱 제거​

  • 앱을 마우스 오른쪽 클릭하고 제거를 선택합니다.
  • 앱 데이터를 삭제할지 묻습니다.
  • 나중에 재설치할 수 있으므로 데이터 유지를 선택하거나, 깨끗하게 제거하려면 데이터 삭제를 선택합니다.

파일 관리자​

내장 파일 관리자로 PCS의 파일을 탐색하고 관리할 수 있습니다.

파일 접근​

  1. CasaOS 대시보드에서 파일 아이콘을 클릭합니다.
  2. 파일 브라우저를 사용하여 디렉토리를 탐색합니다.
  3. 기본 뷰는 모든 앱 데이터가 저장된 /DATA를 표시합니다.

파일 작업​

  • 업로드 — 파일을 드래그 앤 드롭하거나 업로드 버튼을 클릭합니다.
  • 다운로드 — 파일을 선택하고 다운로드를 클릭합니다.
  • 폴더 생성 — 마우스 오른쪽 클릭 후 "새 폴더"를 선택합니다.
  • 이름 변경 / 이동 / 삭제 — 파일을 마우스 오른쪽 클릭하여 옵션을 확인합니다.
  • 공유 — 파일의 공유 가능한 링크를 생성합니다.

주요 디렉토리​

경로내용
/DATA/AppData/모든 앱 데이터 및 설정
/DATA/AppData/<앱>/특정 앱의 데이터 폴더
/DATA/Media/미디어 파일 (구성된 경우)
/DATA/Documents/문서 저장소

시스템 모니터링 위젯​

CasaOS 대시보드 상단에 시스템 상태 위젯이 표시됩니다:

  • CPU — 현재 CPU 사용률
  • RAM — 메모리 사용량 (사용 중 / 전체)
  • 디스크 — 저장소 사용량 (사용 중 / 전체)
  • 네트워크 — 현재 업로드 및 다운로드 속도

더 자세한 모니터링이 필요하면 관리자 패널 → 리소스를 사용하세요.

계정 설정​

비밀번호나 프로필을 변경하려면:

  1. 프로필 아이콘(우측 상단)을 클릭합니다.
  2. 설정 또는 계정을 선택합니다.
  3. 비밀번호나 표시 이름을 업데이트합니다.
  4. 저장을 클릭합니다.
노트

CasaOS 비밀번호를 변경하면 관리자 패널과 모든 SSO 지원 앱의 로그인 자격증명도 함께 변경됩니다.

CasaOS vs 관리자 패널​

기능CasaOS관리자 패널
앱 설치/관리예보기만 가능
파일 관리예아니오
도메인 설정아니오예
인증서 관리아니오예
시스템 터미널아니오예
리소스 모니터링기본 위젯벤치마크 포함 상세 정보
마이그레이션아니오예
지원 티켓아니오예
백업/복원아니오예
사용자 계정예CasaOS 링크

요약하면: CasaOS는 일상적인 앱 관리용, 관리자 패널은 시스템 관리용입니다.