개념과 모드
기본 개념
클라이언트, 코어, 구독을 구분한 뒤 연결 모드를 선택하세요.
Clash, ClashX, mihomo는 어떤 관계인가요?
Clash는 프록시 코어와 관련 생태계를 가리키는 이름이고, ClashX는 macOS용 클라이언트이며, mihomo는 계속 개발되는 호환 코어입니다. 클라이언트는 메뉴, 구독 관리, 시스템 연동을 담당하고 코어는 연결, DNS, 규칙 처리를 담당합니다. 클라이언트마다 포함된 코어와 유지 관리 상태, 기능 메뉴가 다르므로 이름만 보고 TUN이나 특정 프로토콜 지원 여부를 판단할 수 없습니다. 사용할 클라이언트를 고를 때는 프로젝트 안내와 코어 정보를 확인한 뒤 해당 클라이언트 문서를 참고하세요.
클라이언트를 설치한 뒤에도 구독이 필요한 이유는 무엇인가요?
클라이언트는 연결과 트래픽 분배 기능을 제공하지만, 사용할 수 있는 프록시 서비스까지 자동으로 포함하지는 않습니다. 원격 구독에는 보통 노드, 그룹, 규칙이 포함되며 직접 관리하는 로컬 YAML 설정을 사용할 수도 있습니다. 가져오기 전에 출처를 신뢰할 수 있는지, 서비스 이용 기간이 남아 있는지, 현재 코어와 출력 형식이 호환되는지 확인하세요. 구독 링크의 토큰에는 접근 권한이 포함되는 경우가 많으므로 공개 화면에 노출하거나 공개 변환 사이트에 보내지 마세요. 이 사이트의 예시 주소는 입력 방법 설명용이며 실제 연결에는 사용할 수 없습니다.
규칙·전역·직접 연결 모드는 어떻게 선택하나요?
일상적인 사용은 보통 규칙 모드로 시작합니다. 연결은 설정에 지정된 규칙 순서에 따라 사용할 프록시를 선택합니다. 전역 모드는 코어가 처리하는 연결에 전역 정책을 적용하지만, 모든 앱의 트래픽이 자동으로 프록시를 거치는 것은 아닙니다. 시스템 프록시나 TUN도 올바르게 활성화해야 합니다. 직접 연결 모드는 프록시를 우회하므로 비교 점검에 유용합니다. 모드를 바꾼 뒤에는 새 연결로 테스트하세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 같은 페이지를 새로고침하는 것만으로 판단하지 마세요.
시스템 프록시와 TUN은 어떻게 다른가요?
시스템 프록시는 운영체제에 로컬 프록시 주소를 등록해 해당 설정을 따르는 앱에 적용합니다. TUN은 가상 네트워크 인터페이스로 라우팅 조건에 맞는 트래픽을 받아 처리하므로 적용 범위가 더 넓은 편이지만, 권한과 라우팅, DNS 설정이 필요합니다. 두 기능을 반드시 함께 켜야 하는 것은 아니며 모든 네트워크 트래픽을 처리한다고 보장할 수도 없습니다. 처음 설정할 때는 시스템 프록시부터 확인하고, 게임이나 명령줄 도구 등 실제 필요에 따라 TUN을 활성화하세요. 여러 트래픽 처리 방식을 동시에 바꾸면 원인을 찾기 어려워질 수 있습니다.
지연 시간 테스트에 값이 나오면 웹사이트도 반드시 열리나요?
지연 시간 테스트는 지정한 노드를 통해 특정 테스트 주소에 당시 접속을 시도했다는 뜻일 뿐, 모든 웹사이트와 프로토콜, 포트에 접속할 수 있음을 보장하지 않습니다. 실제 웹 탐색은 그룹 선택, 규칙 적용, DNS 확인, 대상 사이트의 제한에도 영향을 받습니다. 연결 기록에서 대상 도메인과 적용된 규칙, 실제 프록시 출구를 확인하고 대상 앱에서 새 요청을 보내 보세요. 지연 시간이 가장 짧다는 이유만으로 노드를 고르지 마세요. 한 번의 테스트보다 요청이 연속해서 안정적으로 완료되는지가 더 중요합니다.
가져오기 및 권한
설치 및 설정
설정을 활성화한 다음 시스템 프록시와 플랫폼 권한을 확인하세요.
구독 링크는 어디서 가져오며, 형식이 지원되지 않으면 어떻게 하나요?
클라이언트의 구독, 설정 또는 Profiles 화면에서 원격 설정을 추가하고 전체 URL을 붙여 넣은 다음 저장하고 다운로드해 해당 설정을 선택하세요. 클라이언트마다 메뉴 이름은 다를 수 있으며, 저장에 성공했다고 설정이 활성화된 것은 아닙니다. 파싱 오류가 표시되면 제공업체가 웹페이지나 단일 노드 링크, Base64 노드 문자열만 제공한 것이 아니라 호환되는 Clash YAML을 제공하는지 확인하세요. 우선 제공업체의 클라이언트별 설정 메뉴를 이용하세요. 변환이 꼭 필요하다면 토큰 노출과 규칙 변경 위험을 이해한 뒤 진행해야 합니다.
Windows에서 시스템 프록시를 켰는데 브라우저가 직접 연결되면 어떻게 하나요?
먼저 코어가 실행 중인지 확인하고 클라이언트에 표시된 로컬 수신 주소와 혼합 포트를 확인하세요. 그런 다음 Windows 프록시 설정의 주소와 포트가 일치하는지 살펴보세요. 모든 설정의 포트가 7890이라고 단정하면 안 됩니다. 브라우저 확장 프로그램, 별도 프록시 설정, 프록시 우회 목록이 시스템 설정을 덮어쓰는지도 확인하세요. 새 페이지를 열고 클라이언트 연결 기록을 살펴보세요. 새 기록이 전혀 없다면 트래픽이 프록시로 전달되는지 확인하고, 기록이 있다면 규칙과 그룹에서 실제로 선택된 출구를 점검하세요.
macOS에서 처음 실행할 때 확장 프로그램과 키체인 팝업은 어떻게 처리하나요?
먼저 앱을 응용 프로그램 폴더로 옮긴 다음 현재 클라이언트 안내에 따라 처음 실행하세요. 네트워크 확장 프로그램, 보조 서비스, 키체인 권한 요청은 해당 기능을 구현한 경우에만 표시될 수 있으며 모든 ClashX 클라이언트에서 같은 팝업이 나타나는 것은 아닙니다. 시스템 설정에서 허용하는 메뉴는 macOS 버전에 따라 달라지므로 개인정보 보호 및 보안과 네트워크 관련 설정을 확인하세요. 권한을 허용하기 전에 요청한 앱이 방금 설치한 앱인지 확인하세요. 이전에 권한을 거부했다면 프로젝트 문서에 따라 다시 요청을 표시하고, 시스템 보안 기능을 통째로 끄지는 마세요.
TUN 권한 부족 오류는 어떻게 해결하나요?
먼저 TUN을 끄고 클라이언트가 현재 시스템의 트래픽 처리 방식을 지원하는지 확인하세요. 이어서 서비스 모드, 보조 서비스, 네트워크 확장 프로그램이 설치되어 있고 권한을 부여받았는지 살펴보세요. Windows 클라이언트는 시스템 서비스 설치가 필요할 수 있고, Linux에서는 서비스 권한이나 네트워크 관리 기능이 관련될 수 있습니다. macOS는 구현 방식에 따라 승인된 보조 프로그램이나 확장 프로그램을 사용합니다. 현재 프로젝트 문서에 따라 필요한 권한만 부여하세요. 원인을 찾는 대신 관리자 권한으로 계속 실행하지 마세요. 권한 설정 후 TUN을 다시 켜고 인터페이스, 라우팅, 시작 로그를 확인하세요.
Android 또는 iOS에서 VPN 연결을 설정할 수 없으면 어떻게 하나요?
모바일 클라이언트는 보통 시스템 VPN 인터페이스로 트래픽을 처리하며, 처음 연결할 때 시스템 권한을 허용해야 합니다. 먼저 다른 VPN, 광고 차단 앱, 방화벽 앱이 같은 기능을 사용 중인지 확인하고 기존 연결을 끊은 뒤 다시 시도하세요. Android에서는 상시 연결 VPN, VPN 없이 연결 차단, 백그라운드 배터리 제한도 확인해야 합니다. iOS에서는 기존 VPN 설정과 주문형 연결 설정을 살펴보세요. 권한 문제로 판단하기 전에 설정이 활성화되어 있고 그룹에 사용할 수 있는 노드가 있는지 확인하세요.
업데이트 및 트래픽 분배
사용 팁
사용자 설정을 보존하고 연결 상세 정보로 변경 결과를 확인하세요.
설정이 업데이트로 덮어쓰이지 않도록 구독 자동 업데이트를 어떻게 관리하나요?
구독 설정에서 적절한 업데이트 간격을 지정하고, 예약 작업을 실행하려면 클라이언트를 켜 두어야 하는지 확인하세요. 기기가 절전 상태이거나 네트워크가 제한되면 업데이트가 늦어질 수 있습니다. 원격 설정은 업데이트 시 전체가 교체되는 경우가 많아 직접 수정한 규칙이 사라질 수 있습니다. 사용자 설정을 계속 유지해야 한다면 클라이언트에서 지원하는 덮어쓰기, 병합, 규칙 확장 기능을 우선 사용하세요. 업데이트 전에 사용할 수 있는 설정을 복사해 두고, 업데이트 후 그룹 이름과 현재 선택 항목을 확인하세요. 제공업체가 노드를 삭제하거나 이름을 바꿨는지도 살펴보세요.
Clash 그룹은 수동 선택과 자동 선택 중 무엇이 좋은가요?
select 그룹은 출구를 직접 지정할 때 적합하고, url-test는 테스트 결과에 따라 노드를 선택하며, fallback은 설정 순서에 따라 사용할 수 있는 후보를 찾습니다. 각 방식은 설정에 지정된 테스트 주소와 간격, 후보 목록에 따라 작동하므로 이름이 비슷해도 동작이 같지는 않습니다. 먼저 규칙이 실제로 어느 그룹을 가리키는지 확인하고, 그 그룹 안에 다른 그룹이 중첩되어 있는지도 살펴보세요. 문제를 찾는 동안에는 확인된 노드 하나를 고정해 자동 전환 변수를 줄일 수 있습니다. 평소 사용으로 돌아갈 때는 자동 그룹의 후보 범위를 조정하세요.
Clash 규칙 분기가 예상한 정책을 적용하지 않는 이유는 무엇인가요?
규칙은 순서대로 평가되며 보통 처음 일치하는 규칙이 적용됩니다. 앞쪽의 포괄적인 규칙이나 기본 규칙이 먼저 처리하지 않았는지 확인하세요. 도메인 규칙은 코어가 도메인 정보를 얻을 수 있어야 하고, 프로세스 규칙은 플랫폼과 프로세스 식별 기능의 영향을 받습니다. 먼저 연결 상세 정보에서 실제 대상, 적용 규칙, 출구를 확인한 다음 해당 규칙을 수정하세요. 설정에 규칙이 있다는 이유만으로 적용된다고 단정하지 마세요. 저장한 뒤 다시 불러오고 새 연결로 확인하세요. 원격 설정을 사용하는 경우에는 덮어쓰기 기능으로 변경 사항을 보존하는 것이 좋습니다.
Fake-IP 때문에 LAN이나 일부 앱에 문제가 생기면 어떻게 조정하나요?
Fake-IP는 앱에 가상 주소를 전달하고, 이후 연결에서 코어가 해당 주소와 도메인을 연결합니다. 실제 서버 주소는 아닙니다. LAN 기기나 특정 앱, 도메인 조회에 호환성 문제가 생기면 해당 요청이 코어에 들어오는지, 어떤 DNS를 사용하는지 먼저 확인하세요. 호환되지 않는다고 확인된 도메인은 현재 코어의 문법에 맞춰 fake-ip-filter에 추가한 뒤 클라이언트 안내에 따라 설정을 다시 불러오고 관련 DNS 캐시를 지우세요. 모든 도메인을 필터 목록에 넣지는 마세요. DNS 모드를 바꾸기 전에는 설정을 백업하고 기존 값을 기록해 두세요.
구독과 노드 정보를 보호하면서 로그를 내보내려면 어떻게 하나요?
문제가 발생한 시각, 시스템 버전, 클라이언트와 코어 정보를 먼저 기록하세요. 문제를 재현할 수 있는 수준으로 로그 단계를 잠시 높이고, 보통 info부터 확인하면 됩니다. 문제 발생 시각 전후의 필요한 부분만 내보내고, 제출 전에 구독 URL, 토큰, 인증 정보, 노드 주소, 개인적으로 접속하는 도메인이 포함되어 있는지 확인하세요. 전체 설정 파일이나 구독 화면 전체를 그대로 공개하지 마세요. 점검이 끝나면 평소 로그 단계로 되돌리고 재현 과정에서 만든 민감한 사본을 삭제해 불필요한 접속 정보가 오래 남지 않게 하세요.
오류 및 복구
문제 해결
구독 요청, 노드 연결, 로컬 트래픽 처리를 구분해 확인하세요. 원인을 찾는 대신 반복해서 재설치하지 마세요.
구독 업데이트 실패가 만료 때문인지 네트워크 오류 때문인지 어떻게 구분하나요?
먼저 링크가 온전한지, 불필요한 공백이 없는지 확인한 다음 업데이트 로그를 살펴보세요. 401이나 403은 인증 정보 또는 접근 권한 문제인 경우가 많고, 404는 주소가 변경되었을 수 있으며, 429는 요청 횟수 제한을 뜻합니다. 단, 상태 코드만으로 단정하지 말고 제공업체 안내도 확인하세요. 연결 시간 초과가 발생하면 현재 네트워크와 DNS, 구독을 내려받을 때 사용하는 출구를 점검하세요. 로그인 페이지나 오류 페이지가 반환되면 클라이언트에서 파싱 오류가 발생할 수 있습니다. 업데이트를 연속해서 반복하지 말고 서비스 이용 기간을 확인한 뒤 제공업체 안내에 따라 링크를 다시 발급받거나 가져오세요.
노드가 시간 초과되거나 dial tcp timeout이 표시되면 무엇부터 확인해야 하나요?
먼저 다른 프록시 도구를 끄고 기본 네트워크가 작동하는지 확인한 다음 노드 하나를 고정해 명확한 테스트 주소에 접속하세요. 로그에서 실패한 대상을 확인하세요. 노드 서버 주소에서 실패했다면 노드 상태와 도메인 확인, 포트, 로컬 네트워크 제한을 점검하고, 대상 사이트에서 실패했다면 출구 정책을 확인하며 원인을 좁히세요. 노드와 네트워크를 각각 바꿔 교차 테스트하되 한 번에 변수 하나만 바꾸세요. 노드 하나가 시간 초과되었다고 구독 전체가 만료된 것은 아닙니다. 시간 초과를 없애려고 시스템 방화벽을 끄지도 마세요.
Clash를 종료한 뒤 인터넷이 안 되면 시스템 프록시와 라우팅을 어떻게 복구하나요?
가능하면 원래 사용하던 클라이언트를 다시 열고 시스템 프록시와 TUN을 끈 다음 정상적으로 종료해 네트워크가 복구되는지 확인하세요. 앱을 실행할 수 없다면 운영체제의 프록시 설정에서 남아 있는 로컬 프록시를 지우고 수동 DNS나 VPN 설정이 남아 있는지도 확인하세요. 회사 네트워크에서 필요한 프록시나 DNS는 삭제하지 마세요. 확실하지 않다면 기존 값을 먼저 기록해 두세요. 프록시 도구를 여러 개 사용했다면 각각의 트래픽 처리 상태를 확인하세요. 필요하면 네트워크에 다시 연결하고 DNS 캐시를 비운 뒤, 복구 후 클라이언트를 하나씩 실행해 확인하세요.
Windows UWP 앱이 인터넷에 연결되지 않을 때 루프백 예외가 필요한가요?
AppContainer 격리 환경에서 실행되는 일부 앱은 로컬 루프백 프록시에 직접 접속하지 못할 수 있습니다. 브라우저가 연결되더라도 해당 앱은 실패할 수 있습니다. 먼저 문제가 발생한 앱이 시스템 프록시를 실제로 사용하는지 확인하세요. 그런 다음 클라이언트의 UWP 루프백 도구에서 앱 목록을 확인하고 로컬 프록시에 접속해야 하는 앱에만 예외를 설정하세요. 관리자 권한이 필요할 수 있으며, 설정 후 대상 앱을 다시 시작하세요. 모든 스토어 앱이 같은 네트워크 방식을 사용하는 것은 아닙니다. 계속 문제가 발생하면 모든 앱에 예외를 적용하는 대신 해당 앱의 별도 프록시, DNS, 로그를 확인하세요.
GeoIP 업데이트 실패와 시작 시 포트 사용 중 오류는 각각 어떻게 해결하나요?
GeoIP 업데이트가 실패하면 로그에서 다운로드 주소와 네트워크 오류, 파일 접근 권한을 확인하세요. 설정이 GeoIP 데이터베이스를 사용하는지, 다른 지리 규칙 데이터 형식을 사용하는지도 확인해야 합니다. 서로 다른 데이터 파일을 임의로 바꿔 사용할 수는 없습니다. 로그에 address already in use가 표시되면 로컬 포트 바인딩에 실패한 것입니다. 다른 클라이언트나 중복 실행된 코어가 있는지 확인하세요. 중복 프로세스를 종료하거나 수신 포트를 변경하고 시스템 프록시 설정에도 반영하세요. 두 오류는 서로 다른 단계의 문제이므로 구독을 반복해서 가져오지 마세요.