입문 가이드 · 첫 설정

FlClash 입문 가이드
구독·모드·연결 확인

네 단계로 기본 설정을 마치세요. 먼저 앱 하나의 요청이 프록시로 제대로 전달되는지 확인한 다음 TUN, DNS, 사용자 지정 규칙을 설정합니다. 구독이 유효하고 네트워크에 접속할 수 있다면 약 10분 안에 처음 설정을 마칠 수 있습니다.

플랫폼별 안내: 이 문서는 FlClash의 ‘설정 → 프록시 → 연결’ 기능을 기준으로 설명합니다. 버전에 따라 메뉴 이름과 위치가 다를 수 있습니다. 데스크톱에서는 사이드바나 설정 페이지를, Android에서는 페이지 탐색 메뉴와 설정 항목을 찾아보세요. 다른 Clash 클라이언트도 같은 기능을 찾아 설정하면 되며 버튼 위치까지 같을 필요는 없습니다.

Windows, macOS, Linux에서 처음 테스트할 때는 시스템 프록시를 우선 사용하세요. Android에서는 연결 시 시스템 VPN 권한이 필요한 경우가 많습니다. iOS에서는 먼저 설치 파일 페이지에서 해당 클라이언트를 선택한 뒤, 클라이언트의 설정 가져오기 메뉴를 이용하세요. 데스크톱 시스템 프록시 절차를 그대로 적용하지 마세요.

시작하기 전에 유효한 구독 URL이나 신뢰할 수 있는 출처의 YAML 설정 파일을 준비하세요. 구독은 노드, 정책 그룹, 규칙을 제공하며 클라이언트를 설치하는 것만으로는 사용할 수 있는 프록시 서비스가 생기지 않습니다. 아직 설치하지 않았다면 설치 파일 페이지에서 운영체제에 맞는 프로그램을 선택하세요. 이미 설정이 있더라도 첫 단계의 활성화 여부 확인은 건너뛰지 마세요.

1단계: 구독 가져오기

FlClash의 ‘설정’ 페이지를 열고 설정 추가 메뉴를 찾으세요. 원격 구독을 사용할 경우 URL 가져오기를 선택한 뒤 서비스 제공업체가 안내한 전체 구독 주소를 입력란에 붙여 넣습니다. ‘일상용 설정’처럼 알아보기 쉬운 이름을 지정해도 됩니다. 이름은 로컬에서 관리할 때만 사용되며 노드 연결에는 영향을 주지 않습니다. 저장하기 전에 URL 앞뒤에 공백이나 줄바꿈, 메신저가 자동으로 붙인 문장 부호가 없는지 확인하세요.

구독 주소에는 개인 인증 정보가 포함되는 경우가 많으므로 비밀번호처럼 관리하세요. 전체 주소를 공개 게시판에 올리거나 스크린샷에 주소 매개변수가 보이게 하지 마세요. 브라우저에서 열리는 계정 페이지가 반드시 구독 URL인 것은 아닙니다. 서비스 제공업체가 Clash 또는 mihomo용으로 안내한 구독 주소를 사용하세요. 여러 형식이 제공된다면 클라이언트 코어가 인식할 수 있는 형식을 우선 선택하세요.

다운로드·파싱·활성화 상태 확인

저장 또는 가져오기를 누른 뒤 클라이언트가 구독을 가져올 때까지 기다리세요. 성공하면 설정 목록에 방금 지정한 이름이 표시됩니다. 화면에 업데이트 시간이나 기타 구독 정보가 함께 나타날 수도 있지만, 표시 여부는 서버가 반환하는 내용에 따라 다릅니다. 목록에 항목이 생겨도 활성화되지 않았을 수 있으므로 해당 항목을 누르거나 활성화 기능을 사용해 현재 설정으로 지정하세요. 그런 다음 ‘프록시’ 페이지에서 정책 그룹과 노드가 보이는지 확인합니다.

이 단계의 완료 기준은 현재 설정이 선택되어 있고 프록시 페이지에 해당 내용이 로드된 상태입니다. 설정 이름만 보이고 예상한 정책 그룹이 없다면 TUN을 켜기 전에 설정 목록으로 돌아가 가져온 결과를 확인하세요. 일부 구독은 노드만 제공하므로 클라이언트 설정 템플릿으로 규칙을 보완해야 합니다. 완성된 설정을 제공하는 구독도 있습니다. 두 경우의 화면은 다를 수 있으니 서비스 제공업체의 안내와 실제 로드 결과를 기준으로 판단하세요.

로컬 파일 가져오기 및 실패 해결

로컬 설정을 사용할 때는 파일 가져오기를 선택하고 시스템 파일 선택기에서 실제 YAML 파일을 여세요. 웹페이지를 파일로 저장한 뒤 가져오지 마세요. 웹페이지 내용은 프록시 설정이 아닙니다. 가져온 뒤에는 해당 설정을 선택하고 프록시 페이지를 확인해야 합니다. 설정에 외부 규칙 집합이나 프록시 그룹이 포함된 경우 처음 로드할 때 추가 다운로드가 필요할 수 있으며, 해당 리소스에도 접속할 수 있어야 합니다.

요청 시간 초과가 표시되면 현재 네트워크에서 구독 서비스에 접속할 수 있는지 먼저 확인하세요. 파싱 오류가 표시되면 응답이 로그인 페이지, 만료 안내 또는 오류 페이지로 바뀌지 않았는지 확인합니다. 추가 버튼을 반복해서 눌러 중복 항목을 만들지 말고, 개인 구독 정보를 출처가 불분명한 변환 사이트에 입력하지 마세요. 형식별 점검 순서는 구독 가져오기 실패 및 파싱 오류 자체 점검을 참고하세요.

가져오기가 끝나면 이번 테스트에 사용할 설정 하나만 유지하세요. 이후에는 두 번째 구독을 추가하거나 별도의 덮어쓰기 설정을 가져오지 마세요. 이렇게 하면 모드 선택 단계에서 정책 그룹의 출처가 명확해지고 문제가 생겼을 때 쉽게 되돌릴 수 있습니다.

2단계: 프록시 모드 선택

홈이나 설정 페이지로 돌아가 ‘모드’ 또는 ‘아웃바운드 모드’를 찾으세요. 처음 사용할 때는 ‘규칙’을 선택합니다. 이는 설정의 mode: rule에 해당합니다. 규칙 모드는 설정에 정의된 매칭 순서에 따라 요청을 직접 연결하거나 정책 그룹 또는 다른 아웃바운드로 보냅니다. 자주 쓰는 앱인지에 따라 자동으로 판단하는 방식이 아니며 모든 웹사이트가 프록시를 거친다는 보장도 없습니다.

모드와 노드는 서로 다른 설정입니다. 먼저 규칙 모드를 선택한 다음 ‘프록시’ 페이지를 열어 규칙에서 사용하는 주요 정책 그룹을 찾으세요. 그룹 이름은 설정에 따라 다르므로 용도를 나타내는 한글 이름일 수도 있고 사용자 지정 이름일 수도 있습니다. ‘주 노드’라는 고정된 이름의 항목을 찾을 필요는 없습니다. 정책 그룹을 펼친 뒤 사용 가능한 노드를 눌러 해당 그룹의 현재 항목으로 지정하세요.

먼저 아웃바운드 노드 하나를 지정하고 자동 선택은 나중에

처음 확인할 때는 수동 선택 그룹에서 명확한 노드 하나를 지정하는 편이 좋습니다. 주요 정책 그룹이 다른 그룹을 참조한다면 계속 펼쳐 실제로 사용할 수 있는 노드까지 선택됐는지 확인하세요. DIRECT에 머물거나 아웃바운드가 차단된 상태여서는 안 됩니다. 자동 선택 그룹은 설정된 검사 규칙에 따라 구성원을 고르므로 설정이 안정된 뒤 사용하기 좋습니다. 처음 문제를 확인할 때는 노드를 고정해야 설정 변경의 영향을 쉽게 파악할 수 있습니다.

클라이언트에 지연 시간 테스트 기능이 있다면 보조 점검으로 한 번 실행해 보세요. 결과는 해당 노드와 지정된 테스트 주소 사이의 성능만 보여 줍니다. 모든 대상에 접속할 수 있다는 뜻도, 브라우저 트래픽이 프록시로 들어갔다는 뜻도 아닙니다. 테스트 실패는 테스트 주소, 노드 상태, 네트워크 문제 때문일 수 있습니다. 테스트에 성공해도 이후 연결 및 실제 접속 확인을 마쳐야 합니다.

규칙·전역·직접 연결 모드의 용도

‘전역’ 모드는 일반적으로 코어로 들어온 요청을 전역 정책 그룹으로 보냅니다. 분기 규칙이 문제의 원인인지 잠깐 확인할 때 유용합니다. 모드를 바꾼 뒤에도 전역 그룹에서 선택된 아웃바운드를 확인해야 합니다. 직접 연결로 설정되어 있을 수도 있습니다. ‘직접 연결’ 모드는 일반적으로 코어에 들어온 요청을 대상에 바로 연결하므로 직접 연결이 필요한 상황에 적합합니다. 직접 연결 모드는 클라이언트를 종료하는 기능이 아니며 운영체제의 프록시 설정을 자동으로 해제하지도 않습니다.

일상적으로는 규칙 모드를 유지하고 규칙 집합, DNS, 노드 프로토콜 설정을 한꺼번에 바꾸지 마세요. 화면에 규칙 모드가 표시되어도 앱 트래픽이 클라이언트에 들어간다는 보장은 없습니다. 다음 단계에서 연결을 시작하고 트래픽 연결 방식을 선택해야 합니다. proxy-groups, rules 및 규칙 매칭 순서에 관한 자세한 설명은 설정 필드 참고에서 확인하세요.

이 단계의 완료 기준: 규칙 모드가 선택되어 있고 규칙에서 사용하는 정책 그룹에 아웃바운드가 지정되어 있어야 합니다. 규칙 모드에서는 일부 요청이 직접 연결될 수 있으므로 ‘모든 사이트의 외부 IP가 바뀌었다’를 판단 기준으로 삼지 마세요.

3단계: 연결 시작

홈으로 돌아가 연결 스위치를 조작해 클라이언트를 시작하고 현재 설정을 불러오세요. 버전에 따라 연결 동작과 시스템 프록시 설정이 연동되거나 각각 별도로 제공될 수 있습니다. 따라서 ‘코어가 실행 중인지’와 ‘앱 트래픽이 연결됐는지’를 따로 확인해야 합니다. 홈 화면의 스위치가 켜져 있다는 이유만으로 브라우저가 프록시를 사용한다고 판단할 수는 없습니다.

데스크톱: 먼저 시스템 프록시 활성화

Windows, macOS, Linux에서는 먼저 ‘시스템 프록시’ 설정을 찾아 활성화하고 TUN은 꺼 두세요. 시스템 프록시를 사용하면 운영체제의 프록시 설정을 따르는 앱이 요청을 로컬 수신 포트로 보냅니다. 브라우저는 첫 테스트에 적합하지만, 별도의 프록시 설정을 사용하는 앱이나 시스템 설정을 무시하는 앱도 있습니다. 기본 연결이 확인된 뒤 그런 앱을 따로 설정하세요.

연결하기 전에 시스템 프록시나 VPN을 이미 관리 중인 다른 프로그램을 종료해 시스템 설정이 서로 덮어쓰이지 않게 하세요. 브라우저에 프록시 전환 확장 프로그램이 설치되어 있다면 다른 주소를 강제로 지정하는지도 확인해야 합니다. 첫 확인에서는 프록시 연결 지점을 하나만 유지하세요. 여러 확장 프로그램, 수동 프록시, TUN을 동시에 켜고 어느 설정이 작동했는지 추측하지 마세요.

포트 충돌 알림이 표시되면 설정 페이지에 나온 혼합 포트를 확인하세요. 일반적인 설정에서는 mixed-port: 7890을 사용하지만 구독, 클라이언트 또는 기존 설정에 따라 포트가 다를 수 있으므로 현재 값을 기준으로 삼으세요. 먼저 해당 포트를 사용하는 다른 클라이언트를 종료하세요. 포트를 변경해야 한다면 앱에 수동 입력한 프록시 주소도 함께 수정해야 합니다. 원격 노드만 바꿔서는 로컬 수신 포트 충돌을 해결할 수 없습니다.

Android: 시스템 VPN 권한 확인

Android에서 처음 연결할 때는 시스템 VPN 연결 요청이 표시되는 경우가 많습니다. 연결을 허용하기 전에 요청한 앱이 방금 설치해 사용할 클라이언트인지 확인하세요. 권한을 허용한 뒤 클라이언트로 돌아와 실행 상태인지 살펴봅니다. 시스템에서 다른 VPN이 이미 실행 중이라면 보통 기존 연결을 끊은 다음 새 연결을 시작해야 합니다. 시스템 VPN 두 개를 동시에 실행하는 방식은 기본 설정으로 사용할 수 없습니다.

앱에서 앱별 프록시를 설정했다면 테스트할 브라우저가 적용 대상에 포함되어 있는지 확인하세요. 포함되지 않으면 클라이언트가 정상 실행 중이어도 브라우저는 직접 연결할 수 있습니다. 연결 후 시스템 VPN 표시가 나타나면 시스템 터널이 만들어졌다는 뜻일 뿐, 원격 노드와 규칙, DNS가 모두 정상이라는 의미는 아닙니다. 4단계까지 진행해 확인하세요.

TUN은 언제 켜야 하나요?

브라우저가 시스템 프록시를 통해 정상적으로 접속되는데 특정 앱만 프록시 설정을 따르지 않을 때 TUN을 고려하세요. 데스크톱의 TUN은 가상 네트워크 인터페이스를 통해 더 많은 트래픽을 연결하며 관리자 권한이나 클라이언트 서비스가 필요할 수 있습니다. 라우팅과 DNS 동작도 설정의 영향을 받습니다. 처음부터 TUN을 모든 연결 문제를 해결하는 스위치처럼 사용하지 말고, 노드를 사용할 수 없는 상태에서 반복해서 켜고 끄지 마세요.

시작에 실패하면 로그를 열고 연결 버튼을 누른 뒤 처음으로 나타난 명확한 오류부터 확인하세요. 설정 로드 실패, 수신 주소 점유, 권한 부족은 각각 다른 단계의 문제이므로 따로 해결해야 합니다. 오류 내용이 길다면 필요한 항목만 남기고 개인 정보는 가린 뒤 mihomo 로그 오류별 확인 방법을 참고해 계속 점검하세요.

이제 현재 설정, 규칙 모드, 선택한 노드, 명확한 트래픽 연결 방식이 준비되어 있어야 합니다. 설정은 그대로 두고 새 요청만 보내 실제로 어떤 경로를 거치는지 확인하세요.

4단계: 작동 여부 확인

브라우저에서 새 페이지를 열고 현재 네트워크에서 접속할 수 있는 테스트 대상에 접속하세요. 이미 로드된 탭만 살펴보지 마세요. 기존 페이지가 캐시를 사용하거나 이미 열린 장기 연결이 이전 경로를 계속 사용할 수 있습니다. 필요하면 기존 탭을 닫고 다시 열어 현재 설정 이후의 새 요청을 확인하세요.

웹 접속과 연결 기록 대조하기

대상에 접속하는 동시에 클라이언트의 ‘연결’ 페이지를 열고 도메인이나 최근 기록으로 요청을 찾으세요. 대상 주소, 적용된 규칙, 실제 아웃바운드를 확인합니다. 설정에 따라 대상에 직접 연결 규칙이 적용되었다면 직접 연결로 표시되는 것이 정상입니다. 프록시 노드를 확인하려면 모든 요청이 같은 아웃바운드로 표시되기를 기대하지 말고, 현재 규칙이 실제로 프록시 그룹에 보내는 대상을 선택하세요.

외부 IP 확인 사이트는 보조 수단으로 사용할 수 있지만, 먼저 해당 요청이 어떤 아웃바운드를 사용하는지 확인하세요. 조회 도메인이 규칙에 따라 직접 연결된다면 로컬 네트워크의 외부 IP가 표시되어도 클라이언트 전체가 작동하지 않는다는 뜻은 아닙니다. 새 요청이 연결 기록에 나타나고, 예상한 규칙과 노드를 사용하며, 대상 페이지가 정상적으로 로드되는지 확인하는 것이 더 확실합니다. 노드 지연 테스트나 홈 화면의 실행 상태만으로는 이 확인을 대신할 수 없습니다.

실패하면 연결 방식, 규칙, 노드 순서로 점검

접속에 실패했는데 연결 목록에 해당하는 새 요청이 없다면 먼저 시스템 프록시가 켜져 있는지, 브라우저가 별도의 프록시를 사용하는지, Android의 앱별 적용 범위에 브라우저가 포함됐는지 확인하세요. 캐시와 기존 연결의 영향도 배제해야 합니다. 이때는 먼저 트래픽 연결을 점검하세요. 요청이 아직 코어에 들어가지 않았을 수 있으므로 DNS부터 바꾸지 마세요.

연결 기록은 있지만 실제 아웃바운드가 예상한 노드가 아니라면 2단계로 돌아가 모드와 정책 그룹 선택을 확인하세요. 규칙이 대상을 다른 그룹으로 보내거나 그룹에서 직접 연결을 선택했을 수 있습니다. 아웃바운드는 맞지만 로그에 연결 시간 초과가 표시되면 모드는 그대로 두고 사용 가능하다고 확인된 노드 하나만 바꿔 테스트하세요. 도메인 확인 오류가 명확히 나타날 때는 설정의 DNS 동작을 확인합니다. 자세한 필드와 Fake-IP 원리는 설정 필드 참고에서 확인할 수 있으며, 첫 설정에서 관련 항목을 한꺼번에 다시 작성할 필요는 없습니다.

한 번에 한 항목만 바꾼 뒤 같은 대상으로 다시 요청하고 결과를 기록하세요. 그래야 ‘노드를 바꾼 뒤 복구됨’과 ‘연결 방식을 바꾼 뒤 복구됨’을 구분할 수 있습니다. 구독을 바꾸고 TUN을 켜고 전역 모드로 전환한 뒤 DNS까지 수정하면 일시적으로 접속되더라도 실제 원인을 파악하기 어렵고, 나중에 원래 설정으로 되돌릴 때 다시 끊길 수 있습니다.

확인 후 일상적으로 설정 관리하기

작동을 확인한 뒤 현재 유효한 설정을 유지하고 구독 제공업체의 안내에 따라 업데이트하세요. 업데이트할 때는 기존 설정 항목을 새로고침하면 되며 매번 새 설정을 추가할 필요는 없습니다. 업데이트 후 정책 그룹을 다시 확인하세요. 노드 이름이나 그룹 구성원이 바뀌면 기존 선택을 조정해야 할 수 있습니다. 자동 업데이트 간격은 클라이언트와 서비스 제공업체에 따라 다르므로 제한 사항을 모른 채 지나치게 자주 요청하도록 설정하지 마세요.

사용을 마치면 시스템 프록시를 끄거나 클라이언트의 정상 연결 해제 기능을 사용해 트래픽 연결을 해제한 뒤 앱을 종료하세요. 앱이 비정상 종료된 후 브라우저에서 갑자기 인터넷에 접속할 수 없다면 시스템 프록시가 더 이상 수신하지 않는 로컬 포트를 가리키는지 확인하세요. Android에서는 VPN 연결이 끊겼는지 확인합니다. 앱 종료와 운영체제 네트워크 설정 해제는 항상 같은 동작이 아닙니다.

완료 기준: 현재 설정을 사용할 수 있고, 모드와 정책 그룹 선택이 명확하며, 새 요청에 예상한 규칙이 적용되어 접속이 완료되어야 합니다. 이 상태를 확인한 뒤 TUN, LAN 공유, 사용자 지정 규칙을 하나씩 추가하세요. 입문 과정을 마치기 위해 모든 설정을 미리 바꿀 필요는 없습니다.

설정 필드와 병합 방식은 설정 필드 참고에서 확인하세요. 설치 권한과 초기 설정을 다시 점검하려면 최초 설치 후 초기 설정 체크리스트를 참고하세요. 이 페이지의 네 단계는 기기를 바꾸거나 설정을 다시 가져온 뒤 점검할 때도 활용할 수 있습니다.

Clash 다운로드