리눅스 네트워크 에러:`gateway4` has been deprecated, use default routes instead

 

 

gateway4 has been deprecated, use default routes instead

Ubuntu에서 netplan apply 실행 시 아래와 같은 경고를 본 적이 있다면,

`gateway4` has been deprecated, usedefault routes instead

이는 설정 오류가 아니라 Netplan 설계 변경에 따른 deprecated 경고다.

이번 글에서는 왜 이런 경고가 발생하는지와 공식 권장 방식으로 수정하는 방법을 정리한다.

---

문제 원인

기존 Netplan에서는 IPv4 기본 게이트웨이를 아래처럼 설정했다.

gateway4:192.168.1.1

하지만 Netplan 최신 버전에서는

게이트웨이를 단일 필드로 정의하는 방식이 제거(deprecated) 되었고,

라우팅 정책과 통합된 routes 기반 설정을 사용하도록 변경되었다.

즉, gateway는 “특별한 설정”이 아니라

default route의 한 종류로 취급된다.

---

기존 설정 (경고 발생)

network:
version:2
ethernets:
eth0:
dhcp4:no
addresses:
-192.168.1.10/24
gateway4:192.168.1.1
nameservers:
addresses:
-8.8.8.8
-8.8.4.4

이 설정은 여전히 동작하지만,

Netplan 실행 시 deprecation 경고가 출력된다.

---

권장 해결 방법 (Default Route 사용)

핵심 변경점

• ❌ gateway4 제거
• ✅ routes에서 default route 정의

---

수정된 설정 (권장)

network:
version:2
ethernets:
eth0:
dhcp4:no
addresses:
-192.168.1.10/24
routes:
-to:default
via:192.168.1.1
nameservers:
addresses:
-8.8.8.8
-8.8.4.4

아래 방식도 동일하게 동작한다.

routes:
-to:0.0.0.0/0
via:192.168.1.1

---

설정 적용

sudo netplan apply

경고 메시지가 더 이상 출력되지 않는다.

---

정상 적용 확인

ip route

정상이라면 다음과 같이 표시된다.

default via192.168.1.1 dev eth0

---

왜 이렇게 바뀌었나?

Netplan은 단순 네트워크 설정 도구가 아니라

정책 기반 라우팅(PBR), 멀티 게이트웨이, metric, table 관리까지 고려한 구조로 발전 중이다.

routes 기반 설정의 장점:

• 여러 default gateway + metric 설정 가능
• source-based routing과 자연스럽게 통합
• IPv4 / IPv6 설정 구조 일관성 유지
• systemd-networkd / NetworkManager 백엔드 공통 처리

---

정리

• gateway4는 deprecated (지금은 동작하지만 언젠가 제거될 수 있음)
• 기본 게이트웨이는 default route로 정의해야 함
• 기능 차이는 없고, 미래 호환성과 확장성을 위한 변경

Netplan 경고가 보인다면

지금 수정하는 것이 가장 깔끔한 선택이다.

 

 

 

Reference

https://askubuntu.com/questions/1410750/netplan-gateway-has-been-deprecated

Netplan - gateway has been deprecated