결론: 새로운 UniFi 배포라면 2024년 BigBear 컨테이너 템플릿보다 Ubiquiti의 현재 자체 호스팅 모델을 따르세요
2024년 CasaOS 게시물은 UniFi Network Application용 BigBearCasaOS 패키지를 안내했습니다. 하지만 Ubiquiti의 현재 자체 호스팅 방식은 달라졌습니다. 이제 지원되는 Linux/Windows/macOS 자체 호스팅 환경에서는 UniFi OS Server를 권장하며, 검색, 채택 및 업데이트가 호스트 서비스에 의존하므로 완전한 UniFi OS Server는 독립 실행형 Docker/Podman 컨테이너로 제공되지 않는다고 명시합니다. 따라서 오래된 커뮤니티 컨테이너는 레거시 방식일 뿐, 2026년의 기본 권장 방법은 아닙니다.
먼저 적합한 UniFi 제품을 선택하세요
UDM 또는 UCG와 같은 UniFi Cloud Gateway를 이미 보유하고 있다면 UniFi Network 제어 플레인이 이미 포함되어 있으므로 외부 자체 호스팅 컨트롤러에 채택해서는 안 됩니다. 독립형 게이트웨이, 스위치 및 액세스 포인트를 사용하는 경우에는 자체 호스팅 UniFi 서버가 적합할 수 있습니다.
Ubiquiti의 UniFi 자체 호스팅 문서에서 이 범위를 설명합니다.
ZimaOS 호스트에는 전용 Linux VM을 우선 사용하세요
현재 UniFi OS Server는 단일 Docker 컨테이너가 아니라 호스트 수준의 서비스를 필요로 하므로, 전체 서버를 NAS 호스트에 억지로 넣기보다는 ZimaOS에서 소형 Debian/Ubuntu VM을 사용하는 편이 더 깔끔합니다. 이렇게 하면 업데이트, Java/Mongo/서비스 종속성 및 네트워크 검색을 ZimaOS 어플라이언스와 분리할 수 있습니다.
ZimaOS VM 요구 사항에서 ZimaOS 측 리소스 모델을 확인할 수 있습니다.
필요한 네트워크 포트를 신중하게 여세요
UniFi 장치 검색 및 채택에는 웹 UI 외에도 여러 요소가 필요합니다. Ubiquiti는 기존 Network Application 작업 흐름에 UDP 3478, UDP 10001 및 TCP 8080을 비롯한 포트를 안내하며, 원격 액세스 및 기능에 따라 추가 포트가 필요할 수 있습니다. UniFi 필수 포트 문서에서 현재 포트 정보를 확인할 수 있습니다.
채택 시점에 컨트롤러와 장치에 모두 연결할 수 있도록 하세요
액세스 포인트나 스위치가 다른 VLAN/서브넷에 있으면 Layer-2 검색이 작동하지 않을 수 있습니다. 의도적으로 원격 채택 방식을 사용하고 라우팅/방화벽 정책에서 필요한 제어 트래픽을 허용하는지 확인하세요. 검색 문제를 해결하기 위해 모든 UniFi 포트를 공용 인터넷에 개방해서는 안 됩니다.
업데이트 전에 UniFi 사이트를 백업하세요
Ubiquiti는 자체 호스팅 Network 서버를 업데이트하기 전에 백업을 다운로드할 것을 권장합니다. VM/시스템 디스크 외부에 사본을 보관하세요. ZimaOS 백업은 NAS 수준의 복구 계층을 제공합니다.
기존 Docker 패키지가 여전히 작동할 수 있는 이유
기존 UniFi Network Application용 커뮤니티 컨테이너 이미지는 일부 사용자 환경에서 여전히 실행될 수 있습니다. 그렇다고 해서 현재 UniFi OS Server 지원과 동등한 것은 아닙니다. 의도적으로 계속 사용한다면 버전을 고정하고 데이터베이스/구성 데이터를 영구 저장하며 이미지 유지 관리자가 제공하는 업데이트 지침을 따르세요.
HTTPS 없이 관리자 인터페이스를 직접 노출하지 마세요
네트워크 컨트롤러 자격 증명으로 Wi-Fi, 게이트웨이 및 VLAN을 변경할 수 있습니다. 가능한 경우 관리자 엔드포인트를 LAN/VPN 전용으로 유지하세요. 공개해야 한다면 강력한 인증, TLS 및 제한된 소스 액세스를 사용하세요. ZimaOS HTTPS 프록시에서 공개 웹 경계를 관리할 수 있습니다.
대신 UniFi Console을 사용해야 하는 경우
네트워크 관리가 업무상 중요하고 Ubiquiti의 통합 업데이트/지원 경로를 원한다면, 자체 호스팅보다 UniFi Cloud Gateway 또는 Console을 운영하는 편이 간단합니다. 컨트롤러 인프라를 직접 운영하려는 경우에 ZimaOS 호스팅 UniFi를 선택하세요.
기존 UniFi 사이트를 이전하기 전에 채택 계획을 세우세요
장치가 이미 다른 컨트롤러에 채택된 상태라면 두 번째 서버를 단순히 시작한다고 해서 자동으로 인계될 것이라고 기대하지 마세요. 사이트/시스템 백업을 내보내고 현재 inform/control 주소를 기록한 다음 Ubiquiti의 지원되는 마이그레이션/채택 절차를 사용하세요. 컨트롤러를 이전할 때는 모든 액세스 포인트를 공장 초기화하는 대신 장치 소유권, WLAN/VLAN 설정 및 인증서를 유지해야 합니다.
FAQ
BigBearCasaOS로 UniFi를 계속 설치할 수 있나요?
레거시 커뮤니티 패키지가 존재할 수 있지만, 새로운 배포에서는 현재 Ubiquiti 자체 호스팅 지침을 기준으로 삼아야 합니다.
UniFi OS Server를 Docker에서 실행할 수 있나요?
Ubiquiti는 현재 완전한 UniFi OS Server를 독립 실행형 Docker/Podman 컨테이너로 제공하지 않는다고 안내합니다.
UniFi를 ZimaOS VM에서 실행해야 하나요?
전용 Linux VM은 현재 자체 호스팅 UniFi 서비스에 깔끔한 호스트 경계를 제공합니다.
어떤 포트를 열어야 하나요?
Ubiquiti의 최신 필수 포트 문서를 사용하고 검색, 채택 및 관리에 필요한 포트만 노출하세요.
UDM 또는 UCG를 사용한다면 자체 호스팅 컨트롤러가 필요한가요?
아니요. 현재 UniFi Cloud Gateway에는 이미 UniFi Network 제어 플레인이 포함되어 있습니다.
