문제 해결 · 설정 단계별 점검

v2rayN 자주 묻는 질문

구독 가져오기부터 연결 문제 해결까지, 먼저 문제가 발생한 단계를 확인한 뒤 순서대로 점검하세요. 질문을 선택하면 해결 방법이 펼쳐집니다. 메뉴 이름과 권한 안내는 현재 클라이언트 버전을 기준으로 확인하세요.

설정 출처 확인 앱 연결 경로 확인 오류 로그 대조
입문 가이드

클라이언트, 구독, 프로토콜

설정 내용과 클라이언트 기능을 구분하면 잘못된 메뉴에서 반복해서 시도하는 일을 줄일 수 있습니다.

v2rayN, v2rayNG, 코어는 각각 어떤 역할을 하나요?

v2rayN은 Windows, macOS, Linux용 그래픽 클라이언트이며 v2rayNG는 Android용입니다. 클라이언트는 구독 관리, 설정 편집, 프록시 연결 지점을 담당하고 실제 연결은 코어가 처리합니다. Xray와 V2Fly는 관련 오픈 소스 코어 생태계에 속하며, 지원 기능은 버전에 따라 달라집니다. 문제를 확인할 때는 ‘V2Ray가 안 돼요’라고만 하지 말고 클라이언트 이름, 코어 이름, 오류 메시지를 기록하세요. Android에서는 V2Fly 코어를 사용하는 다른 클라이언트인 v2flyNG도 선택할 수 있지만, 설정 호환 여부는 실제 프로토콜과 매개변수를 확인해야 합니다.

구독 주소와 단일 공유 링크는 어떻게 다른가요?

구독 주소는 보통 웹 요청 주소이며, 클라이언트가 접속해 여러 설정을 가져온 뒤 다시 업데이트할 수 있습니다. 단일 공유 링크는 대개 vmess://, vless://, trojan:// 같은 프로토콜 접두사로 시작하며 설정 하나를 가져올 때 사용합니다. 구독 주소를 단일 설정 가져오기 메뉴에 붙여 넣으면 형식 오류가 날 수 있고, 공유 링크를 구독 주소 입력란에 넣어도 업데이트되지 않습니다. 먼저 내용을 구분한 다음 구독 그룹이나 클립보드 가져오기 메뉴를 선택하세요. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 전체 주소가 보이는 스크린샷이나 링크를 공개하지 마세요.

클라이언트만 설치하면 바로 연결할 수 있나요?

클라이언트를 설치하면 로컬 도구가 준비된 것일 뿐, 유효한 서버 설정이나 구독을 적법하게 확보해야 합니다. 설정을 가져온 뒤에는 프로토콜, 서버 주소, 포트, 인증 매개변수를 확인하고 활성 설정으로 지정하세요. 클라이언트에 실행 중이라고 표시되어도 로컬 코어나 프록시 연결 지점이 작동한다는 뜻일 뿐, 원격 서버 연결이나 모든 앱의 작동을 보장하지는 않습니다. 처음 설정할 때는 먼저 시스템 프록시를 지원하는 브라우저로 테스트한 다음 터미널, 게임, 기타 앱을 확인하는 것이 좋습니다. 이 사이트는 사용 방법을 안내하며 구독 주소나 접속 계정은 제공하지 않습니다.

REALITY는 프록시 모드인가요? 어디에서 설정하나요?

REALITY는 ‘전역’이나 ‘LAN 우회’ 같은 프록시 모드가 아니라 연결 설정에 사용하는 보안 기술이며, VLESS 설정에서 흔히 볼 수 있습니다. REALITY 사용 여부는 서버 측 구성에 따라 결정되므로 문제를 해결하려고 임의로 TLS로 바꾸면 안 됩니다. 설정을 가져온 뒤에는 서버에서 요구하는 서버 이름, 공개 키, 짧은 ID 등 매개변수를 확인하세요. 항목 이름은 클라이언트 버전에 따라 달라질 수 있습니다. 시스템 프록시는 앱이 클라이언트에 연결되는 방식을 정하고, 라우팅은 트래픽이 어느 경로로 나갈지 정합니다. REALITY 매개변수와는 서로 다른 계층이므로 따로 점검해야 합니다.

설치 및 설정

설치 파일과 첫 설정 가져오기

먼저 운영체제와 아키텍처에 맞는 파일을 선택한 다음 가져오기 메뉴, 실행 환경, 네트워크 권한을 확인하세요.

Android 설치 파일은 arm64와 universal 중 무엇을 선택해야 하나요?

기기에서 지원하는 앱 아키텍처에 맞춰 선택하세요. 최근 출시된 Android 스마트폰은 대개 arm64 패키지를 사용할 수 있으며, 파일 크기도 보통 범용 패키지보다 작습니다. universal 패키지는 여러 아키텍처를 포함하므로 기기 아키텍처를 아직 확인하지 못했을 때 시도하기 좋습니다. 휴대폰 구매 연도만으로 판단하지 마세요. 기기의 시스템 환경과 칩셋 지원이 일치하지 않는 경우도 있습니다. 호환되지 않는다는 메시지가 나오면 먼저 시스템 설정이나 기기 설명에서 아키텍처 정보를 확인하세요. universal 패키지도 설치되지 않는다면 같은 아키텍처의 패키지를 반복해서 바꾸기보다 Android 버전, 저장 공간, 서명 충돌을 점검하세요.

v2rayN에서 구독을 가져오지 못하면 어떤 메뉴를 확인해야 하나요?

구독 그룹 설정에서 새 그룹을 만들고 알아보기 쉬운 이름을 입력한 뒤, 구독 주소 전체를 주소 입력란에 붙여 넣으세요. 저장한 다음 현재 구독 업데이트를 실행합니다. 먼저 복사한 주소에 공백, 줄바꿈, 따옴표, 설명 문구가 섞이지 않았는지 확인하고 주소가 아직 유효한지도 점검하세요. 복사한 것이 단일 공유 링크라면 서버 클립보드 가져오기 메뉴를 사용해야 합니다. Base64는 일부 구독 콘텐츠에 사용되는 인코딩 방식일 뿐, 아무 인코딩 문자열이나 구독 주소 입력란에 넣어도 된다는 뜻은 아닙니다. 메뉴 이름은 버전에 따라 달라질 수 있으므로 현재 버전의 구독 관리 메뉴를 기준으로 찾으세요.

Windows에서 실행하자마자 종료되면 런타임부터 설치해야 하나요?

먼저 현재 시스템에 맞는 클라이언트 빌드를 받았는지 확인하고, 압축 파일을 쓰기 가능한 폴더에 완전히 풀어 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 현재 빌드에 외부 런타임이 명시적으로 필요하거나 오류 메시지에 실행 환경이 없다고 표시될 때만 안내에 따라 해당 아키텍처의 .NET Desktop Runtime을 설치하세요. 모든 실행 오류를 런타임 문제로 단정하지 마세요. 이어서 보안 프로그램의 차단 기록, 폴더 권한, 시작 로그를 확인합니다. 설정 손상이 의심되면 먼저 백업한 뒤 별도의 새 폴더에서 테스트하세요. 기존 구독과 라우팅 설정을 바로 삭제하지 마세요.

TUN을 켤 때 권한 부족 메시지가 표시되면 어떻게 해야 하나요?

TUN은 가상 네트워크 인터페이스를 만들거나 설정해야 하므로 데스크톱에서는 플랫폼과 클라이언트 버전에 따라 관리자 권한, 서비스 구성 요소 또는 시스템 네트워크 권한이 필요할 수 있습니다. 먼저 네트워크를 제어하는 다른 도구를 종료하고 클라이언트 안내에 따라 권한을 부여하세요. 설치 폴더 전체에 과도한 권한을 설정하지 마세요. Android에서는 시스템의 VPN 연결 권한을 확인하세요. 이미 다른 VPN 연결이 활성화되어 있으면 동시에 사용할 수 없을 수 있습니다. 권한을 부여한 뒤에도 실패하면 로그에서 인터페이스 또는 라우팅 오류를 확인하세요. 문제를 진단하는 동안에는 TUN을 끄고 일반 로컬 프록시로 원격 설정이 작동하는지 확인한 다음 TUN을 따로 점검하세요.

사용 팁

시스템 프록시 및 라우팅 설정

앱이 클라이언트에 연결되는지와 연결된 뒤 트래픽이 어떻게 분기되는지는 각각 확인해야 합니다.

시스템 프록시 옵션 세 가지 중 무엇을 선택해야 하나요?

시스템 프록시를 지원하는 앱에서 클라이언트를 사용하려면 ‘시스템 프록시 자동 설정’을 선택하세요. ‘시스템 프록시 지우기’는 클라이언트가 설정한 시스템 프록시 연결을 제거하며, 사용을 중지하거나 남은 설정을 확인할 때 유용합니다. ‘시스템 프록시 변경 안 함’은 기존 시스템 설정을 직접 수정하지 않는다는 뜻이지, 모든 트래픽이 우회한다는 뜻은 아닙니다. 시스템 프록시는 앱이 클라이언트에 연결되는 방식일 뿐 전역 라우팅이 아니며 모든 프로그램에 자동으로 적용되지도 않습니다. 전환하기 전에 기존 설정을 기록해 두세요. 특히 기기에 회사 네트워크 프록시가 설정되어 있다면 주의해야 합니다. 테스트를 마친 뒤 클라이언트를 종료하고 시스템 프록시가 예상대로 복구되었는지도 확인하세요.

브라우저는 되는데 터미널에서는 왜 연결이 안 되나요?

많은 명령줄 프로그램은 데스크톱 시스템 프록시를 읽지 않고 자체 프록시 설정이나 http_proxy, https_proxy, all_proxy 같은 환경 변수를 사용합니다. 먼저 프로그램 설명서에서 HTTP 프록시와 SOCKS 프록시 중 무엇을 지원하는지 확인한 다음, 클라이언트에서 실제로 활성화된 로컬 수신 주소와 해당 포트를 입력하세요. SOCKS 포트를 HTTP 포트로 사용하지 말고, 버전이 다르면 포트도 같을 것이라고 가정하지 마세요. 환경 변수를 테스트할 때는 우선 현재 터미널 세션에만 적용하고, 성공한 뒤 영구 설정 여부를 결정하세요. 이전에 프록시를 설정한 적이 있다면 기존 변수와 no_proxy가 이번 요청에 영향을 주는지도 확인하세요.

LAN 우회와 전역 라우팅은 어떻게 다른가요?

LAN 우회는 보통 사설 IP 주소 대역을 직접 연결해 라우터, 프린터, 로컬 서비스에 접근하도록 합니다. 나머지 트래픽을 어떻게 처리할지는 현재 규칙 집합에 따라 달라집니다. 전역 라우팅은 일반적으로 클라이언트에 들어온 트래픽을 모두 프록시 출구로 보내지만, 클라이언트를 거치지 않는 앱까지 자동으로 연결해 주지는 않습니다. 로컬 기기에 접근할 수 없다면 먼저 대상 주소에 적용되는 규칙과 규칙 순서를 확인하고, TUN이나 DNS 설정이 경로를 바꿨는지 살펴보세요. 프록시 모드, 라우팅, DNS를 한꺼번에 수정하지 말고 하나씩 바꾼 뒤 같은 대상으로 다시 테스트해야 원인을 찾기 쉽습니다.

구독을 업데이트하기 전후에 수동 설정을 보존하려면 어떻게 해야 하나요?

직접 추가한 설정은 별도의 그룹에 보관하세요. 구독에서 생성된 설정을 직접 수정하면 다음 업데이트 때 해당 항목이 덮어써질 수 있습니다. 업데이트 전에 클라이언트 설정과 사용자 지정 라우팅을 백업하고, 현재 사용하는 그룹과 설정을 기록해 두세요. 백업 파일에도 인증 정보가 포함될 수 있으므로 안전하게 보관해야 합니다. 업데이트 후에는 활성 설정이 그대로 있는지 확인한 다음 전송 및 보안 매개변수가 바뀌었는지 살펴보세요. 자동 업데이트는 구독 내용을 다시 가져오는 기능이지, 만료된 계정을 서버에서 복구하는 기능이 아닙니다. 업데이트 결과가 이상하면 응답 내용과 로그를 먼저 확인하고 유일한 백업 파일을 계속 덮어쓰지 마세요.

문제 해결

시간 초과 및 인터넷 연결 문제

오류 원문을 보존하고 한 번에 한 항목만 수정하세요. 먼저 로컬 연결 지점을 확인한 뒤 이름 확인과 원격 핸드셰이크를 점검하세요.

노드 연결 시간 초과, 어떤 순서로 확인해야 하나요?

먼저 기기 네트워크로 평소 직접 접속하는 사이트에 접속할 수 있는지 확인하고 시스템 자동 시간 설정을 켜세요. 시간 오차로 보안 핸드셰이크가 실패할 수 있습니다. 다음으로 클라이언트 코어가 실행 중인지, 로컬 수신 포트를 다른 프로그램이 사용 중인지 확인한 뒤 서버 주소, 원격 포트, 전송 방식, TLS 또는 REALITY 매개변수를 점검하세요. 로그를 보고 도메인 이름 확인 실패, 연결 시간 초과, 연결 거부, 핸드셰이크 실패를 구분하세요. 서로 다른 오류를 같은 문제로 취급하면 안 됩니다. 특정 네트워크에서만 실패한다면 사용이 허용된 다른 네트워크에서 다시 테스트해 보세요. 설정 오류를 감추려고 인증서 검증을 끄지 마세요.

클라이언트에는 연결됨으로 표시되는데 웹페이지가 열리지 않으면 어떻게 해야 하나요?

먼저 ‘연결됨’이 로컬 서비스 실행을 뜻하는지, 원격 요청 성공을 뜻하는지 확인하세요. 같은 브라우저에서 평소 직접 접속하는 사이트와 프록시가 필요한 사이트에 각각 접속해 봅니다. 활성 설정을 올바르게 선택했는지, 시스템 프록시가 클라이언트의 현재 수신 포트를 가리키는지, 브라우저에 별도 프록시 설정이 켜져 있는지 확인하세요. 접속 시 해당 로그가 남는지도 확인합니다. 기록이 없다면 앱이 클라이언트에 연결되지 않은 문제를 먼저 점검하고, 기록은 있지만 이름 확인에 실패하면 DNS를 확인하세요. 핸드셰이크 오류가 있으면 원격 매개변수를 점검합니다. 구독 서비스 상태도 확인해야 합니다. 연결 지점이 실행 중이라고 계정까지 유효한 것은 아닙니다.

시스템 프록시를 자동 설정했는데도 브라우저에서 작동하지 않는 이유는 무엇인가요?

운영체제의 프록시 설정을 열어 주소와 포트가 클라이언트의 현재 수신 지점과 일치하는지 확인한 다음, 브라우저 확장 프로그램이 시스템 설정을 덮어쓰는지 살펴보세요. 일부 브라우저나 업무용 프로필은 별도 프록시, 자동 설정 스크립트, 관리 정책을 사용하므로 클라이언트 메뉴를 바꿔도 해당 설정은 변경되지 않습니다. 기기 관리 정책을 준수하는 범위에서 프록시 확장 프로그램을 잠시 끄고 브라우저를 완전히 종료한 뒤 다시 열어 테스트할 수 있습니다. 시크릿 창에서도 프록시 확장 프로그램이나 관리 정책이 우회되지 않을 수 있습니다. 클라이언트 로그에 요청이 없다면 연결 지점 문제부터 해결하고, 곧바로 구독을 바꾸거나 원격 프로토콜을 수정하지 마세요.

구독 업데이트 실패, 주소가 만료된 건가요 아니면 네트워크 문제인가요?

먼저 업데이트 오류를 확인하세요. 시간 초과라면 요청 경로와 네트워크를 점검해야 합니다. 인증되지 않음이나 접근 금지 오류라면 구독 권한을 확인하세요. 형식 오류가 반환되면 로그인 페이지나 오류 페이지를 설정으로 읽고 있을 수 있습니다. 클라이언트에서 업데이트 경로를 선택할 수 있다면 먼저 프록시를 거치지 않고 업데이트해 보세요. 구독 서비스가 프록시 접속을 요구한다면 이미 작동하는 설정으로 업데이트해야 합니다. 아직 가져오지 못한 설정으로 구독을 업데이트하려는 순환 문제를 피할 수 있습니다. 주소가 만료되거나 재설정되었다면 원래 서비스 제공자에게서 다시 받아야 합니다. 오류를 공유할 때는 오류 유형과 필요한 상태 정보만 남기고 전체 주소, 인증 항목, 응답 내용에 포함된 인증 정보는 가리세요.