오픈 소스 데스크톱 클라이언트 / YAML 설정 관리

Clash Nyanpasu 공식 사이트멀티 플랫폼 Clash
클라이언트 다운로드 및 설정

Clash 다운로드 가이드 보기

mihomo 엔진 기반의 Clash GUI 클라이언트입니다. 구독, YAML 설정과 분기 규칙을 한곳에서 관리하고, 멀티 플랫폼 데스크톱 인터페이스와 한국어 설정 참고 자료를 제공합니다.

  • LICENSEGPL-3.0
  • 오픈 소스
  • 한국어 문서

FIG 1 / CONFIGURATION WORKSPACE

설정 구조와 트래픽 분기

구독에서 설정을 제공하고, 클라이언트가 설정을 구성하며, 엔진이 규칙을 실행합니다.각 요소의 역할을 구분한 다음 오버라이드, 프록시 그룹 및 네트워크 연결 방식을 조정하세요.

Clash Nyanpasu는 데스크톱 설정 관리에 초점을 둡니다. 원격 구독을 가져온 뒤 설정이 정상적으로 로드되는지 확인하고, 프록시 그룹과 규칙의 대상도 살펴보세요. 아래 예시는 필드 간 관계를 설명하기 위한 것이며 실제로 연결할 수 있는 프록시 서비스는 포함하지 않습니다. 예시의 DIRECT는 직접 연결을 뜻합니다. 모바일 OS용 클라이언트는 아래 플랫폼 안내에서 확인하세요.

원격 구독과 로컬 변경 사항 분리하기

Profile은 클라이언트가 관리하는 설정 항목으로, 로컬 YAML 파일이나 원격 구독에서 가져올 수 있습니다. 구독 원문을 직접 수정하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다. 계속 유지할 포트, DNS, 사용자 규칙은 별도의 오버라이드에 넣고, 최종 생성된 설정을 확인하는 편이 좋습니다. 목록 필드의 교체·추가 방식과 스크립트 처리 방식은 클라이언트마다 다르므로 모든 병합을 단순 연결로 이해해서는 안 됩니다. Profile을 전환하기 전에 사용할 수 있는 사본을 보관하고, 로드한 뒤 로그를 확인해 오버라이드 필드가 예상한 계층에 적용됐는지 살펴보세요.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
오버라이드와 병합 안내 보기 →

FIG 2 / PLATFORM SELECTOR

Clash 클라이언트 플랫폼 안내

데스크톱과 모바일은 각각 적합한 클라이언트를 선택하세요.
설치 파일, 아키텍처 및 시스템 요구 사항은 다운로드 페이지에서 확인할 수 있습니다.

Clash Nyanpasu의 데스크톱용 기능과 Clash 생태계의 멀티 플랫폼 선택지는 구분해야 합니다. Windows, macOS, Linux 사용자는 데스크톱 환경과 설정 방식에 맞는 GUI 클라이언트를 고를 수 있습니다. Android와 iOS에서는 해당 OS용 앱을 사용해야 하며 데스크톱 프로그램을 설치할 수 없습니다. 이 페이지에서 5개 플랫폼의 다운로드 안내를 제공하며, 구체적인 클라이언트 목록은 다운로드 페이지에서 확인하세요. 기존 구독도 출력 형식을 확인해야 합니다. 앱마다 지원하는 필드가 다를 수 있습니다.

Windows

시스템 프록시, 설정 편집, 서비스 모드가 필요한 데스크톱 사용자에게 적합합니다. 다운로드 전에 시스템 설정의 「시스템 → 정보」를 열어 프로세서 아키텍처를 확인하고 알맞은 설치 파일을 선택하세요. 처음 실행하면 사용할 수 있는 설정을 가져와 포트 충돌 여부를 확인한 뒤 시스템 프록시를 켜세요. TUN이 필요하다면 그다음 서비스 권한을 설정하면 됩니다.

Clash for Windows에서 옮길 때는 원본 설정과 사용자 규칙을 먼저 백업하세요. 새 클라이언트는 설정 디렉터리, 오버라이드 메뉴, 엔진 필드 지원 범위가 다를 수 있으므로 앱 데이터 전체를 덮어쓰기보다 항목별로 옮기는 것이 좋습니다.

다운로드 Windows 클라이언트

macOS

「이 Mac에 관하여」에서 Apple Silicon 또는 Intel을 확인한 뒤 알맞은 설치 파일을 선택하세요. 설치 후에는 시스템 안내에 따라 실행을 허용합니다. 백그라운드 서비스나 네트워크 관련 권한이 필요한지는 선택한 클라이언트와 연결 방식에 따라 달라집니다. 일반 시스템 프록시가 정상 작동하는지 먼저 확인하고 다른 네트워크 기능을 하나씩 켜면 권한이나 설정 문제를 찾기 쉽습니다.

클라이언트를 바꾸기 전에 기존 앱을 종료하고 시스템 프록시를 끄세요. 브라우저가 계속 이전 프록시 주소를 사용한다면 구독을 반복해서 가져오기보다 시스템 네트워크 설정을 확인해야 합니다.

다운로드 macOS 클라이언트

Android

기기의 아키텍처에 맞는 Android 클라이언트를 설치한 뒤 호환되는 구독 설정을 가져오세요. 처음 연결할 때 시스템에서 VPN 연결 권한을 요청할 수 있습니다. 이는 앱이 로컬 네트워크 연결 경로를 설정하기 위한 절차이며, 구독이 정상 작동한다는 뜻은 아닙니다. 설정이 로드됐는지와 규칙 대상이 올바른지 따로 확인하세요.

백그라운드 실행은 시스템의 배터리 정책에 영향을 받습니다. 앱을 전환한 뒤 연결이 끊긴다면 설정을 먼저 바꾸기보다 배터리 최적화와 백그라운드 제한을 확인하세요. 다른 VPN 앱이 실행 중이라면 시스템 연결을 점유하고 있는지도 살펴보세요.

다운로드 Android 클라이언트

iOS

iPhone과 iPad 사용자는 다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 앱 안내에 따라 설정을 가져온 다음 시스템 메시지가 표시되면 VPN 구성을 허용하세요. 구독 링크는 신뢰할 수 있는 출처에서 받아야 합니다. 접속 정보가 포함된 전체 URL을 스크린샷이나 공개 게시물에 노출하지 마세요.

데스크톱 설정 파일을 이전할 때 참고할 수는 있지만, 모든 스크립트와 오버라이드 기능이 그대로 작동한다고 가정해서는 안 됩니다. 가져온 뒤 앱이 지원하는 필드와 프록시 그룹을 먼저 확인하고 필요한 부분을 조정하세요.

다운로드 iOS 클라이언트

Linux

데스크톱 사용자는 배포판의 패키지 형식에 맞는 GUI 클라이언트를 선택하고 데스크톱 세션에 필요한 의존성도 확인하세요. 서버나 라우터에서 사용할 경우 다운로드 페이지의 mihomo 엔진 항목을 참고할 수 있습니다. 엔진만으로는 데스크톱 설정 관리 인터페이스를 제공하지 않으므로 설정 경로, 실행 인수와 서비스 수명 주기를 직접 관리해야 합니다.

시스템 프록시가 적용되는 범위는 데스크톱 환경과 명령줄 도구에 따라 다릅니다. 특정 앱이 프록시를 사용하지 않는다면 먼저 시스템 설정을 읽는 앱인지 확인하고, 앱별 프록시 옵션이나 다른 연결 방식을 검토하세요.

다운로드 Linux 클라이언트

클라이언트는 로컬 설정과 연결을 관리하며 프록시 서비스는 제공하지 않습니다. 가져오기에 실패하면 구독 형식을 확인하고, 연결에 문제가 있으면 모드, 규칙 대상, 시스템 프록시를 차례로 점검하세요. 처음 설정하는 순서는 빠른 시작 가이드에서, 필드의 의미는 용어 가이드에서 확인할 수 있습니다.

전체 클라이언트 보기 →

FIG 3 / SOURCE & RUNTIME

오픈 소스 프로젝트와 엔진의 관계

GUI / PROFILE / CORE

클라이언트와 Clash 생태계

Clash Nyanpasu는 Clash 생태계의 오픈 소스 데스크톱 GUI 클라이언트입니다. Clash는 초기 프로젝트의 이름으로 쓰이기도 하고, 호환 설정 형식과 관련 클라이언트를 가리키기도 합니다. 가이드를 읽을 때는 프로젝트 이름과 설정 문법을 구분해야 합니다. 특정 구형 클라이언트의 메뉴 경로를 모든 앱에 그대로 적용할 수는 없습니다. Clash for Windows 대체 클라이언트를 찾을 때는 이름이 비슷한지보다 설정 이전, 엔진 지원, 서비스 권한을 비교하세요.

GUI와 mihomo의 역할

클라이언트는 구독 항목, UI 조작, 설정 생성과 시스템 연동을 담당하고, mihomo는 설정을 읽어 프로토콜 처리, 규칙 매칭, DNS 등의 작업을 수행합니다. 인터페이스에 스위치가 보인다고 해서 엔진이 해당 설정을 정상적으로 불러왔다는 뜻은 아닙니다. 생성된 설정과 시작 로그를 함께 확인해 문제를 진단하세요. 파싱 오류는 YAML 계층을, 참조 오류는 그룹 이름을, 리스닝 실패는 포트 사용 여부를 먼저 점검하면 서로 다른 문제를 혼동하지 않을 수 있습니다.

소스 코드, 라이선스와 이슈

프로젝트 소스 코드는 Clash Nyanpasu 오픈 소스 저장소에서 확인할 수 있으며, GPL-3.0 라이선스를 따릅니다. 소스 코드는 구현 내용을, 릴리스 노트는 변경 사항을, 이슈 기록은 알려진 동작을 파악하는 데 도움이 됩니다. 이슈를 등록할 때는 OS, 재현 절차, 예상 결과와 관련 로그를 적고 구독 URL, 인증 정보, 개인 도메인은 삭제하세요. 관련 없는 필드가 잔뜩 포함된 전체 설정보다 재현 가능한 최소 설정이 문제를 파악하기 쉽습니다.

클라이언트 업데이트와 설정 업데이트

앱 업데이트, 엔진 업데이트, 구독 업데이트는 서로 다른 작업입니다. 앱 업데이트는 인터페이스나 설정 처리 방식을 바꿀 수 있고, 엔진 업데이트는 필드 지원에 영향을 줄 수 있으며, 구독 업데이트는 원격 콘텐츠를 교체합니다. 업데이트 전에 로컬 오버라이드와 정상 작동하는 설정을 백업하고, 업데이트 후에는 기존 기본 기능부터 확인한 다음 새 필드를 적용하세요. 문제를 진단하는 동안 클라이언트 교체, DNS 변경, 규칙 재작성까지 한꺼번에 하면 원인을 찾기 어렵습니다.

프로젝트 소스 코드 받기

로컬에 Git이 필요합니다. 저장소를 복제하면 소스 코드만 내려받으며, 빌드 방법은 저장소 문서를 참고하세요. 일반적으로 사용하려면 다운로드 페이지의 설치 파일을 이용하세요.

git clone https://github.com/LibNyanpasu/clash-nyanpasu.git

설정 문서 읽는 순서

처음 사용한다면 빠른 시작 가이드를 읽고 설정 가져오기, 모드 선택, 시스템 프록시 설정을 완료하세요. Profile, fake-ip, 프록시 그룹 같은 개념은 용어 가이드에서 확인할 수 있습니다. 필드를 수정할 때는 YAML 설정 가이드를 참고해 공통 필드, 프록시, 프록시 그룹, 규칙, 오버라이드 순으로 살펴보세요. 예시는 내용을 이해한 뒤 사용하고, 특히 규칙의 모든 대상이 정의되어 있는지 확인하세요. 설명용 코드 조각을 완성된 구독 설정으로 사용해서는 안 됩니다.

Clash 무료 노드나 VPN 구독 서비스를 이용하더라도 클라이언트는 설정을 읽을 뿐, 제3자 서비스의 가용성·개인정보 처리·지속성을 보장하지 않습니다. 제공처를 선택할 때는 서비스 약관과 이용 범위를 확인하세요. 장애 화면을 공유하기 전에는 구독 URL을 가려야 합니다. 설정을 가져오는 데 성공했다는 것은 형식이 받아들여졌다는 뜻일 뿐, 네트워크 연결이나 트래픽 분기가 예상대로 작동한다는 보장은 아닙니다.

READING / RECENT NOTES

설정 및 플랫폼 가이드

전체 글 보기 →

블로그 글은 한 번에 하나의 작업 주제를 다룹니다. 규칙 글에서는 매칭 순서를, 플랫폼 글에서는 시스템 권한을, 설정 글에서는 여러 Profile을 관리하는 방법을 알아봅니다. 문제를 해결 중이라면 작동하는 설정 하나를 기준으로 삼고 원본 로그를 보관한 뒤, 글에 나온 변수를 하나씩 조정하세요. 서로 다른 OS의 권한 경로나 클라이언트 조작 방법을 섞어 적용하지 마세요.

고급 규칙

Clash 사용자 규칙 작성법: rules 문법, 매칭 순서와 우선순위

DOMAIN-SUFFIX, IP-CIDR, GEOIP, RULE-SET, MATCH 등 규칙 유형의 문법을 살펴보고, 위에서 아래로 검사해 처음 일치한 규칙을 적용하는 방식과 규칙 정렬 기준을 설명합니다.

글 읽기 →
플랫폼별 설정

macOS에 Clash Nyanpasu 설치하기: 네트워크 확장 권한과 키체인 알림 해결

macOS에서 앱을 열 수 없는 문제, 서비스 모드 권한, 네트워크 확장 허용, 키체인 알림 반복 표시 등의 해결 방법을 시스템 설정 경로에 따라 안내합니다.

글 읽기 →
프로필 관리

Clash Profile이란? 설정 파일의 기본 개념과 여러 설정 전환 및 관리

Profile과 config.yaml의 관계부터 로컬 설정, 원격 구독, 오버라이드 스크립트의 역할까지 살펴보고 여러 설정을 함께 사용할 때의 이름 지정, 전환, 백업 방법을 안내합니다.

글 읽기 →
Clash 최신 버전 다운로드