mihomo · YAML

Clash 설정 파일 레퍼런스

이 페이지에서는 설정 항목을 찾고 참조 관계를 확인하며, 코어가 실제로 불러오는 설정을 살펴봅니다. 처음 설치하거나 구독을 가져오는 경우 먼저 빠른 시작 가이드를 확인하세요. 연결이 정상적으로 작동하면 이 문서로 돌아와 설정을 조정하면 됩니다. 아래 예시는 mihomo를 기준으로 하며, 외부 서비스가 필요한 경우 실행 조건을 따로 안내합니다.

YAML 구조와 설정 시작점

최상위 항목, 맵, 목록

코어는 맵을 최상위 구조로 하는 YAML 문서를 읽습니다. 포트와 모드는 최상위 키로 작성하고, DNS는 맵으로 작성한 뒤 그 안에 DNS 서버 주소 목록을 둡니다. 노드, 프록시 그룹, 규칙에도 각각 최상위 키가 있습니다. 항목을 어디에 넣을지 판단할 때는 먼저 부모 항목을 찾고, 그 부모가 키-값 쌍을 받는지 목록을 받는지 확인하세요. 다른 설정과 시각적으로 비슷한 위치에 들여쓰기만 맞춰도 올바른 모듈에 자동으로 포함되지는 않습니다.

같은 단계의 항목은 들여쓰기를 동일하게 맞추고, 단계마다 공백 두 칸을 사용하는 것이 좋습니다. 목록 항목은 하이픈으로 시작하고 하이픈 뒤에 공백을 둡니다. 목록의 노드 하나는 하나의 레코드입니다. 노드 이름, 유형, 주소는 같은 레코드에 있어야 하며 각각 별도의 목록 항목으로 작성하면 안 됩니다. 규칙은 다릅니다. 보통 규칙 하나를 문자열 한 줄로 작성합니다. 쉼표는 규칙 문자열 안의 필드를 구분할 뿐, 이를 여러 YAML 목록 항목으로 나누라는 뜻이 아닙니다.

숫자 포트는 숫자로 작성하고, 스위치는 true 또는 false로 작성하세요. 모든 값에 따옴표를 붙이지는 마세요. 이름이나 긴 매개변수에는 따옴표를 사용할 수 있습니다. 값에 주석이나 키-값 구분자로 해석될 수 있는 문자가 들어가면 특히 따옴표를 유지해야 합니다. 예를 들어 따옴표 없이 작성한 이름에서 공백 뒤에 샵 기호가 오면, 그 뒤의 글자가 주석으로 처리되어 사라질 수 있습니다. 그러면 해당 이름을 참조하는 프록시 그룹이 대상을 찾지 못합니다. 빈 목록 []과 빈 맵 {}도 서로 다른 값입니다.

최소 기준 설정과 이름 참조

아래 기준 설정은 로컬 혼합 프록시 포트만 열고, 해당 포트로 들어오는 모든 트래픽을 내장 직결 출구로 보냅니다. 구독이나 추가 리소스가 필요하지 않아, 로컬 프록시 입구를 통해 원래 접속 가능한 사이트에 접근되는지 먼저 확인하기 좋습니다. 암호화 프록시 설정은 아니며, 코어를 거치지 않는 앱의 트래픽도 바꾸지 않습니다. 로컬에서 다른 클라이언트가 이미 이 포트를 사용 중이면 비어 있는 포트를 선택하고 테스트하는 쪽의 포트도 함께 변경하세요.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

이 기준 설정에서 프록시 그룹을 추가할 때는 데이터 참조 관계를 한 줄로 따라가면 됩니다. 규칙은 프록시 그룹을 참조하고, 그룹은 노드·다른 그룹·내장 출구를 참조하며, 노드는 실제 연결 방식을 정의합니다. 규칙이 내장 출구를 직접 가리킬 수도 있습니다. 참조는 목록의 위치가 아니라 이름으로 연결됩니다. 노드 이름을 바꾸면 모든 프록시 그룹을 확인하고, 그룹 이름을 바꾸면 규칙과 해당 그룹을 참조하는 다른 그룹까지 확인해야 합니다. 공백 하나가 더 있는 비슷한 이름도 같은 객체로 인식되지 않습니다.

구독, 설정 파일, 프록시 제공자의 내용은 서로 바꿔 쓸 수 있는 것이 아닙니다. 클라이언트의 구독 가져오기 기능은 전체 설정을 받아 처리하거나 자체 규칙에 따라 최종 설정을 생성할 수 있습니다. 프록시 제공자는 프록시 그룹에서 선택할 노드 목록을 불러옵니다. 노드 목록만으로 최상위 리스너와 규칙이 포함된 설정이 되는 것은 아닙니다. 내용을 복사하기 전에 최상위 키를 확인하세요. 최상위 키가 payload라면 어떤 종류의 리소스인지 확인해야 하며, 이를 기본 설정처럼 바로 실행하면 안 됩니다.

원본 설정과 실제 적용 설정 구분하기

그래픽 클라이언트를 사용할 때는 구독 원본, 로컬 덮어쓰기, 코어에 전달되는 최종 설정을 구분해야 합니다. 인터페이스의 스위치가 최종 파일 생성에 반영될 수도 있고, 런타임 API를 통해 코어 상태를 바꿀 수도 있습니다. 구독을 갱신할 때마다 직접 수정한 내용이 사라진다면, 캐시 파일을 계속 편집하기보다 클라이언트가 지원하는 덮어쓰기 위치로 사용자 설정을 옮기는 편이 좋습니다. 구체적인 위치는 클라이언트별로 확인하세요. 처음 클라이언트를 고른다면 설치 파일 페이지에서 추천 항목인 Clash Plus부터 살펴볼 수 있습니다.

중국어 주석으로 변경 목적을 설명할 수는 있지만, 주석으로 참조 충돌을 해결할 수는 없습니다. 같은 맵 안에 동일한 키를 중복해서 쓰지 마세요. 일부 파서는 오류를 표시하고, 다른 파서는 값 중 하나만 남길 수 있습니다. 규칙을 두 번 작성해도 규칙이 추가되는 것은 아닙니다. 하나의 목록으로 정리하고 원하는 매칭 순서대로 배치하세요. 저장한 뒤에는 실제 구조를 확인하고, 인터페이스에서 올바른 설정을 선택했는지도 확인하세요.

편집기의 색상만 보고 설정이 올바른지 판단하는 것은 신뢰하기 어렵습니다. 구문 강조는 들여쓰기와 따옴표 문제 일부를 알려줄 수 있지만, 그룹 이름이 정의되어 있는지 또는 현재 코어가 해당 항목을 지원하는지는 알 수 없습니다. 로드 오류가 발생하면 오류 위치에서 위쪽으로 가장 가까운 부모 키를 찾아 목록 단계와 항목 유형을 확인하세요. 구문 검사를 통과한 다음에는 실제 참조 관계를 점검합니다. 이렇게 하면 표기와 정책을 동시에 바꾸다가 어느 수정으로 문제가 해결됐는지 알 수 없게 되는 일을 막을 수 있습니다.

일반 포트, 바인딩 범위, 실행 모드

입구를 선택하고 실제 리스닝 상태 확인하기

포트 항목은 코어가 로컬에서 요청을 받는 입구를 나타내며, 원격 노드가 실행되는 서버 포트와는 다릅니다. 혼합 포트는 HTTP 프록시와 SOCKS 요청을 모두 받을 수 있어 두 종류의 앱이 같은 주소를 사용하기에 적합합니다. 앱에서 각각 별도의 입구를 요구한다면 HTTP와 SOCKS 포트를 따로 설정할 수 있습니다. 여러 입구를 리스닝할 때는 서로 다른 포트를 사용하세요. 세 항목을 모두 같은 숫자로 설정하면 안 됩니다.

항목제어 대상확인 사항
mixed-portHTTP와 SOCKS 혼합 프록시 입구앱에서 사용하는 프록시 프로토콜을 선택해야 합니다.
portHTTP 프록시 입구HTTPS 사이트에 프록시로 접속한다고 해서 로컬 입구를 HTTPS 프록시로 설정하는 것은 아닙니다.
socks-portSOCKS 프록시 입구앱이 대상 도메인을 전달하는지, 이미 해석된 주소를 전달하는지 확인하세요.
allow-lan로컬 프록시 입구에 LAN 연결을 허용할지 여부로컬에서만 사용할 때는 false로 설정하세요.
bind-addressLAN 연결 허용 시 바인딩할 주소공유가 필요하다면 인터페이스 주소를 명시하고 접근 범위를 확인하세요.
external-controller코어 제어 인터페이스프록시 포트가 아니며 프록시 입구와 함께 외부에 열어두면 안 됩니다.

아래 예시는 두 종류의 입구에 서로 다른 포트를 할당합니다. 클라이언트가 이미 이 항목을 관리한다면 인터페이스에서 해당 값을 설정하거나 덮어쓰기 후의 최종 파일을 확인하세요. 설정에 포트 번호가 있다고 해서 프로세스가 실제로 바인딩된 것은 아닙니다. 이전 인스턴스가 계속 실행 중이거나 다른 도구가 주소를 사용 중이거나, 시스템이 프로세스의 리스닝을 제한하면 포트를 사용할 수 없습니다. 포트 충돌이 발생하면 먼저 어떤 프로세스가 점유 중인지 확인한 뒤 이전 인스턴스를 종료할지 포트를 바꿀지 결정하세요.

port: 7890
socks-port: 7891
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

로컬 앱에는 보통 루프백 주소 127.0.0.1와 해당 프로토콜의 포트를 입력합니다. 검증할 때는 먼저 리스닝 로그를 확인한 다음 프록시를 직접 설정할 수 있는 앱에서 요청을 보내세요. 해당 앱은 성공했는데 다른 앱에는 연결 기록이 없다면, 다른 앱이 시스템 프록시를 사용하는지 또는 자체 프록시 설정이 있는지 먼저 확인하세요. 프록시 아이콘이 켜졌다는 이유만으로 모든 앱이 같은 입구를 사용한다고 판단하지 마세요.

클라이언트의 시스템 프록시 스위치는 보통 시스템 수준의 프록시 설정을 변경하며, 이를 사용할지는 앱에 따라 다릅니다. TUN은 네트워크 인터페이스와 라우팅 단계에서 지정된 트래픽을 가로채며, 대개 시스템 권한도 필요합니다. 두 기능은 트래픽을 코어에 어떻게 전달할지 다루며, 코어에 들어온 뒤 어떤 출구를 선택할지와는 별개입니다. mode만 바꿔서는 시스템 프록시가 켜지지 않으며 TUN 인터페이스 설정을 대신할 수도 없습니다. 처음 문제를 확인할 때는 한 가지 연결 방식만 사용하세요.

규칙 모드, 전역 모드, 직결 모드 구분하기

rule 모드는 규칙 순서에 따라 출구를 선택하므로 트래픽 분기 기준이 명확한 설정에 적합합니다. global 모드는 전역 선택을 사용하며 규칙 목록을 차례로 검사하지 않습니다. 사용 전에 클라이언트에서 어떤 출구가 선택되어 있는지 확인해야 하며, 특정 원격 노드를 사용 중이라고 단정해서는 안 됩니다. direct 모드는 코어에 들어온 트래픽을 직결시킵니다. 로컬 리스닝을 끄거나 시스템 프록시 설정을 원래대로 되돌리는 모드는 아닙니다.

같은 사이트가 규칙 모드와 전역 모드에서 다르게 작동한다면 두 연결 기록에 표시된 실제 출구부터 확인하세요. 전역 모드에서 성공했다는 것은 해당 시점에 선택된 경로가 작동했다는 뜻일 뿐, 전체 규칙에 문제가 있다는 의미는 아닙니다. 규칙이 직결을 선택했거나 참조한 그룹에서 다른 항목이 선택됐을 수도 있고, 두 번의 연결에서 도메인 해석 결과가 달랐을 수도 있습니다. 직결 모드로 테스트한다면 현재 네트워크에서 해당 사이트에 직접 접속할 수 있는지도 확인하세요.

평소 로그 수준은 info로 두는 것이 좋습니다. 문제를 찾을 때는 잠시 debug로 높이고 한 번 재현한 뒤 원래대로 돌리세요. 로그의 대상 주소와 설정 이름에 사용 환경 정보가 포함될 수 있으므로 공유할 때는 문제와 관련된 기록만 캡처하세요. ‘요청이 입구에 도착함’, ‘규칙이 출구를 선택함’, ‘원격 연결이 완료됨’의 세 단계를 구분하세요. 첫 단계만 완료된 상태에서 문제를 대상 사이트 탓으로 돌릴 수는 없습니다.

로컬과 LAN의 경계 제한하기

다른 기기에서 연결해야 할 때만 LAN 접근을 고려하세요. 원격 기기에는 코어가 실행 중인 호스트의 LAN 주소를 입력해야 하며, 원격 기기 자신의 루프백 주소를 입력하면 안 됩니다. 접근을 허용하기 전에 사용할 인터페이스와 방화벽 범위를 정하고, 테스트가 끝나면 더 이상 필요하지 않은 경우 끄세요. 제어 인터페이스는 별도로 판단해야 합니다. 프록시로 인터넷에 접속할 수 있다고 해서 호출자에게 코어 제어 권한까지 필요한 것은 아닙니다. 로컬 연결 문제를 해결하려고 프록시 포트와 제어 포트를 모두 모든 인터페이스에 바인딩하지 마세요.

포트를 의도적으로 변경한 뒤에는 시스템 프록시, 브라우저의 별도 설정, 터미널 환경 변수가 여전히 이전 값을 사용하는지 확인하세요. 재시작 전에는 작동했지만 이후 작동하지 않는다면 재시작 전후의 실제 리스닝 주소와 설정 이름을 기록하고 같은 인스턴스가 실행됐는지 확인합니다. 시스템 설정 위치와 플랫폼 권한의 차이는 먼저 빠른 시작 가이드에서 확인한 뒤 여기서 코어 항목과 대조하세요.

DNS 항목과 fake-ip 동작 방식

요청이 코어에서 해석되는지 확인하기

설정에서 DNS를 활성화하면 코어 자체의 DNS 모듈이 켜집니다. 이 스위치만으로 운영체제의 모든 DNS 쿼리를 가로채지는 않습니다. 브라우저가 자체 암호화 DNS를 사용할 수도 있고, 앱이 해석된 주소를 프록시에 전달할 수도 있습니다. 시스템 프록시와 TUN은 트래픽을 전달하는 방식이 다르며, DNS 요청을 받을 수 있는지는 구체적인 설정에 따라 달라집니다. 문제를 확인하기 전에 어느 앱이 쿼리를 시작했는지, 실제로 어느 리졸버에 전달됐는지 확인하세요.

DNS 설정의 nameserver는 일반 도메인에 사용할 리졸버 목록입니다. nameserver-policy를 사용하면 특정 도메인에 사용할 리졸버를 지정할 수 있습니다. default-nameserver는 시작 단계에서 DNS 서버의 호스트 이름을 해석하는 등의 부트스트랩 용도로 쓰이며, 모든 요청에 하나씩 시도하는 예비 리졸버 목록이 아닙니다. 호스트 이름을 사용하는 암호화 DNS 주소를 설정할 때는 부트스트랩 리졸버가 현재 네트워크에서 연결 가능한지 확인하세요. 설정을 읽는 데 성공해도 첫 쿼리는 시간 초과될 수 있습니다.

proxy-server-nameserver는 프록시 노드 서버의 도메인을 해석하는 데 사용합니다. 노드에 연결하기 전에 노드 주소를 어떻게 알아낼지 해결하는 항목이며, 일반 웹사이트의 도메인 해석과는 다릅니다. 노드가 도메인이고 그 도메인 해석에 필요한 상위 리졸버에 해당 노드를 통해서만 접속할 수 있다면 순환 의존이 발생합니다. 이 경우 일반 웹사이트의 쿼리를 어느 경로로 보낼지 결정하기 전에, 연결을 시작하기 전에도 실제로 사용할 수 있는 노드 주소 해석 경로를 마련하세요.

주소 매핑, 필터링, 로컬 조회 예시

fake-ip 모드에서 코어는 받은 도메인 쿼리에 가상 주소를 할당하고 도메인과 주소의 매핑을 저장할 수 있습니다. 연결이 같은 코어로 돌아오면 코어가 도메인을 복원해 도메인 규칙에 따라 판단할 수 있습니다. 이 가상 주소는 대상 서버가 공개한 실제 주소가 아니며, 현재 코어의 매핑 없이 단독으로 사용할 수도 없습니다. 쿼리는 코어를 거쳤는데 연결이 시스템 라우팅으로 바로 전달되면 앱이 도달할 수 없는 가상 주소에 연결하려고 할 수 있습니다.

mixed-port: 7890
allow-lan: false
mode: rule
dns:
  enable: true
  listen: 127.0.0.1:1053
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter:
    - 'localhost'
    - '+.lan'
  nameserver:
    - system
rules:
  - MATCH,DIRECT

이 예시는 루프백 주소에서 별도 DNS 포트를 열고 일반 쿼리를 시스템 리졸버로 전달합니다. 해당 포트로 테스트 쿼리를 직접 보내는 용도이며 시스템 DNS를 대신 변경해 주지는 않습니다. 이 예시를 사용할 때는 시스템 리졸버가 쿼리를 다시 이 리스닝 포트로 보내지 않도록 해야 합니다. 다른 도구가 같은 포트를 사용 중이면 비어 있는 포트로 변경하세요. 가상 주소 대역이 로컬의 기존 라우팅 또는 다른 프록시 인스턴스의 가상 네트워크 대역과 충돌하는지도 확인해야 합니다.

예시의 기본 필터 동작에서 fake-ip-filter는 목록에 있는 이름을 가상 주소 할당 대상에서 제외합니다. 로컬 도메인을 목록에 추가하면 실제 DNS 응답을 받아야 하는 문제를 해결할 수 있지만, 해당 도메인의 레코드가 새로 생기는 것은 아닙니다. 내부 도메인 접미사를 조직의 리졸버에서만 처리해야 한다면 시스템 DNS가 해당 레코드를 반환할 수 있는지 확인하거나, 접미사에 사용할 수 있는 리졸버를 별도로 설정하고 라우팅에서 해당 DNS 서버에 접근할 수 있는지 검증하세요.

또 다른 강화 모드인 redir-host는 보통 앱에 실제 주소를 반환합니다. 도메인 규칙을 계속 적용할 수 있는지는 프록시 요청에 도메인 정보가 포함되는지 또는 코어가 실제 트래픽 경로에서 도메인 정보를 얻을 수 있는지에 따라 달라집니다. 모드를 바꾸는 것만으로 모든 도메인 매칭 문제가 해결된다고 생각하면 안 됩니다. 같은 대상을 기준으로 DNS 응답과 연결 로그를 함께 확인하세요. 전자만 달라졌다면 후자가 예상한 규칙에 일치했다는 뜻은 아닙니다.

DNS 해석 실패, 캐시, 이후 연결 실패 구분하기

시스템에 서버와 포트를 지정할 수 있는 쿼리 도구가 있다면 아래 두 쿼리를 실행할 수 있습니다. 첫 번째는 예시의 리스닝 주소로 직접 보내고, 두 번째는 도구의 기본 시스템 DNS 경로를 사용합니다. 두 결과의 주소가 같아야 한다고 가정하지 말고 응답 상태와 주소 유형을 기록하세요. 가상 주소 모드에서는 결과가 서로 다른 것이 정상일 수 있습니다. 리스너에 쿼리가 도착하지 않는다면 상위 DNS 서버를 바꾸기 전에 주소와 포트를 먼저 확인하세요.

dig @127.0.0.1 -p 1053 example.com A
dig example.com A

응답은 왔는데 연결이 실패한다면 연결이 매핑을 저장한 동일한 인스턴스로 들어갔는지 확인한 뒤 도메인 규칙, 프록시 그룹, 출구 로그를 살펴보세요. 설정을 바꾼 뒤에도 브라우저와 운영체제가 이전에 캐시한 주소를 계속 사용하거나 이미 연결된 세션을 재사용할 수 있습니다. 새 연결로 다시 테스트하고, 필요한 경우 테스트 앱의 관련 상태만 초기화하세요. DNS, 트래픽 가로채기, 노드 변경을 한꺼번에 하지 말고 매번 하나의 요소만 바꾸세요.

듀얼 스택 환경에서는 IPv4와 IPv6도 각각 확인해야 합니다. DNS의 ipv6 옵션은 코어 DNS가 IPv6 쿼리를 처리하는 방식을 제어할 뿐, 시스템의 IPv6 스택을 비활성화하지 않으며 IPv6 연결 경로 점검을 대신하지도 않습니다. 진단할 때 쿼리 유형과 실제 대상 주소를 기록하세요. 한 주소 체계로 연결에 성공했다고 해서 다른 주소 체계에서도 같은 정책과 경로를 사용한다는 뜻은 아닙니다.

프록시 노드 항목과 제공자

프로토콜별 출구 레코드 작성하기

proxies는 노드 레코드 목록입니다. 일반적인 레코드에는 이름, 프로토콜 유형, 서버, 포트가 포함되며 프로토콜별 항목은 실제 서비스에 맞게 작성합니다. 이름은 참조와 표시에 사용하고 주소와 포트는 연결 대상을 결정합니다. 주소에는 호스트 이름이나 주소만 입력해야 합니다. 스킴과 경로가 포함된 구독 링크를 넣으면 안 됩니다. 구독 주소는 설정을 가져오거나 생성하는 데 사용하고, 노드 주소는 출구 연결을 설정하는 데 사용합니다. 둘은 로드 과정에서 서로 다른 역할을 합니다.

아래는 기존 로컬 SOCKS 서비스를 연결하는 노드 예시입니다. 이 예시를 사용하려면 로컬 1080 포트에서 별도의 SOCKS 서비스가 이미 리스닝 중이고 이 클라이언트의 접근을 허용해야 합니다. 해당 서비스의 설정은 바꿀 필요가 없습니다. 코어가 인바운드 요청을 받는 포트는 7890입니다. 이 노드의 서버 포트를 같은 코어의 혼합 입구 포트로 변경하지 마세요. 요청이 출구에서 입구로 되돌아가 중복 처리되거나 연결이 실패할 수 있습니다.

mixed-port: 7890
allow-lan: false
mode: rule
proxies:
  - name: Local-SOCKS
    type: socks5
    server: 127.0.0.1
    port: 1080
    udp: false
rules:
  - DOMAIN-SUFFIX,example.com,Local-SOCKS
  - MATCH,DIRECT

이 예시는 예시 도메인과 일치하는 연결만 해당 노드로 보내고 나머지는 직결합니다. 사용할 SOCKS 서비스가 없다면 먼저 최소 기준 설정으로 입구를 검증하세요. 노드 예시가 실패했다고 해서 YAML 로드에 실패한 것은 아닙니다. 노드가 클라이언트 목록에 나타났다는 것은 레코드를 읽었다는 뜻일 뿐입니다. 실제로 작동하는지 확인하려면 주소에 접근할 수 있는지, 프로토콜 핸드셰이크가 완료되는지, 대상 요청이 해당 출구를 통해 응답을 받는지 각각 확인해야 합니다. 어느 단계에서든 실패하면 인터페이스에는 단순히 시간 초과로 표시될 수 있습니다.

프로토콜을 바꿀 때 type만 변경하고 기존 항목을 모두 그대로 사용하지 마세요. 예를 들어 Shadowsocks의 비밀번호와 암호화 방식은 서버 설정과 일치해야 합니다. TLS를 사용하는 다른 프로토콜에는 서버 이름, 인증서 검증, 전송 방식 등이 필요할 수도 있습니다. 설정 구조가 비슷하다고 핸드셰이크까지 호환되는 것은 아닙니다. 인증서 오류가 발생하면 서버 이름, 시스템 시간, 서버 인증서를 먼저 확인하세요. 검증을 끄는 방식은 일반적인 해결책이 아닙니다.

udp는 일부 노드에서 UDP 전달을 활성화할지 지정합니다. UDP를 지원하지 않는 서비스에 이 기능을 자동으로 추가하지는 않습니다. 노드로 웹페이지에 접속할 수 있다고 해서 음성 통화나 다른 UDP 앱도 작동한다고 단정할 수 없습니다. 문제를 확인할 때는 인바운드가 해당 트래픽을 전달하는지, 정책이 호환되는 출구를 선택했는지, 서버가 실제로 전달할 수 있는지 함께 살펴보세요. 웹페이지가 열리는지를 프로토콜 계층 점검의 대용으로 삼지 마세요.

프록시 제공자의 경로와 로드 순서

별도로 관리하는 노드가 여러 개라면 proxy-providers를 사용할 수 있습니다. 기본 설정에서 리소스 출처를 선언하고, 프록시 그룹은 use로 제공자 이름을 참조합니다. 아래 예시는 로컬 파일 방식입니다. 먼저 코어의 작업 디렉터리에 표시된 파일을 만들어야 합니다. 예시는 앞에서 설명한 별도 SOCKS 서비스를 계속 사용하므로 실제로 연결하기 전에 해당 서비스가 실행 중인지 확인하세요. 파일을 찾지 못하면 상대 경로나 시작 시 선택한 작업 디렉터리를 수정하세요.

mixed-port: 7890
allow-lan: false
mode: rule
proxy-providers:
  local-source:
    type: file
    path: ./local-proxies.yaml
proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - DIRECT
    use:
      - local-source
rules:
  - DOMAIN-SUFFIX,example.com,PROXY
  - MATCH,DIRECT
proxies:
  - name: Local-SOCKS
    type: socks5
    server: 127.0.0.1
    port: 1080
    udp: false

프록시 그룹을 열어 제공자 구성원이 표시되는지 확인한 다음 직접 선택하세요. 연결 기록에 그룹 이름만 보인다고 해서 충분하지 않습니다. 그룹의 현재 구성원이 여전히 직결이면 노드를 검증한 것이 아닙니다. HTTP 제공자를 사용한다면 가져온 내용이 코어에서 인식할 수 있는 노드 리소스인지, 로그인 페이지나 별도의 전체 설정 파일은 아닌지 확인하세요. 제공자의 작업 경로와 업데이트 주기는 따로 관리해 여러 리소스가 같은 캐시 파일을 공유하지 않도록 하세요.

리소스 업데이트를 확인할 때는 ‘다운로드 성공’, ‘파싱 성공’, ‘구성원 사용 가능’을 각각 기록하세요. 업데이트로 기존 구성원이 삭제되거나 같은 이름의 레코드가 서버 매개변수와 함께 교체될 수 있습니다. 업데이트 후 직접 선택한 구성원이 사라졌다면 이전 화면만 비교하지 말고 새 제공자 구성원 목록과 그룹의 현재 선택 항목을 확인하세요. 설정 조각을 공유할 때는 구독 주소, 인증 정보, 내부 호스트 이름을 제거하고 구조를 설명하는 데 필요한 항목만 남기세요.

프록시 그룹 유형, 구성원, 상태 확인

출구를 선택하는 프록시 그룹

proxy-groups는 출구 선택 정책을 정의하며 새로운 프록시 프로토콜을 정의하지는 않습니다. 그룹 이름은 규칙이 참조할 대상이고, 구성원으로는 개별 노드, 내장 출구, 다른 그룹, 제공자의 노드를 지정할 수 있습니다. 그룹을 사용하면 노드를 교체하거나 조정할 때 해당 그룹을 참조하는 규칙을 바꾸지 않아도 되어 규칙을 안정적으로 유지할 수 있습니다. 먼저 그룹의 역할을 분명하게 정한 뒤 구성원 출처를 결정하세요. 용도가 다르다는 이유만으로 이름이 한 글자만 다른 그룹을 여러 개 만들지는 않는 것이 좋습니다.

유형선택 방식확인 사항
select사용자가 구성원을 선택클라이언트가 이전 수동 선택을 복원했는지 확인하세요.
url-test탐색 결과에 따라 구성원 선택탐색 주소, 주기, 전환 허용 범위가 선택에 영향을 줍니다.
fallback목록 우선순위에 따라 사용 가능한 구성원 선택주·대기 순서는 구성원 목록으로 정하며 지연 시간이 짧은 순서로 정렬하지 않습니다.
load-balance설정된 정책에 따라 연결 분배연결마다 다른 출구를 사용할 수 있으므로 고정 출구가 필요한 서비스인지 확인해야 합니다.

정적 구성원은 proxies 아래에 이미 선언된 이름으로 작성합니다. 노드 레코드 전체를 그룹 안에 다시 넣는 것이 아닙니다. 제공자는 use 아래에 제공자 이름으로 작성하며 리소스 주소를 넣는 곳이 아닙니다. 노드 이름을 use에 넣거나 제공자 이름을 proxies에 넣는 것은 잘못된 참조 단계입니다. 설정을 옮길 때는 간단한 정적 그룹 하나로 참조를 먼저 검증한 뒤 제공자 구성원을 단계적으로 추가하세요.

아래 예시는 이전 장의 Local-SOCKS 노드를 재사용합니다. 원본 파일의 규칙 목록을 여기에 나온 규칙으로 바꾸고 그룹 정의를 최상위에 추가하세요. 이 예시에서는 수동으로 비교할 수 있도록 직결을 남겨 둡니다. 기본 매칭 규칙은 마지막에 작성해 지정한 도메인만 수동 그룹으로 들어가도록 합니다. 테스트할 때 두 항목을 각각 선택한 뒤 새 연결을 만들고 로그에서 최종 구성원이 선택에 따라 달라지는지 비교하세요.

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - Local-SOCKS
      - DIRECT
rules:
  - DOMAIN-SUFFIX,example.com,PROXY
  - MATCH,DIRECT

그룹 중첩은 자동 선택을 수동 입구 아래에 두는 데 적합합니다. 예를 들어 수동 그룹 하나에 자동 그룹과 고정 노드를 함께 넣을 수 있습니다. 참조 방향을 추적할 수 있어야 하며, A 그룹이 B 그룹을 참조하고 B 그룹이 다시 A 그룹을 참조하거나 자기 자신을 참조해서는 안 됩니다. 순환 참조가 발생하면 ‘바깥 그룹에서 안쪽 그룹을 가리키는’ 관계를 먼저 그려 보세요. 각 규칙 대상에서 노드 또는 내장 출구까지 따라가다가 이미 확인한 그룹이 다시 나타나면 구조를 바꿔야 합니다.

탐색 결과만으로 서비스 동작을 판단할 수 없습니다

앞의 수동 그룹을 주·대기 그룹으로 바꾸려면 아래 그룹 정의를 사용할 수 있습니다. 규칙은 같은 그룹 이름을 계속 참조합니다. interval의 단위는 초입니다. 예시는 공개 문서 도메인으로 탐색 항목의 작성법을 보여줍니다. 실제로 사용할 때는 기기에서 접근이 허용되고 응답이 안정적인 탐색 주소를 선택하고, 각 후보 출구에서 정상적으로 접속할 수 있는지 확인하세요. 이 탐색은 지정한 주소에 요청한 결과를 측정할 뿐 인터넷 전체의 사용 가능 여부를 측정하지 않습니다.

proxy-groups:
  - name: PROXY
    type: fallback
    proxies:
      - Local-SOCKS
      - DIRECT
    url: https://example.com/
    interval: 300

이 예시에서는 동작 비교를 위해 직결을 대체 경로로 사용합니다. 특정 서비스가 정해진 출구를 반드시 사용해야 한다면 이 그룹에 직결을 자동 대체 경로로 추가해서는 안 됩니다. 모든 후보를 사용할 수 없을 때는 서비스 요구사항에 맞게 실패를 처리해야 합니다. 사용 가능한 결과를 더 많이 표시하려고 서로 동등하지 않은 출구를 한 그룹에 섞지도 마세요. 그룹을 사용할 수 있는지는 연결 가능한 구성원이 있는지뿐 아니라 해당 구성원이 대상 접근 조건을 충족하는지에도 달려 있습니다.

url-test 그룹의 전환 허용 범위를 설정하면 탐색 시간이 조금씩 달라질 때 자주 전환되는 현상을 줄일 수 있습니다. 탐색 간격이 너무 짧으면 불필요한 요청이 늘고 일시적인 변동을 지속적인 차이로 오인하기 쉽습니다. 한 번의 테스트에서 특정 구성원이 느리게 나왔다면 그 변화가 계속되는지 먼저 확인한 뒤 실제 서비스에서 문제가 재현되는지 살펴보세요. 탐색은 성공했는데 앱이 실패한다면 주기를 줄이기 전에 두 요청의 도메인과 프로토콜, 최종 출구를 비교하세요.

제공자도 자체 상태 확인을 관리할 수 있습니다. 문제를 점검할 때는 ‘리소스에 어떤 구성원이 있는지’, ‘각 구성원의 탐색 상태’, ‘프록시 그룹이 현재 무엇을 선택했는지’를 구분하세요. 정책을 바꿔도 앱이 기존 세션을 유지하면 바로 결과가 달라지지 않을 수 있습니다. 클라이언트에서 선택 기억 기능을 켠 경우 설정을 다시 불러온 뒤 이전 구성원이 복원될 수도 있습니다. 필요하면 세션을 새로 만들고 해당 연결의 로그를 기준으로 확인하세요.

규칙 문법, 매칭 순서, 규칙 세트

첫 번째로 일치하는 규칙부터 확인하기

규칙 모드에서 코어는 목록 순서대로 규칙을 검사하고 처음 일치한 결과를 적용합니다. 일반적인 문법은 ‘유형, 조건, 대상’이며 일부 유형에는 옵션이 추가될 수 있습니다. MATCH에는 조건이 필요 없고 대상만 지정합니다. 범위가 넓은 규칙이 앞에 있으면 뒤의 구체적인 규칙은 매칭될 기회를 얻지 못할 수 있습니다. 따라서 예외를 일반 규칙보다 앞에 두고, 목록 끝의 기본 규칙이 기대한 동작과 일치하는지 확인하세요.

아래 예시는 원격 노드 없이 직결과 거부로 몇 가지 분기를 구분합니다. 정확히 일치하는 이름은 먼저 직결하고, 같은 도메인 접미사에 속하는 나머지 이름은 거부합니다. 대상이 루프백 주소인 연결은 주소 규칙에 일치하면 직결되고 나머지 요청은 기본 규칙으로 갑니다. 이 예시는 해당 코어에 들어온 요청에만 적용됩니다. 시스템 라우팅으로 직접 전송된 트래픽은 설정에 거부 규칙이 있다고 해서 차단되지 않습니다.

mode: rule
rules:
  - DOMAIN,example.com,DIRECT
  - DOMAIN-SUFFIX,example.com,REJECT
  - IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
  - MATCH,DIRECT

DOMAIN은 전체 도메인 이름을 검사합니다. DOMAIN-SUFFIX는 해당 도메인과 하위 도메인에 적용되며 문자열 끝부분을 임의로 찾는 규칙이 아닙니다. 특정 호스트 이름 하나에만 적용하려면 접미사 규칙으로 넓히지 마세요. 같은 최상위 도메인의 다른 서비스까지 영향을 받을 수 있습니다. DOMAIN-KEYWORD는 키워드 기준으로 매칭하므로 범위가 더 넓습니다. 해당 키워드가 포함된 다른 이름을 먼저 살펴본 뒤 사용 여부를 결정하세요.

IP-CIDR은 IPv4 주소 범위에 사용하고 IPv6에는 IP-CIDR6을 사용합니다. 대상 주소가 필요한 규칙의 경우 연결에 도메인만 전달되면 코어가 먼저 주소를 조회해야 할 수 있습니다. no-resolve는 해당 규칙만을 위해 추가 조회를 하지 않도록 하는 항목이며 요청에 이미 포함된 대상 주소를 지우지는 않습니다. 전역 DNS를 끄는 지시자로 사용하면 안 됩니다. 매칭에 해석 결과가 필요하다면 해당 규칙에서 조회를 허용하는지 확인한 다음 결과가 지정한 네트워크 범위에 속하는지 확인하세요.

GEOIP와 GEOSITE는 각각 코어가 읽을 수 있는 지리 기반 IP 데이터와 도메인 분류 데이터에 의존합니다. 해당 데이터에 정의된 분류를 나타낼 뿐, 특정 연결의 위치나 소속을 실시간으로 측정하지는 않습니다. 두 환경에서 서로 다른 데이터 파일을 사용하면 규칙 문구가 같아도 매칭 결과가 다를 수 있습니다. 이런 차이를 확인할 때는 데이터 출처와 클라이언트에서 활성화된 설정을 기록하세요. 사이트 하나의 동작만으로 분류 데이터 전체를 추측하지 마세요.

규칙 데이터와 처리 동작 분리하기

매칭 조건 여러 개를 독립적으로 관리하려면 rule-providers를 사용할 수 있습니다. 기본 파일에서는 RULE-SET으로 규칙 세트와 처리 동작을 지정하고, 리소스에는 조건만 선언합니다. 아래 로컬 예시는 도메인 목록을 사용해 지정한 도메인과 그 하위 도메인을 직결합니다. 파일을 만든 다음 설정을 불러오세요. 상대 경로는 편집기를 연 디렉터리가 아니라 코어의 작업 디렉터리를 기준으로 확인해야 합니다.

mode: rule
rule-providers:
  reference-domains:
    type: file
    behavior: domain
    format: yaml
    path: ./reference-domains.yaml
rules:
  - RULE-SET,reference-domains,DIRECT
  - MATCH,REJECT
payload:
  - '+.example.com'

이 예시의 마지막 규칙은 목록에 없는 대상을 거부합니다. 허용 범위를 의도적으로 테스트하는 설정에만 사용하고 평소 사용하는 규칙을 그대로 대체하지 마세요. behavior: domain은 도메인 형식의 조건을 받습니다. ipcidr은 주소 범위에, classical은 규칙 유형과 매개변수로 구성된 조건에 사용할 수 있습니다. DOMAIN-SUFFIX,example.com,DIRECT 전체를 도메인 목록에 넣거나 기본 파일에서 동작을 일괄 지정하는 조건에 출구 이름을 넣지 마세요.

연결 기록으로 매칭 근거 확인하기

대상이 기본 규칙에 들어갔다면 먼저 클라이언트 기록에 도메인 이름이 표시되는지 숫자 주소가 표시되는지 확인하세요. 앱이 직접 주소를 조회해 주소만 전달하면 도메인 조건에 사용할 정보가 없을 수 있습니다. 이 경우 규칙 순서만 조정해서는 해결되지 않습니다. 그다음 앞쪽에 범위가 넓은 규칙이 있는지 확인하고 마지막으로 규칙 세트 파일이 실제로 로드됐는지 살펴보세요. 연결 로그에 올바른 매칭 규칙이 표시되면 조건을 계속 바꾸지 말고 그룹 구성원과 출구를 확인하세요.

웹페이지 하나도 기본 문서, 정적 파일, 다른 서비스에 각각 연결하므로 연결마다 규칙을 따로 적용합니다. 기본 문서가 열렸다고 페이지의 모든 리소스가 같은 출구를 사용한다고 볼 수는 없으며, 일부 리소스가 실패했다고 최상위 도메인 전체의 규칙을 바꿔야 하는 것도 아닙니다. 실패한 연결 하나를 골라 대상, 매칭 규칙, 최종 구성원을 기록한 뒤 예외를 추가할지 결정하세요. 용어를 기준으로 항목을 찾으려면 용어 설명의 트래픽 분기 규칙 분류를 참고하세요.

덮어쓰기, 병합, 업데이트 후 변경 사항

먼저 병합을 수행하는 주체 확인하기

덮어쓰기는 클라이언트가 최종 설정을 생성하는 과정이며, 코어가 같은 이름의 키 두 개를 보고 자동으로 수행하는 일반적인 작업이 아닙니다. 클라이언트마다 맵, 목록, 빈 값의 병합 방식이 다를 수 있고 인터페이스 덮어쓰기와 스크립트 처리 기능을 각각 제공할 수도 있습니다. 수정하기 전에 어떤 기능을 사용하는지, 한 설정에만 적용되는지 모든 설정에 적용되는지 확인하세요. 타사 가이드의 덮어쓰기 전용 키를 기본 YAML에 코어 항목처럼 그대로 옮기면 안 됩니다.

변경 사항을 스칼라, 맵, 순서에 영향을 받는 목록으로 나눠 관리하는 것이 좋습니다. 포트와 모드는 보통 값 하나만 바꾸면 됩니다. DNS는 맵이므로 블록 전체를 덮어쓰면 기존 리졸버나 필터 항목이 사라질 수 있습니다. 규칙은 순서가 있는 목록이므로 추가, 앞에 삽입, 전체 교체의 결과가 다릅니다. 클라이언트가 ‘맵을 깊이 병합한다’고 안내하더라도 목록까지 추가한다고 단정할 수는 없습니다. 확인 대상은 덮어쓰기 파일의 줄 수가 아니라 실제로 출력된 설정입니다.

데이터 유형변경 예시확인할 결과
스칼라mixed-port를 사용 가능한 다른 포트로 변경최종 설정, 실제 리스닝 포트, 앱이 사용하는 포트가 일치합니다.
맵dns.enhanced-mode 변경필요한 리졸버와 정책 맵이 그대로 남아 있습니다.
순서가 있는 목록rules에 예외 추가예외가 적용 범위를 포함하는 기존 규칙보다 앞에 있습니다.
객체 목록proxy-groups에 그룹 하나 추가기존 그룹이 유지되고 이름이 고유하며 모든 구성원 참조가 유효합니다.

아래에는 수정 전후의 전체 파일을 보여줍니다. 혼합 포트를 변경하고 예시 도메인이 기본 규칙보다 먼저 거부되도록 하는 것이 목표입니다. 특정 클라이언트의 패치 문법에 의존하지 않고 직접 병합한 결과입니다. 클라이언트에서 같은 내용을 생성할 수 있더라도 출력에 규칙이 하나만 있는지, 예외가 첫 번째에 있는지, 기존 모드와 리스닝 범위가 바뀌지 않았는지 확인하세요.

mixed-port: 7890
allow-lan: false
mode: rule
rules:
  - MATCH,DIRECT
mixed-port: 7892
allow-lan: false
mode: rule
rules:
  - DOMAIN-SUFFIX,example.com,REJECT
  - MATCH,DIRECT

클라이언트가 새 규칙을 기존 목록에 추가하는 기능만 지원한다면 앞의 예시에서 추가한 규칙은 MATCH 뒤에 놓여 매칭되지 않습니다. 앞에 삽입할 수 있는 기능을 사용하거나 전체 규칙 목록을 정리해 통째로 교체하세요. 전체 교체를 선택하면 유지 관리도 직접 해야 합니다. 구독에 새로 추가된 중요 규칙이 사용자 지정 목록에 자동으로 포함되지는 않습니다. 업데이트 후에는 설정이 여전히 시작되는지만 확인하지 말고 상위 규칙과 다시 비교하세요.

이름 변경, 빈 값, YAML 병합 키

프록시 그룹을 추가하기 전에 이름이 충돌하지 않는지 확인하세요. 덮어쓰기 도구가 이름을 기준으로 객체를 병합하면 같은 이름의 그룹이 기존 그룹을 대체할 수 있습니다. 객체만 추가한다면 로드할 수 없는 중복 그룹이 생길 수도 있습니다. 노드, 그룹, 제공자를 삭제하기 전에는 해당 항목을 참조하는 곳을 모두 검색하세요. 규칙 대상이 기존 그룹 이름이고 같은 이름의 그룹과 유효한 구성원을 유지한다면 모든 규칙을 함께 바꿀 필요는 없습니다. 그룹 자체를 삭제한다면 참조를 다른 대상으로 옮겨야 합니다.

빈 값이 포함된 항목도 구분해야 합니다. 키 뒤를 비워 두면 보통 null로 파싱되며, 이는 ‘기존 값을 유지’한다는 뜻이 아닙니다. 빈 목록도 자동으로 ‘수정하지 않음’을 의미하지 않습니다. 덮어쓰기 도구는 이를 비우기, 교체, 잘못된 입력으로 처리할 수 있으며 지원되지 않는 경우 거부할 수도 있습니다. 구독의 특정 항목을 그대로 유지하려면 보통 덮어쓰기 파일에서 해당 항목을 생략한 뒤 최종 파일을 확인해야 합니다. 확인되지 않은 병합 의도를 빈 값으로 표현하지 마세요.

YAML 앵커와 별칭은 단일 YAML 문서를 파싱하는 범위에서만 사용할 수 있습니다. 별도의 덮어쓰기 파일이 구독 원본에 있는 앵커를 공유하게 만들 수는 없습니다. 일부 파서는 << 병합 키를 지원하지만 주로 맵 병합에 사용하며 규칙 목록을 이어 붙이는 연산은 아닙니다. 클라이언트가 읽고 다시 출력하는 과정에서 이런 표기가 펼쳐지거나 달라질 수도 있습니다. 여러 클라이언트에서 유지 관리한다면 단순한 구조를 우선 사용하고 최종 내보내기 결과인 일반 YAML을 기준으로 확인하세요.

구독 업데이트를 설정 다시 생성 과정으로 보기

구독을 업데이트하기 전에 마지막으로 사용했던 최종 설정과 로컬 덮어쓰기를 따로 보관하세요. 업데이트 후에는 최상위 포트와 DNS 맵을 비교하고 노드, 그룹, 규칙의 참조 관계를 확인한 다음 같은 대상으로 다시 테스트하세요. 업데이트 때문에 문제가 생겼다면 먼저 덮어쓰기를 잠시 끄고 원본 설정을 검증한 뒤 로컬 변경 사항을 하나씩 다시 적용하세요. 이렇게 하면 원본 데이터 변경, 클라이언트 병합 변경, 런타임 선택 변경을 구분할 수 있습니다.

다른 클라이언트로 옮길 때도 의미를 확인할 수 있는 코어 항목만 가져오세요. 같은 mihomo 코어를 사용하더라도 클라이언트 인터페이스별 덮어쓰기 순서가 같거나 설정 디렉터리와 제공자 경로가 같은 것은 아닙니다. 기존 설정을 mihomo로 옮겨야 한다면 mihomo 코어와 원본 Clash의 항목 차이를 참고한 뒤 대상 클라이언트가 실제로 사용하는 코어와 설정 위치를 확인하세요.

설정 검증, 연결 확인, 자주 묻는 문제

파일을 먼저 검증한 뒤 실행 상태 확인하기

문제 해결을 시작할 때는 정상 작동이 확인된 설정을 보관하고 테스트할 파일은 다른 이름으로 저장하세요. 그래픽 클라이언트에서는 현재 선택한 설정과 덮어쓰기 후 실행에 사용되는 설정을 확인합니다. 독립 코어를 사용한다면 파일 경로와 작업 디렉터리를 명시하세요. 한 시스템에 설치 경로가 여러 개라면 터미널에서 실행하는 바이너리와 인터페이스가 실제 사용하는 코어가 같은지도 확인해야 합니다. 서로 다른 코어를 사용한다면 한쪽의 테스트가 통과하고 다른 쪽에서 로드가 실패해도 모순이 아닙니다.

아래 명령은 터미널에서 mihomo를 실행할 수 있는 환경을 대상으로 합니다. 현재 디렉터리에 config.yaml이 있다고 가정합니다. 작업 디렉터리에서 설정이 참조하는 데이터와 로컬 리소스를 읽을 수 있어야 합니다. 테스트 통과는 이번 설정 검사를 코어가 완료했다는 뜻일 뿐, 모든 리스닝 포트가 바인딩되거나 리졸버에 연결되거나 노드의 프로토콜 핸드셰이크가 성공했다는 의미는 아닙니다.

mihomo -t -d . -f ./config.yaml

오류가 발생하면 단계별로 범위를 좁히세요. 구문 오류는 오류가 표시된 줄과 바로 앞 레코드에서 콜론 누락, 잘못된 들여쓰기, 닫히지 않은 따옴표를 확인합니다. 참조 오류라면 그룹, 노드, 제공자 이름을 확인하고 리소스 오류라면 작업 디렉터리, 경로, 파일 구조를 확인하세요. 파일 이름, 규칙, 구독 주소를 한꺼번에 바꾸지 마세요. 수정할 때마다 같은 검사를 반복해 오류 단계가 넘어간 것을 확인한 다음 다음 항목으로 진행하세요.

입구, 매칭, 출구 순서로 다시 테스트하기

시작한 뒤 먼저 로컬 리스닝 상태를 확인하고 프록시 입구를 명시해 간단한 요청을 보내세요. 아래 명령은 혼합 포트가 127.0.0.1:7890에서 리스닝 중이고 현재 정책이 대상 접근을 허용한다고 가정합니다. 앞에서 포트 덮어쓰기 예시를 적용했다면 명령의 포트도 함께 바꾸세요. 거부 규칙을 테스트 중이라면 요청이 거부되는 것이 예상된 결과일 수 있습니다. 요청 실패만으로 입구가 작동하지 않는다고 판단하지 마세요.

curl --noproxy "" --proxy http://127.0.0.1:7890 \
  --max-time 15 --head https://example.com/

위의 줄 연속 문자는 일반적인 Unix 계열 명령줄 환경에서 사용합니다. 해당 문자를 지원하지 않는 터미널에서는 명령을 한 줄로 작성하고 실제 설치된 curl 프로그램을 사용하세요. --noproxy ""는 이번 명령에서 프록시 우회 목록을 비워 입구를 확인하기 쉽게 합니다. 대상 서버의 응답을 받았다고 해서 모든 앱이 시스템 프록시를 사용하는 것은 아닙니다. 이 테스트는 명시적으로 지정한 경로만 확인하며 인터페이스 아이콘 상태에는 의존하지 않습니다.

새 연결 기록이 없다면 올바른 프록시 프로토콜, 주소, 포트를 사용했는지와 앱이 프록시를 우회하는지 확인하세요. 기록은 있지만 매칭 규칙이 잘못됐다면 당시의 모드, 요청이 코어에 전달된 대상 형식, 규칙 순서를 점검합니다. 매칭과 선택이 모두 올바르면 출구 핸드셰이크, 노드 도메인 해석, 대상 서비스의 응답을 확인하세요. 대상, 모드, 매칭 항목, 최종 구성원을 매번 기록하면 ‘연결되지 않음’만 기록하는 것보다 문제를 훨씬 쉽게 찾을 수 있습니다.

모든 노드가 시간 초과되는 경우와 노드 하나만 시간 초과되는 경우는 따로 판단해야 합니다. 모두 실패하면 공통 구독, 입구, DNS 해석, 로컬 네트워크 조건부터 확인하세요. 노드 하나만 문제라면 같은 입구와 대상을 유지한 채 다른 구성원과 비교할 수 있습니다. 점검을 마치기 전에 여러 옵션을 동시에 자주 바꾸지 마세요. 증상별로 계속 확인하려면 노드 시간 초과 문제 해결 순서를 참고하고, 시스템 연결을 다시 설정해야 한다면 빠른 시작 가이드로 돌아가세요.

자주 발생하는 설정 문제

설정을 불러왔는데 클라이언트가 이전 포트를 계속 사용하는 이유는 무엇인가요?

먼저 인터페이스에 표시되는 새 포트가 최종 설정에 반영됐는지 확인한 다음 설정을 다시 불러왔는지와 실제로 바인딩됐는지 살펴보세요. 코어는 새 포트에서 리스닝하지만 앱이 이전 포트로 요청을 보낸다면 시스템 프록시, 앱의 프록시 설정, 터미널 환경 변수를 함께 변경해야 합니다. 이전 포트에서 여전히 서비스가 응답한다면 다른 인스턴스가 실행 중인지 확인해 이전 인스턴스의 로그를 이번 테스트 결과로 오인하지 않도록 하세요.

규칙이 올바른 그룹에 매칭됐는데 결과가 예상과 다른 이유는 무엇인가요?

그룹 이름은 선택 정책의 입구를 나타낼 뿐입니다. 수동 그룹은 이전 선택을 복원할 수 있고, 주·대기 그룹은 대체 구성원을 선택할 수 있으며, 자동 그룹은 탐색 결과에 따라 다른 항목을 선택할 수 있습니다. 먼저 해당 연결이 최종적으로 어떤 구성원을 사용했는지 확인한 뒤 그룹의 구성원이 용도에 맞는지 살펴보세요. 선택을 바꾼 뒤에는 새 연결로 다시 테스트해야 합니다. 기존 연결을 재사용하는 앱에서는 변경 사항이 바로 나타나지 않을 수 있습니다.

YAML을 복원했는데 시스템 네트워크가 이전 상태로 돌아오지 않는 이유는 무엇인가요?

시스템 프록시, 가상 인터페이스, 라우팅, 운영체제의 DNS 설정은 각각 해당 시스템 기능이나 클라이언트가 관리합니다. 설정 파일 하나를 덮어쓴다고 자동으로 해제되지는 않습니다. 클라이언트 인터페이스에서 처음 활성화했던 연결 기능을 필요에 따라 끄고, 시스템에서 현재 어떤 설정을 사용 중인지 확인한 뒤 새 요청으로 검증하세요. 이전 설정을 복원하기 전후로 문제가 계속 재현된다면 시스템 수준의 상태와 코어 설정 문제를 구분해야 합니다.