QA 중니어 Log
[Ubuntu] 우분투 24.04 Realtek LAN 드라이버 변경 방법 (r8125) 본문
사내에 Kubernetes 환경을 구축할 일이 있어 새로운 PC 3대를 받아 네트워크 구성부터 하려는데,
LAN을 꼽아도 네트워크 인터페이스가 안생겼다.. 랜카드를 인식하지 못하는 문제가 있었다.

검색해보니 우분투 설치할 때 많이들 겪는 문제인 것 같은데, 누군가에게 도움이 될까 싶어 내용을 정리해둔다.
1. 기존 드라이버 버전과 내가 설치해야할 버전 확인하기
- Ubuntu 24.04 LTS에서 기본 설치되는 Realtek LAN Controller 드라이버 버전은 r8169
- 내가 설치해야하는 버전은 아래 명령어를 통해 product 정보를 확인하면 된다.
sudo lshw -C network
- 아래와 같은 결과를 얻을 수 있었다.
product : RTL8125 2.5GbE Controller
2. r8125에 맞는 드라이버를 다운로드한다.
- 인터넷이 안됐기에... 회사에서 USB 예외 정책 기안을 올린 뒤에 USB에 아래 파일들을 다운로드 받았다.
- dh-dkms_3.0.11-1ubuntu13_all.deb
> DKMS 프레임워크 동작에 필요한 빌드 도구 패키지
- realtek-r8125-dkms_9.016.0101_amd64.deb
> Realtek에서 직접 배포하는 r8125 소스 기반 드라이버
다음으로 설치... 하려는데 의존성 패키지 오류가 많이 나왔다 ;;;
랜카드 인식이 안되는 것이지, USB로 LAN 연결하면 되니까 이후에는 그래도 설치가 편했다.
3. 네트워크 설정해주기 (apt update 등 작업할 때 사용함)
1) /etc/netplan 아래 yaml 파일 생성해주기
- 나는 아무런 파일이 없어서 01-netcfg.yaml이라는 파일을 생성했다. (IP는 예제)
network:
version: 2
ethernets:
enp7s0:
dhcp4: no
addresses:
- 192.168.1.150/24
routes:
- to: default
via: 192.168.1.1
nameservers:
addresses:
- 8.8.8.8
- 1.1.1.1
2) 파일 권한
- Netplan은 설정 파일 권한을 제한하지 않으면 적용이 안되더라고요..
sudo chmod 600 /etc/netplan/01-netcfg.yaml
sudo chown root:root /etc/netplan/01-netcfg.yaml
3) 적용
sudo netplan apply
4) 확인
- 아래 명령어들로 제대로 설정됐는지 확인할 수 있다!
ip addr
ip route show
ping gateway_ip
4. DKMS 설치
1) Ubuntu 저장소에서 제공하는 r8125 설치 (비추)
- 이제 네트워크 연결되니까 쉽게 할 수 있지 않을까 싶어서 우분투 저장소에서 제공하는 r8125 모듈을 설치했다.
- 아.. 근데 Ubuntu 24.04 기본 커널에서는 최신 칩셋이나 펌웨어랑 완전히 맞지 않아서 링크 flap, TX drop 같은 문제가 나타났다. 나 같은 경우에는 네트워크 설정이 제대로 안돼서 이것저것 확인하다보니 패킷이 전부 drop되고 있었다. ㅠㅠ
- 우분투 공식에서 제공하는 r8125-dkms만으로는 최신 환경에서 불안정할 수 있으니 Realtek에서 제공하는 패키지를 설치하는 것이 좋다!
sudo apt install r8125-dkms -y
2) Realtek 제공 r8125-dkms 설치 (추천)
- 보통은 Realtek 드라이버만 설치하면 충분하다는데,,,
나는 dkms 패키지를 다운받아라 어쩌구 하는 내용이 떠서 dh-dkms 패키지까지 설치했다.
- dh-dkms > realtek-r8125 순서로 설치해야 한다.
# 1. 의존성 최신화
sudo apt update
# 2. DKMS 패키지 설치
sudo apt install ./dh-dkms_3.0.11-1ubuntu13_all.deb
# 3. Realtek 드라이버 설치
sudo apt install ./realtek-r8125-dkms_9.016.0101_amd64.deb
- 드라이버 모듈이 정상 등록되었는지 확인
lsmod | grep r8125
- 여기서 결과가 안나오면 모듈을 수동 로드해주고 다시 확인해보면 된다.
sudo modprobe r8125
5. LAN 연결해서 확인해보기
- 이제 준비는 다 됐으니, PC에 LAN을 직접 연결해서 확인해보면 된다!
- LAN을 연결한 뒤, 네트워크 인터페이스를 확인하자
ip link show
> 처음에는 lo 만 보였는데, 이제 enp~~, eth~~ 이런 장치가 보이면 성공이다 ㅎㅎ
- /etc/netplan 아래 yaml 파일의 인터페이스를 수정해준 뒤, 다시 적용하면 인터넷이 된다!
# 네트워크 인터페이스 수정
vi /etc/netplan/01-netcfg.yaml
# 변경 내용 적용
sudo netplan apply
파이팅!

'QA' 카테고리의 다른 글
| [QA] 웹 서비스 자동화 Pipeline 구축 4 - 테스트 결과 보고서 (5) | 2025.07.30 |
|---|---|
| [QA] 웹 서비스 자동화 Pipeline 구축 3 - Playwright 설치 및 Jenkins에서 실행하기 (4) | 2025.07.29 |
| [Playwright] JavaScript, TypeScript 환경에서 Playwright 설치하기 (3) | 2025.07.25 |
| [QA] 웹 서비스 자동화 Pipeline 구축 2 - 대상 서버에 패키지 다운로드 및 설치 (2) | 2025.07.24 |
| [QA] 웹 서비스 자동화 Pipeline 구축 1 - Jenkins 설치 (4) | 2025.07.23 |