용어 안내 · macOS 설정 참고

Clash 용어집

프로토콜부터 시스템 설정까지, 설정 중 마주치는 용어를 찾아볼 수 있습니다. 각 항목에서 개념과 역할, 사용 범위를 확인한 다음 클라이언트의 해당 화면에서 설정을 조정하세요.

처음 설정한다면 빠른 시작을 먼저 확인하세요. 프로토콜과 코어를 비교하려면 프로토콜 안내서를 참고하세요. 각 용어 항목에는 개별 앵커가 있어 해당 링크를 바로 공유할 수 있습니다.

어떤 프로토콜로 연결할까

프록시 프로토콜

프로토콜은 클라이언트와 서버가 데이터를 주고받는 방식을 정의합니다. 노드 이름이나 아웃바운드 모드와는 별개의 개념입니다. 클라이언트에서 프로토콜 항목을 바꿔도 서버가 다른 프로토콜을 지원하게 되지는 않습니다.

ShadowsocksSS: 암호화된 데이터 전달을 중심으로 설계된 프록시 프로토콜입니다. 일반적인 설정에는 서버 주소, 포트, 비밀번호, 암호화 방식이 포함됩니다. 클라이언트와 서버에서 호환되는 매개변수를 사용해야 합니다. 기존 방식과 Shadowsocks 2022는 키 요구 사항이 다르므로 암호화 방식 이름만 바꿔 전환할 수 없습니다. 가져온 뒤 지원하지 않는 방식이라는 오류가 표시되면 시스템 프록시를 반복해서 바꾸기보다 먼저 코어가 해당 방식을 지원하는지 확인하세요.

VMessVMess protocol: V2Ray 생태계에서 사용하는 프록시 프로토콜로, 일반적으로 UUID로 사용자를 식별하며 여러 전송 방식을 함께 사용할 수 있습니다. UUID가 올바르더라도 연결이 보장되지는 않습니다. TLS, 서버 이름, 경로 등의 매개변수도 서버 설정과 일치해야 합니다. 시스템 시간이 크게 어긋나면 인증에 실패할 수 있으므로 Mac에서 문제를 해결할 때는 먼저 ‘시스템 설정’의 날짜와 시간을 확인하세요.

TrojanTLS-based proxy protocol: 일반적으로 TLS로 연결을 보호하는 프록시 프로토콜로, 설정에는 비밀번호, 서버 주소, 서버 이름이 자주 포함됩니다. 인증서 이름, 유효 기간, 신뢰 체인이 모두 핸드셰이크에 영향을 줍니다. 인증서 오류가 발생하면 검증을 건너뛰기보다 각 항목을 확인하세요. Trojan은 macOS에 별도의 루트 인증서를 설치할 필요가 없으므로, 그런 요구가 있다면 구체적인 용도를 확인해야 합니다.

VLESSVLESS protocol: V2Ray 및 Xray 생태계의 경량 프록시 프로토콜입니다. 자체적으로 페이로드를 암호화하지 않으며 실제 보안은 TLS, REALITY 등의 방식과 올바른 설정에 달려 있습니다. 특정 VLESS 조합을 지원하는지는 코어 버전과 전송 매개변수에 따라 달라집니다. 구독을 성공적으로 가져왔다는 것은 파일을 읽었다는 뜻일 뿐, 모든 연결 조합이 정상적으로 작동한다는 의미는 아닙니다.

Hysteria2Hy2 · QUIC: QUIC 기반 프록시 프로토콜로, 일반적으로 UDP로 연결하며 불안정한 네트워크에서의 전송 성능을 고려해 설계되었습니다. 실제 사용 경험은 회선 품질, UDP 지원 여부, 대역폭 설정에 따라 달라집니다. 새 프로토콜이라는 이유만으로 더 빠른 것은 아닙니다. 특정 네트워크로 전환한 뒤 연결되지 않는다면 해당 네트워크에서 UDP 통신을 허용하는지 먼저 확인하세요.

TUICQUIC-based proxy protocol: QUIC 기반 프록시 프로토콜로 TCP와 UDP 트래픽을 전달하며, 연결을 재사용해 일부 연결 설정 비용을 줄일 수 있습니다. 프로토콜 버전과 구현에 따라 호환 범위가 다르므로 클라이언트 매개변수를 서버 요구 사항에 맞춰야 합니다. 코어 지원 여부뿐 아니라 현재 네트워크의 UDP 제한도 고려하세요. 시스템 프록시를 켜도 UDP 통신 자체가 차단된 문제는 해결되지 않습니다.

설정 화면과 실행 방식

코어와 클라이언트

메뉴 막대 앱은 조작 화면을 제공하고, 프록시 코어는 실제 연결을 처리합니다. 기능을 사용할 수 있는지 판단할 때는 앱 버전, 포함된 코어, macOS 권한을 구분해야 하며 클라이언트 이름만으로 판단할 수 없습니다.

클래식 ClashOriginal Clash core: Clash 생태계 초기에 사용된 규칙 기반 프록시 코어로, 후속 프로젝트가 이어받은 여러 설정 구조를 정의했습니다. 원 프로젝트는 개발이 중단되었습니다. 기존 설정의 기본 노드, 프록시 그룹, 규칙은 후속 코어에서 읽을 수 있지만, 새 프로토콜과 항목까지 역호환되는 것은 아닙니다. 오래된 튜토리얼을 참고할 때는 안내된 절차를 현재 클라이언트 문서와 대조하세요.

Clash MetaFormer name of mihomo: mihomo의 초기 프로젝트 이름으로, 오래된 튜토리얼, 설정 주석, 일부 앱 이름에서 여전히 Meta라는 표현을 볼 수 있습니다. 이 이름이 모든 GUI 클라이언트를 뜻하는 것은 아니며, 앱에 포함된 코어의 버전을 판단하는 기준도 아닙니다. 설정 항목을 인식하지 못하거나 프로토콜을 지원하지 않는다면 클라이언트에 표시된 실제 코어 정보를 확인하세요.

mihomoRule-based proxy core: Clash Meta를 이어 발전한 규칙 기반 프록시 코어로, 프로토콜 연결, DNS 처리, 규칙 매칭, 아웃바운드 스케줄링을 담당합니다. 자체적으로 완전한 macOS 메뉴 막대 인터페이스를 제공하지 않으며, 일반적으로 GUI 클라이언트가 실행하고 관리합니다. 새 설정의 사용 가능 여부는 실제 코어 버전에 따라 다르므로 모든 mihomo 기능이 모든 클라이언트에서 지원된다고 볼 수는 없습니다.

GUI 클라이언트GUI client: 메뉴 막대, 구독 관리, 프록시 그룹 선택, 설정 화면을 제공하는 앱입니다. 백그라운드에서 별도의 프록시 코어를 실행하는 경우가 많습니다. 시스템 프록시 설정, 로그인 시 실행, 보조 서비스 권한은 클라이언트와 시스템의 협력에 달려 있어 코어만으로 결정되지 않습니다. 같은 설정이라도 앱에 따라 조작 경로가 다를 수 있으며, 앱 업데이트와 코어 업데이트가 동시에 이루어지는 것도 아닙니다.

연결이 코어에 들어온 뒤 출구를 선택하는 방식

규칙과 프록시 그룹

규칙은 연결을 판별하고, 프록시 그룹은 선택 가능한 출구를 구성합니다. 트래픽 분기 결과를 확인할 때는 먼저 연결과 일치한 규칙을 살펴본 뒤, 그 규칙이 참조하는 프록시 그룹에서 어떤 출구가 선택됐는지 확인하세요.

규칙 기반 라우팅Rule-based routing: 도메인, 대상 IP, 프로세스 등의 조건에 따라 연결에 직접 연결, 프록시, 차단 등의 아웃바운드 방식을 선택합니다. 일반 규칙은 순서대로 매칭되며, 앞에서 일치한 규칙이 우선 적용됩니다. 마지막의 MATCH는 앞선 규칙에 포함되지 않은 연결을 처리합니다. 규칙 순서를 바꾸면 결과도 달라지므로, 새 규칙을 추가한 뒤에는 파일이 저장됐는지만 확인하지 말고 연결 기록도 살펴보세요.

프록시 그룹Proxy group: 노드나 다른 프록시 그룹을 묶어 규칙에서 참조할 수 있는 설정 단위로 만듭니다. 일반적인 유형으로는 수동 선택, 자동 테스트, 장애 시 대체가 있습니다. 자동 테스트는 테스트 대상의 응답 결과를 확인하며, 장애 시 대체는 설정된 순서에 따라 사용 가능한 출구를 찾습니다. 두 방식은 서로 다릅니다. 그룹을 변경해도 해당 그룹을 참조하는 연결에만 영향을 주며, 다른 규칙은 바뀌지 않습니다.

아웃바운드 모드Rule / Global / Direct: 일반적으로 규칙, 전역, 직접 연결 중에서 선택해 코어에 들어온 트래픽의 출구를 결정합니다. 규칙 모드는 설정된 규칙에 따라 처리하고, 전역 모드는 보통 전역 프록시 그룹을 사용하며, 직접 연결 모드는 원격 프록시를 거치지 않습니다. 전역 모드는 TUN과 같지 않으며, 원래 코어에 들어오지 않은 앱 트래픽을 자동으로 전달하지도 않습니다.

GeoIPIP geolocation data: IP 주소를 지역 정보에 연결하는 데이터로, 대상 주소에 따라 아웃바운드 정책을 선택할 때 규칙에서 자주 사용합니다. 도메인 목록과는 다르며, 데이터 갱신 지연, 공유 IP, CDN 라우팅으로 인해 예상과 다른 결과가 나올 수 있습니다. 도메인 연결에서 주소를 먼저 조회하는지는 규칙 매개변수에도 달려 있으므로 웹사이트 이름만으로 매칭 결과를 추측하지 마세요.

GeositeDomain classification data: 지역, 서비스, 용도별로 정리한 도메인 분류 데이터로, 규칙에서 컬렉션 이름을 지정해 여러 도메인을 한꺼번에 참조할 수 있습니다. 도메인 목록을 기준으로 매칭하며 대상 IP의 지역을 기준으로 하는 GeoIP와는 다릅니다. 한 웹사이트가 여러 리소스 도메인을 사용할 수도 있습니다. 컬렉션 이름과 포함 범위는 데이터 소스에 따라 다르므로, 특정 분류가 있다고 해서 관련 서비스가 모두 포함된 것은 아닙니다.

macOS 트래픽 진입점과 DNS 경로

네트워크와 시스템

이 범주의 설정은 앱이 트래픽을 클라이언트로 전달하는 방식과 도메인을 조회하는 주체를 결정합니다. 먼저 트래픽이 전달되는 경로를 확인한 다음 아웃바운드 결과를 살펴보면 여러 옵션을 동시에 바꿔 원인을 파악하기 어려워지는 일을 줄일 수 있습니다.

시스템 프록시System proxy: macOS가 네트워크 서비스별로 저장하는 프록시 설정입니다. 시스템 설정을 따르는 앱은 지정된 주소와 포트로 요청을 전달합니다. 브라우저는 보통 이 설정을 사용하지만 일부 터미널 도구, 게임, 자체 네트워크 스택을 사용하는 앱은 무시할 수 있습니다. 클라이언트를 종료할 때 시스템 프록시가 복원되지 않으면 앱이 더 이상 수신하지 않는 로컬 포트로 계속 요청할 수 있습니다.

TUN 모드Virtual network interface: 가상 네트워크 인터페이스와 라우팅을 통해 대상 IP 트래픽을 프록시 코어로 전달합니다. 시스템 프록시를 사용하지 않는 프로그램의 트래픽을 처리할 때 주로 사용합니다. macOS에서는 일반적으로 권한 승인이나 보조 서비스 설치가 필요하며, 적용 범위는 라우팅, 제외 항목, DNS 설정에 따라 달라집니다. 다른 VPN과 충돌하면 노드를 바꾸기보다 먼저 라우팅과 인터페이스 상태를 확인하세요.

Fake-IPSynthetic DNS mapping: 도메인 쿼리에 코어가 매핑하는 가상 주소를 반환하는 DNS 처리 방식입니다. 이후 코어는 매핑 정보를 통해 도메인을 복원하고 연결을 처리합니다. 도메인 정보를 보존해 트래픽을 분기하는 데 도움이 되지만, 반환된 주소는 실제 웹 서버 주소가 아닙니다. 일부 로컬 네트워크 서비스나 실제 DNS 조회 결과에 의존하는 앱은 Fake-IP 필터 예외에 추가해야 할 수 있습니다.

DNS 누출DNS leak: DNS 쿼리가 예상한 조회 경로로 전달되지 않고 다른 리졸버에서 처리되는 현상입니다. 핵심은 실제 경로가 설정한 목표와 일치하는지 여부입니다. 브라우저의 보안 DNS, 시스템 리졸버, 클라이언트 DNS, TUN 라우팅이 모두 결과에 영향을 줄 수 있습니다. 테스트 페이지에 표시된 리졸버 이름만으로 결론을 내리지 말고 예상 설정 및 클라이언트 로그와 함께 확인하세요.

혼합 포트mixed-port: 하나의 수신 포트에서 HTTP 프록시와 SOCKS 프록시 요청을 모두 받아 서로 다른 앱이 로컬 프록시 서비스를 함께 사용하도록 합니다. 7890이 흔히 쓰이는 예시지만 실제 포트 번호는 클라이언트 설정을 기준으로 확인하세요. 포트를 변경했다면 프록시를 직접 설정한 앱도 함께 수정해야 합니다. 다른 기기의 접근 허용 여부는 수신 주소, 방화벽, 로컬 네트워크 연결 설정에 따라서도 달라집니다.

지연 시간Latency / URL test: 클라이언트가 지정된 대상과의 연결을 테스트하는 데 걸린 시간입니다. 테스트 주소, 연결 설정 과정, 회선 상태에 따라 수치가 달라집니다. 지연 시간이 짧다고 다운로드 속도가 빠른 것은 아니며, 처리량과 대상까지의 라우팅은 서로 다른 요소이므로 모든 웹사이트에 접속할 수 있다는 뜻도 아닙니다. 테스트 시간 초과가 발생하면 노드, DNS, 테스트 대상 문제일 수 있으므로 실제 접속과 로그를 함께 확인하세요.

구독을 가져오고 설정을 저장하는 방법

구독과 설정 파일

구독은 설정을 배포하는 방식이고 YAML은 자주 쓰이는 파일 형식이며, 노드는 설정에 포함된 아웃바운드 항목입니다. 각각 서로 다른 계층에 있으므로 파일을 가져올 수 있는지와 연결을 설정할 수 있는지를 따로 확인해야 합니다.

구독Subscription: 링크를 통해 노드나 전체 설정을 배포하는 방식입니다. 프록시 프로토콜이 아니며, 클라이언트를 설치하면 자동으로 제공되는 연결 리소스도 아닙니다. 링크에 따라 Clash YAML, 인코딩된 노드 목록, 기타 형식이 반환될 수 있으며, 바로 가져올 수 있는지는 클라이언트 지원 여부에 달려 있습니다. 구독 링크에 접근 인증 정보가 포함될 수 있으므로 문제를 해결할 때 전체 주소를 공개 게시물에 올리지 마세요.

노드Proxy entry: 프록시 아웃바운드 연결에 필요한 설정 항목으로, 일반적으로 서버 주소, 포트, 프로토콜, 인증 정보를 포함합니다. 표시 이름은 식별을 위한 레이블일 뿐 실제 위치, 회선 품질, 사용 프로토콜을 보장하지 않습니다. 노드를 선택한 뒤에도 규칙이 해당 출구를 참조하도록 설정해야 합니다. 목록에 노드가 표시된다고 해서 현재 연결이 그 노드를 경유하는 것은 아닙니다.

YAMLConfiguration data format: Clash 설정에 자주 사용하는 텍스트 데이터 형식으로, 들여쓰기, 키-값 쌍, 목록으로 계층을 표현합니다. 들여쓰기에는 탭이 아닌 공백을 사용해야 합니다. 문법을 읽을 수 있다는 것만으로 설정 항목 이름, 참조 대상, 코어 지원 여부까지 확인되는 것은 아닙니다. 직접 수정하기 전에 복사본을 보관하고, 수정 후에는 로딩 로그를 먼저 확인해 문법 오류를 네트워크 문제로 오인하지 않도록 하세요.

구독 자동 업데이트Scheduled profile refresh: 설정한 주기에 따라 클라이언트가 구독 내용을 다시 가져와 노드, 규칙 및 기타 설정을 갱신합니다. 실제로 갱신되는 항목은 구독 내용에 따라 다릅니다. 앱이나 코어 업데이트와는 다르며, Mac이 잠자기 상태이거나 네트워크 연결이 끊긴 동안에도 정시에 완료된다고 보장할 수 없습니다. 구독 파일을 직접 수정한 내용은 덮어써질 수 있으므로, 변경 사항을 유지하려면 클라이언트의 오버라이드, 병합 또는 로컬 설정 기능을 사용하세요.