본문으로 건너뛰기

빠른 시작

PCS를 받으셨나요? 이 가이드는 시작하는 데 필요한 모든 것을 안내합니다.

1단계: 접속 URL 확인

PCS가 설정되면 두 가지 주요 URL을 받게 됩니다:

  • CasaOS 대시보드: https://casaos-<yourdomain>.nsl.sh/
  • 관리자 패널: https://admin-<yourdomain>.nsl.sh/

IP 주소 기반의 대체 URL도 있습니다: https://<your-ip>.sslip.io/

2단계: 첫 로그인

CasaOS 대시보드

  1. 브라우저에서 https://casaos-<yourdomain>.nsl.sh/를 엽니다.
  2. CasaOS 로그인 화면이 나타납니다.
  3. 설정 시 제공된 기본 자격증명을 입력합니다.
  4. CasaOS 대시보드에 접속되었습니다.

관리자 패널

  1. https://admin-<yourdomain>.nsl.sh/를 엽니다.
  2. SSO(싱글 사인온) 로그인 페이지로 리다이렉트됩니다.
  3. CasaOS로 로그인을 클릭하고 같은 자격증명을 입력합니다.
  4. 관리자 패널에 접속되었습니다.

3단계: 비밀번호 변경

가장 중요한 첫 단계입니다. 기본 비밀번호를 즉시 변경해야 합니다.

  1. CasaOS 대시보드에서 프로필 아이콘(우측 상단)을 클릭합니다.
  2. 설정 또는 계정으로 이동합니다.
  3. 강력한 비밀번호로 변경합니다 (최소 12자, 문자/숫자/기호 조합).
  4. 저장을 클릭합니다.
경고

CasaOS 비밀번호는 SSO 비밀번호이기도 합니다. 여기서 변경하면 관리자 패널과 모든 SSO 보호 앱의 로그인이 함께 변경됩니다.

4단계: 시스템 확인

시스템 정보 확인

  1. 관리자 패널 → 시스템 정보로 이동합니다.
  2. 다음을 확인합니다:
    • 공인 IP — 실제 인터넷 연결과 일치하는지
    • 도메인.nsl.sh 도메인이 올바른지
    • PCS 버전 — 현재 소프트웨어 버전

상태 점검 실행

  1. 관리자 패널 → 상태로 이동합니다.
  2. 지금 실행을 클릭하여 자가 점검을 실행합니다.
  3. 완료될 때까지 기다리고 로그에 오류가 없는지 확인합니다.

PCS가 인터넷에 접속 가능하고, 인증서가 유효하며, 모든 시스템 서비스가 실행 중인지 확인됩니다.

5단계: 첫 앱 설치

  1. CasaOS 대시보드에서 앱 스토어 아이콘(또는 "+" 버튼)을 클릭합니다.
  2. 사용 가능한 앱을 탐색하거나 검색합니다.
  3. 추천 첫 앱:
    • Immich — 스마트폰 사진 백업 (Google Photos 대안)
    • Nextcloud — 파일 동기화 및 저장소 (Google Drive 대안)
    • Jellyfin — 영화와 음악을 위한 미디어 서버
    • Uptime Kuma — 서비스 모니터링
  4. 앱을 클릭하고 설치를 클릭합니다.
  5. 설치가 완료될 때까지 기다립니다.
  6. 앱이 대시보드에 나타나고 https://<앱>-<yourdomain>.nsl.sh/에서 접근할 수 있습니다.

6단계: 도메인 설정

기본 도메인

PCS에는 바로 작동하는 .nsl.sh 도메인이 제공됩니다. 각 앱은 자동으로 자체 서브도메인을 받습니다:

  • https://casaos-demo.nsl.sh/ — CasaOS
  • https://immich-demo.nsl.sh/ — Immich
  • https://jellyfin-demo.nsl.sh/ — Jellyfin

기본 애플리케이션

루트 도메인(<yourdomain>.nsl.sh)에 접속할 때 어떤 앱이 열릴지 선택할 수 있습니다:

  1. 관리자 패널 → 도메인으로 이동합니다.
  2. 기본 애플리케이션 드롭다운을 찾습니다.
  3. 랜딩 페이지로 사용할 컨테이너를 선택합니다.
  4. 예를 들어, "Docusaurus"를 선택하면 demo.nsl.sh가 CasaOS 대신 문서 사이트를 엽니다.

커스텀 도메인 (선택 사항)

자체 도메인을 소유하고 있다면 PCS에 연결할 수 있습니다. 자세한 설정은 커스텀 도메인 가이드를 참조하세요.

7단계: 첫 백업 생성

추가 변경 전에 기본 백업을 생성하세요:

  1. 관리자 패널 → 앱으로 이동합니다.
  2. 설치한 각 앱에 대해 백업을 클릭합니다.
  3. 문제가 발생할 경우 복원할 수 있는 복원 지점이 됩니다.

자세한 내용은 백업 및 복원을 참조하세요.

8단계: 관리자 패널 탐색

몇 분간 관리자 패널의 각 섹션을 살펴보세요:

섹션확인할 내용
대시보드PCS 상태 개요
시스템 정보IP, 도메인, 시스템 세부 정보
도메인도메인 설정과 기본 애플리케이션
인증서SSL/TLS 인증서 상태
접근SSH 접근 및 로그인 기록
상태야간 유지보수 스케줄 및 로그
리소스CPU, 메모리, 디스크, 네트워크 사용량
모든 앱의 백업 및 복원

전체 안내는 관리자 패널 가이드를 참조하세요.

다음 단계

PCS가 설정되었으니 다음 가이드를 탐색해 보세요:

관리자 패널 URL과 CasaOS URL을 북마크에 추가해두세요. CasaOS는 매일 앱 관리에, 관리자 패널은 시스템 설정에 간헐적으로 사용합니다.