오픈 소스 · Clash Meta 코어

FlClash설치 및 설정

Clash 다운로드가이드 보기

Clash Meta 코어 기반으로 구독 가져오기, 규칙 분기 및 TUN 모드를 한곳에서 관리합니다.

  • 오픈 소스
  • GPL-3.0
  • Flutter 크로스 플랫폼

운영체제에 맞는 클라이언트 선택

CONFIGURATION WORKSPACE

FlClash 설정 및 트래픽 처리 경로

먼저 설정의 출처, 트래픽 처리 방식, 분기 규칙을 구분한 뒤 사용 환경에 맞게 조정하세요. 화면의 스위치는 기능을 켜고 끄며, 실제 연결 경로는 현재 설정과 프록시 그룹이 함께 결정합니다.

구독 및 여러 설정

설정 페이지에서 구독 링크를 추가하거나 기존 로컬 설정 파일을 가져온 다음 사용할 항목을 선택하세요. 여러 설정을 저장하면 구독 출처나 테스트 환경을 나눠 관리하기 편합니다. 여러 설정을 저장해도 동시에 합쳐서 적용되는 것은 아닙니다. 코어만 실행하는 방식과 달리 FlClash에서는 GUI에서 설정 가져오기, 업데이트, 전환을 관리할 수 있습니다. 구독을 업데이트하면 원격에서 제공하는 내용이 바뀔 수 있으므로, 오래 유지해야 할 사용자 규칙은 클라이언트의 덮어쓰기 방식을 먼저 확인하세요. 생성된 파일을 직접 수정하면 다음 업데이트 때 변경 내용이 사라질 수 있습니다.

Flutter로 만든 UI.
Clash Meta가 연결을 처리합니다.
GPL-3.0에 따라 소스 코드 공개.

클라이언트는 설정 관리와 시스템 연동을 담당하고, 코어는 프로토콜·DNS·규칙 실행을 맡으며, 구독 제공자는 노드와 관련 설정을 제공합니다. 각 계층은 별도로 관리됩니다. 문제가 생기면 모든 스위치를 반복해서 바꾸기보다 먼저 어느 계층에서 발생했는지 파악해야 유효한 단서를 놓치지 않습니다.

PLATFORM ENTRIES

운영체제별 다운로드 센터

먼저 기기의 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 아래 링크에서 플랫폼별 클라이언트 목록을 볼 수 있습니다. iOS에는 호환되는 다른 클라이언트가 안내되며, FlClash 설치 파일을 제공하는 것은 아닙니다.

Windows

시스템 프록시, 구독 관리, 데스크톱 TUN이 필요한 사용자에게 적합합니다. 설치 전에 시스템 정보에서 프로세서 아키텍처를 확인하세요. 처음 실행하면 설정을 가져온 뒤 브라우저 연결을 테스트하고, 가상 네트워크 어댑터를 사용할 때는 안내에 따라 권한을 허용하세요. 다른 프록시 프로그램이 실행 중이면 시스템 프록시를 함께 변경하지 않도록 해당 프로그램의 트래픽 처리 기능을 먼저 종료하세요.

다운로드 페이지로 이동 →

macOS

‘이 Mac에 관하여’에서 칩 정보를 확인해 Apple Silicon용과 Intel용 설치 파일을 구분하세요. 설치 후 구독을 가져오고 시스템 네트워크 설정의 프록시 상태를 확인합니다. TUN에는 추가 권한이 필요하므로 일반 프록시가 작동한 뒤 설정하는 것이 좋습니다. 앱을 종료한 뒤에도 브라우저가 인터넷에 연결되지 않으면 시스템에 로컬 포트를 가리키는 프록시 설정이 남아 있는지 확인하세요.

다운로드 페이지로 이동 →

Android

기기에서 지원하는 아키텍처에 맞는 설치 파일을 선택한 뒤, 가져온 설정을 적용하고 시스템 VPN 연결 권한을 허용하세요. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화, 백그라운드 실행, 제조사의 자동 시작 제한을 확인하세요. 휴대폰의 VPN 연결은 보통 한 앱만 사용할 수 있습니다. 클라이언트를 바꿀 때는 기존 연결을 종료한 뒤 새 요청으로 규칙과 노드가 적용되는지 확인하세요.

다운로드 페이지로 이동 →

iOS

다운로드 센터에는 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io가 안내되어 있습니다. 클라이언트를 고를 때는 먼저 구독 형식과 필요한 규칙 기능을 확인한 뒤, 앱 안내에 따라 설정을 추가하고 네트워크 연결을 허용하세요. 설정 이름은 클라이언트마다 다를 수 있습니다. 데스크톱의 TUN 설정을 모바일 운영체제에 그대로 적용하지 말고 앱에서 실제로 제공하는 옵션을 기준으로 설정하세요.

다운로드 페이지로 이동 →

Linux

데스크톱 환경에서는 GUI 클라이언트를, 서버나 라우터에서는 코어 항목을 확인하세요. 설치 전에 배포판의 패키지 형식과 의존성을 확인해야 합니다. TUN을 사용하려면 권한, 라우팅, DNS 관리 서비스도 고려하세요. 터미널 명령이 프록시를 통하지 않는다면 해당 프로그램이 프록시 환경 변수를 읽는지 먼저 확인하세요. 브라우저에서 접속된다고 모든 프로세스의 트래픽이 처리되는 것은 아닙니다.

다운로드 페이지로 이동 →

설치 후 설정부터 확인하세요

클라이언트 다운로드는 첫 단계일 뿐입니다. 구독이 정상적으로 파싱되는지, 현재 설정이 활성화되어 있는지, 프록시 그룹에서 연결 경로를 선택했는지 확인한 다음 트래픽 유입 설정을 점검하세요. 문제가 생기면 한 번에 한 가지 조건만 바꾸고 변경 전후의 로그를 보관하세요. 클라이언트, 노드, DNS를 동시에 바꾸면 원인을 비교하기 어렵습니다.

모든 클라이언트 보기 →

SOURCE & MAINTENANCE

오픈 소스 프로젝트와 설정의 범위

코드, 코어, 구독의 세 가지 관점에서 클라이언트를 살펴봅니다. 이 사이트는 다운로드 링크와 한국어 안내를 제공하며, 프록시 노드를 제공하거나 구독 서비스의 회선 문제를 대신 처리하지 않습니다.

프로젝트 출처와 클라이언트의 발전

FlClash는 Flutter와 Clash Meta 기반의 오픈 소스 클라이언트입니다. 공개 저장소에서 UI, 플랫폼 연동, 빌드 관련 코드를 확인할 수 있습니다. Clash 생태계에는 각기 다른 개발자가 유지 관리하는 GUI 클라이언트와 코어 분기가 있으며, 같은 Clash 설정을 지원하더라도 배포 경로, 업데이트 주기, 기능 위치까지 동일한 것은 아닙니다. 기존 클라이언트에서 옮길 때는 구독 주소와 사용자 규칙을 먼저 백업하고, 새 클라이언트의 지원 여부를 항목별로 확인하세요. 기존 디렉터리를 바로 덮어쓰지 않는 것이 좋습니다.

프로젝트를 살펴볼 때는 README에서 플랫폼 안내와 사용법을 확인하고, 릴리스 기록에서 사용 중인 운영체제와 관련된 변경 사항을 살펴보세요. 문제를 제보하려면 재현 조건, 운영체제, 관련 설정, 민감 정보를 가린 로그가 필요합니다. ‘연결 실패’라는 설명만으로는 권한, 형식, 노드, 라우팅 중 무엇이 원인인지 구분하기 어렵습니다. 공개 게시 전에 구독 링크의 인증 정보, 노드 비밀번호, 개인 계정을 식별할 수 있는 정보를 삭제하세요.

Clash Meta와 mihomo의 관계

Clash Meta 코어의 후속 프로젝트는 보통 mihomo라는 이름으로 불립니다. 문서, 설정 항목, 로그에서 두 이름을 모두 볼 수 있습니다. FlClash는 이를 바탕으로 GUI 기능을 제공하지만, 프로토콜 호환성·규칙 매칭·DNS 동작은 실제로 통합된 코어에 따라 달라집니다. GUI에서 YAML 파일을 가져올 수 있다는 사실만으로 연결까지 성공한다고 볼 수는 없습니다. 프로토콜 매개변수, 프록시 그룹 참조, 현재 네트워크 상태도 확인해야 합니다.

문제를 확인할 때는 ‘요청이 코어에 들어왔는가, 예상한 규칙에 매칭됐는가, 사용할 수 있는 연결 경로를 선택했는가’ 순서로 살펴보세요. 로그에 대상 요청이 없다면 시스템 프록시, 앱 자체 프록시 설정, TUN 트래픽 처리를 먼저 점검합니다. 요청이 기록되고 연결 경로도 올바르다면 DNS 조회, 핸드셰이크, 원격 연결을 확인하세요. 이 단계별 점검 방식은 비슷한 코어를 사용하는 다른 클라이언트에도 적용할 수 있습니다.

GPL-3.0 라이선스와 소스 코드

FlClash 프로젝트는 GPL-3.0 라이선스를 적용합니다. 일반 사용자는 소스 코드와 릴리스 안내를 통해 소프트웨어 동작을 확인할 수 있습니다. 프로젝트를 수정하거나 재배포 또는 통합하려면 저장소의 라이선스와 의존성 라이선스를 읽고, 해당 조건에 따라 저작권 고지를 보존하고 관련 의무를 이행해야 합니다. 오픈 소스 라이선스는 코드의 이용 조건을 설명할 뿐, 구독 서비스나 원격 서버, 네트워크 환경까지 같은 프로젝트가 관리한다는 뜻은 아닙니다.

FlClash 소스 코드 보기

프로젝트 저장소 보기 ↗
git clone https://github.com/chen08209/FlClash.git

앱 업데이트와 구독 업데이트는 별도로 관리하세요

앱 업데이트는 UI, 시스템 연동, 함께 제공되는 코어를 바꿉니다. 구독 업데이트는 설정 제공자가 배포한 노드, 규칙, 프록시 그룹을 다시 가져옵니다. 두 업데이트는 해결하는 문제가 다릅니다. 노드가 작동하지 않는다고 반드시 클라이언트를 다시 설치할 필요는 없으며, 앱 권한 문제도 구독 새로고침으로 해결되지 않을 수 있습니다. 업데이트 전에 현재 설정 이름, 연결 모드, 트래픽 처리 방식을 기록하고 중요한 로컬 수정 사항은 따로 백업하세요. 업데이트 후에는 같은 대상과 연결 경로로 다시 테스트합니다.

구독 주소에는 계정 인증 정보가 포함되는 경우가 많으므로 비밀번호처럼 관리해야 합니다. 전체 링크를 공개 스크린샷, 온라인 YAML 검사 도구, 질문 게시글에 올리지 마세요. 설정 구조를 공유해야 한다면 항목 이름은 유지하되 도메인, 비밀번호, 토큰은 명확한 예시 값으로 바꾸세요. 이 사이트의 설정 예시는 항목 간 관계를 설명하기 위한 것이며, 그대로 사용할 수 있는 프록시 서비스가 아닙니다.

처음 사용할 때 확인할 순서

먼저 설정 페이지에서 설정을 가져와 선택한 다음, 프록시 페이지에서 프록시 그룹의 구성원을 선택할 수 있는지 확인하세요. 마지막으로 대시보드에서 필요한 트래픽 처리 방식을 켭니다. 규칙 모드는 일반적인 트래픽 분기에 적합하고 전역 모드는 짧은 비교 테스트에 유용하지만, 둘 다 코어에 전달된 연결에만 적용됩니다. 새 요청을 만들어 테스트하고 연결 또는 로그 페이지에서 결과를 확인하세요. 스위치가 켜져 있다는 것만으로 실제 연결 경로를 알 수는 없습니다.

구독 업데이트는 되지만 특정 사이트에 접속할 수 없다면 다른 연결 경로와 다른 대상을 각각 테스트하세요. 모든 연결 경로에서 실패하면 기기의 네트워크, 시스템 시간, DNS를 확인합니다. TUN을 켠 뒤 문제가 생겼다면 먼저 TUN을 끄고 일반 프록시 상태에서 비교한 다음 라우팅, 권한, 다른 VPN을 하나씩 점검하세요. 자세한 방법은 구독 가져오기 가이드를 참고하세요. 규칙 집합이나 DNS를 조정하려면 고급 설정 매뉴얼을 이어서 확인하세요.

CONFIGURATION NOTES

설정 구조와 클라이언트 비교

먼저 Profile의 출처와 전환 방법을 살펴본 뒤 YAML 각 항목의 참조 관계를 익혀 보세요. 클라이언트를 바꿔야 한다면 화면이 비슷한지만 볼 것이 아니라 플랫폼, 코어, 관리 방식에 따라 비교하세요.

글 전체 보기 →