Clash Nyanpasu에서는 그래픽 인터페이스로 설정과 프록시 모드, 코어 실행 상태를 관리할 수 있습니다. 처음 사용할 때는 설정이 정상적으로 불러와지는지 확인한 다음, 트래픽이 코어로 들어오는 경로를 점검하고 규칙에 따라 어떤 프록시 그룹으로 연결되는지 살펴보세요. 아래 화면은 각 기능의 역할을 이해하기 위한 설정 예시입니다. 실제 메뉴 이름과 사용 가능한 옵션은 설치한 클라이언트에 따라 다를 수 있습니다.
현재 모드
설정의 의미를 설명하기 위한 예시 화면입니다.
프록시 모드는 코어로 들어온 연결이 어떤 경로로 나갈지 결정합니다. 일반적인 사용 환경에서는 먼저 규칙 모드를 선택해 도메인, 주소와 규칙 집합을 설정에 따라 라우팅할 수 있습니다. 전역 모드는 모든 연결을 전역 정책으로 보내므로 출구를 임시로 확인할 때 유용하고, 직접 연결 모드는 네트워크 상태를 비교할 때 사용할 수 있습니다. 모드를 바꿔도 작동하지 않는 구독이 복구되거나 앱의 시스템 프록시 사용 여부가 달라지지는 않습니다. mihomo를 사용하는 다른 그래픽 클라이언트와 마찬가지로 라우팅 결과는 주로 코어와 설정에 따라 달라지며, 인터페이스의 이름이 결과를 결정하지는 않습니다. 문제를 확인할 때는 한 번에 설정 하나씩 바꿔야 원인을 파악하기 쉽습니다.
원격 설정 가져오기
구독 관리는 원격 링크를 불러올 수 있는 로컬 설정으로 변환합니다. 가져오기 전에 링크가 Clash 호환 설정을 반환하는지 확인하세요. 로그인 페이지나 오류 메시지, 다른 클라이언트 전용 형식이라면 사용할 수 없습니다. 가져온 뒤에는 해당 설정을 선택하고 프록시 그룹이 표시되는지 확인한 다음 필요에 따라 자동 업데이트를 켜세요. 원격 업데이트로 직접 수정한 내용이 덮어써질 수 있으므로, 계속 유지해야 하는 변경 사항은 클라이언트가 지원하는 오버라이드 또는 병합 기능으로 관리해야 합니다. 클라이언트마다 구독 메뉴와 병합 방식이 다를 수 있으니, 다른 클라이언트로 옮길 때는 구독 이름만 비교하지 말고 최종 적용된 설정을 확인하세요.
규칙 예시 · Proxy는 미리 정의해야 합니다
DOMAIN-SUFFIX,github.com,Proxy
GEOIP,CN,DIRECT
MATCH,Proxy규칙은 연결을 식별하고 프록시 그룹은 연결 경로를 결정하므로, 두 항목을 정확한 이름으로 연결해야 합니다. 이 예시에서는 지정한 도메인을 Proxy로 보내고, 중국 본토 주소는 직접 연결 규칙으로 처리한 뒤 나머지 연결에는 MATCH를 적용합니다. 여기서 Proxy는 프록시 그룹 이름일 뿐 자동으로 생성되는 예약어가 아닙니다. 규칙을 더 구체적으로 작성해도 앞에 범위가 더 넓은 규칙이 있으면 적용되지 않을 수 있습니다. 같은 설정을 다른 클라이언트로 옮길 때는 규칙 집합과 데이터베이스, 코어의 지원 여부도 함께 확인하세요. 연결이 잘못된 경로로 나가면 연결 기록에서 실제로 매칭된 규칙부터 확인하는 것이 좋습니다.
사용 가능한 네트워크 스택
시스템 프록시는 운영체제의 프록시 설정을 통해 앱의 연결을 유도하므로 브라우저처럼 해당 설정을 따르는 소프트웨어에 적합합니다. TUN은 가상 네트워크 인터페이스와 라우팅을 이용해 더 많은 트래픽을 처리합니다. 시스템 프록시를 사용하지 않는 앱에 유용하지만, 필요한 권한을 부여하고 DNS나 다른 가상 네트워크 어댑터와 충돌하지 않는지 확인해야 합니다. 네트워크 스택은 시스템과 앱의 호환성을 기준으로 선택해야 하며, 특정 옵션이 항상 더 빠르다고 볼 수는 없습니다. 그래픽 클라이언트마다 서비스 설치와 권한 요청 방식이 다를 수 있습니다. 처음 설정할 때는 시스템 프록시로 연결을 확인한 뒤 TUN을 별도로 켜서 비교해 보세요.
설정 예시이며, 실제 지원 범위는 클라이언트 빌드에 따라 다릅니다.
클라이언트 인터페이스와 프록시 코어는 서로 다른 역할을 합니다. 인터페이스는 설정과 조작 메뉴를 관리하고, 코어는 규칙을 해석하고 연결을 설정하며 프로토콜을 처리합니다. 일반적으로는 구독과 호환되는 mihomo 안정 버전을 사용하는 것이 좋습니다. Alpha 버전은 검증 중인 변경 사항을 시험할 때 사용하며, 전환하기 전에 릴리스 노트를 읽고 기존 설정을 보관하세요. 다른 코어가 같은 설정 항목을 지원한다고 보장할 수 없으므로 이름이 비슷하다는 이유만으로 대체해서는 안 됩니다. 코어를 바꿀 수 있는 클라이언트는 특정 코어에 고정된 클라이언트보다 호환성 문제를 찾기 쉽지만, 조합에 따른 차이가 늘어날 수 있습니다. 설정을 불러오지 못하면 먼저 로그에서 알 수 없는 항목이나 프로토콜 관련 메시지를 확인하세요.
설정 스위치를 많이 켜는 것보다 순서를 지키는 것이 중요합니다. 구독을 성공적으로 가져왔다는 것은 설정이 저장됐다는 뜻일 뿐입니다. 코어가 정상적으로 시작되어야 설정을 해석할 수 있고, 연결이 기록에 나타나야 트래픽이 클라이언트에 들어왔다는 것을 알 수 있습니다. 마지막으로 매칭된 규칙과 예상 출구가 일치하는지 확인해야 합니다. 각 단계를 나눠 점검하면 모드와 DNS, 네트워크 스택을 한꺼번에 바꾸는 것보다 문제를 찾기 쉽습니다.
기존 설정도 계속 사용할 수 있지만, 먼저 백업한 다음 옮기세요. 원격 규칙 집합이나 외부 파일, 오버라이드 스크립트를 사용하는 경우 새 클라이언트가 해당 기능을 지원하는지 확인해야 합니다. 인터페이스 설정과 구독 파일이 최종 설정에 함께 영향을 줄 수 있으므로 충돌이 발생하면 실제로 불러온 결과를 기준으로 판단하세요. Fake-IP, 프록시 그룹, 규칙 제공자 같은 개념은 용어 설명에서 확인할 수 있습니다.
먼저 운영체제를 선택한 뒤 프로세서 아키텍처와 설치 방식을 확인하세요. Clash Nyanpasu는 데스크톱 클라이언트입니다. 스마트폰과 태블릿에서는 해당 플랫폼의 클라이언트를 선택해야 합니다. 플랫폼별 링크는 다운로드 센터에서 해당 운영체제에 맞는 선택 정보를 제공한다는 뜻이며, 모든 소프트웨어에 같은 이름의 모바일 버전이 있다는 의미는 아닙니다. 다운로드 페이지에서 설치 파일과 시스템 요구 사항, 유지 관리 상태를 확인할 수 있습니다. 실제 배포 범위는 페이지에 안내된 내용을 기준으로 확인하세요.
Clash Nyanpasu, Clash Plus, Clash Verge Rev 등 데스크톱 클라이언트를 살펴보세요. 설치 전에 시스템 아키텍처를 확인하고, 처음 실행하면 설정을 가져와 시스템 프록시가 작동하는지 점검하세요. 더 많은 앱의 트래픽을 처리해야 한다면 서비스 권한과 TUN 설정도 확인해야 합니다. 다른 프록시 프로그램이 실행 중이라면 포트나 시스템 프록시 설정이 서로 덮어쓰지 않도록 먼저 정리하세요.
다운로드 페이지로 이동 →Apple Silicon 또는 Intel 프로세서에 맞는 설치 파일을 선택하고 클라이언트가 요구하는 macOS 버전 범위를 확인하세요. 네트워크 확장, 백그라운드 서비스 또는 라우팅 권한이 필요한 경우 시스템 알림에 표시된 안내를 읽으세요. 클라이언트를 바꾸기 전에 기존 프로그램을 종료해 여러 프로그램이 같은 시스템 프록시 설정을 반복해서 수정하지 않도록 하세요.
다운로드 페이지로 이동 →Clash Plus, Clash Meta for Android, FlClash, Surfboard 등에서 구독 형식과 사용 방식에 맞는 클라이언트를 선택하세요. 처음 연결할 때는 시스템 VPN 권한을 허용해야 하는 경우가 많습니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한도 확인하세요. 설정을 옮기기 전에 대상 클라이언트가 기존 구독 프로토콜을 지원하는지 확인해야 합니다.
다운로드 페이지로 이동 →다운로드 센터에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io 정보를 확인할 수 있습니다. 설치한 뒤 호환되는 설정을 가져오고, 시스템 안내에 따라 VPN 구성을 허용한 다음 프록시 그룹 선택을 확인하세요. 데스크톱의 파일 경로와 스크립트, 권한 설정을 휴대폰에 그대로 적용할 수는 없습니다. 기능을 옮길 때는 모바일 클라이언트가 실제로 지원하는 범위를 기준으로 하세요.
다운로드 페이지로 이동 →데스크톱 환경에서는 Clash Verge Rev와 FlClash를 확인하고, 배포판의 패키지 형식과 의존성 요구 사항에 맞춰 설치하세요. 서버나 라우터에서 사용할 경우 mihomo 코어 패키지를 별도로 살펴볼 수 있지만, 코어만으로는 완전한 그래픽 클라이언트가 되지 않습니다. 시스템 트레이, 시스템 프록시와 서비스 관리 방식은 배포판에 따라 다를 수 있으므로 시작 문제가 발생하면 먼저 로그를 확인하세요.
다운로드 페이지로 이동 →클라이언트를 고를 때 인터페이스만 비교하지 마세요. 같은 구독에도 특정 코어에서만 지원하는 프로토콜이나 설정 항목이 포함될 수 있습니다. 클라이언트를 설치할 수 있다고 해서 설정까지 호환되는 것은 아닙니다. 유지 관리가 계속되고 시스템 요구 사항이 명확하며 현재 설정에 맞는 제품을 우선 선택하세요. 보관된 클라이언트는 과거 동작을 확인하는 데 유용하지만, 장기간 사용하기 전에는 호환성과 유지 관리 상태를 따져봐야 합니다. 자세한 기능 차이는 클라이언트 비교 평가에서 확인하세요.
처음 설정할 때는 “설정 사용 가능, 트래픽 연결, 출구 확인” 순서로 진행하면 됩니다. 클라이언트는 설정을 읽고 프록시 연결을 만들며, 구독에 포함된 서버와 인증 정보, 사용 기간은 구독 제공자가 관리합니다. 소프트웨어를 설치한 뒤에도 사용 가능한 설정이 필요합니다. 링크가 만료됐다면 클라이언트를 반복해서 재설치하기보다 구독부터 확인하세요.
설정 또는 구독 관리 메뉴를 열고 전체 링크를 붙여넣은 뒤 가져오기를 실행하세요. 목록에 설정이 나타나면 현재 사용할 항목으로 지정하고 프록시 그룹이 불러와졌는지 확인합니다. 구문 분석에 실패했다는 메시지가 표시되면 링크가 설정 파일을 반환하는지 웹 페이지를 반환하는지 확인하고, 접근 인증 정보를 갱신해야 하는지도 살펴보세요. 구독 링크에는 개인 접근 정보가 포함되는 경우가 많으므로 문제를 확인할 때 전체 링크를 스크린샷이나 게시판에 공개하지 마세요.
가져온 뒤에는 연결을 확인하기 전까지 기존 규칙을 유지하고 오버라이드를 추가하지 않는 편이 좋습니다. 설정이 여러 개라면 용도를 알아볼 수 있는 이름을 지정하고, 전환할 때마다 현재 설정 표시가 바뀌었는지 확인하세요. 그래야 이후 연결 기록을 볼 때 어떤 규칙을 테스트 중인지 알 수 있습니다.
프록시 모드에서 규칙을 선택한 다음 앱의 필요에 따라 시스템 프록시를 켜세요. 주요 프록시 그룹으로 이동해 사용 가능한 출구나 적절한 자동 선택 그룹이 선택되어 있는지 확인합니다. 먼저 브라우저로 연결을 테스트하세요. 앱의 연결이 기록에 나타나지 않는다면 시스템 프록시를 따르지 않을 수 있으므로 TUN 설정을 확인해 보세요. TUN은 트래픽을 처리하는 범위를 바꾸는 기능이지, 모든 네트워크 문제를 자동으로 해결하는 기능은 아닙니다.
TUN을 처음 켤 때는 권한 안내와 다른 VPN 또는 가상 네트워크 어댑터 프로그램의 상태를 확인하세요. 한 번에 설정 하나만 변경하고 정상적으로 연결되는 조합을 기록해 두세요. 이전 상태로 되돌려야 한다면 방금 켠 트래픽 처리 방식을 먼저 끄고 시스템 프록시와 라우팅 설정이 복원됐는지 확인하세요.
테스트할 웹사이트나 앱에 접속한 뒤 클라이언트의 연결 기록에서 요청 도메인, 매칭된 규칙과 사용된 프록시 그룹을 확인하세요. 페이지가 열리는 것은 첫 단계일 뿐입니다. 직접 연결해야 하는 연결이 프록시를 거치지 않는지, 지정한 프록시 그룹을 사용해야 하는 연결이 올바른 규칙과 매칭됐는지도 확인해야 합니다. 지연 시간 테스트는 특정 요청의 결과만 보여주므로 다운로드나 동영상, 업무용 앱에서의 실제 사용 경험을 대신할 수 없습니다.
문제가 발생하면 최소한의 재현 정보를 기록하세요. 어떤 앱에서 어떤 작업을 했는지, 어떤 설정을 사용했는지, 로그에 어떤 오류가 표시됐는지를 정리하면 됩니다. 로그를 공유하기 전에는 구독 링크와 접근 인증 정보, 개인 주소를 삭제하세요. 이러한 정보를 구체적으로 정리하면 단순히 “인터넷이 안 된다”고 설명하는 것보다 DNS, 규칙, 출구 또는 권한 중 어느 단계의 문제인지 찾기 쉽습니다.
소프트웨어의 출처를 파악할 때는 인터페이스, 코어와 구독의 역할도 구분해야 합니다. Clash Nyanpasu의 소스 코드와 개발 기록은 공개 저장소에서 확인할 수 있습니다. 실제 기능은 클라이언트 빌드와 코어의 지원 범위, 구독 내용에 따라 달라집니다. 이 페이지는 기능별 사용 흐름을 안내하며, 확인되지 않은 다운로드 수나 평점, 성능 수치를 클라이언트 선택 기준으로 제시하지 않습니다.
Clash Nyanpasu는 Clash 그래픽 클라이언트 생태계에 속하며 데스크톱 인터페이스를 Tauri로 구축했습니다. 공개 저장소에서 소스 코드와 이슈 논의, 릴리스 기록을 확인할 수 있어 특정 기능이 구현됐는지 또는 동작이 변경되고 있는지 살펴보는 데 유용합니다. 프로젝트 이력은 커밋 기록과 릴리스 노트를 통해 확인하세요. 이름이 비슷하다는 이유만으로 다른 클라이언트와의 계승 관계를 단정해서는 안 됩니다.
인터페이스 조작에 문제가 있다면 저장소의 논의에서 증상과 오류 메시지를 검색해 보세요. 문제를 제보할 때는 운영체제와 재현 단계, 관련 로그를 설명하고 개인 설정 전체를 첨부하지 마세요. 오픈 소스라고 해서 모든 환경에서 같은 결과가 보장되는 것은 아닙니다. 자신의 시스템에서 직접 확인해야 하며, 다른 사용자의 테스트 결과를 모든 기기의 결과로 간주해서는 안 됩니다.
그래픽 클라이언트는 구독 관리와 설정 메뉴, 프로세스 제어 및 상태 표시를 담당하고, mihomo는 설정을 해석하고 규칙을 매칭해 연결을 처리합니다. 두 계층은 역할이 구분되어 있으므로 인터페이스를 바꿔도 같은 설정의 라우팅 결과가 달라지지 않을 수 있습니다. 반면 코어를 바꾸면 프로토콜과 DNS, 규칙 항목의 호환성에 영향을 줄 수 있습니다. Meta와 mihomo의 관계도 코어가 발전해 온 맥락에서 살펴볼 필요가 있습니다.
화면 설정은 저장되지만 코어가 시작되지 않는다면 설정 구문 분석과 실행 로그를 먼저 확인하세요. 코어는 정상적으로 실행되는데 앱 연결이 나타나지 않는다면 트래픽 처리 방식을 점검해야 합니다. 문제를 해당 계층에 맞춰 살펴보면 클라이언트 옵션이나 구독 내용을 조정할지, 코어 문서를 확인할지 판단하기 쉬워 불필요한 재설치를 줄일 수 있습니다.
구독은 설정을 배포하는 방식이지 클라이언트에 연결 서비스가 내장되어 있다는 뜻은 아닙니다. 링크는 완전한 Clash 설정을 반환할 수도 있고, 다른 형식의 서버 정보만 제공할 수도 있습니다. 파일을 읽을 수 있더라도 내부의 프로토콜과 규칙 집합, 오버라이드 방식이 특정 코어나 클라이언트 확장 기능에 의존할 수 있습니다. 다른 클라이언트로 옮길 때는 먼저 형식을 확인하고 설정이 참조하는 외부 리소스에 접근할 수 있는지도 점검하세요.
같은 링크가 클라이언트마다 다르게 작동하는 원인은 링크 자체의 불안정성이 아니라 요청 방식과 설정 변환, 기능 지원 범위의 차이일 수 있습니다. 정상 작동하는 설정을 비교용으로 보관하고 자동 업데이트를 켰는지도 기록해 두세요. 장기간 유지할 규칙을 수정하기 전에는 오버라이드 방식을 확인해 다음 구독 업데이트에서 로컬 변경 사항이 덮어써지지 않도록 하세요.
클라이언트 업데이트와 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스나 권한 처리 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜과 설정 동작에 영향을 줄 수 있으며, 구독 업데이트는 보통 서버와 라우팅 내용을 변경합니다. 업데이트 전에 관련 안내를 읽고 오버라이드와 필요한 설정을 백업하세요. 변경이 발생하면 세 가지 항목을 각각 확인해야 실제 원인을 찾을 수 있습니다.
안정적으로 사용하려면 호환성을 우선하고 테스트 빌드가 나왔다고 바로 전환할 필요는 없습니다. 문제를 확인하기 위해 Alpha를 사용한다면 기존 설치본과 설정으로 되돌릴 방법을 남겨두고 전환 전후의 차이를 기록하세요. 페이지 상단에는 특정 릴리스 번호를 표시하지 않습니다. 설치 파일과 배포 정보는 다운로드 센터에서 확인하세요. 홈페이지의 소개를 실시간 릴리스 기록으로 오해하지 않도록 주의하세요.
Git이 설치되어 있다면 아래 명령을 터미널에 복사하세요. 복제하면 프로젝트 소스 코드를 받을 수 있습니다. 설치해서 사용하려는 경우에는 다운로드 센터에서 클라이언트를 선택하세요.
git clone https://github.com/libnyanpasu/clash-nyanpasu.git기본 연결을 설정한 다음 문제에 맞는 심화 자료를 확인하세요. 라우팅 결과가 예상과 다르면 규칙 순서를 먼저 살펴보고, 속도 측정값과 실제 체감이 다르면 연결 지연 시간과 전송 대역폭을 구분하세요. 주소 분류가 달라졌다면 데이터베이스와 규칙 집합을 점검해야 합니다. 아래 글은 혼동하기 쉬운 개념을 각각 설명하며 최신 글부터 날짜 역순으로 정렬되어 있으니 구체적인 질문에 맞춰 읽어보세요.
GeoIP와 GeoSite 데이터 파일의 출처 및 형식 차이를 살펴보고, mihomo의 geodata-mode와 사용자 지정 업데이트 주소, 자동 업데이트 설정 방법을 설명합니다. 데이터가 오래됐을 때 나타나는 대표적인 증상도 정리합니다.
데이터베이스 업데이트 가이드 보기 →클라이언트의 지연 시간 테스트가 무엇을 측정하는지, 테스트 주소와 제한 시간이 결과에 어떤 영향을 주는지 설명합니다. 연결 지연 시간과 대역폭, 회선 혼잡의 차이를 알아보고 측정 결과를 올바르게 해석할 수 있도록 돕습니다.
지연 시간 테스트의 한계 알아보기 →자주 쓰이는 라우팅 사례를 바탕으로 위에서 아래로 적용되는 규칙 매칭 순서와 프록시 그룹 참조 방법, rule-providers 원격 규칙 집합 구성법을 설명합니다. 규칙을 잘못 배치해 트래픽이 엉뚱한 경로로 나가는 일을 방지할 수 있습니다.
규칙 구성 방법 보기 →문제가 어느 유형에 속하는지 판단하기 어렵다면 자주 묻는 질문에서 증상을 먼저 확인한 다음 가이드로 돌아가 가져오기와 모드, 트래픽 처리 단계를 점검하세요. 기술 참고 자료는 프로토콜과 코어의 차이를 비교할 때, 용어 설명은 설정 항목을 빠르게 이해할 때 유용합니다. 조작 절차와 원리 자료를 나눠 읽으면 문제를 확인할 때 판단 흐름을 명확하게 유지할 수 있습니다.