프로젝트 소개

이 저장소는 개인 클라우드 운영 체제인 CasaOS의 독립적이고 커뮤니티가 유지 관리하는 배포판인 **ReCasaOS**용 설치 프로그램과 릴리스 번들을 제공합니다. 2025년에 배포를 중단한 원래 업스트림 프로젝트인 IceWhale과는 관련이 없습니다. 설치 프로그램은 alvins82의 포크를 기반으로 하여 CasaOS를 Docker 29 및 Ubuntu 26에 설치할 수 있게 유지하며, 인증된 공유, Compose 편집기, TLS 지원, 완전한 CI 기반 릴리스 파이프라인과 같은 기능을 추가합니다. ## 설치 단일 명령으로 설치합니다: ```bash curl -fsSL https://github.com/ReCasaOS/CasaOS-Install/releases/latest/download/install.sh | sudo bash ``` 지원 아키텍처: amd64, arm64, arm/v7. 설치 프로그램은 런타임 시 배포판과 아키텍처를 감지합니다. Ubuntu 26이 지원되지만 필수는 아닙니다. 기존 설치에서 동일한 명령을 실행하면 업그레이드되며, alvins82 또는 IceWhale 설치 프로그램의 설치도 동일한 방식으로 마이그레이션할 수 있습니다. 마이그레이션 후에는 앱 내 업데이터가 이 배포판의 릴리스를 따릅니다. 이후 `get.casaos.io/update`를 사용하지 마십시오. IceWhale의 고정 구성 요소 번들을 설치하기 때문입니다. ## 보안 및 검증 설치 프로그램이 다운로드하는 모든 패키지는 추출 전에 SHA-256 다이제스트와 대조하여 검증되며, 모든 다운로드는 ReCasaOS 릴리스에서 제공됩니다. 다이제스트는 각 구성 요소가 게시한 체크섬에서 릴리스 시점에 `install.sh`에 기록되거나, 체크섬이 없는 구성 요소의 경우 게시된 패키지에서 계산됩니다. 제거 스크립트도 동일한 방식으로 검증됩니다. ## 릴리스 하이라이트 (v0.4.98 ~ v0.4.65) 변경 로그는 여러 버전에 걸친 일련의 개선 사항과 수정 사항을 문서화합니다: - **v0.4.98**: 코어가 자체 버전 태그를 올바르게 보고합니다. - **v0.4.97**: 보안 릴리스—메시지 버스가 인증되지 않은 요청을 중지하고, Go 및 종속성이 업데이트되었으며, 폴더 다운로드가 스트리밍되고, LocalStorage가 축소되었습니다. - **v0.4.96**: 디스크 포맷 호출에 대한 잘못된 요청은 충돌 대신 400으로 거부됩니다. - **v0.4.95**: `casaos -v`가 실제 설치된 버전을 보고합니다. - **v0.4.94**: 백업이 앱 설치/업데이트/배포 중에 실패하는 대신 차례를 기다립니다. - **v0.4.93**: 하드웨어 위젯의 네트워크 카운터에서 메모리 손상 충돌이 수정되었습니다. - **v0.4.92**: git 저장소에서 앱을 배포하거나 기존 폴더를 채택합니다. 자동 재빌드 및 롤백. - **v0.4.91**: 컨테이너 후크(`post_start`, `pre_start`)가 이제 실행됩니다. - **v0.4.90**: `docker compose up`으로 실행된 스택이 앱으로 나열됩니다. Compose v5.5.1 지원. - **v0.4.89**: UPX 패킹 없이 바이너리가 빌드되어 시작 실패가 수정되었습니다. - **v0.4.88**: 위젯 재정렬, RAID 어레이가 한 번만 계산, Docker 설치 확인. - **v0.4.87**: 앱 스토어 카탈로그 폴백이 IceWhale의 현재 스토어와 일치하도록 업데이트되었습니다. - **v0.4.86**: 이미지별 세부 정보와 순차 업데이트가 포함된 "모든 앱 업데이트" 기능. - **v0.4.85**: 세션이 재시작 후에도 유지됩니다. 서명 키가 디스크에 저장됩니다. - **v0.4.84**: 자체 서명 인증서로 443 포트의 HTTPS, 백업 보존, 카탈로그 폴백. - **v0.4.83**: 루프백 인증 수정, Go 1.26으로 업데이트. - **v0.4.82**: PsiTransfer 및 ayon 앱 복원, 타사 카탈로그에서 스토어 작동. - **v0.4.81**: 백업 복원 경로 매핑 수정. - **v0.4.80**: 전체 박스 백업 및 복원(사용자, 공유, 일정, 대상). - **v0.4.79**: 백업 진행 카드, rclone crypt를 통한 암호화, 정리. - **v0.4.78**: 메시지 버스 데이터베이스 폴더 문제로 인한 새 설치 실패 수정. - **v0.4.77**: compose 파일과 데이터가 있는 모든 대상에서 앱 복원. - **v0.4.76**: API 복원 플래그 매핑 수정. - **v0.4.75**: 데이터 교체와 함께 기록에서 백업 복원. - **v0.4.74**: `.env` 파일이 없는 앱의 백업 인벤토리 수정. - **v0.4.73**: 첫 설치 확인에서 백업 기록 문제 발견 및 수정. - **v0.4.72**: rclone이 v1.75.1로 고정, CI가 모든 릴리스에서 설치 및 백업. - **v0.4.71**: 업데이트 진행 카드 및 관련 문제 수정. - **v0.4.70**: 공유 액세스 수준 표시 및 계정 관리. - **v0.4.69**: 공유 대화 상자에서 이제 액세스 수준(게스트 또는 계정)을 묻습니다. - **v0.4.68**: 설정 패널 너비 수정. - **v0.4.67**: 세부 정보 및 작업이 포함된 비-CasaOS 컨테이너 처리 개선. - **v0.4.66**: rclone으로 S3/SFTP/FTP에 백업, 회색으로 표시된 앱 수정. - **v0.4.65**: 수동으로 작성된 compose 스택의 상태 표시 수정, 바이너리에서 IceWhale 브랜딩 제거. ## 개발 및 테스트 각 릴리스는 깨끗한 Ubuntu VM에서 실행되는 설치 확인으로 테스트되며, 번들 설치, 사용자 등록, 앱 설치, rclone 대상 생성, 백업 수행, 파일 검증을 수행합니다. 확인은 또한 복원 기능을 테스트하고 설치 로그에서 알려진 실패 패턴이 있는 릴리스를 거부합니다. ## 지원 이것은 커뮤니티 프로젝트입니다. 문제는 IceWhale이 아닌 [ReCasaOS/CasaOS/issues](https://github.com/ReCasaOS/CasaOS/issues)에 보고하십시오. 원래 프로젝트는 [IceWhaleTech/CasaOS](https://github.com/IceWhaleTech/CasaOS)입니다.