현재 CoolStore 저장소에서 게시한 ZIP URL을 사용하면 App Store의 소스 추가 기능을 통해 CasaOS에 CoolStore를 계속 추가할 수 있습니다. 그러나 이는 IceWhale에서 관리하는 공식 소스가 아닌 서드파티 스토어이므로, 설치하기 전에 각 앱의 이미지, 볼륨, 포트 및 유지 관리자를 검토하세요.
2023년 포럼 튜토리얼은 이제 유일한 지침으로 사용하기에는 너무 오래되었습니다. 현재 CoolStore 저장소는 유지 관리되는 소스 URL을 게시하고 있으며, CasaOS/ZimaOS 앱 스토어 생태계 전반도 최신 스토어 프로토콜과 더욱 강화된 검증 방식으로 전환되고 있습니다.
현재 CoolStore 소스 URL
현재 프로젝트 저장소에는 다음 URL이 등록되어 있습니다.
https://casaos-appstore.paodayag.dev/coolstore.zip이전 튜토리얼의 단축 링크보다 CasaOS CoolStore 저장소를 신뢰할 수 있는 정보원으로 사용해야 합니다.
CasaOS에 CoolStore 추가하는 방법
- CasaOS 대시보드를 엽니다.
- App Store를 엽니다.
- 소스 추가를 선택합니다.
- 현재 CoolStore ZIP URL을 붙여 넣습니다.
- 소스가 새로 고침될 때까지 기다립니다.
- 무엇이든 설치하기 전에 CoolStore 애플리케이션이 표시되는지 확인합니다.
소스 추가가 성공했다고 표시되지만 앱이 나타나지 않는 경우
App Store 페이지를 새로 고치고 소스가 여전히 등록되어 있는지 확인하세요. 소스 형식이나 스토어 루트가 변경될 때 CasaOS에서 서드파티 스토어 호환성 문제가 발생한 사례가 있으므로, 성공 알림만으로 스토어가 올바르게 구문 분석되었다고 항상 단정할 수는 없습니다.
서드파티 스토어 앱을 공식 CasaOS 앱으로 간주하지 마세요
커뮤니티 스토어가 훌륭한 소프트웨어를 제공할 수는 있지만, 앱 매니페스트는 해당 애플리케이션의 업스트림 개발자와 다른 사람이 관리할 수 있습니다. 설치하기 전에 다음 항목을 확인하세요.
- Docker 이미지 소스
- 버전/태그 관리 방식
- 호스트 경로 볼륨 매핑
- 권한 모드 또는 장치 액세스
- 게시된 포트
- 업데이트 이력
중요한 앱에는 업스트림 Docker 문서를 우선 사용하세요
데이터베이스, 리버스 프록시, 비밀번호 관리자 또는 기타 중요한 서비스를 설치하는 경우 CoolStore 매니페스트를 업스트림 프로젝트의 최신 Docker 문서와 비교하세요. 서드파티 패키지는 업스트림의 주요 변경 사항을 늦게 반영할 수 있습니다.
새로운 앱 스토어 방향 이해하기
IceWhale의 최신 App Store 개발자 문서에서는 생성된 store.json, index.json, 앱별 Compose 파일, 메타데이터 및 에셋을 사용하는 새로운 v2 스토어 프로토콜을 정의하고 있습니다. 레거시 ZIP 스토어도 호환성을 위해 계속 존재할 수 있지만, 이제 앱 스토어 형식은 ZIP만이 아닙니다.
최신 App Store 개발자 문서에서 새로운 스토어 아키텍처를 설명합니다.
앱 데이터를 삭제하지 않고 스토어 소스 제거하기
스토어 소스 제거는 해당 소스에서 설치한 앱의 제거와 별개로 처리해야 합니다. 이미 실행 중인 컨테이너는 카탈로그 소스를 제거한다고 해서 자동으로 사라지지 않습니다.
커뮤니티 패키지로 설치한 애플리케이션을 제거하기 전에 중요한 앱 데이터를 백업하세요.
수동 Docker 설치가 더 나은 경우
CoolStore 앱이 오래되었거나 위험한 권한을 요청한다면 업스트림 Compose 정의를 대신 수동으로 설치하세요. 이렇게 하면 이미지 태그, 볼륨, 네트워크 및 시크릿을 더 쉽게 감사할 수 있습니다.
사용자 지정 Docker 가이드에서 동일하게 투명한 배포 방식을 제공합니다.
스토어 패키지를 바꾸기 전에 앱 백업하기
이미 CoolStore에서 앱을 설치했고 다른 스토어의 버전으로 교체하려는 경우, 두 매니페스트가 동일한 호스트 경로, 환경 변수 또는 컨테이너 이름을 사용한다고 가정하지 마세요. 먼저 앱의 영구 데이터를 내보내거나 백업한 다음, 무엇이든 제거하기 전에 두 Compose 정의를 비교하세요.
스토어 항목이 정상적인지 판단하는 방법
기반 Docker 이미지가 여전히 업데이트되고 있는지, 스토어 매니페스트가 합리적인 버전을 고정하는지, 최근 사용자들이 설치 성공을 보고했는지 확인하세요. 스토어에 계속 접속할 수 있더라도 개별 패키지 하나가 조용히 오래된 상태가 될 수 있습니다.
보안에 민감한 서비스의 경우 매니페스트가 명확한 이유 없이 권한 모드, 호스트 네트워킹, 원시 장치 또는 광범위한 파일 시스템 마운트를 요청하지 않는지도 확인하세요.
FAQ
CoolStore는 공식 CasaOS 스토어인가요?
아니요. 커뮤니티에서 운영하는 서드파티 스토어입니다.
어떤 URL을 사용해야 하나요?
오래된 단축 링크가 아니라 CoolStore GitHub 저장소에 게시된 최신 ZIP URL을 사용하세요.
CoolStore를 추가하면 CasaOS 자체가 변경되나요?
추가 앱 카탈로그 소스가 등록됩니다. 개별 앱은 여전히 포트, 볼륨, 권한 또는 호스트 액세스를 요청할 수 있으므로 각 매니페스트를 별도로 검토하세요.
CoolStore의 앱이 오래된 경우 어떻게 해야 하나요?
오래된 매니페스트를 억지로 사용하는 대신 업스트림 Docker/Compose 문서 또는 다른 유지 관리되는 스토어 패키지를 사용하세요.
