OpenClash는 OpenWrt 라우터에서 Mihomo와 라우터 측 트래픽 분기를 관리하는 LuCI 플러그인입니다. 일반 Windows, Mac이나 휴대전화에 IPK/OpenWrt APK를 직접 설치할 수 없으며 기기용 클라이언트나 설정된 라우터를 사용해야 합니다.
펌웨어가 opkg를 사용하면 .ipk를, apk를 사용하면 OpenWrt용 .apk를 선택하세요. 여기서 APK는 Android 설치 파일이 아닙니다. 이 사이트의 IPK 백업은 ZIP으로 제공되므로 PC에서 ZIP 압축을 풀어 .ipk 파일을 꺼낸 뒤 해당 파일을 업로드하고 설치해야 합니다. LuCI 플러그인 패키지의 all 표기는 해당 플러그인 패키지에만 적용되며 Mihomo 코어 아키텍처와는 별개입니다. 코어는 라우터의 CPU, 엔디언과 운영체제에 맞아야 합니다. 의존성 설치 시에도 iptables와 firewall4를 구분하고 사용 중인 펌웨어에 맞는 구성을 선택하세요.
플러그인 설치는 비슷할 수 있지만 게이트웨이, DNS, DHCP와 전달 경로는 다릅니다. 메인 라우터는 보통 게이트웨이와 DNS를 배포하며 보조 게이트웨이는 단말과 DNS 경로를 명확히 해야 합니다. 먼저 단말 한 대의 설정만 바꿔 비교하세요. 네트워크 전체의 DHCP 설정을 한꺼번에 변경하지 말고 관리 화면에 접속할 경로를 유지하세요.
실패한 요청이 구독 URL인지 GitHub의 플러그인·코어 다운로드인지 구분하고 해당 로그를 확인합니다. 라우터 자체의 인터넷과 DNS가 정상이어야 합니다. curl (6)은 라우터 DNS, 시간 초과는 네트워크 경로, 인증서 오류는 시간과 CA 인증서를 확인하세요. 저장 공간과 구독 유효 기간도 확인하며 휴대전화 접속 성공이 라우터 접속까지 증명하지는 않습니다. 다운로드 후 구성 문법이나 코어 아키텍처를 확인합니다. 수동 업로드는 “配置管理”(구성 관리)의 “上传文件类型”(업로드 파일 유형)에서 “[Meta] 内核文件(.tar.gz)”(Meta 코어 파일)을 선택하고 CPU에 맞는 공식 .tar.gz 코어 압축 파일을 골라 “上传”(업로드)합니다. 이 업로드 항목은 .tar.gz를 요구하며 .gz의 확장자만 바꿔서는 변환되지 않습니다. 구성·백업 유형이나 LuCI 패키지를 코어로 사용하지 말고 DNS 문제를 반복 재설치로 해결하려 하지 마세요.
먼저 OpenClash의 구성 관리에서 백업을 선택해 플러그인 백업을 내려받아 보관하세요. OpenWrt 시스템 설정은 별도로 시스템 백업 페이지의 백업 생성로 저장합니다. 기존 게이트웨이·DNS 설정과 현재 코어 버전을 기록하고, 이전 플러그인 설치 패키지와 작동하는 코어 파일도 보관하세요. 플러그인, 코어와 구독은 각각 따로 업데이트하고 매번 단말 한 대로 검증합니다. 문제가 발생하면 먼저 플러그인을 비활성화하고 중지될 때까지 기다린 뒤, 방금 업데이트한 플러그인이나 코어를 이전에 작동하던 버전으로 되돌립니다. 플러그인 백업을 복원하려면 구성 관리에서 업로드 파일 유형을 백업 파일로 설정하고 저장한 .tar.gz를 업로드하세요. 게이트웨이나 DNS를 수동으로 변경했다면 기록한 값으로 복원한 뒤 단말의 직접 인터넷 연결과 라우터 관리 페이지 접속을 확인합니다. 백업에 구독 인증 정보가 포함될 수 있으므로 비공개로 보관하세요.
구독 가져오기는 구성 파일을 받는 과정일 뿐이며, 시작하려면 해당 구성을 선택하고 실행 가능한 코어도 갖춰야 합니다. 먼저 구성 관리의 구성 파일 목록에서 대상 YAML을 찾아 구성 전환를 선택하고 현재 구성으로 지정하세요. 시작에 실패하면 실행 로그를 열어 첫 번째 오류부터 해결합니다. 구성 파싱 오류라면 표시된 위치를 수정하거나 호환되는 구성을 다시 받으세요. 코어가 없거나 아키텍처가 맞지 않으면 해당 기기에 맞는 코어를 다시 설치하고, 권한이나 의존성 오류는 로그에 따라 수정합니다. 한 번에 하나만 변경한 뒤 다시 시작해 검증하세요.
단말 한 대에서 직접 연결 사이트, 목적 사이트와 관리 페이지를 비교하고 실제 게이트웨이·DNS를 확인합니다. 라우터만 정상이라면 DHCP, 전달과 접근 제어를, IP만 접속된다면 DNS를 확인하세요. 요청이 연결 기록에 나타나면 적용 규칙, 정책 그룹과 서버를 점검합니다. 복구하려면 실행 상태의 플러그인 스위치를 끄고 중지를 기다린 뒤 수동 변경한 게이트웨이·DNS를 기록한 값으로 되돌리고 기본 네트워크와 관리 접속을 다시 시험합니다. 모든 펌웨어에서 중지만으로 DNS가 복구되는 것은 아닙니다. 계속 실패하면 민감 정보를 제거한 로그와 펌웨어 정보를 보관하며 설정을 하나씩 변경합니다.
