FAQ / 설정 문제 해결 색인

V2Ray 자주 묻는 질문

구독 가져오기, 프록시 모드, 연결 오류

문제 증상을 먼저 확인한 뒤 해당 단계부터 점검하세요. 주소, 노드, 트래픽 유입 경로, 라우팅을 나눠 살펴보고 한 번에 하나씩만 바꾸세요. 그래야 로그를 참고할 수 있습니다. 질문을 열어 해결 방법을 확인하세요.

v2rayN / v2rayNG 구독 / 라우팅 / TUN

클라이언트 / 구독 / 코어

기본 개념

소프트웨어와 설정의 역할을 먼저 구분하세요. 구독, 노드, 프록시 설정은 서로 다른 기능입니다.

v2rayN, v2rayNG, v2flyNG 중 어떤 클라이언트를 선택해야 할까요?

Windows, macOS, Linux 데스크톱에서는 노드 관리, 구독 업데이트, 라우팅 선택, 시스템 프록시 설정을 지원하는 v2rayN을 우선 고려하세요. Android에서는 Xray 코어를 사용하는 v2rayNG가 적합하며, V2Fly 코어를 사용하는 v2flyNG도 대안이 될 수 있습니다. 기기 운영체제에 맞춰 클라이언트를 고른 다음 서비스 제공자가 요구하는 프로토콜과 전송 매개변수를 확인하세요. 같은 구독을 사용하려고 모든 클라이언트를 설치할 필요는 없습니다. 클라이언트는 기기에서 설정을 관리하는 도구이며, 사용할 수 있는 노드를 자동으로 만들어 주지는 않습니다. 다운로드한 뒤에는 정식으로 받은 구독 주소나 공유 링크가 필요합니다. 기존 설정이 있다면 클라이언트를 바꾸기 전에 백업해 사용자 지정 라우팅 규칙이 누락되지 않도록 하세요.

V2Ray 구독 링크와 단일 노드 공유 링크는 어떻게 다른가요?

구독 링크는 보통 HTTPS 주소이며, 클라이언트가 이 주소에 요청을 보내 노드 목록을 받아옵니다. 이후에도 다시 업데이트할 수 있습니다. vmess://, vless:// 같은 공유 링크는 일반적으로 서버, 포트, 인증 정보, 전송 설정이 포함된 단일 노드 정보를 담습니다. 두 링크는 사용하는 메뉴가 다릅니다. 구독 주소는 구독 그룹에 저장한 뒤 업데이트하고, 단일 노드 링크는 클립보드에서 가져오기를 사용하세요. 일반 웹페이지 주소를 구독 링크로 사용하거나 공유 링크를 구독 주소 입력란에 넣지 마세요. 구독 링크에는 계정 인증 정보가 포함될 수 있으므로 비밀번호처럼 취급하고 공개 스크린샷에 노출하지 마세요. 노드 목록을 업데이트할 수 있어도 계정의 사용 기간이나 데이터 한도까지 갱신되는 것은 아닙니다.

시스템 프록시, 전역 라우팅, TUN은 같은 설정인가요?

아닙니다. 시스템 프록시는 시스템 프록시 설정을 따르는 앱의 요청을 클라이언트로 전달할지 결정합니다. 라우팅 규칙은 코어에 들어온 요청을 어느 아웃바운드로 보낼지 정합니다. TUN은 가상 네트워크 인터페이스를 통해 지정된 조건에 해당하는 트래픽을 받아옵니다. 전역 라우팅을 설정해도 시스템 프록시를 무시하는 프로그램이 자동으로 프록시를 사용하지는 않으며, TUN이 켜지는 것도 아닙니다. 문제를 확인할 때는 먼저 앱 트래픽이 클라이언트에 들어오는지 확인한 다음 라우팅 규칙이 프록시 아웃바운드에 적용되는지 살펴보세요. 평소에는 시스템 프록시와 중국 본토 주소 우회 라우팅을 함께 사용할 수 있습니다. 시스템 프록시를 따르지 않는 앱이 있을 때 TUN 사용을 검토하세요. 세 설정을 한꺼번에 바꾸면 어느 단계에서 문제가 생겼는지 파악하기 어렵습니다.

Project V, V2Fly, Xray 코어는 어떤 관계인가요?

Project V는 V2Ray 생태계를 이해할 때 참고할 배경입니다. V2Fly는 V2Ray 코어를 이어받아 커뮤니티에서 유지·관리하고, Xray는 관련 코드에서 발전한 별도의 코어 계열입니다. 코어는 프로토콜 처리, 전송, DNS, 라우팅을 담당하고 v2rayN, v2rayNG 같은 그래픽 클라이언트는 설정을 생성하고 조작 화면을 제공합니다. 프로토콜 이름이 같더라도 서로 다른 코어에서 모든 최신 매개변수를 사용할 수 있는 것은 아닙니다. 가져온 뒤 지원하지 않는 필드라는 메시지가 나오면 클라이언트와 코어의 지원 여부부터 확인한 다음 서버에서 요구하는 설정을 살펴보세요. 코어 이름만 바꾼다고 호환성 문제가 해결되는 것은 아닙니다. 전송 방식, 보안 설정, 관련 확장 기능도 함께 맞춰야 합니다.

아키텍처 / 구독 / 권한

설치 및 설정

설치 패키지는 시스템 아키텍처에 맞추고, 구독은 올바른 가져오기 메뉴를 사용하며, 권한은 기능에 필요한 범위만 허용하세요.

Android 설치 패키지는 arm64와 universal 중 무엇을 선택해야 하나요?

64비트 ARM 시스템을 사용하는 스마트폰이라면 보통 arm64 패키지를 선택합니다. 최신 주류 Android 기기는 대부분 여기에 해당합니다. universal 패키지는 여러 프로세서 아키텍처를 포함해 용량이 더 큰 편이며, 기기의 아키텍처를 모를 때 대안으로 사용할 수 있습니다. 프로세서가 64비트를 지원한다고 해서 제조사가 설치한 운영체제도 64비트라는 보장은 없습니다. 기기를 구매한 연도만으로 판단하지 마세요. arm64 패키지가 호환되지 않는다고 표시되면 운영체제와 프로세서 정보를 확인한 뒤 universal 패키지를 시도하세요. 기존 앱 위에 설치할 때는 앱 서명, 운영체제 버전, 설치된 기존 버전도 영향을 줄 수 있습니다. 설치에 실패하면 기존 앱을 바로 삭제하지 말고 오류 메시지를 그대로 기록하세요. 재설치가 필요하다면 설정을 내보내거나 구독 주소를 먼저 저장하세요.

v2rayN과 v2rayNG에서 구독을 가져오려면 어떻게 하나요?

v2rayN에서는 먼저 ‘구독 그룹 설정’을 열고 그룹을 추가한 뒤 설명과 구독 주소를 입력해 저장하세요. 그런 다음 ‘구독 그룹’ 메뉴에서 업데이트를 실행합니다. 업데이트 메뉴에는 프록시 사용 여부에 따른 옵션이 따로 있을 수 있습니다. v2rayNG에서는 ‘구독 그룹 설정’에서 그룹과 주소를 추가하고, 메인 화면으로 돌아와 ‘구독 업데이트’를 실행하세요. 버전에 따라 메뉴 배치는 달라질 수 있지만 주소 저장, 목록 업데이트, 노드 선택 순서는 같습니다. 단일 공유 링크를 가져오려면 ‘클립보드에서 가져오기’ 또는 해당 가져오기 메뉴를 사용하세요. 구독 그룹을 만들 필요는 없습니다. 가져온 뒤에는 노드의 서버와 전송 유형을 확인하세요. 구독 설명은 단순한 라벨이므로 설정의 유효성을 판단하는 기준이 될 수 없습니다.

v2rayNG에 처음 연결할 때 VPN 권한이 필요한 이유는 무엇인가요?

v2rayNG의 VPN 모드는 Android VPN 인터페이스를 통해 트래픽을 받습니다. 처음 연결하면 시스템에 연결 요청이 표시되며, 이 인터페이스를 만들려면 권한을 허용해야 합니다. 이 권한은 구독 로그인과 다르며 노드 연결이 성공했다는 뜻도 아닙니다. 허용한 직후에도 연결이 중단된다면 VPN 인터페이스를 사용하는 다른 앱을 종료한 뒤 다시 연결하세요. 일반적으로 같은 사용자 환경에서 이런 연결을 두 개 동시에 실행할 수 없습니다. 일부 앱만 프록시를 사용하지 않는다면 ‘앱별 프록시’ 설정과 허용·제외 모드를 확인하세요. 백그라운드에서 연결이 자주 끊기면 v2rayNG의 배터리 사용 및 백그라운드 실행 제한을 살펴보고 변경 후 실제 동작을 확인하세요. 시스템 권한을 한꺼번에 모두 허용할 필요는 없습니다.

v2rayN에서 TUN 모드 권한 부족 오류가 표시되면 어떻게 해야 하나요?

TUN은 가상 네트워크 인터페이스를 만들고 라우팅을 조정하므로 일반 시스템 프록시보다 높은 권한이 필요한 경우가 많습니다. Windows에서는 클라이언트를 종료한 뒤 현재 버전의 안내에 따라 관리자 권한으로 실행해 보세요. macOS와 Linux에서는 클라이언트에 표시되는 권한 승인 또는 서비스 설치 안내를 따르세요. Windows에서의 방법을 그대로 적용하면 안 됩니다. 실행 후 로그를 확인해 가상 인터페이스와 라우팅이 정상적으로 설정되었는지 살펴보세요. 인터페이스가 사용 중이라는 오류가 나오면 트래픽을 가로채는 다른 프로그램을 먼저 종료하세요. 트래픽을 가로챌 필요가 없다면 TUN을 끄고 시스템 프록시로 노드를 확인하세요. 오류를 우회하려고 시스템 보호 기능을 끄거나 설정 폴더 전체에 임의로 쓰기 권한을 부여하지 마세요. 필요한 작업에만 권한을 허용해야 합니다.

라우팅 / Mux / 설정 백업

사용 팁

규칙이 트래픽 경로를 정하고 앱이 트래픽 유입 방식을 결정합니다. 변경 전에는 기존 설정을 보관하고, 변경 후에는 같은 대상으로 다시 테스트하세요.

로컬 네트워크와 중국 본토 주소를 우회하는 라우팅은 어떻게 이해해야 하나요?

이 라우팅은 일반적으로 로컬 네트워크와 규칙이 중국 본토 주소로 판별한 대상은 직접 연결하고, 나머지는 프록시 규칙에 따라 처리합니다. 로컬 서비스와 해외 웹사이트에 함께 접속할 때 적합합니다. 웹페이지에 표시된 언어가 아니라 도메인, IP 데이터, 규칙 순서에 따라 트래픽 경로가 결정됩니다. 코어는 규칙 순서대로 일치 여부를 확인하므로 앞선 규칙이 먼저 아웃바운드를 결정할 수 있습니다. 사용자 지정 규칙을 잘못된 위치에 넣으면 뒤쪽 규칙이 적용되지 않을 수 있습니다. 특정 웹사이트의 연결 경로가 이상하면 로그에서 대상과 아웃바운드를 확인한 뒤 사용자 지정 도메인 규칙, DNS, 규칙 데이터를 살펴보세요. 로컬 네트워크 프린터나 내부 서비스에 접속할 수 없다면 모든 트래픽을 전역 프록시로 바꾸기 전에 사설 IP 직접 연결 규칙부터 확인하세요.

v2rayN에서 시스템 프록시를 설정했는데 일부 프로그램은 왜 직접 연결되나요?

시스템 프록시는 해당 설정을 읽고 따르는 앱에서만 적용됩니다. 일부 프로그램은 별도 프록시 설정을 사용하고, 일부 명령줄 도구는 환경 변수를 읽으며, 시스템 프록시를 아예 무시하는 프로그램도 있습니다. 먼저 브라우저에서 현재 노드가 작동하는지 확인한 뒤 대상 프로그램의 네트워크 설정을 열어 시스템 프록시를 사용하는지 살펴보세요. 주소를 직접 입력해야 한다면 클라이언트가 실제로 수신 대기 중인 로컬 주소와 포트를 입력하고 HTTP와 SOCKS를 구분하세요. 한 프로토콜의 포트를 다른 프로토콜 입력란에 임의로 넣으면 안 됩니다. 포트는 현재 클라이언트 설정을 기준으로 확인하고 오래된 안내에 나온 값을 그대로 사용하지 마세요. 설정이 올바른데도 트래픽이 클라이언트에 들어오지 않는다면 TUN 사용을 검토할 수 있습니다. 확인이 끝나면 임시 설정을 원래대로 되돌려 다음 실행 때 프록시 설정이 중복되지 않게 하세요.

Mux 다중화와 Sniffing 도메인 스니핑을 계속 켜 두어야 하나요?

Mux는 연결을 다중화하는 기능으로, 효과는 프로토콜, 서버, 네트워크 환경에 따라 달라집니다. 항상 속도를 높여 주는 기능은 아닙니다. 일부 설정 조합에서는 사용하지 않는 편이 나을 수 있으므로 연결이 끊기거나 특정 웹사이트에 문제가 생기면 먼저 끄고 비교해 보세요. Sniffing은 식별 가능한 트래픽에서 대상 정보를 추출해 도메인 라우팅을 돕지만, 클라이언트가 생성한 라우팅 및 DNS 설정과 함께 작동해야 합니다. 뚜렷한 필요가 없다면 클라이언트 기본값을 사용하고 문제에 따라 하나씩 조정하세요. 한 번에 설정 하나만 바꾸고 연결을 다시 시작한 뒤 같은 웹사이트에서 재현해 로그를 기록하세요. 노드가 작동하지 않는 상태에서 Mux, Sniffing, TUN을 한꺼번에 켜지 마세요. 세 설정을 동시에 바꾸면 원인을 찾기 어려워집니다.

클라이언트를 바꾸거나 도움을 요청하기 전에 어떤 설정을 백업하고 가려야 하나요?

클라이언트를 바꾸기 전에 구독 주소, 직접 추가한 노드, 사용자 지정 라우팅, DNS, 앱별 프록시 설정을 저장하세요. 내보낸 파일에 연결 인증 정보가 포함될 수 있으므로 안전한 위치에 보관해야 합니다. 구독을 가져오는 데 성공해도 사용자 지정 규칙까지 옮겨진 것은 아니므로 이전 후 항목별로 확인하세요. 다른 사람에게 도움을 요청할 때는 운영체제와 클라이언트 이름, 오류가 발생한 단계, 민감 정보를 가린 로그만 제공하세요. 구독 토큰, UUID, 비밀번호, 개인 키, 전체 공유 링크는 반드시 숨기세요. 스크린샷에 표시된 QR 코드와 클립보드 미리보기도 확인해야 합니다. 구독 인증 정보가 이미 공개되었다면 서비스 제공자에게 재설정을 요청하세요. 이미지 게시물을 삭제하는 것만으로 기존 주소가 무효화되지는 않습니다. 오류 유형과 발생 시각만으로도 문제 해결에 도움이 되므로 전체 설정을 공개할 필요는 없습니다.

파싱 / 업데이트 / 연결 로그

문제 해결

‘설정을 가져오지 못하는 문제’와 ‘가져온 설정으로 연결할 수 없는 문제’를 구분하세요. 오류가 발생한 단계부터 확인하면 됩니다.

구독을 가져오지 못하거나 파싱 오류가 발생하면 무엇부터 확인해야 하나요?

먼저 주소 저장, 콘텐츠 다운로드, 노드 파싱 중 어느 단계에서 실패했는지 확인하세요. 붙여넣은 내용에 앞뒤 공백이나 줄바꿈, 전각 문장 부호가 있는지, 계정 관리 페이지 주소를 잘못 사용했는지 살펴보세요. 구독 주소는 클라이언트가 지원하는 노드 데이터를 반환해야 합니다. 로그인 페이지나 웹 오류 메시지가 반환되면 안 됩니다. 브라우저에서 열리는 주소라고 해서 형식이 올바른 것은 아닙니다. 서비스 제공자에게 해당 주소가 v2rayN 또는 v2rayNG에서 사용할 수 있는지, 계정이 유효한지 확인하세요. 로그에 지원되지 않는 프로토콜이나 필드가 표시되면 클라이언트 버전과 사용 중인 코어를 확인하세요. 파싱을 통과하려고 보안 매개변수를 임의로 삭제하지 마세요. 단일 공유 링크는 클립보드에서 가져오고 구독 주소는 구독 그룹에 등록해야 합니다. 두 메뉴를 바꿔 사용해도 오류가 발생할 수 있습니다.

잘 작동하던 구독이 업데이트에 실패하는 이유는 무엇인가요?

주소 만료, 계정 만료, 구독 서버 장애, DNS 조회 실패, 현재 네트워크에서 구독 서버에 접속할 수 없는 상황 등이 업데이트 실패의 원인일 수 있습니다. v2rayN에서 프록시 사용·미사용 업데이트를 모두 지원한다면, 정상 작동하는 노드를 이용해 프록시를 통한 업데이트를 먼저 시도한 뒤 프록시를 사용하지 않은 결과와 비교하세요. 현재 노드 자체가 작동하지 않으면 프록시를 통한 업데이트도 실패할 수 있습니다. v2rayNG는 사용 중인 버전의 구독 업데이트 설정을 기준으로 확인하세요. TLS 관련 오류가 발생하면 기기 시간과 서버 인증서를 확인하고 인증서 검증을 바로 끄지 마세요. 사용 가능한 설정을 잃지 않도록 기존 목록을 보존한 뒤 다시 시도하세요. 서비스 제공자가 주소를 재설정했다면 업데이트를 반복해서 누르지 말고 새 주소로 교체해야 합니다.

노드 연결 테스트가 시간 초과될 때 네트워크 문제와 설정 문제를 어떻게 구분하나요?

먼저 기기에서 일반 웹사이트에 정상적으로 접속할 수 있는지 확인한 다음 노드 서버 주소와 포트, 기기 시간을 살펴보세요. 테스트 방식도 구분해야 합니다. TCP 연결 성공은 포트에 접속할 수 있다는 뜻일 뿐이며, 실제 연결 테스트에는 프로토콜 핸드셰이크, DNS, 테스트 대상도 포함됩니다. 두 결과를 같은 의미로 보면 안 됩니다. 현재 유효한 노드 하나를 기준으로 비교하고, 가능하다면 네트워크를 바꿔 테스트하세요. 노드 하나만 실패하면 서버 상태와 해당 노드의 매개변수를 중점적으로 확인하고, 모든 노드가 실패하면 로컬 네트워크, DNS, 방화벽, 클라이언트 로그를 살펴보세요. 핸드셰이크 오류가 발생하면 UUID, TLS, serverName, 전송 매개변수를 확인하세요. 재시작으로 일부 임시 상태는 초기화할 수 있지만 만료된 계정이나 잘못된 설정까지 해결되지는 않습니다.

클라이언트에는 연결됨으로 표시되는데 인터넷에 접속할 수 없다면 어떻게 해야 하나요?

연결됨 표시는 대개 로컬 서비스나 VPN 인터페이스가 시작되었다는 뜻일 뿐, 원격 노드가 작동한다는 보장은 아닙니다. 먼저 선택한 노드를 테스트하세요. 그런 다음 데스크톱 앱이 시스템 프록시를 사용하고 있는지, Android에서 VPN 권한을 허용했는지, 앱별 규칙이 대상 앱을 제외하지 않았는지 확인하세요. 이어서 로그를 살펴보세요. 대상 요청이 없다면 트래픽 유입 경로를 확인하고, 요청은 있지만 아웃바운드 오류가 있다면 노드와 핸드셰이크 매개변수를 확인하세요. 도메인으로 접속할 때만 실패하면 DNS를, 특정 웹사이트에서만 실패하면 라우팅과 대상 서버를 살펴보세요. 간단한 라우팅으로 잠시 비교 테스트한 뒤 원래 설정으로 복구할 수 있습니다. 포트나 가상 인터페이스가 충돌하지 않도록 다른 프록시 도구를 종료하세요. 한 번에 조건 하나만 바꾸고 같은 대상을 다시 테스트해야 여러 설정을 연달아 바꾸는 것보다 원인을 찾기 쉽습니다.