본문으로 건너뛰기

빠른 시작

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는 매일 앱 관리에, 관리자 패널은 시스템 설정에 간헐적으로 사용합니다.