2023년 커뮤니티 영상에서는 WisdomSky의 LinuxServer AppStore를 타사 소스로 추가하는 방법을 CasaOS에서 시연했습니다. 이 스토어는 LinuxServer.io 컨테이너 이미지를 CasaOS 호환 앱 정의로 패키징하여 대시보드에서 설치할 수 있도록 합니다.
이는 기본 제공되는 IceWhale App Store가 아니며 공식 LinuxServer.io 제품도 아닙니다. 카탈로그, 템플릿, 업데이트 시기 및 지원은 타사 저장소의 책임입니다.
CasaOS 버전 확인 및 앱 설정 백업
현재 저장소에는 사용자 지정 앱 스토어를 사용하려면 CasaOS 0.4.4 이상이 필요하다고 안내되어 있습니다. 소스를 추가하기 전에 지원되는 인터페이스를 통해 CasaOS를 업데이트하고, 기존 애플리케이션의 볼륨 경로와 포트를 기록하며, 중요한 AppData를 백업하세요.
커뮤니티 동영상 안내 시청. 현재 CasaOS 릴리스에서는 인터페이스의 라벨이 다를 수 있습니다.
LinuxServer 카탈로그 추가
- CasaOS 대시보드를 열고 App Store로 이동합니다.
- 소스 추가를 엽니다. 일부 인터페이스 버전에서는 이 영역이 더 많은 앱으로 표시됩니다.
- 저장소의 설치 섹션에서 최신 카탈로그 URL을 복사합니다.
- URL을 CasaOS에 붙여넣고 추가를 선택합니다.
- 가져오기가 완료될 때까지 기다린 후 App Store를 새로 고치고 LinuxServer 소스로 필터링합니다.
https://casaos-appstore.paodayag.dev/linuxserver.zip위 URL은 이 글을 수정한 시점에 타사 저장소에서 게시한 최신 값입니다. 가져오기 전에 WisdomSky/CasaOS-LinuxServer-AppStore에서 다시 확인하세요.
원클릭 설치 전에 앱 검토
영상에서는 code-server를 예시로 설치하면서 CasaOS가 이미지를 다운로드하고 Docker Compose를 통해 시작한다고 설명했습니다. 설치를 선택하기 전에 템플릿을 열고 다음 항목을 확인하세요.
- 호스트 및 컨테이너 볼륨 경로
- 게시된 포트 및 충돌 여부
- PUID, PGID, 시간대 및 기타 환경 값
- 권한 모드, 장치 및 기능
- 이미지 태그 및 업스트림 문서
카탈로그 항목을 사용하면 배포가 간소화되지만 기본 경로가 사용자의 서버에 적합하다는 보장은 없습니다.
앱 업데이트는 여러 계층에서 제공됩니다
저장소에서는 LinuxServer.io 릴리스가 자동으로 추적된다고 안내합니다. 그렇더라도 카탈로그 템플릿, Docker 이미지 및 애플리케이션 데이터베이스는 서로 독립적으로 변경될 수 있습니다. 주요 업그레이드 전에 업스트림 릴리스 노트를 읽고 애플리케이션의 구성 및 데이터 볼륨을 보존하세요.
소스 제거는 앱 제거와 다릅니다
카탈로그를 더 이상 사용하지 않으려면 소스 항목만 제거하세요. 기존 컨테이너와 AppData는 남아 있을 수 있습니다. 삭제하기 전에 별도로 확인하고, 하나의 카탈로그를 제거하기 위해 전체 AppData 디렉터리를 삭제하지 마세요.
CasaOS LinuxServer App Store FAQ
공식 IceWhale App Store인가요?
아니요. 별도의 커뮤니티 저장소에서 관리하는 타사 CasaOS 카탈로그입니다.
인터페이스에 “소스 추가” 대신 “더 많은 앱”이라고 표시되는 이유는 무엇인가요?
일부 CasaOS 버전에서는 라벨이 변경되었습니다. 저장소의 이슈 트래커에서 이 인터페이스 차이를 확인할 수 있습니다.
원클릭 설치를 사용하면 경로를 확인하지 않아도 되나요?
아니요. 설치하기 전에 스토리지, 포트, 권한 및 이미지 문서를 확인하세요.
