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

LinuxからZimaOSにリモートアクセス:内蔵ZeroTierネットワークに参加する

An April 2025 thread where IceWhale explained that a Linux computer can join the ZeroTier network identified by ZimaOS and access the server through its virtual address.

Linuxユーザーが、Linux向けのネイティブZimaClientデスクトップアプリケーションなしでZimaOSにリモートアクセスしたいと考えました。IceWhaleのチームメンバーは、ZimaOSのリモートネットワークがZeroTierを基盤としているため、Linuxコンピューターからデバイスネットワークに直接参加し、同じLAN上にいるかのようにZimaOSの仮想アドレスを使用できると説明しました。

これによりIP接続は解決しますが、ZimaClientと完全に同じではありません。ZimaClientには、デバイスの検出、接続先の選択、ファイルマネージャーへのショートカット、バックアップ、その他の統合ワークフローも用意されています。

ZimaOSからネットワークIDを取得する

「設定」を開いて「ネットワーク」に切り替え、デバイスのネットワークIDをコピーします。現在のネットワークIDガイドで、インターフェース上の正確な位置を確認できます。

デバイスのLAN IPをネットワークIDの代わりに使用しないでください。IDはオーバーレイネットワークへの参加に使用し、参加後に割り当てられる仮想IPをサーバーへの接続に使用します。

公式ZeroTier Linuxクライアントから参加する

ZeroTierの最新プラットフォーム手順を使用してZeroTierをインストールします。サービスの起動後、このスレッドでは次のコマンドを使用しました。

sudo zerotier-cli join <ZIMAOS_NETWORK_ID>

プレースホルダーを、自分のZimaOSからコピーした正確なIDに置き換えます。ダッシュボードをテストする前に、ネットワークが承認済みまたはオンラインの状態になっていることを確認してください。ネットワーク識別子、デバイスアドレス、アクセス画面のスクリーンショットを必要以上に公開しないでください。

ZimaOSとアプリには仮想アドレスを使用する

参加後、その仮想ネットワーク上で割り当てられたZimaOSのアドレスを確認します。そのアドレスでダッシュボードを開き、必要に応じてアプリに公開されたホストポートを指定します。LANでは動作するのにZeroTier経由では動作しないサービスは、特定のインターフェースにのみバインドされているか、ホストのファイアウォールによってブロックされている可能性があります。

現在のZimaOSリモートアクセスガイドでは、統合クライアントの利用手順を説明しています。手動でのZeroTier利用は、コミュニティスレッドで紹介されたLinux向けの回避策であり、ZimaClientを機能面ですべて置き換えるものではありません。

ファイルアクセスは別途設定する

ネットワークに参加しても、ファイルが自動的にマウントされるわけではありません。接続が確立したら、サーバーの仮想IPとZimaOSの認証情報を使用して、ZimaOSのSMB共有に接続します。ルーターのポート転送でSMBを直接公開することは避けてください。

他の提案にさらなる計画が必要な理由

このスレッドでは、Tailscale、WireGuard、リバースプロキシ、ダイナミックDNS、Cloudflare Tunnelについても言及されています。これらは有効なアーキテクチャになり得ますが、信頼性、ルーティング、認証、公開範囲のモデルがそれぞれ異なります。リバースプロキシは特定のWebアプリには適していますが、プライベートなSMBアクセスの汎用的な代替手段ではありません。

Linuxリモートアクセスチェックリスト

  • ZimaOSでリモートアクセスが有効になっていることを確認する。
  • Linux上のZeroTierサービスが正常に動作していることを確認する。
  • 正しいネットワークIDに参加していることを確認する。
  • ブラウザーではネットワークIDではなく、割り当てられた仮想IPを使用する。
  • 個別のアプリポートをテストする前に、ZimaOSダッシュボードをテストする。
  • ネットワーク設定を変更する前に、ローカルLAN経由の復旧手段を確保する。

ZimaOS Linuxリモートアクセスに関するよくある質問

現在、Linux向けのネイティブなZimaClientデスクトップアプリはありますか?

現在の公式ダウンロードガイドに掲載されているデスクトップクライアントはWindows版とmacOS版で、Linux版はありません。

ZeroTierだけでZimaClientのファイルインターフェースを利用できますか?

いいえ。ZeroTierが提供するのはプライベートネットワークへの経路です。ファイルのマウントとアプリケーションへのアクセスは別途設定します。

SMBをパブリックルーターで転送すべきですか?

いいえ。SMBを公開せず、代わりにプライベートなオーバーレイネットワーク経由でアクセスしてください。