운영체제에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 규칙 기반 라우팅, 프록시 설정을 차례로 진행하세요.
설정 화면은 예시이며 실제 화면과 다를 수 있습니다. 포트는 사용 중인 클라이언트 설정을 확인하세요. Clash Verge Rev는 데스크톱용이며, 모바일에서는 해당 플랫폼에 맞는 클라이언트를 사용하세요.
먼저 ‘트래픽이 코어로 어떻게 들어오는지’와 ‘들어온 트래픽에 어떤 규칙을 적용하는지’를 구분하세요. 시스템 프록시와 TUN 모드는 트래픽을 가져오는 경로를 제어하고, 규칙·글로벌·직접 연결은 처리 방식을 정합니다. 두 설정은 서로 다른 기능입니다.
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,PROXYPROXY는 예시 정책 그룹 이름입니다. 설정에 해당 그룹을 정의해야 합니다.
규칙 기반 라우팅은 도메인이나 대상 주소 등의 조건에 따라 연결 경로를 정하므로, 로컬 서비스와 프록시가 필요한 웹사이트를 함께 이용할 때 유용합니다. 클라이언트의 프록시 모드에서 ‘규칙’을 선택한 다음 규칙 화면에서 적용 순서를 확인하세요. 코어는 위에서 아래로 규칙을 확인하며, 처음 일치하는 규칙이 적용되면 이후 규칙은 처리하지 않습니다. LAN 직접 연결 규칙은 일반적으로 기본 규칙보다 앞에 둡니다. 예시의 PROXY는 설정에 정의된 정책 그룹이어야 합니다. 그룹 정의 없이 규칙만 복사하면 작동하지 않습니다. 글로벌 모드에서는 모든 연결에 글로벌 정책을 적용하므로 이 규칙 목록에 따라 분기하지 않습니다. TUN은 트래픽을 가져오는 경로만 바꾸며 규칙을 대체하지 않습니다.
모드 선택 방법 보기 →TUN 모드는 가상 네트워크 인터페이스로 트래픽을 가져오므로 시스템 프록시를 따르지 않는 앱에 적합합니다. 먼저 클라이언트 안내에 따라 서비스를 설치하거나 권한을 허용한 뒤 설정에서 TUN을 켜세요. 코어 지원 여부에 따라 stack은 mixed, system, gvisor 중에서 선택할 수 있습니다. auto-route는 라우팅을 설정하고 dns-hijack은 조건에 맞는 DNS 요청을 가로챕니다. 가상 인터페이스만 켜고 DNS 처리 경로를 확인하지 않으면 문제가 생길 수 있습니다. 시스템 프록시와 달리 TUN은 시스템 라우팅에 영향을 주므로 다른 VPN과 충돌할 수 있습니다. 문제가 발생하면 다른 트래픽 제어 도구를 먼저 끄고 규칙 모드는 유지한 채 매칭 결과를 확인하세요.
TUN 및 라우팅 문제 해결 방법 보기 →주소 형식만 보여 주는 예시이며 실제 구독 링크가 아닙니다.
구독 관리는 원격 설정을 가져와 로컬에 저장하는 기능이며, 네트워크 프록시를 켜는 기능은 아닙니다. 구독 페이지에 서비스 제공자가 안내한 전체 주소를 붙여 넣고 가져온 뒤 해당 설정을 선택하세요. 그다음 자동 업데이트 간격을 설정하면 됩니다. 예시에서는 하루에 한 번 업데이트하지만, 실제 주기는 제공자의 제한을 따르세요. 구독 링크에 접근 자격 정보가 포함될 수 있으므로 스크린샷이나 공개 로그에 노출하지 마세요. 업데이트에 실패하면 응답이 설정 파일인지, 로그인 페이지나 오류 페이지인지 먼저 확인하세요. 기존 설정을 사용할 수 있어도 원격 링크가 유효하다는 뜻은 아닙니다. 사용자 지정 규칙은 덮어쓰기 또는 병합 기능으로 저장해야 다음 업데이트 때 수동 변경 사항이 사라지지 않습니다.
자동 업데이트 안내 보기 →우회 주소 형식은 운영체제에 따라 다릅니다.
시스템 프록시는 로컬 프록시 주소를 운영체제 설정에 등록해, 해당 설정을 따르는 브라우저 등의 앱이 혼합 포트에 연결하도록 합니다. 클라이언트 설정에서 켠 뒤 시스템에 표시된 주소와 포트가 코어의 수신 설정과 일치하는지 확인하세요. 우회 주소는 어떤 대상에 프록시를 적용하지 않을지 운영체제에 지정합니다. 코어가 받은 트래픽에 적용하는 직접 연결 규칙과는 서로 다른 단계입니다. 터미널 프로그램, 게임, 자체 프록시 설정이 있는 앱은 시스템 프록시를 따르지 않을 수 있으므로 별도로 설정하거나 TUN을 사용해야 합니다. 클라이언트를 종료하기 전에는 정상적으로 종료하고 시스템 프록시 설정이 복원됐는지 확인하세요. 그렇지 않으면 앱이 더 이상 연결되지 않는 로컬 포트에 접속할 수 있습니다.
시스템 프록시 자주 묻는 질문 보기 →혼합 포트는 앱이 프록시에 연결하는 진입점이고 외부 제어 주소는 클라이언트 화면에서 코어를 관리하는 데 사용합니다. 두 주소는 서로 바꿔 쓸 수 없습니다. 혼합 포트를 변경했다면 브라우저 프록시 확장 프로그램, 터미널 환경 변수, 프록시 주소를 직접 입력한 다른 프로그램도 함께 확인하세요. 설정 창의 스위치는 기능 설정을 보여 주는 예시이며, 현재 기기에서 해당 기능이 켜져 있다는 뜻은 아닙니다.
웹페이지가 열리지 않으면 먼저 설정이 선택됐는지, 코어가 정상적으로 시작되는지 확인한 다음 시스템 프록시나 TUN이 트래픽을 가져오는지 살펴보세요. 이어서 연결에 적용된 규칙과 정책 그룹을 확인하고 마지막으로 DNS를 점검합니다. 한 번에 한 항목만 바꾸고 다시 테스트해야 원인을 파악할 수 있습니다. 글로벌 모드로 전환하면 규칙 분기 문제를 확인하는 데 도움이 될 수 있지만, 포트 충돌이나 잘못된 구독, 시스템 DNS 오류를 해결해 주지는 않습니다.
운영체제에 맞는 다운로드 센터로 이동한 뒤 프로세서 아키텍처와 시스템 요구 사항을 확인하세요. 클라이언트는 그래픽 인터페이스를 제공하고 코어는 연결과 규칙 처리를 담당합니다. 같은 설정을 다른 클라이언트로 옮길 수 있는지는 대상 클라이언트가 지원하는 필드와 기능에 따라 달라집니다.
먼저 Clash Plus를 확인하고, Clash Verge Rev, FlClash, Clash Nyanpasu도 선택할 수 있습니다. 설치 전에 시스템 아키텍처를 확인하세요. 처음 사용할 때는 일반 시스템 프록시를 설정한 뒤 필요한 경우 TUN 서비스를 활성화하세요.
Clash for Windows는 더 이상 유지 관리되지 않습니다. 기존 설정을 옮길 때는 구독 원본 주소와 사용자 지정 규칙을 유지하고 포트 및 서비스 모드를 다시 확인하세요. 새 클라이언트의 설정 디렉터리 전체를 그대로 덮어쓰지 마세요.
다운로드 페이지로 이동Apple Silicon용과 Intel용 설치 파일을 구분하세요. 다운로드 센터에서는 Clash Plus, Clash Verge Rev, FlClash를 확인할 수 있으며, ClashX Meta의 유지 관리 상태도 별도로 안내해 기존 클라이언트에서 옮길 때 참고할 수 있습니다.
처음 실행할 때 시스템 권한이 필요하면 먼저 설치 출처를 확인한 뒤 시스템 안내에 따라 진행하세요. 시스템 프록시는 네트워크 서비스별로 적용되므로 유선과 무선 네트워크를 전환한 뒤 네트워크 설정으로 돌아가 클라이언트와 프록시 설정이 일치하는지 확인할 수 있습니다.
다운로드 페이지로 이동사용 방식에 따라 Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 설정 형식의 호환성을 확인하세요. 구독 주소가 열리는 것만으로 모든 클라이언트에서 사용할 수 있다고 판단해서는 안 됩니다.
처음 연결할 때 VPN 권한이 필요한 경우가 많습니다. 화면을 잠근 뒤 연결이 끊긴다면 시스템의 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 다른 VPN이 실행 중이면 먼저 종료한 다음 현재 클라이언트의 트래픽 제어가 제대로 작동하는지 테스트하세요.
다운로드 페이지로 이동다운로드 센터에서 Clash Plus의 App Store 페이지로 이동하거나 공식 웹사이트 clashplus.io에서 제품 정보를 확인하세요. 설치 후 호환되는 설정을 가져오고 시스템 안내에 따라 VPN 설정 추가를 허용하세요.
모바일 기기의 트래픽 제어 방식은 운영체제의 네트워크 확장 기능에 따라 달라지므로 데스크톱의 서비스 설치, 혼합 포트, 시작 시 자동 실행 절차를 그대로 적용할 수 없습니다. 연결 전에 현재 설정과 정책을 확인하고 앱에서 대상에 정상적으로 접속할 수 있는지 테스트하세요.
다운로드 페이지로 이동데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식을 사용하세요. 서버와 라우터에서는 보통 mihomo 코어를 직접 실행하며 설정 디렉터리, 서비스 시작, 트래픽 전달 규칙을 직접 관리해야 합니다.
그래픽 클라이언트에서 시스템 프록시를 켜도 모든 명령줄 도구가 이를 사용하는 것은 아닙니다. 터미널에서는 프로그램이 지원하는 프록시 환경 변수를 설정할 수 있습니다. TUN을 사용할 때는 권한, 라우팅, DNS도 확인해 기존 네트워크 관리 서비스가 중복으로 트래픽을 가져오지 않도록 하세요.
다운로드 페이지로 이동어떤 클라이언트를 선택할지 모르겠다면 먼저 플랫폼, 설정 형식, TUN 필요 여부를 정한 뒤 인터페이스와 설정 관리 방식을 비교하세요. 기존 클라이언트 이름을 코어 이름으로 혼동하지 마세요. 같은 Clash 생태계의 앱이라도 코어 구현 방식과 업데이트 주기가 다를 수 있습니다.
모든 클라이언트 보기 → 클라이언트 선택 가이드 읽기 →처음 설정할 때는 재현 가능한 연결 경로 하나를 먼저 완성한 뒤 자동 업데이트, 시작 시 자동 실행, 사용자 지정 규칙을 추가하세요. 클라이언트를 설치했다고 해서 바로 사용할 수 있는 설정이 있는 것은 아닙니다. 이 사이트의 설치 안내에서는 프록시 서비스 구독을 제공하지 않습니다.
구독 또는 설정 페이지를 열고 제공자가 안내한 전체 링크를 붙여 넣으세요. 가져오기가 끝나면 해당 설정을 직접 선택합니다. 로컬 YAML 파일을 가져왔다면 파일 인코딩과 들여쓰기가 올바른지 먼저 확인하세요. 설정 이름이 표시된 뒤에도 코어가 정상적으로 불러왔는지 확인해야 합니다. 구문 오류나 존재하지 않는 정책 그룹 참조는 시스템 프록시를 켰다 껐다 해도 해결되지 않습니다.
일상적으로 사용할 때는 먼저 규칙 모드를 선택하고 실제 정책 그룹에서 원하는 연결 경로를 지정한 다음 시스템 프록시를 켜세요. 시스템 프록시를 따르지 않는 앱을 사용할 때만 TUN을 추가로 설정하면 됩니다. 글로벌 모드와 TUN은 서로 다른 기능이므로 반드시 함께 켤 필요는 없습니다. 프록시 클라이언트를 여러 개 동시에 실행한다면 다른 클라이언트의 시스템 프록시와 가상 네트워크 인터페이스를 종료해 포트 및 라우팅 충돌을 줄이세요.
프록시가 필요한 웹사이트와 로컬 네트워크 서비스를 각각 방문하고 연결 기록에서 적용된 규칙과 정책을 확인하세요. 특정 앱에서만 실패한다면 먼저 해당 앱의 프록시 설정을 확인합니다. 모든 앱에서 실패한다면 포트, 트래픽 제어, 규칙, DNS 순으로 점검하세요. 정상 작동을 확인한 뒤 구독 업데이트 간격을 설정하고 사용자 지정 덮어쓰기 설정을 보관하면 업데이트하거나 옮길 때 복구하기 쉽습니다.
프로젝트 이름, 코어 구현, 클라이언트 인터페이스를 구분해야 설정 호환성과 업데이트 범위를 파악할 수 있습니다. 아래 저장소 명령은 mihomo 소스 코드를 확인하는 명령이며 클라이언트를 설치하거나 구독을 가져오는 명령이 아닙니다.
Clash 생태계에는 코어, 데스크톱 인터페이스, 모바일 앱이 포함되며 하나의 설치 파일로 모든 시스템을 지원하는 것은 아닙니다. 초기 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티에서는 다른 인터페이스와 코어 구현을 계속 개발하고 있습니다. Clash for Windows의 개발 중단이 생태계 전체의 업데이트 중단을 뜻하거나, 기존 클라이언트가 새 프로토콜을 자동으로 지원한다는 뜻은 아닙니다. 클라이언트를 선택할 때는 이름이 익숙한지만 비교하지 말고 현재 프로젝트의 유지 관리 상태를 확인하세요.
mihomo는 설정 파싱, 프로토콜 연결, 규칙 매칭, DNS 처리를 담당합니다. Clash Verge Rev 같은 그래픽 클라이언트는 mihomo를 기반으로 구독 관리, 설정 화면, 시스템 연동 기능을 제공합니다. 기능을 사용할 수 있는지는 코어가 지원하는지뿐 아니라 클라이언트에서 해당 설정을 제공하는지도 확인해야 합니다. 데스크톱 인터페이스의 버튼 위치가 설정 규격 그 자체는 아닙니다. 다른 클라이언트의 가이드를 참고할 때는 같은 메뉴를 기계적으로 찾기보다 설정 필드의 의미를 확인하세요.
오픈 소스 저장소에서 구현, 커밋 기록, 알려진 문제를 확인하면 동작이 설정 오류 때문인지 기능 제한 때문인지 파악하는 데 도움이 됩니다. 이슈 내용을 살펴볼 때는 운영체제, 코어, 클라이언트를 구분하세요. 문제를 제보할 때는 오류 유형, 재현 단계, 민감한 정보를 삭제한 설정을 준비하되 구독 링크, 접근 자격 정보, 개인 네트워크 정보는 제거해야 합니다. 공개 로그에는 문제 진단에 필요한 내용만 남기고 전체 설정을 그대로 게시하지 마세요.
클라이언트 업데이트는 인터페이스, 시스템 연동, 포함된 코어를 변경합니다. 구독 업데이트는 서비스 제공자의 원격 설정을 가져옵니다. 업데이트 경로와 실패 원인은 서로 다릅니다. 클라이언트를 바꾸기 전에 기존 혼합 포트, TUN 설정, 사용자 지정 규칙을 기록하세요. 구독을 업데이트하기 전에는 로컬 변경 사항을 병합 또는 덮어쓰기 설정에 저장했는지 확인합니다. 업데이트가 끝난 뒤에는 성공 메시지만 확인하기보다 실제 적용된 설정을 다시 살펴야 이전이 제대로 완료됐는지 알 수 있습니다.
증상에 따라 점검 순서를 정한 뒤 해당 설정을 확인하세요. 구독 파싱 실패, DNS 이상, 연결됐지만 웹페이지가 열리지 않는 문제는 서로 다른 단계에서 발생하므로 클라이언트를 반복해서 재설치하는 방식으로 해결할 수 없습니다.
링크 형식과 응답 내용부터 확인한 뒤 YAML 문법과 서버 상태를 점검하세요. 응답이 비어 있는 경우, 로그인 페이지가 반환된 경우, 필드가 호환되지 않는 경우를 구분해 구독 문제를 클라이언트 설치 실패로 오해하지 않도록 합니다.
문서 읽기 →DNS 업스트림, 대체 서버 선택, 강화 모드가 각각 어떤 역할을 하는지 설명합니다. 트래픽 제어 방식에 따라 DNS 가로채기를 이해하고 요청이 실제로 어떤 DNS 서버로 전달되는지 확인한 다음 관련 설정 필드를 조정하세요.
문서 읽기 →시스템 프록시, 포트 충돌, 프록시 모드, 규칙 매칭, DNS 순으로 원인을 좁혀 가세요. 각 단계에서는 조건 하나만 바꾸고 같은 대상에 다시 접속해 문제를 재현하며, 원인을 파악하는 데 필요한 로그만 보관하세요.
문서 읽기 →증상에 따라 차례대로 문제를 해결하려면 문제 해결 매뉴얼을 확인하세요. 처음 연결을 설정하려면 구독 가져오기 가이드를 따라 하면 됩니다. 기본 개념과 자주 발생하는 설정 문제는 도움말 센터에서 확인할 수 있어, 관련 용어를 이해한 뒤 설정을 변경하는 데 유용합니다.