설정 가이드 · 초보자부터 전문가까지

Clash 완전 설정 튜토리얼

구독 가져오기, TUN 가상 NIC, GeoIP 라우팅, 다중 설정 병합 및 오버라이드, JavaScript 스크립팅, 로그 디버깅 6개 핵심 챕터 – 다음에 호환: Clash Verge Rev, FlClash, Nyanpasu 등 모든 주요 클라이언트.

구독 설정 가져오기

Clash 클라이언트는 구독 URL을 통해 서비스 제공자로부터 YAML 형식의 설정 파일을 원격으로 가져옵니다. 설정 파일에는 프록시 서버 목록, 정책 그룹, 라우팅 규칙이 포함되어 있으며 모든 기능의 기반입니다.

1

구독 URL 받기

서비스 제공자의 대시보드에 로그인하여 Clash 형식의 구독 URL을 복사하세요(일반적으로 ?token= 매개변수 포함). 이 URL은 민감한 정보이므로 다른 사람과 공유하지 마세요.

2

클라이언트에서 가져오기

Clash Verge Rev를 열고 왼쪽의 " 프로필 " 탭을 클릭한 후 오른쪽 상단의 " 새로 만들기 " 버튼을 클릭하고 URL 입력란에 링크를 붙여넣은 후 가져오기를 클릭하세요.

3

설정 파일 활성화

가져온 후 설정 카드를 클릭하여 "현재 사용"으로 설정하면 클라이언트 아이콘이 활성화됩니다. 설정에서 " 자동 업데이트 "(24시간마다)를 활성화하여 노드 목록을 최신 상태로 유지하는 것을 권장합니다.

4

속도 테스트 및 노드 선택

프록시 페이지로 이동하여 정책 그룹에서 " 속도 테스트 ⚡ "를 클릭하세요. 100ms 미만의 지연이 고품질 노드입니다. DIRECT 외에 🔁 표시가 있는 자동 선택 그룹을 우선 선택하여 자동 장애 조치가 가능하도록 하는 것을 권장합니다.

일반적인 YAML 설정 구조 (참고용)

# Clash Meta (Mihomo) 설정 파일 구조 개요
mixed-port: 7890         # HTTP + SOCKS5 혼합 프록시 포트
allow-lan:  false        # LAN 장치에서 접근 불가
mode:       rule         # 규칙 모드 (권장)
log-level:  info

proxies:                   # 노드 목록 (구독으로 자동 채워짐)
  - name: "홍콩 01"
    type: vmess
    server: hk1.clashhelp.com
    port:   443
        # ... (기타 필드 생략)

proxy-groups:              # 정책 그룹
  - name: "🚀 노드 선택"
    type: select
    proxies: ["자동 선택", "홍콩 01"]

rules:                     # 라우팅 규칙
  - GEOIP,CN,DIRECT
  - MATCH,🚀 노드 선택
FlClash 사용자:메인 화면 오른쪽 상단 → 설정 → 설정 추가 → URL 입력으로 가져오세요. 설정 카드를 길게 눌러 예약 자동 업데이트를 설정할 수 있습니다.

TUN 가상 NIC 모드

TUN(터널) 모드는 OS에 가상 NIC를 생성하여 네트워크 계층(L3)에서 모든 아웃바운드 트래픽을 제어하여 터미널 도구(git, npm, curl), 게임 클라이언트 등을 시스템 프록시가 커버하지 못하는 문제를 영구 해결합니다.

시스템 프록시 (구방식)

  • ✗ 프록시 프로토콜을 지원하는 앱만 커버
  • ✗ 터미널 도구는 수동으로 HTTP_PROXY 설정 필요
  • Clash Meta (Mihomo) 설정 파일 구조 개요
  • HTTP + SOCKS5 혼합 프록시 포트

TUN 모드 (권장)

  • 홍콩 01
  • ✓ 터미널 / IDE / 게임 모두 자동으로 프록시 사용
  • ✓ DNS 유출 방지 지원
  • △ 최초 설정 시 서비스 모드 드라이버 설치 필요

Clash Verge Rev에서 TUN 모드 활성화

1

서비스 모드 설치

설정 → 시스템 설정 → 서비스 모드로 이동하여 설치를 클릭하세요. Windows는 UAC 관리자 승인이 필요하고, macOS는 시스템 비밀번호가 필요합니다. 설치 완료 후 상태 아이콘이 녹색으로 바뀝니다.

2

TUN 토글 활성화

설정 페이지에서 TUN 모드 토글을 찾아 켜세요. 처음 활성화 후 설정이 완전히 적용되도록 클라이언트를 재시작하는 것을 권장합니다.

3

TUN 작동 확인

터미널에서 curl -I https://www.google.com을 실행하세요 – HTTP 200이 반환되면 TUN 프록시가 성공적으로 활성화된 것입니다. 클라이언트의 연결 페이지에서도 터미널 도구의 연결 기록을 확인할 수 있습니다.

YAML에서 수동으로 TUN 활성화 (Meta 코어 설정)

tun:
  enable:              true
  stack:               mixed    # mixed / gvisor / system (mixed 권장)
  auto-route:          true     # 라우팅 테이블 자동 설정
  auto-detect-interface: true   # 아웃바운드 NIC 자동 감지
  dns-hijack:
    - any:53                   # 모든 DNS 쿼리 가로채기, 유출 방지

dns:
  enable:    true
  enhanced-mode: fake-ip    # TUN 모드에서는 fake-ip 권장
  nameserver:
    - https://doh.pub/dns-query
    - https://dns.alidns.com/dns-query
참고:macOS에서 서비스 모드를 처음 설치하면 시스템이 드라이버 로딩을 차단할 수 있습니다. 시스템 설정 → 개인 정보 보호 및 보안으로 이동하여 그래도 허용을 클릭한 후 클라이언트를 재시작하세요.

GeoIP 트래픽 라우팅 규칙

트래픽 라우팅으로 어떤 트래픽을 프록시로, 어떤 것을 직접 연결로 사용할지 정밀하게 제어할 수 있습니다. 올바른 설정은 지연을 줄이고, 대역폭 사용을 낮추며, 국내 서비스가 프록시 우회로 인해 느려지는 것을 방지합니다.

일반적인 규칙 유형 빠른 참조

규칙 유형 매칭 로직 예시
DOMAIN정확한 도메인 매칭DOMAIN,google.com,PROXY
DOMAIN-SUFFIX도메인 접미사 (서브도메인 포함)DOMAIN-SUFFIX,github.com,PROXY
DOMAIN-KEYWORD도메인에 키워드 포함DOMAIN-KEYWORD,google,PROXY
IP-CIDRIP 범위 매칭IP-CIDR,192.168.0.0/16,DIRECT
GEOIPIP 지리적 위치 (GeoIP 데이터베이스)GEOIP,CN,DIRECT
GEOSITE도메인 카테고리 세트 (Meta 전용)GEOSITE,cn,DIRECT
RULE-SET원격 규칙 세트 (권장)RULE-SET,proxy,PROXY
MATCH폴백 규칙 (반드시 마지막에 배치)MATCH,PROXY

권장 라우팅 규칙 예시

다음 설정은 "국내 직접 연결 + 해외 프록시" 표준 라우팅 전략을 구현합니다:

rule-providers:          # 원격 규칙 세트 (권장, 매일 자동 업데이트)
  reject:
    type:     http
    behavior: domain
    url:      "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/reject.txt"
    interval: 86400
  proxy:
    type:     http
    behavior: domain
    url:      "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/proxy.txt"
    interval: 86400
  direct:
    type:     http
    behavior: domain
    url:      "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/direct.txt"
    interval: 86400

rules:
  - RULE-SET,reject,REJECT       # 광고/추적 차단
  - RULE-SET,proxy,🚀 노드 선택   # 일반적인 해외 서비스
  - RULE-SET,direct,DIRECT       # 일반적인 국내 도메인
  - GEOSITE,cn,DIRECT            # 중국 본토 도메인 컬렉션
  - GEOIP,CN,DIRECT              # 중국 본토 IP
  - MATCH,🚀 노드 선택            # 폴백: 나머지 트래픽은 프록시 사용
권장 규칙 세트:Loyalsoldier/clash-rules 는 광고 필터링, 해외 프록시, 국내 직접 연결의 세 가지 카테고리를 커버하는 가장 포괄적인 커뮤니티 유지 Clash 규칙 세트로 매일 자동으로 업데이트됩니다.

다중 구독 병합 & 설정 오버라이드

여러 구독이 있거나 구독 위에 커스텀 규칙을 추가해야 할 때, Clash Verge Rev의 오버라이드(Override) 또는 병합(Merge) 기능을 사용하면 원본 구독 파일을 수정하지 않아도 됩니다.

Merge(병합 모드)

추천

커스텀 설정 스니펫을 구독 설정과 심층 병합합니다. 개인 규칙 추가, DNS 설정 교체, 자체 노드 추가 등에 적합합니다.

Script Override(스크립트 오버라이드)

JavaScript 함수로 설정 객체를 임의로 수정합니다. 조건부 노드 필터링, 동적 정책 그룹 생성 등 복잡한 시나리오에 적합합니다.

Merge로 커스텀 규칙 추가

Verge Rev에서 프로필 → 오버라이드로 이동하여 새 Merge 유형 설정 파일을 만드세요:

# merge-overwrite.yaml — 오버라이드/추가할 필드만 작성
dns:
  nameserver:
    - https://doh.pub/dns-query       # DNS 서버 오버라이드

rules:                                # 추가할 규칙 (기존 규칙 앞에 삽입)
  - DOMAIN-SUFFIX,internal.corp,DIRECT   # 회사 내부망 직접 연결
  - IP-CIDR,10.0.0.0/8,DIRECT            # 사설 IP 범위 직접 연결

proxies:                               # 자체 노드 추가
  - name: "자체 VPS"
    type: trojan
    server: vps.mydomain.com
    port:   443
    password: "your-password"
다중 구독 병합:Verge Rev의 프로필 페이지에서 여러 설정 파일을 동시에 가져온 후 오버라이드에서 스크립트를 작성하여 config.proxies 다른 설정의 노드 목록을 병합하고 통합된 정책 그룹을 만들 수 있습니다.

고급 JavaScript 스크립팅

Clash Verge Rev에는 JavaScript 엔진(V8)이 내장되어 있어 스크립트로 설정 객체를 프로그래밍 방식으로 처리할 수 있습니다 – 구독 변환, 노드 필터링, 동적 정책 그룹 등 정적 YAML 설정으로는 처리할 수 없는 고급 요구 사항을 위해.

설정 스크립트

구독 로드 후 실행, 전체 설정 객체 수정

오버라이드 스크립트

오버라이드 레이어로 적용, Merge 모드와 보완적으로 사용

예약 스크립트

merge-overwrite.yaml — 오버라이드/추가할 필드만 작성

유용한 스크립트 예시: 지역별 노드 필터링

// 오버라이드 스크립트 진입 함수, config 매개변수는 완전한 설정 객체
function main(config) {

    // 이름에 "홍콩" 또는 "일본"이 포함된 노드만 유지
  const allowedRegions = ['홍콩', 'HK', '일본', 'JP'];

  config.proxies = config.proxies.filter(proxy =>
    allowedRegions.some(r => proxy.name.includes(r))
  );

  // 필터링된 노드 이름 목록 가져오기
  const proxyNames = config.proxies.map(p => p.name);

  // 필터링된 노드를 사용하도록 노드 선택 정책 그룹 업데이트
  config['proxy-groups'].forEach(group => {
    if (group.name === '🚀 노드 선택') {
      group.proxies = ['DIRECT', ...proxyNames];
    }
  });

  return config;
}

유용한 스크립트 예시: 속도 테스트 그룹 자동 추가

function main(config) {
  const allProxies = config.proxies.map(p => p.name);

  // url-test 자동 속도 선택 정책 그룹 삽입
  config['proxy-groups'].unshift({
    name:     '⚡ 자동 속도 선택',
    type:     'url-test',
    proxies:  allProxies,
    url:      'https://www.gstatic.com/generate_204',
    interval: 300,
    tolerance:50
  });

  return config;
}
참고:스크립트 구문 오류는 설정 로딩 실패를 야기합니다. 저장하고 활성화하기 전에 클라이언트의 설정 편집기에서 내장 구문 검사 기능을 사용하여 확인하는 것을 권장합니다.

로그 디버깅 & 일반적인 오류

연결 문제가 발생하면 로그가 가장 직접적인 진단 도구입니다. 이 챕터에서는 가장 일반적인 오류 메시지와 해결책을 다룹니다.

로그 레벨 참조

debug 가장 상세함, 심층 문제 디버깅 시 사용 – 많은 양의 로그 생성
info 일상적인 사용에 권장, 연결 및 규칙 매칭 정보 기록
warning / error 오류 메시지만 출력, 프로덕션 환경에 적합

자주 발생하는 오류 해결 가이드

dial tcp: i/o timeout — 노드 연결 타임아웃
노드 주소에 도달할 수 없습니다. 가능한 원인: ① ISP가 노드 IP를 차단함; ② 포트가 방화벽에 의해 차단됨; ③ 노드가 오프라인 상태. 해결책:다른 노드로 전환하거나, 설정에서 TCP 동시 연결을 활성화하여 클라이언트가 자동으로 가용 노드를 선택하도록 하세요.
proxyconnect tcp: EOF — 프록시 핸드셰이크 중단
프록시 서버가 핸드셰이크 중에 연결을 끊었습니다. 프로토콜 매개변수 오류(UUID, 비밀번호 또는 암호화 불일치) 또는 서버 버전 호환성 문제가 일반적인 원인입니다. 해결책:구독 파일을 다시 가져오거나, 서비스 제공자에게 서버 설정이 업데이트되었는지 확인하세요.
no such rule provider — 규칙 세트 다운로드 실패
원격 규칙 세트 URL에 접근할 수 없습니다(클라이언트가 프록시 채널을 구축하기 전에는 규칙을 다운로드할 수 없습니다). 해결책: proxy: 🚀 노드 선택 필드를 사용하여 규칙 세트를 프록시를 통해 다운로드하거나, 규칙 세트 URL을 프록시 없이 접근 가능한 미러 주소로 교체하세요.
DNS resolution failed — DNS 확인 실패
TUN 모드에서 DNS 설정이 부적절하면 모든 도메인 확인이 실패할 수 있습니다. 해결책:설정에서 dns.enable: true가 활성화되어 있는지 확인하고, dns-hijackany:53으로 설정하세요. 여러 신뢰할 수 있는 DoH 업스트림 서버(예: doh.pub + dns.alidns.com)를 설정하는 것도 권장합니다.
TUN device not found — TUN NIC 생성 실패
서비스 모드가 올바르게 설치되지 않았거나 시스템 보안 정책이 드라이버 로딩을 차단하고 있습니다. 해결책 (Windows):관리자 권한으로 Clash Verge Rev를 재시작하고 서비스 모드를 다시 설치하세요. 해결책 (macOS):시스템 설정 → 개인 정보 보호 및 보안으로 이동하여 시스템 확장을 허용한 후 시스템을 재시작하세요.

실시간 로그 보기 방법

Clash Verge Rev

왼쪽 메뉴 → 로그 → 실시간 스크롤 표시. 오른쪽 상단에서 로그 레벨 전환 가능(디버깅 시 debug 선택), 키워드 필터링 지원.

명령줄 접근

# Clash RESTful API를 통한 실시간 로그 확인
curl -N http://127.0.0.1:9090/logs \
  -H "Authorization: Bearer <secret>"
로그 파일 위치:Windows — %APPDATA%\io.github.clash-verge-rev\logs\; macOS — ~/Library/Logs/io.github.clash-verge-rev/. 충돌 또는 재현하기 어려운 문제가 발생하면 로그 파일을 커뮤니티 Issue에 공유하면 진단 속도가 빨라집니다.

자주 묻는 질문

Clash Verge Rev와 Clash for Windows의 차이는 무엇인가요? 설정 파일은 호환되나요?
CFW(Clash for Windows)는 2023년 말에 유지 관리가 중단되어 패치되지 않은 보안 취약점이 있습니다. Clash Verge Rev는 Tauri 2.0으로 재작성된 후계자로 더 현대적인 UI, 더 작은 패키지 크기(<15MB), 최신 Meta 코어가 내장되어 있습니다. 설정 파일은 완전 호환됩니다 – 기존 YAML 설정 파일을 어떤 필드도 수정하지 않고 Verge Rev에 직접 가져올 수 있습니다.
구독 가져오기 후 모든 노드가 타임아웃 / 지연 9999ms로 표시되면 어떻게 해야 하나요?
다음 순서로 문제를 해결하세요: ① 구독이 만료되었는지 확인하세요(서비스 제공자 대시보드에 로그인하여 확인); ② 바이러스 백신 / Windows Defender 방화벽을 임시로 비활성화하세요; ③ 시스템 시간이 올바른지 확인하세요(90초 이상의 오차는 핸드셰이크 실패를 야기합니다); ④ 다른 네트워크(예: 모바일 핫스팟)로 전환하여 ISP 차단 문제인지 테스트하세요.
TUN 모드 활성화 후 LAN의 다른 기기도 프록시를 사용할 수 있나요?
TUN 모드는 기본적으로 로컬 트래픽만 프록시합니다. LAN 기기와 공유하려면 설정에서 allow-lan: true을 설정하고 다른 기기의 게이트웨이 또는 프록시를 이 기기의 IP로 지정하세요(기본 포트 7890). 활성화 후 프록시 남용을 방지하기 위해 적절한 접근 제어를 설정하세요.
git / npm / pip 등의 터미널 도구를 프록시를 통해 사용하려면 어떻게 해야 하나요?
가장 쉬운 방법: TUN 모드를 활성화하면 추가 설정 없이 완전 자동으로 프록시가 적용됩니다. TUN을 사용하지 않는 경우, 터미널에서 임시로 환경 변수를 설정하세요:
# macOS / Linux
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890

# Windows PowerShell
$env:https_proxy="http://127.0.0.1:7890"
프록시 활성화 후 국내 웹사이트 접속이 느려졌습니다. 최적화 방법은?
규칙에 GEOSITE,cn,DIRECTGEOIP,CN,DIRECT 이 포함되어 있는지 확인하여 국내 트래픽이 프록시를 우회하고 직접 연결되도록 하세요. fake-ip-filter DNS 모드를 사용하는 경우 fake-ip-filter에 일반적인 국내 도메인(예: *.baidu.com, *.qq.com)을 추가하여 불필요한 DNS 지연을 방지하세요.
iOS에서 추천하는 Clash 클라이언트가 있나요?
iOS에서 현재 다음 옵션들이 있습니다: ① ① Stash(유료, Clash 설정과 호환, 세련된 UI, 완전한 기능, 국내 앱스토어에서 구매 가능); ② ② Shadowrocket(유료, 중국 외 Apple ID 필요, 다양한 프로토콜 지원); ③ ③ Sing-Box(오픈소스 무료, 새로운 생태계, 강력한 기능). FlClash의 iOS 버전은 현재 개발 중이며 GitHub에서 진행 상황을 확인하세요.