초기 연결을 마친 뒤 참고하는 페이지입니다. 처음 설치하고 구독을 가져온 다음 연결을 확인하려면 입문 가이드를 먼저 살펴보세요. 플랫폼을 바꾸거나 재설치할 때는 다운로드 센터에서 해당 설치 파일을 선택하세요. 데스크톱에서는 v2rayN을 우선 권장하며, 아래 GUI 설명은 v2rayN을 기준으로 합니다. 본문의 JSON은 Xray 설정 구조를 기준으로 설명하므로 다른 코어의 편집기에 그대로 붙여 넣지 마세요.
설정 이름은 클라이언트 인터페이스와 코어에 따라 다를 수 있습니다. 한 번에 한 단계씩만 변경하고 같은 앱과 대상에 다시 연결해 확인하세요. 먼저 항목이 가져와졌는지 확인하고, 트래픽이 예상한 인바운드로 들어오는지 살펴본 다음, DNS 응답과 아웃바운드 선택을 점검하세요. 가져온 항목이 없거나 실행되지 않는 등 입문 단계의 문제는 v2rayN 초보자 질문 10가지도 참고하세요.
구독 그룹 및 서버 필터링
소스 그룹, 화면 검색, 가져오기 필터 구분하기
구독 그룹에는 소스 주소, 업데이트 옵션, 가져온 서버 항목이 함께 묶입니다. 서버 목록 위쪽의 검색은 현재 화면에 표시되는 항목만 좁히며 구독 캐시를 지우지 않습니다. 그룹 편집 화면의 필터는 업데이트 시 조건에 맞지 않는 항목을 건너뛸 수 있습니다. 두 곳에 같은 문구를 입력해도 결과가 다를 수 있습니다. 그룹 이름은 클라이언트에서 소스를 구분하는 용도일 뿐, 프로토콜 연결에는 영향을 주지 않습니다. 이름에는 용도와 소스의 관계를 명확히 적고, 주소에 포함된 접근 매개변수는 이름이나 스크린샷, 문제 기록에 넣지 마세요.
v2rayN의 구독 그룹 메뉴에서 그룹 설정을 열고 소스를 추가해 저장한 다음, 메인 목록에서 해당 그룹을 선택하세요. 업데이트 메뉴에서는 처음부터 전체 구독을 갱신하지 말고 현재 구독만 선택하세요. 첫 업데이트 때는 원본 항목을 그대로 가져오고 필터는 설정하지 마세요. 업데이트가 끝나면 화면 검색을 비우고 그룹에 정상적으로 사용할 수 있는 항목이 하나 이상 있는지 확인한 뒤, 해당 소스의 이름 표기 규칙을 살펴보세요. 먼저 전체 항목을 기준으로 확보해야 나중에 항목이 줄었을 때 서버 측 변경, 가져오기 실패, 로컬 필터 중 원인을 구분할 수 있습니다.
전체 서버 이름을 기준으로 필터 만들기
필터는 대개 서버 이름을 대상으로 하며 주소 필드, 프로토콜 속성 또는 사용자 지정 그룹 이름에는 적용되지 않습니다. 현재 화면에 정규식 지원이 표시되어 있다면 실제로 존재하는 서버 이름 하나로 먼저 테스트한 뒤 비슷한 이름 전체에 적용하세요. 예를 들어 서버 이름이 ‘가정용’으로 시작하고 뒤에 공백이나 하이픈이 올 수 있다면 아래 정규식을 사용할 수 있습니다. 이름이 ‘가정용’만으로 끝나는 항목도 포함됩니다. 정규식 입력란에는 프로그래밍 언어에서 쓰는 슬래시 구분자를 붙이지 말고 그대로 입력하세요. 편집란이 일반 텍스트만 지원한다면 변하지 않는 짧은 단어를 사용하고 결과를 하나씩 확인하세요.
^가정용(?:[\s-]|$)
옵션 이름만 보고 필터가 어떻게 적용되는지 단정하지 마세요. 인터페이스에 따라 일치 항목을 유지하거나 제외할 수도 있고, 화면 표시만 제한할 수도 있습니다. 저장하기 전에 필드 안내를 확인하고 업데이트 후에는 유지되어야 할 이름과 제외되어야 할 이름을 하나씩 대조하세요. 전각 괄호, 긴 대시, 앞쪽 공백, 대소문자도 일치 결과를 바꿉니다. 여러 접두어를 허용해야 한다면 후보 단어를 같은 그룹에 넣고 그룹 바깥에 시작 앵커를 하나만 두세요. 지나치게 넓은 정규식을 먼저 작성한 뒤 예외를 덧붙이지 마세요. 소스의 이름 규칙이 바뀌면 어떤 항목이 목록에 들어왔는지 파악하기 어려워집니다.
그룹 수준에서 필터를 설정했다면 조건을 바꾼 뒤 해당 그룹을 업데이트해야 적용되는 경우가 많습니다. 이미 가져온 목록에 변경 사항이 바로 반영되지는 않을 수 있습니다. 업데이트 전에 기존 규칙을 로컬에 복사하고 현재 사용하는 항목을 기록해 두세요. 일부 소스는 업데이트 과정에서 그룹의 항목을 다시 구성하므로 기존 항목의 내부 식별자가 바뀌고 선택 상태가 사라질 수 있습니다. 업데이트 후 항목을 다시 선택하고 연결을 테스트하세요. 규칙은 소스 관리자가 유지하는 이름 규칙을 기준으로 삼고, 업데이트 후 사라질 로컬 메모에 의존하지 마세요. 별도로 관리해야 하는 설정은 자동 업데이트 그룹과 분리해 보관하세요.
로그로 빈 목록 원인 찾기
업데이트 후 목록이 비었다면 먼저 업데이트 로그에 응답을 받았다고 표시되는지 확인하세요. 요청 시간 초과, 주소 만료, 콘텐츠 파싱 실패는 서로 다른 문제입니다. 시간 초과라면 현재 네트워크와 업데이트 방식, 주소의 유효성을 확인하세요. 파싱에 실패했다면 소스가 클라이언트에서 인식하는 구독 형식으로 응답하는지 확인하세요. 로그인 페이지나 오류 메시지가 반환된 것은 아닌지도 살펴보세요. 파싱은 성공했는데 항목이 가져와지지 않았다면 그룹 필터를 지우고 해당 그룹만 다시 업데이트한 뒤, 잘못된 그룹에 머물러 있거나 검색어가 남아 있지 않은지 확인하세요. 여러 소스를 같은 주소로 바꿔 시험하지 말고 구독 주소 전체를 공개된 기록에 붙여 넣지 마세요.
같은 소스에서 일부 항목만 가져와진다면 먼저 로그에서 건너뛴 항목의 유형을 확인하고, 지원되지 않는 형식인지 이름이 필터에 맞지 않은 것인지 구분하세요. 필터를 검증된 이름 하나만 남기도록 잠시 좁혀 규칙을 바꿨을 때 문제가 달라지는지 확인할 수 있습니다. 필터를 끄자 항목은 복구됐지만 연결되지 않는다면 해당 항목의 프로토콜 매개변수, 현재 선택된 코어, 연결 로그를 살펴보세요. 필터를 계속 바꿀 필요는 없습니다. 이 소스가 안정적으로 동작한 뒤 다른 그룹을 정리하세요. 업데이트를 분리하고 예비 소스를 유지하는 방법은 다중 구독 관리를 참고하세요.
라우팅 규칙 실전
연결이 코어에 들어올 때의 주소 기준으로 매칭하기
라우팅은 연결이 어떤 규칙과 일치하는지, 일치 후 어떤 아웃바운드로 전달되는지를 결정합니다. 앱에 프록시를 자동 적용하거나 코어에 들어오지 않은 요청에 규칙을 적용하지는 않습니다. 먼저 v2rayN에서 라우팅 설정을 열고 메인 화면에서 편집 중인 규칙 세트가 활성화되어 있는지 확인한 뒤 규칙 순서를 바꾸세요. 시스템 프록시, 앱에서 따로 설정한 로컬 프록시, TUN은 연결을 서로 다른 인바운드로 보낼 수 있습니다. 문제를 해결할 때는 경로를 하나로 고정하세요. 세 방식을 한꺼번에 바꾸면 결과가 무작위처럼 보일 수 있습니다.
먼저 코어에 전달된 값이 도메인인지 IP 주소인지 확인하세요. 앱이 로컬 프록시에 도메인을 전달하면 도메인 규칙을 바로 적용할 수 있습니다. 앱이 먼저 DNS 조회를 한 다음 연결하면 인바운드에는 목적지 주소만 전달될 수 있습니다. 트래픽 스니핑으로 일반적인 프로토콜의 핸드셰이크에서 도메인을 찾아낼 수 있지만, 요청에 식별 가능한 정보가 실제로 포함된 경우에만 가능합니다. 모든 앱에서 도메인이 전달되는 것은 아닙니다. 로그에 주소만 표시된다면 앱의 프록시 설정과 인바운드 스니핑이 적용되는지 먼저 확인한 다음, 앱이 도메인을 전달하도록 할지 관리 대상 주소에 서브넷 규칙을 추가할지 결정하세요.
예외 규칙을 포괄적인 규칙보다 먼저 배치하기
Xray는 설정 순서대로 라우팅 규칙을 확인하며 가장 먼저 일치한 항목이 연결 경로를 결정합니다. 특정 유지보수 도메인은 직접 연결하고 같은 도메인 접미사의 나머지 연결은 프록시로 보내려면 전체 도메인 규칙을 먼저, 도메인 접미사 규칙을 다음에 작성하세요. full:은 정확히 일치하는 도메인만, domain:은 지정된 도메인과 하위 도메인을 매칭합니다. 우선순위가 다르면 규칙을 두 개로 나눠야 합니다. 하나의 규칙에 있는 서로 다른 필드는 보통 모두 충족해야 합니다. 예를 들어 도메인과 포트를 함께 지정하면 해당 도메인의 지정 포트에 연결하는 경우를 뜻하며, 둘 중 하나만 맞아도 되는 것은 아닙니다.
다음은 보존용 도메인 example.net을 사용해 순서를 보여 주는 Xray 설정의 routing 예시입니다. 테스트 설정의 같은 이름 객체에 병합하고 기존 규칙 전체를 덮어쓰지 마세요. 두 태그는 모두 해당 설정의 outbounds에 있어야 하며, 의도한 연결 경로를 실제로 나타내야 합니다. 인터페이스에서 다른 태그를 사용한다면 같은 이름의 아웃바운드를 중복 생성하지 말고 태그를 바꾸세요. 예시 호스트는 공개적으로 접속 가능한 서비스에 의존하지 않습니다. 매칭을 확인하려면 직접 DNS 조회와 접속이 가능한 테스트 도메인으로 바꾸세요.
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["full:maintenance.example.net"],
"outboundTag": "direct"
},
{
"type": "field",
"domain": ["domain:example.net"],
"outboundTag": "proxy"
}
]
}
}
규칙에 일치하지 않을 때의 동작 확인하기
AsIs는 라우팅 매칭을 위해 도메인을 추가로 조회하지 않습니다. IPIfNonMatch는 도메인 대상에 일치하는 규칙이 없으면 조회를 수행한 뒤 IP 규칙을 다시 확인합니다. IPOnDemand는 매칭 과정에서 IP가 필요한 규칙을 만났을 때 조회합니다. 도메인 조회 정책은 아웃바운드의 최종 DNS 조회 정책과 다릅니다. 로그에 DNS 조회 기록이 있어도 최종 연결이 직접 연결인지 프록시인지 판단할 수는 없습니다. 끝에 전체 트래픽을 포괄하는 규칙이 있으면 첫 확인에서 이미 일치할 수 있으므로, IPIfNonMatch가 앞서 있는 IP 규칙을 다시 시도할 것이라고 기대하지 마세요.
정확한 도메인, 같은 접미사를 쓰는 다른 호스트, 규칙 범위 밖의 호스트를 차례로 테스트한 다음 로그에서 인바운드와 아웃바운드 태그를 확인하세요. 어떤 규칙에도 일치하지 않으면 Xray는 설정에서 첫 번째 아웃바운드를 사용하므로 순서를 바꾸면 규칙에 걸리지 않은 연결도 달라질 수 있습니다. 로그에 첫 번째 아웃바운드를 사용했다고만 나온다면 매칭 조건이 빠졌는지, 활성화되지 않은 규칙 세트를 수정한 것은 아닌지 확인하세요. 연결을 새로 시작하는 것도 중요합니다. 기존 장기 연결은 규칙 변경 후 바로 재생성되지 않을 수 있으므로 이전 세션으로 테스트하면 결과를 잘못 판단할 수 있습니다.
트래픽이 잘못 분기되면 현재 규칙 순서를 내보내거나 기록한 다음 새로 추가한 규칙을 임시로 옮겨 다시 테스트하세요. 규칙 문제로 확인되면 범위를 제어 가능한 도메인 하나로 좁힌 뒤 접미사, 서브넷, 포트 범위로 단계적으로 넓히세요. 도메인 또는 IP 데이터 파일을 사용할 때 로그에 데이터 세트가 없다고 표시된다면 참조를 고치거나 기존 데이터 파일의 소스를 복구하세요. 라우팅 전체를 다시 작성할 필요는 없습니다. 요청 경로를 정확히 확인하려면 같은 요청의 로그를 비교하세요. 홈페이지의 사용량 수치나 전반적인 연결 상태로 개별 규칙의 결과를 대신 판단하지 마세요.
DNS 설정 최적화
DNS 조회를 어느 계층에서 처리하는지 확인하기
브라우저, 운영체제, 프록시 코어, 프록시 서버 모두 도메인을 조회할 수 있습니다. 같은 페이지의 리소스를 불러올 때도 여러 경로가 섞일 수 있습니다. 시스템 DNS 조회 도구의 결과는 해당 도구가 선택한 리졸버만 보여 주며 브라우저나 코어가 같은 응답을 받는다는 뜻은 아닙니다. 같은 네트워크에서 안정적인 공개 도메인 하나와 사용할 권한이 있는 내부 도메인 하나를 선택해 시스템 조회 결과와 코어 로그를 각각 기록하세요. 시스템에서는 조회되지만 프록시 앱에서 실패한다면 앱이 도메인과 IP 주소 중 무엇을 프록시에 전달하는지 먼저 확인하고 시스템 리졸버를 바로 바꾸지는 마세요.
v2rayN의 매개변수 설정에서 실제 사용 중인 코어를 확인한 뒤 해당 코어의 DNS 설정을 여세요. 기본 설정, 사용자 지정 설정, 클라이언트 생성 설정은 각각 진입 경로가 다릅니다. 별도의 사용자 지정 설정으로 실행 중이라면 일반 설정을 바꿔도 변경 사항이 적용되지 않을 수 있습니다. 저장 후 적용된 설정을 확인하고 필요한 경우 코어를 다시 불러오세요. 로그를 비교할 때는 조회 도메인, 반환된 주소 유형, 시간 초과 여부, 요청에 사용된 최종 아웃바운드를 기록하세요. 그래야 주소 조회 실패, 주소에 연결할 수 없는 문제, DNS 트래픽이 적절하지 않은 아웃바운드로 전달된 문제를 구분할 수 있습니다.
전용 리졸버를 사용할 도메인 범위 지정하기
내부 서비스는 전용 IP 주소를 반환하는 사내 DNS가 필요할 수 있지만 모든 도메인을 같은 경로로 조회할 필요는 없습니다. 아래 Xray 예시는 로컬 DNS 서버가 이미 있는 테스트 환경에서만 사용하세요. 로컬 5353 포트는 lab.example.net과 그 하위 도메인을 처리하고, 나머지 조회는 시스템 리졸버로 전달할 수 있습니다. 이 예시는 외부 연결을 수신하는 설정이 아니며 서버를 실행할 수 없습니다. 사용 전에 테스트 리졸버가 해당 포트의 루프백 주소에서 이미 대기 중인지 확인하세요. 시스템 리졸버가 다른 설정을 통해 이 Xray DNS에 의존하도록 구성하면 안 됩니다. DNS 조회가 반복되어 재귀가 발생할 수 있습니다.
{
"dns": {
"servers": [
{
"address": "127.0.0.1",
"port": 5353,
"domains": ["domain:lab.example.net"],
"skipFallback": true
},
"localhost"
],
"disableFallbackIfMatch": true
}
}
skipFallback은 해당 DNS 서버를 일반 대체 경로에서 제외한다는 뜻입니다. disableFallbackIfMatch는 전용 범위에 일치할 경우 일반 대체 경로로 다시 전환하지 않는다는 뜻입니다. 따라서 내부 도메인 조회가 실패하면 다른 리졸버가 다른 응답을 반환해 잘못 연결되는 대신 오류를 확인할 수 있습니다. 별도의 네트워크 환경에서 검사한 뒤 실제로 이중화가 필요하다면 제한을 해제하지 말고 같은 내부 레코드를 알고 있는 DNS 서버를 동일한 범위에 추가하세요. 내장 DNS는 실제로 전달된 조회만 처리합니다. 이 설정만 추가한다고 모든 시스템 요청이나 앱 자체 DNS 조회가 자동으로 다른 경로로 바뀌지는 않습니다.
상위 DNS 서버가 도메인 이름을 사용하는 암호화된 DNS 엔드포인트라면 클라이언트는 먼저 해당 엔드포인트의 주소를 알아내고 접속할 수 있어야 합니다. 초기 조회가 아직 연결되지 않은 동일한 상위 서버를 다시 가리키도록 하지 마세요. DNS 조회가 프록시를 통과한다면 프록시 서버 자체의 도메인도 별도로 먼저 조회할 수 있는지 확인하세요. 이 두 가지 의존성을 따로 기록한 다음 전용 DNS와 일반 DNS를 구성하세요. 그렇지 않으면 로그에 시간 초과가 반복되어 상위 DNS 서버 문제처럼 보일 수 있지만 실제로는 연결이 로컬 장치를 벗어나지 않았을 수 있습니다. 진단할 때는 일시적으로 작동이 확인된 DNS 구성으로 되돌려 프록시 연결을 확인한 뒤 암호화된 상위 DNS를 다시 설정하세요.
주소 유형, 캐시, 연결을 나눠 확인하기
네트워크에서 사용할 주소 유형의 경로를 확인한 뒤에만 조회 정책을 변경하세요. 앱은 IPv4와 IPv6를 모두 조회할 수 있으며 주소를 두 개 받았다고 두 경로 모두 접속 가능한 것은 아닙니다. 처음 페이지를 여는 데 오래 걸린다면 로그에서 어떤 조회가 완료됐고 어떤 연결이 시간 초과됐는지 구분한 다음 앱에 맞는 정책을 선택하세요. 처음부터 특정 주소 유형을 전역에서 모두 차단하지 마세요. 캐시를 지우지 않으면 설정을 바꿔도 효과가 없는 것처럼 보일 수 있습니다. 테스트 앱을 종료하거나 앱의 DNS 캐시를 지우고, 필요하면 시스템 캐시도 갱신한 뒤 새 연결을 만드세요. 이전 페이지가 계속 열린다는 사실을 근거로 삼지 마세요.
되돌릴 때는 서버 순서, 도메인 범위, 조회 정책을 모두 원래대로 복구하세요. 주소 하나만 바꾸는 것으로는 충분하지 않습니다. TUN을 켰을 때만 문제가 생긴다면 가상 네트워크 어댑터의 DNS 가로채기 범위를 확인하세요. 명확한 합성 주소가 반환된다면 FakeDNS 장에서 해당 주소와 트래픽 분기의 관계를 점검하세요. 지연은 노드나 네트워크 경로 문제일 수도 있습니다. 속도 저하 단계별 점검을 참고해 같은 대상으로 DNS 조회 대기 시간과 연결 후 데이터 전송 시간을 구분하세요.
TUN 모드
먼저 시스템 프록시 기준 상태 만들기
시스템 프록시는 앱이 프록시 설정을 읽어야 동작합니다. TUN은 가상 네트워크 어댑터를 만들어 시스템 라우팅 조건에 맞는 패킷을 트래픽 가로채기 구성 요소로 전달합니다. 가상 어댑터가 있다고 모든 트래픽이 그곳을 통과하는 것은 아닙니다. 운영체제의 라우팅 우선순위, 제외 서브넷, 다른 가상 인터페이스, 앱에 지정된 물리 네트워크 어댑터가 모두 결과를 바꿀 수 있습니다. TUN을 켜기 전에 v2rayN의 시스템 프록시 모드에서 브라우저 하나를 테스트하고 접근 권한이 있는 내부 서비스를 비교 대상으로 정하세요. 두 대상의 원래 네트워크에서의 응답과 연결 상태를 기록해 두어야 경로가 바뀐 지점을 알아낼 수 있습니다.
테스트 전에 시스템 라우팅이나 DNS를 변경하는 다른 클라이언트를 비활성화하세요. 조직에서 관리하는 네트워크에서는 관리 정책을 따르고 조직이 배포한 설정을 바꾸지 마세요. 첫 시험에서 노드, 라우팅 규칙, DNS, TUN 매개변수를 동시에 바꾸지 마세요. 같은 앱이 로컬 프록시에 직접 연결되는 동시에 가상 어댑터 규칙의 영향을 받지 않도록 시스템 프록시를 먼저 원래 상태로 되돌리는 것이 좋습니다. 다른 네트워크 어댑터를 계속 사용해야 한다면 TUN을 끈 뒤 원래 경로가 복구됐는지 확인할 수 있도록 어댑터의 활성화 상태와 용도를 기록하세요.
가상 어댑터를 켜고 트래픽 가로채기 범위 확인하기
v2rayN에서 먼저 작동하는 서버를 선택하고 현재 라우팅 구성을 확인한 다음 메인 화면에서 TUN 모드를 켜세요. 가상 어댑터를 만들거나 시스템 라우팅을 변경하려면 시스템 권한이 필요할 수 있으니 클라이언트와 운영체제의 안내를 따르세요. 시작 경고가 표시되면 스위치를 반복해서 누르지 말고 클라이언트 로그에서 인터페이스가 생성됐는지, 라우트가 추가됐는지 확인하세요. 실제 트래픽 가로채기 구성 요소는 서버에서 사용하는 코어와 다를 수 있습니다. Xray 설정 한 곳에 저장이 성공했다고 해서 가로채기 구성 요소도 같은 인바운드, DNS, 제외 범위를 적용했다는 뜻은 아닙니다. 원인을 찾을 때는 각 구성 요소의 로그를 따로 확인하세요.
아래 읽기 전용 명령으로 시스템 라우팅을 확인하세요. 명령은 비교를 돕는 용도이며 로그를 대신하지 않습니다. TUN을 켜기 전과 후에 각각 확인하고 프록시 서버 주소, 내부 서비스 주소, 일반 대상이 각각 어떤 인터페이스를 사용하는지 살펴보세요. 구현에 따라 더 세분화된 접두어나 정책 라우팅으로 가로채기 범위를 나눌 수도 있으므로 기본 경로 한 줄만으로 가로채기 여부를 판단하지 마세요.
| 운영체제 | 확인 명령 | 우선 확인할 항목 |
|---|---|---|
| Windows | route print | 인터페이스 목록, 활성 라우트, 메트릭. |
| macOS | netstat -rn | 대상 서브넷, 다음 홉, 인터페이스 이름. |
| Linux | ip route show table all、ip rule show | 정책 규칙에서 참조하는 라우팅 테이블과 해당 인터페이스. |
트래픽 가로채기 후 모든 대상이 시간 초과된다면 먼저 프록시 서버 연결이 가상 어댑터로 되돌아가는지 확인하세요. 우회가 필요하다면 가로채기 구성 요소에서 제공하는 아웃바운드 인터페이스 바인딩 또는 제외 기능을 사용해 서버 연결이 실제 네트워크 인터페이스로 나가도록 하세요. 서버 주소에 도메인을 사용한다면 특정 시점의 IP 하나만 제외하는 방법은 오래 유효하지 않을 수 있습니다. 내부 서비스만 연결되지 않는다면 해당 서브넷이 가상 어댑터로 잘못 전달되고 있는지 확인하고 실제로 필요한 서브넷만 조정하세요. 모든 사설 주소를 한꺼번에 제외하거나 모든 내부 연결을 프록시로 보내지 마세요.
DNS, UDP, MTU를 나눠 점검하기
IP 주소로는 접속되지만 도메인으로는 실패한다면 먼저 가로채기 구성 요소가 DNS 조회를 예상한 리졸버로 전달하는지 확인하세요. 일반 웹페이지는 열리지만 실시간 앱이 실패한다면 앱이 사용하는 전송 프로토콜, 인바운드에 해당 패킷이 도착하는지, 선택한 아웃바운드가 해당 프로토콜을 지원하는지 살펴보세요. 작은 요청은 성공하고 큰 데이터를 전송할 때 끊기는 경우에만 MTU를 원인 후보에 포함하세요. TUN을 끈 결과와 비교하고 기존 값을 기록한 뒤 명확한 테스트 경로에서 조금씩 조정하며 매번 새로 연결하세요. 속도 측정 결과의 변동만으로 MTU 문제라고 단정할 수 없습니다.
테스트를 마치면 먼저 TUN을 끄고 인터페이스와 라우트가 기준 상태로 돌아왔는지 확인하세요. 시스템 프록시도 원래 용도에 따라 복구해야 하는지 점검하세요. 내부 도메인 조회가 계속 이상하다면 현재 시스템 DNS 설정과 관련 프로세스가 실행 중인지 살펴보고, 정체를 모르는 인터페이스나 라우트를 무작정 삭제하지 마세요. 절전 모드에서 깨어나거나 무선 네트워크를 바꾼 뒤에도 다시 테스트하세요. 인터페이스나 다음 홉이 달라졌을 수 있습니다. 자세한 증상별 안내는 TUN 가상 네트워크 어댑터 설정 안내를 참고하세요.
FakeDNS
합성 주소에서 원래 도메인으로 매핑 추적하기
FakeDNS가 반환하는 것은 대상 서버의 실제 주소가 아니라 합성 주소입니다. 구성 요소는 요청자에게 주소를 반환하는 동시에 주소와 도메인의 매핑을 저장합니다. 이후 앱이 해당 주소로 연결하면 트래픽 가로채기 인바운드가 연결을 받아 같은 매핑에서 도메인을 찾아야 합니다. 도메인을 복원한 다음에야 도메인 규칙으로 경로를 선택하고 해당 아웃바운드가 실제 대상에 연결할 수 있습니다. 앱이 먼저 DNS 조회를 한 뒤 패킷을 보내는 상황에서 이 방식을 자주 사용합니다. 이 기능은 도메인을 보존하고 복원하는 방법을 바꾸는 것이지 모든 DNS 조회를 빠르게 하거나 모든 앱이 같은 인바운드를 사용하도록 보장하지는 않습니다.
FakeDNS를 끈 상태에서 먼저 TUN을 정상 동작시켜 일반 DNS 조회, 인바운드 가로채기, 도메인 규칙이 각각 작동하는지 확인하세요. 그런 다음 실제로 DNS 응답을 반환하는 구성 요소와 데이터 패킷을 받는 구성 요소가 매핑을 공유하는지 확인하세요. 클라이언트의 트래픽 가로채기를 다른 구성 요소가 담당한다면 해당 구성 요소의 설정 형식에 맞춰 지원 범위를 확인하세요. Xray 필드를 그대로 그 구성 요소의 편집기에 붙여 넣으면 안 됩니다. 테스트 환경에서 한 구성 요소의 로그만 볼 수 있다면 요청 측에서 반환 주소를 기록하고 인바운드에서 후속 연결이 예상한 프로세스로 전달되는지 확인하세요.
주소 풀, DNS 전달, 인바운드 설정을 함께 복구하기
다음 세 부분은 Xray 전용 설정 예시입니다. 테스트 주소 풀을 설정하고 lab.example.net 범위에서만 합성 DNS 조회를 사용합니다. 병합할 때 다른 리졸버와 기존 라우팅 규칙은 유지하세요. 먼저 주소 풀이 실제 네트워크, 다른 가상 어댑터, 기업 테스트 서브넷과 겹치지 않는지 확인하세요. 예시 서브넷은 테스트용이며 모든 실제 네트워크에서 사용할 수 있다는 뜻은 아닙니다. 풀 용량은 동시 연결 수 제한이 아니라 저장할 수 있는 도메인 매핑 수에 영향을 줍니다. 풀이 가득 차거나 프로세스가 재시작된 뒤 앱이 이전 합성 주소를 캐시하고 있으면 기존 페이지와 새 조회의 결과가 달라질 수 있습니다.
{
"fakedns": [
{
"ipPool": "198.18.0.0/15",
"poolSize": 4096
}
],
"dns": {
"servers": [
{
"address": "fakedns",
"domains": ["domain:lab.example.net"],
"skipFallback": true
},
"localhost"
],
"disableFallbackIfMatch": true
}
}
합성 주소 연결을 받는 Xray 인바운드에는 이에 맞는 스니핑 설정이 필요합니다. 아래 필드를 실험용 인바운드 객체에 병합하세요. 새 인바운드를 추가하거나 전역 스위치를 켜는 것이 아닙니다. 기존 인바운드에 다른 스니핑 유형이 있다면 덮어쓰지 말고 병합하세요. 이 테스트에서는 실제 대상 도메인을 복원해 연결해야 하므로 경로 선택에만 사용하는 routeOnly는 쓰지 않습니다. 활성화한 뒤 합성 주소 풀에 대한 트래픽이 실제로 이 인바운드에 도착하는지 확인하세요. DNS가 합성 주소를 반환했다는 사실만으로 연결이 이 경로에 들어왔음을 알 수는 없습니다.
{
"sniffing": {
"enabled": true,
"destOverride": ["fakedns"]
}
}
아웃바운드 연결이 실제 대상에 접속해야 한다면 같은 합성 범위를 다시 조회해 풀 안의 주소를 받아서는 안 됩니다. 테스트 중 실제 연결에 사용되는 DNS 경로가 실제 주소를 반환하는지 확인하세요. 예를 들어 프록시 원격 서버에서 대상 도메인을 조회하거나 직접 연결 아웃바운드가 실제 레코드를 반환하는 DNS 경로를 사용할 수 있습니다. 프록시 서버 자체의 도메인도 합성 범위에 넣지 마세요. 내부 파일 서버, 장치 검색, 실제 주소를 기준으로 접근을 제어하는 앱은 기존 조회 경로를 유지하는 것이 좋습니다. 영향을 받지 않는지 확인한 뒤에만 테스트 범위를 넓히세요.
세 가지 관찰 지점으로 문제 위치 찾기
첫 번째는 조회 결과가 주소 풀에 속하는지 확인하는 것입니다. 합성 주소가 반환되지 않았다면 앱이 가로채기 DNS 인바운드를 우회했거나 테스트 도메인이 대상 범위에 포함되지 않았을 수 있습니다. 두 번째는 연결이 해당 인바운드에 들어왔는지 확인하는 것입니다. 조회 결과는 풀 안의 주소인데 인바운드 기록이 없다면 주소 풀이 실제 트래픽 가로채기 인터페이스로 전달되도록 라우팅되는지 살펴보세요. 세 번째는 경로 선택 로그에서 복원된 도메인을 확인할 수 있는지 보는 것입니다. 인바운드가 주소 연결을 받았지만 도메인을 복원하지 못했다면 캐시에 남은 이전 주소, 만료된 매핑, DNS 응답 프로세스와 연결 수신 프로세스의 불일치부터 확인한 다음 도메인 규칙을 조정하세요.
되돌릴 때는 합성 DNS 전달 설정과 합성 주소 풀에 의존하는 트래픽 가로채기 설정을 함께 제거하세요. 일반 DNS를 복구한 뒤 테스트 앱에서 다시 조회하고, 필요하면 시스템 캐시를 지우고 이전 연결을 유지 중인 프로세스를 종료한 다음 같은 도메인을 테스트하세요. 도메인 복원만 끄고 합성 주소가 계속 반환되면 요청이 일반 IP 규칙에 따라 엉뚱한 인터페이스로 전달될 수 있습니다. DNS만 바꿔 놓고 이전 캐시를 재사용해도 같은 현상이 나타날 수 있습니다. 일반 주소를 받고 요청이 원래 경로로 전달되는 것이 확인되어야 되돌리기가 완료된 것입니다. 설정 화면에서 어떤 옵션이 꺼졌는지만 확인해서는 안 됩니다.
다중 구독 관리
업데이트 소스와 사용 목적을 분리해 관리하기
소스가 여러 개라면 먼저 업데이트 방식에 따라 분리하고, 그다음 용도에 따라 선택하세요. 같은 서비스에서 받은 두 주소가 업데이트 제한을 공유할 수도 있습니다. 이름이 같은 두 항목도 서로 다른 계정에 속하거나 전송 매개변수가 다를 수 있습니다. 목록을 깔끔하게 보이게 하려고 모든 항목을 일괄 업데이트할 수 있는 하나의 그룹에 넣지 마세요. 계정 정보를 노출하지 않으면서 소스를 구분할 수 있는 그룹 이름을 사용하고, 용도와 업데이트 방식, 문의 가능한 관리 채널은 로컬에 따로 기록하세요. 예비 소스 여부는 이름에 표시된 지역이나 목록 순서가 아니라 실제 의존 관계를 기준으로 판단하세요.
그룹 설정에서 주소를 하나씩 추가하고 현재 그룹만 업데이트하세요. 가져온 결과를 확인한 다음 메인 목록에서 해당 그룹의 항목을 선택하고 연결 로그를 점검한 뒤 다음 그룹으로 넘어가세요. 일괄 업데이트 참여 스위치가 있다면 수동 테스트에 성공한 뒤에만 켜세요. 가끔 사용하거나 수동으로 관리하는 그룹은 계속 따로 업데이트할 수 있습니다. 업데이트 주소가 없는 수동 항목은 별도 그룹에 두세요. 서버 목록에서 직접 편집한 내용은 다음 업데이트 때 유지되지 않을 수 있습니다. 중요한 독립 테스트 설정은 별도로 저장하고 소스 내용과 다른 이유를 기록하세요.
서로 의존하지 않는 업데이트 경로 구성하기
구독 업데이트는 독립된 요청이며 항목 연결 성공 여부와는 별개의 문제입니다. 클라이언트에서 현재 프록시를 사용하거나 프록시를 사용하지 않고 업데이트할 수 있다면 소스마다 어떤 경로를 사용할 수 있는지 확인하세요. 현재 노드를 통해서만 업데이트할 수 있는데 그 노드를 복구하려면 다시 업데이트해야 하는 순환 의존성에 특히 주의하세요. 검증된 접속 경로를 하나 유지하거나 프록시 없이 해당 소스에 접속할 수 있는 환경에서 테스트하세요. 업데이트에 실패해도 로컬에서 여전히 작동하는 항목을 바로 삭제하지 마세요. 연결 실패, 권한 만료, 소스의 요청 제한, 응답 형식 변경 중 무엇인지 먼저 확인하세요.
정기 업데이트가 필요하다면 먼저 각 소스에서 허용하는 빈도에 맞춰 설정하세요. 그룹별로 업데이트 시간을 분산하거나 직접 업데이트할 수 있습니다. 일괄 업데이트에 실패하면 그룹별 테스트로 돌아가 실패한 그룹과 당시 사용한 네트워크 경로를 기록하세요. 프로그램 시작 시 자동 업데이트와 사용자가 직접 시작한 업데이트를 구분해 로그를 확인하세요. 그룹 하나의 응답이 비었다고 다른 그룹까지 다시 구성할 필요는 없습니다. 다른 그룹을 업데이트하기 전에 해당 그룹의 소스 콘텐츠와 필터 조건을 확인하면 일괄 새로고침으로 인한 변경 범위를 줄일 수 있습니다.
소스 업데이트는 항목을 추가하는 데 그치지 않고 포트, 프로토콜 매개변수, 서버 이름을 바꿀 수 있습니다. 이름이 같아도 설정이 그대로라는 뜻은 아니며, 이름이 다르다고 서로 다른 경로인 것도 아닙니다. 중복을 정리하려면 로컬에서 프로토콜, 서버 주소, 포트, 전송 설정, 용도를 비교하고 한 그룹 안에서 먼저 처리하세요. 그룹을 넘나들며 삭제하면 예비 연결 경로를 잃을 수 있습니다. 두 그룹이 결국 같은 서비스에 연결되더라도 갱신과 업데이트 방식은 다를 수 있으므로 표시 이름 하나만 남기는 것보다 소스별 경계를 유지하는 편이 유용합니다.
전환과 되돌리기를 다시 확인할 수 있는 절차로 만들기
업데이트 전에 현재 그룹, 활성 항목, 라우팅 구성을 기록하세요. 업데이트가 끝나면 익숙한 항목이 남아 있는지 확인하고, 계속 사용할 항목을 직접 선택해 새 연결을 테스트하세요. 예비 그룹은 작동하지만 주 그룹이 실패한다면 같은 대상과 같은 라우팅 설정으로 두 그룹을 비교하세요. 네트워크 모드까지 동시에 바꾸지 마세요. 연결은 되지만 속도가 다르다고 해서 이번 테스트 경로에 차이가 있었다는 사실만 알 수 있습니다. 비교가 필요하다면 연결 수립 시간과 데이터 전송 시간을 구분하고 동일한 조건에서 반복하세요. 한 번의 목록 정렬 결과만으로 소스를 영구 삭제하지 마세요.
이전하거나 되돌리기 전에 클라이언트에서 제공하는 방법으로 설정을 백업하고 접근 권한을 제한하세요. 백업에는 구독 주소, 계정 식별 정보, 서버 연결 매개변수가 포함될 수 있으므로 공유 채팅에 보내거나 공개 폴더에 두지 마세요. 되돌릴 때는 문제가 있는 그룹만 먼저 복구하고 다른 그룹은 그대로 유지한 다음 기존 자동 업데이트 계획을 종료할지 확인하세요. 전체 설정만 복원할 수 있다면 현재 사본을 먼저 보관해 복원 지점 이후에 변경한 라우팅 및 DNS 설정이 덮어써지지 않도록 하세요. 마지막으로 실제 연결에 사용된 항목과 로그가 일치하는지 확인하세요. 선택된 그룹 이름만 봐서는 안 됩니다.
사용자 지정 아웃바운드
아웃바운드 객체와 규칙 참조 구분하기
아웃바운드 객체는 코어가 연결을 처리하는 방식을 정의합니다. 태그는 규칙에서 객체를 참조하는 이름일 뿐이며 실제 동작은 protocol과 해당 설정으로 결정됩니다. 태그를 direct라고 붙였다고 자동으로 직접 연결되는 것은 아닙니다. 설정에서 직접 연결에 해당하는 프로토콜을 지정해야 합니다. 아웃바운드를 추가하기 전에 인바운드, 규칙, 대상, 미일치 시 기본 경로를 정리하세요. 기존 트래픽의 경로만 바꾸면 된다면 이미 있는 아웃바운드를 먼저 재사용하세요. 처리 방식이 실제로 달라야 할 때만 새 객체를 추가해 같은 매개변수를 여러 곳에서 관리하지 않도록 하세요.
일반 GUI 설정은 클라이언트가 생성하므로 실행 디렉터리의 파일을 임시로 편집하면 서버를 바꾸거나 재시작할 때 덮어써질 수 있습니다. v2rayN에서 사용자 지정 설정을 사용할 때는 설정 형식에 맞는 코어를 먼저 선택하세요. 전체 테스트 파일을 가져온 뒤 실행 전에 클라이언트가 수신 대기 포트와 관리 옵션을 별도로 맞추도록 요구하는지 확인하세요. 전체 사용자 지정 설정은 현재 구독 항목에 아웃바운드를 추가하는 것과 다릅니다. 기존 라우팅, 스니핑, DNS 설정이 자동으로 병합되지 않을 수 있습니다. 변경 전에 기존 구성을 보관하고 테스트할 때는 수신 설정 하나만 활성화하세요.
루프백 인바운드에서 직접 연결과 차단 테스트하기
아래는 로컬에서만 접근할 수 있는 SOCKS 인바운드로 태그 매칭을 확인하는 완전한 최소 Xray 테스트 설정입니다. 원격 프록시가 필요하지 않고 시스템 프록시 설정도 변경하지 않습니다. 테스트 전에 해당 포트를 사용 중인 프로세스를 종료하거나 사용하지 않는 로컬 포트를 선택하고 요청 명령에서도 같은 포트로 바꾸세요. 먼저 특정 도메인 하나를 차단하고 나머지 요청은 첫 번째 아웃바운드로 직접 연결합니다. 이렇게 하면 라우팅 매칭 오류와 원격 연결 문제를 구분하기 쉽습니다. 이 예시는 격리된 테스트 파일이므로 현재 사용하는 설정을 덮어쓰지 마세요.
{
"log": {
"access": "access.log",
"loglevel": "warning"
},
"inbounds": [
{
"tag": "local-test",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
],
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-test"],
"domain": ["full:example.org"],
"outboundTag": "block"
}
]
}
}
명령줄에서 실행할 수 있는 Xray가 로컬에 있다면 로그를 기록할 수 있는 테스트 디렉터리에 이 설정을 config.json으로 저장하세요. 첫 번째 명령으로 설정을 불러올 수 있는지 확인한 다음 두 번째 명령으로 실행하세요. 다른 터미널을 열어 두 요청을 실행하세요. curl이 다른 명령에 연결된 터미널에서는 실제 curl 실행 파일을 명시적으로 호출해야 합니다. --socks5-hostname을 사용하면 도메인이 인바운드까지 전달되므로 먼저 IP로 조회되어 정확한 도메인 규칙과 일치하지 않는 문제를 피할 수 있습니다. 직접 연결 요청의 성공 여부는 로컬에서 대상에 접속할 수 있는지에 따라 달라집니다. 원격 응답이 항상 돌아온다고 가정하지 마세요.
xray run -test -config config.json
xray run -config config.json
curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.org/
curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.net/
첫 번째 요청은 block, 두 번째 요청은 direct로 전달되어야 합니다. 구체적인 오류 문구는 운영체제와 도구에 따라 다를 수 있습니다. 두 요청이 모두 실패한다면 프로그램이 수신 포트에 바인딩됐는지, 접근 로그에 인바운드가 기록됐는지 확인한 뒤 아웃바운드 태그와 시스템 네트워크를 점검하세요. 두 요청이 모두 성공한다면 먼저 환경의 NO_PROXY 설정으로 요청이 우회되지 않았는지, 실제로 이 설정 파일을 실행했는지 확인하세요. 검증 중에는 필요한 로그만 저장하고 인바운드, 대상, 아웃바운드를 기록해 전체 접근 기록을 장기간 보관하지 마세요.
실제 아웃바운드를 추가하기 전에 의존성과 되돌리기 방법 확인하기
사용 권한이 확인된 원격 아웃바운드를 추가할 때는 태그를 고유하게 지정하고 서버에서 실제로 설정된 프로토콜 매개변수를 사용하세요. 범위가 명확한 테스트 규칙 하나에서만 해당 태그를 참조하고 첫 번째 아웃바운드를 즉시 변경하지 마세요. 서버 도메인의 조회 방식, 서버 접속 가능 여부, 서버 연결이 가상 어댑터로 되돌아가는지 확인하세요. 같은 설정에서 아웃바운드 여러 개를 조합한다면 각 연결이 의존하는 선행 아웃바운드가 사용 가능한지도 점검하세요. 두 경로가 서로를 선행 조건으로 삼아서는 안 됩니다. 설정이 실행된다고 해도 원격 핸드셰이크나 최종 접속이 성공한다는 뜻은 아닙니다.
아웃바운드를 삭제하기 전에 해당 객체를 참조하는 모든 규칙을 제거하거나 수정한 다음 객체를 삭제하고 설정을 다시 불러오세요. 아웃바운드 순서를 바꿨다면 규칙에 일치하지 않는 요청도 다시 테스트하세요. 실험이 끝나면 테스트 프로세스를 종료하고 일반 클라이언트 설정으로 복구한 다음 로컬 포트를 예상한 프로세스가 수신 중인지 확인하세요. 필요에 따라 시스템 프록시나 TUN도 복구하세요. 이후 문제를 점검할 때는 인바운드 하나, 규칙 하나, 확인된 대상 하나부터 시작하세요. 단일 경로가 재현되는 것을 확인한 뒤 구독, DNS 조회, 트래픽 가로채기를 전체 경로에 다시 포함하세요.