왜 OpenWrt에서 Clash를 사이드 게이트웨이로 쓰는가

집안 스마트폰·노트북에는 각각 Clash 클라이언트를 설치할 수 있지만, TV·콘솔·일부 IoT는 시스템 프록시가 없거나 제한적입니다. 이때 기본 게이트웨이만 OpenWrt 쪽 고정 IP로 바꾸면 해당 기기의 IP 트래픽이 전부 Mihomo를 거치게 되어, 한 프로필로 규칙과 DNS를 통일할 수 있습니다. 메인 인터넷 공유기는 그대로 두고 옆에 사이드 라우터(旁路由) 역할만 하는 패턴이 흔합니다.

같은 목적을 NAS에서 Docker Clash로 구현하는 방법도 있고, 베어메탈 리눅스에서는 Ubuntu·systemd·TUN 글과 흐름이 비슷합니다. 다만 OpenWrt는 dnsmasq·firewall4(nftables)·플래시 용량·메모리 제약이 겹치므로, “어디까지를 라우터 OS에 맡기고 어디부터를 Mihomo에 맡길지”를 먼저 정하는 것이 안전합니다.

토폴로지와 IP 설계

전형적인 구성은 메인 공유기가 192.168.1.1이고 DHCP로 단말에 주소를 나눠 주는 경우입니다. OpenWrt 장치에는 브리지된 LAN 포트 하나에 고정 주소(예: 192.168.1.2)를 부여하고, TV·게임기 등은 “IP와 서브넷 마스크는 DHCP 그대로, 게이트웨이와 DNS만 192.168.1.2”로 수동 지정합니다. 이렇게 하면 L2 브로드캐스트 도메인은 하나로 유지되어 설정이 단순해집니다.

이중 NAT로 WAN을 메인 LAN에 붙이는 방식도 가능하지만, 초기에는 동일 세그먼트 + 게이트웨이 분리가 트래블슈팅 비용이 적습니다. OpenWrt의 WAN 포트를 실제 회선에 쓰지 않고 LAN 스위치에만 붙인 “순수 사이드” 형태라면, 기본 라우팅 테이블에서 “인터넷으로 나가는 다음 홉”이 메인 공유기인지 Mihomo 호스트인지 헷갈리기 쉬우므로, uci show network 출력과 함께 한 장짜리 다이어그램을 남겨 두는 것이 좋습니다.

설치 경로: 패키지 vs 수동 바이너리

OpenWrt 23.xx 이후 환경에서는 커뮤니티 패키지 피드에 따라 mihomo 또는 유사 이름의 패키지가 제공되기도 합니다. 피드가 없다면 공식 아키텍처에 맞는 Mihomo 정적 바이너리를 내려받아 /usr/bin/ 등에 두고, init.d 또는 procd 유닛으로 기동하는 방식이 일반적입니다. 플래시가 빠듯하면 실행 파일과 구독 캐시를 외장 USB 오버레이로 옮기는 것을 검토하세요.

어떤 경로든 config.yaml은 버전 관리 가능한 위치에 두고, 업데이트 시 롤백할 수 있게 백업 스크립트를 만드는 편이 좋습니다. 구독 URL이 장치에서 직접 나가야 하므로, 메인 공유기가 클라이언트 필터링을 하면 갱신이 실패합니다. 바이너리 출처·서명 확인은 GitHub 릴리스 페이지에서 하되, 가정용 단말에 설치할 그래픽 클라이언트는 공식 다운로드 페이지를 우선 안내하는 것이 독자에게 혼선이 적습니다.

TUN 모드 켜기 전에 확인할 것

TUN은 커널 가상 인터페이스를 통해 시스템 프록시를 무시하는 앱까지 규칙에 태울 수 있게 해 줍니다. 개념과 증상별 점검은 TUN 모드 완전 가이드와 같이 읽으면 Windows·리눅스와 차이를 빠르게 정렬할 수 있습니다. OpenWrt에서는 kmod-tun 모듈이 로드돼 있는지, Mihomo 프로세스가 CAP_NET_ADMIN 권한으로 뜨는지, 그리고 기존 fw4 규칙과 충돌하지 않는지를 순서대로 확인합니다.

tun 스택은 system과 gvisor 중 환경에 맞는 쪽을 고릅니다. 라우터 CPU가 약하면 gVisor 쪽이 CPU를 더 먹을 수 있어, 처리량이 나오지 않으면 스택을 바꿔 실측합니다. TUN을 켠 직후 SSH 세션이 끊기거나 루프백만 살아 있는 경우는 라우팅 테이블이 덮였거나 DNS가 localhost에만 묶인 경우가 많으니, 콘솔 포트·fail-safe 모드까지 염두에 둡니다.

DNS: dnsmasq 포워드와 fake-ip 정렬

사이드 게이트웨이에서 가장 흔한 불일치는 “브라우저는 되는데 특정 앱만 실패” 형태인데, 대부분 DNS가 Mihomo 밖에서 먼저 해석되거나, fake-ip 모드와 클라이언트 캐시가 어긋난 경우입니다. OpenWrt 기본 dnsmasq가 53번을 잡고 있다면, LAN 클라이언트의 DNS를 OpenWrt의 LAN 주소로 두고 dnsmasq에서 상위 DNS로 Mihomo의 DNS 리스너(예: 127.0.0.1:1053)를 지정하는 식으로 경로를 단일화할 수 있습니다.

또는 53번을 Mihomo가 직접 받게 하고 dnsmasq를 다른 포트로 옮기는 방법도 있으나, LuCI에서 예기치 않은 재시작이 일어나기 쉬워 문서화가 필요합니다. redir-host와 fake-ip 중 무엇을 쓸지는 규칙 세트와 호환성에 따라 갈리므로, 프로필을 바꾼 뒤에는 log-level: debug로 잠시 올려 DNS 질의가 기대한 리스너로 들어오는지 확인합니다. 증상이 복잡하면 로그·DNS·규칙 점검 글의 순서를 그대로 적용할 수 있습니다.

DHCP와 게이트웨이 옵션

가족 기기마다 수동 IP를 치기 어렵다면, 메인 공유기 쪽 DHCP에서 특정 MAC 주소에만 다른 게이트웨이·DNS를 배포하도록 설정하는 방법이 있습니다. 반대로 OpenWrt가 메인 DHCP를 담당하게 만들면 전체 집이 한 번에 사이드 경로로 넘어가므로, 장애 시 영향 범위가 커집니다. 운영 단계에 따라 “소수 테스트 단말만 수동”에서 시작해 점진적으로 DHCP 옵션을 넓히는 전략이 안전합니다.

IPv6가 활성화돼 있으면 AAAA 응답이 직통으로 나가면서 “규칙을 피하는” 경우가 있습니다. 테스트 기간에는 RA·DHCPv6를 잠시 줄이거나, OpenWrt에서 IPv6 DNS 경로까지 Mihomo와 맞는지 별도로 확인하세요. 듀얼 스택 환경에서는 문제 원인이 반쯤 IPv6에 있을 가능성을 항상 열어 두는 것이 좋습니다.

방화벽·포워딩·루프 방지

사이드 장치가 게이트웨이 역할을 하려면 커널에서 IPv4 포워딩이 켜져 있어야 하고, fw4에서 LAN→WAN(또는 LAN→메인 게이트웨이) 트래픽이 허용되는지 확인합니다. Mihomo가 TUN으로 잡은 트래픽을 다시 메인 공유기로 넘길 때, 비대칭 라우팅이나 NAT 루프가 생기면 “핑만 되고 HTTPS는 실패” 같은 증상이 납니다. 이때는 tcpdump로 어느 인터페이스에서 패킷이 사라지는지부터 봅니다.

관리용 Web UI 포트와 Mihomo 외부 API 포트가 겹치지 않게 분리하고, 외부 API는 LAN에서만 접근 가능하게 제한하세요. 공유기 뒤라도 가정 내 침해를 막기 위한 최소한의 조치입니다. 규칙이 길어지면 문서 허브의 고급 라우팅 챕터와 함께 백업 정책을 세우는 것이 좋습니다.

끊김·무응답 트러블슈팅 체크리스트

첫째, OpenWrt LAN 주소·메인 공유기 주소·클라이언트 게이트웨이가 의도대로인지 ip route와 LuCI 개요 화면으로 다시 적습니다. 둘째, Mihomo 프로세스가 살아 있고 구독이 갱신됐는지 로그로 확인합니다. 셋째, DNS가 실제로 어느 포트로 들어가는지 dig @192.168.1.2 등으로 검증합니다. 넷째, TUN을 켠 뒤라면 스택·MTU·노드 지연을 의심하고, 다섯째, 메인 공유기가 AP 격리나 방화벽으로 사이드 IP를 차단하지 않는지 봅니다.

증상이 “특정 앱만”이면 SNI·QUIC·UDP 경로를 의심하고, 전부라면 게이트웨이·기본 라우트·DNS 순으로 좁힙니다. 변경 전후의 uci export와 Mihomo 설정 디렉터리를 타임스탬프와 함께 보관하면 다음 장애 때 비교가 빨라집니다. 장시간 재현되는 끊김이면 VPN 터널의 MTU 조정 문서를 함께 참고하세요.

네트워크 프록시는 합법적인 개인정보 보호·개발·원격 업무에 쓸 수 있지만, 관할 법령·서비스 약관·고용 계약을 위반하는 우회에 사용해서는 안 됩니다. 회사망·타인에게 제공하는 Wi‑Fi에서는 정책을 확인하세요.
오픈소스 코어의 릴리스·이슈는 GitHub 등에서 확인할 수 있습니다. 데스크톱·모바일 클라이언트 설치 패키지는 공식 다운로드 페이지를 우선 참고하고, 소스·라이선스는 저장소를 별도로 열람하는 편이 혼선이 적습니다.

정리

OpenWrt Clash 조합으로 라우터 사이드 게이트웨이를 만들 때 핵심은 세 가지입니다. 첫째, LAN 토폴로지와 고정 IP를 문서화하고, 둘째, TUN을 켤 거라면 커널 모듈·권한·방화벽 순서를 미리 검증하며, 셋째, DNS 경로를 Mihomo 규칙과 같은 파이프로 묶는 것입니다. 이 셋이 맞으면 TV·콘솔처럼 프록시 UI가 없는 기기도 동일 정책으로 묶기 쉬워집니다.

같은 코어를 쓰더라도 Docker 호스트와 OpenWrt는 서비스 관리·플래시 수명 제약이 다릅니다. 위 순서대로 검증하면 “한 번 올리고 잊는” 구성에 가깝게 수렴합니다. 이미 PC에서 규칙을 다듬었다면 프로필만 복사해 라우터 쪽 경로에 두고 재사용할 수 있어, 가정 내 정책을 한 파일로 맞추기도 수월합니다.

라우터 밖의 노트북·스마트폰에서는 동일한 Mihomo 규칙을 GUI 클라이언트로 쓰는 편이 관리가 쉬울 때가 많습니다. 다른 플랫폼과 같은 정책을 유지하면서 체감 지연을 비교해 보고 싶다면, 아래 링크에서 클라이언트를 고르시면 됩니다.

Clash를 무료로 내려받고 OpenWrt와 함께 쓸 데스크톱·모바일 클라이언트도 선택해 보기