Windows
일상적인 데스크톱 사용에 적합합니다. FlClash, Clash Plus, Clash Verge Rev 중에서 선택할 수 있으며, 다운로드 전에 시스템 설정에서 프로세서 종류를 확인하세요. 처음 실행하면 설정을 가져온 뒤 시스템 프록시를 켜 브라우저 연결을 확인하세요. 더 많은 앱의 트래픽을 처리해야 한다면 가이드에 따라 TUN 권한을 설정하면 됩니다.
다운로드 페이지로 이동 →오픈소스 Clash 클라이언트 · mihomo 기반
호환되는 구독 하나로 데스크톱과 모바일을 연결하세요. FlClash는 구독 관리, 규칙 기반 라우팅, TUN 모드를 제공합니다.
먼저 운영체제를 확인한 다음 프로세서 아키텍처를 확인하세요. FlClash는 데스크톱과 Android 클라이언트를 제공하며, iOS에서는 별도의 호환 클라이언트를 사용합니다. 구독을 재사용할 수 있는지는 설정 형식과 프로토콜 지원 여부, 서비스 제공자의 기기 제한에 따라 달라집니다. 화면 구성이 비슷해도 모든 설정을 그대로 옮길 수 있는 것은 아닙니다.
일상적인 데스크톱 사용에 적합합니다. FlClash, Clash Plus, Clash Verge Rev 중에서 선택할 수 있으며, 다운로드 전에 시스템 설정에서 프로세서 종류를 확인하세요. 처음 실행하면 설정을 가져온 뒤 시스템 프록시를 켜 브라우저 연결을 확인하세요. 더 많은 앱의 트래픽을 처리해야 한다면 가이드에 따라 TUN 권한을 설정하면 됩니다.
다운로드 페이지로 이동 →Apple Silicon과 Intel 기기는 각각 맞는 설치 파일을 선택해야 합니다. ‘이 Mac에 관하여’에서 칩 정보를 확인할 수 있습니다. 설치 후에는 시스템 안내에 따라 필요한 네트워크 권한을 허용하세요. 클라이언트를 바꾸기 전에 기존 프록시 앱을 종료해야 시스템 프록시가 종료된 프로그램의 포트를 계속 가리키는 일을 막을 수 있습니다.
다운로드 페이지로 이동 →FlClash, Clash Meta for Android 등의 클라이언트를 선택할 수 있으며, 기기에 맞는 아키텍처의 설치 파일을 사용해야 합니다. 처음 연결할 때는 시스템 VPN 요청을 승인하세요. 백그라운드 연결을 유지하려면 배터리 최적화와 백그라운드 실행 권한도 확인해야 합니다. 앱별 프록시는 선택한 앱에만 적용되며 설정에 지정된 도메인 규칙을 대신하지 않습니다.
다운로드 페이지로 이동 →iPhone과 iPad에서는 다운로드 페이지를 통해 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 공식 사이트는 clashplus.io입니다. 가져오기 전에 구독이 해당 클라이언트를 지원하는지 확인하고, 처음 실행할 때 VPN 구성 추가를 허용하세요. 데스크톱의 로컬 파일 경로와 시스템 프록시 설정은 모바일에 그대로 적용할 수 없습니다.
다운로드 페이지로 이동 →데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지 형식을 사용하세요. 시스템 프록시의 작동 여부는 데스크톱 환경과 앱에 따라 달라집니다. 서버와 라우터에서는 보통 mihomo 코어를 직접 실행하는 편이 적합합니다. TUN은 네트워크 권한이 필요하므로 활성화하기 전에 현재 라우팅과 DNS 설정을 확인하세요.
다운로드 페이지로 이동 →다운로드 페이지에서 선택 가능한 클라이언트, 설치 파일의 아키텍처와 시스템 요구 사항을 확인할 수 있습니다. 클라이언트를 바꾸기 전에 기존 설정을 보관하세요. 구독 업데이트와 앱 업데이트는 별개의 작업입니다.
전체 클라이언트 보기 →설정부터 요청 전송까지, 클라이언트와 코어가 각각 담당하는 기능을 살펴보세요.
FlClash에서는 설정 화면에서 구독 링크와 로컬 설정을 관리할 수 있습니다. 링크를 추가한 뒤 콘텐츠를 다운로드하고 사용할 설정을 선택하세요. 자동 업데이트 간격은 클라이언트가 구독을 다시 가져오는 주기이며, 앱 업데이트와는 별도로 설정합니다. 여러 설정을 각각 저장할 수 있지만, 전환할 때는 프록시 그룹 선택이 여전히 유효한지 확인하세요. 구독 업데이트로 원격 설정의 규칙이 덮어써질 수 있으므로, 계속 유지할 사용자 지정 내용은 클라이언트가 지원하는 오버라이드 방식으로 저장해야 합니다. 정적 파일 하나만 가져오는 것보다 구독 관리를 이용하면 서비스 제공자의 노드와 규칙 변경을 지속적으로 반영하기 쉽습니다. 다만 링크의 유효성은 구독 제공자가 관리합니다.
구독 가져오기 절차 보기 →규칙 모드에서는 요청을 도메인, 대상 주소 또는 규칙 세트와 차례로 비교하고, 일치하는 규칙에 따라 직접 연결 정책이나 프록시 그룹으로 보냅니다. 모든 요청을 전역 그룹으로 보내는 전역 모드와 달리 대상별 라우팅을 유지합니다. FlClash는 정책 선택 화면을 제공하지만, 실제 규칙은 현재 설정에 따라 달라집니다. 특정 웹사이트의 연결 경로를 확인할 때는 연결 기록에서 먼저 적용된 규칙을 확인한 다음 규칙 위치를 조정하세요. 마지막 기본 규칙 뒤에 추가한 항목은 적용되지 않습니다. 프록시 그룹 이름은 규칙에서 참조하는 이름과 일치해야 합니다. 이름을 변경하기 전에 참조 관계도 함께 확인해야 설정 로드 오류를 막을 수 있습니다.
규칙 작성법과 매칭 순서 알아보기 →TUN은 가상 네트워크 인터페이스를 통해 라우팅 조건에 맞는 트래픽을 코어로 전달하므로 시스템 프록시 설정을 읽지 않는 앱에 적합합니다. 시스템 프록시는 이를 지원하는 앱에 프록시 주소를 제공하며, 두 방식은 처리하는 트래픽 범위가 다릅니다. TUN을 켜기 전에 일반 프록시로 설정과 노드가 정상 작동하는지 확인한 뒤 관리자 권한, 가상 네트워크 인터페이스, DNS 설정을 점검하세요. TUN을 사용해도 구독의 유효성이 바뀌지는 않으며, 모든 네트워크 환경에서 같은 결과가 보장되는 것도 아닙니다. 다른 VPN, 가상 머신 네트워크 또는 보안 소프트웨어를 함께 사용하는 기기에서는 호환성을 하나씩 확인하고, TUN을 끈 뒤 네트워크를 복구하는 방법도 미리 알아두세요.
연결 및 권한 설정 확인 →Clash 생태계에는 여러 코어와 클라이언트가 있으므로 설정 호환성을 따로 확인해야 합니다. FlClash는 mihomo 기반으로, mihomo가 지원하는 프로토콜과 규칙 기능을 사용할 수 있습니다. 다중 코어 호환이라는 항목은 생태계의 형식 간 차이를 비교한다는 뜻이지, FlClash에서 모든 코어를 자유롭게 바꿀 수 있다는 의미는 아닙니다. 기존 Clash 설정을 옮길 때 일반적인 규칙은 그대로 쓸 수 있는 경우가 많지만, 새 프로토콜이나 DNS 필드, 규칙 세트 매개변수는 코어의 지원 여부를 확인해야 합니다. 노드만 포함된 구독은 프록시 그룹과 규칙을 추가로 설정해야 합니다. 클라이언트 이름만 보는 것보다 서비스 제공자가 제공하는 형식과 대상 클라이언트의 코어를 먼저 확인하는 편이 정확합니다.
프로토콜 및 코어 호환성 확인 →FlClash는 Flutter로 크로스 플랫폼 UI를 구현해 데스크톱과 Android에서 설정, 프록시, 로그 등의 메뉴를 비슷한 방식으로 사용할 수 있습니다. 호환되는 구독은 두 기기에 각각 가져올 수 있지만, 로컬 설정과 파일 경로, 시스템 권한은 기기별로 따로 설정해야 합니다. 같은 링크를 사용해도 자동으로 동기화되지는 않습니다. 모바일은 시스템 VPN 인터페이스로 연결하며, 데스크톱에서는 시스템 프록시와 TUN을 구분해야 합니다. iOS에서는 다운로드 페이지에 안내된 다른 클라이언트를 사용하세요. 기기를 바꿀 때는 구독의 동시 연결 제한을 확인하고 프록시 그룹 선택, DNS, 백그라운드 권한을 점검해 기기 차이를 노드 오류로 오해하지 않도록 하세요.
플랫폼별 사용 가능한 클라이언트 보기 →처음 설정할 때는 먼저 연결을 확인할 수 있는 경로를 완성한 뒤 사용자 지정 규칙이나 트래픽 처리 범위를 추가하세요. 다음 세 단계는 호환되는 구독이 있는 사용자를 위한 안내입니다. 클라이언트는 설정을 불러오며, 노드와 서비스의 사용 가능 여부는 구독 제공자가 결정합니다.
운영체제와 프로세서 아키텍처에 맞는 클라이언트를 설치하세요. 설정 화면을 열고 구독 링크를 추가한 뒤 저장합니다. 다운로드가 끝나면 해당 설정을 선택하고 프록시 화면에 프록시 그룹이 표시되는지 확인하세요. 단일 노드 링크를 받았다면 클라이언트에서 바로 가져올 수 있는지 먼저 확인해야 합니다. 웹페이지 주소를 구독 입력란에 붙여 넣는 것만으로는 일반적으로 유효한 설정을 가져올 수 없습니다.
설정 이름은 용도에 따라 구분해 지정할 수 있으며, 구독 링크는 신뢰할 수 있는 곳에 보관하세요. 링크에 포함된 접근 식별 정보는 계정과 연결될 수 있으므로 로그나 스크린샷을 공유할 때 가려야 합니다. 가져오기 오류가 발생하면 주소가 완전한지, 구독이 만료되지 않았는지 확인한 다음 서비스 제공자가 지원하는 형식인지 살펴보세요. 클라이언트를 반복해서 재설치할 필요는 없습니다.
대시보드에서 규칙 모드를 선택한 다음 프록시 화면에서 필요한 프록시 그룹의 아웃바운드를 지정하세요. 규칙 모드는 기존 설정의 직접 연결과 프록시 분기를 유지하는 데 적합합니다. 전역 모드는 잠시 비교하거나 문제를 확인할 때 쓸 수 있지만, 설정의 규칙을 자동으로 바꾸지는 않습니다. 모드를 바꾼 뒤 새 요청을 보내 확인하세요. 이미 연결된 세션은 경로가 바로 바뀌지 않을 수 있습니다.
데스크톱에서는 먼저 시스템 프록시를 켜고, 모바일에서는 시스템 안내에 따라 VPN 구성을 허용하세요. TUN이 필요할 때만 별도로 활성화하고 권한을 확인하세요. 모드, DNS, 트래픽 처리 방식을 한꺼번에 바꾸면 어떤 설정이 연결에 영향을 줬는지 판단하기 어렵습니다.
연결을 시작한 뒤 특정 웹페이지에 접속하고 연결 기록이나 로그에서 대상 도메인, 적용된 규칙, 아웃바운드 정책을 확인하세요. 브라우저에서 페이지가 열린 것은 첫 단계일 뿐입니다. 프록시가 필요한 앱의 트래픽도 처리되는지 확인해야 합니다. 일부 앱에서만 문제가 발생하면 앱 자체의 프록시 설정과 이전 포트가 남아 있는지 먼저 살펴보세요.
시간 초과가 발생하면 로컬 네트워크, 구독 유효성, 트래픽 처리 상태, DNS, 노드 순으로 확인하세요. 설정을 한 번에 하나씩 변경하고 매번 다시 테스트한 뒤, 연결이 복구된 설정 조합을 기록해 두세요. 정상 작동을 확인한 다음 구독 자동 업데이트를 설정하면, 이후 업데이트에 실패해도 비교할 수 있는 작동 설정이 남습니다.
클라이언트 UI, 프록시 코어, 구독 콘텐츠는 각각 역할이 다릅니다. 이 세 계층의 관계를 알면 어떤 프로그램을 다운로드하고 무엇을 업데이트할지, 문제가 발생했을 때 어디부터 확인할지 판단하는 데 도움이 됩니다. 이 사이트에서는 다운로드 정보와 한국어 안내를 제공하며, 프로젝트 코드와 릴리스 기록은 해당 오픈소스 저장소에서 확인하세요.
FlClash는 Flutter와 mihomo 기반의 오픈소스 클라이언트 프로젝트입니다. Flutter는 크로스 플랫폼 UI 구현을 지원하고, mihomo는 프록시 프로토콜, DNS, 규칙 처리를 담당합니다. FlClash는 Clash 설정 생태계의 일부이며, 과거의 모든 Clash 클라이언트를 하나로 합친 프로그램은 아닙니다. 클라이언트마다 비슷한 설정 문법을 사용할 수 있지만, 운영체제 연동 방식과 유지 관리 주기는 서로 다를 수 있습니다.
프로젝트 현황은 저장소의 릴리스 노트, 커밋 기록, 이슈와 토론을 확인하면 알 수 있습니다. 특정 업데이트가 현재 사용 중인 기능에 영향을 주는지 판단하려면 릴리스 노트를 살펴보세요. 이슈와 토론에서는 특정 시스템 환경에서 문제를 재현한 정보를 찾을 수 있습니다. 공개 기록은 변경 사항을 추적하는 데 유용하며, 별점 숫자 하나만으로 모든 기기의 안정성을 판단할 수는 없습니다.
FlClash는 설정 관리, 프록시 선택, 로그 확인을 사용하기 쉬운 UI로 제공합니다. 요청이 규칙과 어떻게 매칭되고 어떤 프로토콜로 연결되는지는 코어와 현재 설정에 따라 달라집니다. UI에 특정 스위치가 있어도 서비스 제공자의 노드가 해당 기능을 지원한다는 뜻은 아닙니다. 마찬가지로 코어가 특정 프로토콜을 지원하더라도 노드 매개변수가 완전하고 올바르게 설정되어야 합니다.
mihomo는 Clash Meta의 기술 방향을 이어받아 프로토콜과 규칙 기능을 계속 발전시키고 있습니다. 구독 안내에는 기존 Clash, Meta, mihomo라는 이름이 함께 등장하는 경우가 많으므로 호환성을 확인할 때 각각 살펴봐야 합니다. 프로토콜별 특징, 리소스 사용량, 모바일 사용 환경은 프로토콜 상세 안내에서 확인할 수 있습니다.
앱 업데이트는 클라이언트 프로그램을 교체하며 UI 수정, 운영체제 호환성 개선, 포함된 코어 변경 등이 적용될 수 있습니다. 구독 업데이트는 설정 콘텐츠를 다시 가져와 노드, 프록시 그룹, 규칙에 영향을 줍니다. 두 업데이트는 서로 대체할 수 없습니다. 구독 주소가 만료되거나 무효라면 앱을 업그레이드해도 이용 권한이 복구되지 않습니다. 설정에 최신 필드가 포함된 경우에도 구독만 새로고침해서는 오래된 코어가 해당 필드를 인식하지 못합니다.
업데이트 전에 사용할 수 있는 설정과 필요한 로컬 옵션을 보관하고, 릴리스 노트에서 현재 운영체제와 관련된 내용을 확인하세요. 업데이트 후에는 기존 연결이 정상인지 먼저 테스트한 뒤 새 기능을 사용하세요. 설정 로드에 실패하면 로그에서 필드나 규칙 오류를 찾아 원인을 확인하세요. 되돌릴 수 있는 기록을 잃지 않도록 설정 폴더 전체를 바로 삭제하지 마세요.
클라이언트를 설치한 뒤에도 사용할 수 있는 설정이 필요합니다. 구독은 보통 기존 서비스의 계정 페이지나 직접 구축한 서비스에서 제공되며, FlClash가 구독에 포함되는 노드를 결정하지는 않습니다. 구독을 선택할 때 프로토콜 형식, 기기 수 제한, 업데이트 주소, 서비스 안내를 확인하세요. 출처를 알 수 없는 온라인 설정에는 현재 환경에 맞지 않는 DNS, 라우팅 또는 원격 규칙이 포함될 수 있으므로 가져오기 전에 기능을 파악해야 합니다.
문제를 제보할 때는 운영체제, 재현 단계, 민감 정보를 가린 오류 로그를 제공할 수 있습니다. 구독 주소, 노드 비밀번호, 접근 식별 정보, 계정 정보는 공개 토론에 올리지 마세요. 구독이 없다면 먼저 구독 출처 안내를 읽어보세요. 낯선 설정 항목은 용어 빠른 검색에서 노드, 정책 그룹, 규칙 세트, DNS의 차이를 확인할 수 있습니다.
Git이 설치되어 있다면 명령어를 복사해 저장소를 로컬에 가져올 수 있습니다. 코드를 복제하는 것은 소스 확인이나 개발을 위한 것으로, 클라이언트 설치와는 다릅니다. 일반적인 사용자는 다운로드 페이지에서 설치 파일을 선택하세요.
FlClash 오픈소스 저장소 열기 ↗git clone https://github.com/chen08209/FlClash.git
구체적인 증상부터 살펴보고 단계별로 문제 범위를 좁혀보세요. 글을 읽기 전에 사용 중인 설정, 아웃바운드 모드, 트래픽 처리 방식을 기록해 두면 안내된 확인 절차와 비교하기 쉽습니다. 설정을 바꾼 뒤에는 새 연결을 요청해 이전 연결로 새 규칙을 판단하지 않도록 하세요.
로컬 네트워크, 구독 유효성, 시스템 프록시와 TUN 상태, DNS 설정, 노드 순으로 확인해 원인을 좁혀보세요. 무작정 노드를 바꾸느라 시간을 낭비하지 않도록 안내합니다.
문제 해결 절차 보기 →규칙 한 줄의 세 부분 구성부터 자주 쓰는 규칙 유형, 위에서 아래로 적용되는 우선순위, no-resolve 매개변수와 규칙 세트 참조까지 설명하고 흔한 작성 오류도 다룹니다.
규칙 안내 보기 →GeoIP와 GeoSite 데이터 파일의 역할, 클라이언트에서 수동 또는 자동으로 업데이트하는 방법, 설정에서 GEOIP 및 GEOSITE 규칙을 작성하는 방법을 설명합니다.
데이터베이스 사용법 보기 →