ActionMask 블로그 - Ubuntu 24.04 LTS에 r8125 랜카드 드라이버 설치

많은 최신 가정용 메인보드들의 랜카드는 2.5G급 이상의 속도를 지원하고 있습니다. 대표적으로 리얼텍의 r8125 칩셋이 탑재된 랜카드가 많이 사용되고 있는데, Ubuntu 24.04 LTS와 같은 최신 리눅스 배포판에서는 기본적으로 r8125 드라이버가 포함되어 있지 않아 별도로 드라이버를 설치해주어야 합니다.

기본적으로 많이 사용되는 리얼텍社의 1G 랜카드 드라이버인 r8169 드라이버는 Ubuntu 24.04 LTS에 기본적으로 포함되어 있지만, 2.5G 이상의 속도를 지원하는 r8125 드라이버는 별도로 설치해야 합니다.

1. Secure Boot 비활성화

r8125 드라이버는 커널 모듈로 설치되기 때문에, Secure Boot가 활성화된 상태에서는 서명되지 않은 커널 모듈이 로드되지 않아 드라이버 설치가 불가능합니다. 따라서, 먼저 BIOS 설정에서 Secure Boot를 비활성화해야 합니다.

컴퓨터를 재부팅하고 BIOS 설정 화면으로 진입합니다. (일반적으로 부팅 시 F2, Del, Esc 등의 키를 누릅니다.) BIOS 설정 메뉴에서 "Secure Boot" 옵션을 찾아 비활성화(Disable)한 후, 설정을 저장하고 BIOS에서 나와 컴퓨터를 재부팅합니다.

메인보드 제조사마다 BIOS 설정 화면이 다를 수 있으므로, 자세한 내용은 메인보드 매뉴얼을 참고하시기 바랍니다.

아래는 주요 메인보드 제조사의 Secure Boot 설정 방법에 대한 설명 링크입니다:

2. USB 랜카드 준비

이 부분이 아이러니하면서도 필수적으로 선행되어야 하는 부분입니다. 기본적으로 Ubuntu 24.04 LTS에서는 r8125 랜카드를 인식하지 못하기 때문에 네트워크를 사용할 수 없습니다. 하지만, 각종 필수 패키지 및 드라이버를 설치하기 위해서는 인터넷 연결이 필수적입니다. 물론, 수동으로 각종 의존성 패키지들을 직접 찾아 다운로드 받아 설치할 수는 있지만 효율성 측면에서 USB 랜카드를 이용하여 인터넷 접속을 확보하는 것을 추천합니다.

대부분 시중에서 구할 수 있는 1G 혹은 100M급 USB 랜카드는 별도의 설정 없이 Ubuntu에서 인식이 가능합니다. 만일 USB 랜카드가 없는 경우, 스마트폰의 USB 테더링 기능을 이용하여 임시로 인터넷에 연결할 수도 있습니다.

USB 랜카드를 컴퓨터에 연결하고, Ubuntu에서 정상적으로 인식되는지 확인합니다.

3. 커널 업그레이드 및 필수 패키지 설치

Ubuntu 설치 후 먼저 apt를 이용해 최신 커널로 업그레이드를 진행합니다.

sudo apt update && sudo apt upgrade -y

그 다음, r8125 드라이버 빌드에 필요한 필수 패키지들을 설치합니다.

sudo apt install build-essential dkms

4. 레거시 드라이버 차단

기존의 r8169 드라이버 관련 설정을 모두 막아줘야 합니다.

/etc/modprobe.d/blacklist-r8169.conf 경로와 같이 파일을 만들고

해당 파일에 다음과 같이 작성합니다.

blacklist r8169

저장 후 아래 명령어로 내용을 반영해줍니다.

sudo update-initramfs -u

재부팅을 수행합니다.

sudo reboot now

5. r8125 드라이버 다운로드 및 설치

리얼텍 공식 홈페이지에서 최신 r8125 드라이버를 다운받을 수 있지만, 보다 편리하게 최신 드라이버 패키지를 빌드하여 배포하는 프로젝트가 있습니다.

https://github.com/awesometic/realtek-r8125-dkms에서 최신 빌드된 드라이버를 다운받을 수 있습니다.

직접 수동으로 설치하는 것보다 아래와 같이 apt 저장소에 해당 패키지를 등록하여 설치하는 방법을 추천드립니다.

sudo add-apt-repository ppa:awesometic/ppa
 
sudo apt install realtek-r8125-dkms

이렇게 설치를 완료하면 자동으로 커널 모듈이 빌드되고 설치됩니다.

드라이버 설치 후 재부팅을 수행합니다.

sudo reboot now

재부팅 후 네트워크 설정에서 r8125 랜카드가 정상적으로 인식되는지 확인합니다.
필요한 경우 /etc/netplan/ 디렉토리에서 네트워크 설정 파일을 수정하여 네트워크를 구성할 수 있습니다.

고정 IP의 경우 아래와 같이 /etc/netplan/50-cloud-init.yaml 파일을 생성 및 수정합니다.

network:
  version: 2
  ethernets:
    enp131s0:
      optional: true
      dhcp4: false
      addresses:
        - 192.168.0.100/24
      routes:
        - to: default
          via: 192.168.0.1
      nameservers:
        addresses:
          - 1.1.1.1
          - 8.8.8.8

이후 아래 명령어로 네트워크 설정을 적용합니다.

sudo netplan apply

6. 추가 설정

리얼텍의 경우 Energy Efficient 관련 설정으로 인해 안정적인 네트워크 이용에 방해가 될 수 있습니다. 이를 방지하기 위해 ethtool을 이용해 EEE 기능을 비활성화하는 방법이 있습니다.

먼저 서비스 파일을 생성합니다.

sudo vi /etc/systemd/system/disable-eee.service

해당 파일에 아래와 같이 작성합니다.

[Unit]
Description=Disable EEE on Realtek r8125 NIC
After=network-online.target
 
[Service]
Type=oneshot
ExecStart=/usr/sbin/ethtool --set-eee enp131s0 eee off
 
[Install]
WantedBy=multi-user.target

서비스를 등록하고 활성화합니다.

sudo systemctl enable disable-eee.service
 
sudo service disable-eee start

재부팅을 수행합니다.

sudo reboot now

이제, 안정적으로 네트워크 이용 가능합니다. 커널 업그레이드 시에도 DKMS가 자동으로 드라이버를 재빌드해주기 때문에 별도의 추가 작업 없이도 최신 커널에서 r8125 드라이버를 사용할 수 있습니다.

맺음말

차기 버전의 Ubuntu에서는 기본적으로 r8125 드라이버가 포함되기를 기대해봅니다. 일반 가정용 메인보드를 이용하여 리눅스를 설치하시는 분들에게 도움이 되었기를 바랍니다.
드라이버 설치 과정에서 어려움이 있는 경우, 댓글로 남겨주시면 최대한 아는 한도 내에서 도움을 드리겠습니다.

감사합니다.