v2rayN
데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 창 구성을 유지합니다. 먼저 시스템 설정에서 프로세서 종류를 확인한 뒤 설치 안내를 읽어 보세요. 두 인터페이스 사이를 전환하기 전에는 구독 그룹과 사용자 지정 라우팅을 백업해 인터페이스 차이를 연결 문제로 오해하지 않도록 하세요.
다운로드 페이지로 이동 →운영체제별 설치 파일 선택
먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요. 설치 파일은 다운로드 페이지에서 확인할 수 있으며, 홈페이지에서는 클라이언트 선택과 설정 방법을 안내합니다.
데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 창 구성을 유지합니다. 먼저 시스템 설정에서 프로세서 종류를 확인한 뒤 설치 안내를 읽어 보세요. 두 인터페이스 사이를 전환하기 전에는 구독 그룹과 사용자 지정 라우팅을 백업해 인터페이스 차이를 연결 문제로 오해하지 않도록 하세요.
다운로드 페이지로 이동 →‘이 Mac에 관하여’에서 칩 이름을 확인하고 Apple Silicon과 Intel에 맞는 설치 파일을 선택하세요. 처음 실행할 때 시스템 경고가 표시되면 다운로드 출처를 확인하고 안내 내용을 읽어 보세요. 설치 후에는 네트워크 프록시가 클라이언트의 현재 로컬 포트를 가리키는지 확인하세요.
다운로드 페이지로 이동 →먼저 Xray 코어를 사용하는 v2rayNG를 살펴보고, V2Fly 코어가 필요할 때 v2flyNG를 고려하세요. 비교적 최신 Android 휴대전화는 대부분 arm64를 선택할 수 있습니다. 아키텍처를 모르겠다면 범용 패키지 안내를 확인하세요. 처음 연결할 때는 시스템 VPN 권한을 허용하고, 다른 앱이 이미 VPN 연결을 사용 중인지 확인하세요.
다운로드 페이지로 이동 →Ubuntu와 Debian 데스크톱에서는 보통 deb, Fedora 등에서는 rpm 패키지를 선택합니다. x64와 arm64도 구분해야 합니다. 그래픽 클라이언트는 데스크톱 환경에 적합합니다. 터미널 프로그램의 프록시 사용 여부는 프로그램 자체 설정에 달려 있으므로 데스크톱의 시스템 프록시 스위치만 보고 판단하지 마세요.
다운로드 페이지로 이동 →클라이언트는 설정을 읽고 코어를 실행하며 로컬 프록시를 관리하지만, 설치만으로 사용할 수 있는 원격 연결을 자동 생성하지는 않습니다. 신뢰할 수 있는 출처에서 받은 구독 주소나 개별 설정을 준비하고, 사용 권한과 유효 기간을 확인한 뒤 가이드에 따라 가져오세요. 구독 링크에는 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷에 노출하거나 출처가 불분명한 온라인 변환 사이트에 입력하지 마세요. V2Ray 구독 변환이 꼭 필요하다면 대상 클라이언트가 지원하는 형식인지 확인하고, 설정 제공자가 명시적으로 지원하는 내보내기 방식을 우선 사용하세요.
처음 설정할 때는 클라이언트를 하나만 실행하고 기본 수신 포트를 유지하세요. 브라우저 프록시 확장 프로그램이나 네트워크를 가로채는 다른 도구는 일단 함께 사용하지 않는 편이 좋습니다. 먼저 구독을 가져올 수 있는지, 코어가 실행되는지 확인한 다음 시스템 프록시를 켜세요. 기본 연결이 확인된 후 라우팅 규칙과 TUN을 설정하세요. 한 번에 한 가지씩만 변경하면 문제가 생겼을 때 원인을 파악하고 이전 설정으로 되돌리기 쉽습니다.
설정 항목별 연결 경로 이해하기
화면에 표시되는 항목 이름은 플랫폼과 버전에 따라 달라질 수 있습니다. 먼저 각 설정의 역할을 이해한 다음 클라이언트의 해당 옵션을 확인하세요. 데스크톱 메뉴를 Android에 그대로 적용하지 마세요.
노드 목록이 비어 있거나 업데이트 후에도 바뀌지 않는다면 먼저 ‘구독 그룹 설정’에서 주소가 올바른지, 그룹이 활성화되어 있는지, 구독이 아직 유효한지 확인하세요. 출처별로 그룹을 나누면 업데이트할 때 설정을 혼동하지 않을 수 있습니다. 현재 연결을 사용할 수 없다면 ‘프록시를 사용하지 않고 구독 업데이트’를 시도해 보세요. 주소가 특정 네트워크 경로에서만 열리는 경우에는 해당 경로를 이용해야 합니다. 업데이트가 완료되면 실제로 가져온 항목을 확인하세요. 요청 완료가 노드 연결 가능을 뜻하지는 않습니다. 그룹을 사용하면 항목별로 직접 관리하는 것보다 일괄 업데이트가 쉽지만, 만료된 주소가 자동으로 복구되지는 않습니다.
설정 가이드 보기 →같은 노드로 일부 사이트에는 접속되지만 다른 사이트에서 시간 초과가 발생한다면 먼저 대상 도메인에 어떤 라우팅 규칙이 적용되는지 확인하세요. 규칙은 일반적으로 순서대로 적용되므로 범위가 넓은 규칙이 요청을 먼저 가로챌 수 있습니다. ‘IPIfNonMatch’는 도메인 규칙이 일치하지 않을 때 대상 주소를 확인한 뒤 IP 규칙을 적용한다는 뜻이며, 모든 요청이 먼저 IP로 확인된다는 의미는 아닙니다. 이해하기 쉬운 기본 규칙을 먼저 사용하고 사용자 지정 규칙은 필요한 만큼만 추가하세요. 변경할 때마다 같은 대상을 다시 테스트하세요. 라우팅은 연결 경로를 정하는 기능이지 노드 연결을 확인하거나 원격 인증 오류를 해결하는 기능은 아닙니다.
설정 가이드 보기 →IPIfNonMatch시스템 프록시는 해당 설정을 읽는 앱에만 적용되므로 모든 프로그램의 트래픽이 클라이언트를 통과하는 것은 아닙니다. ‘시스템 프록시 자동 설정’은 로컬 프록시 주소를 시스템에 지정하고, ‘시스템 프록시 지우기’는 관련 설정을 제거하며, ‘시스템 프록시 변경 안 함’은 현재 상태를 유지합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 처리하며 권한, 라우팅, DNS 설정이 함께 필요할 수 있습니다. 먼저 일반 프록시 연결을 확인한 뒤 TUN 사용 여부를 결정하세요. 처음부터 여러 트래픽 처리 방식을 동시에 켜지 마세요. 터미널, 브라우저 확장 프로그램, Android VPN은 각각 설정 위치가 다르므로 실제 요청 경로를 따로 확인해야 합니다.
설정 가이드 보기 →그래픽 클라이언트와 코어의 역할은 다릅니다. 클라이언트는 설정을 관리하고, 코어는 프로토콜과 네트워크 연결을 처리합니다. v2rayN은 지원되는 설정에서 Xray나 sing-box를 사용할 수 있지만, 구체적인 메뉴와 지원 범위는 버전과 플랫폼에 따라 다릅니다. 지원되지 않는 전송 방식이나 매개변수 오류가 표시되면 코어를 반복해서 바꾸기보다 먼저 로그의 오류를 기록하고 설정 요구 사항을 확인하세요. Android에서는 Xray를 사용하는 v2rayNG와 V2Fly를 사용하는 v2flyNG도 구분해야 합니다. 코어 전환은 호환성 문제를 해결할 수 있지만 만료된 구독이나 잘못된 인증 정보를 유효하게 만들지는 않습니다.
설정 가이드 보기 →Project V · V2Fly · Xray
클라이언트, 코어, 프로토콜, 구독을 각각 구분해 이해하세요. 그래픽 인터페이스를 다운로드하는 것은 첫 단계일 뿐이며, 실제 연결에는 설정과 네트워크 환경도 필요합니다.
V2Ray는 Project V 생태계에서 시작했습니다. 설정을 통해 인바운드, 아웃바운드, 라우팅을 조합해 앱 요청이 처리되는 경로를 지정하는 것이 핵심입니다. V2Fly는 V2Ray 관련 코어를 커뮤니티에서 이어서 관리하며, Xray는 관련 코드 기반에서 발전해 자체 구현과 기능을 갖췄습니다. 서로 역사적 연관성이 있지만 모든 매개변수와 프로토콜 확장, 설정 파일을 그대로 호환할 수 있다고 가정해서는 안 됩니다.
프로토콜은 통신 규칙을 설명하고 코어는 해당 프로토콜을 구현하며, 그래픽 클라이언트는 자주 쓰는 기능을 메뉴로 제공합니다. VMess, VLESS, Trojan, REALITY 등의 이름을 확인했다면 설정 요구 사항과 코어 지원 여부부터 살펴보세요. 클라이언트 이름이 비슷하다는 이유만으로 설정을 가져오지 마세요. 전송 방식과 TLS 매개변수, 서버 측 설정은 서로 일치해야 하며 한쪽만 변경해서는 호환되지 않는 경우가 많습니다.
문제를 해결할 때는 막연히 ‘V2Ray가 안 된다’고 설명하기보다 ‘사용한 클라이언트, 코어, 연결 방식, 실패한 단계’를 기록하는 편이 효과적입니다. 로그의 시작 실패와 요청 시간 초과는 서로 다른 단계의 문제입니다. 시작 실패는 설정과 수신 상태를 먼저 확인하고, 시간 초과는 원격 서버와 이름 확인, 연결 경로를 살펴보세요.
v2rayN은 데스크톱용으로 서버 목록, 구독 그룹, 시스템 프록시, 라우팅을 한곳에서 관리합니다. v2rayNG는 Android용이며 Xray 코어를 사용하고 시스템 VPN 인터페이스로 앱 트래픽을 처리합니다. v2flyNG도 Android용으로 V2Fly 코어를 사용하며 해당 코어의 동작이나 호환 범위가 필요한 경우에 적합합니다. 세 클라이언트 모두 오픈 소스이지만 같은 프로그램의 스킨만 다른 것은 아닙니다.
데스크톱과 휴대전화에서 같은 출처의 호환 설정을 사용할 수 있지만 로컬 프록시 포트, 백그라운드 실행 방식, 권한 요구 사항은 다릅니다. 데스크톱의 ‘시스템 프록시 자동 설정’은 Android VPN 권한을 대신하지 않으며, Android의 연결 버튼은 데스크톱의 모든 네트워크 설정에 대응하지 않습니다. 다른 기기로 옮길 때는 설정을 가져온 뒤 대상 기기에 맞는 연결 방식을 다시 확인하세요.
이 사이트는 다운로드 경로와 한국어 사용 안내를 정리하며 각 프로젝트의 공식 개발 사이트는 아닙니다. ‘v2rayN 공식 사이트’나 ‘v2rayNG 공식 사이트’를 검색할 때는 사이트 운영 주체, 소프트웨어 프로젝트, 설정 제공자를 구분하세요. 세 주체의 역할과 책임은 서로 다릅니다.
오픈 소스 소프트웨어는 해당 라이선스에 따라 코드가 공개되어 있다는 뜻입니다. 사용, 수정, 재배포에는 각 프로젝트의 라이선스 조건을 따라야 합니다. 클라이언트와 코어, 포함된 구성 요소의 라이선스가 서로 다를 수 있으므로 재배포할 때는 각각의 라이선스 안내를 확인하세요. ‘오픈 소스’라는 말만으로 사용 허가 여부를 판단할 수 없습니다. 소프트웨어가 무료라는 사실과 원격 서비스에 요금이 부과될 수 있다는 점도 구분해야 합니다.
구독에는 여러 연결 설정이 포함되며 서버 주소, 사용자 식별자, 인증 정보가 들어갈 수 있습니다. 문제를 공개적으로 문의할 때는 구독 주소와 민감한 매개변수를 가리고 오류 유형, 메뉴 위치, 필요한 환경 정보만 남기세요. 문제 재현을 위해 구독 전체를 공개하지 마세요. 민감 정보를 제거한 로그와 작업 순서를 공유하는 편이 문제 파악에 도움이 됩니다.
설정을 가져올 수 있다고 해서 서비스가 유효하거나 모든 앱이 프록시에 연결된 것은 아닙니다. 출처와 호환성, 사용 권한을 확인한 뒤 실제 접속으로 연결 상태를 검증하세요. 인증서 오류가 발생하면 시스템 시간, 대상 이름, 설정의 일치 여부를 먼저 확인하세요. 보안 검사를 끄는 방법을 일반적인 해결책으로 사용하지 마세요.
그래픽 클라이언트와 코어, 라우팅 데이터는 각각 별도로 업데이트될 수 있습니다. 메뉴에 옵션이 하나 추가됐다고 모든 기존 설정을 함께 변경할 필요는 없으며, 프로토콜 지원 변화도 인터페이스가 아니라 코어에서 비롯될 수 있습니다. 업데이트 전에 현재 정상 동작 상태를 기록하고 구독 그룹, 사용자 지정 규칙, 필요한 설정을 백업한 다음 사용 중인 플랫폼 관련 변경 사항을 확인하세요.
업데이트 후에는 최소 설정부터 확인하세요. 클라이언트를 실행하고 코어가 정상 작동하는지 확인한 다음, 작동이 확인된 설정 하나로 지정된 대상에 접속해 보세요. 기본 연결을 확인한 뒤 사용자 지정 라우팅, TUN, 백그라운드 실행 설정을 복원하세요. 업데이트 후에만 문제가 발생한다면 구체적인 오류와 재현 단계를 기록하세요. 설정 삭제, 코어 교체, 네트워크 초기화를 동시에 하면 원인을 파악하기 어렵습니다.
구독 업데이트가 실패하면 주소와 요청 경로부터 확인하세요. 웹페이지가 열리지 않으면 클라이언트가 수신 중인지, 앱이 프록시를 사용하는지 살펴보세요. 속도가 느리다면 네트워크와 원격 서버 부하를 비교해 보세요. 이런 식으로 시작점에서 출구까지 순서대로 확인하면 반복해서 재설치하는 것보다 유용한 단서를 더 잘 보존할 수 있습니다. 복잡한 문제는 문제 해결 가이드에서 더 확인하세요.
목록에 사용 가능한 설정이 있는지, 현재 서버를 선택했는지 먼저 확인한 다음 코어 시작 로그를 살펴보세요. 코어가 정상이라면 ‘시스템 프록시 자동 설정’을 확인하고 브라우저 확장 프로그램이 프록시를 덮어쓰는지도 점검하세요. 한 앱에서만 문제가 발생한다면 모든 노드를 바꾸기보다 해당 앱의 프록시 설정부터 확인하세요. 설정 가이드에 따라 연결 상태를 추가로 점검할 수 있습니다.
먼저 포트를 사용 중인 프로그램을 확인하고 정체를 모르는 시스템 프로세스를 바로 종료하지 마세요. 클라이언트가 중복 실행됐는지, 다른 프록시 프로그램이 같은 포트를 사용 중인지 살펴보세요. ‘로컬 혼합 프록시 포트’를 변경해야 한다면 새 포트 번호를 기록하고 서비스를 다시 시작한 뒤 브라우저와 앱에 직접 입력한 프록시 설정도 함께 수정하세요. 화면에서 값을 바꿔도 기존 포트 설정이 모두 자동으로 사라지지는 않습니다. 자세한 내용은 문제 해결을 참고하세요.
먼저 TUN을 끄고 일반 프록시 모드가 작동하는지 확인하세요. 일반 모드가 정상이라면 TUN에 필요한 권한과 가상 인터페이스, 다른 네트워크 도구와의 충돌 여부를 각각 점검하세요. 현재 DNS와 라우팅 설정을 기록해 두고 한 번에 한 항목만 변경한 뒤 다시 테스트하세요. 클라이언트를 종료한 후에도 네트워크에 접속할 수 없다면 남아 있는 시스템 프록시도 확인하세요. 자세한 내용은 문제 해결 가이드를 참고하세요.
구독 업데이트는 주소에 설정을 요청하는 과정이고, 노드 연결은 가져온 설정으로 원격 서버에 접속하는 과정입니다. 두 과정은 서로 다른 네트워크 경로를 사용할 수 있습니다. 먼저 구독 주소가 유효하고 형식이 지원되는지 확인한 뒤 프록시 사용 여부에 따른 업데이트 방식을 비교하세요. 기존 노드의 연결 시간 초과가 직접 연결을 통한 업데이트를 막는 것은 아니며, 구독 업데이트에 성공해도 원격 서비스가 정상이라는 보장은 없습니다. 다른 증상은 문제 해결에서 확인하세요.
사용 팁
구체적인 증상에 맞는 사용 안내를 확인하세요. 실패한 단계를 찾고 관련 설정을 조정한 뒤 각 변경 전후의 결과를 기록하세요.
Ubuntu, Debian, Fedora 데스크톱 사용자를 대상으로 deb 및 rpm 패키지 설치 명령, 의존성 문제 해결, 데스크톱 바로가기, 부팅 시 자동 실행 설정을 안내합니다. 먼저 배포판과 프로세서 아키텍처를 확인한 다음 설치 실패, 인터페이스 실행 실패, 프록시 미적용을 구분하세요.
설치 단계 보기 →구독 주소 만료, 형식 인식 실패, 잘못된 경로로 업데이트 요청이 전송되는 등 자주 발생하는 원인을 정리하고 구독 그룹의 자동 업데이트 간격과 ‘프록시를 사용하지 않고 업데이트’ 설정 방법을 설명합니다. 먼저 요청이 도달하는지 확인한 뒤 응답 내용을 살펴보고, 오류 페이지를 유효한 구독으로 오해하지 않도록 하세요.
업데이트 문제 해결 보기 →시스템 프록시 자동 설정을 켰는데 웹페이지가 열리지 않는다면 브라우저 확장 프로그램, 시스템 설정, 터미널 환경 변수로 나누어 확인하세요. 먼저 로컬 프록시가 계속 수신 중인지 확인한 뒤 각 앱에서 실제로 사용하는 주소와 포트를 점검하세요. 브라우저에서 접속된다고 터미널에서도 접속되는 것은 아닙니다.
프록시 문제 해결 보기 →