ZimaOS Linuxクライアント v2.0.0：パッケージ、制限事項、修正内容

結論：Linux v2.0.0は公式ZimaClientビルドではなく、コミュニティ製クライアント

最も重要な違いは配布元です。ZimaSpaceの現在のダウンロードページとセットアップページで公式に掲載されているデスクトップ版ZimaClientは、WindowsおよびmacOS向けです。このスレッドのLinux v2.0.0パッケージは、コミュニティが保守するchicohaager/zima-linux-clientプロジェクトから提供されています。実際に便利なソフトウェアですが、公式クライアントと同じサポート範囲があると考えず、コミュニティ製ソフトウェアとして評価してください。

Files、Apps、Backup、Remote IDのサポートを示すZimaOS Linux Clientの検出機能パネル — v2.0.0のスレッドには、Files、Apps、Backup、Remote IDの検出された機能に加え、Photos機能のラベルにある誤字を示す実際のクライアント画面が掲載されています。

公式Zimaダウンロードページには、公式に対応しているプラットフォームが掲載されています。コミュニティプロジェクトのLinuxクライアントのソースが、Linuxパッケージに関する一次情報です。

Linux v2.0.0で実際に追加された機能

このリライト版では、ローカルデバイスの検出、SMBマウント、Files、Photos／フォルダー閲覧、アプリへのアクセス、バックアップタスク、再起動／シャットダウン操作、バンドルされたZeroTier経由のRemote IDに対応しています。また、煩わしい白いウィンドウの問題も修正されました。アプリのWebインターフェースが接続を拒否した場合、クライアントはアプリ名、接続先アドレス、ブラウザーエラーを表示するようになり、空のウィンドウがいつまでも残ることはありません。

これは運用上重要な改善です。以前は空白のElectronウィンドウによって、アプリ自体が停止しているのか、ポートに到達できないのか、Webエンドポイントがエラーを返しているのかを判断できませんでした。ERR_CONNECTION_REFUSEDが表示されれば、次に確認すべき対象はLinuxクライアントの再インストールではなく、ZimaOSアプリとポートだと分かります。

Remote IDが必要ならネイティブパッケージを選ぶ

このプロジェクトでは、DEB、RPM、Pacmanパッケージに加えてAppImageも公開されています。ネイティブパッケージでは、依存関係を確認し、バンドルされたZeroTier機能を設定するインストール処理が実行されます。プロジェクト自身のリリースノートでは、AppImageは同じシステム統合機能を提供しないと説明されているため、Remote IDがそこで動作すると決めつけないでください。

# install.sh、チェックサム、対応するパッケージを1つダウンロードした後
chmod +x install.sh
sudo ./install.sh

# 既存のインストール状態を確認
./install.sh --check

# サポート対象のインストール問題を修復
sudo ./install.sh --repair

ダウンロードしたインストーラーをroot権限で実行する前に、スクリプトを確認し、公開されているチェックサムを検証してください。GitHubでは、ソフトウェアサプライチェーンのセキュリティで、リリースアセットの完全性に関する考え方を説明しています。

テスト済みプラットフォームの範囲を把握する

このスレッドでは、Ubuntu、Debian、Fedora、Arch、openSUSE系でパッケージと起動の確認が行われたと報告されています。ただし、メンテナーは、自動テストやコンテナ内の確認は、実機での幅広い検証とは異なると明確に説明しています。公開されているv2.0.0はx86_64専用です。実際のARMハードウェアでアプリが起動することが確認できていなかったため、ARM64版は意図的に公開されていません。

Wayland、SELinux、一般的でないキーリング、派生ディストリビューションを使用している場合は、バグ報告時にその詳細を記録してください。「Linuxで動かない」だけでは原因を特定できません。ディストリビューション、バージョン、X11／Wayland、パッケージ形式が有用な切り分け情報です。

開かないアプリを診断する方法

同じアプリがZimaOSダッシュボードから直接開くことを確認します。
Linuxクライアントのエラーメッセージに表示されたURLとポートを確認します。
アプリが実行中であり、Linuxコンピューターからそのポートに到達できることを確認します。
LANアクセスは機能するのにRemote IDが機能しない場合は、クライアントのZeroTier診断を実行します。
埋め込みアプリWebビューとは別に、SMB／ファイルアクセスを直接テストします。

ZimaClientのデバイスアクセスとTailscaleリモートアクセスでは、ZimaOS側でサポートされている2つの比較経路を確認できます。

代わりに標準的なLinuxツールを使うべき場合

必要なのがファイルアクセスだけなら、Linuxには成熟したSMB／CIFSマウント機能とTailscale／WireGuardクライアントがすでにあります。コミュニティ製デスクトップクライアントの価値が高まるのは、デバイス検出、アプリ、バックアップ、リモートIDを1つのUIで利用する、統合されたZimaOS体験を求める場合です。サーバーやヘッドレスワークステーションでは、標準プロトコルのほうがシンプルで自動化しやすいことがあります。

要件が共有ストレージだけなら、ZimaOSのSMB認証を使うほうが適切です。

LinuxクライアントのバグとZimaOSサービスのバグを混同しない

同じ操作を、必ずZimaOSのWebインターフェースまたは標準プロトコルからもテストしてください。Webダッシュボードではファイルを閲覧でき、SMBも機能するのにLinuxクライアントだけが失敗する場合は、クライアント層の問題として報告します。基盤となるZimaOSアプリや共有自体も失敗する場合は、まずそのサービスを修正してください。この切り分けにより、無関係なNASの問題までコミュニティ製クライアントのせいにすることを防げます。

FAQ

ZimaClientはLinuxで公式に利用できますか？

現在の公式ZimaSpaceダウンロードフローでは、デスクトップ版ZimaClientの対応OSとしてWindowsとmacOSが掲載されています。このコミュニティスレッドのv2.0.0 Linuxアプリは、別のコミュニティGitHubリポジトリで保守されています。

Linux v2.0.0はARM64に対応していますか？

いいえ。実機でのアプリ起動が検証されていなかったため、v2.0.0のスレッドではARM64ビルドは公開されていません。

AppImageとDEB／RPMのどちらを使うべきですか？

プロジェクトのシステム統合機能と、バンドルされたZeroTier Remote ID経路が必要なら、ネイティブパッケージを使用してください。AppImageはよりポータブルですが、インストール後に利用できるすべての機能が提供されるわけではありません。

アプリにERR_CONNECTION_REFUSEDと表示されるのはなぜですか？

埋め込みブラウザーが、アプリが接続を受け付けていないアドレスに到達したためです。クライアントを再インストールする前に、アプリの状態、接続先ポート、ホストアドレス、ファイアウォールを確認してください。

LinuxのSMBでZimaOSの共有を直接マウントできますか？

はい。目的がファイルアクセスだけであれば、標準のCIFS／SMBツールはコミュニティ製デスクトップクライアントの有効な代替手段です。