QUICK START / YAML → RULE → CONNECT
Clash 초보자 설정
구독 가져오기 → 프록시 모드 선택 → 연결 켜기 → 작동 확인. 데스크톱 GUI 클라이언트를 기준으로 첫 설정을 순서대로 진행합니다.
플랫폼별 안내: Ubuntu, Windows, macOS 클라이언트에서는 보통 ‘설정’, ‘구독’, ‘프록시’ 또는 Profiles, Proxies라는 메뉴를 사용합니다. Android와 iOS에서는 시스템 VPN 연결을 허용해 트래픽을 전달하는 경우가 많습니다. 아래 버튼 이름은 메뉴 위치를 찾기 위한 참고이며, 실제 명칭은 사용하는 클라이언트에 따라 다를 수 있습니다. 플랫폼이 달라도 작업 순서를 따르면 되며 화면 구성이 완전히 같을 필요는 없습니다.
시작하기 전에 호환 클라이언트와 신뢰할 수 있는 출처에서 받은 구독 URL 또는 로컬 YAML 설정 파일을 준비하세요. 클라이언트는 화면과 시스템 연동을 담당하고, mihomo 같은 코어는 설정을 읽고 연결을 처리합니다. 클라이언트만 설치하면 프록시를 사용할 수 있는 상태가 아닐 수 있습니다. 이 가이드에서는 구독을 제공하지 않으며 복잡한 설정 항목을 미리 수정할 필요도 없습니다. 설정 파일이 있고 네트워크가 정상이라면 기본 절차는 약 10분이면 완료할 수 있습니다. 이후 실제 문제에 따라 필요한 설정을 추가하세요.
이 가이드에서는 확인과 원상 복구가 쉬운 ‘규칙 모드 + 데스크톱 시스템 프록시’ 경로를 사용합니다. 서버 배포, 프로토콜 차이, 코어 호환성은 첫 연결에 필수적인 단계가 아니므로 필요할 때 프로토콜 및 코어 참고 가이드를 확인하세요. 클라이언트를 아직 설치하지 않았다면 Linux 다운로드 페이지 또는 해당 플랫폼 페이지에서 설치 방법을 확인한 뒤 이 페이지로 돌아오세요.
01 구독 설정 가져오기
클라이언트를 실행한 뒤 시스템 프록시가 아니라 ‘설정’ 또는 ‘구독’ 페이지를 먼저 여세요. ‘새로 만들기’, ‘추가’ 또는 ‘URL에서 가져오기’ 메뉴를 찾아 구독 URL을 주소 입력란에 그대로 붙여 넣습니다. 이름에는 알아보기 쉬운 용도를 입력할 수 있습니다. 주소 앞뒤에 공백이나 줄바꿈이 없는지 확인한 다음 다운로드 또는 가져오기를 누르세요. 구독 URL에는 로그인 정보가 포함될 수 있으니 전체 주소를 공개 스크린샷이나 게시물, 온라인 변환 사이트에 올리지 마세요.
다운로드가 끝나면 설정 목록에 이름, 업데이트 시간 또는 활성화 상태가 표시된 설정 카드가 추가됩니다. 목록에 표시되는 것만으로 코어가 설정을 읽은 것은 아닙니다. ‘사용’, ‘활성화’ 또는 카드의 선택 버튼을 눌러 현재 설정으로 지정하세요. 정상적으로 로드되면 설정 파싱 오류가 사라지고, ‘프록시’ 페이지에서 설정에 정의된 정책 그룹과 선택 가능한 프록시를 볼 수 있습니다.
로컬 파일을 받은 경우 ‘파일에서 가져오기’를 선택하고 config.yaml 또는 다른 YAML 파일을 찾아 여세요. 확장자는 파일 형식을 알아보는 단서일 뿐이며, 파일 내용은 사용하는 클라이언트 코어의 설정 형식에 맞아야 합니다. 웹페이지를 YAML 파일로 저장하거나 노드 링크만 들어 있는 텍스트를 완전한 Clash 설정으로 사용하지 마세요. 가져온 뒤 설정을 활성화하고 정책 그룹이 표시되는지 확인하세요.
일부 서비스는 여러 구독 형식을 제공합니다. Clash, Clash Meta 또는 mihomo 호환으로 표시된 항목을 선택하세요. 브라우저에서 링크가 열린다는 것은 서버가 콘텐츠를 반환했다는 뜻일 뿐, 클라이언트가 읽을 수 있는 설정이라는 의미는 아닙니다. 클라이언트에서 구문 또는 유형 오류가 표시되면 먼저 형식 선택을 확인하고 로그인 페이지 주소를 복사하지 않았는지 점검하세요. 오류를 없애려고 모르는 프로토콜 항목을 임의로 삭제하지 마세요.
‘다운로드 실패’가 발생하면 파일을 가져오지 못한 경우와 가져온 파일을 불러오지 못한 경우를 구분하세요. 전자는 주소가 완전한지, 구독 권한이 유효한지, 현재 네트워크에서 해당 주소에 접속할 수 있는지 확인합니다. 후자는 클라이언트 로그에서 구체적인 필드 오류를 살펴보세요. 일부 클라이언트는 구독 업데이트에 직접 연결과 프록시 연결 중 하나를 지정할 수 있습니다. 프록시를 아직 연결하지 않았다면 현재 사용할 수 없는 프록시에 업데이트를 의존하지 않도록 하세요.
구독을 정상적으로 가져온 뒤에는 전체 내용을 수동 편집기에 복사해 반복해서 수정하지 마세요. 원격 업데이트가 직접 수정한 내용을 덮어쓸 수 있고, 클라이언트의 덮어쓰기, 병합 또는 스크립트 기능도 서로 다릅니다. 처음에는 원래 설정을 그대로 사용하고, 사용자 지정 규칙이 꼭 필요해진 뒤 변경 사항을 유지하는 방법을 알아보세요. 현재 설정이 활성화되어 있고 정책 그룹이 표시되는 것을 확인했다면 다음 단계에서 모드를 선택하면 됩니다.
02 규칙 모드 선택
홈 화면이나 설정 페이지로 돌아가 ‘모드’, ‘실행 모드’ 또는 Mode 메뉴를 찾아 Rule, 즉 규칙 모드를 선택하세요. 이 모드에서는 코어에 들어온 요청을 rules 목록의 위에서부터 검사하고, 처음 일치한 규칙이 프록시를 결정합니다. 모든 앱의 트래픽이 자동으로 코어에 전달되는 것은 아닙니다. 시스템 프록시나 TUN 연결은 다음 단계에서 설정합니다. 먼저 트래픽 분기 방식을 정하면 이후 문제를 더 쉽게 찾을 수 있습니다.
나머지 대표 모드는 Global과 Direct입니다. 전역 모드는 코어에 들어온 요청을 전역 정책으로 처리하고, 직접 연결 모드는 프록시를 거치지 않고 연결합니다. 전역 모드라고 해서 컴퓨터의 모든 프로그램이 자동으로 프록시를 사용하는 것은 아니며, 직접 연결 모드도 클라이언트가 종료된다는 뜻은 아닙니다. 특별한 테스트 목적이 없다면 처음에는 규칙 모드를 유지하세요. 모드와 네트워크 연결 방식을 동시에 바꾸면 결과에 영향을 준 설정을 찾기 어려워집니다.
이어서 ‘프록시’ 또는 ‘정책 그룹’ 페이지를 여세요. 설정에 따라 여러 그룹이 표시되며, 이름은 설정 작성자가 정합니다. 예를 들어 직접 선택하는 기본 그룹과 용도별 그룹이 있을 수 있습니다. 규칙에서 실제로 참조하는 기본 선택 그룹을 펼친 다음, 사용할 권한이 있고 현재 연결 가능한 프록시를 선택하세요. 선택하면 보통 체크 표시나 테두리가 나타나거나 현재 선택 항목이 바뀝니다. 그룹이 다른 그룹을 가리키는 경우 최종 프록시가 보일 때까지 계속 펼쳐 확인하세요.
이름만 보고 정책의 의미를 판단하지 마세요. DIRECT는 직접 연결, REJECT는 연결 거부를 뜻하며 일반적인 원격 프록시가 아닙니다. 기본 정책 그룹에서 DIRECT를 선택한 상태라면 시스템 프록시가 켜져 있어도 해당 요청은 로컬 네트워크를 통해 직접 나갈 수 있습니다. 자동 선택 그룹은 설정에 지정된 검사 주소와 정책에 따라 항목을 선택하므로 특정 프록시 하나를 고정할 수 없을 수 있습니다. 직접 선택하려면 설정에 포함된 선택 그룹을 사용하세요.
클라이언트의 ‘연결 테스트’나 ‘사용 가능 여부 테스트’는 참고 자료로 활용할 수 있습니다. 테스트에 성공해도 지정된 테스트 요청에 응답이 왔다는 뜻일 뿐, 특정 웹사이트나 계정 로그인, 모든 앱이 정상 작동한다는 보장은 아닙니다. 테스트 주소 자체의 문제로 실패할 수도 있습니다. 응답이 있는 프록시를 먼저 선택한 뒤 실제 접속과 연결 기록을 함께 확인하세요. 테스트 수치만으로 판단하지 마세요.
예상한 그룹이 보이지 않는다면 빈 그룹을 바로 추가하지 말고 이전 단계로 돌아가 현재 활성화된 설정을 확인하세요. 그룹 이름이 서로 다른 것은 정상입니다. 중요한 것은 규칙에서 참조하는 이름이 실제 정책과 일치하는지입니다. 사용자 지정 규칙, 자동 선택, 프로토콜 유형에 대한 자세한 설명은 프로토콜 참고 가이드를 확인하세요. 일반적인 화면 및 선택 문제는 자주 묻는 질문에서 확인할 수 있습니다. 모드와 프록시를 확인한 다음 앱 트래픽 연결을 시작하세요.
03 코어 실행 및 시스템 프록시 설정
먼저 홈 화면에서 코어가 실행 중인지 확인하세요. 클라이언트에 따라 실행 후 코어가 자동으로 시작되기도 하고, 시작 또는 연결 버튼을 눌러야 하기도 합니다. 설정 오류, 서비스 중지 또는 포트 사용 중 메시지가 표시되면 시스템 프록시를 켜기 전에 오류를 해결하세요. 시스템 프록시는 앱 요청을 로컬 수신 주소로 전달합니다. 코어가 해당 포트에서 수신하지 않는 상태로 먼저 켜면 브라우저 등의 앱이 서비스가 없는 포트에 연결하게 됩니다.
Windows와 macOS 데스크톱 클라이언트에는 보통 ‘시스템 프록시’ 스위치가 있으며, 켜면 해당 시스템 설정이 변경됩니다. Ubuntu GUI 클라이언트에도 같은 스위치가 있을 수 있지만, 데스크톱 환경과 설치 방법에 따라 적용 결과가 다를 수 있습니다. 설정 후 클라이언트를 계속 실행한 상태에서 스위치가 켜진 채로 유지되는지 확인하세요. 다른 프록시 클라이언트나 VPN을 사용 중이라면 시스템 설정이 서로 덮어써지지 않도록 한쪽 연결을 먼저 일시 중지하는 것이 좋습니다.
Ubuntu GNOME에서는 시스템 ‘설정’의 ‘네트워크’에서 ‘네트워크 프록시’를 열어 현재 값을 확인할 수 있습니다. 메뉴 위치는 버전에 따라 조금 다를 수 있습니다. 클라이언트가 자동으로 설정하지 않는다면 수동으로 전환해 로컬 주소 127.0.0.1를 입력하고, 클라이언트에 표시된 실제 HTTP 또는 혼합 포트를 사용하세요. 설정에 mixed-port: 7890이 있다면 HTTP와 HTTPS 프록시 입력란에 보통 같은 주소와 포트를 입력합니다.
HTTPS 프록시 입력란은 브라우저가 HTTPS 웹사이트에 접속할 때 사용할 프록시를 지정하는 곳입니다. 로컬 프록시 연결 자체가 HTTPS여야 한다는 뜻은 아닙니다. 입력란 이름이 다르다고 포트를 임의로 바꾸지 마세요. 혼합 포트는 HTTP와 SOCKS5 요청을 모두 받을 수 있습니다. 클라이언트에서 포트를 따로 지정한다면 화면의 안내에 따라 각각 입력하세요. 7890은 흔히 사용하는 예시일 뿐입니다. 실제 설정에서 포트를 변경했다면 시스템이나 앱의 값도 맞춰야 합니다.
데스크톱의 시스템 프록시 설정이 모든 프로그램에 강제로 적용되는 것은 아닙니다. 브라우저는 보통 시스템 설정을 읽지만, 일부 터미널 도구와 게임, 개별 앱은 자체 네트워크 설정을 사용할 수 있습니다. 먼저 브라우저 하나가 정상 작동하는지 확인한 다음 다른 앱을 설정하세요. 특정 앱에만 프록시가 필요하면 해당 앱에서 로컬 주소와 포트를 직접 입력할 수 있습니다. 같은 컴퓨터에서 연결할 때는 allow-lan을 켤 필요가 없으며, 제어 인터페이스도 용도를 모른 채 외부에 노출하지 마세요.
Android와 iOS에서는 보통 클라이언트의 연결 버튼을 누른 뒤 시스템 안내에 따라 VPN 연결 생성을 허용해야 합니다. 이는 클라이언트가 트래픽을 전달하기 위해 사용하는 시스템 기능이며, 다른 VPN 앱을 추가로 설치해야 한다는 뜻은 아닙니다. 다른 앱이 이미 해당 기능을 사용 중이라면 어떤 연결을 유지할지 먼저 정하세요. 앱별 분할 연결 지원 여부와 설정 위치는 클라이언트 및 시스템 버전에 따라 다르므로 데스크톱 시스템 프록시 절차를 그대로 적용하지 마세요.
대상 앱이 시스템 프록시를 따르지 않거나 더 넓은 범위의 트래픽을 연결해야 할 때만 TUN을 고려하세요. 데스크톱에서는 서비스 설치, 관리자 권한 허용 또는 가상 네트워크 어댑터 생성이 필요할 수 있습니다. 용도를 모르는 스위치를 한꺼번에 여러 개 켜지 마세요. 현재 정상 작동하는 설정을 기록한 뒤 TUN만 따로 테스트하세요. 켠 뒤 네트워크 문제가 발생하면 TUN을 끄고 확인된 연결 방식으로 돌아오세요. DNS 및 권한 문제는 문제 해결에서 계속 확인할 수 있습니다.
04 요청과 프록시 확인
연결 버튼이 켜져 있어도 대상 앱이 예상한 프록시를 사용하는지는 따로 확인해야 합니다. 클라이언트를 실행한 상태에서 ‘연결’ 또는 Connections 페이지를 열고 브라우저에서 새 탭을 만들어 정상적으로 접속할 수 있는 웹사이트를 방문하세요. 해당 도메인의 새 연결이 나타나는지, 브라우저가 정상 응답을 받는지 확인합니다. 새 요청을 사용하는 것이 좋습니다. 기존 연결에는 이전 연결 경로가 유지될 수 있습니다.
해당 연결의 세부 정보를 열어 대상 도메인, 적용된 규칙, 정책 그룹 또는 프록시 체인을 확인하세요. 표시 항목은 클라이언트마다 조금씩 다르지만 직접 연결인지, 특정 그룹을 거치는지, 규칙에서 거부했는지 판단할 수 있어야 합니다. 규칙 모드에서는 일부 웹사이트가 직접 연결되는 것이 정상입니다. 원격 프록시를 확인하려면 현재 규칙에 따라 실제로 프록시 그룹을 사용하는 요청을 확인하세요. 모든 연결이 같은 노드로 표시되어야 하는 것은 아닙니다.
필요하다면 신뢰할 수 있는 프록시 출구 IP 조회 서비스를 참고하되 연결 기록도 함께 확인하세요. 조회 사이트 자체에도 분기 규칙이 적용될 수 있으므로 로컬 출구가 표시된다고 해서 프록시가 작동하지 않는 것은 아닙니다. 브라우저 캐시, 기존 연결, 계정이나 위치 권한에 따라 사이트가 표시하는 지역 정보도 네트워크 경로를 판단하는 기준이 될 수 없습니다. 확인할 핵심은 ‘이 앱의 이 요청이 예상대로 코어에 전달되고 프록시를 선택했는가’입니다.
터미널 사용에 익숙한 데스크톱 사용자는 아래 명령으로 HTTP 프록시를 명시해 표준 테스트 사이트에 접속할 수 있습니다. 포트는 클라이언트가 실제로 수신 중인 혼합 포트 또는 HTTP 포트로 바꾸세요. 이 테스트는 ‘코어의 프록시 포트에 연결할 수 있는지’와 ‘앱이 시스템 설정을 읽는지’를 구분하는 데 도움이 됩니다. 모든 터미널 도구가 프록시를 자동으로 사용한다는 뜻은 아닙니다.
curl --proxy http://127.0.0.1:7890 --head https://example.com
프록시를 명시한 명령은 성공했지만 일반 브라우저의 연결 기록이 없다면 브라우저가 시스템 프록시를 사용하는지, 확장 프로그램이 설정을 덮어쓰는지, 시스템 설정의 포트가 맞는지 먼저 확인하세요. 연결 기록은 있지만 요청이 실패하면 적용된 정책과 관련 로그를 살펴보세요. 이 경우 시스템 프록시 스위치를 반복해서 켜고 끄는 것은 대개 도움이 되지 않습니다. HTTPS 경고를 피하려고 인증서 검증을 끄지 말고 시스템 시간, 대상 사이트와 프록시 상태를 확인하세요.
모든 요청이 실패하면 다음 순서로 점검하세요. 현재 설정이 활성화되어 있는지, 코어가 실행 중인지, 로컬 포트가 수신 중인지, 앱 요청이 코어로 전달되는지, 마지막으로 선택한 프록시를 사용할 수 있는지 확인합니다. 한 번에 하나만 변경하고 요청을 다시 보내세요. 설정, DNS, TUN, 모드를 한꺼번에 바꾸지 마세요. 포트 충돌은 포트 사용 중 오류와 mixed-port 변경 방법을 참고하세요. 용도를 모르는 시스템 프로세스를 종료하지 마세요.
연결이 확인되면 정상 작동을 확인한 모드와 정책 그룹을 유지하고 필요에 따라 구독 업데이트와 시작 시 실행을 설정하세요. 다음 구독 업데이트 뒤에는 그룹 항목이 달라질 수 있으므로 문제가 생기면 현재 선택이 여전히 유효한지 먼저 확인하세요. Ubuntu 서비스 실행과 프로토콜 선택은 이후에 다룰 고급 설정입니다. 프로토콜 및 코어 참고 가이드를 확인하면 되며, 첫 연결을 위해 전체 서비스를 미리 설정할 필요는 없습니다.
완료 기준: 설정이 정상적으로 로드되고 코어가 실행 중이며, 앱에서 보낸 새 요청이 연결 기록에 나타나고 적용된 규칙과 프록시가 예상과 일치해야 합니다. 클라이언트를 종료하기 전에 시스템 프록시를 끄거나 기존 프록시 설정을 복원하세요. TUN을 사용했다면 클라이언트가 관련 네트워크 연결을 정상적으로 해제했는지도 확인합니다.