도움말 센터 · 문제별 설정 찾기

V2Ray 자주 묻는 질문 및 연결 문제 해결

먼저 문제가 발생한 단계가 설치, 가져오기, 업데이트, 트래픽 처리 중 어디인지 확인하세요. 해당 질문을 펼쳐 설정을 순서대로 점검하고, 한 번에 한 항목만 변경한 뒤 같은 대상으로 결과를 확인하세요.

기본 개념

클라이언트, 코어, 프록시 모드를 먼저 구분하면 잘못된 설정을 반복해서 바꾸는 일을 줄일 수 있습니다. 전문 용어는 용어집과 함께 확인하세요.

V2Ray, V2Fly, Xray와 v2rayN, v2rayNG는 각각 무엇인가요?

먼저 코어와 그래픽 클라이언트를 구분해야 합니다. Project V는 관련 도구와 프로토콜의 오픈 소스 생태계입니다. V2Fly는 V2Ray 코어를 유지 관리하며, Xray는 별도의 코어 분기입니다. v2rayN은 데스크톱에서 구독, 서버, 라우팅을 관리하는 인터페이스를 제공하고, v2rayNG는 Xray 코어를 사용하는 Android 클라이언트입니다. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 설정을 사용할 수 있는지는 클라이언트가 실제로 호출하는 코어와 버전에 따라 달라집니다. 가져오기에 실패했다면 제품 이름이 비슷한지만 볼 것이 아니라 프로토콜과 전송 방식의 지원 여부를 확인하세요.

클라이언트를 설치했는데 서버 목록이 비어 있는 이유는 무엇인가요?

클라이언트는 설정 관리와 트래픽 전달을 담당하며, 설치 파일에 사용할 수 있는 서버가 포함되어 있지는 않습니다. 먼저 사용 권한이 있는 구독 주소, 공유 링크 또는 설정 파일을 받은 다음 구독 그룹이나 가져오기 메뉴에서 추가해야 합니다. 구독 주소는 여러 설정을 업데이트하는 데 쓰이고, 단일 공유 링크는 보통 서버 하나의 정보만 담으므로 서로 바꿔 쓸 수 없습니다. 구독을 추가했는데도 항목이 없다면 먼저 업데이트를 실행하고 로그를 확인하세요. 현재 그룹이나 검색 필터 때문에 서버가 숨겨져 있지 않은지도 살펴보세요. 계정 로그인 페이지 주소를 구독 주소로 사용하면 안 됩니다.

시스템 프록시, TUN 모드, Android VPN 모드는 어떻게 다른가요?

시스템 프록시는 앱에 로컬 HTTP 또는 SOCKS 프록시 주소를 알립니다. 해당 설정을 읽는 앱만 이를 따릅니다. TUN 모드는 가상 네트워크 인터페이스를 통해 라우팅 조건에 맞는 트래픽을 받으므로 대체로 더 넓은 범위를 처리하지만, 권한과 제외 규칙, DNS 설정의 영향도 받습니다. v2rayNG의 VPN 모드는 Android가 제공하는 VPN 인터페이스로 기기 트래픽을 받는 기능이며, 별도의 상용 VPN 서비스에 연결하는 것과는 다릅니다. 문제를 확인할 때는 먼저 트래픽을 처리하는 방식을 하나만 사용하고, 정상 작동을 확인한 뒤 분할 라우팅 규칙을 추가하세요. 여러 프록시 도구가 동시에 네트워크 경로를 바꾸지 않도록 주의해야 합니다.

VMess, VLESS, Trojan, REALITY를 서로 바로 바꿔 사용할 수 있나요?

클라이언트에서 프로토콜 이름만 바꿔서는 사용할 수 없습니다. VMess, VLESS, Trojan은 인증 정보와 서버 설정이 서로 다릅니다. REALITY는 전송 보안 관련 설정이며, 이 프로토콜들과 나란히 놓이는 별도의 서버 유형이 아닙니다. 클라이언트에 입력하는 주소, 포트, 인증 정보, 전송 방식, 보안 매개변수는 서버 설정과 일치해야 합니다. 공유 링크를 가져왔다면 제공자가 지정한 값을 우선 그대로 사용하세요. 지원되지 않는 항목이 있다면 클라이언트와 코어를 업데이트해야 하는지 확인하세요. 보안 검증을 끄거나 프로토콜을 임의로 바꿔가며 시도하지 마세요.

설치 및 설정

기기 아키텍처에 맞는 설치 파일을 선택한 뒤 구독 형식과 권한을 확인하세요. 다시 설치해야 한다면 클라이언트 다운로드 페이지에서 플랫폼과 패키지 유형을 확인하세요.

구독을 가져오지 못할 때 주소와 클라이언트 중 무엇부터 확인해야 하나요?

먼저 주소를 확인하세요. 구독 링크 전체를 복사하고 앞뒤 공백을 제거한 뒤, 줄바꿈이나 메신저가 덧붙인 문장 부호가 없는지, 쿼리 매개변수가 잘리지 않았는지 살펴보세요. v2rayN에서는 구독 그룹의 주소 입력란에 링크를 붙여 넣고 업데이트를 실행하세요. v2rayNG에서는 구독 그룹 설정을 사용해야 하며, 구독 주소를 서버 하나의 링크처럼 클립보드에서 가져오면 안 됩니다. 로그인 페이지나 오류 페이지, 클라이언트가 지원하지 않는 형식이 반환된다면 제공자에게 알맞은 주소를 다시 요청하세요. 로그를 확인할 때는 오류 유형만 남기고, 화면을 공유하기 전에는 전체 구독 주소와 인증 정보를 가리세요.

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

먼저 기기의 프로세서 아키텍처와 시스템이 지원하는 앱 ABI를 확인하세요. 비교적 최신 Android 휴대전화는 대체로 arm64 패키지에 적합하지만, 출시 연도만으로 단정할 수는 없습니다. 일부 기기는 다른 ABI만 지원하는 시스템을 사용할 수 있습니다. universal 패키지는 여러 아키텍처를 포함하므로 보통 용량이 더 크며, 아키텍처를 확인하기 어려울 때 시도할 수 있습니다. 설치에 실패하거나 앱이 호환되지 않는다는 메시지가 표시되면 Android 버전, 저장 공간, 기존 설치 앱과 서명이 일치하는지도 확인하세요. 이전 버전을 바로 삭제하지 말고 설정을 먼저 내보내 안전하게 보관한 다음, 실제 오류에 따라 재설치 여부를 결정하세요.

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

먼저 TUN을 끄고 설정을 저장한 뒤, 현재 시스템과 클라이언트 버전에 필요한 가상 네트워크 인터페이스 생성 및 라우팅 변경 권한을 부여하세요. Windows에서는 v2rayN을 종료한 다음 관리자 권한으로 실행할 수 있습니다. macOS와 Linux에서는 클라이언트 안내에 따라 권한을 부여하세요. 일반 사용자 설정 폴더를 임의로 시스템 디렉터리로 바꾸지 마세요. 그래도 실패하면 로그에서 권한 거부, 가상 네트워크 인터페이스 생성 실패, 라우팅 충돌 중 무엇인지 확인하고 다른 VPN이나 네트워크 관리 도구가 사용 중인지 살펴보세요. 먼저 일반 프록시 연결을 확인한 뒤 TUN 문제를 따로 점검하면 서버 오류를 권한 문제로 오해하지 않을 수 있습니다.

macOS와 Linux에 v2rayN을 설치할 때 패키지는 어떻게 선택하나요?

macOS에서는 먼저 이 Mac에 관하여에서 칩을 확인하세요. Apple Silicon은 arm64, Intel 프로세서는 x64를 선택하면 됩니다. Linux에서는 프로세서 아키텍처와 배포판 패키지 형식을 함께 확인하세요. Debian·Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 사용합니다. 터미널에서 uname -m을 실행하면 아키텍처를 확인하는 데 도움이 됩니다. x86_64는 x64, aarch64는 대체로 arm64에 해당합니다. 설치에 성공해도 의존성이나 데스크톱 권한이 모두 준비된 것은 아니므로 처음 실행할 때 오류 메시지를 살펴보세요. 파일 확장자가 비슷하다는 이유만으로 다른 배포판의 패키지를 설치하지 마세요.

사용 팁

구독, 속도 측정, 앱별 설정은 각각 따로 확인하세요. 사용할 수 있는 설정을 먼저 보관하고 트래픽 처리 범위를 조금씩 조정하세요.

구독을 업데이트하면서 로컬 그룹과 라우팅 설정을 유지하려면 어떻게 해야 하나요?

먼저 클라이언트의 백업 또는 내보내기 기능으로 현재 설정을 저장하세요. 출처별로 구독 그룹을 따로 만들고 알아보기 쉬운 메모를 붙이는 것이 좋습니다. 업데이트할 때는 대상 그룹만 선택하고, 서버 목록의 검색 필터를 해제한 뒤 결과를 확인하세요. 구독으로 받은 서버 매개변수는 업데이트 과정에서 덮어쓸 수 있습니다. 계속 유지할 수동 설정은 별도 항목으로 만들고, 구독 항목을 직접 수정한 뒤 그대로 보존될 것이라고 기대하지 마세요. 라우팅 규칙과 구독 내용은 따로 관리해야 합니다. 업데이트 전후의 항목 변경과 로그를 기록해도 되지만, 전체 구독 주소를 공개 메모에 남기지 마세요.

V2Ray 서버 속도 측정에서 지연 시간과 실제 다운로드 속도는 어떻게 봐야 하나요?

먼저 어떤 방식으로 측정했는지 확인하세요. TCP 연결 테스트는 지정한 포트에 연결할 수 있는지를 주로 보여줍니다. 프록시를 통해 테스트 주소에 요청하는 방식은 실제 접속에 더 가깝지만, 모든 웹사이트에서의 체감 속도를 보장하지는 않습니다. 다운로드 속도는 회선 혼잡, 서버 부하, 대상 사이트, 로컬 대역폭의 영향을 받으므로 지연 시간이 가장 낮은 서버만 골라서는 안 됩니다. 같은 네트워크와 같은 테스트 대상을 사용해 나눠서 측정한 뒤, 실제로 이용할 서비스에 접속해 확인하세요. 속도 측정은 데이터를 소모하며 서버 측 제한을 유발할 수도 있습니다. 전체 구독을 자주 동시에 테스트하지 말고, 한 번 시간 초과가 발생했다고 계속 사용할 수 없는 서버로 단정하지 마세요.

v2rayNG 앱별 프록시 목록은 프록시를 사용할 앱을 뜻하나요, 우회할 앱을 뜻하나요?

먼저 현재 버전의 앱별 프록시 화면에서 모드 설명을 읽은 다음 앱을 선택하세요. 목록은 프록시를 적용할 앱을 지정할 수도 있고 우회할 앱을 지정할 수도 있으므로, 체크 표시 자체에 고정된 의미가 있는 것은 아닙니다. 변경한 뒤 안내에 따라 VPN 연결을 다시 시작해야 새 앱 범위가 적용됩니다. 앱을 한꺼번에 많이 추가하지 말고 브라우저 하나를 먼저 선택해 확인하세요. 시스템 구성 요소, 업무 프로필의 앱, 별도 다운로드 프로세스는 같은 트래픽 처리 범위에 포함되지 않을 수도 있습니다. 특정 앱에 문제가 생기면 앱 범위를 단순하게 되돌린 뒤 예외 항목을 하나씩 확인하세요.

휴대전화에서 LAN을 통해 컴퓨터의 v2rayN 프록시를 사용하려면 어떻게 해야 하나요?

두 기기를 신뢰할 수 있는 동일한 LAN에 연결하세요. v2rayN에서 LAN 연결 허용을 켜고 실제 수신 주소와 HTTP 프록시 포트를 확인한 다음, 컴퓨터 방화벽에서 신뢰할 수 있는 네트워크에만 해당 포트를 허용하세요. 휴대전화의 WLAN 프록시 설정에는 127.0.0.1이 아니라 컴퓨터의 LAN IP를 입력해야 합니다. 포트는 클라이언트에 표시된 값을 사용하세요. 이 방식은 주로 WLAN HTTP 프록시 설정을 따르는 앱에만 적용되며 휴대전화의 모든 트래픽을 처리하지는 않습니다. 연결되지 않으면 게스트 네트워크 격리, 컴퓨터 절전 모드, IP 주소 변경을 확인하세요. 사용이 끝나면 LAN 수신을 꺼서 접근 범위가 넓어지지 않게 하세요.

문제 해결

구독 요청, 로컬 수신, 원격 연결을 구분하세요. 오류 발생 시각과 수행한 작업, 로그의 오류 유형을 기록하면 반복해서 재설치하는 것보다 원인을 찾는 데 도움이 됩니다.

v2rayN에서 구독 업데이트에 실패했지만 기존 서버에는 연결할 수 있다면 어떻게 해야 하나요?

기존 서버에 연결할 수 있다면 데이터 연결 자체에는 문제가 없을 수 있습니다. 구독 업데이트는 별도의 요청 경로를 사용합니다. 먼저 업데이트 로그를 확인하세요. 시간 초과는 접속 경로나 DNS 문제일 가능성이 높고, 인증 오류라면 주소가 만료되었는지, 파싱 오류라면 반환 형식이 올바른지 확인해야 합니다. 현재 버전에 프록시를 통한 구독 업데이트 옵션이 있다면 사용 가능한 서버 설정을 보존한 채 시도하고, 업데이트 요청이 실제로 해당 서버를 통과하는지 확인하세요. 전체 설정을 먼저 지우거나 그룹을 반복해서 삭제하고 다시 만들지 마세요. TLS 또는 인증서 오류가 발생하면 인증서 검증을 끄는 대신 시스템 시간과 네트워크 인증 페이지를 확인하세요.

서버 테스트가 계속 시간 초과될 때 어떤 순서로 확인해야 하나요?

먼저 기기의 기본 네트워크가 정상인지 확인한 다음 서버 주소와 포트, 구독이 유효한지 점검하세요. 이어서 정상 작동이 확인된 서버 하나와 비교해 특정 항목만 실패하는지, 모든 항목이 실패하는지 확인합니다. 전부 실패한다면 로컬 방화벽, 다른 VPN, DNS 확인, 현재 네트워크 제한을 살펴보세요. 하나만 실패한다면 서버 상태와 설정 매개변수가 변경되었는지 확인하는 것이 우선입니다. TCP 테스트는 성공했는데 실제 요청이 시간 초과된다면 인증, 전송 방식 또는 보안 매개변수가 맞지 않을 수 있습니다. 로그의 연결 거부, 도메인 이름 확인 실패, 요청 시간 초과는 서로 다른 오류이므로 유형에 맞게 처리하세요.

클라이언트는 연결됨으로 표시되는데 웹페이지가 열리지 않을 때 DNS와 라우팅은 어떻게 확인하나요?

연결됨 표시는 보통 로컬 프록시나 VPN 인터페이스가 시작되었다는 뜻일 뿐, 서버와 대상 웹사이트에 모두 접속할 수 있다는 의미는 아닙니다. 먼저 클라이언트의 연결 테스트로 현재 서버를 확인한 다음 브라우저가 실제로 로컬 프록시를 사용하는지 살펴보세요. 로그에 도메인 이름 확인 실패가 표시되면 DNS 서버에 연결할 수 있는지, 아직 만들어지지 않은 프록시 경로로 DNS 요청이 잘못 전달되고 있지 않은지 확인하세요. 일부 도메인만 실패한다면 라우팅 규칙의 일치 순서와 대상 아웃바운드를 점검하세요. 원래 설정을 백업하고 단순한 규칙으로 되돌려 비교하세요. DNS, 프로토콜, 라우팅을 한꺼번에 바꾸면 어떤 변경이 효과가 있었는지 판단하기 어렵습니다.

시스템 프록시가 작동하지 않을 때 브라우저는 되는데 터미널은 안 되는 이유는 무엇인가요?

먼저 v2rayN에서 시스템 프록시 자동 설정이 선택되어 있는지 확인하고, 현재 HTTP 및 SOCKS 수신 포트를 확인하세요. 브라우저는 시스템 설정을 읽을 수도 있지만 확장 프로그램이나 별도의 프록시 설정이 이를 덮어쓸 수도 있습니다. 터미널 도구는 자체 설정이나 프록시 환경 변수를 따르는 경우가 많습니다. curl --proxy http://127.0.0.1:10809 https://example.com을 임시로 실행해 HTTP 프록시 경로를 확인할 수 있습니다. 포트는 실제 값으로 바꿔야 합니다. 프록시를 명시하면 작동하지만 일반 명령에서는 작동하지 않는다면 해당 터미널 도구에 환경 변수를 설정하세요. 로컬 프록시 문제와 원격 서버 시간 초과를 같은 문제로 다루지 마세요.