시작 가이드 / 첫 설정

FlClash 구독 가져오기
및 연결 설정

설정을 처음 마치려면 구성 가져오기, 규칙 모드 선택, 시스템 트래픽 연결, 실제 출구 확인의 4단계를 진행하세요. 사용할 수 있는 구독이 준비돼 있다면 주요 설정을 약 10분 안에 마칠 수 있습니다. 다운로드 실패나 시스템 권한 문제는 별도로 해결해야 합니다.

먼저 운영체제와 아키텍처에 맞는 클라이언트를 설치하고, 서비스 제공업체가 안내한 구독 URL 또는 mihomo 호환 YAML 설정을 준비하세요. FlClash는 설정 및 연결 도구이며, 클라이언트를 설치하는 것만으로 프록시 서비스가 생성되지는 않습니다. 아직 설치하지 않았다면 설치 파일을 확인하세요.

구독을 가져와 설정 활성화하기

FlClash를 열고 ‘설정’ 페이지로 이동합니다. 데스크톱에서는 보통 왼쪽 탐색 메뉴, 모바일에서는 하단 메뉴에서 찾을 수 있습니다. 추가 또는 더하기 버튼을 누르고 URL 가져오기를 선택한 다음 구독 URL 전체를 입력란에 붙여 넣습니다. 설정을 구분하기 쉬운 이름도 지정하세요. 이 이름은 로컬 관리용이며 서비스 내용에는 영향을 주지 않습니다. 저장하기 전에 URL 앞뒤에 공백이 붙지 않았는지 확인하세요. 특히 채팅 메시지에서 복사할 때 안내 문구까지 함께 선택하지 않았는지 살펴보세요.

구독 URL은 서비스 제공업체의 홈페이지나 계정 로그인 페이지가 아닙니다. 올바른 URL은 클라이언트가 지원하는 설정 내용을 반환해야 합니다. 서비스 제공업체가 가져오기 옵션을 여러 개 제공한다면 Clash, Clash Meta 또는 mihomo 호환이라고 명시된 설정 경로를 우선 선택하세요. 개별 프로토콜 링크 몇 개만 들어 있는 텍스트는 완전한 YAML 설정으로 가져올 수 없을 수 있으며, 이는 클라이언트 버전과 가져오기 기능에 따라 다릅니다. 이 경우 같은 URL을 계속 다시 시도하지 말고 서비스 제공업체의 사용 안내를 먼저 확인하세요.

파싱이 끝날 때까지 기다린 다음 현재 설정으로 선택하기

가져오기를 시작한 뒤 네트워크 연결을 유지하고 다운로드와 파싱이 끝날 때까지 기다립니다. 성공하면 ‘설정’ 목록에 방금 추가한 항목이 표시됩니다. 해당 항목이나 활성화 버튼을 눌러 현재 설정으로 지정하세요. 목록에 설정 카드가 보이는 것만으로 클라이언트가 이를 사용 중이라고 볼 수는 없습니다. 대시보드로 돌아가 현재 설정 이름이 방금 가져온 항목과 일치하는지 확인하고, ‘프록시’ 페이지에서 정책 그룹과 선택 가능한 출구가 표시되는지 살펴보세요. 그룹 이름은 설정에 따라 달라지므로 튜토리얼과 같을 필요는 없습니다.

로컬 파일을 사용한다면 설정을 추가할 때 파일 가져오기를 선택하고 시스템 파일 선택기에서 YAML 파일을 여세요. 웹페이지를 파일로 저장한 뒤 확장자만 바꾸거나, 서식 문서를 일반 텍스트 설정 대신 사용하지 마세요. 파일 가져오기는 완성된 설정이 있을 때 적합하지만, 서비스 변경에 따라 자동 업데이트되는지는 파일에 포함된 원격 리소스와 클라이언트 설정에 달려 있습니다. 로컬 파일이 구독에 연결된 온라인 설정이라고 가정해서는 안 됩니다.

가져오기에 실패하면 이 단계에서 먼저 멈추기

다운로드 실패, 파싱 오류 또는 빈 설정이 표시되면 오류 메시지를 먼저 보관하세요. 다운로드 실패라면 URL, 현재 네트워크, 서비스 유효 기간을 확인합니다. 파싱 오류라면 응답 내용이 실제로 호환 설정인지 확인하세요. 브라우저에서 URL이 열리더라도 반환되는 내용이 클라이언트에 적합하다는 뜻은 아닙니다. 로그인 안내 페이지도 다운로드 자체는 성공할 수 있습니다. 기존 설정이 작동한다면 비교 기준을 잃지 않도록 먼저 삭제하지 마세요. 자세한 내용은 FAQ의 설치 및 설정 안내를 확인하고, 계속 실패하면 문제 진단의 구독 가져오기 실패 항목으로 이동하세요.

계속하기 전에 확인: 설정을 가져왔고 현재 설정으로 지정했으며, 프록시 페이지에 사용 가능한 항목이 표시돼야 합니다. 이 세 가지를 확인한 뒤 요청 처리 모드와 출구를 선택하세요.

규칙 모드와 프록시 출구 선택하기

대시보드로 돌아가 ‘아웃바운드 모드’ 또는 이에 해당하는 설정을 찾아 ‘규칙’으로 지정합니다. 처음 사용하는 경우 규칙 모드부터 시작하는 것이 좋습니다. 일반적인 구독에는 웹사이트 분류와 정책 그룹이 이미 포함돼 있어 클라이언트가 설정된 규칙에 따라 요청을 하나씩 판별한 뒤 직접 연결하거나 프록시로 보냅니다. 여기서 ‘규칙’은 모든 사용자에게 맞는 분할 라우팅을 자동으로 만드는 기능이 아니라 현재 설정에 있는 규칙을 적용하는 모드입니다. 따라서 첫 단계에서 올바른 현재 설정을 선택하는 것이 중요합니다.

그다음 ‘프록시’ 페이지에서 규칙이 실제로 가리키는 정책 그룹을 찾습니다. 그룹에서 직접 선택할 수 있다면 현재 사용 가능한 출구를 선택하고 선택 표시가 바뀌었는지 확인하세요. 자동 선택 또는 장애 조치 정책 그룹을 사용한다면 먼저 후보 항목이 있는지 살펴보고 필요하면 연결 테스트를 실행합니다. 테스트 결과는 해당 테스트 대상에 연결할 수 있는지를 판단하는 참고 자료일 뿐, 모든 웹사이트의 접속을 보장하지 않습니다. 숫자 하나만으로 서비스 품질을 판단해서도 안 됩니다.

모드 선택과 출구 선택 구분하기

아웃바운드 모드는 요청을 처리할 방식을 정하고, 정책 그룹은 프록시가 필요한 요청을 실제로 어디로 보낼지 정합니다. 규칙 모드를 선택했더라도 그룹에서 직접 연결 항목을 선택하면 요청이 직접 연결될 수 있습니다. 반대로 프록시 출구를 선택해도 직접 연결 규칙에 해당하는 웹사이트는 바로 접속합니다. 설정에 여러 단계의 정책 그룹이 있다면 현재 선택 항목을 따라 다음 단계의 선택도 확인하세요. 실제로 참조되지 않는 그룹 하나만 변경하는 일이 없도록 주의해야 합니다.

‘전역’ 모드는 보통 클라이언트가 연결한 요청을 전역 정책으로 보내며, 규칙 모드와의 차이를 잠시 비교할 때 사용할 수 있습니다. 그렇다고 시스템의 모든 앱이 반드시 클라이언트를 거치는 것은 아닙니다. 앱이 연결되는지는 다음 단계의 시스템 프록시, VPN 또는 TUN 설정에 따라 달라집니다. ‘직접 연결’ 모드는 프록시 없이 접속하는 방식이므로 이 상태에서 프록시 출구가 작동하는지 판단하면 안 됩니다. 처음 연결할 때 여러 모드를 계속 바꿀 필요는 없습니다. 규칙 모드와 사용 가능한 출구 하나를 유지하면 문제를 더 쉽게 찾을 수 있습니다.

구독 규칙을 먼저 사용하고 YAML 수정은 미루기

설정에 이미 규칙이 있다면 우선 그대로 두고 연결을 한 번 완료하세요. 규칙 순서, DNS 또는 정책 그룹 이름을 바꾸면 문제를 찾을 때 고려할 변수가 늘어나고, 구독을 업데이트하면 직접 수정한 내용이 덮어써질 수도 있습니다. 특정 웹사이트를 프록시로 보내려면 먼저 현재 어떤 규칙이 적용되는지 확인한 뒤 필요한 부분만 조정하세요. 규칙의 위에서 아래로의 매칭, 최종 기본 규칙, 정책 그룹 참조에 대한 자세한 설명은 FAQ의 사용 팁 분류에서 확인할 수 있습니다. 처음 사용하는 단계에서는 이 항목들을 수정할 필요가 없습니다.

이 시점에서 현재 설정, 아웃바운드 모드, 정책 그룹 선택을 기록해 두면 다음 단계의 확인 기준으로 사용할 수 있습니다. 프록시 목록이 비어 있다면 전역 모드로 바꿔 출구가 자동으로 추가되길 기대하지 말고 첫 단계로 돌아가 설정을 확인하세요. 목록은 있지만 테스트가 모두 실패한다면 구독 서비스 상태와 로컬 네트워크부터 점검하세요. 계속하기 전에 확인: 대시보드에 규칙 모드가 표시되고 관련 정책 그룹에서 출구가 선택돼 있어야 합니다. 확인한 뒤 앱 트래픽을 클라이언트에 연결하세요.

연결 시작 및 시스템 트래픽 연결

설정과 출구 선택을 마치면 대시보드로 돌아가 연결 또는 시작 버튼을 누릅니다. 상태가 실행 중으로 바뀌는지 확인하고 포트 사용 중, 권한 부족 또는 설정 로드 오류가 표시되는지도 살펴보세요. 코어가 성공적으로 시작됐다는 것은 클라이언트가 요청을 처리할 준비를 마쳤다는 뜻일 뿐입니다. 브라우저와 다른 앱에서 요청을 보내려면 해당 플랫폼에 맞는 연결 방식도 설정해야 합니다. 데스크톱과 Android의 연결 방식은 다르므로 아래에서 해당 플랫폼의 절차를 따르세요. 모든 옵션을 켜려고 네트워크 설정을 여러 개 동시에 바꾸지 마세요.

데스크톱: 시스템 프록시로 브라우저부터 확인하기

Windows, macOS 또는 Linux에서 먼저 FlClash의 ‘시스템 프록시’를 켠 다음 시스템 프록시 설정을 따르는 브라우저로 웹페이지를 엽니다. 시스템 프록시는 해당 설정을 읽는 앱에만 영향을 주며 네트워크 전체를 완전히 연결하지는 않습니다. 일부 Linux 데스크톱 환경과 앱은 같은 프록시 설정을 따르지 않을 수 있고, Firefox 같은 앱은 별도 설정을 사용할 수도 있습니다. 브라우저에 적용되지 않는다면 구독을 바로 수정하지 말고 브라우저가 시스템 프록시를 사용하도록 설정돼 있는지 먼저 확인하세요.

처음 설정할 때는 기본 혼합 포트를 그대로 사용해도 됩니다. 흔히 기본값은 7890이지만 실제 값은 클라이언트에 표시된 내용을 기준으로 하세요. 다른 프록시 도구가 같은 포트를 사용 중이라면 충돌하는 프로그램을 먼저 종료한 뒤 FlClash를 다시 시작합니다. 임의의 포트를 입력해 보거나 시스템 프록시를 켠 직후 클라이언트를 강제 종료하지 마세요. 시스템이 로컬 프록시를 계속 가리키는데 프로그램이 종료되면 웹페이지에 일시적으로 접속할 수 없게 됩니다.

브라우저는 작동하지만 시스템 프록시를 따르지 않는 앱이 예상대로 접속하지 못한다면 TUN을 고려하세요. TUN은 가상 네트워크 인터페이스를 통해 트래픽을 연결하며, 운영체제와 클라이언트 버전에 따라 관리자 권한, 서비스 구성 요소 또는 시스템 네트워크 권한이 필요할 수 있습니다. 먼저 현재 설정을 저장하고 안내에 따라 활성화한 다음 권한을 승인하고 정상적으로 시작됐는지 확인하세요. 라우팅, DNS, 다른 VPN과의 충돌은 문제 해결에서 항목별로 확인하고, 이번에는 고급 매개변수를 동시에 바꾸지 마세요.

Android: 시스템 VPN 권한 확인하기

Android에서 시작을 누르면 처음에는 시스템에서 VPN 연결 요청이 표시될 수 있습니다. 방금 설치해 직접 실행한 FlClash에서 보낸 요청인지 확인한 뒤 안내를 읽고 승인하세요. 일반적으로 시스템 상태 표시줄이나 네트워크 설정에 VPN 실행 중이라고 표시되고, 클라이언트에도 시작 상태가 나타납니다. 권한을 거부했다면 설정 가져오기에 성공했더라도 앱 트래픽이 프록시로 연결됐다고 볼 수 없습니다. 시스템마다 상태 표시줄 아이콘이 다를 수 있으므로 클라이언트와 시스템 VPN 페이지를 함께 확인하세요.

휴대폰에서 다른 VPN을 사용 중이라면 먼저 중지한 뒤 FlClash에 연결하세요. 두 도구가 같은 연결 지점을 차지하려고 하는 상황을 방지할 수 있습니다. 앱별 분할 설정을 사용 중이라면 테스트할 브라우저가 연결 허용 목록에 포함돼 있는지도 확인하세요. 제외된 앱은 연결 버튼을 눌렀다고 자동으로 프록시를 사용하지 않습니다. 우선 기본 앱 범위를 유지하고 확인을 마친 뒤 실제 필요에 따라 세분화하면 첫 설정 때 발생하는 변수를 줄일 수 있습니다.

연결에 성공하면 다음 단계의 테스트를 진행하는 동안 클라이언트를 실행 상태로 유지하세요. Android에서 화면을 잠근 뒤에만 연결이 끊긴다면 기본 연결이 정상인지 확인한 다음 배터리 최적화와 백그라운드 실행 권한을 점검하세요. 처음부터 모든 절전 설정을 변경할 필요는 없습니다. 계속하기 전에 확인: 클라이언트가 정상 실행 중이고 플랫폼에 맞게 데스크톱 시스템 프록시 또는 모바일 VPN을 활성화했으며, 다른 프록시 프로그램이 간섭하지 않아야 합니다.

웹 접속 및 실제 트래픽 라우팅 확인하기

연결 버튼에 실행 중이라고 표시되더라도 상태 색상만으로 결과를 판단하지 마세요. 먼저 방금 연결 여부를 확인한 브라우저에서 직접 연결이 예상되는 웹사이트를 열고, 이어서 설정상 프록시를 사용해야 하는 웹사이트를 열어 각각 정상적으로 로드되는지 확인합니다. 두 종류의 요청을 모두 테스트해야 합니다. 프록시 사이트만 확인하면 직접 연결 경로의 DNS나 규칙 문제를 놓칠 수 있고, 원래 접속되던 사이트만 확인하면 프록시 출구를 실제로 사용했는지 알 수 없습니다.

테스트할 때 페이지를 새로고침하고 필요하다면 전에 방문하지 않은 페이지도 열어 보세요. 기존 연결, 브라우저 캐시, 백그라운드 탭 때문에 시작 전후의 차이가 드러나지 않을 수 있습니다. 브라우저 프록시 확장 프로그램을 여러 개 사용하거나 다른 클라이언트를 동시에 실행하지 마세요. 웹페이지가 열리더라도 어떤 설정이 적용됐는지 확인하기 어려워집니다. 브라우저가 별도의 프록시 설정을 사용한다면 먼저 기존 설정을 기록한 뒤 시스템 프록시 사용으로 임시 변경해 비교하세요.

연결 기록에서 대상과 출구 확인하기

FlClash의 ‘연결’ 페이지를 열고 웹페이지에 다시 접속한 뒤 해당 도메인을 찾습니다. 현재 버전에서 제공하는 정보를 바탕으로 요청에 적용된 규칙, 거친 정책 그룹, 최종 출구를 확인하세요. 연결이 짧게 끝나 기록을 확인하기 어렵다면 페이지를 새로고침하거나 로그를 참고할 수 있습니다. 로그 수준이 너무 낮으면 세부 정보가 표시되지 않을 수 있으므로 필요한 동안만 임시로 조정하세요. 확인을 마치면 평소 사용하는 수준으로 되돌려 불필요한 기록이 계속 쌓이지 않도록 합니다.

페이지는 열리지만 기록상 최종 연결이 직접 연결로 표시된다면 먼저 설정상 예상된 결과인지 확인하세요. 규칙 모드에서 직접 연결 사이트와 프록시 사이트의 출구가 다른 것은 정상입니다. 출구 IP 조회로 확인하려면 조회 요청 자체가 프록시 정책에 적용됐는지 먼저 확인한 뒤 결과를 비교하세요. IP가 바뀌지 않았다는 이유만으로 클라이언트 전체가 작동하지 않는다고 단정할 수는 없습니다. 대상마다 적용되는 규칙이 다르므로 확인 결과는 특정 요청에 대해서만 판단해야 하며, 한 번의 테스트로 모든 앱을 검증할 수는 없습니다.

실패하면 마지막으로 성공한 단계부터 다시 확인하기

연결 전에는 웹페이지가 정상적으로 열렸지만 연결 후 모두 접속할 수 없다면 먼저 연결을 끄고 시스템 프록시를 복원한 뒤 기본 네트워크가 정상인지 확인하세요. 그다음 방금 선택한 출구와 연결 설정을 점검합니다. 일부 웹사이트만 실패한다면 설정과 모드를 그대로 유지하고 실패한 도메인, 오류 메시지, 실제 적용 규칙을 기록한 뒤 서비스 연결 상태나 DNS를 확인하세요. 한 번에 조건 하나만 변경하고 같은 대상에 다시 접속해야 어느 단계가 영향을 줬는지 알 수 있습니다.

브라우저는 정상인데 다른 앱에 변화가 없다면 앱이 시스템 프록시를 따르는지, Android 앱별 분할에서 제외됐는지 먼저 확인하세요. 프록시 후보가 모두 시간 초과된다면 구독 서비스, 시스템 시간, 로컬 방화벽을 점검합니다. 자세한 점검 순서는 문제 해결에서, 자주 쓰이는 개념과 설정 차이는 FAQ에서 확인하세요. 먼저 재현 가능한 방식으로 작동을 확인하면 됩니다. 곧바로 DNS를 수정하거나 설정 전체를 다시 만들 필요는 없습니다.

마지막으로 종료 상태를 확인하세요. 먼저 FlClash에서 연결을 끄고 데스크톱에서는 시스템 프록시가 꺼졌거나 원래 상태로 복원됐는지 확인한 뒤 프로그램을 종료합니다. Android에서는 VPN 연결이 중지됐는지 확인하세요. 클라이언트를 다시 열 때 현재 설정, 규칙 모드, 출구 선택이 그대로 올바른지 점검합니다. 구독 내용이 바뀌었다면 설정 페이지에서 업데이트한 뒤 다시 테스트하세요. 같은 URL을 매번 새 설정으로 추가하지 마세요. 이로써 첫 사용에 필요한 주요 설정이 끝났습니다. 이후에는 실제 앱 사용 방식에 맞춰 필요한 항목을 차례로 조정하면 됩니다.