Clash Verge Rev Mixin 설정 방법, Windows에서 덮어쓰기 구성하기

Clash Verge Rev에서 구독 파일을 사용하다 보면 기본 설정만으로는 부족한 순간이 있습니다. 특정 도메인만 다른 프록시 그룹으로 보내거나, DNS 모드를 바꾸거나, Windows에서 TUN 모드와 시스템 프록시를 함께 조정해야 할 때가 그렇습니다. 그러나 구독 파일을 직접 수정하면 다음 업데이트에서 변경 사항이 사라지고, 잘못된 YAML 문법 때문에 전체 설정이 적용되지 않을 수도 있습니다. 이때 사용하는 기능이 Mixin 오버라이드입니다.

Mixin은 원본 프로필을 보존한 상태에서 사용자가 지정한 설정을 추가하거나 덮어쓰는 방식입니다. Clash Verge Rev에서는 Windows 환경에 맞는 개인 설정을 별도로 관리할 수 있으므로, 구독 제공자가 갱신한 프록시 노드와 사용자의 로컬 설정을 안전하게 분리할 수 있습니다. 이 글에서는 Mixin의 작동 원리부터 Windows에서 작성하는 방법, 자주 사용하는 설정 예제, 적용 여부 확인과 문제 해결까지 단계별로 설명합니다.

Mixin 오버라이드란 무엇인가

Clash 설정은 하나의 YAML 문서로 구성되지만, 실제로는 프록시 노드, 프록시 그룹, DNS, 규칙, 모드와 같은 여러 섹션이 함께 들어 있습니다. 구독 프로필을 불러오면 Clash Verge Rev는 원격 서버에서 받은 기본 설정을 사용합니다. Mixin은 이 기본 설정에 사용자가 작성한 조각을 결합해 최종 실행 설정을 만드는 계층이라고 이해하면 됩니다.

예를 들어 구독 파일의 mode가 rule로 되어 있어도 Mixin에서 mode: global을 지정하면 최종 설정에서는 global 모드가 사용됩니다. DNS 설정을 추가하거나 기존 프록시 그룹의 이름을 참조하는 것도 가능합니다. 반면 구독 파일 안의 노드 자체를 수정하는 용도는 아닙니다. 노드의 서버 주소나 UUID를 바꾸려면 제공자가 발급한 구독을 수정하거나 별도의 로컬 프로필을 사용해야 합니다.

• 원본 보존: 구독 파일을 직접 편집하지 않으므로 자동 업데이트 후에도 개인 설정이 유지됩니다.
• 변경 범위 제어: 필요한 키만 덮어쓰므로 전체 설정을 복사할 필요가 없습니다.
• 환경별 관리: 업무용, 게임용, 테스트용처럼 여러 Mixin 파일을 나누어 적용할 수 있습니다.
• 복구 용이성: 문제가 생기면 Mixin을 비활성화하거나 해당 항목만 삭제해 원래 상태로 돌아갈 수 있습니다.

Mixin 병합과 덮어쓰기 규칙 이해하기

Mixin을 작성하기 전에 병합 규칙을 이해해야 합니다. 최종 설정은 대체로 기본 프로필에 Mixin 값이 결합되는 형태이며, 동일한 키가 있으면 Mixin 쪽의 값이 우선합니다. 단순한 스칼라 값은 비교적 직관적입니다. mode, log-level, mixed-port처럼 하나의 값으로 끝나는 항목은 Mixin에서 지정한 값으로 대체됩니다.

리스트와 객체는 조금 더 주의해야 합니다. dns 아래의 nameserver처럼 목록을 새로 작성하면 기존 목록을 보완하는 것이 아니라 전체 목록을 대체하는 방식으로 처리될 수 있습니다. 또한 proxy-groups에 같은 이름의 그룹을 다시 선언하면 그룹의 여러 속성이 새 정의로 바뀔 수 있습니다. 이름이 정확히 일치하지 않으면 새로운 그룹이 만들어지거나 참조가 실패할 수 있으므로 공백, 대소문자, 하이픈을 원본과 동일하게 확인해야 합니다.

Clash Verge Rev의 버전과 내부 코어가 Clash 또는 Mihomo인지에 따라 지원되는 필드가 다를 수 있습니다. 특히 TUN, DNS, 프로세스 규칙, 최신 프록시 그룹 옵션은 Mihomo에서 더 많은 기능을 제공합니다. 따라서 예제를 붙여 넣기 전에 현재 프로필의 코어와 설정 스키마를 확인하는 것이 좋습니다.

Windows에서 Mixin 설정 화면 열기

먼저 Windows에서 Clash Verge Rev를 실행합니다. 왼쪽 메뉴에서 설정 또는 프로필 관련 메뉴를 열고, Mixin을 관리하는 항목을 찾습니다. 버전에 따라 메뉴 이름이 Mixin, Mixin 설정, 또는 프로필 편집 화면 안의 오버라이드 항목으로 표시될 수 있습니다. 메뉴가 보이지 않는다면 앱을 최신 버전으로 업데이트하고, 현재 사용 중인 코어가 Mixin을 지원하는지 확인하세요.

1. Clash Verge Rev를 관리자 권한이 필요한 다른 네트워크 프로그램과 함께 사용 중이라면 앱을 완전히 종료한 뒤 다시 실행합니다.
2. 왼쪽 메뉴에서 Profiles 또는 프로필 관리 화면을 엽니다.
3. 현재 사용 중인 구독 프로필을 선택하고 Mixin 또는 오버라이드 편집 버튼을 누릅니다.
4. 새 Mixin 파일을 만들거나 기존 사용자 설정 파일을 엽니다.
5. YAML 형식으로 변경할 항목을 작성한 후 저장합니다.
6. 프로필 화면에서 해당 Mixin을 활성화하고 현재 프로필을 다시 적용합니다.

일부 Windows 설치에서는 사용자 설정 파일이 앱 데이터 폴더에 저장됩니다. 폴더 위치는 설치 방식과 앱 버전에 따라 달라질 수 있으므로 경로를 임의로 추측하기보다 Clash Verge Rev의 설정 화면에서 제공하는 편집 기능을 우선 사용하세요. 직접 파일을 열어야 한다면 파일 확장자가 .yaml 또는 .yml인지 확인하고, 메모장이 자동으로 .txt를 붙이지 않도록 저장 형식을 점검해야 합니다.

기본 Mixin 템플릿 작성하기

처음에는 가장 작은 설정부터 시작하는 것이 안전합니다. 아래 예제는 Windows에서 사용할 로컬 포트, 로그 수준, 작동 모드를 명시하는 기본 템플릿입니다. 이미 동일한 포트가 다른 프로그램에서 사용 중이라면 Clash가 시작되지 않을 수 있으므로, 포트 충돌 여부를 먼저 확인해야 합니다.

mode: rule
log-level: info

mixed-port: 7890
allow-lan: false
unified-delay: true

external-controller: '127.0.0.1:9090'

mixed-port는 HTTP와 SOCKS5 요청을 함께 받을 수 있는 포트입니다. Windows 애플리케이션마다 프록시 프로토콜 지원 방식이 다르므로 하나의 포트로 통일하면 관리가 편합니다. allow-lan: false는 같은 네트워크의 다른 기기가 로컬 프록시 포트에 접근하지 못하도록 하는 보수적인 기본값입니다. 다른 기기에서 사용해야 하는 경우에만 true로 바꾸고, Windows 방화벽과 인증 설정을 함께 점검하세요.

external-controller는 대시보드나 외부 관리 도구가 Clash API에 연결할 때 사용합니다. 로컬 컴퓨터에서만 관리한다면 127.0.0.1 바인딩을 유지하는 것이 좋습니다. 0.0.0.0:9090으로 열면 LAN에 노출될 수 있으므로, 특별한 이유 없이 변경하지 마세요.

DNS와 TUN 모드 오버라이드

Windows에서 브라우저뿐 아니라 게임 런처, 메신저, 개발 도구까지 함께 라우팅하려면 TUN 모드를 고려할 수 있습니다. 다만 TUN은 시스템 전체의 네트워크 경로에 관여하므로, DNS 설정과 가상 어댑터 권한을 함께 확인해야 합니다. 아래 예제는 Mihomo 계열 코어에서 자주 사용하는 기본적인 방향을 보여 줍니다.

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: '198.18.0.1/16'
  nameserver:
    - 1.1.1.1
    - 8.8.8.8
  fake-ip-filter:
    - '*.lan'
    - '*.local'
    - 'localhost.ptlogin2.qq.com'

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true

fake-ip 모드는 도메인 기반 규칙을 적용하기 쉬워 DNS 오염이나 예기치 않은 로컬 해석을 줄이는 데 도움이 됩니다. 하지만 일부 게임, 프린터, 사내 장비, 화상회의 프로그램은 실제 IP나 로컬 네트워크 검색을 요구할 수 있습니다. 이런 환경에서는 fake-ip-filter에 예외 도메인을 추가하거나 TUN을 잠시 끄고 원인을 분리해서 테스트해야 합니다.

TUN을 활성화할 때는 Windows에서 가상 네트워크 어댑터가 정상적으로 만들어졌는지 확인하세요. 관리자 권한이 부족하거나 다른 VPN 클라이언트가 자체 TUN 드라이버를 점유하면 Clash가 켜져 있어도 트래픽이 통과하지 않을 수 있습니다. 처음에는 시스템 프록시만 사용해 기본 연결을 확인한 다음 TUN을 활성화하는 순서가 안전합니다.

프록시 그룹과 규칙을 사용자 환경에 맞게 바꾸기

Mixin의 가장 실용적인 용도는 기존 프록시 그룹을 사용자 방식으로 재구성하는 것입니다. 구독 파일에 이미 노드와 그룹이 있다면 모든 노드를 다시 입력할 필요가 없습니다. 원본 그룹의 이름을 확인한 뒤, 사용할 노드 목록이나 자동 선택 방식을 오버라이드하면 됩니다. 단, 그룹 이름이 구독 갱신 때 바뀌면 참조가 끊길 수 있으므로 프로필을 업데이트한 뒤 이름을 다시 확인하세요.

proxy-groups:
  - name: 'Proxy'
    type: url-test
    url: 'https://www.gstatic.com/generate_204'
    interval: 300
    tolerance: 50
    proxies:
      - 'Node A'
      - 'Node B'
      - 'Node C'

rules:
  - 'DOMAIN-SUFFIX,github.com,Proxy'
  - 'DOMAIN-SUFFIX,openai.com,Proxy'
  - 'GEOIP,LAN,DIRECT'
  - 'MATCH,DIRECT'

노드 이름에 공백이나 특수문자가 포함되어 있다면 문자열로 감싸는 편이 안전합니다. url-test는 주기적으로 연결 상태를 측정해 상대적으로 빠른 노드를 선택하지만, 측정 URL에 연결할 수 있다고 해서 모든 서비스가 빠르다는 뜻은 아닙니다. 스트리밍이나 게임처럼 특정 지역이 중요한 경우에는 자동 측정보다 수동 select 그룹이 더 적합할 수 있습니다.

규칙은 위에서부터 아래로 평가됩니다. 따라서 특정 도메인을 먼저 지정하고, 사설망 예외를 배치한 뒤 마지막에 MATCH를 두어야 합니다. 마지막 규칙을 생략하면 예상하지 못한 트래픽이 기본 동작으로 처리될 수 있습니다. 직접 연결해야 하는 Windows 업데이트나 회사 도메인이 있다면 해당 도메인을 명시적으로 DIRECT에 연결하세요.

Mixin 적용 여부 확인하기

파일을 저장했다고 해서 항상 즉시 실행 설정에 반영되는 것은 아닙니다. Clash Verge Rev의 프로필 화면에서 현재 사용 중인 프로필과 Mixin이 모두 활성화되어 있는지 확인하고, 필요하면 프로필을 다시 적용하거나 코어를 재시작하세요. 메뉴 이름은 버전에 따라 다르지만 최종 설정 보기, 설정 검증, 또는 디버그 정보와 비슷한 기능을 찾으면 됩니다.

1. Mixin 파일의 YAML 들여쓰기를 확인합니다. 탭 대신 스페이스를 사용하세요.
2. 현재 프로필을 다시 선택해 최종 설정을 생성합니다.
3. 대시보드에서 모드, DNS, 프록시 그룹, 연결 규칙을 확인합니다.
4. Windows 시스템 프록시가 켜져 있는지, 브라우저가 올바른 포트를 사용하는지 점검합니다.
5. 테스트 사이트와 일반 사이트를 각각 열어 프록시 및 직접 연결 규칙을 검증합니다.

가장 확실한 방법은 한 번에 하나의 설정만 바꾸는 것입니다. 예를 들어 먼저 mode: rule만 적용하고, 정상 작동한 뒤 DNS를 추가한 다음 TUN을 켭니다. 여러 항목을 동시에 변경하면 어느 설정이 문제를 일으켰는지 확인하기 어렵습니다. 연결 화면에서 목적지, 매칭된规则, 사용된代理组를 확인하면 규칙이 예상대로 적용되는지 빠르게 판단할 수 있습니다.

적용되지 않을 때 점검할 항목

Mixin이 전혀 적용되지 않는다면 먼저 파일 형식과 활성화 상태를 확인하세요. YAML은 들여쓰기 하나만 달라도 다른 구조로 해석됩니다. 키 앞에 불필요한 공백이 있거나 콜론 뒤에 값이 없으면 파싱 오류가 발생할 수 있습니다. Windows 메모장에서 저장한 파일이 mixin.yaml.txt로 되어 있지 않은지도 확인해야 합니다.

• 설정 검증 오류: 최근에 추가한 블록을 삭제하고 최소 설정으로 되돌린 뒤 항목을 하나씩 다시 추가합니다.
• 그룹을 찾을 수 없음: 원본 프로필의 그룹 이름과 Mixin의 name 값이 완전히 같은지 비교합니다.
• DNS는 되지만 웹사이트가 열리지 않음: fake-ip 예외, DNS 업스트림, 규칙의 프록시 그룹을 차례로 점검합니다.
• TUN 활성화 후 인터넷이 끊김: 다른 VPN 또는 보안 프로그램의 가상 어댑터를 끄고 관리자 권한으로 다시 테스트합니다.
• 구독 업데이트 후 설정이 사라짐: Mixin이 프로필에 연결되어 있는지 확인하고, 원본 구독 파일을 직접 수정하지 않았는지 점검합니다.

Mixin은 구독 파일과 개인 환경 설정을 분리해 주는 실용적인 방법입니다. Windows에서는 먼저 기본 포트와 시스템 프록시를 안정적으로 확인한 뒤, DNS와 TUN, 프록시 그룹, 규칙을 작은 단위로 추가하는 것이 가장 안전합니다. 원본 프로필의 구조와 그룹 이름을 존중하고, 변경 전 백업을 남긴다면 구독 업데이트가 반복되어도 자신만의 Clash Verge Rev 환경을 일관되게 유지할 수 있습니다.