오픈 소스 클라이언트mihomo 코어 · Flutter 기반

FlClash 다운로드및 설정 시작하기

Clash 다운로드 가이드 보기

mihomo 코어를 기반으로 한 데스크톱 및 모바일 클라이언트입니다. 구독 가져오기로 설정을 관리하고, 규칙 라우팅으로 직접 연결과 프록시 요청을 구분합니다.

  • 영구 무료
  • 오픈 소스
  • 한국어 문서
운영체제에 맞는 설치 파일 선택 · iOS는 다른 클라이언트 안내

설치 파일 및 플랫폼 선택

운영체제에 맞는 Clash 클라이언트 찾기

FlClash는 데스크톱과 Android를 지원합니다. 다운로드 페이지에서 다른 Clash 생태계 클라이언트도 확인할 수 있습니다. 프로세서 아키텍처와 사용 방식에 맞게 선택하세요. iOS 항목에는 Clash Plus 앱 스토어 링크가 안내되어 있습니다.

설치 파일은 플랫폼, 아키텍처, 패키지 형식이 모두 맞아야 합니다. 같은 운영체제를 실행하는 컴퓨터라도 이름이 같은 모든 설치 파일이 적합한 것은 아닙니다. Android도 기기가 실제로 지원하는 아키텍처를 확인하세요. 다운로드 페이지에는 플랫폼별 클라이언트 목록과 유지 관리 상태, 설치 시 주의사항이 정리되어 있어 FlClash, Clash Plus, Clash Verge Rev 등의 옵션을 비교할 수 있습니다.

전체 클라이언트 보기 →

설정 및 네트워크 구성

FlClash 주요 기능

먼저 설정의 출처를 확인한 다음, 트래픽이 클라이언트에 들어오는 방식과 규칙에 따른 아웃바운드 경로를 정하세요. 아래 화면은 설정 간 관계를 설명하기 위한 예시이며, 실제 메뉴는 사용 중인 클라이언트 버전을 기준으로 확인해야 합니다. 항목을 클릭하면 자동 전환이 멈춰 원하는 속도로 읽을 수 있습니다.

구독 가져오기와 현재 설정

구독 주소는 설정을 가져오는 경로입니다. 가져온 뒤에는 해당 설정을 현재 설정으로 선택해야 합니다. 먼저 반환된 내용이 Clash 설정인지 확인하고, 프록시 그룹과 규칙이 제대로 들어 있는지 살펴보세요. 원격 구독은 지속적인 업데이트에 적합하고, 로컬 파일은 직접 수정한 내용을 보관하기 좋지만 관리 방식은 서로 다릅니다. 구독에서 생성된 파일을 직접 수정하면 다음 업데이트에서 변경 사항이 덮어써질 수 있습니다. 구독 원본과 로컬에서 수정한 내용을 따로 기록하고, 업데이트 후 정책 그룹 참조가 유지되는지 확인하세요. 같은 구독을 데스크톱과 휴대폰에 각각 가져올 수 있지만, 클라이언트 설정과 권한은 기기마다 별도로 확인해야 합니다.

구독 가져오기 단계 보기 →

첫 연결

구독 가져오기부터 연결 확인까지

클라이언트를 설치한 뒤에는 사용할 구독이나 로컬 설정이 필요합니다. 여러 네트워크 설정을 한꺼번에 바꾸기보다 설정, 모드, 시스템 권한을 순서대로 확인하면 문제를 찾기 쉽습니다. 클라이언트에는 바로 사용할 수 있는 프록시 서비스가 포함되어 있지 않습니다.

  1. 설정을 가져와 현재 설정으로 선택

    설정 페이지에서 화면에 표시된 방법으로 구독 주소나 로컬 파일을 추가하세요. 원격 주소는 신뢰할 수 있는 설정 제공자가 발급한 것이어야 합니다. 웹사이트 로그인 주소를 구독 주소로 사용하지 마세요. 가져온 후 해당 항목이 현재 설정으로 선택되었는지 확인하고 프록시 페이지에서 사용할 수 있는 정책 그룹이 있는지 살펴보세요. 설정 이름이 보인다고 해서 내용이 모두 정상적으로 로드된 것은 아닙니다.

    가져오기에 실패하면 먼저 오류 메시지를 확인하고 주소에 접속할 수 없는 경우, 로그인 페이지가 반환된 경우, 설정 형식이 호환되지 않는 경우를 구분하세요. 구독 다운로드 문제를 해결하려고 아웃바운드 모드를 계속 바꾸지 마세요. 서로 다른 단계의 설정입니다. 구독 주소에는 접근 정보가 포함될 수 있으므로 화면을 캡처하거나 도움을 요청할 때 전체 주소를 가리세요.

  2. 규칙 모드와 아웃바운드 선택

    일상적인 사용에서는 먼저 규칙 모드를 선택한 뒤 설정에 포함된 정책 그룹에서 적절한 아웃바운드를 고르면 됩니다. 규칙 그룹과 노드 이름은 설정에 따라 달라지므로 화면에 표시되는 이름이 가이드 예시와 다를 수 있습니다. 전역 모드는 비교 테스트에 사용할 수 있지만, 만료된 구독이나 잘못된 인증 정보, 사용할 수 없는 서비스를 해결해 주지는 않습니다.

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, Android에서는 안내에 따라 VPN 연결을 허용하세요. 다른 프록시 앱이 실행 중이라면 로컬 포트와 라우팅이 동시에 바뀌지 않도록 하나를 먼저 종료한 뒤 테스트하세요. TUN이 필요하다면 기본 연결이 정상인지 확인한 후 켜고, 변경 전 설정을 기록해 두세요.

  3. 요청과 규칙 매칭 확인

    직접 연결되어야 하는 웹사이트와 프록시를 사용해야 하는 서비스를 각각 방문하세요. 연결 또는 로그 페이지에서 요청이 클라이언트에 도달했는지, 어떤 규칙에 매칭되었는지, 최종적으로 어떤 정책 그룹이 선택되었는지 확인할 수 있습니다. 연결 버튼에 실행 중이라고 표시되어도 관련 서비스가 시작되었다는 뜻일 뿐, 모든 앱이 프록시를 사용한다는 의미는 아닙니다.

    브라우저에서는 연결되지만 다른 앱에서는 안 된다면 해당 앱이 시스템 프록시를 따르는지 먼저 확인하세요. 모든 요청이 실패하면 현재 설정, 정책 그룹, 서비스 사용 가능 여부를 차례로 확인하세요. 설정은 한 번에 하나씩만 변경하고 결과를 기록한 뒤 DNS, 권한, 방화벽 문제를 추가로 확인하는 것이 좋습니다.

전체 가이드에서는 가져오기 실패, 권한 안내, 연결 확인을 각각 어디서 처리하는지 자세히 설명합니다. 복잡한 네트워크 환경의 진단 절차는 문제 진단 페이지에서 확인할 수 있어 첫 설정 과정을 방해하지 않습니다.

전체 가이드 보기 →

프로젝트 및 오픈 소스 생태계

FlClash, mihomo 및 설정 출처

클라이언트, 코어, 프록시 서비스의 역할을 이해하면 제품을 선택하거나 문제를 해결할 때 혼동을 줄일 수 있습니다. 오픈 소스 저장소에서 코드, 릴리스 노트, 알려진 문제를 확인할 수 있지만 연결 품질은 설정, 서비스, 로컬 네트워크에 따라 달라집니다.

  • Flutter 인터페이스
  • mihomo 코어
  • GPL-3.0

프로젝트 소스 코드 가져오기

Git이 설치된 개발자는 명령어를 복사해 터미널에서 저장소를 가져올 수 있습니다. 일반 사용자는 설치 파일을 선택하면 되며 소스 코드를 직접 빌드할 필요가 없습니다.

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

코어는 네트워크를 처리하고 클라이언트는 조작 화면을 제공합니다

mihomo는 프로토콜 처리, 규칙 매칭, 연결 전달 등을 담당하고, FlClash는 설정 관리, 연결 토글, 정책 선택, 로그 확인을 위한 화면을 제공합니다. 이전 자료에서 자주 보이는 Clash Meta와 mihomo는 프로젝트의 발전 과정에서 이어진 이름입니다. 다만 오래된 가이드의 메뉴 위치와 지원 옵션이 현재 클라이언트에도 그대로 적용된다고 볼 수는 없습니다. 기능 차이가 있다면 클라이언트 구현과 사용 중인 코어의 기능을 모두 확인해야 합니다.

Flutter는 GUI를 만드는 기술이지 프록시 프로토콜이 아닙니다. 화면 테마를 바꿔도 서버가 지원하는 프로토콜은 달라지지 않으며, 클라이언트를 바꾼다고 서버 만료나 잘못된 인증 정보가 자동으로 해결되는 것도 아닙니다. 소프트웨어 이름을 바꿔 가며 재설치하기보다 문제가 화면 설정, 코어 설정, 서비스 연결 중 어느 단계에서 생겼는지 먼저 확인하고 관련 문서를 찾아보세요.

오픈 소스 라이선스와 커뮤니티 자료 활용법

FlClash 프로젝트는 GPL-3.0 라이선스를 따르며 저장소에서 소스 코드와 라이선스 전문을 확인할 수 있습니다. 코드를 수정하거나 배포하거나 다른 프로젝트에 활용하려면 먼저 라이선스 요구사항을 확인해야 합니다. 코드를 볼 수 있다는 이유만으로 기존 라이선스 안내를 임의로 삭제해도 되는 것은 아닙니다. 일반 사용자는 저장소의 릴리스 기록, 이슈 논의, 문서를 통해 기능 변경과 알려진 제한 사항을 확인할 수 있습니다.

커뮤니티 이슈를 살펴볼 때는 운영체제, 설치 방식, 증상이 비슷한 사례를 먼저 찾아보세요. 같은 '인터넷에 연결할 수 없음' 문제라도 원인은 전혀 다를 수 있습니다. 문제를 올리기 전에 재현 단계, 민감 정보를 가린 오류 로그, 이미 시도한 조치를 준비하면 연결 버튼만 캡처해 올리는 것보다 원인을 찾는 데 도움이 됩니다. 구독 주소, 계정 정보, 전체 설정에 포함된 민감한 항목은 공개하지 마세요.

프로그램 업데이트와 구독 업데이트는 별개입니다

클라이언트 업데이트는 주로 인터페이스, 코어 연동, 호환성 문제를 개선합니다. 구독 업데이트는 프록시, 정책 그룹, 규칙 정보를 다시 가져오는 과정입니다. GeoIP와 GeoSite 데이터는 별도의 업데이트 메뉴가 있을 수도 있습니다. 도메인 라우팅이 예상과 다를 때는 규칙 내용, 데이터 사용 가능 여부, 매칭 순서를 각각 확인하세요. 설치 파일이 최신이라고 해서 설정까지 올바르다고 단정할 수는 없습니다.

업데이트 전에 필요한 로컬 설정을 기록하고, 권한, 설정 이전, 시스템 요구사항과 관련된 릴리스 노트를 확인하세요. 업데이트 후에는 현재 설정이 그대로 선택되어 있는지 확인한 다음 자주 쓰는 앱으로 연결을 테스트하세요. 문제가 생기면 업데이트 전후의 차이를 기록해 증상에 따라 확인하세요. 원인을 파악하기도 전에 구독을 바꾸고 DNS를 수정하고 모든 설정을 초기화하지 마세요.

설정은 여러 기기에서 쓸 수 있지만 기기별 환경은 따로 확인해야 합니다

호환되는 클라이언트라면 같은 구독을 각각 가져올 수 있습니다. 다만 설정 제공자가 동시 연결 기기 수나 서비스 이용 방식을 제한할 수 있습니다. 휴대폰과 컴퓨터는 네트워크 환경이 다르므로 같은 설정을 가져와도 DNS, 라우팅, 방화벽 조건이 달라질 수 있습니다. 한 기기에서 연결된다는 사실은 문제를 찾는 단서일 뿐, 다른 기기에서도 반드시 작동한다는 보장은 아닙니다.

클라이언트를 더 알아보려면 클라이언트 비교를 확인하세요. 설치를 마친 뒤 연결 문제가 생겼다면 문제 진단에서 증상에 맞는 절차를 찾아볼 수 있습니다. 기본 개념과 자주 묻는 설치 질문은 FAQ에 정리되어 있으니, 네트워크 설정을 바꾸기 전에 용어와 설정의 의미부터 확인해 보세요.

기술 노트

규칙, 데이터 및 로컬 네트워크 공유

특정 설정을 보충 설명합니다. 첫 연결을 완료한 뒤 필요한 항목에 따라 데이터 업데이트, 클라이언트 간 관계, 프록시 공유 방법을 확인하세요. 글에 나온 설정값은 현재 구성에 맞게 적용해야 하며, 특히 정책 그룹 이름, 수신 주소, 권한 차이에 주의하세요.

기술 노트에서는 개별 기능의 원리와 사용법을 자세히 다룹니다. 아직 설정 가져오기에 성공하지 못했다면 먼저 시작 가이드를 완료한 뒤 필요한 주제를 하나씩 확인하세요.

전체 글 보기 →