오픈 소스 프록시 생태계 · 플랫폼별 설정 안내
Windows, macOS, Android, iOS, Linux 클라이언트를 한곳에서 확인하고 구독 가져오기, 시스템 프록시, 규칙 분기를 단계별로 설정하세요. TUN 권한, DNS 설정, 연결 로그 등 자주 사용하는 설정 항목도 함께 다룹니다.
플랫폼별 작업 흐름
Clash 클라이언트마다 화면은 다르지만 설정 흐름은 대체로 같습니다. 먼저 사용할 설정을 확보하고, 프록시 모드와 정책 그룹을 확인한 다음 시스템 프록시 또는 TUN을 켭니다. 아래에서는 실제 사용 순서에 따라 핵심 단계 다섯 가지를 설명합니다.
구독 URL은 일반적으로 서비스 제공업체가 생성하며, 클라이언트는 이를 요청하고 해석해 설정을 저장합니다. 가져올 때는 클라이언트의 구독 또는 설정 메뉴를 사용하고, 노드 이름이나 규칙 편집기처럼 관련 없는 입력란에 URL을 붙여 넣지 마세요. 업데이트가 끝나면 프록시 목록과 정책 그룹이 표시되는지 먼저 확인한 뒤 노드를 선택합니다. 목록이 비어 있다면 시스템 프록시를 반복해서 전환하기보다 구독 응답, 설정 형식, 클라이언트 로그를 우선 확인해야 합니다.
규칙 모드는 설정 파일의 위에서 아래 순서로 도메인, IP, 프로세스 또는 규칙 집합을 매칭합니다. 처음 일치한 규칙이 트래픽을 어느 정책 그룹으로 보낼지 결정합니다. 평소에는 구독에 포함된 규칙을 우선 유지하고, 매칭 대상을 명확히 알고 있을 때만 사용자 규칙을 추가하는 것이 좋습니다. 전역 모드는 노드 사용 가능 여부를 짧게 확인할 때 유용하지만 세밀한 분기를 우회합니다. 직접 연결 모드는 문제가 프록시 경로에서 발생했는지 판단할 때 사용합니다.
시스템 프록시를 켜면 클라이언트가 운영체제 설정에 로컬 프록시 주소를 기록하고, 브라우저와 대부분의 데스크톱 앱은 이를 통해 트래픽을 전달합니다. 권한 요구가 비교적 낮고 언제든 끌 수 있어 첫 연결 테스트에 적합합니다. 일부 게임, 명령줄 도구, 자체 네트워크 스택을 사용하는 프로그램은 시스템 프록시를 무시할 수 있습니다. 이 경우 먼저 앱 자체에 프록시 설정이 있는지 확인한 뒤 TUN이 필요한지 판단하세요.
TUN 모드는 시스템 네트워크 계층에 가상 인터페이스를 만들어 시스템 프록시 설정을 읽지 않는 앱의 트래픽도 처리합니다. 활성화하려면 관리자 권한이 필요할 수 있으며, 다른 VPN, 가상 네트워크 인터페이스, 보안 소프트웨어 또는 기업 네트워크 정책과 충돌할 수 있습니다. 처음 설정할 때는 유사한 도구를 끄고 일반 시스템 프록시가 작동하는지 확인한 뒤 TUN을 켜세요. 이렇게 하면 노드 문제와 가상 인터페이스 문제를 분리해 판단할 수 있습니다.
로그는 문제가 발생한 단계에 따라 읽어야 합니다. 설정 해석 오류는 일반적으로 시작 또는 구독 업데이트 시 나타나고, DNS 오류에는 도메인 해석, 폴백 또는 시간 초과 정보가 표시됩니다. 연결 오류는 대상 주소, 정책 그룹, 핸드셰이크 과정과 관련된 경우가 많습니다. 문제를 해결할 때는 첫 번째 오류만 기록하면 되며 여러 옵션을 계속 바꿀 필요는 없습니다. 먼저 실행 가능한 설정으로 복구한 다음 사용자 지정 DNS, 규칙, TUN 설정을 하나씩 추가하면 어떤 변경으로 문제가 생겼는지 더 쉽게 찾을 수 있습니다.
클라이언트 다운로드
다운로드 페이지에는 플랫폼별 그래픽 클라이언트, 설치 패키지 형식, 시스템 요구 사항을 정리했습니다. 선택하기 전에 기기 아키텍처를 확인하세요. 기존 클라이언트를 사용하는 경우에는 원래 구독 URL과 사용자 지정 규칙을 보관한 뒤 마이그레이션하는 것이 좋습니다.
데스크톱 트레이, 시스템 프록시 전환, 규칙 관리 화면이 필요한 사용자에게 적합합니다. 다운로드 전에 운영체제 비트 수를 확인하고, 설치 후 구독을 가져와 정책 그룹을 선택한 다음 시스템 프록시를 켜세요. 기존 Clash for Windows 설정이 남아 있다면 마이그레이션 전에 구독 URL, 오버라이드 규칙, 포트 설정을 각각 백업해야 합니다.
다운로드 페이지로 이동macOS 설치 패키지는 Apple Silicon과 Intel 프로세서용을 구분해야 합니다. 처음 실행할 때 앱 출처, 네트워크 확장 또는 백그라운드 서비스 권한을 승인하라는 메시지가 나타날 수 있으며, TUN을 켤 때는 해당 시스템 구성 요소도 허용해야 합니다. 권한 설정을 마친 뒤에는 먼저 시스템 프록시로 구독과 노드를 확인하고 가상 인터페이스 설정을 진행하는 것이 좋습니다.
다운로드 페이지로 이동Android 클라이언트는 시스템 VPN 인터페이스를 통해 트래픽을 전환하며, 연결할 때 VPN 권한 승인 메시지가 표시됩니다. 백그라운드에서 클라이언트가 종료된다면 배터리 최적화, 백그라운드 실행, 알림 권한을 확인하세요. 구독을 가져온 뒤 정책 그룹을 선택하고 연결을 시작한 다음, 연결 기록에서 대상 앱이 프록시 경로로 들어갔는지 확인합니다.
다운로드 페이지로 이동iPhone과 iPad 클라이언트는 App Store에서 설치하며, 처음 연결할 때 VPN 설정 추가를 허용해야 합니다. 구독 업데이트, 정책 선택, 연결 상태 확인은 모두 클라이언트에서 처리합니다. 모바일 네트워크와 Wi-Fi의 동작이 다르면 노드만 바꾸지 말고 DNS, IPv6, 주문형 연결 설정을 각각 테스트해야 합니다.
다운로드 페이지로 이동Linux 사용자는 그래픽 인터페이스가 있는 클라이언트를 선택하거나 Mihomo 코어를 직접 실행할 수 있습니다. 데스크톱 환경에서는 시스템 프록시 적용 방식과 트레이 지원을 확인하고, 서버나 라우터 환경에서는 설정 파일 경로, 서비스 관리, 수신 주소, 방화벽 규칙을 이해해야 합니다. 명령줄로 배포하기 전에 포그라운드에서 한 번 실행해 설정이 정상적으로 해석되는지 확인한 뒤 서비스 관리자로 넘기세요.
다운로드 페이지로 이동오픈 소스 생태계와 유지 관리 범위
Clash는 처음에 YAML 설정, 규칙 매칭, 정책 그룹을 중심으로 한 프록시 사용 방식으로 발전했습니다. 원 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티가 관리하는 Mihomo 코어는 프로토콜, DNS, 규칙 집합, TUN 기능을 계속 확장하고 있습니다. 현재 많이 사용하는 데스크톱 및 모바일 클라이언트는 대체로 그래픽 인터페이스 역할을 하며, 설정 다운로드, 정책 전환, 시스템 프록시 관리, 실제 트래픽 처리를 위한 코어 호출을 담당합니다.
코어와 클라이언트의 관계를 이해하면 문제 해결이 쉬워집니다. 화면이 실행되지 않거나 트레이 메뉴가 비정상적이거나 시스템 프록시가 적용되지 않는 문제는 대개 클라이언트 계층에 속합니다. 설정 해석 실패, 규칙 불일치, DNS 폴백 이상, 연결 핸드셰이크 오류는 코어 또는 설정 계층에 더 가깝습니다. 두 구성 요소의 업데이트 주기도 다를 수 있으므로 클라이언트를 바꿀 때는 화면만 비교하지 말고 코어 유형, 설정 호환 범위, 시스템 권한 요구 사항도 확인해야 합니다.
오픈 소스 저장소에는 소스 코드, 이슈 기록, 릴리스 노트가 공개되어 있어 기능 변경과 알려진 문제를 확인할 수 있습니다. 이 사이트의 문서는 특정 화면 위치를 영구적인 규칙으로 고정하지 않고 안정적인 작업 흐름을 중심으로 설명합니다. 클라이언트가 업데이트되면 버튼 이름은 바뀔 수 있지만 “설정 가져오기, 정책 선택, 트래픽 전환, 로그 확인” 순서는 여전히 적용됩니다. 화면이 다를 때는 같은 스크린샷을 기계적으로 찾기보다 설정 이름과 기능 의미를 기준으로 찾아야 합니다.
설정 업데이트에서는 출처도 구분해야 합니다. 구독에 포함된 노드, 정책 그룹, 규칙은 설정 제공업체가 관리하며 클라이언트 업데이트가 구독 내용을 자동으로 수정해 주지는 않습니다. 클라이언트 업그레이드는 주로 화면, 코어 버전, 시스템 연동을 변경합니다. 문제가 생기면 최근 변화가 구독, 클라이언트, 운영체제 중 어디에서 비롯되었는지 먼저 판단한 뒤 설정 롤백, 서비스 재시작, 권한 확인 여부를 결정하면 불필요한 작업을 크게 줄일 수 있습니다.
자주 묻는 질문
대부분의 문제는 설정, 프록시 트래픽 전환, 네트워크 해석의 세 단계로 나누어 원인을 찾을 수 있습니다. 아래는 처음 사용할 때 권장하는 기본 확인 순서입니다.
Windows 사용자는 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu를 비교할 수 있습니다. 이전하기 전에 구독 URL과 사용자 지정 규칙을 저장하고, 새 클라이언트를 설치한 뒤 구독을 가져와 정책을 선택하고 시스템 프록시를 테스트하세요. 기존 설정에서 화면에 종속된 오버라이드 기능은 그대로 이전되지 않을 수 있으므로 새 클라이언트의 설정 방식에 맞춰 다시 구성해야 합니다.
가져오기에 성공했다는 것은 클라이언트가 설정 파일을 읽었다는 뜻일 뿐입니다. 정책 그룹에서 사용 가능한 노드를 선택하고 시스템 프록시 또는 TUN을 켜야 합니다. 그런 다음 연결 기록을 확인하세요. 요청이 전혀 없다면 트래픽이 전환되지 않은 것이고, 요청은 있지만 연결에 실패한다면 노드 상태를 확인해야 합니다. 요청이 DIRECT로 향한다면 모드와 매칭 규칙을 점검하세요. 빠른 시작 문서에 따라 항목별로 확인할 수 있습니다.
규칙 모드는 설정 파일 순서에 따라 요청을 매칭하고 해당 정책 그룹으로 트래픽을 전달하므로 일상적인 사용에 적합합니다. 전역 모드는 대부분의 트래픽을 하나의 프록시 정책으로 보내 노드 경로를 짧게 확인할 때 유용합니다. 직접 연결 모드는 프록시를 사용하지 않아 웹사이트나 앱에 직접 접속할 수 있는지 판단할 수 있습니다. 문제를 해결한 뒤에는 세밀한 분기를 장기간 우회하지 않도록 일반적으로 규칙 모드로 되돌리는 것이 좋습니다.
게임, 명령줄 프로그램 또는 특정 앱이 시스템 프록시 설정을 읽지 않을 때 TUN으로 네트워크 트래픽을 전환하는 방법을 고려할 수 있습니다. 활성화하기 전에 일반 시스템 프록시와 노드 연결이 정상인지 확인하고 충돌할 수 있는 VPN이나 가상 네트워크 인터페이스 도구를 끄세요. TUN에는 일반적으로 관리자 권한이 필요합니다. 활성화 후 전체 네트워크가 끊기면 먼저 TUN을 끈 다음 가상 인터페이스, DNS 가로채기, 라우팅 설정을 점검하세요.
설정 및 문제 해결 글
인증서 오류부터 TUN 트래픽 전환, DNS 유출까지 문제가 발생한 네트워크 계층별로 확인 방법을 정리했습니다. 여러 설정을 동시에 변경하지 않고도 원인을 찾을 수 있도록 구성했습니다.
시스템 시간, 브라우저 인증서 체인, 프록시 중간 계층, 네트워크 가로채기 네 가지 방향에서 HTTPS 오류 원인을 찾고, 영향 범위에 따라 정상 접속을 단계적으로 복구합니다.
전체 글 읽기 →TUN 가상 인터페이스가 시스템 프록시를 따르지 않는 트래픽을 처리하는 방식을 설명하고, 플랫폼별 권한 요구 사항, 활성화 순서, 일반적인 네트워크 충돌을 정리합니다.
전체 글 읽기 →브라우저 테스트와 시스템 조회로 DNS 출구를 확인하고, fake-ip, DNS 가로채기, 폴백 해석 설정을 함께 점검해 도메인 해석 경로를 파악합니다.
전체 글 읽기 →