コミュニティソリューション

ホーム画面にZimaOSのアプリが表示されない場合の確認事項

A ZimaOS 1.6.1 user lost all app icons across multiple browsers; after updating to 1.6.2, the apps returned.

ZimaOSのホーム画面からすべてのアプリが消えているものの、サーバーとデータには引き続きアクセスできる場合、NASが故障している、またはアプリが削除されたと決めつけないでください。まず、正確なZimaOSのバージョン、Dockerコンテナがまだ存在しているか、そして症状がフロントエンド/ダッシュボードの不具合だけなのかを確認してください。

元の事例はその好例です。ZimaOS 1.6.1では、ユーザーは複数のブラウザーでアプリが表示されず、システムが間もなく故障するのではないかと心配していました。1.6.2にアップグレードしたところ、アプリが戻りました。これはユーザーによって確認された復旧例ですが、このスレッドには、アプリが表示されなくなるすべてのケースが1.6.1の共通のバグだったと証明するIceWhaleの声明はありません。

ステップ1:アプリが実際に消えているか確認する

ターミナルを開き、Dockerを確認します。

docker ps -a

コンテナが一覧に残っている場合、ホーム画面が空でも、アプリの定義やデータはまだ存在している可能性があります。

Docker自体がエラーを返す場合は、ダッシュボードより深刻な問題です。サービスまたはストレージの問題として診断してください。

ステップ2:正確なZimaOSのバージョンを確認する

元のユーザーは1.6.1を使用しており、1.6.2に更新したところアプリアイコンが復元されたと報告しています。公式のZimaOS 1.6.2のリリースノートには、より広範な安定性およびストレージ関連の修正が記載されていますが、ユーザーが遭遇したアプリ消失の症状について具体的には記載されていません。

すでに新しい安定版を使用している場合は、過去の1つの事例で解決したからといって、1.6.2へダウングレードしないでください。

ステップ3:クリーンなブラウザーセッションでダッシュボードをテストする

プライベート/シークレットウィンドウを使用し、ページをハードリロードしてください。テスト中は、ローカルのZimaOSアドレスに対する強力なコンテンツブロッカーやスクリプトフィルターを無効にします。

元のユーザーはBrave、Firefox、Chromeをすでに試していたため、単一ブラウザーのキャッシュだけが原因である可能性は低くなっていました。ただし、現在のケースでもこの確認は有効です。

ステップ4:IPアドレスとホスト名でテストする

LAN内の直接IPアドレスと、普段使用しているローカルホスト名の両方を開いてください。一方ではアプリのダッシュボードが表示され、もう一方では表示されない場合は、DNS、キャッシュされたフロントエンドアセット、またはアクセス元ごとのブラウザー保存データを調査します。

Dockerコンテナが正常に動作しているにもかかわらず、両方でホーム画面が空の場合は、Dockerアプリを再インストールするのではなく、ZimaOSのフロントエンド/バックエンドにあるアプリ一覧サービスに注目してください。

ステップ5:繰り返し再起動する前にストレージを確認する

元のユーザーは、ディスクが断続的に消え、毎日再起動が必要になることにも言及していました。これは別の優先度の高い症状です。AppDataストレージが見えなくなると、アプリの列挙や起動に失敗する可能性があります。

「設定」→「ストレージ」を開き、AppDataの保存先がマウントされていることを確認してください。最新のZimaOSストレージ設定ガイドでは、現在のディスクおよびアレイの状態インジケーターについて説明しています。

データが安全だと確認するまでアプリを再インストールしない

コンテナとAppDataがまだ存在している場合、App Storeから再インストールすると、重複したパスや新しいボリュームが作成され、どのデータがどのインスタンスに属するのか分からなくなる可能性があります。

Dockerアプリのトラブルシューティングガイドでは、UIからの表示消失と、実際のコンテナ消失を切り分ける方法を説明しています。

UIの障害とアプリの障害を見分ける方法

症状 可能性の高い層
ホーム画面は空だが、コンテナは存在し実行中 ダッシュボード/アプリ一覧UIまたはバックエンドのメタデータ
コンテナは存在するが停止している Docker/アプリ設定または依存関係の問題
コンテナはないがAppDataは存在する アプリメタデータまたは再インストールによる復旧経路
AppDataストレージが見えない ストレージのマウント、権限、またはディスクの問題
ダッシュボードとターミナルの両方が利用できない システム、ネットワーク、またはサービスの障害

更新すべき場合とログを収集すべき場合

新しい安定版のZimaOSが利用可能で、バックアップも最新であれば、更新を検討してよいでしょう。特に、問題が以前のアップデート直後に発生した場合は有効です。ただし、ストレージが劣化している、またはシステムディスクに障害が発生している場合は、まずデータ層を修復または保護してください。

最新の安定版でも問題が続く場合は、ブラウザーのコンソールエラー、docker ps -aの結果、現在のストレージ状態、ZimaOSのバージョン、関連するシステム/アプリサービスのログを収集して、サポートに提供してください。

FAQ

ZimaOS 1.6.2でアプリアイコンが表示されない問題は解決しましたか?

元のユーザーが遭遇した1.6.1のケースでは解決しました。ただし、このスレッドから、アプリが表示されないすべての問題が同じ原因だったとは証明できません。

ホーム画面が空の場合、アプリは削除されていますか?

必ずしもそうとは限りません。何かを再インストールする前に、docker ps -aとAppDataストレージを確認してください。

ブラウザーのキャッシュによってZimaOSのすべてのアプリが隠れることはありますか?

古いフロントエンドによってUIの問題が発生する可能性があるため、ハードリロードやプライベートウィンドウを試す価値はあります。クリーンなブラウザーでもすべて同じ症状になる場合は、次にサーバー側を調査してください。

アップデート前にバックアップ用ドライブを購入すべきですか?

いずれにしてもバックアップを維持するのは賢明ですが、ダッシュボードが空というだけで、差し迫ったデータ損失が証明されるわけではありません。まずシステムとストレージの状態を確認してください。