누구를 위한 글인가: OpenClash LuCI에서 막히는 지점

이미 OpenWrt 올리고 OpenClash까지 넣었는데, 스마트폰이나 PC에서 막혔을 때마다 데스크톱 앱이 아니라 LuCI 웹만 열고 싶은 경우가 많습니다. 그런데 메뉴 이름이 Services 아래에 붙기도 하고, 번역 팩에 따라 구독·Subscription·Profiles처럼 용어가 섞이면 “지금 화면이 구독 갱신용이 맞는지”부터 의심하게 됩니다. 한국어로 OpenClash 사용법을 찾을 때 흔한 검색은 구독 갱신, 정책 그룹, 프록시 그룹, 노드 전환으로 이어지는데, 핵심은 같은 코어 구성을 웹에서 저장·병합·재시작하는 순서를 한 번에 기억해 두는 것입니다.

라우터에서의 관리 경험만으로는 패널 레이블이 헷갈릴 수 있으니, 초기에는 변경 원인별로 순서 노트를 두는 편이 가장 빠릅니다. 본 글은 턴키 설치 과정 자체보다 “이미 돌아가는 상태에서 매일 하는 조작”에 초점을 맞춥니다. OpenWrt 쪽 게이트웨이 설계까지 같이 잡아야 한다면 OpenWrt Clash 사이드 게이트웨이 글과 토폴로지부터 맞추는 편이 좋습니다.

패널에 들어가기 전에 확인할 것

첫째, 저장 공간이 부족하면 구독 파일이 받아 졌더라도 잘린 YAML이 만들어져 “새 노드가 하나도 안 보인다”는 증상이 납니다. 둘째, OpenClash 패키지는 릴리스마다 버튼 위치와 탭 이름이 조금씩 달라질 수 있어, 글 속 단어와 1대1 매칭이 안 될 때는 기능 그룹(구독·구성 파일·실행 상태·프록시 뷰) 기준으로 옮겨 다녀야 합니다. 셋째, 관리용 웹 접속 자체가 VPN에 막혀 있으면 패널이 열리지 않으므로, 최초 한 번은 직접 LAN에서 검증합니다.

보안 차원에서 패스워드를 공유 라우터에 두지 말고, 설정을 바꾼 날짜별로 설정 디렉터리를 백업해 두면 병합 실수 후에도 빠르게 되돌릴 수 있습니다. 고급 편집은 YAML 무결성이 중요하므로 시작 전후로 config.yaml 스냅샷 습관이 유효합니다. 규칙 문법을 같이 점검하고 싶다면 커스텀 라우팅 규칙 입문 글의 “위에서 아래로 읽는다”는 설명이 그대로 도움이 됩니다.

구독 새로 고침: 어디를 누르고 무엇이 바뀌나

구독 갱신은 원격 서버가 내려 주는 프록시 목록·규칙 조각을 로컬에 다시 쓰는 단계입니다. LuCI에서는 보통 (1) 구독 항목을 고르고, (2) “업데이트·다운로드·새로 고침”에 해당하는 버튼을 누르며, (3) 로그에 오류가 없는지 확인합니다. 이때 인증 URL이 만료됐거나, 라우터가 아웃바운드 DNS를 못 풀면 타임아웃으로 비어 있는 파일이 생깁니다. 실패 메시지가 짧을 때는 상위 공유기에서 필터링하는지, OpenClash가 쓰는 DNS가 루프에 빠지지 않았는지부터 봅니다.

여러 구독을 동시에 쓰는 구성이라면 “어느 구독이 어느 정책 그룹에 매핑되는지”를 메모해 두는 것이 좋습니다. 한 구독만 갱신했는데 전체가 흔들리는 것처럼 느껴지면, 실제로는 메인 프로필 병합 단계에서 다른 소스가 덮어썼을 가능성을 의심합니다. 데스크톱에서 정책 그룹 경험이 있다면 Clash Verge Rev 정책 그룹 가이드의 용어를 그대로 가져오면 패널 이해가 빨라집니다.

실전에서 반복 검증하기 좋은 순서입니다.

  1. LuCI에서 OpenClash 메뉴로 이동하고 상단 상태가 Running인지 확인합니다.
  2. 구독·Subscription·Profiles 등 구독과 연결된 탭을 연 뒤, 갱신할 항목의 체크박스 또는 행 단위 선택을 고릅니다.
  3. 해당 줄에 대한 업데이트·다운로드 액션을 실행하고 진행 표시와 로그에 오류가 없는지 봅니다.
  4. 완료 후 디스크에 생성된 로컬 구독 파일이 기대 크기인지 간단히 확인합니다(0바이트면 즉시 중단 원인부터).
  5. 구독이 메인 실행 프로필에 합쳐지도록 적용·병합에 해당하는 저장을 누릅니다(버전에 따라 용어가 다릅니다).
  6. 코어 재시작 또는 리로드까지 끝내고, Proxies 패널에 노드가 반영되었는지 확인합니다.

설정 적용과 재시작: 반드시 순서대로 갈 필요는 없지만 빠트리면 안 된다

패널에서는 “파일 저장”과 “실행 중인 코어 반영”이 분리되어 있는 경우가 많습니다. LuCI 표준 폼이라면 페이지 하단 Save & Apply까지 눌러야 uci 수준 변경이 디스크에 남습니다. 반면 OpenClash 전용 패널은 Merge·Reload-Core·Restart-Service 같은 동작 이름을 따로 둘 수 있습니다. 헷갈릴 때는 항상 (1) 구독/룰 소스 디스크 쓰기 → (2) 메인 실행 파일 갱신 → (3) 서비스 재기동 순으로 생각하면 안전합니다.

재시작 직후 몇 분간 핑이 튀는 것은 흔한데, 그때 브라우저를 새로 고침해 코어 대시보드가 다시 뜨는지 확인합니다. SSH로 볼 수 있다면 프로세스 기동 로그에서 DNS나 TUN 관련 경고가 연속으로 찍히는지 함께 보는 편이 좋습니다. 사이드 게이트웨이 환경처럼 메인 공유기와 경로가 겹친다면 OpenWrt TUN·DNS 글의 “DNS가 코어 밖에서 먼저 풀리는” 함정을 같이 점검하세요.

구독이 자주 바뀌는 집이라면 LuCI에서 수동 갱신 대신 스케줄 태스크를 켜 두는 편이 편합니다. 다만 실패 시 공급자 측 레이트 리밋에 걸리지 않게 주기를 너무 짧게 잡지 마세요.

정책 그룹·프록시 그룹 전환: 실제로 어디를 조작하나

Clash 구성에서 proxy-groups의 select·url-test·fallback 항목이 LuCI나 외부 대시보드에서는 정책 그룹으로 표시되는 경우가 많습니다. 사용자가 손으로 바꾸는 것은 대개 활성 노드 한 줄이며, 이 값이 바뀌면 그 그룹을 참조하는 규칙 줄의 출구가 함께 바뀝니다. 글로벌·룰·디렉트 같은 상위 모드와 혼동하기 쉬운데, 상위 모드는 “전체 트래픽 기본 경로”이고, 정책 그룹은 “규칙이 가리킨 출구 묶음”이라는 점이 다릅니다.

패널에서 보통 (1) Proxies·Policy·Dashboard 계열 화면을 연 뒤, (2) 목록에서 바꾸고 싶은 그룹 이름을 찾고, (3) 드롭다운에서 노드를 고릅니다. 일부 스킨은 모바일 뷰에서 접기 메뉴로 숨겨 두므로 가로 폭이 좁은 기기라면 데스크톱 모드로 보는 편이 낫습니다. url-test 그룹은 자동으로 회전하므로 UI에서 잠겨 보일 수 있는데, 그때는 간격·테스트 URL·히스테리시스 값을 YAML에서 조정해야 합니다.

“정책을 바꿨는데 특정 앱만 안 바뀐다”면 DNS 캐시나 OS 수준 프록시, 듀얼 스택 IPv6 우회를 의심합니다. 노드 자체는 살아 있는데 앱만 예전 경로를 쓰는 패턴은 데스크톱에서도 자주 나오므로, 라우터만의 문제라고 단정하지 말고 단말 쪽 캐시를 비우는 실험을 병행하세요.

로그로 좁히기: 구독과 정책 중 어디가 깨졌나

증상이 애매할 때는 먼저 OpenClash 로그에서 다운로드 단계 메시지를 찾습니다. HTTP 403·404·SSL 핸드셰이크 실패는 공급자 URL 문제이고, DNS resolve failed는 상위 DNS 설정 문제에 가깝습니다. 그다음 코어 쪽에서 rule match 또는 연결 이벤트가 찍히는지 봅니다. 아무 것도 안 찍히면 트래픽이 애초에 OpenClash를 안 지나가고 있거나, 브라우저가 시스템 프록시를 무시하고 있을 수 있습니다.

정책 그룹을 바꿨는데 속도만 이상하면 실제 활성 노드가 기대와 다른지 패널과 로그 시간을 같이 적어 비교합니다. 자동 테스트 그룹이라면 테스트 URL 자체가 막혀 잘못된 노드를 “정상”으로 찍는 경우도 있어, 진단 단계에서는 수동 선택 그룹으로 고정하는 것이 빠른 경우가 많습니다.

자주 묻는 질문

Q. 구독 새로 고침은 됐는데 노드 목록이 그대로일 때 무엇을 보나요?
A. 메인 프로필에 합치지 않았거나 코어 재시작이 빠졌을 가능성이 큽니다. 또한 디스크에 빈 파일이 생겼는지, 병합 시 문법 오류로 이전 설정이 유지되는지 로그와 파일 크기로 확인합니다.

Q. 정책 그룹과 프록시 그룹은 같은 말인가요?
A. 화면 번역에 따라 이름이 다르지만, 대개 proxy-groups 블록을 가리킵니다. 타입별 동작 차이(select 대 url-test)를 이해하면 UI 문구 변화에 덜 흔들립니다.

Q. LuCI만으로 데스크톱 Clash와 완전히 같은 조작이 가능한가요?
A. 코어 중심 작업은 대부분 동일하게 할 수 있습니다. 다만 규칙 편집 UX·통계 해상도·대량 로그 검색 등은 PC 앱이 유리할 때가 있어 역할 분담으로 생각하면 부담이 줄어듭니다.

프록시·우회 기능은 거주 지역 법령·서비스 약관·고용 계약·네트워크 운영 정책을 준수하는 범위에서만 사용해야 합니다. 타인에게 제공하는 Wi‑Fi나 회사 회선에서는 관리 규정을 따르세요.
OpenClash는 OpenWrt 생태 안에서 패키지로 배포되는 프론트엔드이며 실제 규격은 Mihomo 계열 클라이언트와 호환되는 YAML입니다. 새 릴리스와 문서 변경은 업스트림 저장소 공지를 참고하고, 노트북·스마트폰 클라이언트 바이너리는 혼선을 줄이기 위해 공식 스타일 가이드를 따르는 다운로드 페이지를 허브로 쓰는 편이 좋습니다.

정리

일부 범용 VPN 앱이나 토글만 있는 단순 클라이언트는 “라우터 뒤에서 구독 URL을 받아 규칙 묶음으로 합치고, 정책 그룹별로 노드를 교체한다” 같은 OpenWrt 패널 플로우를 그대로 설명하기 어렵습니다. 그 결과 같은 증상에도 사용자는 원인 레이어(구독 파일·메인 프로필·실행중 코어·DNS) 중 어디를 봐야 할지 막히기 쉽습니다.

반면 Clash·Mihomo 코어 계열은 OpenClash처럼 LuCI에서도 동일한 정책 그룹 개념을 유지하면서 노드 교체와 구독 갱신을 같은 YAML 생명주기로 묶어 줍니다. 규칙 출구를 패널 로그까지 연결해 검증하면 “새 노드만 안 받아진다”가 구독 실패인지 병합 누락인지 빠르게 갈립니다.

라우터 밖에서는 데스크톱·모바일 Clash 클라이언트가 편한 경우도 많습니다. 동일 규격을 여러 기기에서 맞추고 싶다면 본 사이트 클라이언트 다운로드 페이지에서 현재 플랫폼 패키지를 확인한 뒤, 여기 적은 순서로 OpenClash를 다시 따라가며 비교 검증하면 됩니다. 개념을 넓히려면 문서 허브 고급 섹션을 이어도 같은 용어가 그대로 이어집니다.

우선 데모부터 맞추고 싶다면 우선 패널 순서 노트만 적어 두어도 OpenClash 사용법 검색으로 들어온 분들에게 큰 줄일 에너지를 줄입니다. 아래 버튼에서 바로 패키지를 받아 테스트해 보실 수 있습니다.

→ OpenWrt에서는 LuCI를 쓰고, 나머지 기기에서는 Clash를 무료로 받아 정책을 맞춰 보기

클라이언트 다운로드 페이지에서 Clash 받기