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アドレスを使用する
CasaOSサーバーのIPアドレスをDHCPで予約してください。ルーターの再起動後にコントローラーのアドレスが変わっても、Omadaデバイスや管理者が探し回る必要がないようにします。
コントローラーのバージョンをアップグレードする前にバックアップする
大規模なアップグレードの前に、Omadaコントローラーのバックアップをエクスポートし、永続コンテナデータを保護してください。ネットワークコントローラーのスキーマ変更は、通常のWebアプリの更新より元に戻すのが難しい場合があります。
Adoptionポートと検出ポートを確認する
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の公式ソフトウェアですか？
コミュニティ製DockerイメージにTP-Linkのコントローラーが含まれています。TP-LinkはLinux/Windows向けのネイティブコントローラーのサポートを案内しています。
現在のBigBearCasaOSのバージョンは何ですか？
現在のリポジトリにはOmada Controller 6.2と記載されています。
更新前にバックアップを取るべきですか？
はい。まずコントローラーの設定をエクスポートし、永続データを保護してください。
UIは使えるのに、デバイスを採用できないのはなぜですか？
必要なOmadaの検出・採用ポート、ネットワークモード、VLANルーティング、デバイスからのコントローラー検出経路を確認してください。
