新しい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アップデートに関するよくある質問
新しいリリースは、すべてのサーバーにすぐ表示されますか？
必ずしもそうとは限りません。自動配信やパッケージのダウンロード時期は、一般公開のお知らせとは異なる場合があります。
DNSフィルタリングによってアップデートがブロックされることはありますか？
更新エンドポイントとの通信に影響する可能性があるため、確認する価値はあります。ただし、元スレッドのユーザーはDNSを変更するだけでは問題を解決できませんでした。
公式のCLIアップデーターはありますか？
あります。IceWhaleの公式アップグレードチュートリアルでは、自動アップグレードに失敗した場合の代替手段としてOTAスクリプトを案内しています。
