127.0.0.1 / FAQ 목차

Clash 자주 묻는 질문

설정을 가져올 수 없다면 구독과 YAML부터 확인하고, 프록시를 켰는데도 작동하지 않는다면 요청이 코어에 도달했는지 먼저 살펴보세요. 겪고 있는 문제에 맞는 항목을 선택해 펼쳐 보세요.

127.0.0.1

기초 입문

프로그램, 설정, 트래픽이 들어오는 지점을 먼저 구분하세요.

Clash 클라이언트, Mihomo 코어, 구독은 각각 어떤 역할을 하나요?

클라이언트는 설정 가져오기, 로그 표시, 옵션 전환을 담당합니다. Mihomo를 사용하는 클라이언트에서는 코어가 포트 수신, DNS 조회, 규칙 매칭을 처리합니다. 구독은 설정을 가져오는 방법 중 하나이며, 설치 파일을 받는다고 자동으로 제공되지는 않습니다. 화면은 열리지만 연결되지 않으면 먼저 코어가 실행 중인지, 현재 설정이 적용되어 있는지, 노드가 정상인지 차례로 확인하세요. 설정을 불러오는 단계에서 로그 오류가 발생했다면 먼저 해당 오류를 해결해야 합니다. 노드를 바꿔도 코어 시작 문제는 해결되지 않습니다.

127.0.0.1, 192.168.1.1, 0.0.0.0은 어떻게 다른가요?

127.0.0.1은 기기 자체를 가리키는 IPv4 루프백 주소입니다. 휴대폰에 이 주소를 입력하면 컴퓨터가 아니라 휴대폰 자신을 가리킵니다. 192.168.1.1은 사설 IP 주소로 라우터 게이트웨이에 흔히 쓰이지만, 실제 용도는 기기의 네트워크 설정에 따라 다릅니다. 수신 주소로 사용하는 0.0.0.0은 기기의 모든 IPv4 인터페이스에 바인딩한다는 뜻이지, 다른 기기에 입력할 프록시 서버 주소가 아닙니다. 프록시를 해당 기기에서만 사용할 경우 루프백 주소를 우선 사용하고, LAN 공유가 켜져 있지 않은지 확인하세요.

mixed-port와 컨트롤 패널 포트를 같은 용도로 써도 되나요?

mixed-port는 HTTP와 SOCKS 프록시 연결을 모두 처리하는 혼합 프록시 수신 포트입니다. external-controller는 코어 관리 API의 수신 주소를 지정하며, 호환되는 패널이 상태를 확인하거나 정책을 바꿀 때 사용합니다. 브라우저 트래픽을 전달하는 포트가 아닙니다. 앱에 프록시를 설정할 때는 클라이언트에 현재 표시된 수신 주소와 포트를 사용하세요. 안내서의 예시 숫자를 그대로 입력하면 안 됩니다. 로컬에서만 사용하는 관리 API는 루프백 주소에 바인딩하고, 연결 문제를 확인한다며 LAN에 공개하지 마세요.

규칙, 전역, 직접 연결 모드는 각각 어떤 트래픽을 처리하나요?

세 모드 모두 코어로 전달된 연결만 처리합니다. 규칙 모드는 규칙을 순서대로 확인해 처음 일치하는 규칙의 대상으로 연결을 보냅니다. 전역 모드는 전역 정책에서 선택한 출구로 연결을 보냅니다. 직접 연결 모드는 프록시 노드를 거치지 않고 코어가 직접 연결합니다. 직접 연결 모드로 바꿔도 클라이언트가 종료되거나 앱에 설정된 프록시가 해제되는 것은 아닙니다. 잠시 모드를 전환하면 규칙 문제인지 출구 문제인지 구분하는 데 도움이 됩니다. 테스트가 끝나면 평소 사용하는 모드로 되돌리세요.

mixed-port

설치 및 설정

파일을 가져오는 단계부터 코어 시작까지 차례대로 확인하세요.

처음 설치한 뒤 가져온 설정이 적용됐는지 어떻게 확인하나요?

클라이언트의 설정 또는 구독 화면에서 로컬 YAML 파일이나 구독 URL을 가져오세요. 목록에 설정 이름이 나타나면 해당 설정을 선택하고 적용합니다. 가져오기에 성공했다는 것은 클라이언트가 파일을 받았다는 뜻일 뿐, 현재 설정이 바뀌었다는 뜻은 아닙니다. 연결 화면으로 돌아가 방금 적용한 설정이 표시되는지 확인한 다음, 프록시 그룹에서 사용할 수 있는 출구를 선택하세요. 접속 가능한 사이트를 브라우저에서 열고 연결 로그에서 대상 도메인과 실제 출구를 확인하면 됩니다.

Clash 구독 업데이트 실패: 링크 오류와 가져오기 실패를 구분하는 방법

먼저 계속 사용할 수 있는 기존 설정을 보존하고 업데이트 로그를 확인하세요. 401, 403, 404가 표시되면 구독 제공 페이지에서 계정 상태, 링크 변경 여부, 요청 출처 제한 여부를 확인합니다. 상태 코드만으로 구독이 만료됐다고 단정할 수는 없습니다. 시간 초과나 도메인 조회 실패가 표시되면 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인한 뒤, 클라이언트의 업데이트 방식도 살펴보세요. 설정 파일 대신 로그인 페이지가 반환되면 구독 URL을 다시 발급받아야 합니다. 문제를 확인할 때 전체 구독 링크가 공개된 화면에 노출되지 않도록 주의하세요.

YAML을 가져온 뒤 파싱 오류가 나면 어디부터 확인해야 하나요?

로그에 표시된 줄 번호와 필드 이름을 먼저 확인하고, 오류가 난 줄의 바로 윗줄도 살펴보세요. 앞줄에서 콜론, 따옴표 또는 들여쓰기를 빠뜨려 오류가 발생하는 경우가 있습니다. 탭 대신 공백으로 들여쓰고, 같은 단계의 목록 항목은 들여쓰기 위치를 맞추세요. 알 수 없는 필드나 지원하지 않는 프록시 유형이라는 오류라면 현재 코어의 필드 문서를 확인해야 합니다. 호환성 문제를 들여쓰기 문제로 오해하지 마세요. 설정 사본에서만 수정하고 다시 불러온 뒤 코어가 정상적으로 시작되는 것을 확인하고 나서 평소 사용하는 설정을 교체하세요.

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

로그에서 가상 네트워크 어댑터 생성 중 실패했는지, 라우팅 변경 중 실패했는지 먼저 확인하세요. 데스크톱에서는 클라이언트 안내에 따라 서비스 구성 요소를 설치하거나, 필요한 권한이 있는 경우 관리자 권한으로 실행하세요. 클라이언트 서비스가 실행 중인지도 확인합니다. 모바일 기기에서 시스템 VPN 인터페이스로 트래픽을 처리한다면 시스템 권한이 허용되어 있는지 확인하세요. 기존 VPN이나 다른 가상 어댑터가 있다면 라우팅 충돌 여부를 살펴보세요. 조직에서 관리하는 기기라면 임의로 권한을 완화하지 말고, 우선 앱에서 지원하는 프록시 설정으로 테스트하세요.

DIRECT

사용 팁

새 연결을 만들어 규칙, 출구, DNS 조회 결과를 확인하세요.

정책 그룹을 바꿨는데 연결 기록에 이전 노드가 계속 표시되는 이유는 무엇인가요?

연결 상세 정보에서 일치한 규칙과 정책 그룹 이름을 먼저 확인하세요. 규칙이 다른 그룹을 참조하거나 DIRECT를 바로 지정할 수 있으므로, 현재 선택한 그룹을 바꿔도 해당 트래픽에는 영향을 주지 않을 수 있습니다. 자동 선택 또는 장애 조치 그룹은 자체 속도 측정 결과와 순서에 따라 출구를 정합니다. 이미 연결된 장시간 연결은 기존 출구를 계속 사용할 수도 있습니다. 테스트 페이지를 닫거나 해당 앱을 재시작한 뒤 새 요청을 보내고, 새로 기록된 로그로 확인하세요. 이전 기록만 보고 판단하지 마세요.

특정 도메인만 열리지 않을 때 DNS 문제인지 확인하는 방법

로그에서 도메인 조회 실패와 조회 성공 후 연결 시간 초과를 구분하세요. 후자는 DNS 문제가 아닐 수도 있습니다. 브라우저에서만 문제가 생기면 브라우저 자체의 보안 DNS 사용 여부를 확인하세요. 사내 도메인이라면 조직에서 지정한 DNS가 필요한지 먼저 확인하고, 공용 DNS로 바로 바꾸지 마세요. 설정을 변경하기 전에 기존 값을 기록해 두고, 한 번에 DNS 설정 하나만 바꾸세요. 같은 앱에서 같은 도메인으로 다시 요청해야 어떤 변경이 효과가 있었는지 알 수 있습니다.

같은 LAN에 연결된 휴대폰에서 컴퓨터의 프록시 포트를 사용하는 방법

신뢰할 수 있는 네트워크에서만 LAN 접속을 허용하세요. 휴대폰의 프록시 주소에는 컴퓨터가 해당 LAN에서 사용하는 사설 IPv4 주소를, 포트에는 실제로 수신 중인 HTTP 또는 혼합 프록시 포트를 입력합니다. 컴퓨터가 해당 네트워크 인터페이스에서 연결을 수신하고 방화벽이 휴대폰의 연결을 허용하는지 확인하세요. 주소와 포트가 맞는데도 연결되지 않으면 Wi-Fi에서 게스트 기기 격리가 켜져 있는지 살펴보세요. 휴대폰의 Wi-Fi 프록시 설정이 모든 앱에 적용되는 것은 아닙니다. 사용을 마치면 공유를 끄고, 수신 포트를 공용 인터넷에 노출하지 마세요.

구독 전체를 수정하지 않고 특정 도메인의 규칙만 바꾸려면 어떻게 하나요?

클라이언트에서 오버라이드나 병합을 지원한다면 별도의 오버라이드 설정에 사용자 규칙을 추가하고, 병합 후 규칙 순서를 확인하세요. 규칙 모드는 처음 일치하는 규칙을 사용하므로 특정 도메인 규칙은 먼저 일치할 수 있는 광범위한 규칙보다 앞에 두고, MATCH는 마지막 기본 규칙으로 남겨 두세요. 수정 후 대상 정책 그룹이 실제로 존재하는지 확인하고 새 연결을 만들어 로그를 살펴보세요. 클라이언트에 오버라이드 기능이 없다면 구독 설정의 로컬 사본으로 테스트할 수 있지만, 이후 업데이트가 사본에 자동으로 반영되지는 않습니다.

127.0.0.1 / 수신 포트

문제 해결

요청이 코어에 도달했는지 먼저 확인한 뒤 다음 단계로 넘어가세요.

노드 속도 측정이 시간 초과되면 노드가 반드시 고장 난 건가요?

속도 측정 시간 초과는 해당 노드가 설정된 테스트 주소에 제때 요청을 완료하지 못했다는 뜻입니다. 같은 테스트 주소로 다른 노드와 비교해 보세요. 특정 노드 하나만 실패하면 해당 노드의 연결 로그를 확인하고, 여러 노드가 동시에 실패하면 현재 네트워크, 테스트 주소 접속 가능 여부, 구독 업데이트 필요 여부를 살펴보세요. 속도 측정은 정상인데 실제 접속이 안 된다면 실제 연결이 같은 출구를 사용하는지 확인하세요. 속도 측정과 앱 접속은 서로 다른 대상을 사용할 수 있으므로 한쪽 결과로 다른 쪽을 판단할 수 없습니다.

시스템 프록시를 켰는데 브라우저나 터미널에서 프록시가 적용되지 않는 이유는 무엇인가요?

새 요청을 보내고 클라이언트 로그를 확인하세요. 기록이 전혀 없다면 시스템 프록시의 주소와 포트가 코어의 수신 설정과 일치하는지 확인합니다. 브라우저에서는 확장 프로그램, 별도 프록시 설정, 우회 목록도 살펴보세요. 터미널 도구는 시스템 프록시 설정을 읽지 않을 수 있으므로, 도구 문서에 따라 프록시 인수나 환경 변수가 적용됐는지 확인해야 합니다. 로그에 연결 기록이 있다면 요청은 이미 코어에 도달한 것입니다. 시스템 프록시를 반복해서 껐다 켜기보다 일치한 규칙과 출구를 확인하세요.

Windows에서 UWP 앱만 로컬 프록시에 연결되지 않을 때 해결 방법

일반 데스크톱 브라우저에서 같은 로컬 프록시 주소와 포트가 작동하는지 먼저 확인하세요. 그런 다음 문제가 발생한 앱이 실제로 루프백 제한이 적용되는 앱 컨테이너에서 실행되는지 살펴봅니다. 스토어에서 설치한 앱이라고 해서 반드시 이 제한을 받는 것은 아닙니다. 컨테이너가 루프백 주소에 연결하지 못하는 문제로 확인되고 기기 관리 정책이 허용한다면, 클라이언트의 루프백 설정에서 해당 앱만 예외로 추가한 뒤 앱을 완전히 종료하고 다시 확인하세요. 이 예외는 루프백 접근 권한만 바꾸며, 원래 프록시 설정을 읽지 않는 앱이 자동으로 프록시를 사용하게 하지는 않습니다.

시작 로그에 포트가 사용 중이라고 나오면 어떤 포트를 바꿔야 하나요?

로그에서 바인딩에 실패한 주소와 포트를 확인한 뒤, 기존 클라이언트 프로세스나 다른 프록시 또는 다른 서비스 중 무엇이 해당 포트를 사용 중인지 살펴보세요. 정체를 모르는 프로세스를 무작정 종료하지 마세요. 충돌한 포트가 혼합 프록시 포트라면 클라이언트에서 사용 가능한 다른 포트로 변경하고 코어를 재시작한 다음, 시스템 프록시나 앱 설정의 포트도 함께 바꾸세요. 관리 API 포트가 충돌했다면 관리 API 주소의 포트를 변경하고 패널 연결 설정도 수정합니다. 마지막으로 로그에서 해당 수신 포트가 정상적으로 시작됐는지 확인하세요.