CasaOS 설치 프로그램이 Ubuntu 24.04에서 다음 메시지와 함께 중단된다면 오류: apt-cache madison 결과에서 '24.0.7'을 찾을 수 없습니다이 오류는 시스템에 강제로 다시 설치해야 하는 Ubuntu 패키지가 없어서가 아니라, 과거의 설치 프로그램과 Docker 버전 간 불일치로 인해 발생합니다. 2025년 11월 IceWhale Community 보고서는 Docker 29.0.1이 이미 설치되어 정상 작동 중이었음에도 새로 설치한 Ubuntu 24.04 LTS 시스템에서 이 문제가 발생했음을 재현했습니다.
중요한 시점은 이 정확한 설치 프로그램 버그가 나중에 해결되었다는 점입니다. 2025년 12월, CasaOS 유지 관리자들은 설치 스크립트가 Docker 24.0.7을 고정하는 대신 사용 가능한 최신 Docker Engine을 설치하고 최신 Docker 버전에 대한 Docker API 호환성 처리를 적용하도록 업데이트되었다고 보고했습니다. 현재 CasaOS 설치 프로그램 스크립트에는 더 이상 이전의 하드코딩된 24.0.7 원래 스레드에서 확인된 종속성입니다.
기존 CasaOS 설치 프로그램 오류의 모습
커뮤니티 작성자는 다음 명령으로 CasaOS를 설치했습니다.
curl -fsSL https://get.casaos.io | sudo bash
그리고 다음도 시도했습니다.
export INSTALL_DOCKER=false
하지만 설치 프로그램은 여전히 Docker 종속성 단계로 진입하여 Docker APT 저장소에서 정확히 일치하는 한 버전을 검색했습니다.
정보: VERSION '24.0.7'에 해당하는 저장소를 검색하는 중
apt-cache madison docker-ce | grep '24.0.7'
오류: apt-cache madison 결과에서 '24.0.7'을 찾을 수 없습니다
호스트에는 이미 Docker Engine 29.0.1이 설치되어 있었습니다. Docker의 Noble 저장소에 기존 스크립트가 요구한 패키지 버전이 더 이상 포함되어 있지 않았기 때문에 CasaOS가 설치를 완료하기 전에 오류가 발생했습니다.
Ubuntu 24.04에서 Docker CE 24.0.7을 찾을 수 없었던 이유
기존 설치 프로그램은 사실상 Docker의 Ubuntu 24.04 저장소에 더 이상 존재하지 않는 패키지 버전을 요청하고 있었습니다. 다음 명령을 실행하면:
apt-cache madison docker-ce
일치하는 24.0.7 항목이 존재하지 않음을 확인했습니다.
커뮤니티 회원 gelbuilding은 이를 설치 프로그램과 Docker 패키지 저장소 간의 시기 불일치로 정확히 설명했습니다. 당시에는 설치 프로그램이 업데이트되기를 기다리는 동안 Ubuntu 22.04 또는 Debian 12와 같이 지원되는 이전 배포판을 사용하는 것이 가장 번거롭지 않은 우회 방법으로 제안되었습니다.
CasaOS가 2025년 장애 이후 변경한 사항
이 동일한 Docker 호환성 문제에 관한 이후 CasaOS GitHub 토론에서는 설치 스크립트가 수정되었다고 보고했습니다. 업데이트된 동작은 다음과 같이 설명되었습니다.
- Docker 24.0.7 대신 사용 가능한 최신 Docker Engine을 설치합니다.
- 최신 Docker 릴리스에 Docker API 호환성 재정의를 적용합니다.
- CasaOS 서비스와 기본 제공 앱 관리가 최신 Docker 버전에서 작동하도록 합니다.
현재 설치 프로그램 소스는 Docker CE 24.0.7을 하드코딩하는 대신 최소 Docker 메이저 버전을 정의합니다. 현재 CasaOS 설치 프로그램 스크립트를 검토할 수 있습니다.
현재 CasaOS 설치 방법
현재 CasaOS 저장소에도 표준 한 줄 설치 프로그램이 안내되어 있습니다.
curl -fsSL https://get.casaos.io | sudo bash
또는:
wget -qO- https://get.casaos.io | sudo bash
현재 CasaOS GitHub 설치 안내를 참조하세요.
오늘은 Docker를 첫 번째 해결책으로 24.0.7까지 다운그레이드하지 마세요
커뮤니티 게시물이 작성되었을 당시에는 설치 프로그램이 Docker 24.0.7을 명시적으로 요구했으므로 Docker 24.0.7을 복원할 방법을 찾는 것이 타당했습니다. 하지만 설치 프로그램 자체가 업데이트된 지금 Ubuntu 24.04에 오래된 Docker 패키지를 강제로 설치하는 것은 일반적으로 첫 번째 해결책으로 적절하지 않습니다.
Docker를 다운그레이드하면 다른 호환성 및 보안 문제가 발생할 수 있으며, 과거의 특정 버전을 되살리기 위해 Ubuntu 릴리스나 패키지 저장소를 섞으면 호스트가 지원되지 않는 패키지 상태에 놓일 수 있습니다.
현재 설치를 진행하려면 현재 CasaOS 설치 프로그램과 현재 Docker 저장소 상태부터 확인하세요.
아직도 오래된 설치 프로그램을 사용 중인지 확인하는 방법
그래도 다음이 표시된다면:
저장소에서 VERSION '24.0.7' 검색 중
캐시되었거나 미러링되었거나 수정된 또는 서드파티 설치 프로그램이 아니라 현재 스크립트를 실행하고 있어야 합니다.
스크립트의 출처를 확인하세요. 오래된 casaos-install.sh 현재 업스트림 스크립트를 사용할 수 있는데도 포럼 첨부 파일이나 오래된 자동화 저장소에서 가져온 경우입니다.
Docker가 이미 설치되어 있다면 어떻게 해야 하나요?
원문 작성자는 이미 Docker 29.0.1을 설치한 상태였습니다. 현재 설치 프로그램은 허용되는 Docker 설치를 감지하고 함께 작동해야 하며, 원문 스레드에 나온 오래된 패키지를 요구해서는 안 됩니다.
CasaOS를 설치하기 전에 다음을 확인하세요.
docker --version
docker version
systemctl status docker
Docker가 정상 작동하지만 현재 CasaOS 설치가 계속 실패한다면 Docker를 제거하기 전에 설치 프로그램의 전체 출력을 캡처하세요. 현재 실패의 원인은 과거의 24.0.7 버그와 다를 수 있습니다.
Ubuntu 24.04는 CasaOS가 권장하는 가장 보수적인 호스트와 동일하지 않습니다
현재 CasaOS 저장소에는 Debian 12가 테스트 및 권장 운영 체제로 등록되어 있으며, 그 밖의 지원 플랫폼 또는 커뮤니티 테스트 플랫폼도 별도로 나열되어 있습니다. Ubuntu 설치도 작동할 수 있지만, 정확한 테스트 수준은 릴리스마다 다릅니다.
프로덕션 홈 서버를 구축 중이며 문제 해결 부담을 최소화하려면, 모든 새로운 Ubuntu 릴리스가 즉시 설치 프로그램 검증을 받는다고 가정하지 말고 CasaOS에서 테스트 및 권장 플랫폼으로 명시한 호스트 운영 체제를 사용하세요.
관련 없는 설치 프로그램 오류를 해결하기 위해 TLS 검증을 비활성화하지 마세요
CasaOS에서는 인증서와 관련된 별도의 과거 사고가 있었습니다. get.casaos.io. TLS 인증서 문제는 Docker 24.0.7 패키지 문제와 다릅니다.
다음과 같은 경우 curl 인증서 검증 오류를 보고하면 자동으로 추가하지 마세요 -k 또는 인증서 검증을 전역적으로 비활성화하세요. 그러면 설치 프로그램 다운로드의 신뢰 모델이 변경되므로 Docker 패키지 문제 해결과 함께 처리해서는 안 됩니다.
현재 문제 해결 절차
- 호스트 운영 체제와 아키텍처를 확인하세요.
- 다음을 실행하세요
docker --version이미 설치되어 있다면 Docker가 정상인지 확인하세요. - 현재 설치 프로그램을 다음에서 사용하고
get.casaos.io오래된 로컬 복사본이 아니라 - 출력에 여전히 Docker 24.0.7을 명시적으로 요청하는 내용이 표시되면 중지하고 스크립트 소스를 확인하세요.
- Docker 24.0.7을 다시 설치하기 위해서만 오래된 Ubuntu 저장소를 추가하지 마세요.
- 현재 호환성 요구 사항을 확인하기 전에는 Docker를 다운그레이드하지 마세요.
- 현재 스크립트가 다른 이유로 실패하면 전체 설치 프로그램 로그를 저장하세요.
CasaOS Docker 24.0.7 설치 프로그램 FAQ
CasaOS에서 Docker CE 24.0.7을 찾을 수 없다고 표시한 이유는 무엇인가요?
과거 설치 프로그램은 Docker 저장소에서 해당 버전을 명시적으로 검색했습니다. 2025년 11월경 Ubuntu 24.04 Noble 저장소에서는 더 이상 해당 버전을 제공하지 않아 설치가 중단되었습니다.
현재 CasaOS 설치 프로그램에도 여전히 Docker 24.0.7이 필요한가요?
현재 업스트림 설치 프로그램 소스에는 더 이상 기존의 Docker 24.0.7 고정 요구 사항이 표시되지 않으며, CasaOS 유지 관리자들은 2025년 12월에 설치 프로그램이 호환성 처리를 포함해 사용 가능한 최신 Docker Engine을 사용하도록 업데이트되었다고 보고했습니다.
Docker 24.0.7을 수동으로 설치해야 하나요?
일반적인 현재 해결 방법으로는 그렇지 않습니다. 이는 과거의 패키지 대상 버전이었습니다. 먼저 현재 설치 프로그램과 최신 Docker 패키지를 사용하세요.
CasaOS는 최신 Docker 릴리스에서 작동하나요?
2025년 사고 이후 수행된 설치 프로그램 및 호환성 작업은 CasaOS가 최신 Docker 버전에서 작동하도록 하기 위한 것이었습니다. 현재 릴리스에서 문제가 발생하면 모든 최신 Docker 버전이 지원되지 않는다고 가정하지 말고, 정확한 API 또는 서비스 오류를 진단하세요.
