ZimaClientのポート変更後の接続：ZimaOS 1.5の修正

この情報源が示す最終的な結論は単純です。ZimaOS WebUIのポートを80/443から変更したことで、ユーザーのZimaBoard 2上のZima App 2.3.0の接続が失敗しましたが、ZimaOSをバージョン1.5に更新した後、ユーザーは問題が解決したと報告しました。

つまり、このページでは、2025年の障害を根拠に、現在のユーザーへ非表示の「ZimaClientポート」を手動設定するよう案内すべきではありません。これはクライアントとカスタムWebUIポート間の過去の互換性問題であり、情報源自体がバージョン1.5で解決したことを示しています。

ユーザーがNginx Proxy Managerのためにポートを変更した理由

Nginx Proxy Managerは通常、HTTP/HTTPSの受信用にホストのポート80と443を必要とします。そのため、ユーザーはZimaOSを次のように変更しました。

[gateway]
port = 8080
[ssl]
enabled = true
port = 30443

その後、CasaOS/ZimaOSのゲートウェイサービスを再起動しました。

その後、Windows版Zima Appが接続できなくなった

情報源の環境は次のとおりです。

ZimaBoard 2 1664
ZimaOSカーネル 6.12.25
Windows 11上のZima App 2.3.0

WebUIのポートを変更した後、Windowsアプリを再起動して再接続を試みましたが、失敗しました。

IceWhaleはポート設定を推測せず、再現可能な詳細を求めた

Zima-Giorgioはユーザーに、問題の正確な説明、再現手順、それまでに行った変更、試した解決策、ハードウェア、OSのバージョン、クライアントのバージョンを提供するよう求めました。同じ接続失敗でも、ディスカバリー、リモートアクセス、TLS、ポート、クライアントバージョンなど、さまざまな原因で発生する可能性があるため、これは適切な証拠の取り扱いです。

ZimaOS 1.5への更新で情報源の事例は解決した

3日後、ThomasSpiは「Zima OS 1.5に更新したら動作しました。問題は解決しました」と投稿しました。

これは情報源から得られる最も確かな結論であり、Zima Appにカスタムポートを手動で設定するという推測に置き換えるべきです。

現在のZimaClientは進化を続けている

現在のIceWhaleのドキュメントでは、ZimaClientはLAN、外部ネットワーク、ホットスポットなど、サポートされている経路を通じてWebUIへ接続できる最速の方法を自動的に見つけると説明されています。

過去の2.3.0時代の対処法を再現する前に、現在のZimaClientのインストール方法と接続モデルを確認してください。

ZimaOS 1.7.1ではDocker Web URLと動的ネットワーク処理がさらに改善された

1.7.1の変更履歴には、より柔軟なDocker Web URLのポート設定と、動的ネットワーク環境におけるURL処理の改善が含まれています。これらはアプリケーションURLに関する変更であり、古いZimaClientのバグについて具体的なことを証明するものではありません。ただし、プラットフォームのポートおよびURL処理が継続的に進化していることは示しています。

リバースプロキシとZimaClientは別々のアクセス経路

Nginx Proxy Managerを使えば、アプリやZimaOSダッシュボードに分かりやすいHTTPSドメインを割り当てられます。一方、ZimaClientは独自のディスカバリーおよびリモートアクセス処理を使用します。リバースプロキシの変更によって、すべてのバージョンでZimaClientの設定も自動的に変更されるとは限りません。

ZimaOSダッシュボードをプロキシする場合はWebSocketを維持する

その後の2026年のコミュニティ事例では、Nginx Proxy Manager経由でダッシュボードの画面自体は読み込めても、WebSocket Supportを有効にするまでライブウィジェットやアプリのダイアログが機能しなかったことが報告されています。ポートの競合とWebSocketプロキシは別々の層です。

WebUIのポートを変更する安全な方法

元のポートを記録します。
利用できる場合は、サポートされたUIからWebUIのポートを変更します。
新しいIP:ポートでブラウザーから直接アクセスできることを確認します。
ZimaClientを再起動または更新し、ディスカバリーを確認します。
その後で、リバースプロキシに80/443を割り当てます。
プロキシとクライアントの両方が失敗した場合に備え、ローカルの復旧手段を確保します。

ZimaClientのポート変更に関するよくある質問

情報源のユーザーは、Zima Appにカスタムポートを手動設定する方法を見つけましたか？

いいえ。スレッドは、OSの更新によって問題が解決したという結論で終わっています。

情報源の事例を解決したバージョンはどれですか？

ユーザーは、ZimaOS 1.5で解決したと明確に報告しています。

現在のユーザーは、ZimaClient 2.3.0の動作が現在も当てはまると考えるべきですか？

いいえ。現在のZimaClientとZimaOSの接続処理は大幅に新しくなっています。