문제별 목차

Clash 자주 묻는 질문

기본 개념, 설정, 일상적인 사용법, 오류 증상별로 찾아보세요. 문제를 확인하기 전에 클라이언트 이름, 코어 정보, 오류 메시지 원문을 기록하고 설정은 한 번에 하나씩만 바꾼 뒤 새 연결로 결과를 확인하세요.

기본 개념

클라이언트, 코어, 구독, 트래픽 진입 경로를 구분해 설정 누락을 소프트웨어 오류로 오해하지 않도록 하세요.

Clash, mihomo, GUI 클라이언트는 각각 어떤 역할을 하나요?

Clash는 일반적으로 규칙에 따라 트래픽을 분기하는 프록시 도구와 그 설정 생태계를 가리키며, mihomo는 이 생태계에서 계속 유지 관리되는 코어 프로젝트입니다. Clash Verge Rev 같은 GUI 클라이언트는 구독 가져오기, 프록시 그룹 선택, 시스템 설정을 담당하고, 코어는 설정을 해석해 규칙을 적용하고 연결을 수립합니다. 문제를 해결할 때는 먼저 GUI 조작 오류인지 코어 실행 오류인지 구분한 다음 해당 로그를 확인하세요. 클라이언트마다 포함된 코어와 지원하는 설정 항목이 다를 수 있으므로, 기존 설정을 옮긴 뒤에는 정상적으로 불러오는지 먼저 확인해야 합니다.

클라이언트를 설치했는데도 구독이나 프록시 설정이 필요한 이유는 무엇인가요?

클라이언트는 로컬 프록시 연결 지점과 트래픽 분기 기능을 제공하지만, 설치만으로 원격 프록시 서비스를 사용할 수 있는 것은 아닙니다. 실제로 연결하려면 유효한 서버 정보나 해당 정보가 포함된 구독 설정이 필요합니다. 사용 권한이 있는 설정을 확보한 뒤 구독 페이지에 가져와 현재 설정으로 지정하고, 프록시 페이지에서 사용할 전략을 선택하세요. 구독 URL에는 접속 인증 정보가 포함되는 경우가 많으므로 비밀번호처럼 관리해야 합니다. 문제를 문의할 때는 URL의 토큰, 계정, 서버 인증 정보를 가리고, 전체 설정을 공개 게시판에 올리지 마세요.

규칙·전역·직접 연결 모드는 어떻게 다른가요?

규칙 모드는 설정에 적힌 규칙 순서에 따라 연결에 사용할 전략을 선택합니다. 전역 모드는 코어로 들어온 연결을 전역 전략에 전달하며, 이때도 해당 전략의 출구를 선택해야 합니다. 직접 연결 모드는 일반적으로 코어로 들어온 연결을 대상에 바로 연결합니다. 전역 모드라고 해서 기기의 모든 앱 트래픽을 처리하는 것은 아닙니다. 시스템 프록시나 TUN으로 들어오지 않는 트래픽은 클라이언트를 우회할 수 있습니다. 평소에는 규칙 모드를 사용하고, 특정 사이트에 문제가 생기면 잠시 전역 모드로 바꿔 비교한 뒤 연결 기록을 살펴 트래픽 분기 문제인지 확인하세요.

시스템 프록시와 TUN 모드를 함께 켜야 하나요?

시스템 프록시는 운영체제의 프록시 설정을 따르는 앱에서 주로 사용합니다. TUN은 가상 네트워크 인터페이스와 라우팅을 통해 트래픽을 처리하므로 시스템 프록시를 읽지 않는 일부 프로그램에 적합합니다. 두 기능을 반드시 함께 켜야 하는 것은 아닙니다. 처음 설정할 때는 시스템 프록시만 사용해 구독과 출구가 정상인지 확인한 다음, 필요한 앱에 맞춰 TUN을 켜세요. 클라이언트가 두 기능의 동시 사용을 지원한다면 문서에 따라 설정하고, 다른 VPN이 라우팅을 동시에 변경하지 않도록 주의하세요. 인터넷이 끊기면 먼저 TUN을 끄고, 확인된 간단한 연결 경로부터 하나씩 점검하세요.

클라이언트를 바꿔도 기존 구독과 규칙을 그대로 사용할 수 있나요?

같은 설정 형식과 코어 기능을 지원하는 클라이언트라면 구독을 재사용할 수 있는 경우가 많습니다. 다만 GUI의 오버라이드, 스크립트, 단축키, 서비스 모드 설정은 함께 이전되지 않을 수 있습니다. 기존 설정과 로컬 규칙을 먼저 백업한 뒤 새 클라이언트에 구독을 별도로 가져오고, 코어가 프로토콜과 설정 항목을 지원하는지 확인하세요. 기본 연결이 정상인지 확인한 다음 오버라이드를 옮겨 한 번에 여러 변수가 생기지 않도록 합니다. 두 클라이언트가 동시에 시스템 프록시나 TUN을 제어하게 두지 마세요. 새 환경을 확인한 뒤 기존 클라이언트의 자동 시작과 백그라운드 서비스를 정리하세요.

설치 및 설정

구독 가져오기, 설정 불러오기, 권한 승인, 프록시 진입 경로 순서로 확인하세요. 설치 파일 선택은 클라이언트 페이지를 참고하세요.

구독을 가져오지 못하거나 오류가 표시되면 먼저 무엇을 확인해야 하나요?

계정 페이지 주소가 아니라 구독 URL 전체를 복사했는지 먼저 확인하고, 링크 만료 여부와 토큰 재발급 여부, 기기 시간이 정확한지도 점검하세요. 가져오기 로그에서 HTTP 상태 코드나 파싱 오류를 확인합니다. 401·403은 권한 문제일 가능성이 높고, 404는 주소가 변경됐을 수 있으며, 웹 페이지 내용이 반환됐다면 로그인 페이지나 인증 페이지에 연결됐을 수 있습니다. 로그에 연결 시간 초과가 표시되면 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인하세요. 낯선 변환 사이트에 링크를 반복해서 제출하지 마세요. 형식을 변환해야 한다면 서비스 제공자가 지원하는 호환 형식을 우선 사용하세요.

YAML을 가져온 뒤 설정 파싱 오류가 발생하면 어떻게 원인을 찾나요?

코어 로그를 열어 오류가 난 줄 번호와 설정 항목 이름을 기록한 뒤, 해당 줄과 바로 앞 줄을 확인하세요. YAML 들여쓰기는 공백을 사용해야 하며, 목록 항목, 콜론 뒤 공백, 따옴표의 짝도 파싱에 영향을 줄 수 있습니다. 지원하지 않는 프로토콜이나 설정 항목이 오류에 표시되면 들여쓰기만 고칠 것이 아니라 현재 코어가 해당 항목을 지원하는지 확인하세요. 우선 가장 최근에 실행됐던 설정으로 돌아간 다음 로컬 변경 사항을 한 부분씩 다시 적용할 수 있습니다. 구독에서 자동 생성된 파일을 직접 수정하면 다음 업데이트 때 변경 사항이 덮어써질 수 있으므로, 클라이언트가 지원하는 오버라이드 기능에 사용자 설정을 추가하세요.

TUN 모드에서 권한 부족 또는 가상 네트워크 어댑터 생성 오류가 발생하면 어떻게 하나요?

먼저 클라이언트에서 요구하는 서비스 모드나 보조 서비스가 설치되어 실행 중인지 확인하세요. Windows에서는 보통 백그라운드 서비스 설치를 승인해야 하고, macOS에서는 보조 구성 요소를 허용해야 할 수 있습니다. Linux에서는 네트워크 관리 권한과 사용 가능한 TUN 장치가 필요할 수 있습니다. 구체적인 방법은 클라이언트 문서를 따르세요. 서비스 설정 대신 모든 프로그램을 상시 높은 권한으로 실행하지 마세요. 권한이 충분한데도 문제가 계속되면 다른 VPN을 끄고 다시 시도한 뒤, 로그에서 드라이버·라우팅·포트 충돌 여부를 확인하세요. 설정을 변경하기 전에는 기존 값을 기록해 네트워크를 복구할 수 있도록 하세요.

시스템 프록시를 켰는데도 브라우저가 프록시를 사용하지 않는 이유는 무엇인가요?

먼저 코어가 실행 중이고 현재 설정이 활성화되어 있으며, 시스템 프록시가 클라이언트에서 실제로 수신 대기 중인 주소와 포트를 가리키는지 확인하세요. 다른 가이드의 포트 번호를 그대로 복사하지 마세요. 그런 다음 브라우저가 별도의 프록시 설정이나 확장 프로그램, 우회 목록을 사용하는지 살펴보세요. 연결 페이지를 열어 새 사이트에 접속해 보세요. 기록이 없다면 우선 트래픽이 들어오는 경로를 확인하고, 기록은 있지만 DIRECT가 선택됐다면 규칙과 모드를 점검하세요. 다른 프록시 프로그램이 시스템 설정을 덮어쓰는지도 확인해야 합니다. 설정을 바꾼 뒤 기존 연결을 닫거나 브라우저를 재시작해 이전 연결이 판단에 영향을 주지 않도록 하세요.

휴대폰에서 VPN 권한과 백그라운드 실행은 어떻게 설정하나요?

모바일 클라이언트는 일반적으로 운영체제의 VPN 인터페이스를 통해 트래픽을 처리하며, 처음 연결할 때 시스템 안내에 따라 권한을 허용해야 합니다. Android에서는 보통 일반 VPN 서비스를 한 번에 하나만 실행할 수 있어, 다른 VPN을 켜면 현재 연결이 끊길 수 있습니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 활동, 제조사별 자동 시작 제한을 확인하고 실제로 필요한 클라이언트에만 권한을 조정하세요. 연결 유지를 위해 모든 절전 기능을 끄지 마세요. 백그라운드 앱 종료가 원인인지 확인한 뒤 배터리 사용 시간과 상시 실행 필요성을 고려하세요. 실제 접속도 함께 확인해야 연결 상태를 판단할 수 있습니다.

사용 팁

연결 기록으로 규칙을 확인하고, 실제 앱의 동작을 기준으로 전략을 판단하세요. 용어 설명은 용어 안내서를 참고하세요.

특정 사이트에 어떤 규칙이 적용됐는지 어떻게 확인하나요?

규칙 모드를 사용하고 연결 페이지에서 도메인이나 앱으로 필터링해 적용된 규칙, 프록시 그룹, 최종 출구를 확인하세요. 캐시 영향을 줄이려면 해당 사이트의 기존 연결을 닫은 뒤 다시 접속합니다. 규칙은 대개 위에서 아래 순서로 적용되므로 앞쪽의 포괄적인 규칙이 뒤쪽의 구체적인 규칙보다 먼저 적용될 수 있습니다. 마지막 MATCH는 앞선 규칙에 걸리지 않은 연결에 적용됩니다. 사용자 규칙을 추가하기 전에 전략 이름이 실제로 존재하는지 확인하고, 구독 업데이트가 로컬 변경 사항을 덮어쓰는지도 살펴보세요. 브라우저에서 사이트가 열리는지만으로는 규칙이 의도대로 적용됐는지 정확히 판단할 수 없습니다.

수동 선택·자동 테스트·장애 조치 프록시 그룹은 어떻게 선택하나요?

수동 선택 그룹은 출구를 고정할 때 적합하고, 자동 테스트 그룹은 측정 결과를 바탕으로 적절한 노드를 선택합니다. 장애 조치 그룹은 일반적으로 설정된 순서대로 사용 가능한 항목을 선택합니다. 자동 테스트 결과는 지정된 테스트 주소에 연결되는지만 보여 주므로 모든 사이트, 동영상, 게임에서 같은 성능을 보장하지 않습니다. 특정 지역으로 안정적으로 로그인해야 한다면 출구를 고정해 세션이 재인증되는 일을 줄이는 편이 좋습니다. 그룹에 사용 가능한 항목이 없다면 구독과 기본 연결부터 확인하세요. 테스트 간격을 줄이는 것만으로 문제를 해결하려 하지 마세요. 너무 잦은 테스트는 네트워크 요청과 모바일 배터리 소모를 늘립니다.

Fake-IP 주소란 무엇이며 호환성 문제가 발생하면 어떻게 해결하나요?

Fake-IP는 예약된 주소 범위의 가상 주소를 사용해 도메인과 연결을 매핑하고, 코어가 도메인 정보를 바탕으로 실제 요청을 처리하는 방식입니다. 따라서 DNS 조회 결과가 사이트의 실제 주소가 아니어도 반드시 DNS 오류인 것은 아닙니다. 일부 로컬 네트워크 서비스, 게임, 실제 주소를 요구하는 앱은 호환되지 않을 수 있습니다. 코어 문서를 참고해 특정 도메인을 필터링하거나 DNS 모드를 조정하세요. DNS 설정을 전부 지우지 마세요. 변경한 뒤 앱 연결을 새로 만들고, 필요한 경우 시스템 DNS 캐시를 비운 다음 조회와 연결이 예상한 경로를 거치는지 확인하세요.

Clash GeoIP를 업데이트했는데도 트래픽 분기가 바뀌지 않을 수 있는 이유는 무엇인가요?

GeoIP 데이터는 주소의 지역 정보를 매칭하는 데 사용되지만, GEOIP 같은 관련 규칙을 실제로 사용할 때만 결과에 영향을 줍니다. 먼저 연결 기록에서 앞선 도메인 규칙, 규칙 세트, MATCH가 적용됐는지 확인한 뒤 설정에서 어떤 데이터베이스와 업데이트 경로를 사용하는지 살펴보세요. 코어에 따라 MMDB, 다른 지리 데이터 형식, 별도 규칙 세트를 사용할 수 있으므로 데이터 파일을 임의로 서로 바꿔 쓸 수는 없습니다. 업데이트에 성공하면 클라이언트 안내에 따라 다시 불러오고 새 연결로 확인하세요. IP 주소의 지역 정보가 서비스 배포 위치와 다를 수도 있으므로 연결 로그와 도메인 규칙을 함께 확인하세요.

시작 프로그램에 등록했는데 부팅 후 자동으로 인터넷에 연결되지 않으면 무엇을 확인해야 하나요?

부팅 시 자동 실행, 실행 후 프록시 활성화, 이전 설정 복원, 백그라운드 서비스 실행은 각각 별개의 옵션입니다. 하나를 켰다고 나머지도 활성화되는 것은 아닙니다. 먼저 시스템 로그인 후 클라이언트가 실제로 실행됐는지 확인하고, 현재 설정과 프록시 그룹, 프록시 스위치가 복원됐는지 점검하세요. TUN을 사용하려면 보조 서비스와 권한도 필요합니다. 부팅 직후에만 실패한다면 네트워크가 아직 연결되지 않았을 수 있으니 로그를 확인하고 클라이언트의 지연 시작 옵션을 사용해 보세요. 여러 시작 작업에서 프로그램을 중복 실행하면 수신 포트가 충돌하거나 시스템 프록시 설정이 덮어써질 수 있습니다.

문제 해결

오류가 발생했을 때의 로그와 설정을 기록해 두고, 한 번에 하나씩 비교 테스트한 뒤 설정이나 네트워크를 변경하세요.

모든 노드에서 시간 초과가 발생할 때 구독 문제와 기기 문제를 어떻게 구분하나요?

먼저 프록시를 끄고 기본 네트워크가 정상인지 확인한 뒤, 기기 시간이 정확하고 구독이 유효하며 트래픽이나 연결 수 제한에 걸리지 않았는지 살펴보세요. 그런 다음 정상 동작이 확인된 출구 하나만 테스트하고, 로그에서 도메인 조회, 핸드셰이크, 연결 거부 메시지를 확인합니다. 모든 출구가 실패하면 설정을 계속 바꾸기보다 기기 방화벽, 네트워크 제한, 다른 VPN과의 충돌을 먼저 점검하세요. 내장 테스트 주소에 접속할 수 없어도 시간 초과가 표시될 수 있으니 실제 접속 결과와 로그를 함께 비교하세요. 특정 네트워크에서만 실패한다면 신뢰할 수 있는 다른 네트워크에서 재시험해 문제 범위를 좁히세요.

시스템 프록시는 작동하는데 Windows 스토어 앱이 인터넷에 연결되지 않으면 어떻게 하나요?

일부 UWP 앱은 네트워크 격리 때문에 로컬 컴퓨터의 루프백 프록시 주소에 직접 접속하지 못합니다. 먼저 해당 앱이 실제로 이 문제에 해당하는지 확인한 뒤, 클라이언트에서 제공하는 루프백 예외 도구를 사용하거나 관리자 권한으로 CheckNetIsolation LoopbackExempt를 실행해 특정 앱을 관리하세요. CheckNetIsolation LoopbackExempt -s를 실행하면 기존 목록을 확인할 수 있습니다. 앱을 추가하려면 정확한 앱 패키지 식별자가 필요합니다. 필요한 앱만 예외로 등록하고 변경 사항을 기록하며, 더 이상 필요하지 않으면 삭제하세요. 일반 데스크톱 프로그램의 연결 오류에는 이 방법을 바로 적용하지 마세요.

Clash DNS 누출이 의심될 때 어떻게 확인하고 설정을 조정하나요?

먼저 프록시를 통해 조회해야 하는 도메인과 로컬에서 조회해도 되는 로컬 네트워크·직접 연결 도메인을 구분하세요. 그런 다음 코어 DNS, TUN의 DNS 처리, 브라우저 보안 DNS, 시스템 DNS 설정이 서로 우회하지 않는지 확인합니다. 테스트 페이지에 표시되는 DNS 서버 위치는 참고 정보일 뿐입니다. 설정과 연결 로그, 필요하면 패킷 캡처까지 함께 확인하세요. 직접 연결 DNS 조회까지 모두 프록시 출구에 표시되어야 하는 것은 아닙니다. 설정은 한 번에 한 계층만 바꾸고 연결을 새로 만들어 확인하세요. 암호화 DNS는 조회 전송을 보호하지만, 조회가 프록시 출구를 거친다는 보장은 하지 않습니다.

TUN을 켠 뒤 로컬 네트워크 기기나 프린터에 접속할 수 없으면 어떻게 하나요?

먼저 TUN을 끄고 비교해 문제가 라우팅이나 DNS 처리에서 비롯됐는지 확인한 뒤, 로컬 네트워크 주소와 사설 IP 대역, 로컬 도메인이 직접 연결되는지 점검하세요. 실제 네트워크에 맞춰 설정에서 우회 또는 직접 연결 규칙을 지정하고, 모든 대역을 한꺼번에 제외하지 마세요. 기업 VPN도 함께 사용한다면 라우팅이 충돌할 수 있으므로 라우팅 테이블과 인터페이스 우선순위를 비교해야 합니다. 프린터 자동 검색은 멀티캐스트에 의존할 수 있어 도메인 규칙만 추가해서는 해결되지 않을 수 있습니다. 먼저 기기 주소로 직접 접속해 보고 검색 프로토콜을 확인한 뒤, 설정을 바꾸고 기기를 다시 연결하세요.

클라이언트를 종료했는데도 네트워크에 문제가 남아 있으면 어떻게 복구하나요?

먼저 시스템 프록시가 더 이상 수신 대기하지 않는 로컬 포트를 가리키는지 확인하고, 필요하면 시스템 네트워크 설정에서 프록시를 끄세요. 그런 다음 TUN, 보조 서비스, 다른 VPN이 아직 실행 중인지 살펴보세요. 창을 정상적으로 닫아도 백그라운드 코어가 종료되지 않았을 수 있습니다. DNS나 라우팅을 직접 바꾼 적이 있다면 모든 네트워크 설정을 한꺼번에 초기화하지 말고 기록한 값을 기준으로 복원하세요. 복구 후에는 직접 연결 사이트와 로컬 네트워크 접속을 각각 테스트합니다. 클라이언트를 다시 실행할 때는 시스템 프록시만 먼저 켜고 정상 작동을 확인한 뒤 TUN을 복원하면 문제를 일으킨 설정을 찾기 쉽습니다.