설정 참고 · 고급 가이드

V2Ray 고급 설정

먼저 빠른 시작 가이드를 따라 처음으로 가져오기, 연결, 검증을 마친 다음 이 가이드에서 개별 설정을 확인하세요. 아래 내용은 데스크톱의 v2rayN을 중심으로 설명하며, Android 관련 내용은 v2rayNG 및 v2flyNG의 차이를 따로 표시합니다.

구독 및 필터트래픽 처리 및 DNS아웃바운드 및 코어

구독 그룹 및 서버 필터

먼저 출처별로 업데이트 범위 나누기

구독 그룹은 서버를 지역별로 분류하기보다 업데이트 범위를 출처별로 나누는 데 주로 사용합니다. v2rayN의 구독 그룹 설정에서 새 항목을 만들고 알아보기 쉬운 별칭과 구독 주소를 입력하세요. 저장한 뒤 해당 그룹을 선택하고, 우선 그 그룹만 업데이트합니다. 별칭에는 ‘테스트용 원격 접속’이나 ‘개인 예비용’처럼 출처와 용도를 함께 적을 수 있습니다. 한 출처에서 용도가 다른 구독을 여러 개 제공한다면 별칭도 각각 다르게 지정하세요. 이렇게 나눠 두면 문제를 해결할 때 어느 출처를 다시 요청해야 하는지 알기 쉽습니다. 서버 표시 이름은 목록에서 항목을 식별하는 용도이므로 구독 그룹 이름과 혼동하지 마세요.

업데이트가 끝나면 새 항목이 어느 그룹에 들어갔는지 확인하고, 프로토콜과 전송 방식이 출처에서 안내한 내용과 일치하는지 살펴보세요. 공유 링크나 클립보드로 개별 가져온 항목은 구독 업데이트 검증에 사용하지 않는 편이 좋습니다. 연결에 성공하더라도 최신 구독 내용을 가져왔다는 뜻은 아니기 때문입니다. 수동으로 추가한 설정을 임시로 유지해야 한다면 별칭을 따로 지정하세요. 구독 그룹 안에 장기간 유지될 수동 수정 항목으로 취급하면 안 됩니다. 일반 업데이트에서는 출처가 항목과 매개변수를 다시 배포할 수 있습니다.

검증 가능한 이름으로 필터 조건 만들기

v2rayN에 서버 필터 입력란이 있다면 먼저 해당 입력란의 설명을 확인하세요. 필터 대상이 서버 별칭이라면 주소, 아웃바운드 태그, 라우팅 도메인을 조건으로 입력해서는 안 됩니다. 정규식을 사용한다고 안내된 경우 ^(업무|테스트)-로 두 단어 중 하나와 하이픈으로 시작하는 이름을 찾을 수 있습니다. 저장하고 새로 고치기 전에 유지해야 할 이름 하나와 제외해야 할 이름 하나를 대조하세요. 정규식에서 괄호는 여러 후보를 묶고 세로줄은 후보 중 하나를 뜻합니다. 이름에 마침표가 포함되어 있다면 문자 그대로 일치하도록 \.로 작성하세요. 이름 규칙이 안정적으로 유지될 때만 시작·끝 앵커를 사용하세요.

필드 이름만 보고 일치한 항목이 반드시 유지되는지 제외되는지 판단하지 마세요. 필터가 현재 목록 표시만 바꾼다고 가정해서도 안 됩니다. 임시 그룹을 만들어 검증하세요. 필터를 적용하지 않은 상태에서 대표 항목을 기록한 다음 조건을 적용해 다시 업데이트하고, 가져오는 단계에서 항목이 제외됐는지 아니면 화면에서만 보이지 않는지 확인합니다. 필터 전후에는 같은 그룹과 같은 출처를 사용해야 차이를 조건의 영향으로 볼 수 있습니다. 출처 이름, 공백 문자, 대소문자가 바뀌면 기존 조건이 맞지 않을 수 있습니다. 복구할 때는 먼저 필터 조건을 지우고 해당 그룹만 새로 고친 뒤 일치 범위를 좁히세요.

요청 실패, 파싱 실패, 필터 결과 없음 구분하기

업데이트 로그에 요청 단계에서 호스트 이름 확인 실패나 연결 시간 초과가 표시된다면 구독 도메인을 확인할 수 있는지, 현재 네트워크에서 연결할 수 있는지, 업데이트 요청이 직접 연결되는지 기존 프록시를 이용하는지부터 확인하세요. 이 단계에서는 서버 필터링이 아직 시작되지 않았습니다. 요청이 완료됐지만 파싱에 실패했다면 응답 내용이 해당 클라이언트에서 인식할 수 있는 구독인지 확인하세요. 노드 설정 대신 로그인 페이지나 서비스 안내가 반환되는 경우도 있습니다. 파싱은 됐지만 예상한 항목이 없다면 서버 이름과 필터 조건, 클라이언트의 해당 프로토콜 지원 여부, 현재 다른 그룹이 선택되어 있지 않은지 점검하세요.

Android에서는 데스크톱 메뉴와 같은 이름으로 기능을 찾지 마세요. v2rayNG 또는 v2flyNG의 구독 메뉴에서 가져오고 새로 고친 다음, 해당 클라이언트가 실제로 제공하는 그룹 및 필터 기능을 기준으로 확인하세요. 같은 필드가 없다면 데스크톱 정규식을 모바일 클라이언트 설정에 그대로 적용하는 것보다 구독을 원본 그대로 유지하고 출처별로 관리하는 편이 예측하기 쉽습니다. 같은 출처가 데스크톱에서는 업데이트되지만 휴대전화에서는 실패한다면 동일한 네트워크 조건에서 다시 시도하세요. 두 클라이언트의 업데이트 요청과 프로토콜 파싱은 별개이므로 목록의 항목 수만으로 문제를 판단할 수 없습니다.

라우팅 규칙 실전

먼저 트래픽이 어느 입구로 들어오는지 확인하기

라우팅 규칙은 코어에 들어온 트래픽만 처리합니다. 시스템 프록시를 켜면 설정을 따르는 앱은 보통 요청을 로컬 프록시로 보낼 수 있지만, 직접 연결을 지정했거나 별도 프록시를 사용하거나 일부 연결을 자체 처리하는 앱은 같은 경로를 거치지 않을 수 있습니다. 검증할 때는 로컬 프록시를 명시적으로 지정할 수 있는 앱을 골라 요청이 실제로 클라이언트에 도달하는지 확인한 다음 규칙을 조정하세요. 로그에 해당 인바운드 요청이 없다면 도메인 규칙을 추가하거나 규칙 순서를 바꿔도 입구 문제만 가려질 뿐입니다. 데스크톱에서 시스템 프록시와 TUN을 함께 사용하는 경우도 있으므로, 처음 테스트할 때는 변수 범위를 줄이기 위해 트래픽 처리 경로를 하나만 사용하세요.

도메인으로 일치시킬 수 있는지는 입구에서 대상 정보를 얻는 방식에도 달려 있습니다. 앱이 도메인을 프록시에 전달하면 도메인 규칙으로 바로 비교할 수 있습니다. 앱이 먼저 직접 이름을 확인한 뒤 주소만 전달하면, 규칙에 도메인이 있다고 해서 코어가 주소를 원래 이름으로 자동 복원하지는 않습니다. 일부 상황에서는 입구의 스니핑 설정으로 프로토콜에 드러난 대상 이름을 얻을 수 있지만, 효과는 트래픽 유형, 암호화 방식, 클라이언트 설정에 따라 달라집니다. 같은 사이트가 앱마다 다른 규칙에 걸린다면 로그에 이름과 주소 중 무엇이 들어왔는지부터 확인한 다음 주소 조건을 추가할지 판단하세요.

구체적인 규칙을 포괄적인 규칙보다 앞에 배치하기

Xray의 라우팅 규칙 배열은 순서대로 검사하며, 규칙이 일치하면 해당 아웃바운드를 사용합니다. 하나의 규칙 안에서 도메인과 포트 등 서로 다른 필터 조건은 모두 충족해야 합니다. 같은 도메인 배열에 있는 후보는 하나만 일치해도 됩니다. 아래 예시는 라우팅 객체만 보여 줍니다. 최상위 routing 필드에 넣고, 참조하는 두 태그는 최상위 outbounds에 미리 정의해야 합니다. 첫 번째 규칙은 테스트 이름 자체만 제외하고, 두 번째 규칙은 예시 도메인과 하위 도메인을 모두 일치시킵니다. 규칙 리소스 파일에 의존하지 않으므로 기본 매칭 문제와 리소스 로딩 문제를 구분해 확인할 수 있습니다.

{
  "domainStrategy": "AsIs",
  "rules": [
    {
      "type": "field",
      "domain": ["full:blocked.example.org"],
      "outboundTag": "blocked"
    },
    {
      "type": "field",
      "domain": ["domain:example.org"],
      "outboundTag": "direct"
    }
  ]
}

예시의 두 번째 규칙을 첫 번째에 배치하면 첫 번째 이름이 더 넓은 도메인 조건에 걸려 제외 규칙이 실행되지 않습니다. 마찬가지로 일반 트래픽을 모두 종료하는 기본 규칙을 맨 앞에 놓으면 개별 규칙이 일치할 기회가 없습니다. 클라이언트에 포함된 라우팅 프리셋을 사용할 때는 편집 가능한 사본을 먼저 만든 뒤 규칙 순서와 마지막에 선택되는 아웃바운드를 확인하세요. 어떤 규칙에도 일치하지 않는 트래픽은 Xray에서 기본적으로 첫 번째 아웃바운드로 전달됩니다. 그래픽 클라이언트가 생성 설정에 기본 규칙을 추가할 수도 있으므로, 화면에서 첫 번째 서버가 무엇인지로 실제 출구를 추정하지 마세요.

도메인 정책과 규칙 리소스를 따로 검증하기

AsIs는 라우팅 매칭을 위해 별도의 도메인 조회를 요구하지 않습니다. IPIfNonMatch는 도메인 단계에서 규칙이 일치하지 않을 때 조회한 주소로 주소 규칙을 다시 확인하는 데 적합합니다. 앞 단계에서 해당 연결과 일치하는 포괄적인 규칙이 이미 있으면 주소를 추가로 조회하는 단계로 넘어가지 않습니다. IPOnDemand는 규칙 검사에 주소가 필요할 때 조회할 수 있도록 합니다. 규칙 순서에 따라 조회 시점도 달라집니다. 이 옵션들은 라우팅에 필요한 매칭 정보를 어떻게 얻을지 결정할 뿐, 앱의 DNS 서버를 지정하거나 최종 아웃바운드가 같은 조회 결과를 사용하도록 보장하지는 않습니다.

직접 작성한 규칙에서 geosite: 또는 geoip: 매칭으로 바꿀 때는 코어가 리소스 파일과 분류 항목을 불러왔는지도 확인하세요. 분류 이름을 사용할 수 있다고 해서 사이트의 모든 관련 도메인이 포함된 것은 아닙니다. 페이지 본문, 로그인 서비스, 정적 리소스가 서로 다른 규칙을 따를 수 있습니다. 검증할 때는 규칙에 일치해야 하는 연결 하나와 기본 아웃바운드로 가야 하는 연결 하나를 선택하고, 각각 새 세션을 만들어 로그를 확인하세요. 이미 생성된 연결은 규칙을 수정해도 출구가 바뀌지 않습니다. 인바운드, 라우팅, 아웃바운드의 전체 구조를 확인하려면 설정 파일 JSON 구조 해설을 참고하세요.

DNS 설정 최적화

앱 DNS와 코어 DNS 구분하기

도메인 연결에 문제가 생겼다고 곧바로 DNS 서버를 바꾸지는 마세요. 해당 조회를 누가 요청했는지 먼저 확인해야 합니다. 앱에 따라 시스템 리졸버를 사용하거나, 프록시에 이름을 전달해 코어나 아웃바운드가 조회하거나, 앱 자체에서 암호화된 DNS 요청을 보낼 수 있습니다. 클라이언트의 코어 DNS 설정은 해당 DNS 모듈에 도달하는 조회에만 영향을 주며 앱에서 별도로 보내는 요청까지 자동으로 바꾸지는 않습니다. 앱과 클라이언트에서 같은 도메인을 테스트할 때는 어떤 입구를 사용했는지 기록하세요. 터미널에서 주소가 조회됐다는 것은 터미널의 DNS 경로가 결과를 얻었다는 뜻일 뿐, 프록시의 DNS 규칙이 적용됐다는 증거는 아닙니다.

내부 도메인은 경계를 확인하는 데 특히 유용합니다. 특정 조직의 네트워크에서만 조회되는 서비스라면 해당 네트워크에서 지정한 DNS 서버로 보내고, 적절한 인터페이스에서 요청에 도달할 수 있는지 확인하세요. 내부 도메인을 공용 DNS 서버로 보내면 존재하지 않는다는 응답을 받을 수도 있고, 알 필요가 없는 서비스에 이름이 노출될 수도 있습니다. 테스트에는 내부 DNS 서버가 관리하는 것으로 확인된 이름 하나와 공개 도메인 하나를 사용하세요. 먼저 두 DNS 서버가 각각 정상 작동하는지 확인한 뒤 도메인 분류를 코어 설정에 연결합니다. 두 주소가 서로 다르다는 사실만으로 DNS 분기가 올바른지 판단할 수는 없습니다.

DNS 서버, 매칭 범위, 폴백을 각각 설정하기

네이티브 조각 설정을 지원하는 Xray 구성에서는 최상위 dns 아래의 servers가 사용할 DNS 서버 후보를 정의합니다. DNS 서버 객체의 domains는 매칭 범위를 지정합니다. 이는 DNS 서버 선택에 영향을 주지만, 연결을 같은 이름의 아웃바운드로 자동 전송하지는 않습니다. 아래 객체는 매칭과 폴백을 설명하기 위한 예시입니다. 코어에서 조회해야 하는 예시 도메인은 지정 서버를 우선 사용하고, 나머지는 시스템 DNS 서버를 사용할 수 있습니다. skipFallback을 설정하면 예시의 전용 서버가 일반 폴백에 참여하지 않습니다. 해당 도메인과 일치할 때 우선 선택되는 것을 막는 설정은 아니며, 전용 서버에서 조회에 실패하면 다른 서버에 절대 요청하지 않는다는 뜻도 아닙니다.

{
  "servers": [
    {
      "address": "223.5.5.5",
      "domains": ["domain:example.org"],
      "skipFallback": true
    },
    "localhost"
  ],
  "queryStrategy": "UseIP"
}

UseIP는 조회를 단일 주소 체계로 제한하지 않습니다. UseIPv4 또는 UseIPv6은 내장 DNS가 선택하는 주소 체계를 제한하며 운영체제의 네트워크 설정을 바꾸지는 않습니다. 일부 연결만 느리거나 실패한다면 두 주소 유형의 레코드가 있는지, 주소를 받은 뒤 실제로 연결할 수 있는지 각각 확인하세요. 현재 네트워크에서 특정 주소 체계에 연결할 수 없다는 점이 확인된 경우 일시적으로 조회 범위를 제한하면 원인을 좁히는 데 도움이 됩니다. 점검을 마치면 한 번의 진단을 위해 바꾼 설정을 계속 사용하지 말고 실제 환경에 맞는 정책으로 되돌리세요.

원격 DNS 서버 연결 실패와 조회된 주소 연결 실패 구분하기

도메인 이름으로 지정하는 암호화 DNS 서버를 사용할 때는 해당 서버의 이름을 어떻게 조회할지 먼저 생각해야 합니다. 서버에 아직 연결하지 못했는데 그 서버를 이용해 자기 이름을 조회하려 하면 의존성 순환이 생깁니다. 서버 연결에 프록시가 필요한데 프록시 서버 이름을 해당 DNS 서버로만 조회할 수 있는 경우에도 비슷한 문제가 발생합니다. 네트워크에서 허용하는 경로를 이용해 먼저 도달할 수 있는 별도의 초기 DNS 방식을 준비하고 서버의 호스트 이름이 올바른지 확인하세요. 오류 로그의 순서도 중요합니다. DNS 서버 연결 실패는 서비스 도메인의 응답을 받은 뒤 업무 연결이 시간 초과되는 상황과는 다릅니다.

DNS 설정을 전환할 때는 다른 DNS 가로채기 실험 옵션을 먼저 끄고 새 세션에서 정상 작동이 확인된 도메인에 접속하세요. 시스템, 앱, 코어가 각각 결과를 캐시할 수 있다는 점도 유의해야 합니다. 한 번 연결에 성공한 것이 앱이 기존 연결을 재사용한 결과일 수도 있습니다. 검증에는 DNS 조회 한 번과 그에 이어지는 실제 서비스 연결이 모두 포함되어야 합니다. 규칙 리소스, 암호화 DNS, 그룹별 DNS 설정을 함께 살펴보려면 V2Ray DNS 분기 설정을 참고하세요. 여러 DNS 서버를 추가하기 전에 이 장의 기본 비교부터 마치세요.

TUN 모드와 트래픽 가로채기

시스템 프록시와 가상 인터페이스 비교하기

시스템 프록시는 대체로 앱이 프록시 설정을 따르는 방식입니다. TUN은 가상 네트워크 인터페이스와 시스템 라우팅을 이용해 조건에 맞는 트래픽을 처리 구성요소로 전달합니다. TUN을 켰다고 해서 모든 트래픽이 같은 출구로 향하는 것은 아닙니다. 어떤 목적지 주소가 가상 인터페이스를 통과하는지, 어떤 앱을 제외하는지, 진입한 트래픽이 라우팅 규칙에 따라 직접 연결되는지는 서로 다른 계층의 결정입니다. 문제를 확인할 때는 ‘앱이 어떤 연결을 시도했고, 어느 입구를 거칠 것으로 예상했으며, 실제 출구는 무엇이었는지’를 먼저 적으세요. 단순히 ‘스위치를 켰더니 연결이 안 된다’고만 기록하지 마세요. 확인할 대상이 인터페이스인지 시스템 라우팅인지 코어 로그인지 판단하는 데 도움이 됩니다.

데스크톱에서는 먼저 v2rayN의 일반 시스템 프록시나 앱에서 직접 지정한 프록시로 정상 연결을 확인한 뒤 TUN을 따로 테스트하세요. 인터페이스 생성과 라우팅 변경을 위한 시스템 권한 안내도 확인해야 합니다. Android의 v2rayNG와 v2flyNG는 보통 시스템 VPN 서비스를 통해 트래픽을 처리합니다. 시스템 권한, 대상 앱 범위, 다른 VPN 서비스와의 동시 사용 제한은 사용 중인 클라이언트와 기기에 표시되는 상태를 기준으로 확인하세요. Android 기능은 데스크톱 TUN 설정과 같은 화면이 아니므로 데스크톱의 권한 조작 방법을 휴대전화에 그대로 적용하면 안 됩니다.

처리 방식입구가 형성되는 조건먼저 확인할 항목
데스크톱 시스템 프록시앱이 시스템 프록시를 따르거나 로컬 프록시를 설정함앱이 로컬 리스닝 주소로 요청을 보내는지
데스크톱 TUN가상 인터페이스를 만들고 시스템 라우팅이 해당 인터페이스를 가리킴트래픽 처리 구성요소가 실행 중인지, 테스트 대상이 해당 경로를 사용하는지
Android VPN 서비스시스템 권한이 승인되고 앱이 처리 범위에 포함됨연결 상태와 앱 포함·제외 목록

출구 트래픽의 루프부터 방지한 뒤 로컬 네트워크 확인하기

인터페이스 생성은 첫 단계일 뿐입니다. 클라이언트가 원격 서버에 연결하는 트래픽은 실제 네트워크 인터페이스를 통해 나갈 수 있어야 합니다. 해당 연결의 기본 경로가 같은 가상 인터페이스로 다시 향하면 트래픽이 루프에 빠질 수 있습니다. TUN을 끄면 연결되지만 켠 뒤에는 기존에 정상 작동하던 서버와도 핸드셰이크할 수 없는 증상이 나타날 수 있습니다. 먼저 트래픽 처리 구성요소가 우회 경로나 인터페이스 바인딩을 제대로 적용했는지 확인한 다음 다른 가상 네트워크 도구와 라우팅이 충돌하는지 살펴보세요. 시스템 라우팅을 먼저 수동으로 삭제하는 것은 권장하지 않습니다. 클라이언트의 TUN을 꺼도 문제가 남는다면 시스템 화면에서 인터페이스 상태를 확인한 뒤 이 기기의 관리 방침에 따라 설정을 복구하세요.

TUN을 켠 뒤 프린터, 공유 폴더, 조직 내부 서비스만 연결되지 않는다면 실제 목적지 주소의 라우팅 문제와 이름 검색 문제를 구분하세요. 알려진 서비스 주소로는 연결되지만 장치 이름으로 접근할 수 없다면 이름 확인이나 검색 트래픽이 올바른 네트워크에 들어가지 못한 문제일 수 있습니다. 두 방식 모두 연결되지 않는 경우에 로컬 네트워크 대역이 가로채기 대상인지 먼저 확인하세요. 네트워크를 바꾸면 로컬 주소 범위와 기본 인터페이스가 달라질 수 있으므로 제외 조건은 현재 환경을 기준으로 정해야 합니다. 출처를 모르는 라우팅 설정을 그대로 복사하지 마세요. 조직 장비와 관련된 설정을 바꾸기 전에는 해당 유형의 트래픽을 앱이 처리해도 되는지 관리 정책을 확인하세요.

프로토콜과 네트워크 환경별로 검증하기

일반 웹페이지가 열린다는 것은 해당 연결 경로가 작동한다는 뜻일 뿐 모든 UDP 앱이나 장시간 연결까지 정상이라는 의미는 아닙니다. 웹은 되는데 음성 앱이 실패한다면 앱이 실제로 UDP를 사용하는지, 입구와 선택한 아웃바운드, 원격 서버가 모두 해당 트래픽 유형을 지원하는지 확인하세요. 연결은 되지만 오래 지나면 멈추는 경우에 한해 패킷 크기나 경로 변경 등을 추가로 점검하세요. 핸드셰이크와 라우팅을 확인하지 않은 채 인터페이스 MTU를 임의로 낮추지는 마세요. 매번 설정 하나만 바꾸고 시작 로그와 반복 가능한 테스트 동작을 남겨 여러 변수를 오가며 추측하지 않도록 합니다.

최소한 TUN을 켠 뒤 접속, 끈 뒤 복구, 다른 네트워크로 전환한 뒤 다시 접속하는 세 가지 상황을 확인하세요. 처음 두 항목으로 트래픽 처리와 원상 복구가 모두 되는지 확인하고, 마지막 항목으로 이전 인터페이스 참조가 남아 있는지 살펴볼 수 있습니다. 기기에서 다른 네트워크 트래픽 처리 도구도 실행 중이라면 설정이 겹치지 않도록 해당 실험 구성을 먼저 끄고 다시 시도하세요. 함께 사용해야 한다면 해당 환경을 관리하는 담당자가 각 도구의 처리 범위를 확인해야 합니다. 기준 상태로 돌아간 뒤 FakeDNS를 별도로 켜야 문제가 가상 인터페이스 자체에서 생겼는지 이름 매핑 과정에서 추가됐는지 구분할 수 있습니다.

FakeDNS 및 도메인 매핑

합성 주소가 유효한 범위 이해하기

FakeDNS는 도메인과 합성 주소의 매핑을 저장합니다. 앱이 이름을 조회해 합성 주소를 받은 뒤 그 주소로 연결하면, 매핑을 읽을 수 있는 코어에 트래픽이 다시 들어와야 코어가 대상 도메인을 복원해 라우팅이나 아웃바운드 처리에 사용할 수 있습니다. 합성 주소는 대상 서버가 실제로 그 주소에 배포되어 있다는 뜻이 아니며 다른 기기에서 독립적으로 사용할 수 있는 조회 결과도 아닙니다. 앱이 트래픽 처리를 우회해 해당 주소에 직접 접속하면 도메인을 복원할 기회가 사라집니다. 따라서 합성 주소는 일반 DNS 서버가 반환하는 최종 서비스 주소가 아니라 트래픽 처리 경로 안에서 사용하는 주소 표식으로 이해해야 합니다.

이 방식은 입구에 대상 주소만 표시되지만 설정은 도메인별로 트래픽을 나눠야 하는 상황에 적합합니다. 일반 시스템 프록시가 앱에서 전달한 도메인을 이미 받을 수 있다면 기존 도메인 규칙부터 확인하세요. 대상 프로그램이 독립적으로 접속할 수 있는 실제 주소를 봐야 하거나 조회 결과를 트래픽 처리 범위 밖의 서비스에 전달한다면 해당 도메인은 실제 DNS로 조회해야 합니다. FakeDNS가 암호화 DNS 요청을 모두 코어 조회로 자동 전환하는 것도 아닙니다. 앱이 DNS 서비스를 직접 사용하는 경우 먼저 조회가 클라이언트에 설정된 DNS 입구를 통과하는지 확인하세요.

주소 풀, 조회 입구, 트래픽 입구를 함께 확인하기

Xray 네이티브 설정에서 FakeDNS를 점검할 때는 세 부분을 따로 확인하세요. 최상위 fakedns는 주소 풀을 정의하고, dns.servers 선택은 내장 DNS 조회 중 어떤 요청에 FakeDNS를 사용할지 정합니다. 이후 트래픽을 받는 입구는 매핑을 이용해 도메인을 복원할 수 있어야 합니다. 네이티브 입구 설정을 사용하는 경우 해당 입구의 sniffing이 켜져 있는지, destOverride에 fakedns가 포함됐는지 확인해야 합니다. 그래픽 클라이언트가 이 필드들을 자동 생성할 수도 있으므로 실제 시작 설정과 로그를 확인하세요. 설정 스위치 하나만 보고 세 항목이 모두 준비됐다고 판단하지 마세요.

아래는 주소 풀 조각만 보여 주며 FakeDNS를 단독으로 활성화하지는 않습니다. ipPool은 합성 주소 범위를 정하고 poolSize는 풀에 저장할 매핑 규모를 제한합니다. 네트워크 대역폭 설정이 아닙니다. 예시에 쓰인 대역을 로컬 테스트 환경이나 다른 트래픽 처리 도구가 이미 사용 중일 수 있으므로 적용 전에 기존 라우팅을 확인하세요. 두 도구가 같은 주소 범위를 쓰면 한 프로그램이 받은 주소를 다른 인터페이스가 잘못 처리할 수 있습니다. DNS 업스트림만 바꿔서는 이런 라우팅 충돌을 해결할 수 없습니다.

{
  "fakedns": [
    {
      "ipPool": "198.18.0.0/15",
      "poolSize": 65535
    }
  ]
}

조회, 트래픽 복귀, 매핑 순서로 원인 찾기

첫 번째는 조회 단계입니다. 테스트 도메인에서 실제 주소가 반환된다면 먼저 FakeDNS를 사용해야 하는 이름인지 확인하세요. 이어서 클라이언트의 DNS 선택, 앱 캐시, 별도의 DNS 서비스 사용 여부를 살펴봅니다. 두 번째는 트래픽 복귀 단계입니다. 합성 주소를 받았지만 앱 연결이 트래픽 처리 로그에 나타나지 않는다면 앱 포함·제외 범위와 해당 주소 대역의 라우팅을 확인하세요. 세 번째는 매핑 단계입니다. 연결은 코어에 들어왔지만 로그에 도메인이 복원되지 않는다면 입구에서 매핑을 지원하는지, 조회와 연결이 같은 인스턴스에서 처리됐는지 확인하세요. 서로 다른 두 도구를 쓰기보다 같은 프로그램에서 조회와 연결을 수행하는 편이 증거를 맞춰 보기 쉽습니다.

코어를 다시 시작하면 앱이 재시작 전 주소를 계속 보유하고 있을 수 있지만 현재 코어에는 해당 매핑이 없을 수 있습니다. 앱 캐시 시간과 코어 동작이 맞지 않으면 풀의 매핑이 사용 중 교체될 수도 있습니다. 이 경우 새 세션을 만들고 앱에서 이름을 다시 조회하도록 한 다음 복구되는지 확인하세요. 특정 내부 서비스나 오래된 앱에서 문제가 반복된다면 해당 이름을 실제 DNS로 되돌리고 도메인 접속과 주소 직접 접속을 다시 비교하세요. 주소 풀, 도메인 규칙, 기본 아웃바운드를 한꺼번에 바꾸면 문제가 해결돼도 원인을 알 수 없습니다.

다중 구독 관리 및 업데이트 순서

출처 변경과 활성 연결을 분리하기

구독 하나를 문제 해결할 때는 특정 가져오기 작업을 살펴보지만, 여러 구독을 관리할 때는 각각 독립적으로 업데이트할 수 있는지가 중요합니다. 출처마다 알아보기 쉬운 그룹 하나를 지정하고 현재 사용 중, 임시 테스트, 예비용을 구분하세요. 업데이트 전에는 활성 항목이 속한 그룹과 실제 프로토콜 및 전송 방식을 기록합니다. 이후 대상 그룹만 새로 고쳐 해당 항목이 남아 있는지, 출처가 다른 설정으로 교체했는지 확인하세요. 목록에 같은 이름이 남아 있어도 서버 주소, 전송 매개변수, 인증 설정이 동일하다는 뜻은 아닙니다. 진행 중인 작업이 활성 연결에 의존한다면 주 사용 출처를 업데이트하기 전에 예비 출처부터 검증하세요.

서버 표시 이름이 같다고 해서 중복 제거 대상이라는 뜻은 아닙니다. 두 출처가 각자 서버에 같은 별칭을 붙였을 수 있으며, 같은 주소를 가리키더라도 권한과 전송 요구 사항은 다를 수 있습니다. 출처를 비교할 때는 먼저 그룹 소속을 확인하고 필요한 프로토콜 및 전송 속성을 로컬에서 대조하세요. 이름만 보고 항목을 합치지 마세요. 선택 실수를 줄이려면 구독에서 생성된 항목을 일괄 수정하기보다 그룹 별칭이나 목록 보기를 조정하는 편이 낫습니다. 다음 업데이트에서 수정 내용이 덮어써질 수 있고 항목의 출처를 구분하기도 어려워집니다.

업데이트 경로를 확인한 다음 자동 새로 고침 설정하기

구독 새로 고침 요청과 서버를 통한 서비스 연결은 서로 다른 작업입니다. 출처에서 특정 네트워크를 통한 요청을 요구한다면 해당 도메인의 조회와 연결 경로, 클라이언트가 현재 프록시로 새로 고침하는지 먼저 확인하세요. 기존 항목이 모두 유효하지 않아 새 항목을 업데이트해야 하는데, 업데이트 요청도 그 기존 항목에 의존하도록 설정된 상황은 순환 의존의 한 예입니다. 같은 실패 경로로 새로 고침을 반복하기보다 승인된 독립 접속 경로를 구독 가져오기에 마련하세요. 먼저 단일 그룹을 수동으로 업데이트해 작동을 확인한 다음 클라이언트의 자동 업데이트 기능을 켜세요.

출처별 요청 횟수 제한이 있다면 자동 업데이트 주기도 각 출처의 요구에 맞게 설정하세요. 한 그룹이 실패했다고 모든 그룹을 연달아 새로 고치지 말고 자동 업데이트를 장애 복구 수단으로 여기지도 마세요. 자동 실행은 절전 모드에서 복귀한 직후, 네트워크를 전환하는 중, 프록시가 아직 준비되지 않은 때 발생할 수 있습니다. 이런 상황에서 업데이트가 실패해도 수동 작업이 성공한 것과 모순되지는 않습니다. 문제를 기록할 때는 요청 당시의 네트워크, 사용 가능한 프록시가 있었는지, 로그가 어느 단계에서 멈췄는지 포함하세요. 같은 조건을 재현할 수 있어야 환경 변화인지 구독 자체의 변경인지 확인할 수 있습니다.

영향 범위에 따라 업데이트 후 문제 해결하기

항목이 사라지면 먼저 대상 그룹과 필터 상태를 확인하고 로그에서 내용을 가져오고 파싱했는지 살펴보세요. 같은 그룹의 항목 여러 개가 함께 바뀌었다면 출처 변경이나 필터 조건 강화일 가능성이 큽니다. 항목 하나만 사라졌다면 출처에서 해당 항목을 내렸는지 따로 확인하세요. 업데이트가 완료됐는데도 클라이언트가 이전 서버로 트래픽을 보내는 경우 이미 연결을 만들고 재사용하는 것인지 새 연결도 실제로 이전 설정을 사용하는지 구분해야 합니다. 테스트 연결을 종료한 뒤 활성 항목을 다시 선택하고 연결을 새로 만드는 편이 목록의 강조 표시만 보는 것보다 확실합니다.

출처를 바꿀 때는 이전 그룹을 단기 복구용으로 남겨 두되, 검증 중 내용이 계속 달라지지 않도록 예약 업데이트는 중지하세요. 새 그룹에서 가져오기와 연결을 확인한 뒤 같은 서비스 테스트로 라우팅과 DNS에 영향이 없는지 검증합니다. 출처를 더 이상 사용하지 않는다면 그룹을 삭제하기 전에 예약 새로 고침을 끄고 해당 출처의 활성 항목이나 예비 설정이 참조되고 있는지 확인하세요. 그룹을 삭제할 때 소속 서버도 함께 제거하는지는 클라이언트마다 다를 수 있습니다. 확인 안내를 읽고 화면의 그룹 이름만 지워지는 것이라고 가정하지 마세요.

기기를 바꿀 때는 대상 클라이언트가 같은 종류의 구독 내용을 지원하는지 먼저 확인한 뒤 출처별로 하나씩 가져오고 검증하세요. 그룹 별칭, 업데이트 프록시 선택, 예약 설정, 활성 항목은 대개 구독 제공 내용에 포함되지 않으므로 새 기기에서 각각 확인해야 합니다. 백업은 접근 제어가 적용된 로컬 위치에 보관할 수 있으며 구독 주소를 공개 협업 문서에 복사할 필요는 없습니다. 설정 화면이나 시스템 프록시 사용이 익숙하지 않다면 빠른 시작 가이드에서 단일 그룹 연결을 먼저 완료한 뒤 이 장으로 돌아와 여러 출처의 업데이트를 구성하세요. 그러면 복구 지점을 더 명확히 정할 수 있습니다.

사용자 지정 아웃바운드 및 태그 연결

최소 설정으로 태그 연결 방식 확인하기

아웃바운드는 연결을 처리할 대상을 정하고 라우팅은 언제 그 대상으로 보낼지를 정합니다. 아웃바운드 정의의 tag는 설정 내부에서 참조하는 이름이며 규칙에서 outboundTag로 지정합니다. 클라이언트 목록에 표시되는 서버 별칭은 이런 참조 이름이 아닙니다. 기존 설정에 아웃바운드를 추가하기 전에 사용 중인 태그를 확인하고 겹치지 않는 이름을 선택한 다음, 어떤 규칙에도 일치하지 않을 때 사용할 출구를 정하세요. 아웃바운드 이름만 바꾸고 라우팅 참조를 수정하지 않거나 새 출구를 실수로 배열 첫 항목에 넣으면 실제 트래픽 분기가 달라질 수 있습니다.

아래는 로컬 SOCKS 인바운드, 직접 연결, 차단 아웃바운드의 관계를 확인하기 위해 단독 실행할 수 있는 Xray 최소 설정입니다. 리스닝 범위는 로컬 기기로 제한되므로 구독이나 원격 계정이 필요하지 않습니다. 시작하기 전에 실행 중인 클라이언트가 해당 포트를 사용하고 있지 않은지 확인하세요. 포트를 변경하면 테스트 앱의 프록시 포트도 함께 바꿔야 합니다. 이 예시는 시스템 프록시나 TUN을 활성화하지 않으므로 리스닝 포트를 명시적으로 지정하지 않은 앱의 트래픽은 처리하지 않습니다. 이번 테스트에서 리스닝 주소를 다른 기기에서도 접근할 수 있는 주소로 바꾸지 마세요.

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

인터넷 연결 여부뿐 아니라 규칙 일치 여부도 테스트하기

테스트 앱에서 프록시를 통해 도메인을 전달해야 합니다. 예를 들어 프록시 측 DNS 조회를 지원하는 SOCKS 모드를 선택하세요. 먼저 예시의 전체 도메인에 접속한 뒤 사용할 수 있는 공개 도메인에 접속합니다. 첫 번째 도메인은 차단 아웃바운드로 전달되어야 하며, 규칙에 맞지 않는 두 번째 도메인은 첫 번째 직접 연결 아웃바운드를 사용합니다. 테스트 프로그램이 로컬에서 이름을 조회한 뒤 주소만 입구에 전달하면 이 예시에서 전체 도메인으로 매칭되지 않습니다. 차단 규칙을 검증할 때는 로그에서 선택된 태그를 확인하세요. 브라우저 오류만으로 판단해서는 안 됩니다. DNS 조회 실패, 프록시 미실행, 테스트 앱의 잘못된 포트 사용도 페이지가 열리지 않는 결과를 낼 수 있습니다.

실제 설정에 프록시 아웃바운드를 추가할 때는 프로토콜 매개변수, 전송 계층 매개변수, 서버와 합의한 보안 설정을 함께 확인해야 합니다. 공유 링크는 연결에 필요한 일부 매개변수만 포함할 수 있으므로 앱 전체의 인바운드, 라우팅, DNS 설정을 대신하지 않습니다. 새 아웃바운드를 전용 테스트 규칙 하나에만 연결해 시작, 규칙 일치, 연결이 각각 성공하는지 확인한 뒤 적용 범위를 넓히세요. 프로토콜이 다른 아웃바운드 객체는 protocol 필드 하나를 바꿔 다른 프로토콜로 변환할 수 없습니다. 관련 설정 구조는 프로토콜마다 다르므로 사용하는 코어의 해당 프로토콜 정의를 기준으로 하세요.

클라이언트 생성 파일과 수동 설정 구분하기

그래픽 클라이언트는 서버 전환, 라우팅 변경, 재연결 시 새 설정 파일을 생성할 수 있습니다. 임시 생성 파일을 직접 편집하면 한 번은 실행되더라도 다음 업데이트에서 변경 사항이 덮어써질 수 있습니다. 네이티브 설정을 계속 사용하려면 먼저 해당 클라이언트에서 사용자 지정 설정을 지원하는지 확인한 다음 별도의 원본 파일과 마지막으로 정상 작동한 사본을 저장하세요. 예시의 배열을 현재 구독 설정 위에 그대로 덮어쓰면 안 됩니다. 기존 로컬 인바운드, 기본 아웃바운드, 클라이언트의 트래픽 처리에 필요한 태그가 사라질 수 있습니다. 사용하는 코어와 실행 방식에 맞춰 통합하세요.

디버깅 순서를 고정해 보세요. 설정을 읽을 수 있는지, 인바운드가 정상적으로 바인딩되는지, 테스트 요청이 인바운드에 도달하는지, 규칙이 예상한 태그와 일치하는지, 아웃바운드 연결이 완료되는지 순서대로 확인합니다. 첫 단계에서 실패하면 오류가 발생한 필드와 괄호 구조를 먼저 확인하세요. 마지막 단계에서만 실패한다면 선택한 아웃바운드의 네트워크와 서버 매개변수를 점검하면 됩니다. 테스트를 마친 뒤 로그 수준을 적절히 낮추고 접속 대상이 포함된 상세 로그를 장기간 보관하지 마세요. 진단 내용을 공유할 때는 서버 식별자, 인증 정보, 비공개 이름을 지우고 필드 구조와 재현에 필요한 맥락만 남기세요.

다중 코어 전환 및 호환성

프로토콜 요구 사항에 맞춰 코어 선택하기

클라이언트는 설정 관리, 연결 시작, 로그 표시를 담당하고 코어는 설정을 해석해 트래픽을 처리합니다. 데스크톱에서는 v2rayN을 주로 사용합니다. 클라이언트 다운로드 페이지에서 운영체제와 아키텍처에 맞는 항목을 선택하세요. Windows 데스크톱 버전과 클래식 WPF 버전은 인터페이스 구현의 차이이며, 해당 선택만으로 실제 사용 중인 코어를 알 수는 없습니다. Android에서는 Xray를 사용하는 v2rayNG가 주로 사용되며 V2Fly 코어가 필요하다면 v2flyNG를 고려할 수 있습니다. Android 앱에서 항상 공통 코어 전환 버튼을 제공한다고 생각하지 마세요.

V2Ray 생태계를 이해하려면 Project V부터 살펴보세요. V2Fly는 V2Ray 프로젝트를 이어받았고 Xray도 기술적 뿌리를 공유하지만, 설정 모델이 계속 같은 방식으로 발전한 것은 아닙니다. 프로토콜 이름이 같다는 이유만으로 서로 바꿔 쓸 수 있다고 판단해서도 안 됩니다. 서버가 요구하는 전송 방식과 보안 매개변수, 클라이언트 지원 범위를 모두 충족해야 합니다. 예를 들어 서버에서 REALITY를 명시적으로 요구한다면 해당 방식을 실제로 지원하는 코어와 설정 입구를 선택해야 합니다. 서버 주소와 포트만 유지한다고 다른 코어로 이전할 수 있는 것은 아닙니다. 프로토콜 선택에 따른 차이는 네 가지 프록시 프로토콜의 특징 및 사용 시나리오 비교에서 확인할 수 있습니다.

이전할 때 설정 계층별로 유지할 항목 확인하기

전환 전에 활성 프로토콜, 전송 방식, 트래픽 처리 모드, 실제 라우팅 및 DNS 동작을 기록하세요. v2rayN에서는 화면에 표시되는 항목 유형과 코어 설정에 맞춰 지원되는 조합을 선택해야 합니다. 항목마다 코어를 지정할 수 있는지는 클라이언트에서 사용하는 설정 형식에 따라 달라집니다. 테스트 항목으로 새 조합을 검증하고 일상적으로 쓰는 유일한 설정은 바로 수정하지 마세요. 설정이 시작된 뒤 로그에서 실제로 실행된 코어와 항목 파싱 여부를 확인하세요. 화면에서 선택할 수 있는 옵션이 실제 실행 설정에 나타나지 않는다면 다른 유형의 인바운드나 설정 형식에만 적용되는 항목인지 먼저 점검하세요.

이전 과정에서는 비슷한 개념을 같은 설정이라고 착각하기 쉽습니다. 두 코어 모두 라우팅, DNS, 스니핑 기능이 있을 수 있지만 매개변수 이름, 허용 값, 리소스 분류는 다를 수 있습니다. 먼저 ‘인바운드 트래픽 처리, 서비스 아웃바운드, 분기 규칙, DNS 정책’ 네 계층으로 최소 설정을 다시 구성하세요. 하나의 입구와 목적지 하나로 연결을 확인한 다음 규칙과 DNS 설정을 차례로 가져옵니다. 다른 코어의 네이티브 설정 전체를 그대로 붙여 넣지 말고, 설정을 실행하기 위해 인식되지 않는 필드를 모두 삭제하지도 마세요. 일부 필드는 기존 아웃바운드 동작에 필요하며 이를 삭제하면 조용히 기본 경로로 처리될 수 있습니다.

반복 가능한 테스트로 검증하고 복구 경로 남기기

한 차례 검증에서는 세 가지 질문에 답할 수 있어야 합니다. 클라이언트가 의도한 코어를 시작했는지, 테스트 연결이 어떤 아웃바운드로 전달됐는지, 앱의 DNS 결과 또는 실제 연결이 예상과 일치하는지 확인하세요. 먼저 앱 하나와 동작이 확인된 대상 하나로 연결을 검증한 다음 특정 규칙에 일치하는 트래픽과 기본 경로를 따라야 하는 트래픽을 테스트합니다. UDP를 처리하거나 내부 서비스를 이용해야 한다면 일반 연결이 성공한 뒤 추가로 테스트하세요. 웹페이지 하나로 모든 업무를 검증할 수는 없습니다. 두 결과를 비교할 때는 가능하면 같은 네트워크, 같은 기기, 같은 테스트 앱을 사용해 네트워크 변화를 코어 전환의 영향으로 오해하지 않도록 하세요.

문제가 발견되면 단계별로 확인하세요. 코어가 시작되지 않으면 설치 파일과 프로세서 아키텍처를 확인하고 초기화 오류를 살펴보세요. 코어는 시작되지만 핸드셰이크에 실패한다면 프로토콜과 전송 매개변수가 서버 요구 사항에 맞는지 확인합니다. 연결은 되지만 분기가 잘못되면 라우팅 및 DNS 장으로 돌아가 원인을 찾으세요. 실행 환경이 아직 준비되지 않았다면 다운로드 페이지의 시스템 요구 사항과 자주 묻는 질문을 확인할 수 있습니다. 되돌릴 때는 기존 항목, 라우팅 구성, 트래픽 처리 방식을 복구한 뒤 새 세션으로 확인하세요. 코어 이름만 다시 선택해서는 충분하지 않습니다. 검증이 끝날 때까지 정상 작동했던 조합 전체를 보관하는 편이 개별 스위치 몇 개를 기억하는 것보다 유용합니다.