Windows
데스크톱에서는 여러 GUI 클라이언트 중에서 선택할 수 있습니다. 먼저 프로세서 아키텍처와 설치 파일 형식을 확인한 뒤, 시작 프로그램 등록이나 시스템 프록시 설정이 필요한지 결정하세요.
다운로드 페이지로 이동설정 안내
설정을 확인한 뒤 연결을 켜세요
클라이언트의 주요 설정은 각각 다른 역할을 합니다. 왼쪽 항목을 선택해 용도, 설정 위치, 관련 필드를 확인하세요. 처음 사용하는 경우 순서대로 읽으면 됩니다.
PROFILE · 먼저 가져오기
프로필은 연결 설정의 출발점입니다
구독 URL은 설정을 가져오는 경로일 뿐, 연결이 이미 설정됐다는 뜻은 아닙니다. 클라이언트의 ‘프로필’에서 URL 다운로드를 선택한 뒤 제공받은 주소를 붙여 넣고 가져오기가 끝날 때까지 기다리세요. 그런 다음 해당 프로필을 현재 설정으로 지정합니다. 가져온 후에는 아웃바운드 그룹과 규칙이 표시되는지 확인하세요. 목록이 비어 있다면 연결 스위치를 반복해서 켜고 끄기보다 구독 제공처에 주소와 형식을 확인해야 합니다. 업무용과 일상용 설정을 구분하려면 각각 저장한 뒤 사용할 때 전환해 규칙이 섞이지 않도록 하세요.
proxies:
proxy-groups:
rules:더 알아보기: iPhone에서 여러 Profile 관리하기
MODE · 아웃바운드 결정
규칙, 전역, 직접 연결
일상적인 사용에서는 보통 ‘규칙’을 선택합니다. 클라이언트가 프로필의 rules를 위에서 아래로 확인해 요청을 일치시키고 해당 아웃바운드 정책에 전달합니다. ‘전역’은 모든 요청을 선택한 아웃바운드로 보내므로 특정 규칙이 접속에 영향을 주는지 임시로 확인할 때 유용합니다. ‘직접 연결’을 선택하면 요청이 프록시 아웃바운드를 거치지 않습니다. 모드를 바꿔도 구독 내용이 수정되거나 누락된 정책 그룹이 추가되지는 않습니다. 특정 사이트의 접속 경로가 예상과 다르다면 클라이언트를 재설치하기 전에 현재 모드와 규칙 적용 결과부터 확인하는 편이 문제를 찾기 쉽습니다.
mode: rule
rules:
- MATCH,DIRECT용어 안내: 규칙 및 아웃바운드 용어 보기
DNS · 도메인 확인
Fake-IP가 적용되는 범위 이해하기
DNS 설정은 클라이언트가 도메인 조회를 처리하는 방식을 결정합니다. Fake-IP를 사용하면 코어가 먼저 도메인에 매핑 주소를 할당하고, 연결 정보를 바탕으로 도메인을 복원해 규칙을 적용합니다. 실제 서버 주소를 설정에 직접 입력하는 방식과는 다릅니다. 로컬 네트워크 검색에 의존하는 기기나 특정 앱이 제대로 작동하지 않으면 해당 도메인에 필터 규칙이 필요한지 설정을 확인하세요. DNS를 변경하기 전에는 기존 설정을 복사해 두고 항목을 하나씩 바꿔 테스트하는 것이 좋습니다. 여러 필드를 한꺼번에 바꾸면 어떤 항목이 영향을 줬는지 파악하기 어렵습니다.
dns:
enable: true
enhanced-mode: fake-ip작동 원리: Fake-IP와 DNS 매핑
TUN · 시스템 트래픽
스위치와 시스템 권한을 구분하세요
TUN 모드는 시스템 트래픽이 코어로 전달되는 방식을 다룹니다. 별도의 구독 설정이 아니며 아웃바운드 규칙을 대신 선택하지도 않습니다. iPhone에서 클라이언트가 시스템 VPN 연결을 설정할 때는 안내에 따라 권한을 허용해야 합니다. 상태 막대에 연결 아이콘이 나타나면 클라이언트로 돌아와 프로필, 모드, 연결 상태를 확인하세요. 스위치가 곧바로 원래 상태로 돌아간다면 시스템 권한과 설정의 유효성을 먼저 확인합니다. 클라이언트마다 TUN 관련 메뉴 이름과 선택 항목이 다를 수 있으니, 설치된 버전의 설정을 기준으로 하세요. 다른 플랫폼의 메뉴 위치를 그대로 따라 하면 안 됩니다.
tun:
enable: true
stack: system문제 해결: 연결 및 권한 관련 자주 묻는 질문
LAN · 기기 간 접속
공유가 필요할 때만 켜세요
‘로컬 네트워크 연결 허용’은 같은 네트워크의 다른 기기가 클라이언트에서 열어 둔 프록시 리스닝 주소에 접속할 수 있는지 설정합니다. iPhone에서만 클라이언트를 사용한다면 보통 이 옵션을 변경할 필요가 없습니다. 같은 네트워크의 다른 기기가 접속해야 한다면 리스닝 주소와 포트, 시스템 네트워크 권한도 확인해야 합니다. 스위치를 켰다고 다른 기기가 프록시를 자동으로 검색하는 것은 아니며, 모바일 핫스팟 프록시가 활성화되는 것도 아닙니다. 문제를 확인할 때는 두 기기가 서로 접속할 수 있는 네트워크에 있는지 먼저 확인한 다음 주소와 포트를 살펴보세요. 연결 표시만 확인해서는 원인을 알기 어렵습니다.
allow-lan: false
bind-address: "*"관련 용어: 리스닝 주소 및 포트
플랫폼별 안내
운영체제에 맞는 클라이언트 찾기
사용 중인 기기를 확인한 뒤 해당 플랫폼에서 클라이언트, 설치 방법, 시스템 요구 사항을 살펴보세요. 같은 설정을 그대로 사용할 수 있는지는 선택한 클라이언트가 지원하는 설정 형식과 코어 기능에 따라서도 달라집니다.
macOS
Apple Silicon과 Intel 모델을 구분하고, 처음 실행할 때 표시되는 네트워크 확장 및 권한 안내를 확인하세요. 설치한 뒤 설정을 가져오면 됩니다.
다운로드 페이지로 이동Android
기기 아키텍처에 맞는 설치 경로를 선택하세요. 시스템 VPN 권한, 백그라운드 실행 제한, 배터리 관리 설정이 연결 유지에 영향을 줄 수 있습니다.
다운로드 페이지로 이동iOS
iPhone 및 iPad에서는 해당 앱 스토어의 클라이언트 페이지를 확인하세요. 설치 후 설정 가져오기, 시스템 권한 허용, 연결 확인을 차례로 진행합니다.
다운로드 페이지로 이동Linux
GUI 데스크톱 사용자는 클라이언트 설치 파일을 확인하세요. 서버나 라우터에서 사용하려면 아키텍처, 코어 파일, 실행 방식도 추가로 확인해야 합니다.
다운로드 페이지로 이동같은 플랫폼의 클라이언트를 비교하고 싶으신가요? 전체 클라이언트 보기 → 다운로드 페이지에서 플랫폼별 경로와 지원 조건을 확인할 수 있습니다.
빠른 시작
설치부터 연결 확인까지, 세 단계
아래는 권장 작업 순서입니다. 각 단계에는 완료 여부를 확인할 기준이 있습니다. 문제가 생기면 여러 설정을 동시에 바꾸기보다 방금 마친 단계를 다시 확인하세요.
클라이언트를 설치하고 설정 가져오기
기기에 맞는 다운로드 페이지에서 시스템 안내에 따라 설치하세요. 구독 URL을 받은 뒤 클라이언트에서 ‘프로필’ 또는 ‘URL에서 다운로드’를 찾아 주소를 붙여 넣고 가져옵니다. 목록에 프로필이 표시되는지 확인한 뒤 현재 설정으로 지정하세요. 링크를 클립보드에 복사하는 것만으로 클라이언트가 자동으로 읽지는 않습니다. 제공받은 파일이 로컬 YAML이라면 파일 가져오기 메뉴를 사용하고 들여쓰기가 유지됐는지 확인하세요.
아웃바운드 모드 확인
가져온 뒤 선택할 수 있는 아웃바운드 그룹이 있는지 확인하고, 먼저 설정에서 제공하는 그룹을 선택하세요. 그런 다음 아웃바운드 모드를 ‘규칙’으로 설정합니다. 규칙 모드는 설정에 정의된 순서대로 요청을 일치시켜 트래픽 경로를 결정합니다. 특정 사이트의 동작을 진단해야 한다면 잠시 ‘전역’과 ‘직접 연결’을 비교해 테스트한 뒤 일상적으로 사용하는 모드로 되돌리세요. 모드와 그룹은 서로 다른 단계의 설정이므로 하나만 바꾸고 다른 하나도 설정된 것으로 간주하면 안 됩니다.
권한을 허용하고 접속 확인
연결 스위치를 켜고 iOS 안내에 따라 VPN 구성을 허용한 뒤, 클라이언트로 돌아와 스위치가 계속 켜져 있는지 확인하세요. 실제로 접속하려는 웹사이트나 앱을 열어 확인하고, 연결 기록에서 요청이 예상한 규칙과 일치했는지 살펴봅니다. 연결이 설정되지 않으면 권한과 현재 설정을 먼저 확인하세요. 연결은 됐지만 특정 앱이 예상과 다르게 작동한다면 모드, 규칙, DNS를 차례로 점검합니다. ‘스위치가 켜짐’과 ‘원하는 사이트에 접속 가능’을 각각 확인하면 문제 범위를 좁힐 수 있습니다.
전체 사용법 보기 → 단계별 화면 위치와 확인 방법, 자주 막히는 부분을 안내합니다.
오픈 소스 생태계
저장소와 설정 파일의 역할 구분하기
프로젝트 개요
Clash는 규칙 기반 프록시 코어로 처음 주목받았습니다. 이후 커뮤니티에서 여러 운영체제용 코어 파생 버전과 GUI 클라이언트가 개발되면서, 오늘날 ‘Clash 클라이언트’라는 말은 하나의 앱만 가리키지 않습니다. 원본 Clash, Clash Meta, mihomo는 유지 관리 현황과 기능 범위, 설정 지원이 서로 다릅니다. 다운로드 경로를 선택할 때는 먼저 클라이언트 이름을 확인하고, 어떤 코어를 사용하는지 설명을 살펴보세요. 특정 코어가 지원하는 기능을 모든 클라이언트에서 사용할 수 있다고 단정하지 않는 것이 좋습니다.
코드 및 문서
오픈 소스 저장소에서는 코드를 살펴보고 이슈와 업데이트 내용을 확인할 수 있습니다. 예를 들어 mihomo 저장소의 설정 문서에서 각 필드의 의미를 확인할 수 있으며, GUI 클라이언트는 설정 가져오기와 그룹 표시, 내장 코어 실행을 담당합니다. 이 사이트의 한국어 사용 안내는 자주 쓰는 설정을 정리한 것으로, 각 프로젝트의 릴리스 안내를 대신하지 않습니다. 저장소 명령어를 복사하는 기능은 소스 코드를 살펴보거나 변경 사항을 추적하려는 사용자에게 적합합니다. 휴대폰에 클라이언트만 설치하려면 위의 플랫폼별 다운로드 경로를 이용하세요.
코어와 클라이언트
코어는 규칙 일치, DNS, 연결 전달을 처리하고 클라이언트는 시스템 인터페이스와 조작 메뉴를 제공합니다. 이름이 비슷한 프로젝트라도 코어 빌드, 기본 설정, 업데이트 주기가 다를 수 있습니다. 설정 안내를 따라 하기 전에 해당 필드가 현재 사용하는 코어에서 지원되는지 확인하고 YAML을 수정하세요. 인식되지 않는 필드가 있다면 화면의 스위치 이름만 보고 설정 문법을 추측하지 말고 해당 프로젝트의 문서를 확인해야 합니다.
업데이트 및 호환성
설정 제공처, 클라이언트, 코어는 각각 따로 업데이트될 수 있습니다. 구독을 업데이트하면 보통 설정 내용이 새로고침될 뿐 클라이언트가 자동으로 교체되지는 않습니다. 앱을 업데이트해도 기존 설정의 모든 사용자 지정 필드가 이전과 똑같이 작동한다고 보장할 수 없습니다. 변경 전에 정상 작동하는 설정을 따로 저장하고, 업데이트 후 가져오기 결과와 규칙 그룹, 실제 접속을 확인하세요. 여러 기기에서 같은 구독을 사용한다면 한 번의 변경이 모든 기기에서 똑같이 적용된다고 가정하지 말고, 플랫폼별 클라이언트가 지원하는 프로토콜과 필드를 각각 확인해야 합니다.
사용 팁
상황별 가이드 더 보기
초보자 질문부터 DNS 작동 방식까지, 아래 글에서 자주 겪는 상황을 하나씩 다룹니다. 현재 문제와 가장 가까운 글을 먼저 확인한 뒤 클라이언트에서 다시 설정하면 여러 메뉴를 오가며 무작정 시도하는 일을 줄일 수 있습니다.
고급 설정
Fake-IP 모드 원리: DNS 매핑으로 모바일 첫 응답 대기 시간 줄이기
Fake-IP와 redir-host의 처리 방식을 비교하고, 매핑 주소의 역할과 로컬 네트워크 기기 및 일부 앱에서 필터 목록이 필요한 경우를 알아봅니다.
글 읽기 → 빠른 답변Clash iOS 초보자 질문 10가지: 설치 경로, 구독 가져오기, 연결 오류 해결
설치, 설정 가져오기, 권한 허용, 모드 선택 과정에서 자주 막히는 부분을 정리했습니다. 각 질문에서 확인할 위치와 다음 단계의 해결 방법을 안내합니다.
글 읽기 → 입문 가이드Profile이란? iPhone에서 여러 Clash 설정을 전환하고 관리하는 방법
Profile, 구독, 로컬 설정의 차이를 알아보고 사용 목적에 맞춰 설정을 추가·업데이트·전환하는 순서를 안내합니다.
글 읽기 →간단한 질문을 먼저 확인하고 싶으신가요? 도움말 센터로 이동 설정 필드의 의미가 궁금하신가요? 용어집 열기 전체 글 보기 →