오픈 소스 프록시 생태계 · 설정 필드 참고

Clash Q&A 허브
클라이언트 다운로드와 설정 필드

Clash 다운로드 가이드 보기 mihomo 코어 · YAML 설정

운영체제에 맞는 클라이언트를 고르고, YAML 설정을 필드별로 살펴보며 DNS부터 규칙까지 트래픽 분기 경로를 이해하세요.

Clash 설정 파일 클라이언트 선택 DNS 및 Fake-IP
Windows Android iOS macOS Linux
config.yaml YAML · 들여쓰기 2칸
  1. mixed-port: 7890
  2. allow-lan: false
  3. # 규칙에 따라 연결 분기
  4. mode: rule
  5. log-level: info
  6. dns:
  7. enable: true
  8. enhanced-mode: fake-ip
  9. proxy-groups:
  10. - name: PROXY
  11. type: select
  12. proxies: [DIRECT]
  13. rules:
  14. - GEOIP,CN,DIRECT
  15. - MATCH,PROXY
UTF-8

이 예시는 필드 구조를 보여주는 일부 설정으로, 완전한 프록시 설정이 아닙니다. PROXY에는 현재 DIRECT만 포함되어 있으므로 실제 사용하려면 유효한 노드를 가져와 정책 그룹에 추가해야 합니다.

플랫폼별 다운로드
5
코어
mihomo
설정
YAML
코어 프로토콜
GPL-3.0

Clash 클라이언트 플랫폼별 다운로드

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 GUI 클라이언트를 선택하세요. Windows, macOS, Android, iOS에서는 Clash Plus를 우선 추천하며, Linux에서는 Clash Verge Rev부터 살펴볼 수 있습니다. 클라이언트는 설정 관리와 시스템 연동을 담당하고, 설정 필드를 해석해 연결을 만드는 것은 코어입니다. 화면이 비슷해도 설정 지원 범위는 서로 다를 수 있습니다.

Windows

시스템 트레이 제어, 시스템 프록시, 설정 전환이 필요한 데스크톱 사용자에게 적합합니다. Clash for Windows 대체 클라이언트를 찾는다면 Clash Plus와 Clash Verge Rev를 우선 비교하고, 운영체제 아키텍처와 서비스 권한, TUN 지원 여부를 확인하세요. 이전하기 전에 기존 설정을 보관하고 새 클라이언트에서 가져오기와 연결을 테스트해 작업 환경을 덮어쓰지 않도록 하세요.

다운로드 페이지로 이동

macOS

먼저 시스템 정보에서 Apple Silicon 또는 Intel을 확인한 뒤 알맞은 설치 파일을 선택하세요. 시스템 프록시와 네트워크 확장의 권한 부여 방식은 다를 수 있으므로, 처음 실행할 때 클라이언트 안내에 따라 설정해야 합니다. 기존 설정을 가져올 수 있지만 로그인 시 자동 실행, 프록시 연결, 로컬 경로 등은 새 클라이언트에서 다시 확인하세요.

다운로드 페이지로 이동

Android

모바일에서는 보통 시스템 VPN 인터페이스를 통해 트래픽을 처리합니다. 설치 전 기기 아키텍처를 확인하고, 연결 전에 시스템 권한을 허용하세요. 화면이 잠긴 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 제한을 확인합니다. 앱별 프록시는 클라이언트 기능이며, YAML에서 도메인이나 대상 주소를 기준으로 트래픽을 나누는 규칙과는 별개의 설정입니다.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있으며, 공식 사이트는 clashplus.io입니다. 구독을 가져온 뒤 클라이언트가 노드와 정책 그룹을 인식하는지 확인하고 VPN 구성을 추가하도록 허용하세요. 데스크톱에서 사용할 수 있는 일부 저수준 네트워크 설정은 모바일에서 시스템이 처리할 수 있으므로, 실제 지원 범위는 클라이언트에서 확인해야 합니다.

다운로드 페이지로 이동

Linux

데스크톱에서는 Clash Verge Rev와 FlClash를 비교하고 배포판에 맞는 패키지 형식을 선택할 수 있습니다. 서버나 라우터 사용자는 mihomo 코어 다운로드 안내를 참고해 서비스와 설정 경로를 직접 관리할 수 있습니다. 투명 프록시를 활성화하기 전에 라우팅, DNS, 권한의 관계를 파악하고, 원격으로 작업할 때는 복구에 필요한 관리 연결을 유지하세요.

다운로드 페이지로 이동

설치 파일에는 클라이언트만 포함되며, 사용할 수 있는 프록시 서비스가 자동으로 제공되지는 않습니다. 구독 주소에는 보통 접근 자격 정보가 포함되므로 신뢰할 수 있는 기기에 보관하세요. 설정이나 로그를 공유하기 전에는 민감한 값을 삭제해야 합니다. 모든 클라이언트 보기 →

설정 필드 탐색

연결 경로는 진입점, 모드, DNS 해석, 노드, 정책, 규칙의 여섯 단계로 나눌 수 있습니다. 아래에서 설정을 여섯 단계로 살펴보세요. 먼저 요점을 확인한 다음 해당 YAML 예시를 볼 수 있습니다. 각 예시는 일부 설정만 보여주므로 서로 이어 붙여 완전한 구독 설정으로 사용할 수 없습니다. 필드를 직접 선택하면 자동 순환이 중지됩니다.

mixed-port: 7890allow-lan: false
bind-address: 127.0.0.1

port는 어떤 프로그램을 프록시로 연결하나요?

포트 필드는 원격 노드가 아닌 로컬 수신 포트를 지정합니다. port는 HTTP 프록시 연결을 받고, socks-port는 SOCKS 프록시 연결을 받으며, mixed-port는 하나의 포트에서 두 종류의 연결을 모두 받을 수 있습니다. 위 예시는 로컬에서만 수신하므로 앱의 프록시 주소를 로컬 주소와 해당 포트로 설정해야 합니다. 흔한 설정 오류는 코어만 실행하고 앱의 프록시를 설정하지 않는 경우와 두 클라이언트가 같은 포트를 사용하는 경우입니다. LAN에서 접근하도록 허용하기 전에는 바인딩 주소와 방화벽, 인증을 함께 확인하세요. 스위치 하나만 바꾸는 것으로는 충분하지 않습니다.

설정 필드 페이지에서 확인 →

구독 가져오기 및 연결 확인

처음 사용할 때는 가장 간단한 연결 경로부터 확인하세요. 설정이 불러와지고, 정책에 연결 경로가 있으며, 앱이 연결될 수 있어야 합니다. 포트, DNS, TUN, 규칙을 한꺼번에 바꾸지 말고 한 번에 한 단계씩 변경해야 문제가 생겼을 때 원인을 찾기 쉽습니다. 아래에서 전체 입문 과정을 세 단계로 미리 살펴볼 수 있습니다.

  1. 설정 가져오기

    클라이언트의 설정 또는 구독 관리 화면을 열고 신뢰할 수 있는 제공자가 안내한 구독 링크를 추가하거나 로컬 YAML 파일을 가져오세요. 업데이트가 끝나면 설정이 선택되었는지, 노드와 정책 그룹이 표시되는지 확인합니다. 파싱 오류가 표시되면 오류 줄 주변의 들여쓰기, 콜론, 목록 구조부터 살펴보세요. 설정 내용의 오류는 클라이언트를 반복해서 재설치해도 해결되지 않습니다. 원격 구독을 성공적으로 내려받았더라도 모든 노드가 연결되는 것은 아닙니다.

  2. 모드와 연결 경로 선택

    먼저 규칙 모드를 사용하고, 규칙에서 참조하는 주요 정책 그룹을 찾아 유효한 노드를 선택하세요. 데스크톱에서는 시스템 프록시를 켠 뒤 포트가 현재 클라이언트와 일치하는지 확인하고, 모바일에서는 안내에 따라 VPN 연결을 허용합니다. TUN은 시스템 프록시를 사용하지 않는 앱까지 처리해야 할 때 적합하지만 라우팅과 권한이 필요합니다. 일반 프록시 연결을 확인한 뒤 활성화해 연결 문제와 노드 문제를 혼동하지 않도록 하세요.

  3. 실제 연결 확인

    대상 웹사이트를 열고 클라이언트의 연결 목록에서 앱, 대상 도메인, 일치한 규칙, 최종 연결 경로를 확인하세요. 웹페이지가 열린다고 예상대로 트래픽이 분기된 것은 아니며, 속도 측정에 성공했다고 해당 사이트를 사용할 수 있는 것도 아닙니다. 브라우저는 정상인데 터미널만 실패하면 터미널이 프록시 환경 변수를 읽는지 확인하세요. 모든 연결이 시간 초과되면 로컬 네트워크와 노드 상태부터 점검합니다. 확인이 끝나면 임시로 켠 상세 로그를 원래대로 돌려놓으세요.

검증된 설정을 하나 보관한 뒤 앱별 분기나 자동 정책을 조금씩 추가하세요. 기준 설정으로 되돌려 보면 문제가 새 변경 사항 때문인지 네트워크 환경 때문인지 구분하기 쉽습니다. 전체 가이드 보기 →

Clash 생태계와 mihomo 코어

설정의 사용 가능 여부는 클라이언트 이름만 볼 것이 아니라 코어와 필드 지원 여부를 확인해야 합니다. 이 사이트는 다운로드 안내와 중국어 설정 필드 설명을 제공하며, 특정 클라이언트 개발팀의 공식 입장을 대변하지 않습니다. 기능 동작을 확인할 때는 오픈 소스 코드와 프로젝트 문서, 실제 실행 로그를 참고하세요.

프로젝트 역사와 호환 범위

Clash 생태계는 원 프로젝트의 유지 관리 중단 이후 커뮤니티 포크가 이어져 왔습니다. 기존 클라이언트에 저장된 YAML, 정책 선택, 로컬 설정을 새 클라이언트로 그대로 옮길 수 있다고 보장할 수는 없습니다. mihomo는 관련 설정 기능을 이어받아 확장했지만, 구형 코어는 새 프로토콜이나 필드를 인식하지 못할 수 있습니다. 예시를 참고할 때는 어떤 코어를 대상으로 작성된 문서인지 확인한 뒤 현재 환경에 적용할 수 있는지 판단하세요.

Clash for Windows와 ClashX Meta는 다운로드 목록에서 유지 관리가 중단된 보관 항목으로 표시합니다. 새 기기에는 계속 관리되는 대안을 우선 고려하세요. 구형 환경과의 호환성이 꼭 필요하다면 익숙한 화면만 보고 선택하지 말고 운영체제 호환성과 필요한 프로토콜을 먼저 확인해야 합니다. 클라이언트 선택 가이드 보기 →

클라이언트, 코어, 서비스 제공자

클라이언트는 설정 가져오기, 트레이 메뉴, 구독 업데이트, 시스템 프록시와 같은 기능을 담당합니다. 코어는 설정을 읽고 도메인을 해석하며 규칙을 적용해 아웃바운드 연결을 만듭니다. 서비스 제공자는 원격 서버와 구독 내용을 관리합니다. 세 구성 요소는 각각 별도로 문제를 일으킬 수 있습니다. 화면에 연결됨으로 표시되어도 로컬 상태가 활성화되었다는 뜻일 뿐, 원격 서비스가 사용 가능하거나 모든 앱의 트래픽이 처리된다는 보장은 없습니다.

같은 노드가 클라이언트마다 다르게 동작한다면 코어, 프로토콜 매개변수, DNS 처리 방식을 비교하세요. 같은 클라이언트가 네트워크에 따라 다른 결과를 보인다면 통신사 네트워크, 라우팅, 서버 측 제한도 고려해야 합니다. 모든 설정을 한꺼번에 바꾸기보다 문제를 계층별로 나누면 재현 가능한 원인을 찾기 쉽습니다.

오픈 소스 라이선스와 확인 자료

mihomo는 GPL-3.0 오픈 소스 라이선스를 사용하며, 소스 코드와 커밋 기록, 이슈 논의는 프로젝트 저장소에서 확인할 수 있습니다. 코어의 라이선스가 모든 GUI 클라이언트에도 동일하게 적용되는 것은 아니므로 배포하거나 수정하기 전에 해당 프로젝트의 안내를 확인하세요. 코드 공개는 구현을 살펴볼 수 있는 조건을 제공하지만, 설치 출처와 권한, 네트워크 동작을 판단하는 일을 대신하지는 않습니다.

필드 동작을 확인할 때는 먼저 해당 문서를 읽고 로그로 실제 동작을 검증하세요. 문제를 보고할 때는 운영체제, 클라이언트 이름, 코어 정보, 최소 설정, 재현 절차를 함께 적어야 합니다. 전체 구독 주소와 인증 정보, 개인을 식별할 수 있는 연결 기록은 공개하지 마세요. 재현 자료를 간결하게 정리하면 설정 오류와 프로그램 결함을 구분하는 데 도움이 됩니다.

업데이트 방식과 설정 보존

클라이언트 업데이트, 코어 업데이트, 구독 업데이트, 규칙 리소스 업데이트는 서로 다른 작업입니다. 클라이언트를 업데이트하면서 코어도 바뀔 수 있고, 구독 업데이트는 노드와 정책 그룹을 교체할 수 있으며, 규칙 리소스 업데이트는 해당 규칙 집합에만 영향을 줍니다. 작업 전에 어떤 계층이 변경되는지 확인하고 되돌릴 수 있도록 설정과 사용자 정의 항목을 보관하세요.

장기간 관리할 때는 원격 구독과 로컬 오버라이드를 분리하고 규칙의 용도를 기록하세요. 정책 그룹 이름이 바뀌면 사용자 규칙이 여전히 유효한 대상을 참조하는지 확인합니다. DNS 모드를 변경한 뒤에는 필요에 따라 관련 캐시를 지우고 테스트해 기존 매핑이 판단을 방해하지 않도록 하세요. 설정이 성공적으로 불러와진 다음 실제 연결로 업데이트 결과를 확인해야 합니다.

mihomo 소스 코드 확인

Git이 설치된 사용자는 아래 명령을 복사해 공개 저장소를 로컬에 내려받아 살펴볼 수 있습니다. 소스 코드를 복제해도 클라이언트가 설치되거나 실행되는 것은 아닙니다. 일반 사용자는 다운로드 페이지에서 GUI 클라이언트를 선택하면 됩니다.

git clone https://github.com/MetaCubeX/mihomo.git
mihomo 저장소 열기 ↗

설정 및 문제 해결 글

필드 참고 문서는 항목별 확인에 유용하고, 글에서는 하나의 문제를 중심으로 판단 과정을 설명합니다. 최근 게시물 세 편을 날짜순으로 소개합니다. 시스템 프록시 연결, 로그로 확인하는 증거, 여러 설정 관리 등 사용 중 마주치는 서로 다른 질문을 다룹니다.

모든 글 보기 →