오픈 소스 클라이언트 · 설정 안내를 지속적으로 정리

Clash Nyanpasu 설정 가이드

공식 Clash 다운로드 입문 가이드 보기

사용 가능한 클라이언트와 사용법을 한곳에서 확인하고, 구독 가져오기, 규칙 분기, TUN 모드를 익혀 보세요. 먼저 기기에 맞는 다운로드 페이지로 이동한 다음 가이드에 따라 최초 연결과 트래픽을 확인합니다.

영구 무료 오픈 소스 한국어 문서 Mihomo 커널 생태계
Windows Android iOS macOS Linux
커널 생태계 Mihomo 규칙 및 프록시 프로토콜 기반
라이선스 GPL-3.0 공개되어 검토 가능한 코드
설정 핵심 구독, 분기, DNS 최초 가져오기부터 안정적인 사용까지
핵심 설정

구독 가져오기부터 안정적인 트래픽 분기까지

각 설정은 명확한 네트워크 범위와 연결됩니다. 시스템 프록시, TUN, 규칙 모드와 DNS의 역할을 먼저 이해한 뒤 스위치를 조정하면 노드를 계속 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다.

설정 1

구독 주소를 관리 가능한 설정으로 변환

구독 가져오기는 단순히 URL 하나를 저장하는 작업이 아닙니다. 클라이언트가 원격 콘텐츠를 요청하고 프록시 노드와 정책 그룹을 분석한 뒤 선택 가능한 로컬 설정을 생성합니다. 주소를 붙여넣은 후에는 요청이 성공했는지 먼저 확인하고, 방금 가져온 설정을 선택한 다음 정책 그룹이 표시되는지 확인하세요. 목록이 비어 있다면 같은 주소를 계속 추가하기보다 주소의 완전성, 네트워크 권한과 구독 서비스 상태를 우선 점검해야 합니다.

Clash Nyanpasu는 설정 관리, 업데이트 시간과 활성화 상태를 한곳에 모아 보여 주므로 일상 설정과 문제 해결용 백업 설정을 함께 관리하기 좋습니다. 업데이트 전 현재 정책 선택을 기록하고, 업데이트 후 규칙 그룹 이름이 바뀌었는지 확인하면 새 설정이 기존 선택을 덮어쓴 상황을 연결 장애로 잘못 판단하는 일을 피할 수 있습니다.

  • ×가져오기만 완료하고 설정을 선택하지 않으면 프록시 목록은 새 내용으로 전환되지 않습니다.
  • ✓가져오기, 활성화, 정책 그룹 선택을 순서대로 확인하면 문제가 어느 단계에서 발생했는지 판단할 수 있습니다.
구독 가져오기 설정 관리
https://example.com/subscription
저장 후 업데이트
일상 규칙 설정 선택됨, 수동 업데이트 가능
플랫폼 안내

기기에 맞는 Clash 클라이언트 선택

홈에서는 플랫폼 안내만 제공합니다. 다운로드 페이지에서 같은 플랫폼의 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu 등의 클라이언트를 비교한 뒤 프로세서 아키텍처와 시스템 유형에 맞는 설치 패키지를 선택하세요.

Windows

일반적인 데스크톱과 노트북에 적합합니다. 설치 전에 시스템 아키텍처를 확인하고, 설치 후 구독 페이지에서 설정을 가져온 다음 시스템 프록시를 활성화하세요. 커널이 시작되지 않으면 보안 프로그램 차단, 포트 사용 여부와 설정 구문을 점검할 수 있습니다.

다운로드 페이지로 이동

macOS

다운로드할 때 Apple 칩과 Intel 프로세서를 구분해야 합니다. 처음 실행할 때 시스템 보안 알림이 나타나면 시스템 설정에서 앱 권한을 확인하세요. TUN을 활성화할 때 네트워크 확장을 허용해야 할 수도 있으므로 작업 후 연결을 다시 테스트합니다.

다운로드 페이지로 이동

Android

휴대폰, 태블릿과 일부 TV 기기에 적합합니다. 설치 후 로컬 VPN 연결을 만들어야 하며, 시스템의 배터리 절약 정책이 백그라운드에서 클라이언트를 중지할 수 있습니다. 장기간 사용할 때는 백그라운드 실행 권한과 배터리 최적화 설정을 확인하세요.

다운로드 페이지로 이동

iOS

앱 스토어에서 Clash Plus 설치 페이지로 이동하세요. 처음 연결할 때 시스템에서 VPN 설정 추가를 요청하면 승인한 뒤 구독을 가져옵니다. 네트워크를 전환한 후 접속되지 않는다면 기존 연결을 끊고 로컬 VPN 세션을 다시 설정하세요.

다운로드 페이지로 이동

Linux

그래픽 클라이언트와 서버·라우터 환경을 위한 Mihomo 커널 진입점을 제공합니다. 데스크톱 사용자는 그래픽 인터페이스를 우선 선택하고, 명령줄로 배포할 때는 서비스 관리, 설정 경로와 파일 권한 안내를 먼저 읽어 보세요.

다운로드 페이지로 이동
모든 클라이언트 보기 →
오픈 소스 생태계

클라이언트, 커널과 설정의 관계 이해

Clash 클라이언트가 장기간 사용에 적합한지 판단할 때는 인터페이스만 봐서는 안 됩니다. 그래픽 클라이언트가 커널을 어떻게 호출하는지, 설정이 트래픽 경로를 어떻게 결정하는지, 프로젝트 업데이트가 로컬 설치에 어떻게 반영되는지를 이해하는 것이 더 중요합니다.

프로젝트의 역사와 역할

Clash Nyanpasu는 Clash 그래픽 클라이언트 생태계에 속하며 설정 가져오기, 정책 선택, 시스템 프록시 제어, TUN 전환, 로그 확인과 커널 관리 등을 담당합니다. 그래픽 인터페이스는 설정 파일을 직접 편집하는 부담을 줄여 주지만, 실제 네트워크 동작은 사용하는 커널과 현재 설정이 함께 결정합니다. 따라서 인터페이스에 “연결됨”이라고 표시되어도 클라이언트 프로세스가 작동 중이라는 뜻일 뿐, 구독·규칙·DNS와 대상 노드가 모두 정상이라는 의미는 아닙니다.

사용 중에는 클라이언트를 설정과 커널을 관리하는 진입점으로 보는 것이 좋습니다. 문제가 발생하면 먼저 클라이언트가 시작되었는지 확인하고, 커널 로그와 설정 로드 결과를 점검한 뒤 정책 그룹과 노드 연결을 확인하세요. 계층별로 점검하면 구독 만료, 규칙 오설정 또는 로컬 포트 충돌을 모두 클라이언트 자체의 문제로 돌리는 일을 피할 수 있습니다.

오픈 소스 협업과 검토 가능성

코드가 공개되어 있으면 기능 변경, 문제 보고와 수정 과정을 프로젝트 저장소에서 추적할 수 있습니다. 사용자는 커밋 기록, 릴리스 노트와 알려진 문제를 확인할 수 있고, 유지 관리자는 재현 가능한 로그와 작업 단계로 문제를 파악할 수 있습니다. 피드백을 제출할 때는 운영체제, 설치 방식, 현재 프록시 모드, 문제가 발생하기 전후의 작업과 관련 로그 일부를 함께 적는 것이 좋습니다. “사용할 수 없음”처럼 재현하기 어려운 설명만 작성하는 것은 피하세요.

오픈 소스 협업이 모든 문제가 클라이언트에서 직접 해결된다는 뜻은 아닙니다. 구독 내용은 해당 서비스가 제공하고, 노드 상태는 회선이 결정하며, 시스템 네트워크 권한은 운영체제가 관리합니다. 책임 범위를 명확히 구분해야 문제를 올바른 곳에 제보할 수 있고, 여러 설정 화면을 목적 없이 오가는 일도 줄일 수 있습니다.

Mihomo 커널과의 관계

Mihomo는 설정을 읽고 프록시 연결을 수립하며 규칙 매칭과 DNS 처리를 수행하고 실행 상태를 그래픽 클라이언트에 제공합니다. Clash Nyanpasu는 이러한 기능을 조작 가능한 인터페이스로 구성합니다. 정책 그룹, 규칙 모음, 혼합 포트, TUN과 DNS 향상 모드 같은 개념은 본질적으로 커널 설정에서 비롯되며, 클라이언트의 스위치는 일반적으로 해당 설정 또는 실행 매개변수로 변환됩니다.

이 때문에 같은 설정을 여러 클라이언트에서 사용하면 주요 트래픽 분기 결과는 대체로 비슷하지만, 시스템 프록시를 적용하는 방식, 권한 요청, 트레이 조작과 업데이트 절차는 다를 수 있습니다. 클라이언트를 옮길 때는 구독 주소와 사용자 설정을 먼저 백업한 뒤 항목별로 복원하세요. 모든 인터페이스의 스위치 이름과 기본 동작이 완전히 같다고 가정해서는 안 됩니다.

업데이트 및 변경 사항 확인

클라이언트, 커널과 구독 설정은 각각 업데이트 주기가 다릅니다. 클라이언트 업데이트는 인터페이스와 시스템 통합 방식을 바꿀 수 있고, 커널 업데이트는 설정 기능을 추가하거나 호환 동작을 조정할 수 있으며, 구독 업데이트는 노드·정책 그룹·규칙을 변경할 수 있습니다. 일상적으로 세 가지를 동시에 업데이트할 필요는 없습니다. 한 번에 한 계층만 처리하고 변경 후 시작, 구독, 규칙과 대상 웹사이트를 확인하는 편이 안전합니다.

업데이트 전 현재 사용하는 정책 그룹과 주요 스위치를 기록해 두세요. 업데이트 후에는 먼저 릴리스 노트를 확인하고 기본 연결 테스트를 한 번 실행합니다. 문제가 생기면 이전 설정과 명확한 재현 절차를 보관해야 로컬 설정, 상위 설정 또는 새 기능 변경 중 무엇이 원인인지 판단하기 쉽습니다. 이 사이트의 다운로드 페이지는 플랫폼 진입점을 정리하고, 가이드와 문제 해결 페이지는 각각 최초 설정과 이상 현상 확인을 다룹니다.

프로젝트 저장소 복제 명령 git clone https://github.com/LibNyanpasu/clash-nyanpasu.git
자주 묻는 질문

문제가 발생한 계층부터 확인하기

대부분의 연결 문제는 클라이언트 시작, 설정 로드, 시스템 트래픽 가로채기, 규칙 매칭, DNS 해석과 노드 연결의 여섯 계층으로 나눌 수 있습니다. 먼저 어느 계층인지 찾은 다음 그에 맞는 방법을 선택하세요.

구독을 가져온 뒤에도 프록시 목록이 비어 있는 이유는 무엇인가요?

먼저 구독 요청이 성공했는지 확인하고 새 설정이 선택되었는지 점검하세요. 주소가 완전하지 않거나 구독 서비스를 일시적으로 이용할 수 없거나 시스템 시간이 잘못되었거나 로컬 보안 프로그램이 요청을 차단하면 가져오기에 실패할 수 있습니다. 설정은 표시되지만 프록시 목록이 비어 있다면 커널 로그에 설정 형식 오류가 기록되었는지 확인하세요. 먼저 입문 가이드의 구독 가져오기 절차를 읽고, 용어집에서 구독·설정·정책 그룹의 차이를 확인할 수 있습니다.

브라우저는 접속되는데 터미널 명령은 왜 프록시를 사용하지 않나요?

시스템 프록시는 시스템 설정을 능동적으로 읽는 프로그램에만 적용됩니다. 일부 터미널 도구는 프록시 환경 변수를 별도로 설정하거나 TUN 모드로 가로채야 합니다. 먼저 터미널 도구가 사용하는 프로토콜과 포트를 확인한 뒤 환경 변수를 설정할지 TUN을 활성화할지 결정하세요. 같은 테스트에서 시스템 프록시, 환경 변수와 DNS를 동시에 바꾸면 어떤 설정이 실제로 적용되었는지 판단하기 어렵습니다. 전체 절차는 문제 해결에서 확인할 수 있습니다.

규칙 모드와 전역 모드는 어떻게 선택해야 하나요?

규칙 모드는 도메인, IP 또는 규칙 모음에 따라 직접 연결과 프록시를 결정하므로 일상적인 사용에 적합합니다. 전역 모드는 대부분의 요청을 하나의 프록시 정책으로 보내므로 노드 연결성을 짧게 확인할 때 유용합니다. 전역 모드에서는 접속되지만 규칙 모드에서 실패한다면 전역 모드를 계속 사용하는 대신 대상 요청과 정책 그룹에 매칭된 규칙을 확인하세요. MATCH, GEOIP와 정책 그룹 등의 개념은 용어집에서 더 살펴볼 수 있습니다.

TUN을 켠 뒤 인터넷에 연결되지 않으면 어떤 설정부터 꺼야 하나요?

먼저 TUN을 끄고 기본 시스템 프록시가 복구되는지 확인한 다음 관리자 권한, 가상 네트워크 인터페이스, DNS 설정과 다른 VPN 프로그램의 충돌 여부를 점검하세요. 설정 전체를 바로 삭제하지 마세요. 설정 내용에는 문제가 없을 수 있습니다. 기본 연결을 복구한 뒤 TUN만 다시 켜서 테스트하고, 로그에 인터페이스 생성 실패나 권한 부족이 표시되면 시스템 계층의 문제를 먼저 해결하세요. 증상별 절차는 문제 해결에서 확인할 수 있습니다.

설정 문서

최근 문제 해결 및 고급 안내

문서를 증상별로 나누어 점검 순서를 설명하고, 무엇을 관찰해야 하는지, 범위를 어떻게 좁힐지, 어떤 설정을 동시에 변경하면 안 되는지를 중점적으로 안내합니다.

문제 해결

Clash 속도가 느릴 때: 노드·회선·로컬 설정 3단계 점검 목록

속도 변화는 노드 품질, 회선 혼잡, 프로토콜 오버헤드, 배율 설정, 트래픽 분기 규칙 또는 로컬 DNS에서 비롯될 수 있습니다. 반복 가능한 테스트부터 시작해 노드 문제와 로컬 설정을 분리하여 판단합니다.

전체 문서 읽기 →
문제 해결

Clash 포트 사용 중으로 시작 실패: 점유 프로세스 찾기 및 혼합 포트 변경

클라이언트가 커널을 시작하지 못하면 먼저 혼합 포트를 다른 프로그램이 사용 중인지 확인한 뒤 충돌 프로세스를 종료할지 설정을 변경할지 결정하세요. 같은 오류가 반복되는데도 계속 재설치하는 일을 피할 수 있습니다.

전체 문서 읽기 →
문제 해결

시스템 프록시가 적용되지 않을 때: 브라우저는 프록시를 쓰는데 터미널은 왜 쓰지 않을까

브라우저, 터미널과 독립 네트워크 구성 요소는 프록시 설정을 읽는 방식이 서로 다릅니다. 브라우저의 재정의 설정과 터미널 환경 변수를 각각 확인하고, 언제 TUN을 사용해야 하는지도 설명합니다.

전체 문서 읽기 →
모든 문서 보기 →