GUIDE 첫 설정

Clash 사용법

구독을 가져오고 프록시 모드를 설정한 다음 요청에 적용된 규칙을 확인하세요.

약 10분 GUI 클라이언트 첫 연결

구독을 가져와 설정 활성화

먼저 구독 URL을 사용할지 로컬 YAML 파일을 사용할지 확인하세요. 구독 URL은 클라이언트가 직접 읽으며, 보통 나중에 설정 페이지에서 업데이트할 수 있습니다. 로컬 파일은 현재 사본을 가져오므로 원본 파일을 수정해도 자동으로 동기화되지 않을 수 있습니다. 두 방법 중 하나를 선택하면 됩니다. 이미 정상 작동하는 설정이 있다면 새로 가져온 항목에는 다른 이름을 지정하고 기존 항목을 잠시 남겨 두세요. 문제가 생겼을 때 되돌리기 쉽습니다. 구독 URL에 접근 정보가 포함될 수 있으니 공개 로그나 스크린샷, 공유 문서에 올리지 마세요.

설정 페이지에서 소스 추가

클라이언트에서 ‘설정’ 또는 ‘구독’ 페이지를 열고 ‘추가’, ‘가져오기’ 또는 더하기 버튼을 누릅니다. URL을 사용할 경우 ‘URL에서 가져오기’를 선택해 전체 주소를 붙여넣고 확인하세요. 로딩이 끝나면 목록에 새 설정 이름이 표시되는지 확인합니다. 지원하지 않는 형식이라는 메시지가 나오면 해당 클라이언트용 Clash 구독을 받은 것이 맞는지 확인하세요. 계정 관리 웹페이지 주소와 혼동하지 마세요. 가져오기가 시간 초과되면 먼저 기기의 기본 네트워크와 URL의 유효성을 확인하세요. 시스템 프록시를 먼저 켤 필요는 없습니다.

파일을 사용할 경우 ‘파일에서 가져오기’를 선택하고 시스템 파일 선택기에서 실제 YAML 파일을 찾습니다. 파일을 연 뒤 줄 번호가 표시된 파싱 오류가 나오면 오류가 난 줄과 바로 위 줄을 확인하세요. 들여쓰기가 맞지 않거나 앞 항목의 콜론이 빠져 문제가 다음 줄에서 보고될 수 있습니다. 원본 사본을 다시 가져오는 것이 우선입니다. 꼭 수정해야 한다면 백업 파일에서 한 번에 한 곳만 변경하세요. 브라우저에서 받은 로그인 페이지의 확장자를 YAML로 바꿔 다시 가져오지 마세요.

설정이 적용 중인지 확인

가져오기에 성공했다는 것은 설정이 추가되었다는 뜻일 뿐입니다. 목록으로 돌아가 해당 항목을 누르거나 메뉴에서 ‘활성화’ 또는 ‘적용’을 선택하고, 현재 사용 중 표시가 새 항목으로 옮겨졌는지 확인하세요. 설정을 다시 불러오라는 안내가 나오면 완료될 때까지 기다린 뒤 ‘프록시’ 페이지를 여세요. 정책 그룹이 포함된 설정이라면 새 설정에 해당하는 그룹 이름이 보여야 합니다. 기존 그룹 이름만 보인다면 설정 페이지에서 선택 상태와 로딩 안내를 확인한 다음 다시 가져올지 결정하세요.

다음 단계로 넘어가기 전: 설정 이름이 예상한 것과 일치하고 적용 중 파싱 오류가 없었는지 확인하세요. YAML 최상위 구조를 확인하려면 설정 파일 필드 레퍼런스를 참고하세요.

프록시 모드 및 아웃바운드 정책 선택

첫 연결은 설정에 따라 트래픽이 라우팅되는지 확인하기 쉽도록 ‘규칙’ 모드로 진행하세요. ‘프록시’ 페이지나 설정 페이지에서 ‘모드’를 찾아 ‘규칙’ 또는 Rule을 선택하고, 강조 표시된 항목이 바뀌는지 확인합니다. 모드는 트래픽이 코어에 들어온 뒤 경로를 정합니다. 시스템 앱의 요청을 코어로 전달하는 기능은 아닙니다. 이 단계에서 브라우저 동작에 변화가 없는 것은 정상이며, 다음 단계에서 트래픽 진입점을 설정합니다.

mihomo 호환 YAML 파일에서 이 설정을 확인하면 최상위 항목 mode에 해당합니다. 아래 내용은 필드 작성법만 보여 주며 완전한 설정 파일이 아닙니다. 처음에는 인터페이스에서 모드를 변경하세요. 클라이언트의 실행 중 설정이 파일의 값을 덮어쓸 수 있으므로 변경 후에는 화면에 표시된 값을 기준으로 확인합니다.

mode: rule

규칙이 지정한 그룹에서 아웃바운드 선택

먼저 예상 경로를 알고 있는 테스트 대상을 정하고 설정에서 해당 규칙을 확인하세요. 대상 도메인이 수동 정책 그룹과 일치해야 한다면 ‘프록시’ 페이지에서 그룹을 펼쳐 사용 가능한 노드를 선택하고, 선택 표시가 해당 노드에 있는지 확인합니다. 자동 선택이나 장애 조치 그룹이라면 설정된 자동 동작을 그대로 둔 뒤 연결 상세 정보에서 실제 아웃바운드를 확인하세요. 그룹 이름만 보고 트래픽 경로를 판단하지 마세요. ‘수동 선택’ 그룹이 대상 규칙에 연결되어 있지 않다면 그 그룹을 바꿔도 대상의 아웃바운드는 달라지지 않습니다.

‘전역’ 모드는 아웃바운드 연결이 가능한지 임시로 비교할 때 사용할 수 있습니다. 이 모드로 테스트한다면 전역 선택이 무엇을 가리키는지도 확인하세요. 전역 모드에서 테스트에 성공해도 규칙 모드에서 예상한 규칙이 적용됐다는 뜻은 아닙니다. ‘직접 연결’ 모드는 기본 연결 상태를 비교하는 용도이며, 시스템이 요청을 가로채지 않는다는 증거가 되지는 않습니다. 요청이 여전히 코어에 들어온 뒤 코어가 직접 전달할 수 있기 때문입니다. 비교를 마치면 규칙 모드로 되돌려 임시 설정이 이후 확인에 영향을 주지 않도록 하세요.

다음 단계로 넘어가기 전: 현재 모드, 적용될 것으로 예상하는 정책 그룹, 선택한 아웃바운드를 기록하세요. 규칙이 어느 항목부터 매칭되는지 확실하지 않다면 규칙 문법 및 매칭 순서를 확인하세요.

시스템 프록시 또는 모바일 VPN 켜기

첫 테스트에서는 트래픽 진입점을 하나만 켜야 요청이 어디를 통과하는지 파악하기 쉽습니다. 먼저 클라이언트에서 코어가 실행 중인지 확인하세요. 일부 클라이언트는 화면을 열면 코어가 자동으로 시작되지만, 일부는 ‘시작’ 또는 ‘연결’을 눌러야 합니다. 포트 사용 중, 설정 미로드, 코어 시작 실패 등의 안내가 표시되면 먼저 해당 문제를 해결하세요. 시스템 진입점을 켜도 기기에서 요청을 받을 프로세스가 없을 수 있습니다.

데스크톱: 시스템 프록시 켜기

클라이언트의 홈 화면, 설정 페이지 또는 트레이 메뉴에서 ‘시스템 프록시’를 찾아 켠 다음 운영체제의 네트워크 또는 프록시 설정에서 적용 여부를 확인하세요. 로컬 수동 프록시를 사용한다면 루프백 주소와 포트가 클라이언트의 수신 설정과 일치하는지 확인합니다. 예를 들어 설정에 mixed-port: 7890이 있고 클라이언트에서 따로 덮어쓰지 않았다면 로컬 프록시 주소는 127.0.0.1:7890입니다. 노드의 원격 포트를 여기에 입력하지 말고, 예시 포트가 모든 클라이언트의 기본값이라고 가정하지 마세요.

첫 확인에는 시스템 프록시 설정을 사용하는 브라우저를 선택하세요. 브라우저에서 별도의 프록시를 설정했거나 대상 앱이 시스템 프록시를 사용하지 않는다면 시스템 프록시 스위치와 동작이 다를 수 있습니다. 클라이언트에 TUN 스위치도 있다면 시스템 프록시와 함께 켜지 마세요. 대상 앱이 현재 진입점을 사용하지 않는다고 확인된 경우에만 TUN 사용을 별도로 검토하세요. 조직에서 관리하는 기기라면 기존 네트워크 설정을 유지하고 기기 관리 정책에 따라 작업하세요.

모바일: 시스템 VPN 권한 확인

클라이언트 홈 화면에서 ‘시작’ 또는 연결 버튼을 누르고, 처음 사용하는 경우 시스템 안내에 따라 현재 클라이언트의 VPN 연결 요청을 허용하세요. 그런 다음 앱으로 돌아와 연결됨으로 표시되는지 확인합니다. 권한 팝업을 취소했다면 연결 버튼을 다시 눌러 권한 요청을 확인하세요. 기기에서 다른 VPN이 이미 실행 중이라면 현재 활성화된 연결을 먼저 확인하세요. 전환하면 기존 연결이 끊길 수 있습니다. 기기 관리 대상 연결은 임의로 제거하지 마세요.

다음 단계로 넘어가기 전: 선택한 진입점을 켜 둡니다. 테스트를 잠시 중단하려면 데스크톱에서는 클라이언트가 켠 시스템 프록시를 먼저 끈 다음 코어를 종료하세요. 모바일에서는 클라이언트 연결을 끊고 시스템 VPN 상태를 확인합니다.

연결 기록으로 프록시 작동 확인

새 요청을 보내 세 가지를 확인하세요. 요청이 코어에 들어왔는지, 예상한 규칙과 일치했는지, 선택한 아웃바운드로 실제 접속했는지입니다. 먼저 클라이언트의 ‘연결’ 페이지를 여세요. 연결 페이지가 없다면 라우팅 정보를 표시할 수 있는 ‘로그’ 페이지를 엽니다. 현재 시간을 기록한 뒤 예상 규칙을 알고 있고 정상 접속 가능한 테스트 대상을 브라우저에서 여세요. 페이지가 열린 것은 첫 번째 확인 결과일 뿐입니다. 직접 연결 요청으로도 페이지가 열릴 수 있습니다.

대상, 규칙 및 아웃바운드 대조

연결 기록에서 대상 도메인과 요청 시간으로 항목을 찾으세요. 같은 웹페이지의 이미지나 기타 리소스 요청을 메인 페이지 요청으로 착각하지 않도록 주의합니다. 상세 정보를 열어 적용된 규칙, 정책 그룹, 실제 아웃바운드를 비교하세요. 설정상 직접 연결되어야 하는 대상에서 DIRECT가 표시되면 예상된 결과입니다. 프록시 그룹을 거쳐야 하는 대상이라면 실제 아웃바운드가 그룹에서 현재 선택된 노드인지 확인하세요. 자동 그룹에서는 그룹 이름이 아니라 해당 연결 기록에 표시된 노드를 기준으로 판단합니다.

설정에 명확한 직접 연결 규칙과 프록시 규칙이 모두 있다면 첫 대상과 예상 경로가 다른 대상을 골라 다시 테스트할 수 있습니다. 모드나 정책 그룹을 변경할 때마다 새 연결을 만든 뒤 결과를 확인하세요. 브라우저가 캐시에서 페이지를 불러오거나 기존 연결을 재사용할 수 있습니다. 필요하면 아직 방문하지 않은 테스트 대상을 사용하거나 브라우저를 완전히 종료했다가 다시 열어 테스트하세요. 변경 전의 오래된 기록으로 새 설정을 판단하지 마세요.

실패한 지점을 찾아 한 번에 한 곳씩 점검

요청 기록을 찾을 수 없다면 먼저 시간과 도메인을 확인하세요. 요청이 너무 빨리 끝나 목록에 남지 않는 경우도 있으니 접속 중 연결 목록을 살펴볼 수 있습니다. 그래도 기록이 없다면 시스템 프록시나 VPN이 적용됐는지, 브라우저에서 별도의 프록시를 설정했는지 확인하세요. 기록은 있지만 규칙이 예상과 다르면 현재 모드, 규칙 순서, 기본 규칙을 확인합니다. 먼저 노드를 바꾸지 마세요. 규칙은 맞지만 접속 시간이 초과된다면 로그에서 가장 먼저 나타난 것이 DNS 오류인지 연결 시간 초과인지, 아니면 다른 오류인지 확인하세요. 오류와 관련된 부분만 한 번에 하나씩 조정하고 새 요청으로 다시 테스트합니다.

첫 설정 완료: 테스트 대상에 정상적으로 접속되고 연결 기록에 예상 경로가 표시되는지 확인하세요. 문제가 계속된다면 문제 해결 FAQ를 참고하세요. 로그에 도메인 이름 해석 실패가 명확히 표시되면 DNS 설정 필드를 확인하세요.

Clash 다운로드