설정 화면 예시입니다. 메뉴 이름과 위치는 클라이언트 빌드에 따라 다를 수 있습니다.
먼저 운영체제를 확인하고, 다음으로 프로세서 아키텍처를 확인하세요. 데스크톱과 안드로이드는 트래픽을 처리하는 방식이 다릅니다. 구독을 가져온 뒤에도 기기별 설정을 마쳐야 합니다.
v2rayN · 데스크톱 버전과 클래식 WPF 버전
다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 익숙한 데스크톱 사용 방식을 유지합니다. 기존 설정이 있다면 화면 구성을 바꾸기 전에 구독 그룹, 라우팅, 수신 포트를 기록해 두세요. 버전에 따라 메뉴 위치가 다를 수 있으므로 스크린샷만 보고 설정의 유무를 판단하지 마세요.
처음 연결할 때는 시스템 프록시를 사용해 브라우저에서 대상 서비스에 접속되는지 확인한 뒤 Tun 모드를 켤지 결정하세요. 시스템 프록시는 해당 설정을 참조하는 앱에만 적용되므로 컴퓨터 전체의 트래픽이 프록시를 통한다고 단정할 수 없습니다. 클라이언트를 종료하기 전에 시스템 프록시를 해제하면 로컬 포트가 닫힌 뒤 발생할 수 있는 연결 문제를 줄일 수 있습니다.
다운로드 페이지로 →v2rayN · 칩에 맞는 설치 파일 선택
시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 칩 이름이 표시되는지 Intel 프로세서가 표시되는지 확인하세요. Apple Silicon과 Intel은 설치 파일이 다릅니다. 아키텍처에 맞는 파일을 선택한 다음 실행 권한과 네트워크 권한을 설정하세요. 설치만으로 프록시가 활성화되는 것은 아닙니다. 현재 네트워크 서비스가 클라이언트의 로컬 프록시 설정을 사용하도록 되어 있는지도 확인해야 합니다.
무선 네트워크를 바꾸거나 유선 네트워크에 연결한 뒤, 또는 절전 모드에서 복귀한 뒤 브라우저만 접속되지 않는다면 시스템 네트워크 설정과 클라이언트 실행 상태부터 확인하세요. 노드, 라우팅, DNS를 한꺼번에 바꾸지 마세요. 정상 작동이 확인된 설정을 남겨 두고 하나씩 되돌려야 문제가 네트워크 전환, 권한, 프록시 연결 중 어디서 생겼는지 구분할 수 있습니다.
다운로드 페이지로 →v2rayNG 우선 추천 · v2flyNG 대안
v2rayNG는 Xray 코어를 사용해 일반적인 안드로이드 설정을 시작하기에 적합합니다. V2Fly 코어 환경이 필요하다면 v2flyNG를 고려하세요. 대부분의 기기에서는 arm64를 선택하면 됩니다. 확실하지 않다면 시스템 정보와 다운로드 페이지의 범용 버전 안내를 먼저 확인하세요. 설치 파일의 아키텍처와 노드의 프로토콜은 서로 다른 항목이므로 구독에 적힌 프로토콜 이름으로 휴대폰 아키텍처를 판단할 수 없습니다.
VPN 모드를 처음 사용할 때는 시스템 연결 권한을 허용하고, 배터리 절약 설정이 백그라운드 실행을 제한하는지 확인하세요. 안드로이드에서는 일반적으로 이러한 VPN 연결을 한 번에 하나만 사용할 수 있습니다. 다른 네트워크 앱이 연결을 사용 중이라면 먼저 충돌을 해결해야 합니다. 앱별 프록시는 기본 연결이 정상인지 확인한 다음 설정하세요. 처음부터 테스트할 앱을 프록시 대상에서 제외하지 않도록 주의하세요.
다운로드 페이지로 →v2rayN · 배포판과 아키텍처에 맞는 파일 선택
먼저 배포판에서 deb와 rpm 중 어떤 패키지를 사용하는지 확인하고 x64 또는 arm64를 선택하세요. 데스크톱 환경의 프록시 설정과 개별 앱의 프록시 설정은 서로 별개일 수 있습니다. 브라우저는 되는데 다른 프로그램은 연결되지 않는다면 구독을 다시 가져오기보다 해당 프로그램이 데스크톱 프록시 설정을 참조하는지 먼저 확인하세요.
Tun 모드에는 권한, 가상 네트워크 어댑터, 기존 네트워크 규칙이 관련되므로 모든 연결 문제를 해결하는 만능 스위치로 여겨서는 안 됩니다. 먼저 일반 프록시 방식으로 재현 가능한 연결을 만든 뒤 필요에 따라 트래픽 적용 범위를 넓히세요. 시스템에 다른 프록시나 가상 네트워크 도구가 있다면 기존 설정을 기록한 다음 하나씩 끄고 비교하세요. 여러 연결 경로가 서로 덮어쓰는 일을 피할 수 있습니다.
다운로드 페이지로 →세 클라이언트는 설정을 읽고 코어를 실행해 로컬 프록시 연결 지점을 제공합니다. 서버 주소와 접속 정보는 실제로 이용하는 서비스에서 받아야 합니다. 설치 후에는 구독 출처를 확인한 다음 설정을 진행하세요.
모든 클라이언트 보기 →설정 목적에 맞는 메뉴를 찾아 ‘프록시 켜기’와 ‘라우팅 선택’을 한 단계로 혼동하지 마세요. 아래 창은 메뉴 위치를 보여 주는 예시입니다. 항목을 선택하면 관련 설명을 확인할 수 있습니다.
구독 그룹 → 구독 추가 또는 편집에서 주소가 신뢰할 수 있는 출처인지 확인한 뒤 업데이트하세요. 그룹은 서로 다른 출처의 설정을 구분해 관리하기 위한 기능이며, 현재 선택된 연결을 자동으로 바꾸지는 않습니다. 업데이트 후 프로토콜 파싱 오류가 있는지 확인하고 활성 설정을 다시 점검하세요. 여러 설정을 한 목록에 섞어 두는 것보다 그룹별로 관리하면 업데이트에 실패한 구독을 찾기 쉽고 직접 추가한 설정도 별도로 보관할 수 있습니다. 구독 주소에는 접속 정보가 포함될 수 있으므로 스크린샷을 공유할 때는 전체 주소를 가리세요. 업데이트가 실패하면 주소가 만료됐는지 먼저 확인하고, 기존 프록시를 통해 업데이트해야 하는지도 살펴보세요.
메인 화면 또는 트레이 메뉴 → 시스템 프록시에서 ‘시스템 프록시 자동 설정’을 선택하면 시스템 설정을 참조하는 앱이 로컬 수신 포트로 연결됩니다. 이 설정은 앱이 클라이언트에 연결되는 방식을 정할 뿐, 요청이 최종적으로 직접 연결될지 프록시를 거칠지는 결정하지 않습니다. Tun 모드보다 적용 범위가 좁아 첫 연결을 확인하기에 적합합니다. 브라우저는 되는데 특정 프로그램이 연결되지 않는다면 해당 프로그램의 프록시 설정부터 확인하세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제하세요. ‘시스템 프록시 변경 안 함’은 기존 값을 유지하는 옵션일 뿐, 프록시를 켜거나 해제하는 설정이 아닙니다.
라우팅 설정 → 규칙 세트를 선택한 뒤 각 규칙의 순서를 확인하세요. 라우팅은 코어에 전달된 요청을 어떤 아웃바운드로 보낼지 결정하며, 앱에서 프록시를 활성화하지는 않습니다. 시스템 프록시를 단순히 켜고 끄는 것과 달리 도메인이나 주소 등의 조건에 따라 트래픽을 나눌 수 있습니다. 앞쪽의 포괄적인 규칙이 뒤쪽의 세부 규칙보다 우선 적용될 수도 있습니다. 변경 후 다시 연결하고 실제 접속과 로그를 통해 규칙이 적용됐는지 확인하세요. 도메인 목록이나 주소 목록을 사용하는 경우 관련 리소스 파일을 정상적으로 읽을 수 있는지도 점검해야 합니다. 웹사이트 하나가 열린다고 모든 대상의 트래픽이 의도대로 분리된 것은 아닙니다. 직접 연결과 프록시 요청을 모두 테스트하세요.
메인 화면 → Tun 모드에서 기능을 켜기 전에 클라이언트에 필요한 권한과 가상 네트워크 어댑터 구성 요소를 확인하세요. 시스템 프록시를 참조하지 않는 앱의 트래픽을 처리할 수 있지만, 잘못된 서버 설정을 고치거나 모든 프로토콜이 서버를 통해 연결되도록 보장하지는 않습니다. 일반 시스템 프록시보다 로컬 네트워크에 미치는 영향이 크므로 DNS, 라우팅, 다른 가상 네트워크 도구도 함께 점검해야 합니다. 켠 뒤 전체 네트워크에 문제가 생기면 먼저 Tun을 끄고 기존 상태를 복구한 다음 시작 로그와 권한 안내를 확인하세요. 여러 네트워크 스위치를 동시에 반복해서 바꾸지 마세요. 단계별 변경 사항을 기록해야 충돌 원인을 찾을 수 있습니다.
v2rayNG 설정 → 앱별 프록시에서 먼저 목록이 ‘선택한 앱만 프록시 적용’인지 ‘선택한 앱 우회’인지 확인한 다음 앱을 선택하세요. 이 설정은 VPN이 처리할 앱을 정하는 기능으로, 도메인별 트래픽을 나누는 라우팅 규칙과는 별개입니다. 데스크톱 시스템 프록시와 달리 앱 단위로 범위를 지정할 수 있지만 안드로이드 VPN 모드가 필요합니다. 변경 후 연결을 끊었다가 다시 연결해 목록을 적용하고, 테스트할 때 브라우저가 제외되지 않았는지 확인하세요. 앱을 다시 설치하거나 별도의 업무 프로필을 추가한 경우에도 목록이 의도한 앱을 가리키는지 점검해야 합니다.
테스트 순서는 일정하게 유지하세요. 먼저 구독 내용이 정상적으로 파싱되는지 확인하고, 다음으로 코어가 실행되는지, 앱이 로컬 프록시에 연결되는지, 마지막으로 라우팅 결과가 맞는지 확인합니다. 앞 단계가 해결되지 않았다면 스위치를 더 켜도 원인을 파악하기 어렵습니다. 가이드는 이 순서에 따라 설정을 설명하고, 문제 해결 문서는 인터넷 연결 불가, 구독 실패, DNS 이상 등의 증상에서 원인을 역으로 찾도록 구성했습니다.
v2rayN 설정 가이드 읽기 →클라이언트, 코어, 프로토콜은 각각 다른 계층을 가리킵니다. 각자의 역할을 구분한 다음 설정을 사용할 수 있는지 판단하세요.
Project V는 V2Ray 생태계를 이해하는 출발점입니다. 그래픽 클라이언트는 구독, 라우팅, 로컬 프록시 옵션을 화면에 정리해 보여 주고, 코어는 설정을 읽어 실제 네트워크 연결을 처리합니다. 흔히 말하는 ‘V2Ray 설치’는 코어 설정을 직접 편집하는 것보다 코어를 관리하는 클라이언트를 설치하는 경우가 많습니다.
V2Fly는 V2Ray의 커뮤니티 개발을 이어 가고, Xray는 관련 기술을 기반으로 자체 구현과 기능을 발전시켜 왔습니다. 두 프로젝트는 일부 개념과 설정 방식을 공유하지만 이름이 비슷하다고 기능까지 완전히 같다고 볼 수는 없습니다. 특정 전송 방식, 프로토콜 매개변수, 확장 기능의 지원 여부는 클라이언트가 실제로 사용하는 코어를 기준으로 확인하세요.
v2rayN · v2rayNG · v2flyNG
Xray · V2Fly
프로토콜, 전송, 라우팅 및 DNS
v2rayN은 데스크톱용 클라이언트로, 그래픽 인터페이스에서 연결, 구독, 라우팅을 관리하는 데 중점을 둡니다. 여러 코어를 사용할 수 있으므로 ‘인터페이스에서 특정 설정을 추가할 수 있는지’와 ‘현재 코어가 해당 설정을 실행할 수 있는지’를 각각 확인해야 합니다. 실행에 실패하면 클라이언트 화면이 비슷한지만 비교하지 말고 오류에 표시된 필드와 코어 이름을 확인하세요. 데스크톱의 프록시 수신 주소도 중요합니다. 로컬 기기에서만 사용하는 것과 로컬 네트워크에 공유하는 것은 다른 상황이며, 접근 범위를 넓힐수록 방화벽과 네트워크 환경을 함께 점검해야 합니다.
v2rayNG는 Xray 코어를 사용하는 안드로이드 오픈소스 그래픽 클라이언트로, 시스템 VPN 인터페이스나 로컬 프록시 방식으로 작동합니다. v2flyNG도 안드로이드용이며 V2Fly 코어를 사용해 해당 코어 환경이 필요한 경우 대안으로 쓸 수 있습니다. 두 클라이언트는 화면과 사용 방식이 비슷하지만 설정 지원 여부는 각 코어를 기준으로 확인해야 합니다. 이미 정상 작동하는 설정이 있다면 이름이 다르다는 이유만으로 옮길 필요는 없습니다. 전환해야 한다면 필요한 정보를 먼저 내보내고 VPN 권한, 앱 목록, 백그라운드 실행 제한을 각각 확인하세요.
이 클라이언트들은 오픈소스 프로젝트로 개발되며 관련 클라이언트 프로젝트에는 GPL 계열 라이선스가 적용됩니다. V2Fly와 Xray 코어 프로젝트에는 MPL 2.0 라이선스가 적용됩니다. 클라이언트, 코어, 함께 배포되는 의존성의 라이선스를 하나로 묶어 판단해서는 안 됩니다. 재배포 의무는 각 구성 요소의 라이선스 전문을 확인하세요. 일반 사용자에게 오픈소스란 코드와 구현이 공개적으로 논의되고 검토될 기반이 있다는 뜻이지, 모든 외부 구독이 같은 수준으로 검증됐다는 뜻은 아닙니다.
구독은 서버 주소, 사용자 식별 정보, 전송 매개변수, 접속 정보가 함께 포함될 수 있는 실행 설정입니다. 소프트웨어가 오픈소스라고 해서 설정 출처를 따로 확인할 필요가 없어지는 것은 아니며, 서버가 데이터를 어떻게 처리하는지도 보장하지 않습니다. 가져오기 전에 출처를 확인하고, 도움을 요청할 때는 필요한 오류 정보만 공유하세요. 전체 구독 주소와 사용자 정보를 가리면 전체 설정을 공개하지 않고도 문제를 파악하기 쉽고 접속 권한이 노출되는 일도 막을 수 있습니다.
클라이언트 업데이트, 코어 업데이트, 라우팅 리소스 업데이트는 각각 다른 작업입니다. 인터페이스 업데이트는 메뉴 이름을 바꿀 수 있고, 코어 업데이트는 설정 지원 범위에 영향을 줄 수 있으며, 규칙 리소스 업데이트는 트래픽 분류 결과를 바꿀 수 있습니다. 동작이 달라졌다면 어떤 계층을 변경했는지 먼저 되짚어 보세요. 여러 업데이트와 설정 변경을 한꺼번에 진행하면 비교 기준이 사라져 간단한 문제도 재현하기 어려워질 수 있습니다.
먼저 활성 설정, 수신 포트, 사용자 지정 라우팅을 기록하고 해당 업데이트 안내를 읽은 뒤 설치하거나 교체하는 것이 안전합니다. 완료 후 구독이 유지됐는지, 코어가 실행되는지, 시스템 프록시가 현재 포트를 가리키는지 확인하고 직접 연결해야 할 대상과 프록시를 거쳐야 할 대상을 각각 테스트하세요. 이전 상태로 되돌릴 계획이라면 기존 환경이 새 설정 필드를 지원하는지도 확인해야 합니다. 백업 파일에는 민감한 정보가 포함될 수 있으므로 접근이 통제되는 곳에 보관하세요.
실제 연결 테스트는 일부 사용할 수 없는 설정을 걸러내는 데 도움이 됩니다. 하지만 테스트 성공은 해당 시점에 테스트 대상과 연결할 수 있었다는 뜻일 뿐입니다. 브라우저 캐시, 앱 자체 프록시 설정, DNS 해석, 서버 정책에 따라 다른 대상은 다르게 동작할 수 있습니다. 테스트 결과 하나만으로 기기 전체의 프록시 상태를 판단하거나 한 번의 시간 초과를 클라이언트 오류로 단정하지 마세요.
문제를 확인할 때는 최소한의 환경을 유지하세요. 클라이언트 하나, 정상 여부를 확인한 설정 하나, 명확한 테스트 앱 하나로 시작합니다. 먼저 프록시를 끈 상태의 기본 네트워크와 켠 뒤의 변화를 비교하세요. 특정 앱에서만 문제가 생긴다면 해당 앱의 프록시 연결 경로와 라우팅 결과를 확인하세요. 로그에 오류가 나타나면 발생한 동작과 오류 유형만 기록하고 전체 설정을 공개하지 마세요. 계층별로 확인하는 편이 반복해서 재설치하는 것보다 문제 원인에 가까이 다가갈 수 있습니다.
사용할 수 있는 서버 설정 또는 구독 주소가 필요합니다. 클라이언트는 설정 관리와 연결 기능을 제공하지만, 설치만으로 사용할 수 있는 서비스를 자동 생성하지는 않습니다. 설정 출처와 프로토콜 지원 여부를 확인한 뒤 빠른 시작 가이드에 따라 가져와 연결을 확인하세요.
두 기능을 기본적으로 함께 켤 필요는 없습니다. 먼저 시스템 프록시를 사용해 해당 설정을 참조하는 앱이 연결되는지 확인하고, 다른 앱의 트래픽도 처리해야 하는지에 따라 Tun 모드를 사용할지 판단하세요. 두 방식은 서로 다른 네트워크 계층에 적용됩니다. 자세한 문제 해결 방법은 문제 해결 문서를 참고하세요.
화면이 켜져 있을 때는 안정적인데 잠근 뒤 연결이 반복해서 끊긴다면 먼저 클라이언트의 백그라운드 실행이 제한됐는지 확인하고 네트워크 전환 여부도 살펴보세요. 화면이 켜져 있어도 연결되지 않는다면 설정과 기본 네트워크를 확인하세요. 자세한 내용은 자주 묻는 질문을 참고하세요.
아닙니다. 가져오기는 설정을 파싱하고 저장하는 단계일 뿐입니다. 실제 실행 시 코어에서 지원하지 않는 매개변수나 필수 필드 누락, 서버 설정 불일치가 발생할 수 있습니다. 실행 결과와 연결 로그를 확인하고 문제 해결 절차에 따라 원인을 하나씩 찾으세요.
프로토콜 필드부터 로컬 네트워크 공유까지, 첫 연결 절차에 담기 어려운 세부 내용을 정리했습니다. 설정을 바꾸기 전에 영향을 받는 범위가 현재 앱인지, 기기 전체인지, 로컬 네트워크 전체인지 확인하세요.
지원 플랫폼, 코어 계열, 구독 및 라우팅 기능, 사용 난이도 네 가지 기준으로 세 클라이언트를 비교하고 데스크톱과 안드로이드 환경에 맞는 선택 방법을 안내합니다. 기기와 설정 요구 사항을 먼저 확인한 뒤 클라이언트를 바꿀 필요가 있는지 판단하세요.
클라이언트 비교 가이드 읽기 →로컬 네트워크 연결 허용 설정 위치와 포트의 의미, 방화벽 허용 방법, 다른 기기에 프록시를 입력하는 절차를 설명합니다. 공유하기 전에 신뢰할 수 있는 네트워크로 범위를 제한하고 로컬 수신 포트와 서버 포트를 구분하세요.
설정 노트 읽기 →VMess와 VLESS의 암호화 방식, 시간 검증, 전송 조합 차이를 비교해 구독의 프로토콜 항목을 이해할 수 있도록 설명합니다. 프로토콜 이름은 설정의 일부일 뿐이며 서버 매개변수, 전송 계층, 코어 지원 여부도 함께 맞아야 합니다.
프로토콜 해설 읽기 →