고급 설정 / 가이드

V2Ray 고급 설정 가이드

구독 업데이트부터 아웃바운드 선택까지, 트래픽 흐름을 따라 문제를 찾아보세요.

처음 사용한다면 먼저 빠른 시작 가이드에 따라 설정을 가져오고 연결 및 작동을 확인한 뒤, 이 페이지로 돌아와 고급 옵션을 조정하세요. 이 페이지는 주제별 참고 자료이며 모든 기능을 순서대로 켤 필요는 없습니다. 데스크톱에서는 v2rayN을, 안드로이드에서는 필요한 코어에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 자세한 내용은 클라이언트 안내를 참고하세요. 아래에서는 클라이언트 메뉴, 시스템 설정, 코어 설정 항목을 구분합니다. 메뉴 이름과 지원 범위는 사용 중인 클라이언트 버전을 기준으로 확인하세요.

구독 그룹 및 서버 필터링

가져오는 범위와 표시 범위를 구분하세요

구독 그룹은 설정의 출처를 구분하는 기능입니다. 보통 한 그룹은 구독 주소 하나와 해당 주소를 업데이트해 가져온 설정 목록에 해당합니다. 그룹을 선택해도 목록에 표시되는 범위만 바뀔 뿐, 현재 연결 대상이나 코어의 라우팅 규칙은 변경되지 않습니다. v2rayNG에서는 ‘구독 그룹 설정’에서 그룹을 추가하고 메모와 주소를 입력해 저장한 다음, 구성 파일 목록으로 돌아가 업데이트할 수 있습니다. v2rayN에서는 구독 그룹 메뉴에서 그룹 설정을 엽니다. 현재 그룹 업데이트를 지원하는 화면에서는 대상 그룹을 선택한 뒤 해당 그룹만 업데이트하세요. 모든 출처를 업데이트할 때만 전체 업데이트를 선택하면 됩니다. v2flyNG의 그룹 및 필터 기능은 현재 화면에서 확인하세요. 다른 클라이언트의 메뉴 이름을 기준으로 같은 설정을 찾지 마세요.

가져온 뒤 목록에 예상한 설정이 표시되는지 먼저 확인한 다음, 연결할 항목을 직접 선택하세요. 업데이트 과정에서 관리 대상 설정이 다시 생성될 수 있어 기존 선택 항목이 같은 이름의 새 항목으로 바뀌거나 목록에서 사라질 수 있습니다. 상단에 표시된 그룹 이름만으로는 실제 실행 중인 설정을 확인할 수 없습니다. 연결 시 선택한 항목과 로그를 기준으로 확인하세요. 설정 메모가 같다면 프로토콜, 전송 방식, 포트를 로컬에서 비교하면 됩니다. 서버 주소나 구독 주소를 외부 문제 해결 페이지에 복사할 필요는 없습니다.

필터가 적용되는 위치를 구분하세요

먼저 입력란이 어디에 있는지 확인하세요. 구성 목록의 검색창은 보통 현재 표시 범위만 좁힙니다. 검색어를 지우면 항목이 다시 나타나야 합니다. 반면 구독 그룹 설정의 필터 조건은 업데이트할 때 로컬 그룹에 가져올 항목을 결정할 수 있습니다. 이 필터는 변경 후 다시 업데이트해야 결과를 확인할 수 있으며 기존 목록에도 영향을 줄 수 있습니다. 문제를 살펴볼 때는 먼저 목록 검색어를 지우고, 대상 그룹으로 전환한 뒤 해당 그룹의 가져오기 조건을 확인하세요. 세 위치를 한꺼번에 바꾸면 항목이 저장되지 않은 것인지, 다른 그룹에 접혀 있는 것인지, 검색창에 숨겨진 것인지 구분하기 어렵습니다.

설정 안내에 정규식을 사용할 수 있다고 명시된 경우에만 필터 입력란에 정규식을 넣으세요. 예를 들어 제공업체가 테스트 항목의 메모를 모두 Lab-로 시작하도록 했다면 아래 표현식으로 해당 접두사를 찾을 수 있습니다. 이 표현식은 구독 주소나 라우팅 규칙이 아닙니다. 먼저 결과를 아는 메모 두 개로 확인하세요. 하나는 일치하고 다른 하나는 일치하지 않아야 합니다. 그런 다음 화면이 일치 항목을 남기는지 제외하는지 확인하세요. 대소문자를 구분하는 구현에서는 소문자로 시작하는 메모가 일치하지 않습니다. 제공업체가 메모 형식을 바꾸면 정규식 자체는 유효해도 어떤 항목과도 일치하지 않을 수 있습니다.

^Lab-

가져오기 실패와 필터 적용 후 빈 목록을 구분하세요

업데이트에 실패하면 클라이언트가 해석 가능한 구독 내용을 받았는지부터 확인하세요. 요청 시간 초과, 인증서 오류, 권한 거부는 가져오기 단계의 문제입니다. 요청은 성공했지만 항목이 하나도 추가되지 않았다면 로그인 페이지가 반환됐거나, 응답 형식이 현재 클라이언트의 파서와 맞지 않거나, 필터 조건이 모든 항목을 제외했을 수 있습니다. 먼저 업데이트 로그에서 요청 오류를 확인한 뒤, 현재 그룹의 필터 조건을 잠시 지우고 해당 그룹만 다시 업데이트하세요. 항목이 나타나면 필터 설정으로 돌아가 조건을 좁히세요. 여전히 항목이 없다면 주소가 만료됐는지, 제공업체가 준 것이 구독 주소인지 단일 설정 링크인지 또는 다른 도구용 파일인지 확인하세요.

일부 클라이언트에서는 구독 요청을 직접 연결할지 현재 프록시를 통할지 지정할 수 있습니다. 기존 연결은 되지만 업데이트만 실패한다면 두 요청 경로로 구독 서버에 접속할 수 있는지 비교하세요. 사용할 수 있는 설정이 전혀 없을 때 현재 프록시를 통해 업데이트하려 하면 순환 문제가 생길 수 있습니다. 먼저 사용할 수 있는 연결 경로를 하나 복구한 뒤, 구독 업데이트를 해당 경로로 고정할지 결정하세요. 업데이트 성공은 다운로드와 파싱이 끝났다는 뜻일 뿐, 가져온 모든 설정으로 연결할 수 있다는 의미는 아닙니다. 다음 단계에서는 지원 여부를 확인한 항목 하나를 골라 연결을 테스트하세요. 기본 연결 확인을 여러 항목의 일괄 속도 측정으로 대신하지 마세요.

비교용 설정을 남겨 두세요

기존 그룹의 필터 조건을 바꾸기 전에 원래 설정을 기록하고, 연결을 확인한 로컬 설정 하나를 남겨 두세요. 실제 사용 그룹을 실험용으로 바로 바꾸거나, 구독 주소가 포함된 오류 화면을 공유하지 마세요. 화면에서 뒷부분이 가려져 있어도 링크는 인증 정보처럼 취급해야 합니다.

라우팅 규칙 활용

요청이 코어에 전달되는지 먼저 확인하세요

라우팅은 코어에 도달한 연결만 처리합니다. 데스크톱에서 시스템 프록시만 켠 경우 시스템 프록시 설정을 따르지 않는 프로그램은 코어에 도달하지 않을 수 있습니다. 안드로이드에서 앱별 프록시를 사용하면 제외한 앱도 이 규칙으로 처리되지 않습니다. 문제를 확인하기 전에 클라이언트를 반드시 거치는 앱 하나를 정하고, 로그에 해당 요청이 표시되는지 확인하세요. 요청 자체가 로그에 없다면 도메인 정책부터 바꾸지 마세요. 시스템 프록시, 앱 자체의 프록시 설정, VPN 권한 또는 앱이 선택 목록에 포함됐는지 확인하세요. 트래픽이 들어오는 경로를 확인한 다음 규칙이 일치하지 않는지, 잘못된 아웃바운드가 선택됐는지 살펴보세요.

규칙 순서와 기본 경로

Xray의 순차 라우팅 규칙에서는 먼저 일치하는 규칙이 요청 처리 방식을 결정하며, 더 구체적인 규칙을 찾아 계속 내려가지 않습니다. 정확한 도메인, 명확한 사설 네트워크 대역 또는 특정 인바운드에 대한 예외는 범위가 넓은 규칙보다 앞에 두세요. 한 규칙에 도메인과 포트처럼 서로 다른 필드를 함께 지정하면 일반적으로 모든 조건을 만족해야 합니다. 어느 하나만 맞아도 적용되는 방식이 아닙니다. ‘이 도메인에 속하거나 이 주소 대역에 포함되는 경우’를 처리하려면 같은 아웃바운드로 연결되는 규칙을 각각 작성하세요. 어떤 규칙에도 일치하지 않으면 보통 아웃바운드 목록의 첫 항목이 사용됩니다. 그래픽 인터페이스에서 규칙을 자동으로 추가하거나 목록을 재구성할 수 있으므로 실제 우선순위는 적용된 설정을 기준으로 판단하세요.

자주 쓰는 도메인 및 주소 조건
조건의미사용 시 주의점
full:example.com정확히 일치하는 도메인하위 도메인은 일치하지 않습니다.
domain:example.com해당 도메인과 하위 도메인 일치같은 도메인 트리를 동일한 경로로 보내는 데 적합합니다.
192.168.50.0/24지정된 IPv4 대역 일치실제 네트워크 대역을 기준으로 하세요. 로컬 네트워크가 항상 고정된 접두사를 사용한다고 가정하지 마세요.
geoip:private규칙 데이터에 포함된 사설 주소 집합 일치현재 규칙 리소스와 포함 범위에 따라 달라집니다.

도메인 정책을 선택한 뒤 양방향으로 테스트하세요

AsIs는 주소 기반 규칙에 맞추기 위해 대상 도메인을 직접 조회하지 않습니다. IPIfNonMatch는 도메인으로 라우팅 규칙을 판단할 수 없을 때 주소를 조회한 뒤 주소 기반 규칙과 다시 비교할 수 있습니다. 다만 그 전에 범위가 넓은 규칙과 일치했다면 뒤에 있는 주소 규칙으로는 결과를 바꿀 수 없습니다. IPOnDemand는 규칙 평가 중 주소가 필요한 조건을 만나면 도메인을 조회하므로 DNS가 사용될 가능성이 커집니다. 세 옵션 모두 ‘모든 앱이 코어 DNS를 강제로 사용’하게 하는 설정이 아니며, 아웃바운드 연결의 주소 체계를 정하는 옵션도 아닙니다. 명확한 도메인 규칙 하나로 해결할 수 있다면 분할 라우팅을 위해 관련 요청을 모두 미리 조회할 필요는 없습니다.

다음은 Xray 최상위 routing 객체의 예시입니다. 기존 설정에 병합해야 하며, 아웃바운드 목록에 direct라는 이름의 아웃바운드가 있어야 합니다. 테스트 앱에만 적용하려면 인바운드 태그를 추가로 지정하세요. 이 조각만으로 완전한 설정을 만들어 실행해서는 안 됩니다. 예시의 네트워크 대역은 실제로 접속할 수 있는 테스트 대역으로 바꾸세요. 로컬 네트워크 조건을 사용하지 않는다면 두 번째 규칙을 삭제해 범위가 불분명한 규칙을 남기지 마세요.

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.com"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["192.168.50.0/24"],
        "outboundTag": "direct"
      }
    ]
  }
}

확인할 때는 최소 세 종류의 요청을 테스트하세요. 일치해야 하는 정확한 도메인, 같은 도메인 아래에서 일치하지 않아야 하는 하위 도메인, 네트워크 대역 규칙과 일치해야 하는 주소입니다. 하위 도메인에 실제 웹페이지가 없어도 됩니다. 아웃바운드 기록으로 라우팅 결과를 확인할 수 있으므로 접속 결과나 도메인 존재 여부를 규칙의 결론으로 삼지 마세요. 도메인 요청이 로그에 항상 IP 주소로만 표시된다면 앱이 미리 주소를 조회했는지 확인한 뒤, 해당 인바운드에서 ‘트래픽 스니핑 사용’이 적용되는지 확인하세요. 스니핑은 지원되는 식별 가능한 트래픽에서 제한된 대상 정보를 복원할 뿐, 모든 연결에서 도메인을 확인할 수 있게 보장하지 않습니다. 규칙은 일치했는데 페이지가 열리지 않으면 아웃바운드 연결과 대상 포트를 확인하세요. 규칙 순서를 계속 바꿀 필요는 없습니다.

DNS 설정 최적화

누가 질의하고 누가 응답하는지 먼저 확인하세요

한 번의 접속에도 여러 단계의 DNS 조회가 있을 수 있습니다. 앱은 시스템 리졸버를 호출할 수도 있고 자체 암호화 DNS를 사용할 수도 있습니다. 코어는 라우팅 판단을 위해 도메인을 조회할 수도 있고, 원격 아웃바운드가 처리하도록 도메인을 그대로 전달할 수도 있습니다. 프록시 서버 자체의 도메인도 연결을 시작하기 전에 조회해야 합니다. DNS 설정 하나를 바꿔도 다른 단계까지 자동으로 바뀌지는 않습니다. 먼저 문제가 한 브라우저에만 있는지, 클라이언트로 들어가는 모든 앱에서 발생하는지, 클라이언트 자체의 서버 도메인도 조회할 수 없는지 기록하세요. 각각 앱의 DNS 조회, 코어의 DNS 조회, 연결 전 초기 조회를 우선 확인해야 합니다.

데스크톱에서 v2rayN 시스템 프록시 모드를 쓸 때 터미널과 브라우저가 같은 프록시 및 DNS 동작을 사용한다고 가정하지 마세요. 안드로이드에서도 시스템의 ‘비공개 DNS’와 클라이언트의 ‘로컬 DNS 사용’ 같은 옵션을 구분해야 합니다. 이름은 비슷해도 적용되는 위치가 다릅니다. VPN을 켰을 때 앱의 DNS 조회까지 처리되는지는 앱이 VPN에 포함됐는지, 시스템이 제공하는 DNS 설정, 앱이 별도로 암호화 DNS를 요청하는지에 따라 달라집니다. 진단할 때는 테스트 앱 하나에서 자동 설정과 사용자 지정 DNS를 잠시 비교하고, 테스트가 끝나면 원래 설정으로 되돌리세요. 시스템 전체 설정을 먼저 영구적으로 끌 필요는 없습니다.

용도에 맞는 리졸버를 선택하세요

가정이나 사무실 기기의 도메인을 조회해야 한다면 해당 영역의 레코드를 실제로 관리하는 리졸버를 우선 사용하세요. 모두 공용 리졸버로 바꾸면 라우팅에서 내부 주소를 직접 연결하도록 허용했더라도 내부 도메인을 조회하지 못할 수 있습니다. 반대로 공용 도메인을 내부 도메인에만 응답하는 서버로 보내도 시간 초과가 발생할 수 있습니다. Xray 내장 DNS에서는 서버 항목의 domains를 지정해 우선 조회할 도메인 범위를 정할 수 있습니다. 실패할 때 다른 서버로 재시도하는지도 함께 고려해야 합니다. 도메인 범위만 설정한다고 조회가 완전히 분리되는 것은 아닙니다. 내부 도메인은 반드시 내부 리졸버에만 전달해야 한다면 대체 조회 설정과 각 클라이언트의 코어 동작도 함께 확인하세요.

HTTPS 기반 리졸버를 사용할 때는 리졸버에 연결하기 위해 필요한 도메인을 어떻게 조회할지도 확인하세요. 첫 조회가 아직 연결되지 않은 동일한 서비스에 의존하면 시작 단계에서 순환이 발생할 수 있습니다. 리졸버에 접속하려면 특정 프록시 아웃바운드가 필요한데, 프록시 서버 주소는 다시 해당 리졸버가 있어야 조회할 수 있는 경우에도 프록시와 DNS가 서로 대기하게 됩니다. 일반적인 서비스 도메인을 처리하기 전에 연결에 앞서 조회해야 하는 서비스에 독립적으로 도달할 수 있는 초기 조회 경로를 마련하세요. 이 순서 문제를 여러 상위 서버를 추가해 덮으려 하지 마세요. 캐시가 남아 있을 때만 정상처럼 보일 수 있습니다.

주소 결과와 연결 가능 여부를 따로 확인하세요

nslookup을 사용할 수 있는 데스크톱 환경에서는 먼저 시스템 DNS 경로로 조회한 주소를 확인할 수 있습니다. 아래 명령은 IPv4와 IPv6 레코드를 각각 확인합니다. 이 결과만으로 코어가 같은 도메인에서 같은 주소를 받았다고 볼 수는 없습니다. 코어의 동작을 비교하려면 요청이 코어에 들어가는지 확인한 뒤 새 연결을 만들어 해당 DNS 또는 아웃바운드 로그를 살펴보세요. 설정을 바꿀 때마다 대상을 바꾸지 말고, 같은 테스트 도메인에서 반환된 레코드 유형, 소요 시간, 오류 메시지를 기록하세요.

nslookup -type=A example.com
nslookup -type=AAAA example.com

듀얼 스택 환경에서 연결할 수 없는 IPv6 주소를 먼저 시도하는 경우가 잦다면, 조회 시간 초과가 아니라 주소 체계의 연결성 문제인지 IPv4와 IPv6의 실제 연결 결과를 비교하세요. 코어가 지원하는 queryStrategy는 내장 DNS가 조회할 주소 유형을 제한할 수 있지만, 시스템 전체의 IPv6 설정을 바꾸거나 앱이 직접 사용하는 IPv6 리터럴 주소를 차단하지는 않습니다. 적용 범위가 한정된 설정으로 사용하세요. 같은 도메인을 두 조회 위치에서 조회했을 때 주소가 다르더라도 곧바로 오류라고 판단할 수는 없습니다. 캐시, 지역별 응답, 네트워크에 따른 차이로 결과가 달라질 수 있습니다. 실제 연결이 성립하는지, 반환된 주소가 예상 네트워크에 속하는지를 기준으로 판단하세요.

DNS 조회 단계는 한 번에 하나씩 바꾸세요

기존 상위 DNS 서버와 도메인 조건을 먼저 저장한 뒤 한 항목만 바꾸세요. 새 연결로 다시 테스트하고, 필요하면 테스트 앱을 재시작해 앱 캐시 문제와 설정 미적용을 구분하세요. 조회 실패와 조회 성공 후 연결 실패를 따로 기록하고, 모두 ‘DNS 오류’로 묶지 마세요.

TUN 모드와 시스템 트래픽 가로채기

모드를 바꾸는 이유부터 확인하세요

시스템 프록시는 프록시 설정을 읽는 데스크톱 프로그램에 적합합니다. TUN은 가상 네트워크 인터페이스와 시스템 라우팅을 통해 트래픽을 받아, 프록시 설정을 읽지 않는 일부 앱까지 처리해야 할 때 사용합니다. 달라지는 것은 트래픽이 프록시 체인으로 들어오는 방식이지, 모든 연결을 현재 아웃바운드로 전달할 수 있다는 뜻은 아닙니다. 예를 들어 앱에서 UDP 트래픽이 발생해 가상 인터페이스로 들어와도 접속 단계만 확인된 것입니다. 이후 전달 여부는 트래픽 가로채기 구성 요소, 라우팅, 아웃바운드 프로토콜, 서버 지원에 따라 달라집니다. 대상 앱이 이미 시스템 프록시로 작동한다면 현재 모드를 유지하는 편이 문제 위치를 파악하기 쉽습니다.

v2rayN에서는 먼저 시스템 프록시를 변경하거나 가상 네트워크 어댑터를 만드는 다른 도구를 끄세요. 선택한 설정이 기존 모드에서 작동하는지 확인한 다음, 메인 화면에서 ‘TUN 모드’ 스위치를 찾아 시스템 안내에 따라 권한을 허용하세요. 가상 인터페이스를 만들고 라우팅을 바꾸려면 추가 권한이 필요할 수 있습니다. 구체적인 권한과 클라이언트 지원 여부는 플랫폼과 설정에 따라 다릅니다. 안드로이드에서는 Android VpnService를 통해 앱이 지정된 트래픽을 가로챈다고 이해해야 하며, 데스크톱의 네트워크 어댑터 설정을 그대로 적용해서는 안 됩니다. 처음 연결할 때 시스템 권한을 허용해야 합니다. 특정 앱만 처리되지 않으면 먼저 ‘앱별 프록시’ 목록과 우회 모드를 확인한 뒤 권한 및 앱별 프록시 안내를 참고하세요.

플랫폼별로 트래픽 가로채기가 설정됐는지 확인하세요
플랫폼 및 클라이언트먼저 확인할 항목다음으로 확인할 항목
Windows · v2rayN권한 안내, 가상 인터페이스 상태, 기존 VPN스위치를 켜기 전후의 라우팅과 대상 앱 기록을 비교하세요.
macOS / Linux · v2rayN현재 배포판에서 해당 메뉴를 제공하는지와 시스템 권한트래픽 가로채기가 설정됐는지 확인하고 로컬 및 외부 대상을 테스트하세요.
Android · v2rayNG / v2flyNG시스템 VPN 권한과 트래픽을 가로챌 수 있는 앱 범위목록에 포함된 앱과 제외된 앱으로 각각 접속을 테스트하세요.

라우팅 루프와 범위 충돌을 구분하세요

전환 직후 인터넷이 끊기면 먼저 TUN을 꺼서 기존 모드가 복구되는지 확인하세요. 끄면 복구되고 켠 상태에서 같은 서버로 반복해서 연결을 시도한다면 아웃바운드 연결이 다시 가상 인터페이스로 들어가는지 살펴보세요. 많은 클라이언트는 자체 연결이 우회하도록 설정하지만 여러 네트워크 어댑터, 실행 중인 다른 VPN, 수동으로 설정한 기본 경로가 이 전제를 깨뜨릴 수 있습니다. 시스템 기본 경로를 바로 삭제하지 마세요. 서로 충돌하는 트래픽 가로채기 도구를 먼저 중지하고 자동 설정 하나만 복구한 다음, 트래픽 가로채기 구성 요소에서 물리 인터페이스로 나가야 하는 연결을 확인하세요.

외부 웹페이지는 정상인데 같은 네트워크의 기기만 연결되지 않는다면 기기에 설정된 로컬 주소와 실제 서브넷을 먼저 비교하세요. ‘우회’에는 두 가지가 있습니다. 시스템 라우팅이 특정 네트워크 대역을 가상 인터페이스에 넣지 않는 경우, 코어 라우팅이 가상 인터페이스로 들어온 요청을 직접 연결 아웃바운드로 보내는 경우입니다. 코어의 직접 연결 규칙은 요청이 코어에 들어온 경우에만 의미가 있으며, 시스템에서 앱을 미리 다른 경로로 보내거나 잘못된 인터페이스를 할당한 문제는 해결할 수 없습니다. 반대로 시스템 계층에서 어떤 범위를 통째로 제외하면 코어 로그에 해당 요청이 표시되지 않습니다. 화면에 ‘우회됨’이라고 표시된 것만으로 어느 계층에서 처리됐는지 판단하지 마세요.

서로 독립적인 세 가지 회귀 테스트를 수행하세요

첫 번째로 외부 웹페이지에 새로 연결해 일반 접속과 DNS 조회가 되는지 확인하세요. 두 번째로 실제로 존재하는 로컬 네트워크 서비스를 열어 트래픽 가로채기가 내부 경로를 바꾸지 않았는지 확인하세요. 세 번째로 기존에는 시스템 프록시를 따르지 않았던 대상 앱을 사용해 전환의 원래 목적이 달성됐는지 확인하세요. UDP가 필요하다면 해당 기능을 대상 앱 자체에서 테스트하세요. 브라우저에서 일반 웹페이지가 열린다는 것으로 대신하면 안 됩니다. 유선에서 무선으로, 무선에서 모바일 네트워크로 바꾸면 기본 게이트웨이와 주소 체계가 달라질 수 있으므로 필요한 테스트를 다시 실행하세요. 이전에 올바르던 제외 범위가 그대로 적용되지 않을 수 있습니다.

원래 설정으로 되돌리려면 클라이언트 스위치로 트래픽 가로채기를 먼저 중지하고, 기존 시스템 프록시 설정과 로컬 접속이 복구됐는지 확인하세요. 종료하기 전에 최초 오류를 간단히 기록하세요. 권한 거부, 인터페이스 생성 실패, 라우팅 설정 실패, 실행 후 전달 실패를 구분하는 것이 중요합니다. 안드로이드 시스템 설정에서 특정 VPN을 항상 사용하도록 지정했다면 클라이언트를 중지해도 직접 연결로 돌아오지 않을 수 있습니다. 본인의 네트워크 정책에 맞춰 시스템 VPN 설정을 확인하고, 클라이언트가 종료되지 않았다고 단정하지 마세요. 그 밖의 연결 문제는 문제 해결을 참고하세요.

FakeDNS 주소 매핑과 사용 범위

주소에서 도메인을 복원하는 방식

FakeDNS는 설정된 주소 풀에서 조회된 도메인에 합성 주소를 할당하고 그 매핑을 저장합니다. 이후 앱이 해당 주소에 연결하면 연결을 받는 구성 요소가 매핑을 바탕으로 도메인을 복원합니다. 코어는 이 도메인으로 라우팅을 판단하거나 도메인을 다음 아웃바운드의 대상으로 전달할 수 있습니다. 대상 서버에 새 실제 주소를 할당하는 기능도, 모든 DNS 요청을 암호화하는 기능도 아닙니다. 조회부터 연결까지 매핑을 서로 이해하는 하나의 흐름으로 이어져야 합니다. 앱이 알고 있는 IP를 직접 사용하거나 자체 조회 경로로 실제 주소를 받으면 이 매핑 흐름으로 자동 진입하지 않습니다.

가장 흔한 설정 오류는 조회만 바꾸고 이후 연결은 가로채지 않는 경우입니다. 앱이 가로채는 리졸버에서 합성 주소를 받았지만 앱별 목록이나 주소 제외 설정 때문에 연결은 시스템을 통해 직접 나갈 수 있습니다. 이때 로그에 합성 주소 연결 시간 초과가 표시되거나 코어에 요청 자체가 나타나지 않을 수 있습니다. 반대로 트래픽 가로채기 구성 요소가 연결을 받았더라도 매핑이 없거나 FakeDNS 대상을 인식하지 못하면 합성 주소를 그대로 아웃바운드 연결에 사용할 수 있습니다. 두 경우의 증상은 비슷해 보이지만 각각 트래픽이 들어오는 범위와 코어의 주소 인식 설정을 수정해야 합니다. 일반 DNS 상위 서버를 바꾸는 것으로 해결할 수 없습니다.

주소 풀 크기와 적용 범위

다음은 Xray 최상위 fakedns 주소 풀의 일부입니다. 테스트용으로 예약된 대역의 IPv4 주소 일부를 사용합니다. 이 설정은 주소 풀과 매핑 용량만 지정하며 기능 전체를 단독으로 켜지는 않습니다. poolSize는 동시 연결 수나 구독 노드 수가 아닙니다. 풀에 보관할 주소와 도메인 매핑의 규모를 제한합니다. 용량은 네트워크 대역에서 제공할 수 있는 주소 수에 맞추고 자주 사용하는 앱이 동시에 접속하는 도메인 수도 고려하세요. 같은 대역을 내부 테스트 네트워크에서 사용 중인 환경에 이 대역을 그대로 적용하지 마세요. 시스템, 가상 인터페이스, 다른 도구가 이미 해당 대역을 사용하는지 먼저 확인하세요.

{
  "fakedns": [
    {
      "ipPool": "198.18.0.0/16",
      "poolSize": 4096
    }
  ]
}

Xray 설정을 직접 조합한다면 선택한 DNS 조회가 fakedns를 사용할 수 있게 하고, 연결을 받는 인바운드에서 해당 대상을 식별하도록 설정해야 합니다. 예를 들어 적용할 인바운드의 스니핑 설정에서 fakedns를 사용하세요. 그래픽 클라이언트나 TUN 구성 요소는 자체 합성 주소 방식을 사용할 수 있으며, 메뉴와 매개변수가 Xray 최상위 객체와 다를 수 있습니다. 특히 한 계층에서 만든 매핑과 다른 계층에서 별도로 만든 주소 풀을 함께 쓰면서 서로 매핑을 복원할 수 있다고 가정하지 마세요. 생성부터 사용까지 하나의 설정 체계가 담당하도록 한 뒤 실제로 어떤 아웃바운드에 들어가는지 확인하세요.

작은 범위에서 시험하고 되돌릴 준비를 하세요

시험할 때는 제어할 수 있는 앱 하나와 테스트 도메인 하나만 사용하세요. 먼저 일반 DNS 조회로 비교 기준을 만들고 조회 성공 여부, 코어에 도메인과 주소 중 무엇이 표시되는지, 최종적으로 어떤 아웃바운드가 선택되는지 기록하세요. 기능을 켠 뒤 앱에서 새 연결을 만들어 풀에 포함된 주소를 받았는지, 트래픽 가로채기 로그에서 예상 도메인을 복원했는지 확인하세요. 터미널에서 DNS 결과만 확인해 결론을 내리지 마세요. 터미널과 대상 앱이 서로 다른 조회 및 연결 방식을 사용할 수 있습니다. 주소 기반 규칙이 갑자기 일치하지 않으면 규칙이 합성 주소, 복원된 도메인, 이후 조회된 실제 주소 중 무엇을 대상으로 하는지 확인하세요.

로컬 네트워크 기기 검색, 기업 내부 DNS, 실제 주소를 기준으로 판단하는 앱은 필요한 실제 DNS 결과를 유지하는 편이 적합합니다. 서비스가 같은 네트워크 대역에 있다면 로컬 도메인 조회와 해당 서비스 접속이 모두 올바른 경로를 사용하는지 확인하세요. 도메인을 합성 주소 범위에서 제외하는 것만으로 해결됐다고 볼 수 없습니다. 주소 풀이 이미 사용 중이거나 매핑이 제거됐거나 구성 요소가 재시작되면 앱 캐시에 이전 합성 주소가 남을 수 있습니다. 이때 같은 앱에서 새 페이지는 열리지만 기존 페이지가 작동하지 않는다면 풀 크기를 바꾸기 전에 기존 연결을 닫고 테스트 앱을 다시 시작하세요.

설정을 끈 뒤 캐시를 다시 확인하세요

되돌릴 때는 먼저 일반 DNS 조회와 기존 트래픽 가로채기 설정을 복구한 다음 테스트 앱에서 다시 조회하세요. 앱이 이미 저장한 합성 주소는 스위치를 끄자마자 사라지지 않습니다. 새 조회가 실제 주소를 반환하고 연결 대상이 더는 합성 주소 대역을 가리키지 않는지 확인한 다음 문제가 해결됐는지 판단하세요.

다중 구독 관리 및 변경 사항 되돌리기

현재 지연 시간이 아니라 업데이트 담당 기준으로 그룹을 나누세요

구독이 여러 개라면 각각의 출처를 구분해 두세요. 제공업체, 용도, 업데이트 담당자에 따라 그룹 이름을 정할 수 있습니다. 예를 들어 자주 쓰는 출처, 임시 테스트용 출처, 로컬에서 직접 관리하는 설정을 나눌 수 있습니다. 메모에는 범위를 알아볼 수 있는 정보만 적고 링크나 계정 정보를 복사하지 마세요. 속도 측정 결과를 기준으로 그룹을 만들지는 마세요. 네트워크가 바뀌면 항목 순서는 달라지지만 출처와 업데이트 담당자는 그대로입니다. 자주 쓰는 용도와 테스트 용도가 같은 출처를 사용한다면 같은 주소를 불필요하게 반복해서 가져오지 않도록 클라이언트의 태그, 필터 또는 별도의 테스트 환경을 우선 활용하세요.

직접 가져온 설정, 메모를 보존해야 하는 설정, 단기 문제 해결용 설정은 자동 업데이트 항목과 가능한 한 분리하세요. 구독을 새로 고칠 때 클라이언트가 출처를 기준으로 항목을 다시 만들 수 있으므로 구독에서 생성된 항목에 로컬 메모를 추가해도 업데이트 후 유지되지 않을 수 있습니다. 스냅샷을 보존해야 한다면 클라이언트에서 지원하는 복사 기능으로 별도 위치에 복사하고, 출처 변경이 반영되지 않는 사본이라고 표시하세요. 이후에도 사본이 필요한지 정기적으로 확인해야 합니다. 잃어버리지 않으려고 오래된 항목을 계속 쌓아 두면 전환할 때 이미 작동하지 않는 설정을 선택할 가능성이 커집니다.

그룹 하나씩 업데이트하고 확인하세요

관리 작업을 시작하기 전에 현재 정상 작동하는 항목과 해당 그룹을 확인한 다음 변경 대상 출처 하나만 업데이트하세요. 업데이트가 끝나면 해당 그룹 전체가 비어 있지 않은지, 항목을 알아볼 수 있는지, 자주 사용하는 프로토콜과 전송 설정이 예상과 맞는지 비교하세요. 항목 수가 크게 바뀌어도 다른 그룹까지 바로 업데이트해 확인할 필요는 없습니다. 해당 그룹의 업데이트 로그를 보고 출처 응답 변화, 파싱 차이, 필터 조건 중 무엇이 영향을 줬는지 구분한 뒤 대표 설정 하나를 골라 연결을 확인하세요. 한 그룹의 결과가 예상대로인지 확인한 다음 다음 그룹을 업데이트하면 다른 출처를 중단하지 않고도 변경 원인을 찾을 수 있습니다.

업데이트를 예약할 수 있다면 연결 안정성이 꼭 필요한 시간대를 피하세요. 여러 기기에서 같은 출처를 동시에 자주 새로 고치지 말고, 짧은 간격으로 재시도하는 것을 문제 진단 대신 사용하지 마세요. 요청 제한에 걸리면 출처의 이용 정책에 따라 새로 고침 빈도를 낮추세요. 업데이트 실패를 곧바로 노드 장애로 판단해서는 안 됩니다. 현재 프록시로 접속해야 하는 구독이라면 먼저 기존 연결이 정상인지 확인한 뒤 새로 고침을 시작하세요. 한 출처를 업데이트하지 못해도 별도로 정상 작동하는 그룹은 그대로 유지해야 합니다. 자동 업데이트, 자동 항목 선택, 시스템 프록시 자동 활성화는 각각 따로 살펴보세요. 실패 증상은 비슷해 보여도 원인은 다를 수 있습니다.

중복 항목, 마이그레이션, 기기별 차이 처리

메모가 같다는 이유만으로 둘 중 하나를 삭제하지 마세요. 이름이 같아도 출처와 전송 매개변수가 다를 수 있고, 이름이 달라도 같은 서버의 설정일 수 있습니다. 정리할 때는 로컬에서 소속 그룹, 프로토콜 종류, 주소와 포트, 전송 방식, 보안 설정을 비교하세요. 출처가 실제로 중복되는지, 클라이언트가 자주 쓰는 항목을 여러 그룹에 중복 표시하는지 먼저 확인하세요. 유효한 두 출처가 같은 항목을 관리한다면 항목을 하나씩 지우기보다 그룹 하나를 제거하는 편이 업데이트 방식에 더 잘 맞을 수 있습니다. 다만 해당 그룹의 설정에 의존하는 앱 규칙이나 시작 옵션이 없는지 먼저 확인하세요.

v2rayN에서 안드로이드로 옮길 때 데스크톱 설정 폴더 전체를 어디서나 가져올 수 있는 파일로 취급하지 마세요. 그룹 메모와 구독 출처는 다시 설정할 수 있지만, 시스템 프록시, TUN, 앱별 프록시 같은 플랫폼 전용 설정은 각각 별도로 구성해야 합니다. v2rayNG와 v2flyNG는 서로 다른 코어를 사용하므로 같은 구독을 가져와도 결과가 다를 수 있습니다. 일부 프로토콜과 필드는 두 클라이언트 모두에서 지원되지 않습니다. 마이그레이션할 때는 대표 설정 하나를 먼저 확인한 뒤 사용자 지정 라우팅과 DNS를 단계적으로 복구하세요. 호환되지 않는 항목은 대상 클라이언트와 코어의 지원 범위를 기준으로 판단하고 네트워크 장애 통계에 포함하지 마세요.

업데이트 전에 되돌릴 준비를 하세요

업데이트 전에 정상 작동하는 항목, 클라이언트 모드, 관련 규칙을 기록하세요. 백업이 필요하다면 관리되는 안전한 위치에 보관하세요. 내보낸 파일에 구독 주소와 연결 매개변수가 포함될 수 있습니다. 다른 사람에게 문제를 설명할 때는 민감한 정보를 가린 오류 유형, 발생 단계, 재현 절차만 제공하세요. 구독 주소가 노출됐다면 로컬 기록만 삭제하지 말고 출처 제공자에게 새 주소를 요청하세요. 업데이트 후 그룹 전체에 문제가 생기면 먼저 확인된 비교용 설정으로 전환해 클라이언트의 기본 연결이 정상인지 확인하세요. 되돌리기에 성공하면 로컬 설정 복원, 필터 조건 수정, 출처의 응답 복구 대기 중 어떤 조치가 필요한지 판단하세요.

사용자 지정 아웃바운드

전체 설정을 누가 관리할지 먼저 정하세요

아웃바운드는 코어가 연결을 받은 뒤 다음 구간을 어떻게 연결할지 정의합니다. 직접 연결, 연결 거부, 특정 프록시 프로토콜 등을 사용할 수 있습니다. 아웃바운드의 tag는 라우팅에서 참조하는 식별자이지 사용자가 보는 서버 메모가 아닙니다. 규칙의 outboundTag는 실제로 존재하는 태그를 가리켜야 하며 대소문자도 일치해야 합니다. 설정에 아웃바운드만 추가하고 라우팅에서 참조하지 않으면 보통 기대한 결과가 나오지 않습니다. 아웃바운드를 목록 첫 항목에 넣으면 어떤 규칙에도 일치하지 않는 모든 연결의 경로가 뜻하지 않게 바뀔 수 있습니다. 먼저 인바운드, 규칙, 아웃바운드의 연결 관계를 정리한 다음 어느 계층을 변경할지 결정하세요.

그래픽 클라이언트는 설정 하나를 실행할 때 보통 화면의 설정을 바탕으로 실행용 구성을 생성합니다. 생성된 파일을 직접 수정해도 노드를 바꾸거나 클라이언트를 재시작하면 덮어써질 수 있습니다. 완전한 사용자 지정 설정 가져오기를 지원한다면 다시 가져올 수 있는 사본을 해당 모드에서 관리하세요. 전체 설정을 사용할 때 화면의 라우팅 편집기, DNS 스위치, 시스템 프록시 포트가 사용자 지정 내용과 자동으로 병합된다고 가정하면 안 됩니다. 인바운드 유형, 수신 대기 포트, 코어, 실행 모드 등 클라이언트가 설정을 어떻게 사용하는지 먼저 확인하세요. 데스크톱과 안드로이드는 시스템 연결 방식이 다르므로 설정을 파싱할 수 있다는 이유만으로 수정 없이 옮길 수 있다고 판단하지 마세요.

최소 설정으로 태그와 규칙 순서를 확인하세요

다음은 Xray 로컬 테스트용 전체 설정입니다. 루프백 주소에서만 SOCKS 요청을 수신하며, 두 아웃바운드로 직접 연결과 연결 거부를 각각 테스트합니다. 직접 연결 아웃바운드를 첫 항목으로 유지하면 지정한 대상과 정확히 일치하는 경우에만 거부 아웃바운드가 선택됩니다. 이 예제는 원격 프록시 서버를 사용하지 않으므로 아웃바운드 태그 문제와 시스템 트래픽 가로채기 문제를 구분하는 데 적합합니다. 실행 전에 수신 대기 포트가 사용 중이 아닌지 확인하세요. 포트를 바꾸면 테스트 명령도 함께 수정해야 합니다. 클라이언트에서 현재 사용하는 설정을 바로 덮어쓰지 말고 독립된 테스트 환경에서 먼저 사용하세요.

{
  "log": {"loglevel": "info"},
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "tag": "local-test",
      "settings": {"auth": "noauth", "udp": false}
    }
  ],
  "outbounds": [
    {"protocol": "freedom", "tag": "direct", "settings": {}},
    {"protocol": "blackhole", "tag": "reject-test", "settings": {}}
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-test"],
        "domain": ["full:example.net"],
        "outboundTag": "reject-test"
      }
    ]
  }
}

호환되는 Xray 코어에서 설정을 실행한 뒤 curl이 설치된 같은 데스크톱 기기에서 다음 명령을 사용할 수 있습니다. 두 명령 모두 도메인 형태의 대상을 SOCKS 인바운드로 전달합니다. 첫 번째는 직접 연결, 두 번째는 연결 거부 아웃바운드를 선택해야 합니다. 로컬 네트워크에서 테스트 도메인에 접속할 수 없을 수도 있으므로 특정 응답 코드가 나올 것으로 기대하기보다 로그에서 선택된 아웃바운드를 비교하세요. 두 명령 모두 로컬 포트에 연결하지 못한다면 먼저 설정이 실행 중인지, 포트가 올바른지, 다른 프로세스가 해당 포트를 사용 중인지 확인하세요. 아직 라우팅 문제를 살펴볼 단계가 아닙니다.

curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.com/
curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.net/

확장할 때 코어, 연결, 대상을 단계별로 확인하세요

실제 아웃바운드 설정을 추가할 때 재현 가능한 로컬 인바운드와 정상 작동이 확인된 기본 경로를 유지하고, 먼저 대상 규칙 하나만 바꾸세요. 코어가 시작되지 않으면 설정 문법, 프로토콜 지원 여부, 태그 유효성을 우선 확인하세요. 코어는 시작됐지만 요청 기록이 없으면 앱 연결 경로를 확인하세요. 요청이 예상한 아웃바운드를 향하지만 연결에 실패한다면 서버 주소 조회, 네트워크 연결성, 제공업체가 안내한 프로토콜 설정을 확인하세요. TLS 오류가 한 번 나타났다는 이유로 라우팅부터 바꾸는 것이 흔한 오진입니다. 라우팅은 이미 올바른 아웃바운드를 선택했을 수 있습니다. 이 경우 규칙 위치를 바꾸기보다 핸드셰이크에 필요한 매개변수와 대상 주소를 비교하세요.

다른 클라이언트로 설정을 옮기기 전에 Xray와 V2Fly 코어의 차이를 읽고 공통 설정 개념과 코어별 전용 필드를 구분하세요. 배포가 끝나면 테스트 인바운드와 더 이상 사용하지 않는 예외 규칙을 제거하고 로그 수준을 일상 사용에 맞게 되돌리세요. 배포 전 실행 가능한 사본을 보관한 뒤 일반적인 연결 방식으로 앱, DNS, 로컬 네트워크 경로를 다시 테스트하세요. 데스크톱의 명시적 프록시 테스트만 성공하고 시스템에서 트래픽을 가로챈 뒤 앱이 실패한다면 연결 계층을 다시 확인하세요. 이미 검증한 아웃바운드를 다시 작성할 필요는 없습니다.