ZimaOS 설치 프로그램이 “네트워크 주소 검색 중” 화면에 계속 머물며 IP 주소를 전혀 받지 못한다면, 먼저 이더넷 컨트롤러가 감지되고 링크가 연결되었는지 확인하세요. 2025년 12월의 이 사례에서는 Gigabyte X870I Aorus Pro Ice 시스템이 Realtek RTL8125D 2.5GbE 컨트롤러를 사용했으며, 설치 프로그램은 사용 가능한 네트워크 주소를 끝내 받지 못했습니다.
한 커뮤니티 답변자는 해당 문제의 원인을 당시 제공되던 설치 프로그램 빌드의 드라이버 지원 문제로 보았고, 임시로 USB 이더넷을 사용할 것을 제안했습니다. 해당 글에는 IceWhale 엔지니어의 확인이나 최신 ZimaOS에서의 후속 테스트가 없었으므로, RTL8125D가 지원되지 않는다는 영구적인 결론으로 받아들여서는 안 됩니다.
설치 프로그램에 표시할 주소가 없었던 경우
사용자는 주소를 검색하는 설치 단계까지 진행했지만 IP를 받지 못했습니다. 이는 호스트가 유효한 DHCP 임대를 이미 받은 뒤 브라우저에서 ZimaOS가 열리지 않는 상황과는 다릅니다.
먼저 물리적 링크를 확인하세요. 케이블, 스위치 또는 라우터 포트, 링크 LED를 점검합니다. 그런 다음 라우터의 DHCP 클라이언트 목록을 확인하세요. 장치가 목록에 전혀 나타나지 않는다면 문제는 브라우저보다 낮은 계층에 있으며, NIC 감지, 드라이버 연결, DHCP 또는 물리적 네트워크 경로와 관련되었을 수 있습니다.
RTL8125D에 대한 설명은 커뮤니티의 진단이었습니다
질문 작성자는 온보드 컨트롤러를 Realtek RTL8125D라고 밝혔습니다. 한 커뮤니티 답변은 2025년 말에 사용되던 ZimaOS 설치 프로그램 커널에 해당 컨트롤러를 위한 정상 작동 지원이 포함되지 않았으며, 실행 중인 설치 프로그램에 드라이버를 단순히 주입할 수 없다고 설명했습니다.
이 설명은 증상과 부합했지만, 해당 글에는 커널 로그, lspci -k 결과 또는 공식 호환성 발표가 제시되지 않았습니다. 또한 이후 ZimaOS 릴리스보다 이전의 내용입니다. 따라서 이를 현재 이미지에 대한 증명이 아니라 과거의 진단 사례로 활용하세요.
현재 ZimaOS 문서는 x86-64 하드웨어를 광범위하게 설명하지만, NIC 호환성 전체 목록은 제공하지 않습니다. 오늘 같은 컨트롤러를 사용하고 있다면 과거의 제한이 여전히 적용된다고 가정하기 전에 최신 설치 프로그램으로 테스트하세요.
임시 USB 이더넷 어댑터로 문제를 분리할 수 있습니다
해당 글에서 제안된 실용적인 해결 방법은 지원되는 USB 이더넷 어댑터를 통해 설치하는 것이었습니다. 답변에서는 RTL8153 및 AX88179와 같은 일반적인 USB NIC 제품군을 언급했습니다. 원 질문자는 어댑터를 주문했지만, 최종 설치 결과를 알리는 후속 글은 남기지 않았습니다.
임시 어댑터는 네트워크 컨트롤러 호환성 문제와 설치 과정의 다른 문제를 분리하는 데 유용합니다. USB 이더넷을 통해 ZimaOS가 주소를 받고 설정을 완료한다면 온보드 NIC 경로가 주요 용의자가 됩니다. USB 어댑터에서도 DHCP 임대를 받지 못한다면 온보드 컨트롤러를 탓하기 전에 스위치, 라우터, 케이블, VLAN 및 DHCP 서비스를 확인하세요.
오래된 드라이버 결론을 적용하기 전에 최신 설치 프로그램으로 다시 테스트하세요
ZimaOS는 네트워크 드라이버를 계속 추가하고 수정해 왔습니다. 예를 들어 ZimaOS 1.7.1에는 일부 Emulex NIC를 위한 be2net 지원이 명시적으로 추가되었고 Docker 네트워킹이 개선되었습니다. 이는 릴리스에 따라 네트워크 지원이 변경된다는 점을 보여줍니다. 다만 1.7.1 변경 기록에는 RTL8125D 수정 사항이 구체적으로 언급되어 있지 않습니다.
최신 ZimaOS 1.7.1 릴리스 노트는 2025년 12월 포럼의 추측에 의존하는 것보다 더 적절한 버전 기준입니다.
최신 설치 프로그램에서도 실패할 경우 수집할 정보
현재 빌드에서도 같은 문제가 발생한다면 메인보드 모델과 리비전, 정확한 NIC 컨트롤러, ZimaOS 이미지 버전, 링크 LED 점등 여부, 라우터가 임대를 제공하는지 여부, 정상 작동이 확인된 USB 이더넷 어댑터가 작동하는지를 기록하세요.
셸에 접근할 수 있다면 드라이버를 수정하지 않은 상태에서 lspci -nnk, ip link 및 관련 커널 메시지를 수집하세요. 이 출력은 “장치가 감지되지 않음”, “드라이버가 연결되지 않음”, “링크가 다운됨”, “DHCP 실패”를 구분하는 데 도움이 됩니다. 설치 프로그램에는 모두 같은 대기 화면으로 표시될 수 있지만, 실제로는 서로 완전히 다른 문제입니다.
