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 앱 스토어에는 앱 스토어 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 컨트롤러 백업을 내보내고 영구 컨테이너 데이터를 보호하세요. 네트워크 컨트롤러의 스키마 변경은 일반적인 웹 앱 업데이트보다 되돌리기 어려울 수 있습니다.
채택 및 검색 포트 확인
웹 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 소프트웨어인가요?
TP-Link의 컨트롤러를 커뮤니티 Docker 이미지로 패키징한 것입니다. TP-Link는 기본 Linux/Windows 컨트롤러 지원을 자체적으로 문서화하고 있습니다.
현재 BigBearCasaOS에는 어떤 버전이 포함되어 있나요?
현재 저장소에는 Omada Controller 6.2가 등록되어 있습니다.
업데이트 전에 백업해야 하나요?
네. 먼저 컨트롤러 구성을 내보내고 영구 데이터를 보호하세요.
UI는 작동하지만 장치가 채택되지 않는 이유는 무엇인가요?
필요한 Omada 검색 및 채택 포트, 네트워크 모드, VLAN 라우팅, 장치의 컨트롤러 검색 경로를 확인하세요.
