플랫폼별 가이드 · 설치 및 설정 안내

Clash 플랫폼별
설치 및 설정 가이드

처음 설치한다면 빠른 시작 가이드를 따라 다운로드, 가져오기, 연결을 진행하세요. 이 페이지에서는 운영체제별 점검 절차를 정리했습니다. 권한 확인, 클라이언트 변경, 시작 시 자동 실행 설정은 물론, “구독을 가져왔는데도 인터넷에 연결되지 않는” 문제의 원인을 찾을 때도 참고할 수 있습니다.

클라이언트마다 메뉴 이름은 조금씩 다릅니다. 아래에서는 설정, 프록시, 환경설정, 로그 등 기능을 기준으로 안내합니다. 화면이 다르면 현재 사용 중인 클라이언트의 실제 메뉴를 확인하고, 예시 포트를 고정값으로 간주하지 마세요.

공통 준비 사항

클라이언트, 코어, 구독

Clash 생태계에서 클라이언트는 화면을 제공하고 설정을 저장하며 시스템 네트워크 기능을 호출합니다. 코어는 설정을 해석하고 규칙에 따라 연결을 처리합니다. 클라이언트를 다운로드했다고 바로 프록시 서비스를 이용할 수 있는 것은 아닙니다. 실제로 연결하려면 유효한 노드 설정이나 구독 링크, 그리고 해당 서비스를 사용할 수 있는 네트워크 환경이 필요합니다. 먼저 클라이언트 다운로드 페이지에서 플랫폼에 맞는 프로그램을 고른 뒤 서비스 제공업체에서 구독 링크를 받으세요. Windows, macOS, Android, iOS에서는 Clash Plus를 먼저 살펴보고, Linux에서는 Clash Verge Rev를 확인해 보세요. 이름이 비슷해도 같은 코어를 사용하는 것은 아닙니다. 설정 호환 여부는 실제 지원 프로토콜과 필드에 따라 달라집니다.

구독은 전체 Clash YAML 설정일 수도 있고, 노드만 포함하거나 서비스 제공업체가 지정한 형식으로 가져와야 할 수도 있습니다. 가져오기 전에 링크의 용도를 확인하세요. 계정 관리 페이지, 결제 페이지, 웹 공유 주소는 구독 링크가 아닙니다. 구독 링크에는 계정 식별 정보가 포함되는 경우가 많으므로 비밀번호처럼 안전하게 보관하세요. 문제를 문의할 때는 응답 상태와 오류 문구만 공유하고, 전체 주소를 공개 게시판에 올리지 마세요. 설정 화면을 공유할 때도 노드 비밀번호, 토큰, 관리 인터페이스 키를 가려야 합니다. 링크가 공개됐다면 서비스 제공업체의 관리 페이지에서 우선 재설정한 뒤 클라이언트의 기존 항목도 업데이트하세요.

시스템 아키텍처와 설치 범위

다운로드 전에 시스템 아키텍처와 설치 파일 형식을 확인하세요. Windows는 주로 x64와 ARM64, Mac은 Apple Silicon과 Intel을 구분해야 합니다. Android는 ARM64, ARM 또는 범용 패키지인지 확인하고, Linux는 배포판별 패키지 형식도 고려해야 합니다. 기기 외관만 보고 프로세서 아키텍처나 운영체제 비트를 판단할 수는 없습니다. 시스템 정보의 ‘정보’ 화면을 확인하거나 명령어를 실행하세요. 다운로드 페이지에 표시된 패키지만 이 사이트에서 제공하는 파일입니다. 특정 클라이언트가 해당 아키텍처를 지원하지 않는다면 기기에 맞는 다른 클라이언트를 선택하세요. 다른 플랫폼의 파일 이름을 바꿔 설치하려고 해서는 안 됩니다.

플랫폼설치 전 확인연결 관련 권한
Windows시스템 종류 및 설치 경로시스템 프록시, 서비스 또는 가상 네트워크 어댑터 권한
macOS칩 종류 및 보안 경고 출처보조 서비스 및 네트워크 설정 권한
Android패키지 아키텍처 및 설치 출처VPN 승인 및 백그라운드 실행
iOS스토어 호환성 및 기존 VPN 설정시스템 VPN 설정 승인
Linux배포판, 아키텍처, 실행 방식포트 수신, TUN 및 서비스 권한

구독 가져오기 및 첫 점검

클라이언트의 설정 또는 구독 화면에서 항목을 추가하고 URL 가져오기를 선택한 뒤 링크를 붙여 넣어 다운로드하세요. 가져오기가 끝나면 설정 이름, 업데이트 시간, 프록시 그룹이 표시되는지 확인하고 해당 설정을 현재 사용 항목으로 지정합니다. 일부 클라이언트는 항목 추가와 설정 활성화를 별도 단계로 처리합니다. 다운로드만으로는 현재 실행 중인 설정이 바뀌지 않을 수 있습니다. 로컬 파일을 가져왔다면 원본 파일을 백업해 두세요. 클라이언트가 생성한 실행 설정을 직접 수정하면 다음 업데이트 때 덮어써질 수 있습니다. 장기적으로 수정하려면 클라이언트에서 지원하는 오버라이드, 병합 또는 스크립트 기능을 사용하세요.

가져오기에 실패하면 기기 시간, 기본 네트워크 연결, 링크가 온전한지부터 확인하세요. 구독 서버가 웹 페이지를 반환하면 클라이언트에서 구문 분석 오류가 발생할 수 있습니다. 이는 노드 연결 여부와는 별개의 문제입니다. 모든 실패를 형식 문제로 단정하거나 계정 만료를 가리기 위해 코어를 계속 바꾸지 마세요. 먼저 구독이 유효한지 확인한 다음 클라이언트 로그에서 네트워크 오류나 필드 관련 안내를 살펴보세요. 구독 업데이트에 프록시가 필요한 환경이라면 기존에 작동하는 설정으로 먼저 연결하세요. 처음 설치해 연결할 방법이 없다면 서비스 제공업체가 허용하는 방식으로 설정 파일을 내려받아 로컬에서 가져오세요.

프록시 그룹, 모드 및 확인 순서

처음 연결할 때는 규칙 모드를 사용하고, 설정에 포함된 선택 그룹에서 사용 가능한 노드를 직접 고르는 것이 좋습니다. 전역 모드는 짧게 비교할 때 사용할 수 있지만, 원래 직접 연결되던 요청의 경로까지 바뀝니다. 직접 연결 모드에서는 프록시 노드를 사용하지 않습니다. 지연 시간 테스트는 테스트 대상 주소와의 연결 상태만 보여 줍니다. 모든 웹사이트에 접속할 수 있는지, 실제 다운로드 속도가 어떤지는 나타내지 않습니다. 먼저 익숙한 웹사이트를 열고 연결 기록에서 적용된 규칙과 출구를 확인하세요. 요청이 원하는 프록시 그룹을 거치는지 확인한 다음 지역, 프로토콜 또는 테스트 주소를 바꾸세요. 노드 선택 기준은 지연 시간·배율·지역·프로토콜 비교를 참고하세요.

Windows 설치 및 설정

다운로드, 설치 및 이전

Windows 다운로드에서 먼저 Clash Plus를 확인한 뒤 필요에 따라 Clash Verge Rev, FlClash, Clash Nyanpasu를 비교해 보세요. 다운로드 전에 ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하고, 다운로드 페이지에 실제로 제공된 설치 파일을 선택하세요. 설치할 때 대상 폴더와 권한 안내를 확인한 뒤 시작 메뉴에서 실행합니다. 포터블 패키지는 안정적인 로컬 폴더에 압축을 풀어 사용하세요. 압축 파일 미리보기에서 바로 실행하거나 자동 정리되는 임시 폴더에 두지 마세요. 보안 소프트웨어가 경고하면 파일 출처와 구체적인 동작을 먼저 확인하세요. 보안 기능 전체를 끄는 것은 권장하지 않습니다.

Clash for Windows는 유지 관리가 중단됐습니다. 보관용 패키지는 기존 환경을 확인할 때는 쓸 수 있지만 새 기기의 기본 선택지로는 적합하지 않습니다. 유지 관리 중인 클라이언트로 옮길 때는 구독 링크, 규칙 수정 사항, 프록시 그룹 선택을 먼저 백업한 뒤 기존 프로그램을 종료하고 시스템 프록시를 끄세요. 클라이언트마다 데이터베이스와 화면 설정이 호환되지 않을 수 있습니다. 일반적으로는 프로그램 폴더 전체를 복사하는 것보다 구독을 다시 가져오는 편이 안전합니다. 이전 설정에서 특정 스크립트나 필드를 사용했다면 새 코어의 지원 여부를 항목별로 확인하세요. 테마, 단축키, 시작 설정은 대개 다시 설정해야 합니다.

구독 가져오기 및 시스템 프록시

설정 페이지에서 구독을 추가하고 업데이트한 뒤 활성화하고, 프록시 페이지에서 규칙 모드와 사용할 노드를 선택하세요. 그런 다음 설정이나 홈 화면에서 시스템 프록시를 켜고 클라이언트에 표시된 수신 포트를 확인합니다. Windows 시스템 프록시는 시스템 프록시 설정을 따르는 프로그램에 주로 적용되며, 모든 네트워크 트래픽을 자동으로 처리하지는 않습니다. 브라우저에 별도의 프록시 확장 프로그램이 설치되어 있다면 시스템 설정을 덮어쓸 수 있습니다. 문제를 점검할 때는 먼저 브라우저가 시스템 프록시를 사용하도록 설정해 두 경로가 동시에 작동하지 않게 하세요. 다른 VPN, 가속기 또는 이전 클라이언트가 프록시 주소를 계속 변경할 수도 있으므로 먼저 종료한 뒤 확인하세요.

Windows의 네트워크 및 인터넷 설정에서 수동 프록시 주소가 로컬 기기를 가리키는지, 포트가 클라이언트와 일치하는지 확인할 수 있습니다. 주소가 로컬 기기로 설정돼 있는데 프로그램이 종료됐다면 브라우저는 존재하지 않는 서비스에 연결을 시도합니다. 인터넷이 완전히 끊긴 것처럼 보일 수 있습니다. 이때는 먼저 시스템 프록시를 꺼 기본 네트워크를 복구한 뒤 클라이언트를 다시 실행하세요. 브라우저에서 웹페이지가 열린다고 설정이 반드시 올바른 것은 아닙니다. 요청이 직접 연결됐거나 캐시를 사용했을 수도 있습니다. 클라이언트 연결 목록에서 새 요청에 적용된 규칙과 정책을 확인하면 실제 경로를 더 정확히 파악할 수 있습니다.

TUN, 서비스 모드 및 권한

시스템 프록시를 따르지 않는 소프트웨어까지 처리해야 한다면 클라이언트가 지원하는 경우 TUN을 활성화할 수 있습니다. 가상 네트워크 어댑터와 라우팅을 통해 트래픽을 처리하므로 일반 시스템 프록시보다 높은 권한이 필요한 경우가 많습니다. 클라이언트에 따라 보조 서비스를 먼저 설치하거나 관리자 승인이 필요할 수 있으니 현재 화면의 안내를 따르세요. 활성화한 뒤 로그에서 네트워크 어댑터 생성, 경로 추가, DNS 설정이 실패했는지 확인합니다. 전체 화면을 계속 관리자 권한으로 실행하는 것이 항상 최선은 아닙니다. 클라이언트에서 서비스 모드를 제공한다면 안내에 따라 설정하고 서비스가 정상적으로 시작되는지 확인하세요.

TUN과 다른 VPN을 동시에 실행하면 기본 경로를 두고 충돌할 수 있으며, 기업용 보안 소프트웨어가 가상 네트워크 어댑터를 제한할 수도 있습니다. 테스트 전에 기존 VPN과 네트워크 설정을 기록한 다음 트래픽을 처리하는 도구를 하나만 남기고 잠시 확인하세요. TUN을 켠 뒤 인터넷이 끊기면 먼저 TUN을 끄고 시스템 프록시가 작동하는지 확인한 다음 권한, 라우팅, DNS를 각각 살펴보세요. 시스템 프록시는 되지만 TUN만 안 되는 경우라면 구독을 다시 구매하거나 클라이언트를 반복해서 설치할 필요는 없습니다. 노드 연결은 정상이며 문제는 로컬 트래픽 처리 계층에 있을 가능성이 높습니다.

UWP 루프백 및 명령줄 프록시

Windows 앱 컨테이너에서 실행되는 일부 프로그램은 로컬 프록시 포트에 직접 연결하지 못해 브라우저는 되지만 스토어 앱은 실패할 수 있습니다. 먼저 해당 앱이 제한된 앱 컨테이너에서 실행되는지 확인한 뒤 클라이언트에서 제공하는 루프백 예외 도구를 고려하세요. 모든 앱의 접근을 한 번에 허용하지 말고 필요한 앱만 지정하세요. TUN도 다른 해결 방법이지만 클라이언트와 시스템 환경이 지원해야 하며 라우팅 확인도 필요합니다. 일반 데스크톱 프로그램, 브라우저 확장 프로그램 충돌, 앱 컨테이너 제한은 서로 다른 문제입니다. ‘스토어에서 설치한 프로그램’이라는 이유만으로 예외 설정이 필요하다고 단정하지 마세요.

명령줄 도구도 Windows 시스템 프록시를 반드시 읽는 것은 아닙니다. 아래 포트 번호를 클라이언트에 실제로 표시된 포트로 바꿔 로컬 HTTP 프록시를 명시적으로 테스트할 수 있습니다. curl.exe를 사용하면 일부 PowerShell 환경에서 같은 이름의 별칭과 혼동하는 일을 피할 수 있습니다. 명시적 프록시로는 성공하지만 일반 실행은 실패한다면 구독을 계속 수정하지 말고 해당 도구에서 지원하는 환경 변수나 설정을 확인하세요.

curl.exe --proxy http://127.0.0.1:7890 --head https://example.com

시작 시 자동 실행 및 종료 후 복구

수동 연결이 제대로 되는지 확인한 뒤 시작 시 자동 실행을 켜고, ‘클라이언트 시작’, ‘코어 시작’, ‘시스템 프록시 복구’가 각각 무엇을 의미하는지 확인하세요. 로그인 시 자동 시작이 시스템 서비스 시작을 뜻하는 것은 아니며, 보조 서비스가 설정 선택까지 대신해 주는 것도 아닙니다. 재부팅 후 트레이 아이콘, 현재 설정, 프록시 스위치를 확인하고 요청을 한 번 테스트하세요. 프로그램을 종료하기 전에 시스템 프록시와 TUN을 꺼 두는 것이 좋습니다. 특히 이전하거나 제거할 때 유의하세요. 제거 후 인터넷에 연결되지 않는다면 전체 네트워크 설정을 초기화하기 전에 남아 있는 시스템 프록시와 VPN 경로부터 확인하세요.

macOS 설치 및 설정

칩 종류 확인 및 첫 실행

‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 다음 macOS 다운로드에서 설치 파일을 선택하세요. 먼저 Clash Plus를 살펴보고 Clash Verge Rev와 FlClash도 대안으로 확인할 수 있습니다. ClashX Meta는 유지 관리가 중단됐으므로 보관된 환경에서 사용할 때 호환성에 유의하세요. Apple Silicon과 Intel용 설치 파일은 용량만으로 구분할 수 없습니다. 호환성 계층을 통해 다른 아키텍처의 프로그램을 실행할 수 있는지는 앱의 요구 사항에 따라 달라집니다. 네이티브 패키지가 있다면 해당 아키텍처용 패키지를 우선 사용하세요. 설치 전 기존 클라이언트를 종료해 메뉴 막대 프로그램 두 개가 동시에 포트를 수신하거나 프록시를 설정하지 않도록 하세요.

일반적으로 디스크 이미지를 열고 앱을 ‘응용 프로그램’ 폴더로 드래그한 뒤 실행합니다. 디스크 이미지에서 앱을 계속 실행하면 이미지를 분리하거나 재시동 또는 업데이트할 때 프로그램을 찾지 못할 수 있습니다. 처음 실행할 때 보안 안내가 표시되면 다운로드 출처를 확인한 뒤 시스템의 ‘개인정보 보호 및 보안’에서 허용 가능한 절차를 따르세요. 앱 하나 때문에 시스템 전체의 보안 기능을 끄지 마세요. 앱이 손상됐다는 안내가 나오면 온라인에서 찾은 일괄 제한 해제 명령을 바로 실행하지 말고 먼저 다시 다운로드해 시스템 호환성을 확인하세요. 해당 명령은 예상보다 넓은 범위의 파일에 영향을 줄 수 있습니다.

설정 활성화 및 네트워크 서비스 프록시

설정 페이지에서 구독을 가져온 뒤 현재 설정으로 선택하고 프록시 페이지에서 규칙 모드와 노드를 고르세요. 시스템 프록시를 켠 다음 현재 네트워크 서비스를 확인합니다. Wi-Fi, 유선 네트워크 어댑터, 도킹 스테이션 포트, 다른 네트워크 위치마다 프록시 설정이 다를 수 있습니다. 일부 클라이언트는 현재 서비스의 설정을 대신 바꿔 주지만 네트워크를 전환한 뒤에도 적용 상태를 확인하세요. 브라우저에서는 접속되지만 터미널에서는 실패한다면 두 프로그램이 시스템 프록시를 사용하는지 각각 확인하세요. 서로 다른 네트워크 경로의 결과를 같은 것으로 간주하지 마세요.

시스템 설정의 네트워크 세부 정보에서 웹 프록시, 보안 웹 프록시 또는 SOCKS 프록시가 클라이언트의 수신 기능과 일치하는지 확인하세요. 혼합 포트를 사용하면 HTTP와 SOCKS5 요청을 모두 받을 수 있지만, 시스템의 올바른 항목에 각 프로토콜을 입력해야 합니다. 주소는 보통 로컬 루프백 주소입니다. 구독 서버 주소를 입력하면 안 됩니다. 구독 주소는 설정을 가져오는 데 쓰이며 로컬 프록시 서비스가 수신하는 주소가 아닙니다. 클라이언트를 바꾼 뒤에는 특히 포트를 다시 확인하세요. 이전 소프트웨어의 기본값을 새 소프트웨어에도 그대로 적용하지 마세요.

보조 서비스 및 TUN 트래픽 처리

TUN 또는 강화된 트래픽 처리를 사용하려면 추가 네트워크 권한이 필요하며, 일부 클라이언트는 보조 서비스를 설치합니다. 권한을 승인하기 전에 권한을 요청하는 프로그램을 확인하고 방금 설치한 클라이언트에서 온 것인지 검증하세요. 승인 후 스위치가 바로 꺼진다면 로그에서 서비스 연결, 네트워크 어댑터 생성, 경로 정보를 확인하세요. 메뉴 막대에 실행 중이라고 표시돼도 보조 서비스가 정상 작동한다는 뜻은 아닙니다. 업데이트, 앱 위치 이전, 백업 복원 후에는 서비스와 메인 프로그램의 상태가 맞지 않을 수 있습니다. 클라이언트에서 제공하는 서비스 점검 및 복구 기능을 먼저 사용하세요.

회사 기기의 관리 정책은 프록시, 네트워크 확장 또는 보조 서비스를 제한할 수 있습니다. 이런 제한은 스위치를 반복해서 눌러 해결할 수 없습니다. 기기 관리 정책에서 허용하는 범위 내에서 클라이언트를 사용하세요. 다른 VPN, 가상 머신 소프트웨어, 컨테이너 네트워크도 경로를 추가할 수 있습니다. TUN을 켠 뒤 일부 네트워크 대역에서만 문제가 생기면 영향을 받는 대상 주소와 기존 경로를 먼저 살펴보세요. 시스템의 모든 경로를 바로 삭제하지 마세요. 다른 네트워크 처리 프로그램을 종료해 비교하면 문제를 재현할 근거를 남기고 기존 작업 환경도 복구하기 쉽습니다.

터미널, DNS 및 네트워크 전환

터미널 도구는 프록시를 명시적으로 지정해야 하는 경우가 많습니다. 아래 명령은 로컬 수신 상태와 요청 경로를 확인하는 용도이며 포트는 클라이언트 설정에 맞춰야 합니다. 두 번째 명령은 현재 시스템 프록시 정보를 조회할 뿐 설정을 바꾸지 않습니다. 요청이 성공하면 해당 도구에서 지원하는 방식으로 프록시를 설정하세요. 셸 설정 파일에 변수를 저장하면 이후 터미널 세션에도 영향을 줍니다. 먼저 현재 창에서 임시로 테스트하고 클라이언트 종료 시 변수를 어떻게 지울지 확인하세요. 그래야 개발 도구가 종료된 로컬 포트에 계속 연결하는 일을 막을 수 있습니다.

curl --proxy http://127.0.0.1:7890 --head https://example.com
scutil --proxy

Wi-Fi 전환, 휴대폰 핫스팟 연결, 절전 모드 복귀 후에는 클라이언트가 연결을 다시 수립해야 할 수 있습니다. 먼저 로컬 기본 네트워크를 확인한 뒤 코어와 프록시 스위치를 점검하세요. 도메인으로만 접속되지 않는다면 DNS 로그와 현재 네트워크의 이름 확인 설정을 확인합니다. 호텔이나 공용 네트워크에서는 웹 인증을 먼저 완료해야 할 수 있습니다. 이때 잠시 프록시를 끄고 인증 페이지를 연 다음 인증이 끝나면 다시 켜세요. 특정 네트워크에서 인증 페이지가 열리지 않는다고 모든 네트워크의 DNS를 장기간 변경하지 마세요. 국지적인 문제를 다른 환경까지 확산시킬 수 있습니다.

로그인 시 실행, 이전 및 제거

로그인 시 실행이 필요하다면 클라이언트 설정과 시스템 로그인 항목에서 실제 상태를 확인하세요. 창을 닫아도 화면만 숨겨질 수 있습니다. 완전히 종료하려면 보통 메뉴 막대에서 종료해야 합니다. 바탕 화면에 창이 보이는지가 아니라 코어와 수신 상태로 프록시가 계속 작동하는지 판단하세요. 다른 클라이언트로 옮기기 전에 구독과 로컬 규칙을 백업하고 기존 프로그램의 시스템 프록시를 끄세요. 제거할 때는 클라이언트가 제공하는 방식으로 보조 서비스를 삭제한 다음 현재 네트워크 서비스에 로컬 프록시 설정이 남아 있는지 확인하세요. 실제 잔여 설정이 확인된 경우에만 해당 항목을 처리하면 됩니다. 한 번의 소프트웨어 이전 때문에 네트워크 환경 전체를 다시 만들 필요는 없습니다.

Android 설치 및 설정

설치 패키지 아키텍처 및 클라이언트 선택

Android 다운로드에서 먼저 Clash Plus를 확인한 뒤 설정 요구 사항에 따라 Clash Meta for Android, FlClash, Surfboard를 선택하세요. ARM64 패키지는 해당 64비트 환경에, ARM 패키지는 해당 환경에 적합합니다. 범용 패키지가 제공된다면 아키텍처를 모르는 기기에서 선택할 수 있습니다. 하드웨어가 64비트를 지원한다고 해서 시스템에서 모든 ARM64 앱을 설치할 수 있는 것은 아닙니다. 구형 기기나 특수한 시스템은 실제 실행 환경도 확인해야 합니다. ‘설치할 수 없음’ 오류가 나면 같은 패키지의 이름을 바꿔 반복해서 설치하지 말고 시스템 호환성, 저장 공간, 서명 충돌부터 확인하세요.

설치 파일로 앱을 업데이트하려면 패키지 이름과 서명이 기존 앱과 일치해야 합니다. 다른 배포 분기나 서명으로 만든 패키지는 기존 앱 위에 설치되지 않을 수 있습니다. 앱을 제거하면 데이터도 함께 삭제될 수 있으므로 먼저 구독과 로컬 수정 사항을 백업하세요. 시스템에서 설치 출처 권한을 요청하면 설치 파일을 여는 데 실제로 사용하는 파일 관리자나 브라우저에만 권한을 부여하고 설치 후에는 회수할 수 있습니다. Android 제조사마다 메뉴 위치는 다르지만 확인할 항목은 출처 권한, 앱 호환성, 기존 설치 기록입니다. 모든 보안 안내를 끄지 마세요.

구독, 활성 설정 및 규칙

설정 페이지에서 원격 구독으로 링크를 추가하고 다운로드한 뒤 실행할 설정을 명확히 선택하세요. 다운로드가 끝나면 프록시 페이지를 열어 예상한 프록시 그룹과 노드가 표시되는지 확인한 다음 연결을 시작합니다. Clash Meta for Android와 FlClash는 메뉴 이름이 다를 수 있지만 진행 순서는 비슷합니다. 설정을 가져오고 활성 항목으로 지정한 뒤 정책을 선택하고 시스템 권한을 승인합니다. Surfboard의 설정 형식은 Clash YAML과 동일하지 않습니다. Surfboard를 사용할 때는 서비스 제공업체가 지원한다고 명시한 형식을 받아야 합니다. 호환되지 않는 파일을 가져온 뒤 모드만 바꿔 해결하려고 하지 마세요.

원격 업데이트는 보통 구독 내용을 바꿉니다. 로컬에서 바꾼 이름, 추가 규칙, 선택 상태가 유지되는지는 클라이언트 구현에 따라 다릅니다. 규칙을 계속 관리해야 한다면 클라이언트에서 지원하는 별도 오버라이드나 로컬 설정에 저장하고 업데이트 후 실제 적용 결과를 확인하세요. 서비스 제공업체가 프록시 그룹 이름을 바꾸면 기존 선택이 무효가 될 수 있습니다. 노드는 목록에 보이는데 예상한 출구를 사용하지 않는다면 현재 그룹 간 참조 관계부터 확인하세요. 노드 하나의 테스트 버튼만 확인하지 말고 최종 규칙이 해당 그룹을 가리키는지도 점검하세요.

VpnService 권한 승인 및 트래픽 처리 범위

Android에서는 보통 시스템 VpnService를 통해 트래픽을 클라이언트에 전달합니다. 처음 연결하면 VPN 연결 요청이 표시되며 승인 후 시스템에 열쇠 아이콘이나 VPN 상태 표시가 나타날 수 있습니다. 이는 시스템이 로컬 트래픽 처리 통로를 허용했다는 뜻이지 프록시 노드 연결이 성공했다는 뜻은 아닙니다. 승인을 거부했다면 다시 연결을 시작하면서 시스템 안내를 확인하세요. 기기에 업무 프로필, 관리 모드 또는 상시 연결 VPN 정책이 설정되어 있으면 새 연결 허용 여부는 시스템 정책에 따라 달라집니다. 정책 제한을 구독 형식 오류로 오해하지 마세요.

같은 사용자 환경에서는 일반적으로 활성 VpnService를 하나만 실행할 수 있습니다. 광고 차단기, 방화벽 또는 다른 VPN이 같은 연결 방식을 사용할 수 있습니다. 테스트할 때는 관련 앱을 먼저 끈 다음 현재 클라이언트를 실행하세요. 앱별 프록시 기능을 사용할 수 있다면 ‘선택한 앱만 프록시’와 ‘선택한 앱 제외’를 정확히 구분해야 합니다. 두 목록은 의미가 반대라 프록시를 써야 할 앱을 제외할 수 있습니다. 목록을 바꾼 뒤 다시 연결해야 적용되는 클라이언트도 있습니다. 확인할 때는 대상 앱을 다시 열고 새 연결 기록을 살펴보세요.

백그라운드 유지 및 화면 꺼짐 후 연결 끊김

앱 설치 직후 화면이 켜져 있을 때는 작동하지만 화면을 끄고 한동안 지나면 연결이 끊긴다면 배터리 최적화와 백그라운드 제한부터 확인하세요. 시스템의 앱 정보에서 백그라운드 활동을 허용하고 제조사별 메뉴에서 배터리 최적화 제외, 자동 시작, 백그라운드 잠금을 설정합니다. 이러한 옵션이 모두 있는 것은 아니며 어떤 상황에서든 앱을 항상 실행 상태로 유지한다고 보장할 수도 없습니다. 기기에서 실제로 어떻게 작동하는지 확인하세요. 시스템 알림의 포그라운드 서비스 안내는 지속 실행과 관련된 경우가 많습니다. 상태 표시를 숨기려고 필요한 알림을 임의로 비활성화하지 마세요. 백그라운드 제한과 알림 권한은 별개이므로 문제를 확인할 때 각각 기록하세요.

반복할 수 있는 테스트를 진행해 보세요. 연결한 시간과 화면을 끈 시점을 기록하고, 잠시 후 같은 앱을 열어 복구 여부를 확인한 다음 클라이언트 로그에서 재시작이나 네트워크 전환이 있었는지 살펴봅니다. 프로세스는 살아 있지만 모바일 네트워크에서만 실패한다면 데이터 사용 권한, 데이터 절약 모드, 네트워크 상태를 확인하세요. 프로세스가 종료됐다면 시스템의 앱 정리 문제일 가능성이 큽니다. 자세한 내용은 VpnService 권한 승인 및 배터리 최적화 제외 안내를 참고하되, 메뉴 위치는 현재 기기에 맞춰 찾으세요.

핫스팟 공유, DNS 및 연결 복구

휴대폰에 VPN 연결이 표시된다고 해서 핫스팟에 연결된 다른 기기도 같은 프록시를 사용한다는 뜻은 아닙니다. 핫스팟 트래픽은 앱의 VpnService 처리 범위에 포함되지 않을 수 있으므로 휴대폰 자체에서 접속된다는 이유만으로 공유가 성공했다고 판단하지 마세요. 태블릿에서 컴퓨터의 프록시를 사용하려면 LAN 공유 방식에 따라 태블릿의 프록시 주소와 포트를 설정하고 컴퓨터가 연결을 허용하는지 확인해야 합니다. Android 비공개 DNS, 브라우저의 보안 DNS, 클라이언트 DNS가 서로 다른 이름 확인 경로를 만들 수도 있습니다. 도메인 오류가 명확하게 나타날 때만 항목별로 비교하고 모든 DNS 기능을 한꺼번에 끄지 마세요.

종료, 제거 또는 이전 전에 현재 연결을 중지하고 시스템 VPN 페이지에 정리할 설정이 남아 있는지 확인하세요. 백업에는 필요한 구독과 로컬 규칙만 저장하고 계정 정보가 포함된 내보내기 파일을 공유 저장소나 자동 공개 폴더에 두지 마세요. 이전을 마친 뒤 앱별 프록시 범위와 백그라운드 권한을 다시 확인하세요. 기존 클라이언트의 시스템 권한은 새 클라이언트로 자동 이전되지 않는 경우가 많습니다.

iOS 설치 및 설정

스토어 설치 및 기기 호환성

iPhone과 iPad에서는 iOS 다운로드에서 Clash Plus 스토어 페이지를 열거나 Clash Plus App Store 정보를 직접 확인할 수 있습니다. 공식 웹사이트는 clashplus.io입니다. 제품 페이지를 확인할 때 이 도메인을 참고하세요. 설치 전에 스토어에 표시된 기기 및 시스템 호환성을 확인하세요. 시스템 요구 사항은 현재 스토어 정보를 기준으로 하며 다른 플랫폼 설치 파일의 요구 사항을 적용해서는 안 됩니다. 설치 후 앱을 먼저 실행하고 구독을 가져올 준비를 하세요. 시스템에 이미 VPN 설정이 있다면 기존 용도와 연결 상태를 기록해 두세요.

이 페이지에서는 기기의 클라이언트와 시스템 연결 설정을 다룹니다. 프록시 서비스를 이용하려면 여전히 유효한 설정이 필요합니다. 스토어에서 설치됨, 앱 실행 가능, 노드 연결 가능은 각각 별개의 점검 항목입니다. 앱이 열리지 않으면 기기 저장 공간, 시스템 호환성, 설치 상태를 확인하세요. 앱은 열리지만 구독 다운로드에 실패하면 링크와 네트워크를 점검합니다. 구독에 노드가 있는데 연결에 실패하면 권한과 노드 연결 경로를 확인하세요. 이 순서대로 원인을 찾으면 단순한 설치 문제를 계정이나 네트워크 전체를 다시 설정하는 문제로 키우지 않을 수 있습니다.

구독 가져오기, 업데이트 및 선택

Clash Plus에서 설정 또는 구독 메뉴를 찾아 현재 화면에서 제공하는 방식으로 원격 링크를 추가하세요. 붙여 넣기 전에 안내 문구가 아니라 전체 구독 주소를 복사했는지 확인합니다. 다운로드 후 설정이 활성화됐는지, 프록시 그룹이 표시되는지 살펴보세요. 화면에서 파일 가져오기를 지원한다면 서비스 제공업체가 제공한 호환 설정 파일을 사용할 수 있습니다. 링크가 반환하는 형식은 현재 클라이언트가 지원하는 형식과 일치해야 합니다. 이름에 Clash가 들어 있다고 모든 구독을 사용할 수 있는 것은 아닙니다. 특히 최신 프로토콜이나 특정 코어 전용 필드를 사용하는 설정은 주의하세요.

구독을 업데이트하기 전에 선택해 둔 프록시 그룹과 필요한 로컬 설정을 기록하세요. 업데이트로 노드 이름, 그룹 구성, 규칙이 바뀔 수 있으므로 업데이트 후 원래 의도한 출구가 계속 선택됐는지 확인합니다. 구독에 선택 그룹이 여러 개 있다면 홈 화면에서 지연 시간이 낮아 보이는 노드를 하나 고르는 데 그치지 말고 최종 요청이 어떤 그룹에 연결되는지 확인하세요. 자동 선택 그룹은 테스트 대상에 따라 출구를 바꿀 수 있습니다. 특정 지역이나 고정된 연결 방식을 원한다면 설정에 포함된 수동 선택 그룹을 사용하고 규칙에서 실제로 해당 그룹을 참조하는지 확인하세요.

VPN 권한 승인 및 연결 상태

처음 연결할 때 앱에서 VPN 설정 추가를 요청할 수 있으며 시스템에서 승인이나 기기 인증을 요구할 수 있습니다. 권한을 승인한 뒤 앱으로 돌아와 연결을 계속하고 시스템 설정에서 VPN 상태를 확인하세요. 이 시스템 메뉴는 트래픽 처리 권한을 부여하는 곳이지 프록시 서비스 제공업체에 계정 비밀번호를 제출하는 단계가 아닙니다. 승인 창이 나타나지 않거나 연결이 바로 끊기면 시스템에 다른 활성 VPN, 관리 정책 또는 확인 대기 중인 설정이 있는지 살펴본 뒤 앱의 오류 메시지를 확인하세요. 같은 구독을 반복해서 가져와도 시스템 권한 문제는 해결되지 않습니다.

iOS의 연결 경로는 데스크톱 시스템 프록시와 다르며 일반적으로 시스템에서 허용하는 네트워크 확장에 의존합니다. 아래에서 설명하는 데스크톱 TUN 스위치, 서비스 설치, 명령줄 환경 변수는 휴대폰에 그대로 적용하면 안 됩니다. 앱에서 온디맨드 연결, 규칙 또는 기타 네트워크 옵션을 제공한다면 현재 기능 안내에 따라 설정하세요. 활성화하기 전에 Wi-Fi, 셀룰러 네트워크, 기기 잠금 상태에서 어떻게 작동하는지 확인하세요. 기업 VPN이나 관리 설정이 있는 기기에서는 기기 관리 정책을 따라야 합니다. 두 트래픽 처리 도구를 동시에 실행하려고 업무에 필요한 설정을 삭제하지 마세요.

Wi-Fi, 셀룰러 네트워크 및 도메인 문제 해결

처음 확인할 때는 안정적인 Wi-Fi에서 규칙 모드와 사용 가능한 노드 하나를 선택한 뒤 대상 웹사이트를 열고 연결 기록을 확인하세요. 그다음 셀룰러 네트워크로 바꿔 같은 테스트를 진행합니다. 한 네트워크에서만 실패한다면 해당 네트워크의 기본 연결 상태와 앱의 셀룰러 데이터 사용 권한을 확인하세요. 두 네트워크에서 모두 실패하지만 다른 기기에서는 같은 노드가 정상이라면 현재 기기의 설정과 권한을 확인합니다. 네트워크를 바꾸면 기존 연결이 끊길 수 있으므로 잠깐 재연결되는 현상과 계속 인터넷이 되지 않는 상태를 구분해 기록하세요. 전환 직후 잠시 실패했다는 이유만으로 구독이 만료됐다고 판단해서는 안 됩니다.

공용 Wi-Fi에는 인증 포털이 있는 경우가 많으므로 먼저 기본 네트워크 인증을 마친 뒤 프록시를 켜세요. 프록시를 켠 뒤 인증 페이지가 열리지 않는다면 연결을 잠시 중지해 인증한 후 다시 연결하면 됩니다. 도메인 확인 문제는 클라이언트가 DNS 오류를 보고하는지, 관련 개인정보 보호나 네트워크 기능이 요청 경로에 영향을 주는지 확인하세요. ‘특정 웹사이트가 열리지 않는다’고 곧바로 시스템 DNS 문제라고 단정하지 마세요. 직접 연결 규칙이 적용됐거나 현재 출구에서 접속이 차단됐을 수 있습니다. 규칙 모드와 짧은 시간 동안의 전역 모드 결과를 비교하고 연결 로그를 확인하는 편이 시스템 설정을 반복해서 바꾸는 것보다 유용합니다.

백그라운드 연결 및 가정 내 기기 공유

앱 화면을 닫아도 이미 설정된 네트워크 확장이 계속 작동할 수 있습니다. 연결을 완전히 끊으려면 연결 스위치를 사용하거나 시스템 VPN 페이지에서 상태를 확인하세요. 앱을 강제 종료한 뒤 연결이 유지되는지는 현재 구현과 시스템 상태에 따라 다릅니다. 앱이 백그라운드에 표시되는지만으로 전체 트래픽 상태를 판단하지 마세요. 오랫동안 사용하지 않다가 다시 연결할 때는 VPN 상태부터 확인하고 구독이 여전히 유효한지 살펴보세요. 앱이나 시스템 업데이트 후 연결에 문제가 생기면 먼저 연결을 끊었다가 다시 시도하고 구체적인 오류 문구를 기록하세요. 설정이나 권한 문제가 명확한 경우에만 해당 항목을 수정하세요.

iPhone이나 iPad에서 컴퓨터의 프록시를 사용하려면 신뢰할 수 있는 LAN의 Wi-Fi 상세 설정에서 수동 HTTP 프록시를 지정하고 컴퓨터의 LAN 주소와 실제 수신 포트를 입력하세요. 이 방법은 해당 Wi-Fi 프록시 설정을 따르는 요청에만 적용됩니다. 모바일 클라이언트처럼 모든 트래픽을 처리하는 것은 아니며 보통 셀룰러 네트워크에는 적용되지 않습니다. 해당 네트워크를 벗어나기 전에 프록시 설정을 복구하세요. 그래야 다음에 연결할 때 전원이 꺼진 컴퓨터를 찾지 않습니다. 공유 범위와 방화벽에 관한 자세한 내용은 혼합 포트 및 LAN 공유 가이드를 참고하세요.

Linux 설치 및 설정

데스크톱 클라이언트와 명령줄 방식

Linux에서는 사용 환경에 맞춰 방식을 선택하세요. 데스크톱 사용자는 Linux 다운로드에서 Clash Verge Rev를 확인한 뒤 FlClash도 살펴볼 수 있습니다. 서버, 라우터 또는 스크립트로 관리할 환경이라면 코어 다운로드에서 mihomo를 선택하세요. 그래픽 클라이언트는 설정 관리와 사용자 인터페이스를 제공하지만, 명령줄 코어는 파일, 프로세스, 시스템 트래픽 처리를 직접 관리해야 합니다. 코어를 설치한다고 데스크톱 프록시가 자동으로 설정되는 것은 아닙니다. 시작하기 전에 uname -m을 실행해 아키텍처를 확인하고 배포판에서 지원하는 패키지 형식도 살펴보세요. DEB와 RPM은 서로 바꿔 쓸 수 있는 설치 파일이 아닙니다.

데스크톱 설치는 종속성과 제거 기록을 관리할 수 있도록 배포판의 패키지 관리 도구를 우선 사용하세요. 다운로드 페이지에 실제로 올라온 파일을 기준으로 시스템 소프트웨어 설치 프로그램에서 열거나 다운로드 폴더에서 패키지 관리자를 사용하세요. 출처를 알 수 없는 스크립트에 관리자 권한을 부여하지 마세요. 설치 후 프로그램이 시작되지 않으면 터미널에서 해당 실행 명령을 실행해 누락된 라이브러리나 그래픽 환경 오류를 확인하세요. 서버에 그래픽 세션이 없어서 데스크톱 프로그램이 표시되지 않는 것은 코어가 Linux를 지원하지 않아서가 아닙니다. 관련 없는 데스크톱 구성 요소를 계속 설치하지 말고 명령줄 방식을 사용하세요.

데스크톱 구독 및 앱 프록시

그래픽 클라이언트에서 구독을 가져오는 절차는 다른 데스크톱 플랫폼과 비슷합니다. 링크를 추가하고 다운로드한 뒤 활성 설정으로 지정하고 규칙 모드와 노드를 선택하세요. 시스템 프록시를 켠 다음 현재 데스크톱 환경의 네트워크 프록시 설정을 확인합니다. GNOME, KDE, 독립 앱마다 시스템 프록시를 읽는 방식이 다를 수 있으며 터미널, 컨테이너, 시스템 서비스는 데스크톱 설정을 자동으로 따르지 않는 경우가 많습니다. 먼저 브라우저로 확인한 다음 명령줄 도구를 명시적 프록시 매개변수로 테스트하면 노드 문제와 앱이 프록시에 연결되지 않는 문제를 구분할 수 있습니다.

그래픽 클라이언트가 TUN을 지원한다면 스위치가 켜졌는지만 확인하지 말고 보조 서비스, 코어 권한, 라우팅을 점검하세요. Linux에서 TUN 장치를 만들려면 보통 /dev/net/tun에 접근하고 네트워크 관리 권한이 있어야 합니다. 컨테이너에서는 호스트의 명시적인 권한 부여도 필요합니다. 일반 앱 전체에 장기간 높은 권한을 주는 것이 모든 환경에 적절한 것은 아닙니다. 클라이언트가 제공하는 서비스 방식을 사용하거나 권한 범위를 정확히 이해한 뒤 설정하세요. SSH 원격 작업에서는 복구 경로를 반드시 확보하세요. 유일한 연결 경로에서 기본 경로를 바로 변경하지 마세요.

mihomo 파일 배치 및 설정 검증

명령줄로 배포하려면 해당 아키텍처용 코어의 압축을 풀어 고정된 경로에 배치하세요. 아래에서는 /usr/local/bin/mihomo와 /etc/mihomo/config.yaml을 예시 경로로 사용합니다. 앞의 경로는 실행 파일, 뒤의 경로는 설정 파일입니다. 관리 방식에 맞게 경로를 바꿀 수 있지만 명령과 서비스 파일의 경로는 일치해야 합니다. 디렉터리를 준비한 뒤 호환되는 설정 파일을 지정한 위치에 저장하고 구문을 검사하세요. 검사가 통과하면 설정을 읽을 수 있다는 뜻일 뿐 노드 계정이나 대상 네트워크가 작동한다는 뜻은 아닙니다. 정식으로 시작한 뒤 로그와 실제 요청도 확인해야 합니다.

sudo install -d -m 700 /etc/mihomo
sudo chmod 755 /usr/local/bin/mihomo
sudo /usr/local/bin/mihomo -t -d /etc/mihomo -f /etc/mihomo/config.yaml

코어가 시작되는지만 확인하려면 아래의 최소 직접 연결 설정을 사용할 수 있습니다. 프록시 노드는 포함하지 않으므로 프록시 출구를 제공하지 않습니다. 수신, 로그, 기본 설정 형식을 확인하기 위한 용도입니다. 실제로 사용하려면 유효한 구독 설정으로 바꾸거나 필드 간 관계를 이해한 뒤 노드와 프록시 그룹을 추가하세요. 수신은 로컬 기기에만 바인딩하고 LAN 접근을 꺼 둔 상태이므로 안전하게 테스트를 시작할 수 있습니다. 편의를 위해 관리 인터페이스를 공용 인터넷에 노출하지 마세요.

mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

systemd 상시 실행 및 로그

systemd를 사용하는 배포판에서는 코어를 서비스로 실행할 수 있습니다. 아래 예시는 로컬 HTTP 또는 SOCKS 수신을 사용하고 TUN은 활성화하지 않는 기본 환경을 위한 것입니다. 권한이 제한된 동적 사용자로 실행하며 서비스 사용자가 설정 파일을 읽을 수 있어야 하고, 설정에 포함된 파일 경로도 접근 가능해야 합니다. 예시에서는 상태 디렉터리에 실행 데이터를 저장해 설정 파일과 쓰기 가능한 데이터를 분리합니다. 로컬 규칙 파일을 읽어야 한다면 해당 파일에 대한 읽기 권한을 별도로 설정하세요. 인증 정보가 들어 있는 디렉터리 전체를 누구나 쓸 수 있게 바꾸지 마세요.

[Unit]
Description=mihomo local proxy
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
DynamicUser=yes
StateDirectory=mihomo
ExecStart=/usr/local/bin/mihomo -d /var/lib/mihomo -f /etc/mihomo/config.yaml
Restart=on-failure
RestartSec=5
NoNewPrivileges=yes

[Install]
WantedBy=multi-user.target

파일을 /etc/systemd/system/mihomo.service로 저장하세요. 앞서 설정한 디렉터리는 관리자만 읽을 수 있으므로 동적 사용자의 예시를 활성화하려면 서비스가 설정 파일을 읽을 수 있게 해야 합니다. systemd 자격 증명 기능을 사용하거나 전용 고정 사용자를 만들고 필요한 읽기 권한만 부여하세요. 권한 차이를 무시한 채 예시를 그대로 활성화하지 마세요. 전용 사용자 방식에서는 서비스의 사용자 항목과 디렉터리 소유권도 함께 조정해야 합니다. TUN 배포에는 추가 네트워크 권한과 라우팅 설계가 필요하며 이 예시에는 포함되지 않습니다. 권한을 확인한 뒤 서비스를 새로 고침하고 활성화한 다음 로그를 확인하세요. 실패하면 먼저 구체적인 오류를 읽으세요.

sudo systemctl daemon-reload
sudo systemctl enable --now mihomo
sudo systemctl status mihomo
sudo journalctl -u mihomo -b --no-pager

원격 보안 및 업데이트 복구

서비스가 시작되면 명시적 프록시 요청으로 수신 상태를 확인하세요. 서버의 전체 아웃바운드 경로부터 변경하지 마세요. 공유가 필요하다면 수신 네트워크 인터페이스, 출발지 대역, 방화벽 규칙을 제한하세요. 관리 인터페이스와 프록시 포트는 용도가 다르므로 각각 접근을 제한해야 합니다. 코어를 업데이트하기 전에 설정과 서비스 파일을 백업하고 서비스를 중지한 다음 실행 파일을 교체하세요. 설정을 검사하고 서비스를 시작합니다. 문제가 생기면 원래 파일을 복구해 호환성 문제를 확인하세요. 재시작만 반복해 오류를 가리지 마세요. 데스크톱과 명령줄 방식의 전체 비교는 Linux 그래픽 클라이언트 및 systemd 배포 안내를 참고하세요.

설정 문제 및 점검 순서

포트, 규칙 및 오버라이드

설정 문제는 먼저 어느 계층에서 발생하는지 구분하세요. 파일을 읽을 수 있는지, 노드가 연결되는지, 규칙이 원하는 출구를 선택하는지, 앱이 로컬 프록시에 연결되는지 확인합니다. 혼합 포트는 HTTP와 SOCKS5 요청을 받고, 시스템 프록시는 일부 앱에 연결 주소를 알려 주며, TUN은 더 낮은 계층에서 트래픽을 처리합니다. 서로 관련은 있지만 대체할 수는 없습니다. 로그에서 수신 실패가 나오면 포트 점유부터 확인하세요. 정책을 찾을 수 없다는 오류라면 프록시 그룹 참조를 확인하고, 요청이 연결 목록에 들어왔지만 출구가 다르면 규칙 순서를 살펴보세요. 먼저 문제 계층을 파악해야 수정 목적이 명확해집니다.

설정 항목기능주요 점검 항목
mixed-portHTTP 및 SOCKS5 혼합 수신포트 사용 여부 및 앱 설정과 일치하는지
allow-lanLAN 기기 연결 허용바인딩 주소 및 방화벽 범위
mode규칙, 전역 또는 직접 연결 모드클라이언트가 해당 값을 덮어쓰는지
rules순서에 따라 출구 정책을 적용참조한 노드 또는 프록시 그룹이 있는지
dns코어 DNS 설정활성화 여부 및 상위 서버에 연결 가능한지
tun가상 네트워크 어댑터 트래픽 처리 설정코어 지원 여부, 시스템 권한 및 라우팅

규칙은 일반적으로 위에서 아래 순서로 적용됩니다. 마지막 MATCH 규칙은 우선 처리해야 하는 규칙 뒤에 배치해야 합니다. 규칙에 지정한 출구 이름은 기존 노드나 프록시 그룹과 정확히 일치해야 합니다. 대소문자, 공백, 이름 변경도 참조에 영향을 줄 수 있습니다. 아래 예시의 PROXY는 현재 설정에 이미 정의된 정책이어야 하며 코어가 자동으로 만드는 공통 출구가 아닙니다. 원격 구독을 수정했다면 클라이언트의 오버라이드 적용 순서도 확인하세요. 실행 설정이 구독 원본과 다를 수 있으며 정상적인 병합 결과일 수도 있습니다. 판단하기 전에 최종 적용 설정을 확인하세요.

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

자주 발생하는 문제 점검

구독은 다운로드됐는데 프록시 그룹이 표시되지 않는 이유는?

방금 다운로드한 항목이 활성 설정으로 지정됐는지 먼저 확인한 뒤 내용이 전체 설정인지 살펴보세요. 일부 구독은 노드만 제공하므로 클라이언트나 외부 설정에서 프록시 그룹과 규칙을 추가해야 합니다. 웹 오류 페이지가 파일로 저장됐을 수도 있습니다. 다운로드 안내만 보지 말고 구문 분석 로그에서 구체적인 필드를 확인하세요. 이전 설정이 실행 중이라면 잠시 이전 설정으로 돌아가 연결을 복구한 다음 새 구독의 형식과 코어 호환성을 확인할 수 있습니다.

노드 테스트는 성공했는데 브라우저에서 접속되지 않는 이유는?

테스트 요청은 보통 코어가 직접 보내지만 브라우저 요청은 코어에 들어오지 않았을 수 있습니다. 시스템 프록시 주소와 포트, 브라우저의 별도 프록시 설정, 연결 목록을 확인하세요. 새 요청이 보이지 않으면 프록시 연결부터 해결해야 합니다. 요청이 보인다면 적용된 규칙, 프록시 그룹, 오류를 살펴보세요. 다른 대상에 접속해 비교하면 특정 사이트만의 문제인지 전체 연결 실패인지 구분할 수 있습니다. 테스트 주소에 연결된다고 대상 웹사이트, UDP 또는 모든 프로토콜이 작동한다는 뜻은 아닙니다.

TUN을 켠 뒤 오히려 인터넷이 끊기는 이유는?

먼저 TUN을 끄고 기본 네트워크가 작동하는지 확인한 다음 시스템 프록시로 노드를 테스트하세요. 시스템 프록시가 정상이면 가상 네트워크 어댑터 권한, 보조 서비스, 기본 경로, DNS를 중점적으로 확인합니다. 다른 VPN과의 동시 실행, 남아 있는 이전 경로, 연결할 수 없는 DNS 상위 서버도 트래픽 처리 후 요청 실패의 원인이 될 수 있습니다. 한 번에 한 항목만 바꾸고 변경 전후 로그를 보관하세요. 플랫폼, 코어, 네트워크 환경이 다를 수 있으므로 다른 기기의 TUN 설정을 통째로 복사하지 마세요.

노드 문제와 DNS 문제를 어떻게 구분하나요?

로그에 이름 확인 시간 초과가 있는지 확인하고 여러 도메인과 앱의 결과를 비교한 뒤 클라이언트가 어떤 DNS 경로를 사용하는지 살펴보세요. 브라우저 보안 DNS, 시스템 비공개 DNS, 코어 DNS가 동시에 작동할 수 있으므로 시스템 설정을 바꿔도 브라우저에는 영향을 주지 않을 수 있습니다. fake-ip 모드에서 합성 주소를 반환하는 것은 정상 동작입니다. 실제 주소가 아니라는 이유만으로 오류라고 판단하지 마세요. 일부 앱에서 문제가 생긴다면 DNS 영역 전체를 삭제하지 말고 규칙을 이해한 뒤 예외를 설정하세요.

컴퓨터에서는 되는데 휴대폰에서 컴퓨터 프록시를 사용하지 못하는 이유는?

휴대폰에는 127.0.0.1이 아니라 컴퓨터의 현재 LAN 주소를 입력해야 합니다. 두 기기가 서로 통신할 수 있는 네트워크에 있는지, 컴퓨터에서 LAN 연결을 허용하는지, 수신 주소가 외부 요청을 받는지 확인하세요. 방화벽은 신뢰할 수 있는 출발지에만 접근을 허용해야 합니다. 게스트 Wi-Fi나 액세스 포인트 격리 기능이 기기 간 통신을 차단할 수도 있습니다. allow-lan만 켠다고 방화벽과 네트워크 구성이 모두 충족되는 것은 아닙니다. 문제를 확인하려고 방화벽 전체를 끄지 마세요.

구독을 업데이트한 뒤 사용자 규칙이 사라지는 이유는?

원격 설정은 대개 새 내용으로 교체되므로 다운로드한 파일을 직접 수정해도 계속 유지되지 않을 수 있습니다. 현재 클라이언트에서 지원하는 오버라이드, 병합 또는 별도 규칙 기능을 사용하고 적용 순서도 확인하세요. 업데이트 후 최종 실행 설정에서 규칙이 기본 처리 규칙보다 앞에 삽입됐는지, 참조하는 프록시 그룹 이름이 바뀌지 않았는지 살펴보세요. 원본 수정 사항을 백업해 두면 복구에 도움이 됩니다. 이전 설정의 모든 필드를 새 코어에 무리하게 덮어쓰지는 마세요.

로그, 복구 및 추가 안내

문제를 기록할 때 운영체제, 클라이언트 이름, 코어 정보, 트래픽 처리 방식, 대상 앱, 최소 재현 절차를 남기세요. 로그는 일반적인 실행 수준으로 먼저 확인하고 필요할 때만 일시적으로 상세 정보를 높이세요. 공유하기 전 계정 정보는 삭제해야 합니다. 연결 기록에 요청이 없거나 잘못된 규칙이 적용됐거나 노드 핸드셰이크가 실패한 경우는 서로 다른 문제입니다. 반복해서 재설치하기보다 각 경우에 맞춰 확인하세요. 코어 필드 차이는 기본판·Meta·mihomo 호환 안내를, 용어는 용어집을 참고하세요.

원인을 바로 찾기 어렵다면 가장 최근에 정상 작동했던 상태로 먼저 되돌리세요. 새로 추가한 트래픽 처리 기능을 끄고 백업 설정을 복구한 뒤 시스템 프록시가 이미 종료된 프로그램을 가리키지 않는지 확인합니다. 인터넷 연결을 복구한 다음 문제를 단계별로 다시 재현하세요. 다른 클라이언트를 고르려면 선택 가이드를 확인하고, 기본 사용 절차를 다시 살펴보려면 빠른 시작으로 돌아가세요. 다운로드, 설정, 시스템 권한을 분리해 관리하면 다음 이전과 업데이트 때도 비교 기준을 명확히 유지할 수 있습니다.

Clash 최신 버전 다운로드