docs / getting-started.md

Clash 입문 튜토리얼: 구독 가져오기부터 작동 확인까지

이 페이지는 실제 작업 순서에 따라 4단계로 나눠 설명합니다: 구독 가져오기 → 프록시 모드 선택 → 시스템 프록시 켜기 → 작동 확인. 각 단계마다 어디를 클릭하는지, 무엇이 보이는지, 다음에 무엇을 할지 명확히 설명하며 전체 소요 시간은 약 10분입니다. 시작하기 전 두 가지가 필요합니다: 설치가 완료된 Clash 클라이언트(아직 설치하지 않았다면 먼저 클라이언트 받기), 그리고 서비스 제공업체가 제공하는 구독 링크입니다. 플랫폼별 설치 세부사항과 TUN 모드 등 고급 설정은 이 페이지에서 다루지 않으며, 전체 문서를 참고하세요.

플랫폼 차이 안내: 이 페이지는 Clash Plus, Clash Verge Rev, FlClash 등 주요 GUI 클라이언트의 공통 인터페이스를 기준으로 합니다. 클라이언트마다 메뉴 명칭이 조금씩 다릅니다—프로필 페이지는 「프로필」, 「구독」 또는 Profiles로 표시될 수 있고, 프록시 페이지는 「프록시」 또는 Proxies로, 시스템 프록시 스위치는 메인 화면이나 「설정」 안에 있을 수 있습니다. 이름이 일치하지 않으면 기능으로 찾으세요: 구독 파일을 관리하는 곳이 프로필 페이지, 노드와 정책 그룹을 나열하는 곳이 프록시 페이지입니다. 클라이언트별 화면 구성의 상세 대응은 FAQ를 참고하세요.
  1. 구독 가져오기

    구독 링크는 https://로 시작하는 긴 URL로, 프록시 서비스 제공업체나 자체 구축한 서비스의 관리 페이지에서 제공됩니다. 클라이언트는 이 주소에서 노드와 규칙이 포함된 프로필 파일을 내려받습니다. 먼저 서비스 제공업체의 사용자 센터에서 「구독 링크 복사」 또는 비슷한 버튼을 찾아 전체 링크를 클립보드에 복사하세요. Clash 형식의 구독을 복사해야 합니다—일부 제공업체는 여러 형식을 동시에 제공하며 버튼에 형식이 표시되어 있습니다. 링크는 완전해야 하며, 끝부분 파라미터도 한 글자도 빠뜨리면 안 됩니다.

    클라이언트를 열고 프로필 페이지로 이동합니다(Clash Verge Rev와 FlClash는 사이드바에 「프로필」 항목이 있고, Clash Plus는 하단 또는 사이드 내비게이션에 있습니다). 화면 상단이나 우측 상단에 입력창이 있거나, 「가져오기」 혹은 「+」 버튼을 눌러야 입력창이 나타납니다. 방금 복사한 구독 링크를 붙여넣고 「가져오기」, 「다운로드」를 클릭하거나 엔터를 눌러 확인합니다. 클라이언트는 이때 구독 주소로 요청을 보내며, 정상적인 경우 1~2초 안에 완료됩니다.

    가져오기 성공의 신호: 프로필 목록에 이름과 업데이트 시간이 표시된 새 프로필 카드 또는 항목이 나타나며, 일부 클라이언트는 구독에 포함된 트래픽과 만료 정보도 함께 보여줍니다. 이 항목을 클릭해 현재 사용할 프로필로 지정합니다(대부분의 클라이언트는 한 번 클릭하면 선택되며, 선택된 항목은 강조 표시나 체크 표시로 나타납니다). 여기까지 진행하면 구독 가져오기가 완료된 것입니다.

    가져오기가 오류를 내거나 로딩 후 실패한다면 흔한 원인은 세 가지입니다: 링크 복사가 불완전함, 구독 자체가 이미 만료됨, 현재 네트워크 환경에서 구독 서버에 접속할 수 없음. 먼저 브라우저 주소창에 구독 링크를 직접 열어보세요. 긴 텍스트 내용이 보이면 링크 자체는 정상이며 문제는 클라이언트 쪽에 있는 것입니다. 열리지 않는다면 서비스 제공업체 관리 페이지에서 구독을 재설정한 뒤 다시 시도하세요. 체계적인 점검 절차는 FAQ의 설치·설정 분류를 참고하세요.

    팁: 프로필 페이지에서는 대부분 구독의 자동 업데이트 주기(예: 24시간마다)도 설정할 수 있습니다. 활성화를 권장합니다—서비스 제공업체가 노드를 변경해도 로컬 프로필이 자동으로 따라가므로, 실제로는 단순히 프로필이 오래된 것뿐인데 「모든 노드가 타임아웃」으로 보이는 상황을 피할 수 있습니다.

    구독 준비 완료 → 다음 단계는 트래픽 경로 선택

  2. 프록시 모드 선택

    Clash에는 트래픽을 어떤 방식으로 전달할지 결정하는 세 가지 아웃바운드 모드가 있습니다. 규칙 모드(Rule)는 프로필에 정의된 분기 규칙을 순서대로 매칭하여 한국 국내 주소는 직접 연결하고 프록시가 필요한 경우 노드를 경유합니다. 전역 모드(Global)는 구분 없이 모든 트래픽을 프록시로 보냅니다. 직결 모드(Direct)는 모든 트래픽을 프록시 없이 전송합니다. 일상적인 사용에는 규칙 모드를 선택하세요—속도와 가용성을 모두 확보하며, 국내 사이트는 우회하지 않고 해외 사이트는 자동으로 노드를 경유합니다. 전역 모드는 「특정 사이트가 규칙에 매칭되지 않는지」 같은 문제를 진단할 때만 임시로 전환합니다.

    모드 전환 위치: Clash Verge Rev는 사이드바 「프록시」 페이지 상단에 세 가지 모드 버튼이 있고, FlClash는 메인 화면의 아웃바운드 모드 카드에 있으며, Clash Plus는 메인 화면의 모드 선택기에 있습니다. 「규칙」을 클릭하면 즉시 적용되며 재시작할 필요가 없습니다.

    다음으로 노드를 선택합니다. 프록시 페이지로 이동하면 하나 이상의 정책 그룹이 보이는데, 이는 프로필에 정의된 노드 그룹으로 「노드 선택」, 「PROXY」, 「자동 선택」 같은 이름이 흔합니다. 수동 선택 유형의 정책 그룹을 펼치면 사용 가능한 모든 노드가 나열되며, 하나를 클릭해 선택하면 됩니다. 대부분의 클라이언트는 프록시 페이지에 지연 시간 테스트 버튼(번개나 파형 아이콘)을 제공하며, 클릭하면 각 노드 옆에 밀리초 단위의 지연 시간이 표시됩니다. 값이 낮고 안정적인 노드를 우선 선택하세요. 타임아웃(timeout)으로 표시된 노드는 현재 사용할 수 없으므로 다른 노드로 바꾸세요. 정책 그룹의 유형과 동작 방식은 용어집에 별도 항목으로 정리되어 있습니다.

    프록시 페이지가 비어 있고 노드가 하나도 없다면, 이전 단계의 프로필이 선택되지 않았거나 구독 내용이 비어 있다는 뜻입니다. 프로필 페이지로 돌아가 현재 프로필이 방금 가져온 항목인지 확인하고, 필요하면 수동으로 「업데이트」를 한 번 클릭하세요.

    모드와 노드 선택 완료 → 다음 단계는 시스템 트래픽을 클라이언트에 실제로 넘기기

  3. 시스템 프록시 켜기

    앞선 두 단계는 클라이언트를 「준비 상태」로 만든 것일 뿐, 시스템 트래픽은 아직 클라이언트로 넘겨지지 않았습니다. 트래픽을 클라이언트로 유입시키는 가장 일반적인 방법은 시스템 프록시입니다. 클라이언트는 자신이 리스닝하는 믹스드 포트(기본값 mixed-port: 7890)를 운영체제의 프록시 설정에 기록하고, 시스템 프록시를 따르는 브라우저 등의 앱은 이 포트를 통해 트래픽을 송수신하게 됩니다.

    플랫폼별 활성화 위치와 최초 승인 절차:

    • Windows: 클라이언트 메인 화면이나 「설정」에서 「시스템 프록시」 스위치를 찾아 켜면 됩니다. 활성화 후 트레이 아이콘의 색이 바뀌거나 표시가 추가되는 경우가 많으며, 시스템 「설정 → 네트워크 및 인터넷 → 프록시」에서 127.0.0.1:7890이 기록된 것을 확인할 수 있습니다.
    • macOS: 마찬가지로 「시스템 프록시」 스위치를 켭니다. 처음 켤 때 시스템 대화상자가 나타나 사용자 암호 입력을 요청하는데, 이는 네트워크 환경설정을 변경하기 위한 정상적인 승인 절차이며 입력하면 바로 적용됩니다. 메뉴 막대 아이콘은 계속 표시됩니다.
    • Android: GUI 클라이언트는 보통 VPN 방식으로 트래픽을 처리합니다. 메인 화면의 시작 버튼을 누르면 시스템이 「XX에서 VPN 연결을 만들려고 합니다」라는 확인창을 표시하며, 「확인」을 누르고 상태 표시줄에 열쇠 아이콘이 나타나면 정상 작동 중입니다.
    • iOS: 처음 실행하면 「VPN 구성 추가」를 요청하며, 허용하면 시스템 설정의 VPN 목록에서 해당 항목을 확인할 수 있습니다. 이후에는 앱 안에서 한 번의 클릭으로 켜고 끌 수 있습니다.

    스위치를 켠 뒤에는 특별한 변화가 없습니다—화면에 큰 변동은 없지만 프록시 경로는 이미 구축된 상태입니다. 주의할 점은 시스템 프록시가 「시스템 프록시 설정을 따르는」 앱에만 적용된다는 것입니다. 브라우저는 대부분 이를 따르지만, 많은 명령줄 도구와 게임은 이 설정을 읽지 않습니다. 네트워크 계층에서 모든 트래픽을 처리하려면 가상 네트워크 카드와 관리자 권한이 필요한 TUN 모드가 필요하며, 이는 고급 내용으로 설정 방법은 전체 문서의 해당 챕터를 참고하세요.

    주의: 스위치를 켤 때 bind: address already in use 오류가 나타나면 7890 포트가 다른 프로그램에 의해 사용 중이라는 뜻입니다(프록시 클라이언트를 두 개 동시에 켰을 때 흔히 발생). 여분의 클라이언트를 먼저 종료한 뒤 다시 시도하세요. 여전히 안 되면 설정에서 믹스드 포트를 변경하고, 점검 방법은 FAQ의 문제 해결 분류를 참고하세요.

    트래픽 연결 완료 → 마지막 단계는 경로가 실제로 작동하는지 확인

  4. 작동 확인

    「스위치가 초록색」이라는 이유만으로 설정이 성공했다고 판단하지 말고, 1분을 투자해 두 가지 차원에서 확인하세요.

    첫 번째 확인, 브라우저 테스트. 이전에 직접 접속할 수 없던 해외 사이트를 열어보세요. 정상적으로 로딩되면 브라우저 트래픽이 이미 통과했다는 뜻입니다. 동시에 국내 사이트를 열어 속도가 정상인지 확인하세요—규칙 모드에서는 국내 사이트가 직접 연결되어야 하며, 국내 사이트가 눈에 띄게 느려졌다면 규칙이 잘못 매칭되어 프록시를 경유했거나 현재 전역 모드일 가능성이 있습니다.

    두 번째 확인, 클라이언트 측 검증. 클라이언트의 「연결」(Connections) 또는 「로그」 페이지로 전환하고 방금 열었던 웹페이지를 새로고침하세요. 목록에 계속해서 새로운 연결 기록이 나타나야 하며, 각 항목에는 대상 도메인, 매칭된 규칙, 경유한 노드가 표시됩니다. 해외 도메인 기록이 선택한 노드를 경유하고 국내 도메인이 DIRECT로 표시되면 트래픽 분기가 의도대로 작동한다는 뜻입니다. 이 페이지는 이후 문제를 진단할 때도 가장 유용한 곳입니다.

    명령줄에 익숙하다면 터미널에서 출구 IP를 비교해볼 수도 있습니다:

    « 프록시를 사용하지 않고 로컬 공개 IP 반환 »
    curl https://api.ip.sb/ip
    
    « Clash 믹스드 포트를 명시적으로 경유하여 노드 출구 IP 반환 »
    curl -x http://127.0.0.1:7890 https://api.ip.sb/ip

    두 번 반환된 IP가 다르면 프록시 경로가 정상 작동함을 확인한 것입니다. 두 번째 명령이 연결 거부(connection refused) 오류를 반환한다면 포트 번호가 클라이언트 설정의 믹스드 포트와 일치하는지 확인하세요.

    검증에 실패하는 경우—웹페이지가 계속 로딩 중, 연결 페이지에 기록이 없음, 출구 IP가 변하지 않음—대부분 네 가지 원인 중 하나로 귀결됩니다: 노드 사용 불가(2단계로 돌아가 노드를 바꾸고 지연 시간을 다시 테스트), 구독 만료(1단계로 돌아가 프로필 업데이트), 시스템 프록시가 기록되지 않음(3단계로 돌아가 스위치를 다시 켜기), DNS 오염(전체 문서의 DNS 챕터 참고). 「노드 교체 → 구독 업데이트 → 스위치 확인」 순서로 처리하면 90%의 문제는 처음 두 단계에서 해결됩니다. 더 완전한 단계별 점검 목록은 FAQ에 있습니다.

    exit 0 —— 설정 완료, 이후에는 클라이언트를 백그라운드에서 실행 상태로 유지하기만 하면 됩니다

docs / see-also

다음으로 읽을 문서

클라이언트 다운로드