TP-Link Omadaは、現在もメンテナンスされているBigBearCasaOSストアを通じてCasaOSにインストールできますが、このパッケージは公式のTP-Link Dockerイメージではなく、コミュニティによって管理されています。 2026年現在、BigBearCasaOSにはmbentley/omada-controllerを使用するTP-Link Omada Controller 6.2が掲載されています。
つまり、TP-Linkのコントローラー要件とリリースノートを製品に関する正式な情報源として扱い、BigBearのマニフェストはCasaOS向けのパッケージング層としてのみ利用してください。
現在のBigBearCasaOSストアを追加する
現在のBigBearCasaOSアプリストアには、App StoreのZIPファイルと現在のOmadaパッケージが掲載されています。
Omada Controllerアプリをインストールする
ストアを追加したら、TP-Link Omada Controllerを検索し、イメージとバージョンを確認してインストールします。その後の更新に備え、マッピングされている設定およびデータフォルダーを記録しておいてください。
TP-LinkがサポートしているのはLinuxであり、このDockerイメージを直接サポートしているわけではない
TP-Linkの現在のOmada Software Controllerの要件には、対応するx64 Windows/Linuxプラットフォームが記載されています。BigBearが使用するDockerイメージは別途管理されています。
コントローラーのデータを永続化する
コントローラーのデータベースには、サイト、管理対象デバイス、設定、ユーザー、履歴が含まれます。ネットワークで使用する前に、BigBearがコントローラーのデータおよびログディレクトリを永続的なCasaOSストレージにマッピングしていることを確認してください。
安定したLAN IPアドレスを使用する
DHCPでCasaOSサーバーのIPアドレスを予約してください。ルーターの再起動後に、Omadaデバイスや管理者が変動するコントローラーのアドレスを探し直す必要がないようにします。
コントローラーのバージョンをアップグレードする前にバックアップする
メジャーアップグレードの前に、Omadaコントローラーのバックアップをエクスポートし、永続化されたコンテナデータを保護してください。ネットワークコントローラーのスキーマ変更は、通常のWebアプリの更新より元に戻しにくい場合があります。
採用と検出に使用するポートを確認する
Web UIは開くのにOmadaデバイスが検出または採用されない場合は、コンテナのネットワークモードと、必要なOmadaポートが重要です。適当にポートを開くのではなく、BigBearのマニフェストを現在のTP-Linkコントローラーのドキュメントと照合してください。
管理UIを直接公開しない
管理インターフェースへのインターネットからの無制限なポート転送ではなく、LANアクセス、VPN、またはコントローラーが対応するクラウドアクセスを使用してください。
Dockerアプリガイドは、CasaOSのコミュニティパッケージにも適用されます。
採用する前に現在のコントローラーバージョンを確認する
Omadaデバイスとコントローラーのリリースには、互換性のあるファームウェアが必要です。新しいゲートウェイ、スイッチ、またはアクセスポイントを採用する前に、そのファームウェア要件をBigBearがパッケージ化しているコントローラーバージョンと比較してください。
管理用VLANからコントローラーホストに到達できるようにする
Omadaデバイスが別のVLANにある場合は、ルーティングとファイアウォールポリシーで、必要な検出および採用トラフィックを許可する必要があります。CasaOSのLAN上でWebダッシュボードが正常に動作していても、管理対象デバイスがコントローラーに到達できるとは限りません。
大きな変更後にコントローラーのバックアップをエクスポートする
デバイスの採用、WLANの変更、VLANの再構築を行った後は、新しいOmadaバックアップをエクスポートしてください。これにより、ソフトウェアのアップグレード前だけでなく、設定変更後にも復旧ポイントを確保できます。
よくある質問
BigBearのOmadaイメージは公式のTP-Linkソフトウェアですか？
TP-Linkのコントローラーをコミュニティ製Dockerイメージにパッケージ化したものです。TP-Link自身は、Linux/Windows上でのネイティブコントローラー対応について説明しています。
現在のBigBearCasaOSにはどのバージョンが含まれていますか？
現在のリポジトリにはOmada Controller 6.2が掲載されています。
更新前にバックアップする必要がありますか？
はい。まずコントローラー設定をエクスポートし、永続化されたデータを保護してください。
UIは動作するのに、デバイスが採用されないのはなぜですか？
必要なOmadaの検出および採用ポート、ネットワークモード、VLANルーティング、デバイスのコントローラー検出経路を確認してください。
