커뮤니티 솔루션

설치 중 ZimaOS Realtek 2.5GbE 네트워크가 작동하지 않음: 드라이버 문제 해결

A November 2025 installation case where an ASUS B850M board's onboard Realtek 2.5GbE worked in Proxmox, Unraid, and Kubuntu but not during ZimaOS's second install stage. A community reply suspected r8169 versus r8125 binding, while the user ultimately bypassed the issue with an Intel X540-T1 NIC.

이 2025년 11월 설치 사례가 중요한 이유는 사용자가 도움을 요청하기 전에 이례적으로 철저한 교차 테스트를 수행했기 때문입니다. ASUS TUF Gaming B850M-PLUS WIFI7의 온보드 Realtek 2.5GbE 컨트롤러는 동일한 시스템, 케이블, 스위치 포트, NVMe에서 Proxmox, Unraid, Kubuntu를 사용할 때 정상적으로 작동했습니다. ZimaOS만 설치 두 번째 단계에서 인터페이스를 활성화하지 못했습니다.

이 증거는 문제 해결의 초점을 라우터나 케이블에서 벗어나 정확한 NIC 리비전, 커널 드라이버 바인딩 또는 설치 프로그램 환경으로 옮깁니다. 그러나 원본 스레드에서는 IceWhale 엔지니어링 팀의 근본 원인까지 확인하지 못했으므로, 드라이버 원인이라는 설명은 커뮤니티의 진단으로 남겨 두어야 합니다.

하드웨어와 문제는 매우 구체적이었습니다

보고된 시스템은 AMD Ryzen 7 8700G, 64GB DDR5, 512GB NVMe 시스템 디스크, 그리고 메인보드의 온보드 Realtek 2.5Gb 이더넷을 사용했습니다. USB로 부팅한 ZimaOS 설치의 첫 번째 단계는 정상적으로 완료되었고 시스템이 NVMe에 복사되었습니다.

문제는 설치 프로그램이 사용자에게 USB 스틱을 제거하고 설치된 NVMe에서 부팅하라고 안내한 후에만 발생했습니다. 이 시점에서 두 번째 단계 환경은 프로비저닝을 완료하기 위해 네트워크가 필요했지만, 이더넷 인터페이스는 링크 연결이나 DHCP 임대를 얻지 못했습니다.

두 번째 단계에서 사용자가 관찰한 내용

  • 라우터에는 ZimaOS 설치에 대한 DHCP 임대가 전혀 표시되지 않았습니다.
  • 시스템에 핑을 보낼 수 없었고 ZimaOS 웹 인터페이스도 나타나지 않았습니다.
  • 서브넷 스캔에서도 새로운 서버 주소가 발견되지 않았습니다.
  • ip a 루프백 인터페이스만 표시되거나, 링크가 연결되지 않고 IPv4 주소도 없는 이더넷 유형의 인터페이스만 표시되었습니다.
  • 새로 만든 설치 USB를 반복해서 사용해도 같은 결과가 나타났습니다.

이러한 증상은 단순히 잘못된 고정 IP가 설정된 정상 작동 인터페이스와는 다릅니다. 설치된 ZimaOS 환경에서는 링크 자체를 사용할 수 없었습니다.

다른 운영 체제가 중요한 이유

동일한 온보드 NIC는 Proxmox, Unraid, Kubuntu에서 즉시 작동했습니다. 라우터는 DHCP 주소를 할당했고, 링크 LED도 정상적으로 작동했으며, 추가 드라이버 설치 없이 시스템에 연결할 수 있었습니다.

그렇다고 ZimaOS에 일반적인 Realtek 버그가 있다는 뜻은 아닙니다. 다만 실제 NIC, 케이블 및 스위치 경로가 작동할 수 있었다는 점은 입증하므로, 이러한 조건을 이미 확인한 뒤 케이블을 반복해서 교체하는 것은 큰 도움이 되지 않습니다.

r8169와 r8125 이론은 커뮤니티에서 나온 것입니다

커뮤니티의 한 응답자는 이 특정 Realtek 2.5GbE 구현에 다음이 필요하다고 추측했습니다 r8169와 r8125 이론은 커뮤니티에서 나온 것입니다 ZimaOS가 다음 드라이버에 바인딩하는 동안 r8169또는 두 번째 단계 부팅 중 예상 드라이버에 바인딩되지 못하는 경우입니다.

일부 Realtek 리비전에서는 그럴 가능성이 있지만, 공개 스레드에서 IceWhale 직원이 장치 ID, 로드된 모듈 또는 커널 회귀를 확인한 사람은 없습니다. 실제 진단 출력 없이 이 이론을 “ZimaOS가 잘못된 드라이버를 사용한다”라고 단정하는 식으로 바꾸지 마세요.

커뮤니티가 요청한 읽기 전용 검사 3가지

응답자는 다음을 요청했습니다.

lspci -nn | grep -i ethernet
ip a
dmesg | grep -i -e r8169 -e r8125 -e realtek

이 명령은 설치 내용을 수정하지 않기 때문에 유용합니다. 이 명령을 함께 사용하면 PCI 장치 ID, Linux가 생성한 네트워크 인터페이스, 관련 Realtek 드라이버가 보고한 프로브 또는 링크 오류를 확인할 수 있습니다.

현재 시스템에서는 인터페이스를 현재 ZimaOS 네트워크 패널에 표시되어야 하는 이더넷 상태와도 비교하세요. 커널이 사용 가능한 인터페이스를 전혀 생성하지 않는다면 문제는 웹 UI 구성보다 앞선 단계에 있습니다.

제품군 수준의 호환성 목록은 모든 리비전을 보장하지 않습니다

원 게시자는 Realtek 2.5GbE 제품군이 IceWhale의 호환성 정보에 표시되어 있었고, 이것이 메인보드 구매에 영향을 미쳤기 때문에 충분히 답답했을 것입니다. 유사한 마케팅 이름으로 판매되는 네트워크 컨트롤러라도 PCI ID, 실리콘 리비전, 펌웨어, PHY 구성 요소 또는 보드 배선은 서로 다를 수 있습니다.

따라서 고품질 호환성 보고서에는 정확한 lspci -nn 식별자이며, 단순히 “Realtek 2.5GbE”가 아닙니다.

확인된 유일한 결과는 Intel X540-T1을 사용한 우회 방법이었습니다

6일 후, 원래 사용자는 Intel X540-T1 NIC를 구매했으며 이 카드로 문제를 우회할 수 있었다고 보고했습니다. 이는 문제를 겪은 당사자가 확인한 유일한 결과입니다.

이 우회 방법은 다른 호환 가능한 NIC가 네트워크를 제공하면 ZimaOS가 설치를 계속 진행할 수 있었다는 것을 입증합니다. 하지만 온보드 Realtek 장치가 실패한 정확한 이유를 밝히지는 않습니다.

이 스레드에서 확인할 수 없는 사항

  • RTL8125 계열의 모든 NIC가 ZimaOS에서 작동하지 않는다는 것을 입증하지 않습니다.
  • DHCP가 근본 원인이었다는 것을 입증하지 않습니다.
  • 특정 커널 모듈이 누락되었다는 내용은 확인하지 않습니다.
  • 사용자의 평생 라이선스가 하드웨어 지원에 영향을 주었다는 내용은 없습니다.
  • 최종적인 공식 IceWhale 드라이버 수정 사항은 포함되어 있지 않습니다.

오늘날의 더 나은 문제 해결 경로

  1. 정확한 NIC PCI ID를 기록하세요.
  2. 링크 LED와 라우터 포트의 동작을 확인하세요.
  3. Linux가 이더넷 인터페이스를 생성하는지 확인하세요.
  4. 해당 컨트롤러의 정확한 드라이버 메시지를 확인하세요.
  5. 필요하다면 다른 최신 Linux 이미지와 동작을 비교하세요.
  6. 호환성이 확인된 두 번째 NIC를 사용하면 ZimaOS 설치를 완료할 수 있는 경우, 반복해서 재설치하지 말고 실패한 컨트롤러의 진단 정보를 보존하여 호환성 보고서에 포함하세요.

Realtek 2.5GbE 설치 FAQ

온보드 NIC가 물리적으로 고장 난 상태였나요?

교차 테스트 결과는 그 가능성을 낮춥니다. 다른 여러 운영 체제에서는 즉시 작동했습니다.

r8169가 확실히 잘못된 드라이버였나요?

아니요. 이는 공개 스레드에서 요청된 출력 결과로 확인되지 않은 커뮤니티의 추측이었습니다.

확인된 우회 방법은 무엇이었나요?

원래 사용자는 Intel X540-T1 네트워크 카드를 설치한 뒤 설치 문제를 우회할 수 있었습니다.

로그를 수집하기 전에 NIC를 교체해야 하나요?

가능하다면 먼저 PCI ID, 인터페이스 상태, 관련 드라이버 메시지를 수집하세요. 이러한 정보가 있어야 현재 ZimaOS 빌드에도 동일한 호환성 문제가 여전히 존재하는지 훨씬 정확하게 판단할 수 있습니다.