무엇을 도와드릴까요?

일반적으로 Microsoft WebView2 Runtime이 누락된 경우입니다 (Windows 10에는 사전 설치되어 있지 않을 수 있음).

1. Microsoft 공식 웹사이트를 방문하여 "Microsoft WebView2 Runtime"의 에버그린 부트스트래퍼(Evergreen Bootstrapper)를 검색하여 다운로드합니다.
2. 설치가 완료되면 Clash Verge Rev를 다시 시작합니다.

이는 공증되지 않은 앱에 대한 macOS Gatekeeper의 제한입니다. 터미널에서 다음 명령을 실행한 후 앱을 다시 엽니다.

그래도 메시지가 표시되면 시스템 설정 → 개인정보 보호 및 보안으로 이동하여 팝업 경고를 찾아 "확인 없이 열기"를 클릭합니다.

이는 오탐(False Positive)입니다. Clash 클라이언트는 본질적으로 네트워크 프록시 프로그램이며, 시스템 네트워크 설정을 수정하는 동작이 일부 백신 소프트웨어의 휴리스틱 규칙을 트리거하여 오탐을 유발할 수 있습니다.

• Windows 보안의 "제외" 목록에 앱을 추가하면 정상적으로 사용할 수 있습니다.
• 그래도 걱정된다면 먼저 가상 머신에서 테스트하거나 실제로 필요할 때만 프록시를 켜는 것을 권장합니다.

Clash Verge Rev는 기본적으로 시스템 트레이로 최소화되어 실행됩니다.

• Windows: 작업 표시줄 오른쪽 하단의 "숨겨진 아이콘" 영역을 확인합니다 (^ 위쪽 화살표를 클릭하여 확장).
• macOS: 화면 오른쪽 상단 메뉴 막대를 확인하세요. 고양이 또는 네트워크 아이콘이 있습니다.

해당 아이콘을 우클릭하면 기본 창을 열거나 모든 기능에 접근할 수 있습니다.

제어판을 통해서만 프로그램을 제거하면 설정 파일이 남습니다. 완전한 제거 단계:

1. 먼저 클라이언트에서 시스템 프록시를 끄고 앱을 종료합니다.
2. Windows: "제어판 → 프로그램 추가/제거"를 통해 제거한 후 %APPDATA%\clash-verge 디렉토리를 수동으로 삭제합니다.
3. macOS: 앱을 휴지통으로 드래그한 다음 ~/Library/Application Support/clash-verge를 삭제합니다.

가능한 원인:

• 구독 링크가 만료되었거나 서비스 제공업체에 의해 재설정되었습니다. 관리 콘솔에서 최신 링크를 다시 가져오세요.
• 구독 형식이 Clash 형식이 아닙니다 (예: V2Ray / Base64 형식). 서비스 제공업체에서 제공하는 전용 Clash 구독 링크를 사용해야 합니다.
• 붙여넣을 때 링크가 잘렸습니다. URL 전체를 복사했는지 확인하세요.

구독을 업데이트할 때 클라이언트는 서비스 제공업체의 서버에 접근해야 합니다. 현재 네트워크에서 접근할 수 없는 경우 시간 초과가 발생합니다.

1. 로컬 네트워크가 정상인지 확인합니다 (일반 웹사이트가 열리는지 확인).
2. "구독(Profiles)" 페이지에서 해당 구독을 찾아 "시스템 프록시를 사용하여 업데이트(Update via System Proxy)" 또는 "프록시를 통해 업데이트(Update via Proxy)"를 선택합니다.
3. 서비스 제공업체의 도메인이 차단된 경우, 서비스 제공업체에 문의하여 대체 링크를 받으세요.

Clash Verge Rev의 "구독(Profiles)" 페이지에서 해당 구독 카드를 편집합니다.

• "자동 업데이트(Auto Update)" 또는 "업데이트 간격(Update Interval)" 옵션을 찾습니다.
• 노드를 최신 상태로 유지하면서 요청이 너무 빈번하지 않도록 24시간으로 설정하는 것을 권장합니다.
• 노드 변경이 잦은 경우 6~12시간으로 단축할 수 있습니다.

YAML은 들여쓰기에 매우 민감합니다. 일반적인 오류는 다음과 같습니다.

• 들여쓰기에 Tab을 사용했습니다 (YAML은 공백만 허용합니다).
• 콜론 뒤에 공백이 없습니다. 예: key:value는 key: value가 되어야 합니다.
• 특수 문자(: { } [ ] , & * # ? | - < > = ! % @ \)가 포함된 문자열 값이 따옴표로 묶이지 않았습니다.

"구독(Profiles)" 페이지에서 임의의 구독 카드 오른쪽에 있는 "활성화(Activate)" 버튼을 클릭(또는 카드를 직접 클릭)하여 전환합니다. 활성화된 구독 카드는 강조 표시됩니다.

전환 후에는 구독에 따라 노드 목록과 프록시 그룹 이름이 다를 수 있으므로 "프록시(Proxies)" 페이지에서 노드를 다시 선택하는 것이 좋습니다.

Clash 설정 파일은 기본적으로 다음 경로에 저장됩니다:

• Windows: %APPDATA%\clash-verge\profiles\
• macOS / Linux: ~/.config/clash-verge/profiles/

또는 클라이언트의 "구독(Profiles)" 페이지에서 해당 구독을 마우스 오른쪽 버튼으로 클릭하고 "파일 편집(Edit File)"을 선택하여 직접 편집할 수도 있습니다. 편집 후 클라이언트에서 해당 구독을 다시 로드하면 적용됩니다.

이는 시스템 프록시 포트가 충돌하거나 Clash 코어가 실행되지 않음을 나타냅니다.

1. 클라이언트 오른쪽 상단에 "실행 중(Running)"(녹색 상태)이 표시되는지 확인합니다.
2. "설정(Settings)"으로 이동하여 Mixed 포트(기본값 7890)가 다른 프로그램에 의해 점유되지 않았는지 확인합니다.
3. 클라이언트에서 "시스템 프록시(System Proxy)"를 껐다가 다시 켜보세요.
4. 클라이언트를 다시 시작한 후 다시 시도하세요.

노드 자체에 해당 웹사이트에 대한 제한이 있거나 대상 웹사이트의 IP가 노드 출구에 의해 차단되었을 수 있습니다.

• "프록시(Proxies)" 페이지에서 수동으로 노드를 전환하고 다른 지역의 출구를 선택한 후 다시 시도해 보세요.
• 설정 파일의 규칙에서 해당 도메인이 명시적으로 DIRECT로 지정되어 있는지 확인합니다.
• "연결(Connections)" 패널에서 해당 웹사이트의 실제 출구 정책이 예상과 일치하는지 확인합니다.

게임 트래픽은 특별한 처리가 필요합니다.

• 시스템 프록시는 일반적으로 게임 클라이언트에는 효과가 없습니다. TUN 모드를 켜야 합니다.
• 게임 서버가 일반적으로 국내에 있는 경우 프록시를 통과하면 오히려 지연이 증가합니다. 규칙에서 게임 서비스 도메인을 DIRECT로 설정하는 것이 좋습니다.
• 해외 게임(예: Steam, Xbox)을 가속화하려면 게임 서버와 동일한 지역의 노드를 선택해야만 지연이 개선됩니다.

문제 해결 단계:

1. 프록시 모드 확인: "글로벌 모드(Global)"는 모든 트래픽이 프록시를 통과하게 하여 국내 웹사이트 속도를 저하시킵니다. "규칙 모드(Rule)"로 전환하세요.
2. 노드 변경: 현재 노드에 과부하가 걸렸을 수 있습니다. "프록시(Proxies)" 페이지에서 지연 테스트를 수행하고 지연이 가장 낮은 노드를 선택하세요.
3. 노드 프로토콜 확인: 특정 암호화 프로토콜(예: VMess + WebSocket + TLS)은 오버헤드가 더 큽니다. VLESS 또는 Trojan과 같은 프로토콜을 시도해 보세요.

DNS 유출이란 DNS 쿼리가 프록시를 거치지 않고 이루어져 방문 중인 도메인이 노출되는 것을 의미합니다.

확인 방법: dnsleaktest.com을 방문하여 표준 테스트를 실행합니다. 결과에 국내 DNS 서버가 표시되면 유출이 있는 것입니다.

수정 방법: 설정 파일의 dns 섹션에서 다음 설정을 활성화합니다:

TUN 모드는 모든 트래픽을 인수하므로 코어나 노드에 문제가 발생하면 네트워크가 끊어집니다. 비상 복구 단계:

1. 클라이언트에서 TUN 모드 스위치를 끕니다 (또는 클라이언트를 직접 종료하면 시스템이 원래 네트워크 설정으로 복원됩니다).
2. 선택한 노드가 지연 테스트를 통과하는지 확인한 후 다시 켭니다.
3. 설정 파일의 DNS 설정이 올바른지 확인합니다 (fake-ip 모드 권장).

TUN 모드는 시스템 드라이버 수준에서 가상 네트워크 카드를 생성해야 하므로 관리자 권한이 필요합니다. 시작할 때마다 팝업이 나타나는 것은 정상입니다.

매번 수동으로 확인하는 것을 피하려면 Clash Verge Rev를 관리자 권한으로 자동 시작하도록 설정할 수 있습니다 (작업 스케줄러에서 "가장 높은 수준의 권한으로 실행"하는 시작 작업 생성).

이는 정상적인 과정입니다. Helper는 Clash가 macOS에서 TUN 가상 네트워크 카드를 생성하는 데 필요한 시스템 수준의 보조 프로세스입니다.

1. 메시지에 있는 "설치(Install)" 버튼을 클릭합니다.
2. 나타나는 시스템 암호 대화 상자에 macOS 로그인 암호를 입력합니다.
3. 설치가 완료되면 Helper는 백그라운드에 상주하며, 이후 TUN 모드를 켤 때는 더 이상 메시지가 표시되지 않습니다.

Helper는 TUN 네트워크 카드를 관리하는 데만 사용되며 트래픽 데이터를 읽거나 업로드하지 않습니다.

TUN 모드는 이미 모든 트래픽(시스템 프록시를 따르는 앱 포함)을 처리할 수 있으므로 두 가지를 동시에 켜면 중복 프록시가 발생하여 일부 앱의 트래픽이 두 번 프록시되어 지연이 증가할 수 있습니다.

권장 사항: TUN 모드를 켤 때는 시스템 프록시를 끄고 모든 트래픽을 TUN이 통합하여 처리하도록 하세요.

Stash, Shadowrocket과 같은 iOS 프록시 앱은 중국 지역 App Store에서 삭제되었으며, 미국 등 비중국 지역 계정을 통해서만 구매할 수 있습니다.

미국 Apple ID를 등록하는 간단한 방법:

1. 현재 Apple ID에서 로그아웃합니다 (App Store에서만 로그아웃하면 되며 iCloud에서 로그아웃할 필요는 없습니다).
2. 새 이메일로 appleid.apple.com에서 계정을 등록하고, 지역을 "미국(United States)"으로 설정하며, 우편번호는 임의의 미국 우편번호(예: 10001)를 입력합니다.
3. App Store에 로그인한 후 앱을 검색하고 구매합니다.

Android는 기본적으로 App Store 이외의 APK 설치를 금지하므로 수동으로 권한을 부여해야 합니다.

• Android 8+: "설정 → 앱 → 특수 앱 액세스 → 알 수 없는 앱 설치"로 이동하여 사용 중인 파일 관리자 또는 브라우저를 찾아 권한을 켭니다.
• 구버전: "설정 → 보안"으로 이동하여 "알 수 없는 출처" 옵션을 켭니다.

보안을 위해 설치 완료 후 해당 권한을 끄는 것을 권장합니다.

이는 정상적인 과정이며, Android 시스템은 모든 VPN 관련 앱이 처음 실행될 때 사용자로부터 명시적인 권한을 얻도록 요구합니다.

1. 시스템에서 팝업으로 나타나는 VPN 권한 요청을 누르고 "확인" 또는 "허용"을 선택합니다.
2. 상태 표시줄에 VPN 아이콘이 나타나면 프록시가 활성화된 것입니다.

이 권한을 부여하지 않으면 앱에서 네트워크 트래픽을 가로챌 수 없습니다.

systemd를 사용합니다 (최신 대부분의 Linux 배포판):

기능적으로는 기본적으로 동일하지만 주요 차이점은 런타임 종속성에 있습니다.

• Windows 11에는 WebView2 런타임이 사전 설치되어 있어 즉시 사용할 수 있습니다.
• Windows 10의 경우 Microsoft WebView2 Runtime을 수동으로 설치해야 합니다.
• TUN 모드는 두 시스템 모두에서 관리자 권한이 필요합니다.
• Windows 7 / 8은 지원되지 않습니다.

Clash 코어 및 주요 클라이언트(Clash Verge Rev, FlClash 등)는 모두 오픈소스 프로젝트이며 누구나 코드를 감사할 수 있습니다. 클라이언트 자체는 타사에 사용자의 트래픽이나 행동 데이터를 업로드하지 않습니다.

트래픽은 사용자가 구성한 프록시 노드(즉, 서비스 제공업체의 서버)만 통과합니다. 서비스 제공업체의 로그 정책은 해당 제공업체에 따라 다르며 Clash 클라이언트와는 무관합니다.

구독 링크는 계정 자격 증명과 같으므로 유출되면 다른 사람이 사용자의 트래픽 할당량을 사용할 수 있습니다. 즉시 다음 조치를 취해야 합니다.

1. 서비스 제공업체의 콘솔에 로그인하여 "구독 링크 재설정" 또는 "구독 다시 생성" 기능을 찾습니다.
2. 클라이언트의 기존 구독을 새 링크로 교체합니다.
3. 계정의 트래픽 사용 기록을 확인하여 비정상적인 소비가 있는지 확인합니다.

TUN 모드는 운영 체제 커널 수준에서 가상 네트워크 인터페이스(TUN/TAP 장치)를 생성하여 모든 트래픽을 인수합니다. 이는 시스템의 저수준 작업이며 모든 운영 체제(Windows, macOS, Linux)는 이러한 작업을 권한 있는 프로세스만 수행할 수 있도록 요구합니다.

이는 운영 체제의 보안 설계이며 Clash에만 해당하는 요구 사항이 아닙니다. WireGuard, OpenVPN 등과 같은 다른 VPN 도구도 동일한 권한이 필요합니다.