설정
작업 예시1mixed-port: 78902allow-lan: false3mode: rule4log-level: info5dns:6 enable: true문제별 설정 찾기
먼저 클라이언트의 설정 또는 구독 페이지를 열고 URL 가져오기 메뉴를 찾으세요. 서비스 제공업체가 안내한 구독 주소 전체를 붙여 넣고 다운로드를 누릅니다. 설정 카드가 나타나면 해당 항목을 선택해 현재 설정으로 적용해야 합니다. 파일을 내려받기만 해서는 적용되지 않습니다. 그런 다음 프록시 페이지에서 프록시 그룹을 펼쳐 프록시를 선택할 수 있는지 확인하세요. 구독 주소에는 보통 접속 인증 정보가 포함되므로 공개 게시판에 올리지 마세요. 가져오기에 실패하면 먼저 링크가 완전한지, 구독이 유효한지, 현재 네트워크에서 구독 서버에 접속할 수 있는지 확인하세요. DNS를 먼저 바꾸거나 클라이언트를 반복해서 재설치하지 마세요.
설정 → URL에서 가져오기 → 다운로드 → 설정 선택
프록시 → 프록시 그룹 펼치기 → 프록시 선택규칙 모드는 설정에 정의된 규칙 순서에 따라 연결 경로를 결정합니다. 일부 사이트는 직접 연결하고 나머지는 프록시 그룹을 통하게 할 수 있습니다. 전역 모드는 코어로 들어오는 연결을 모두 전역 프록시 그룹에 전달합니다. 이때도 그룹에서 프록시를 선택해야 하며, 모든 기기의 트래픽이 자동으로 프록시를 거치는 것은 아닙니다. 처음에는 구독에서 제공한 규칙 모드를 유지하고 자주 사용하는 사이트가 정상적으로 열리는지 확인하세요. 특정 사이트에 문제가 있으면 전역 모드로 잠시 전환해 비교해 볼 수 있습니다. 전역 모드에서는 되지만 규칙 모드에서 안 된다면 적용된 규칙과 대상 프록시 그룹을 확인하세요. 테스트가 끝나면 규칙 모드로 되돌려 임시 점검 설정이 계속 남지 않도록 하세요.
mode: rule
log-level: info시스템 프록시는 프록시 주소를 운영체제 설정에 등록하므로 브라우저나 시스템 프록시 설정을 따르는 앱에 적합합니다. 일부 게임, 명령줄 도구, 자체 네트워크 스택을 사용하는 프로그램은 시스템 프록시를 따르지 않을 수 있습니다. 이때 TUN을 사용하면 가상 네트워크 인터페이스로 해당 트래픽을 처리할 수 있습니다. 두 기능을 반드시 함께 켜야 하는 것은 아닙니다. 먼저 시스템 프록시를 설정해 브라우저에서 작동하는지 확인하세요. 특정 앱만 작동하지 않는다면 해당 앱의 프록시 옵션을 확인합니다. TUN이 꼭 필요할 때는 클라이언트 안내에 따라 서비스를 설치하거나 권한을 허용하고, 다른 VPN과 충돌하지 않는지 살펴보세요. 인터넷 연결이 끊기면 검증을 마친 설정으로 먼저 되돌린 다음 하나씩 조정하세요.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true클라이언트에 실행 중이라고 표시되어도 프로그램이나 코어가 시작됐다는 뜻일 뿐, 웹 요청이 프록시를 통한다는 증거는 아닙니다. 테스트할 사이트를 열고 연결 또는 로그 페이지에서 해당 도메인을 찾아 적용된 규칙, 대상 프록시 그룹, 최종 출구를 확인하세요. 필요하면 신뢰할 수 있는 외부 IP 확인 페이지에서 프록시를 켰을 때와 껐을 때의 결과를 비교합니다. 규칙 모드에서는 직접 연결하는 사이트의 외부 IP가 바뀌지 않을 수 있으며 이는 정상입니다. 브라우저 캐시, 기존 연결, 다른 프록시 확장 프로그램이 결과에 영향을 줄 수 있으니 테스트 전에 기존 페이지를 닫고 다시 여세요. 상태 스위치만 보는 것보다 개별 요청의 경로를 확인하는 편이 정확합니다.
테스트 페이지 열기 → 해당 연결 찾기
적용된 규칙 확인 → 최종 출구 확인 → 외부 IP 비교설정을 수정하기 전에 현재 정상 작동하는 파일을 내보내고, 적용 중인 덮어쓰기나 병합 설정을 기록해 두세요. 수정 후 파일을 불러올 수 없다면 먼저 백업으로 되돌리고 여러 항목을 한꺼번에 바꾸지 마세요. YAML에서 흔히 발생하는 문제는 탭으로 들여쓰기하기, 콜론 뒤에 공백을 넣지 않기, 목록의 들여쓰기 단계가 잘못된 경우입니다. 구독에서 받은 설정 파일은 업데이트할 때 교체될 수 있으므로, 장기간 유지할 사용자 설정은 클라이언트가 지원하는 덮어쓰기 기능에 넣으세요. 구독을 다시 가져온 뒤에도 문제가 계속되면 덮어쓰기를 잠시 비활성화해 원본 파일과 추가 수정 중 어디에서 오류가 생겼는지 확인하세요. 한 번에 하나씩 복원하거나 수정하고, 설정이 정상적으로 적용된 것을 확인한 뒤 연결을 테스트하세요.
mixed-port: 7890
allow-lan: false
mode: rule
dns:
enable: true운영체제에 맞는 설치 파일 선택
먼저 기기의 운영체제와 프로세서 아키텍처를 확인한 다음 클라이언트를 비교하세요. Clash Plus, Clash Verge Rev, FlClash는 서로 다른 그래픽 인터페이스 프로젝트이므로 파일명에 Clash가 있다고 해서 해당 플랫폼에 맞는다고 단정할 수 없습니다. 다운로드 페이지에서 운영체제별 클라이언트, 유지 관리 상태, 설치 시 유의 사항을 확인할 수 있습니다. 홈페이지의 링크는 플랫폼별 안내로 연결될 뿐, 설치 파일을 바로 내려받지는 않습니다.
처음에는 한 기기에서 구독 가져오기와 연결 확인을 마친 뒤 다른 기기에도 같은 절차를 적용하는 것이 좋습니다. 클라이언트 설치와 구독 준비는 별개의 단계입니다. 설치 파일은 프로그램을 제공하고 구독은 연결에 필요한 설정을 제공합니다. 유효한 구독을 준비했다면 안내에 따라 진행하면 되며, 설치 전에 YAML 전체를 직접 작성할 필요는 없습니다. 기존 클라이언트가 정상 작동한다면 설정과 사용자 규칙을 먼저 내보낸 뒤 이전 여부를 결정하세요.
데스크톱에서는 Clash Plus, Clash Verge Rev, FlClash를 먼저 비교해 보세요. 다운로드 전에 시스템 설정에서 프로세서 아키텍처를 확인하고, 설치 후 구독을 가져온 다음 시스템 프록시를 켜세요. TUN이 필요할 때만 안내에 따라 서비스 권한을 설정하세요. 설치가 완료됐다고 연결까지 된 것은 아닙니다.
Clash for Windows에서 이전한다면 먼저 구독 주소, 규칙, 포트 설정을 백업하세요. 지원이 종료된 클라이언트도 실행될 수 있지만 유지 관리 상태는 새 클라이언트와 다릅니다. 설정 항목이 호환되지 않으면 새 코어 문서를 참고해 하나씩 처리하고, 설정 파일 전체를 그대로 덮어쓰지 마세요.
다운로드 Windows 클라이언트이 Mac에 관하여에서 Apple Silicon인지 Intel인지 확인한 뒤 해당 설치 파일을 선택하세요. 흔히 선택하는 클라이언트로는 Clash Plus, Clash Verge Rev, FlClash가 있습니다. 처음 실행할 때 권한을 요청하면 앱 출처를 확인한 다음 macOS의 일반적인 절차에 따라 진행하세요.
메뉴 막대의 프록시 스위치와 현재 설정은 별도로 확인해야 합니다. 구독을 가져온 뒤 설정이 선택되어 있는지 확인하고, 네트워크 설정이 클라이언트의 로컬 수신 포트를 가리키는지도 살펴보세요. 다른 네트워크 도구로 전환하기 전에는 현재 프록시가 트래픽을 처리하지 않도록 먼저 끄세요. 설정이 서로 덮어쓰는 일을 방지할 수 있습니다.
다운로드 macOS 클라이언트모바일에서는 Clash Plus를 먼저 살펴보고 Clash Meta for Android, FlClash, Surfboard와 비교해 보세요. 최근 기기는 대부분 ARM64를 사용하지만 기기 정보를 기준으로 선택해야 합니다. 클라이언트마다 지원하는 설정 형식이 다를 수 있으므로 모든 구독 링크가 공통으로 지원된다고 가정하지 마세요.
처음 연결할 때 시스템 VPN 권한 요청이 표시되면 앱을 확인하고 허용하세요. 백그라운드로 전환한 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인합니다. 다른 VPN이 이미 실행 중이라면 어떤 앱이 트래픽을 처리하는지 먼저 확인하세요. 알림 표시만으로 실제 연결 경로를 판단하지 마세요.
다운로드 Android 클라이언트iPhone 및 iPad 사용자는 다운로드 페이지에서 Clash Plus의 App Store 페이지를 열 수 있으며, 공식 웹사이트 clashplus.io에서 앱 설명을 확인할 수 있습니다. 먼저 설치를 마친 뒤 클라이언트가 지원하는 구독 형식을 가져오고, 시스템 안내에 따라 VPN 설정을 추가하세요.
연결 스위치를 켜도 적절한 프록시를 선택하고 웹페이지에 접속해 확인해야 합니다. 구독은 가져와지지만 사이트에 접속할 수 없다면 설정의 유효 기간과 현재 선택된 항목부터 확인하세요. 시스템 네트워크 설정을 반복해서 삭제하지 마세요. 모바일 데이터와 Wi-Fi에서 결과가 다르면 각각 따로 기록해 문제를 살펴보세요.
다운로드 iOS 클라이언트데스크톱 환경에서는 Clash Verge Rev와 FlClash를 우선 비교하고 배포판에 맞는 패키지 형식을 선택하세요. 그래픽 클라이언트를 설치한 뒤 시스템 프록시로 브라우저 연결을 확인하고, 그다음 서비스 모드나 TUN을 고려하세요. 그래픽 클라이언트가 열리더라도 코어 서비스가 정상적으로 실행된다는 뜻은 아닙니다.
서버 및 라우터 사용자는 mihomo 코어도 확인할 수 있지만 설정 경로, 권한, 서비스 실행을 직접 관리해야 합니다. 명령줄 프로그램은 데스크톱 프록시 설정을 사용하지 않을 수 있으므로 앱 자체의 프록시 옵션을 확인하세요. 특정 프로그램의 연결 문제를 해결하려고 전체 라우팅을 바로 변경하지 마세요.
다운로드 Linux 클라이언트포트, DNS, TUN, LAN 공유는 처음 연결할 때 모두 바꿔야 하는 항목이 아닙니다. 먼저 구독에 포함된 설정을 사용해 규칙 모드에서 반복 가능한 접속 테스트를 진행하세요. 명확한 문제가 있을 때만 해당 문제와 관련된 항목을 조정합니다. 이렇게 하면 문제를 비교할 기준을 유지하고, 어떤 변경이 결과를 바꿨는지 파악할 수 있습니다.
용어가 낯설다면 먼저 개념 빠르게 보기를 확인하세요. 변경할 항목을 알고 있다면 설정 전체 가이드를 참고하면 됩니다. 튜토리얼은 작업 순서를 안내하고 참고 문서는 각 매개변수를 설명하므로, 두 경로를 모두 읽을 필요는 없습니다.
프로젝트 관계와 설정 출처
Clash 생태계는 모든 기기에 하나의 설치 파일을 사용하는 단일 제품이 아닙니다. 그래픽 클라이언트는 설정 관리, 프록시 선택, 연결 확인, 시스템 연동을 담당하고 코어는 설정을 읽고 규칙을 적용해 외부 연결을 만듭니다. mihomo는 이 생태계에서 지속적으로 개발되는 오픈소스 코어입니다. 이 관계를 이해하면 화면의 기능 스위치와 설정 파일의 항목을 구분하고, 문제를 클라이언트 설정에서 찾아야 할지 코어 설정에서 찾아야 할지 판단하기 쉽습니다.
클라이언트마다 사용하는 코어 빌드, 기본 설정, 설정 병합 방식이 다를 수 있으므로 메뉴 이름이나 튜토리얼 화면이 정확히 일치하지 않을 수 있습니다. 화면보다 작업 목표에 집중하세요. 설정 메뉴를 찾고, 유효한 설정을 적용하고, 프록시를 선택한 뒤 트래픽이 처리되는지 확인하면 됩니다. 버튼 위치가 바뀌어도 전체 절차가 달라진 것은 아닙니다. 반대로 메뉴 이름이 비슷하더라도 모든 고급 설정을 그대로 적용할 수 있는 것은 아닙니다.
Clash 공식 웹사이트, Clash Verge 다운로드, Clash for Windows 지원 종료 등을 검색하면 오래된 튜토리얼, 보관된 프로젝트, 후속 포크가 함께 표시될 수 있습니다. 일부 설정 문법을 공유하더라도 관리 주체와 배포 경로는 서로 다릅니다. 다운로드하기 전에 프로젝트명을 확인하고 최신 릴리스 안내를 읽은 뒤 운영체제에 맞는 설치 파일을 선택하세요. 오래된 글에 나온 프로그램명이 현재도 권장되는 선택이라고 단정하지 마세요.
보관된 프로젝트라고 해서 기존 파일이 바로 작동하지 않는 것은 아니지만, 이후 호환성과 문제 수정 여부는 별도로 판단해야 합니다. 이전을 계획한다면 현재 정상 작동하는 설정을 저장하고 사용자 규칙, 프록시 그룹 이름, 로컬 포트를 기록하세요. 새 클라이언트에서 확인을 마친 뒤 기존 프로그램을 정리하면 차이가 생겼을 때 비교할 기준이 남아 있어 설정을 처음부터 다시 만들 필요가 없습니다.
오픈소스 저장소에서는 소스 코드, 라이선스, 커밋 기록, 이슈 논의를 확인할 수 있어 프로젝트 구현과 변경 사항을 살펴보는 데 유용합니다. mihomo의 공개 저장소는 MetaCubeX 조직에서 관리합니다. 아래 명령은 소스 코드를 가져오므로 구현이나 빌드 과정을 살펴보려는 사용자에게 적합합니다. 일반 사용자는 클라이언트를 설치하기 위해 명령을 실행할 필요가 없으며, 4단계 시작을 위해 빌드 환경을 구성할 필요도 없습니다.
소스 코드 공개 여부와 실제 연결 가능 여부는 별개의 문제입니다. 구독 유효성, 프록시 서버 접속 가능 여부, 네트워크 환경의 접근 허용 여부, 규칙 적용 결과가 모두 연결에 영향을 줍니다. 이 사이트는 검증되지 않은 다운로드 수나 평점 대신 실제로 확인할 수 있는 점검 항목을 안내합니다. 설정을 불러올 수 있는지, 프록시를 선택할 수 있는지, 요청 기록이 남는지, 최종 연결 경로가 예상과 일치하는지 확인하세요.
클라이언트 업데이트는 보통 화면, 시스템 연동 또는 포함된 코어를 변경합니다. 구독 업데이트는 구독 주소에서 설정을 다시 가져오는 작업입니다. 클라이언트 업데이트로 서비스 구독이 자동 갱신되지는 않으며, 구독 업데이트가 앱을 업그레이드하지도 않습니다. 구독 업데이트에 실패하면 먼저 링크에 접속할 수 있는지, 응답 내용이 지원되는 형식인지, 서비스가 여전히 유효한지 확인하세요. 모든 실패를 오래된 클라이언트 탓으로 돌리지 마세요.
업그레이드 전에 변경 사항을 읽고 현재 설정을 내보내세요. 업그레이드 후에는 기존 프록시 그룹, 덮어쓰기, DNS 설정이 예상대로 유지됐는지 확인하고 자주 사용하는 앱의 연결을 다시 테스트합니다. 구독에서 생성된 파일을 직접 수정했다면 다음 구독 업데이트 때 변경 사항이 덮어써질 수 있습니다. 계속 유지할 규칙은 클라이언트가 공식 지원하는 덮어쓰기 또는 병합 기능을 사용하고 복구할 수 있도록 백업해 두세요.
커뮤니티에 도움을 요청할 때는 운영체제와 클라이언트명, 사용 중인 트래픽 처리 방식, 문제가 시작된 단계를 먼저 설명하세요. 모든 사이트에서 실패하는지 특정 도메인이나 앱에서만 실패하는지 밝히고, 규칙 모드와 전역 모드에서 차이가 있는지도 적어 주세요. 이런 정보가 단순히 연결되지 않는다는 설명보다 문제 범위를 파악하는 데 도움이 되며 추가 질문도 줄일 수 있습니다.
로그와 설정에는 구독 인증 정보, 서버 주소, 개인 네트워크 정보가 포함될 수 있습니다. 공유하기 전에 민감한 내용을 삭제하고 문제와 관련된 설정 구조, 오류 메시지, 재현 절차만 남기세요. 구독 주소 전체를 공개하거나 수정한 긴 설정 파일을 현재 작동하는 환경에 그대로 덮어쓰지 마세요. 먼저 최소 범위로 비교 테스트한 뒤 DNS, 라우팅, TUN 설정을 조정할지 결정하세요.
설정을 마친 뒤 더 살펴보기
연결이 정상적으로 되는 것을 확인한 뒤 실제 문제에 맞는 글을 선택하세요. LAN 공유는 다른 기기에서 컴퓨터의 포트에 접속하는 방법, 인증서 오류는 브라우저의 보안 확인, DNS 점검은 도메인 조회 경로를 다룹니다. 문제마다 확인할 항목이 다르므로 여러 글의 설정을 한꺼번에 적용하지 마세요. 현재 설정을 유지하고 한 번에 한 가지씩 변경해 확인하세요.
테스트 페이지로 DNS 요청 유출 여부를 확인한 뒤 dns 항목의 enhanced-mode, nameserver, fallback 설정을 줄마다 설명하고 바로 적용할 수 있는 예시를 제공합니다.
읽을 때는 DNS 조회 경로와 웹 연결 경로를 구분하세요. 테스트 페이지에 표시된 DNS 서비스 제공업체는 참고 정보일 뿐이므로 현재 트래픽 처리 방식과 함께 판단해야 합니다. 낯선 이름이 보인다고 DNS 설정 전체를 바로 교체하지 마세요.
시스템 시간 오류, 공용 Wi-Fi의 트래픽 변조, 프록시 노드 문제, 잘못된 규칙 설정 등을 구분하고 인증서 오류와 프록시의 실제 관계 및 해결 방법을 안내합니다.
보안 경고가 나타나면 계정 정보나 결제 정보를 입력하지 말고 시스템 시간과 접속 도메인을 확인한 뒤 다른 네트워크에서도 테스트하세요. 프록시를 켠 상태에서 인증서 오류가 발생했다는 사실만으로 둘 사이의 인과관계를 단정할 수는 없습니다.
mixed-port가 HTTP와 SOCKS5를 함께 처리하는 원리를 설명하고 allow-lan 활성화, 컴퓨터의 LAN IP 확인, 휴대폰 Wi-Fi 프록시 설정 방법을 안내합니다.
공유하기 전에 컴퓨터에서 먼저 접속할 수 있는지 확인하고 두 기기가 서로 통신할 수 있는 LAN에 연결되어 있는지 살펴보세요. LAN 허용은 필요한 설정 중 하나일 뿐입니다. 수신 주소와 방화벽, 휴대폰에 입력한 프록시 포트도 확인해야 합니다.