새 ZimaOS 릴리스가 출시되었는데도 서버에 이전 버전이 표시될 때, 업데이트 버튼이 없다고 해서 설치가 손상된 것은 아닙니다. 2025년 10월의 원문 스레드에서는 1.5를 기다리며 1.4.3에 머물러 있던 사용자들이 DNS 필터링, 인터넷 연결, 직접 다운로드 실패 문제를 거쳐 마침내 공식 명령줄 OTA 업데이트 프로그램을 사용하게 된 과정이 다뤄졌습니다.
현재 버전 1.5는 이미 과거의 버전이지만, 문제 해결 방식은 여전히 유용합니다. 자동 업데이트가 권장되는 방법이며, 네트워크 필터링으로 인해 업데이트 메타데이터나 패키지가 다운로드되지 않을 수 있습니다. 또한 IceWhale은 일반 업데이트 절차가 실패하는 경우를 위해 명령줄 대체 방법을 제공합니다.
자동 업그레이드가 권장 방법입니다
IceWhale의 공식 설치 및 업그레이드 안내에서는 자동 업그레이드를 가장 간단하고 안전한 방법으로 설명합니다. ZimaOS는 백그라운드에서 패키지를 다운로드하고, 업데이트 준비가 완료되면 설정에 알림을 표시합니다.
따라서 릴리스 공지가 게시되는 즉시 업그레이드 버튼이 표시되지 않을 수도 있습니다.
OTA 시스템이 고장 났다고 판단하기 전에 연결 상태를 확인하세요
원문 스레드에서 커뮤니티 회원들은 Pi-hole, AdGuard Home, NextDNS, 방화벽 규칙 또는 사용자 지정 DNS가 업데이트 서비스를 차단하고 있는지 물었습니다. 한 사용자는 사용자 지정 DNS를 제거하고 DMZ 구성까지 테스트했지만 문제가 해결되지 않았습니다.
이러한 테스트 결과는 “DNS를 확인하라”는 것이 진단 과정의 한 단계일 뿐, 반드시 해결책이 되는 것은 아니라는 점을 보여 줍니다.
한 사용자는 UI 외부에서도 릴리스를 다운로드할 수 없었습니다
이후 한 참여자는 명령줄 업데이트 프로그램을 사용해 보았지만 다운로드 실패 메시지를 받았습니다. IceWhale의 GitHub 릴리스 페이지에서 직접 다운로드도 시도했으나 전송 속도가 극도로 느렸습니다.
이 정황은 설정 버튼이 없는 문제만으로 보기보다는 연결 또는 배포 경로에 문제가 있을 가능성을 더 강하게 시사했습니다.
IceWhale은 공식 명령줄 업그레이드 경로를 제공합니다
공식 Zima-Giorgio 업그레이드 안내에서는 자동 업그레이드가 실패하는 경우를 위한 대체 방법으로 다음 명령을 문서화하고 있습니다.
sudo -i
curl -fsSL 'https://ota.zimaos.com/' | sh버전을 지정하지 않으면 스크립트는 현재 업데이트 채널에 따라 최신 릴리스를 선택합니다. IceWhale은 의도적인 업그레이드 또는 다운그레이드 작업을 위해 버전별 URL도 제공합니다.
과거 포럼 게시물의 명령을 사용해 강제로 업데이트하기 전에 공식 ZimaOS 설치 및 업그레이드 절차를 확인하세요.
원문의 사용자는 결국 OTA 스크립트로 업데이트했습니다
10월 25일, 릴리스를 다운로드하지 못했던 참여자는 다시 글을 남겨 일반 OTA 명령으로 시스템을 ZimaOS 1.5로 성공적으로 업데이트했다고 밝혔습니다.
이는 원문에서 확인된 결과입니다. 다만 그래픽 알림이 표시되지 않은 이유까지 밝혀 주는 것은 아닙니다.
베타 채널은 테스트용이며, 누락된 모든 안정 버전 업데이트의 해결책은 아닙니다
개발자 모드에서는 ZimaOS를 베타 업데이트 채널로 전환할 수 있습니다. 시험판 빌드를 의도적으로 사용하려는 경우에는 유용하지만, 안정 버전 배포가 느려 보인다는 이유만으로 활성화해서는 안 됩니다.
공식 안내에서는 안정 버전 자동 업그레이드를 기본 권장 방법으로 유지하고 있습니다.
원격 업데이트 스크립트는 높은 권한의 시스템 작업으로 취급하세요
OTA 명령은 스크립트를 다운로드한 후 root 권한으로 실행합니다. 공식 IceWhale OTA 도메인만 사용하고, 서버의 전원과 네트워크가 안정적인지 확인하며, 버전을 강제로 변경하기 전에 중요한 데이터를 백업하세요.
현재 서버에서 과거의 1.5.0 URL을 강제로 사용하지 마세요
원문 스레드는 2025년 10월에 1.4.3에서 1.5로 이동하는 문제를 다룬 글이었습니다. 현재 ZimaOS는 해당 릴리스보다 훨씬 발전했습니다. 버전이 고정된 1.5 명령은 과거의 맥락에 해당하며, 현재 업그레이드 권장 방법이 아닙니다.
ZimaOS 업데이트 FAQ
새 릴리스가 모든 서버에 즉시 표시되나요?
반드시 그렇지는 않습니다. 자동 배포 및 패키지 다운로드 시점은 공개 공지 시점과 다를 수 있습니다.
DNS 필터링이 업데이트를 차단할 수 있나요?
업데이트 엔드포인트에 간섭할 수 있으므로 확인해 볼 만한 항목입니다. 하지만 원문의 사용자들은 단순히 DNS를 변경하는 것만으로 문제를 해결하지 못했습니다.
공식 CLI 업데이트 프로그램이 있나요?
있습니다. IceWhale의 공식 업그레이드 안내에서는 자동 업그레이드가 실패할 때 사용할 수 있는 대체 방법으로 OTA 스크립트를 안내합니다.
