v2rayN / v2rayNG
설정 및 연결 문제 해결

먼저 기기에 맞는 클라이언트를 선택하세요. Windows, macOS, Linux에서는 v2rayN을 사용합니다. Windows용은 데스크톱 버전과 클래식 WPF 버전으로 나뉩니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 먼저 살펴보고, V2Fly 코어가 필요하다면 v2flyNG를 고려하세요. 클라이언트 인터페이스와 코어는 서로 다른 계층이므로 이름만 보고 특정 프로토콜의 지원 여부를 판단할 수 없습니다. 가져오기 전에 서비스 설정 요구 사항을 확인하고, 현재 클라이언트와 코어의 지원 여부를 대조하세요. 세 클라이언트 모두 사용 가능한 설정이 필요하며, 설치만으로 연결 조건이 갖춰지는 것은 아닙니다.

클라이언트는 설정을 읽고 연결을 관리하는 도구입니다. 구독 주소는 보통 여러 설정을 가져오는 네트워크 주소입니다. 구독 그룹에 저장한 다음 갱신해야 합니다. 노드 공유 링크에는 대개 하나의 연결 설정이 포함되어 있으므로 클립보드에서 가져오기나 QR 코드 스캔 기능을 사용하세요. 서비스 제공업체의 계정 페이지 주소를 구독 주소로 사용하거나, 여러 공유 링크를 구독 주소 입력란에 붙여 넣지 마세요. 구독 주소에 계정 식별 정보가 포함될 수 있으므로 문제를 문의할 때는 형식과 오류만 설명하고 공개된 스크린샷에 전체 주소를 노출하지 마세요.

먼저 트래픽이 들어오는 경로와 나가는 경로를 구분하세요. 시스템 프록시는 운영체제 설정에 프록시 주소를 등록하며, 해당 설정을 따르는 앱만 이를 사용합니다. TUN은 가상 네트워크 인터페이스로 지정된 조건에 맞는 트래픽을 받아들입니다. 실제로 처리되는 범위는 라우팅, 제외 항목, 시스템 환경의 영향을 받습니다. 라우팅 규칙은 코어에 들어온 연결을 직접 연결, 프록시 또는 지정된 다른 출구 중 어디로 보낼지 결정합니다. TUN을 켰다고 모든 연결이 반드시 프록시를 통과하는 것은 아니며, 중국 본토 우회 모드를 선택했다고 모든 앱의 트래픽이 코어로 들어가는 것도 아닙니다. 처음 설정할 때는 한 가지 진입 경로부터 확인한 뒤 라우팅 결과를 점검하세요.

가져오기 결과만으로 판단할 수는 없습니다. 구독 파싱에 성공했다는 것은 클라이언트가 인식 가능한 내용을 읽었다는 뜻이지, 현재 코어가 각 항목의 모든 매개변수를 지원한다는 의미는 아닙니다. VMess, VLESS, Trojan은 프로토콜 이름이고, REALITY는 연결 보안 관련 설정입니다. 전송 방식과 보안 매개변수도 각각 맞아야 합니다. 일부 항목이 시작되지 않으면 로그에서 지원되지 않는 필드나 매개변수 오류를 먼저 확인한 다음, 선택한 코어와 클라이언트의 업데이트 상태를 살펴보세요. 서비스 설정의 원래 값을 유지하고, 프로토콜 이름만 보고 포트, 전송 경로, 서버 이름을 추측하지 마세요.

먼저 기기의 프로세서 아키텍처나 시스템 정보를 확인하세요. 비교적 최신 Android 휴대전화는 arm64 패키지를 선택할 수 있지만, 프로세서가 64비트를 지원해도 시스템에 해당 실행 환경이 제공된다는 보장은 없습니다. 기기 구매 연도만으로 판단하지 마세요. 아키텍처를 확인하기 어렵다면 대체로 용량이 더 큰 universal 범용 패키지를 선택할 수 있습니다. 기기와 호환되지 않는다는 설치 메시지가 표시되면 시스템 요구 사항과 패키지 아키텍처를 확인하세요. 기존 앱과 충돌한다는 메시지가 표시되면 같은 클라이언트인지, 서명이 일치하는지 살펴보세요. 앱을 삭제하면 로컬 설정에 영향을 줄 수 있으니 먼저 클라이언트의 백업 기능으로 필요한 내용을 저장하세요.

구독 그룹 설정을 열어 주소가 저장되었고 해당 그룹이 활성화되어 있는지 확인하세요. 메인 화면으로 돌아가 구독 그룹 메뉴에서 모든 구독 갱신(프록시 사용 안 함)을 실행한 다음, 해당 그룹으로 전환해 결과를 확인하세요. 주소를 추가하는 것은 구독 출처를 저장하는 작업일 뿐, 설정을 이미 가져왔다는 뜻은 아닙니다. 로그에 가져오기 성공으로 표시되지만 항목이 없다면 주소가 구독 내용이 아닌 로그인 웹페이지를 반환하는지 확인하고, 현재 클라이언트가 내용을 인식할 수 있는지도 살펴보세요. 같은 주소를 반복해서 추가하지 마세요. 그룹 하나만 유지하고 가져오기 실패와 파싱 실패를 구분해 해결하세요.

클립보드에 설명 문구나 웹페이지 제목, 불필요한 문장 부호가 섞인 일부 텍스트가 아니라 온전한 노드 공유 링크가 있는지 확인하세요. 복사할 때 프로토콜 접두사를 빠뜨리지 말고, 인코딩된 내용을 직접 수정하지 마세요. 받은 것이 구독 주소라면 노드 가져오기 기능을 반복해서 사용하는 대신 구독 그룹 설정에서 새 그룹을 만들고 주소를 저장한 뒤 구독을 갱신하세요. QR 코드를 인식하지 못하면 이미지가 선명하고 온전한지 확인하세요. 그래도 가져오지 못한다면 클라이언트가 지원하는 형식과 제공업체의 가져오기 안내를 확인하세요. 구독 내용을 낯선 변환 사이트에 업로드하지 마세요.

먼저 Tun을 끄고 로그를 확인해 권한, 가상 네트워크 인터페이스, 라우팅 설정 중 어느 단계에서 실패했는지 파악하세요. Windows에서는 클라이언트를 종료한 뒤 현재 버전의 요구 사항에 따라 관리자 권한으로 다시 실행하고 Tun을 켜세요. macOS와 Linux는 권한 부여 및 보조 서비스 요구 사항이 다르므로 각 플랫폼의 안내를 따르세요. Windows 절차를 그대로 적용하면 안 됩니다. 시스템이 첫 권한 요청을 차단했다면 앱 출처와 표시된 안내를 먼저 확인하세요. 권한이 있는데도 실패하면 다른 VPN이나 가상 네트워크 도구가 네트워크를 동시에 제어하는지 확인하고, 하나씩 종료한 뒤 다시 시도하세요. 시스템 네트워크 인터페이스를 바로 삭제하지 마세요.

구독 주소에 현재 직접 연결할 수 있는지에 따라 선택하세요. 한 가지 방식을 모든 상황에 적용할 수는 없습니다. 처음 설정하는 중이고 사용 가능한 연결이 없다면 먼저 프록시 없이 갱신해 보세요. 주소에 기존 프록시를 통해서만 접근할 수 있다면 기존 설정이 작동하는지 확인한 다음 프록시를 통한 갱신을 선택하세요. 갱신에 실패하면 상태 코드와 오류 유형을 기록해 주소 만료, 로그인 만료, 파싱 실패, 네트워크 시간 초과를 구분하세요. 클라이언트에서 구독을 갱신하는 것은 내용을 다시 가져오는 작업일 뿐, 계정을 연장하거나 서비스 제공업체의 데이터 한도 및 이용 기간 관리를 대신하지 않습니다.

접속 목적에 따라 라우팅 모드를 선택하세요. 중국 본토 우회 모드는 보통 도메인 및 IP 주소 규칙을 사용해 중국 본토의 대상 중 규칙에 일치하는 연결은 직접 연결하고 나머지는 규칙에 따라 처리합니다. 전역 프록시는 일반적으로 코어에 들어온 연결을 우선 프록시로 보내지만, 구체적인 동작은 현재 규칙에 따라 달라집니다. 모드를 바꾼 후 대상에 다시 접속하고, 필요하면 앱의 기존 연결을 종료해 이전 경로를 계속 사용하지 않도록 하세요. 결과가 예상과 다르면 노드를 바로 바꾸기보다 규칙 순서, 규칙 리소스, 도메인 확인을 점검하세요. 시스템 프록시가 트래픽을 받지 않는 앱은 라우팅 모드만 바꿔도 자동으로 프록시를 사용하지 않습니다.

같은 구독을 사용하면 주로 동일한 출처에서 노드 설정을 각각 가져올 뿐, 클라이언트의 모든 로컬 설정이 자동으로 동기화되지는 않습니다. v2rayN과 v2rayNG의 시스템 프록시, 라우팅, DNS, TUN 또는 VPN 모드는 기기별로 확인해야 합니다. 이름이 같은 설정도 구현 방식이 다를 수 있습니다. 노드 QR 코드나 공유 링크는 개별 항목을 전달하는 데 적합하며 전체 백업을 대신하지 않습니다. 이전하기 전에 대상 클라이언트가 백업 형식을 지원하는지 확인하고 기존 기기의 설정을 보관하세요. 서비스 제공업체의 기기 수 및 동시 연결 제한도 확인해 갱신 성공을 무제한 동시 사용이 가능하다는 뜻으로 오해하지 마세요.

먼저 현재 클라이언트의 백업 또는 내보내기 기능으로 구독 그룹과 필요한 로컬 설정을 저장하고, 사용자 지정 라우팅, DNS, 프록시 진입 설정도 기록하세요. 백업에는 구독 주소와 연결 인증 정보가 포함될 수 있으므로 안전한 곳에 보관해야 합니다. 클라이언트, 인터페이스 버전, 플랫폼을 바꿔 복원하기 전에 대상 버전이 해당 형식을 지원하는지 확인하세요. 출처를 알 수 없는 설정 폴더를 바로 덮어쓰지 마세요. 업데이트 후에는 그룹이 유지되었는지 확인하고, 기존 항목 하나로 연결을 테스트한 다음 사용자 지정 설정을 복원하세요. 새 버전에서 문제가 생기면 오류와 원래 백업을 보관해 두세요. 반복해서 삭제하면 문제 해결에 필요한 단서가 사라질 수 있습니다.

먼저 기기의 기본 네트워크가 작동하는지 확인한 다음 시스템 시간이 정확한지 살펴보세요. 한 항목만 시간 초과되면 같은 구독의 다른 항목과 비교하세요. 모든 항목이 시간 초과되면 로컬 네트워크, 방화벽, 코어 실행 상태, 구독 유효 기간을 우선 점검하세요. TCP 테스트, 실제 연결 테스트, 브라우저 접속 테스트는 각각 확인하는 내용이 다릅니다. 특정 테스트의 시간 초과만으로 모든 앱이 연결되지 않는다고 단정할 수 없습니다. 로그에서 도메인 확인 실패, 연결 거부, 핸드셰이크 실패 중 무엇인지 확인하고 해당 단계에 맞게 조치하세요. 한 번 시간 초과되었다고 노드를 한꺼번에 삭제하거나 모든 프로토콜 매개변수를 바꾸지 마세요.

연결됨 표시는 로컬 서비스나 VPN이 시작되었다는 뜻으로 보고, 원격 서버에 도달할 수 있다는 증거로 여기지 마세요. 현재 항목이 선택되어 있는지, 코어가 정상적으로 시작되었는지 확인한 뒤 직접 연결이 예상되는 대상과 프록시 연결이 예상되는 대상에 각각 접속해 보세요. 둘 다 실패하면 트래픽 진입 경로, DNS, 다른 VPN과의 충돌을 확인하세요. 프록시 대상만 실패하면 해당 항목과 출구 관련 로그를 살펴보세요. 특정 사이트만 실패하면 라우팅 규칙 적용 여부와 도메인 확인을 확인하세요. 문제를 점검하는 동안에는 설정을 하나씩만 바꾸고 다시 접속하세요. DNS, 라우팅, TUN을 동시에 전환하면 어느 단계에서 변화가 생겼는지 판단하기 어렵습니다.

먼저 v2rayN의 시스템 프록시 메뉴에서 시스템 프록시 자동 설정을 선택했는지 확인한 다음, 운영체제에 등록된 프록시 주소와 현재 로컬 수신 포트가 일치하는지 살펴보세요. 일부 앱은 자체 프록시 설정을 사용하거나 시스템 프록시를 아예 읽지 않습니다. 이런 경우 앱에서 실제 수신 프로토콜과 포트에 맞춰 프록시를 설정하거나, 적용 범위를 파악한 뒤 TUN을 사용하세요. 브라우저에 프록시 확장 프로그램이 있다면 시스템 설정을 덮어쓰는지 확인하세요. 클라이언트를 종료한 뒤에도 인터넷에 연결할 수 없다면 운영체제에 프록시 설정이 남아 있는지 확인하고, 현재 네트워크 환경에 맞게 복구한 다음 기본 연결을 점검하세요.

먼저 실패한 단계를 기준으로 구분하세요. 요청 시간 초과는 제한 시간 안에 응답을 받지 못했다는 뜻입니다. 주소에 접근할 수 있는지와 갱신에 사용하는 네트워크 경로를 확인하세요. 401 또는 403 등의 응답이 나타나면 주소, 계정 상태, 서비스 제공업체의 제한을 확인하세요. 반복해서 재시도해도 인증 문제는 해결되지 않습니다. 요청에 성공했지만 파싱에 실패했다면 반환된 내용이 로그인 페이지나 오류 페이지인지, 지원되지 않는 구독 형식인지 확인하세요. 주소를 복사할 때 전체 쿼리 매개변수를 포함하고 끝에 공백이 붙지 않도록 하세요. 로그와 스크린샷을 확인하거나 공유하기 전에 구독 주소, 인증 정보, 개인 정보를 가리세요. 그런 다음 오류 유형을 함께 적어 설정 제공업체에 문의하세요.