유지 관리되는 BigBearCasaOS 스토어를 통해 CasaOS에 TP-Link Omada를 설치할 수 있지만, 이 패키지는 TP-Link 공식 Docker 이미지가 아니라 커뮤니티에서 유지 관리합니다. 2026년 현재 BigBearCasaOS에는 mbentley/omada-controller를 사용하는 TP-Link Omada Controller 6.2가 등록되어 있습니다.
따라서 TP-Link의 컨트롤러 요구 사항과 릴리스 노트를 제품 정보의 기준으로 삼고, BigBear의 매니페스트는 CasaOS 패키징 계층으로만 사용해야 합니다.
최신 BigBearCasaOS 스토어 추가
현재 BigBearCasaOS 앱 스토어에는 앱 스토어 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 컨트롤러 백업을 내보내고 영구 컨테이너 데이터를 보호하세요. 네트워크 컨트롤러의 스키마 변경은 일반 웹 앱 업데이트보다 되돌리기 어려울 수 있습니다.
Adoption 및 검색 포트 확인
웹 UI는 열리지만 Omada 기기가 검색되거나 채택되지 않는다면 컨테이너의 네트워크 모드와 필수 Omada 포트가 중요합니다. 임의로 포트를 열지 말고 BigBear 매니페스트를 최신 TP-Link 컨트롤러 문서와 비교하세요.
관리자 UI를 인터넷에 직접 노출하지 마세요
관리 인터페이스에 인터넷 포트를 직접 포워딩하는 대신 LAN 액세스, VPN 또는 컨트롤러에서 지원하는 클라우드 액세스를 사용하세요.
Docker 앱 가이드는 CasaOS 커뮤니티 패키지에도 적용됩니다.
채택 전에 현재 컨트롤러 버전 확인
Omada 기기와 컨트롤러 릴리스는 호환되는 펌웨어가 필요합니다. 새 게이트웨이, 스위치 또는 액세스 포인트를 채택하기 전에 펌웨어 요구 사항과 BigBear에서 패키징한 컨트롤러 버전을 비교하세요.
관리 VLAN에서 컨트롤러에 연결할 수 있도록 유지
Omada 기기가 다른 VLAN에 있다면, 라우팅과 방화벽 정책에서 필요한 검색/채택 트래픽을 허용해야 합니다. CasaOS LAN에서 웹 대시보드가 작동한다고 해서 관리 대상 기기가 컨트롤러에 연결될 수 있다는 뜻은 아닙니다.
주요 변경 후 컨트롤러 백업 내보내기
기기를 채택하거나 WLAN을 변경하거나 VLAN을 재구성한 후에는 새로운 Omada 백업을 내보내세요. 소프트웨어 업그레이드 전뿐 아니라 구성 변경 후에도 복구 지점을 마련할 수 있습니다.
FAQ
BigBear의 Omada 이미지는 TP-Link 공식 소프트웨어인가요?
커뮤니티 Docker 이미지로 TP-Link 컨트롤러를 패키징합니다. TP-Link는 기본 Linux/Windows 컨트롤러 지원을 문서화하고 있습니다.
현재 BigBearCasaOS에는 어떤 버전이 있나요?
현재 리포지토리에는 Omada Controller 6.2가 등록되어 있습니다.
업데이트 전에 백업해야 하나요?
네. 먼저 컨트롤러 구성을 내보내고 영구 데이터를 보호하세요.
UI는 작동하는데 기기가 채택되지 않는 이유는 무엇인가요?
필수 Omada 검색/채택 포트, 네트워크 모드, VLAN 라우팅, 기기의 컨트롤러 검색 경로를 확인하세요.
