macOSでZimaClientが「接続中」のままになる場合は、アプリを再インストールしたりZimaOSサーバーを変更したりする前に、クライアントからサインアウトしてから再度サインインしてください。この操作だけで、数時間フリーズしていた検証済みの2.1.0の事例が復旧しました。
ただし、サインアウト／サインインを普遍的な根本原因の解決策と考えないでください。同じスレッドでは、ZimaOSのアップグレード後にMacとAndroidの両方で接続問題が発生しており、IceWhaleはファイアウォール、VPN、プロキシ、ISPの変更、ネットワーク設定について具体的に確認しています。適切なトラブルシューティングでは、アカウントやセッションの状態と、ネットワーク到達性を切り分けます。
ステップ1：サーバーがローカルで動作することを確認する
ブラウザでLAN IPを直接指定してZimaOSダッシュボードを開きます。サーバーはローカルで動作するのにZimaClientから接続できない場合は、クライアント、セッション、リモートアクセスの層を確認します。
ステップ2：サインアウトして再度サインインする
元のユーザーは、すでにZimaClientの再インストールとZimaOSの再起動を試していましたが、問題は解決しませんでした。ZimaClientからログアウトして再度認証したところ、接続が復旧しました。
このことから、クライアントやセッションの古い状態が関係していた可能性があります。ただし、どのトークンやネットワーク状態が変化したのかは、スレッドでは証明されていません。
ステップ3：ZimaOSのリモートアクセスを確認する
現在のZimaOSリモートアクセスガイドによると、リモートアクセスは「設定」→「ネットワーク」でオンまたはオフにできます。
自宅外からZimaClientを使用する場合は、有効になっていることを確認してください。
ステップ4：同じLAN上でテストする
現在のZimaOSの初期設定ガイドでは、最初の接続を同じネットワーク上で行うことを推奨しています。ローカルでもZimaClientに接続できない場合、最初に確認すべき問題はリモートNATトラバーサルではありません。
ステップ5：VPN、プロキシ、ファイアウォール、ネットワークの変更を確認する
IceWhaleのサポートは、障害が発生する前にファイアウォール、VPN／プロキシ、ISP、またはネットワーク管理の設定を変更していないか、具体的に確認しています。
診断中は、競合するVPN／プロキシクライアントを一時的に無効にし、macOSのローカルネットワーク権限によってZimaClientがデバイスを検出できることを確認してください。
ステップ6：停止したZimaClientのプロセスを再起動する
現在のZimaClientインストールガイドでは、アプリが起動しているように見えるのに正常に動作しない場合、アクティビティモニタを使用してZima関連のプロセスを終了することを推奨しています。
ステップ7：再インストールする前にログを収集する
現在のドキュメントでは、macOS上のZimaClientのログの場所を次のように記載しています。
~/Library/Application Support/Zima/logs問題を再現した直後にログを収集してください。そうすれば、サポート担当者がデバイス検出、認証、リモートネットワークのどの段階で失敗しているかを切り分けられます。
代替経路として標準VPNツールを使用する
現在のZimaOSは、代替のリモートネットワーク手段としてTailscale、WireGuard Easy、Firefly、NetBirdにも対応しています。これらはZimaClientのバックアップ機能やFinder統合の代わりにはなりませんが、独立したプライベートネットワーク経路を提供できます。
リモート接続ガイドでは、これらの層を比較できます。
認証と接続性を切り分ける
Macがサーバーを検出できるのに認証に失敗する場合は、同じZimaOSアカウントでローカルWeb UIにログインできるか確認してください。ブラウザではアカウントを使用できるのにZimaClientでは使用できない場合、問題はパスワード自体ではなく、クライアントやセッションの状態にある可能性が高いです。
ブラウザでもクライアントでもIPアドレス経由でサーバーに接続できない場合は、まずサーバーまたはLANを調べてください。
macOSのローカルネットワーク権限を確認する
macOSでは、アプリによるローカルネットワーク上のデバイス検出が制限されることがあります。ZimaClientに近くのZimaOSデバイスが表示されない場合は、macOSの「プライバシーとセキュリティ」設定でアプリの「ローカルネットワーク」権限を確認し、変更後にクライアントを再起動してください。
壊れている層だけをリセットする
ZimaOSサーバー、Remote ID、パスワード、クライアントのインストールを一度にすべてリセットしないでください。一度に1つの層だけを変更し、実際に何が問題を解決したのかを把握できるようにします。
元の事例は良い例です。サーバーの再起動とクライアントの再インストールでは改善せず、サインアウトして再度サインインすると改善しました。この証拠は、破損したサーバーのインストールではなく、セッションの状態が原因だった可能性を示しています。
代替のリモート経路を使用するタイミング
ZimaClientを引き続き使用できないものの、サーバー自体は正常な場合は、別途設定したTailscaleまたはWireGuardの経路を使うことで、ログを収集している間も管理アクセスを維持できます。これは独立したネットワーク経路として使用し、ZimaClientの問題が解決した証拠とは考えないでください。
よくある質問
ZimaClientを再インストールしても改善しなかったのはなぜですか？
再インストールしても、アカウントやセッション、ネットワークの状態が変わらない場合があります。検証済みの元の事例では、サインアウトして再度サインインすることでサービスが復旧しました。
なぜSMBは動作するのにZimaClientは失敗するのですか？
LAN上のSMBと、ZimaClientのリモート接続やセッション接続は異なる層です。一方が動作していても、もう一方が壊れていることがあります。
ZimaClientのMac用ログはどこにありますか？
現在の公式ドキュメントでは、~/Library/Application Support/Zima/logsにあると記載されています。
ZimaOSのパスワードをリセットすべきですか？
ZimaClientに「接続中」と表示されるだけでリセットする必要はありません。まず直接ログイン、サインアウト／サインイン、ネットワーク状態、ログを確認してください。
