OpenClash·OpenWrt 설치를 검색할 때의 의도
집이나 사무실에서 「메인 공유기는 그대로 두고, 옆에 OpenWrt 박스만 프록시 게이트웨이로 쓰고 싶다」는 요구가 꾸준합니다. 이때 많은 사용자가 찾는 키워드가 OpenClash 설치, OpenClash OpenWrt, OpenWrt OpenClash 2026 같은 조합입니다. 목표는 단순합니다. 첫째, 내 라우터 펌웨어와 CPU 아키텍처에 맞는 패키지를 고르고 싶습니다. 둘째, LuCI에서 의존성 경고 없이 luci-app-openclash를 올리고 싶습니다. 셋째, 구독 URL을 넣어 노드·규칙이 채워진 뒤, 폰이나 PC에서 첫 연결이 되는지 확인하고 싶습니다.
OpenClash는 OpenWrt용 LuCI 플러그인으로, 내부에서 Mihomo 즉 널리 알려진 Clash Meta 계열 코어를 구동합니다. Windows의 Clash Verge Rev처럼 한 대의 PC만 우회하는 구조가 아니라, LAN 단말의 기본 게이트웨이나 DNS를 이 박스로 두었을 때 투명 프록시·DNS 분기까지 한곳에서 다루는 형태에 가깝습니다. 그래서 「설치」 단계에서 플래시 여유, 커널 모듈, opkg 타깃을 먼저 맞추지 않으면, 이후 《오픈클래시 LuCI 정책 그룹》이나 《사이드 게이트웨이 투명 프록시》 같은 운영 글까지 가기 어렵습니다.
한국어 커뮤니티에는 이미 정책 그룹·노드 전환법은 있어도, 「처음 ipk를 올리는 줄기」가 여러 버전으로 섞여 있는 경우가 많습니다. 본문은 2026 기준으로 LuCI 메뉴 이름이 조금 달라져도 따라갈 수 있게, 「환경 확인 → 의존성 → 플러그인 → 코어 → 구독 → 실행 → 검증」 순서로만 고정합니다. PC만 우회하면 되는 상황이라면 라우터 설치보다 데스크톱 클라이언트 설치가 부담이 적을 수 있다는 점도 미리 짚어 둡니다.
시작 전에 확인할 펌웨어·하드웨어
- OpenWrt 릴리스: 공식·서드파티 이미지 모두 가능하나, 커널·
opkg타깃 문자열이 플러그인 ipk와 일치해야 합니다. LuCI 시스템 → 시스템에서 버전과 보드 이름을 적어 둡니다. - 오버레이 여유: 시스템 → 마운트 또는 SSH에서
df -h /overlay로 남은 용량을 봅니다. 코어·GeoIP·규칙 데이터까지 받으려면 수십 MB 이상 여유가 있는 편이 안전하고, 8MB급 구형 기기는 extroot 없이는 중도 실패가 흔합니다. - 아키텍처: x86_64·aarch64는 선택지가 넓고, 일부 mips/mipsel 보드는 코어 빌드가 제한되거나 TUN·TPROXY 모듈이 빠질 수 있습니다.
- HTTPS 구독: 대시보드에서 복사한 URL을 미리 준비합니다. 채팅방에 그대로 붙이지 마세요.
- 시간 동기화: 시스템 → 시스템 → 시간 동기화에서 NTP를 켭니다. 시각이 어긋나면 구독 TLS가 실패합니다. 자세한 대조는 《구독 업데이트 실패와 TLS·시간》을 참고하세요.
- 백업: 설정보내기나 전체 이미지 백업을 권합니다. 잘못된 방화벽 규칙은 LuCI 접속까지 끊을 수 있습니다.
타깃·아키텍처 맞추기
SSH가 가능하다면 아래로 CPU 계열을 확인합니다.
uname -m
opkg print-architecture
x86_64·aarch64 출력이면 데스크톱용 문서와 비슷한 ipk 이름을 고르기 쉽습니다. mips 계열은 릴리스 페이지에 올라온 파일명의 target·subtarget이 시스템 정보와 글자 단위로 같아야 합니다. 「비슷해 보이는」 다른 보드용 ipk를 강제 설치하면 의존성 지옥만 길어집니다.
가상 머신이나 소프트 라우터(x86)는 RAM 512MB 이상·디스크 여유가 넉넉한 편이 첫 구독 동기화에 유리합니다. 소형 Wi‑Fi 공유기는 발열과 동시 접속 수도 병목이므로, 「설치 성공」과 「가족 전원 동시에 4K」는 별개로 보는 것이 좋습니다.
소프트웨어 목록 갱신과 공통 의존성
LuCI 시스템 → 소프트웨어에서 업데이트를 눌러 인덱스를 갱신합니다. SSH라면:
opkg update
버전마다 권장 패키지 목록이 조금씩 다르지만, 설치 전에 자주 요구되는 항목은 다음과 같습니다. LuCI 검색창에 이름을 넣어 하나씩 설치하거나, SSH에서 opkg install 패키지명으로 넣습니다.
bash,curl,ca-bundle— 스크립트·HTTPS 다운로드ip-full,iptables-nft또는 환경에 맞는iptables계열 — 리다이렉트·NATdnsmasq-full— DNS 분기·dhcp 옵션unzip,gzip— 압축 해제luci-compat,luci-lib-ipkg— LuCI 플러그인 호환kmod-tun,iptables-mod-tproxy등 — TUN·투명 프록시(메뉴에서 모듈 설치를 따로 안내하는 경우도 있음)
nftables 기반 최신 OpenWrt에서는 모듈 이름이 fw4·nft와 엮입니다. OpenClash 설정 화면의 「커널 모듈 설치」 안내가 뜨면, 거기 적힌 대로 진행하는 편이 문서와 실제 펌웨어의 괴리를 줄입니다.
luci-app-openclash ipk 설치
공식 GitHub Releases에서 장치 타깃에 맞는 luci-app-openclash_…_all.ipk 또는 아키텍처별 ipk를 받습니다. LuCI 시스템 → 소프트웨어 → 파일 업로드로 올린 뒤 설치하거나, SCP로 /tmp에 넣고:
opkg install /tmp/luci-app-openclash_*.ipk
의존성 오류가 나면 메시지에 나온 패키지를 먼저 opkg install한 뒤 ipk를 다시 실행합니다. 「설치는 됐는데 메뉴가 없다」면 브라우저 캐시를 비우거나 LuCI를 한 번 새로고침하고, 서비스 메뉴에 OpenClash가 생겼는지 확인합니다.
일부 커스텀 펌웨어는 피드에 미리 넣어 두기도 합니다. 그 경우에도 버전 호환을 확인하세요. 오래된 OpenWrt에 최신 OpenClash만 억지로 올리면 코어 다운로드 단계에서 멈추는 경우가 많습니다.
코어·Geo 데이터·커널 모듈 동기화
처음 서비스 → OpenClash에 들어가면 「코어 업데이트」「커널 모듈」 항목이 보입니다. 여기서 Mihomo(또는 안내하는 Meta 계열) 바이너리를 받아 두고, TUN·TPROXY 관련 모듈 설치를 완료합니다. 플래시가 부족하면 이 단계에서 공간 부족 로그가 남으므로, 앞서 본 오버레이 여유를 다시 확인하세요.
GeoIP·GeoSite·ASN 같은 오프라인 데이터는 규모가 큽니다. 처음에는 「최소 세트」만 받고, 규칙이 요구할 때 추가하는 방식도 있습니다. 구독 제공자가 이미 규칙을 포함한다면, 중복으로 모두 받을 필요는 없습니다.
첫 구독 가져오기
구독 관리·프로필·Subscribe 등 이름만 다른 같은 흐름입니다.
- 새 구독 항목을 추가하고 표시 이름을 붙입니다.
- URL 칸에 HTTPS 구독을 한 줄로 붙여 넣습니다. 앞뒤 공백·숨은 줄바꿈이 있으면 실패하기 쉽습니다.
- 업데이트·동기화를 눌러 원격 구성을 받아 옵니다.
- 노드·정책 그룹·규칙이 채워졌는지, 빨간 오류 배너가 없는지 확인합니다.
URL 자체의 개념·만료·재발급은 《Clash 구독 링크 가져오기》와 동일합니다. 라우터에서는 브라우저 확장 없이도 동작하므로, 「PC에서는 되는데 라우터만 안 된다」면 방화벽·DNS·시간 축을 우선 봅니다.
실행·모드·DNS·LAN 연동
설정을 저장한 뒤 실행·시작을 눌러 서비스를 올립니다. 일상에는 Rule 모드를 기본으로 두는 경우가 많습니다. Global은 모든 트래픽을 한 노드로 내므로 빠른 테스트에는 편하지만 국내 사이트까지 멀리 돌아갈 수 있습니다.
LAN 단말이 이 박스를 쓰게 하는 방법은 두 가지가 흔합니다. 메인 공유기 DHCP는 유지하고, 원하는 기기만 게이트웨이 IP를 OpenWrt로 지정하는 방식(사이드 라우터). 또는 OpenWrt를 메인 게이트웨이로 두는 방식. 전자는 사이드 게이트웨이 글과 짝이 됩니다. DNS를 OpenClash가 잡게 할지, 메인 공유기에 맡길지는 DHCP·53번 포트 충돌을 피하는 쪽으로 선택하세요.
설치 직후에는 TUN·Fake-IP·관리 DNS를 한꺼번에 켜기보다, 구독이 살아 있고 기본 리다이렉트만으로 목표 사이트가 열리는지 먼저 확인하는 순서를 권합니다. DNS 누출·스니핑 개념은 《Fake-IP와 DNS》와 문서 허브를 단계적으로 참고하세요.
첫 연결 검증
게이트웨이를 OpenWrt로 둔 단말에서 브라우저 새 창을 열고, 평소 막히던 사이트가 열리는지 봅니다. 출구 IP를 보여 주는 페이지로 선택한 노드 국가와 일치하는지 확인하면 신뢰도가 올라갑니다. 지연이 크면 LuCI에서 다른 노드·다른 정책 그룹을 고릅니다. 이후 화면별 클릭 순서는 《오픈클래시 정책 그룹》을 이어서 읽으면 됩니다.
「구독은 성공, 웹만 실패」면 실행 상태·방화벽·DNS 하이재킹·이중 NAT를 순서대로 봅니다. 「LuCI만 안 열린다」면 잘못된 redirect 규칙이나 루프백 차단을 의심하고, 물리 LAN 포트로 접속해 규칙을 되돌리세요.
여기서 막히면 점검할 순서
- ipk 설치 실패: 타깃 문자열·OpenWrt 버전·의존 패키지 누락을 메시지 그대로 해결합니다.
- 코어 다운로드 실패: 오버레이 용량·인터넷·GitHub 접근·프록시 없이 다운로드 가능한지 봅니다.
- 구독만 실패: URL·만료·NTP·방화벽 443 차단을 확인합니다.
- 일부 앱만 이상: QUIC·DoH·자체 VPN 앱이 우회를 무시하는지 확인합니다.
- 재부팅 후 꺼짐: 자동 시작 옵션·서비스 enable 상태를 LuCI에서 다시 켭니다.
자주 묻는 질문
플래시 용량이 부족하면 OpenClash를 못 쓰나요?
오버레이 여유가 매우 작으면 ipk·코어·Geo 데이터 중 하나에서 실패합니다. extroot로 USB·SSD를 붙이거나, RAM·플래시가 넉넉한 x86/ARM64 장비로 옮기는 편이 안전합니다.
구독을 넣었는데 노드가 비어 있습니다.
URL 오타·만료·일시 차단을 확인하고 업데이트를 다시 실행하세요. 라우터 시각이 어긋나면 TLS 오류가 납니다.
PC용 Clash와 무엇이 다른가요?
OpenClash는 LAN 게이트웨이용입니다. 본인 PC만 우회하면 데스크톱·Android 클라이언트가 설정 부담이 적습니다.
설치 후 정책 그룹은 어디서 보나요?
LuCI OpenClash의 정책 그룹·프록시 화면에서 Selector를 바꿉니다. 자세한 클릭 순서는 정책 그룹 전용 글을 참고하세요.
정리
OpenWrt에 OpenClash를 처음 올릴 때 핵심은 일곱 단계입니다. 펌웨어·아키텍처·플래시 여유를 확인하고, opkg로 공통 의존성을 맞춘 뒤, 타깃에 맞는 luci-app-openclash ipk를 설치하고, LuCI에서 코어·모듈을 동기화한 다음 구독 URL로 프로필을 채우고 서비스를 실행해 LAN 단말에서 출구·지연을 검증합니다. 메뉴 문구가 바뀌어도 이 줄기는 같으므로, 화면이 달라져도 같은 순서로 되돌아올 수 있습니다.
반면 예전 스크립트 모음이나 보드마다 다른 ipk 링크만 모아 둔 글은 OpenWrt 세대가 섞여 있어, 같은 「설치 실패」인데도 원인을 펌웨어·구독·DNS로 오해하기 쉽습니다. 라우터에 올리기 전에 PC·폰에서 먼저 익숙해지고 싶다면 그래픽 클라이언트가 훨씬 단순합니다. ClashSky는 Windows·macOS·Android·Linux에서 다운로드·구독·모드 선택을 같은 용어로 묶어 설명하고, 문제가 생기면 문서와 교차 링크로 빠르게 이동할 수 있게 정리해 두었습니다. 개인 단말부터 안정적으로 쓰고 싶다면 ClashSky를 무료로 다운로드해 라우터 설치와 비교해 보시길 권합니다.
패키지와 최신 릴리스는 공식 다운로드 페이지에서 플랫폼별로 확인할 수 있습니다.