config.yaml / 첫 설정

Clash 사용법

구독을 가져오는 단계부터 첫 연결 기록을 확인하는 단계까지 안내합니다. 먼저 규칙 모드로 테스트 요청을 보내고, 필요에 따라 포트를 조정하거나 TUN을 활성화하세요.

01 / profiles

구독을 가져와 설정 적용하기

서비스 제공자나 관리자가 전달한, 현재 클라이언트에서 사용할 수 있는 구독 링크를 준비하세요. 구독 링크는 클라이언트가 설정을 가져오는 주소이며, 브라우저의 프록시 설정에 입력하는 서버 주소가 아닙니다. 링크에 계정 인증 정보가 포함될 수 있으니 복사할 때 전체 내용을 유지하고 공개 스크린샷이나 문제 해결 게시물에 붙여 넣지 마세요. 로컬 YAML 파일을 받았다면 ‘파일에서 가져오기’를 선택하면 됩니다. 링크를 만들려고 다른 곳에 업로드할 필요는 없습니다.

설정을 추가하고 다운로드가 끝날 때까지 기다리기

클라이언트에서 ‘구독’ 또는 ‘설정’ 페이지를 열고 원격 설정을 추가하세요. 먼저 소스 유형을 고른 다음 URL 입력란이 표시되는 화면도 있고, 바로 ‘URL에서 가져오기’를 선택하는 화면도 있습니다. 링크를 주소 입력란에 붙여 넣고 끝부분에 공백이나 문장 부호가 실수로 포함되지 않았는지 확인한 뒤 저장하세요. 이름은 구분하기 쉬운 메모로 지정하면 됩니다. 목록에 새 항목이 나타나면 다운로드가 끝날 때까지 기다리세요. ‘업데이트’ 버튼이 있다면 한 번 눌러 성공 상태나 최근 업데이트 시간이 표시되는지 확인합니다.

저장 후 형식 오류가 표시되면 먼저 계정 로그인 페이지나 사용 설명서 페이지가 아니라 구독 엔드포인트를 복사했는지 확인하세요. 브라우저에서 주소가 열린다고 해서 클라이언트가 해석할 수 있는 설정이 반환되는 것은 아닙니다. 인증에 실패하면 제공자 관리 화면에서 링크가 아직 유효한지 확인하고, 시간 초과가 발생하면 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인하세요. 가져오기가 완료되지 않은 상태에서 프록시 모드를 반복해서 바꿀 필요는 없습니다. 모드 전환은 설정을 다운로드하는 기능이 아닙니다.

새 설정이 사용 중인지 확인

가져오기에 성공했다는 것은 파일을 받았다는 뜻일 뿐입니다. 설정 목록으로 돌아가 방금 가져온 항목을 선택하거나 메뉴에서 ‘현재 설정으로 지정’을 누르세요. 체크 표시나 ‘사용 중’ 표시가 나타난 것을 확인한 뒤 화면을 나갑니다. 이어서 ‘프록시’ 페이지를 열고 해당 설정의 그룹 이름과 선택 가능한 노드가 보이는지 확인하세요. 목록이 이전 설정과 같다면 노드를 바꾸기 전에 현재 설정부터 확인합니다. 클라이언트가 이 설정을 불러온 것을 확인한 다음 연결을 어떤 방식으로 분배할지 정하세요.

02 / mode

프록시 모드와 정책 그룹 출구 선택

‘프록시’ 페이지나 홈 화면의 모드 메뉴에서 ‘규칙’, ‘전역’, ‘직접 연결’을 찾으세요. 처음 설정할 때는 ‘규칙’을 선택하는 것이 좋습니다. 트래픽이 클라이언트에 들어오면 규칙을 순서대로 확인하고, 일치하는 규칙에 지정된 대상으로 연결합니다. 대상은 직접 연결, 거부 또는 정책 그룹일 수 있습니다. 전환한 뒤 화면에서 규칙 모드가 선택되어 있는지 확인하세요. 옆의 노드 목록에서 체크 표시가 바뀐 것을 모드 전환으로 착각하지 않도록 주의하세요.

규칙이 어느 그룹을 가리키는지 확인

클라이언트에 규칙 목록이 있다면 먼저 이해하기 쉬운 도메인 규칙을 찾아 어떤 그룹을 가리키는지 확인한 다음 프록시 페이지에서 해당 그룹을 펼치세요. 규칙이 ‘수동 선택’을 가리킨다면 다른 그룹의 노드를 임의로 바꾸지 말고 그 그룹에서 현재 선택된 노드를 확인합니다. 선택 항목 자체가 또 다른 그룹이라면 다음 단계도 확인하세요. 자동 선택 그룹은 자체 테스트 결과에 따라 출구를 선택하며, 화면에는 현재 결과만 표시될 수 있습니다. 첫 연결을 확인하려고 자동 그룹을 수동 그룹으로 바꿀 필요는 없습니다.

규칙의 대상이 DIRECT라면 해당 요청은 설정에 따라 직접 연결됩니다. 옆의 프록시 노드가 정상이어도 이 요청에는 사용되지 않습니다. 대상이 REJECT라면 규칙에 따라 요청이 거부됩니다. 테스트할 때는 목적지가 분명한 도메인을 선택하세요. 프록시 출구를 확인하려는 경우 원래 직접 연결되어야 하는 도메인으로 테스트하지 마세요. 규칙 순서나 기본 처리 항목이 명확하지 않다면 구독 파일을 급히 수정하지 말고 설정 필드 안내서를 먼저 확인하세요.

전역 모드와 직접 연결 모드는 비교용으로 사용

전역 모드는 클라이언트에 들어온 트래픽을 전역 정책에 맡기므로 규칙에 따른 분기 결과를 임시로 비교할 때 유용합니다. 전환한 뒤에는 전역 정책에서 어떤 출구가 선택되어 있는지도 확인하세요. 직접 연결 모드에서는 가로챈 트래픽을 바로 전송합니다. 이는 시스템 프록시를 끄거나 VPN 연결을 끊는 것과 다릅니다. 어느 모드를 선택해도 클라이언트에 들어오지 않은 앱의 트래픽까지 버튼 하나로 처리할 수는 없습니다. 규칙 모드와 출구를 선택한 다음에는 시스템이나 앱이 요청을 클라이언트로 보내도록 설정해야 합니다.

03 / mixed-port

시스템 프록시 또는 클라이언트 연결 활성화

데스크톱에서는 시스템 프록시부터 설정

클라이언트를 실행한 상태에서 홈 화면, 트레이 메뉴 또는 설정 페이지의 ‘시스템 프록시’를 찾아 켜세요. 스위치가 바로 꺼지지 않는지도 확인합니다. 이 기능을 켜면 시스템 프록시 설정을 따르는 앱이 요청을 로컬 프록시로 보냅니다. 첫 테스트에서는 이런 브라우저를 사용하고 터미널, 게임, 자체 프록시를 설정한 앱은 나중에 확인하세요. 브라우저에 프록시 설정을 바꾸는 확장 프로그램이 설치되어 있다면 시스템 설정을 덮어쓰는지 먼저 확인하세요. 클라이언트 스위치가 켜져 있어도 브라우저가 다른 경로를 사용할 수 있습니다.

데스크톱 클라이언트에 시스템 프록시 스위치가 없거나 시스템 환경에서 자동 설정을 허용하지 않는다면 수동 프록시를 지원하는 테스트 앱에 주소와 포트를 입력할 수 있습니다. 먼저 클라이언트의 실제 수신 주소, 포트, 프로토콜을 확인하세요. 로컬 전용으로 사용하고 루프백 주소에서 수신하는 경우 주소에 127.0.0.1을 입력할 수 있습니다. 혼합 포트가 7890임을 확인한 경우에만 이 숫자를 입력하세요. 혼합 포트는 HTTP와 SOCKS 프록시 연결을 모두 받을 수 있습니다. 두 프로토콜의 포트가 분리되어 있다면 앱에서 선택한 프록시 유형에 맞는 포트를 입력하세요. 각 필드의 용도는 일반 필드를 참고하세요.

모바일에서 시스템 권한 확인

클라이언트 홈 화면으로 돌아가 ‘연결’ 또는 시작 버튼을 누르세요. 처음 시작할 때 시스템에서 VPN 연결 허용 여부를 물을 수 있습니다. 방금 실행한 클라이언트에서 표시된 확인 창인지 확인한 다음 시스템 안내에 따라 권한을 허용하세요. 클라이언트로 돌아와 연결됨으로 표시되는지 확인합니다. 시스템 상태 표시줄이나 VPN 설정에도 상태가 표시될 수 있습니다. 권한 허용은 시스템이 연결을 허용했다는 뜻일 뿐입니다. 클라이언트에 여전히 연결되지 않음으로 표시되면 현재 설정이 활성화되어 있는지, 다른 VPN이 연결을 사용 중인지, 시스템이 이번 연결 시도를 차단했는지 확인하세요.

첫 테스트에서는 시스템 프록시와 TUN을 동시에 켤 필요가 없습니다. 시스템 프록시 설정을 따르지 않는 앱도 있습니다. 브라우저에서는 연결되는데 해당 앱의 기록이 없다면 클라이언트가 TUN을 지원하는지, 활성화에 어떤 시스템 권한이 필요한지 확인하세요. 문제를 점검할 때는 한 번에 한 항목만 바꾸세요. 현재 설정과 모드는 유지한 채 트래픽 가로채기 방식만 바꿔 결과를 확인하면 연결 처리 문제와 규칙, 포트, 노드 문제를 구분하기 쉽습니다.

04 / DIRECT

요청이 예상대로 분기되는지 확인

웹 요청과 연결 기록 대조하기

클라이언트의 ‘연결’ 또는 ‘로그’ 페이지를 열어 둔 다음 어떤 규칙을 타야 하는지 아는 도메인을 테스트 브라우저에서 여세요. 새 탭에서 요청하는 것이 좋습니다. 캐시된 페이지만 보이거나 새 기록이 없으면 해당 탭을 닫고 다시 시도하거나 비슷한 다른 도메인으로 테스트하세요. 클라이언트로 돌아와 도메인과 시간을 기준으로 기록을 찾고 요청 총수만 확인하지 마세요. 페이지에는 이미지, 글꼴, API 요청도 함께 로드되며 각각의 도메인은 서로 다른 규칙에 매칭될 수 있습니다. 그중 아무 기록이나 대표 요청으로 간주해서는 안 됩니다.

해당 기록을 찾으면 먼저 대상이 올바른지 확인하고, 이어서 일치한 규칙과 실제 출구를 확인하세요. 프록시를 거쳐야 한다면 연결이 지정된 정책 그룹으로 전달된 뒤 예상한 노드를 사용하는지 확인합니다. 직접 연결이 예상된 요청이라면 DIRECT가 표시되는 것이 설정에 맞습니다. 클라이언트마다 표시되는 정보는 다릅니다. 연결 목록에 규칙 항목이 없다면 로그를 확인하세요. 웹페이지가 열리는지만으로 분기가 올바른지 판단할 수 없고, 노드 속도 테스트만으로 현재 브라우저가 해당 출구를 사용 중이라고 단정할 수도 없습니다.

기록을 보고 다음 점검 항목 찾기

요청이 클라이언트에 전혀 표시되지 않으면 앱의 트래픽이 프록시로 들어오는지부터 확인하세요. 데스크톱에서는 시스템 프록시, 브라우저 자체 프록시 설정, 실제 수신 포트를 확인하고 모바일에서는 VPN 상태와 앱 적용 범위를 확인합니다. 기록은 있지만 대상이 잘못되었다면 ‘프록시’ 페이지에서 모드를 확인한 다음 일치한 규칙과 그룹 내 선택을 살펴보세요. 규칙과 출구가 모두 올바른데도 연결되지 않으면 로그에서 이름 확인 실패, 연결 시간 초과, 대상의 연결 거부 중 어떤 오류인지 확인한 뒤 문제 해결 안내를 따르세요. 이때 네 단계를 모두 처음부터 반복할 필요는 없습니다.

테스트가 끝나면 임시로 바꾼 모드를 평소 사용 설정으로 되돌리세요. 테스트 앱의 프록시만 수동으로 변경했다면 필요에 따라 이 설정도 복구합니다. 클라이언트를 종료하기 전에 클라이언트가 켠 시스템 프록시를 끄거나 VPN 연결을 해제하세요. 실행을 멈춘 로컬 포트로 시스템이 계속 요청을 보내는 일을 방지할 수 있습니다. 다음에 구독을 업데이트한 뒤에는 같은 도메인으로 다시 테스트할 수 있습니다. 도움을 요청할 때는 클라이언트 이름, 현재 모드, 테스트 대상, 민감한 정보가 없는 오류 내용을 전달하세요. 구독 주소나 전체 설정은 첨부하지 마세요.