CONFIGURATION / 설정 바로가기
구독, 트래픽 유입 경로, 아웃바운드 규칙을 먼저 구분한 뒤 세부 설정을 조정하세요. 오른쪽에서 설정 항목을 선택하면 왼쪽 예시 화면에 해당 위치가 표시됩니다. 예시는 설정 간 관계를 설명하며, 실제 메뉴는 사용 중인 클라이언트 화면을 기준으로 확인하세요.
화면 예시이며 현재 연결 상태를 나타내지 않습니다. 먼저 구독을 가져온 뒤 프록시와 라우팅을 확인하세요.
구독 주소를 사용하면 노드 설정을 한곳에서 가져올 수 있고, 그룹을 나누면 출처별로 관리할 수 있습니다. v2rayN에서 구독 그룹을 추가하고 이름과 주소를 입력한 뒤 저장하세요. 해당 그룹을 업데이트한 다음 목록에서 사용할 노드를 선택하면 됩니다. v2rayNG에서도 먼저 구독을 추가한 뒤 업데이트하세요. 기존 그룹 업데이트와 같은 주소를 새로 추가하는 작업은 다릅니다. 노드가 중복으로 보이면 먼저 그룹 출처를 확인하세요. 구독 링크에 접속 정보가 포함될 수 있으므로 공개 스크린샷이나 낯선 변환 사이트에 올리지 마세요. 그래픽 클라이언트가 설정을 읽어올 뿐, 링크 자체가 연결 성공을 의미하지는 않습니다.
자세히 보기시스템 프록시는 앱이 연결을 로컬 클라이언트로 전달할지 결정하고, 라우팅 모드는 전달된 연결의 아웃바운드를 선택합니다. 두 기능은 서로 다릅니다. 데스크톱에서는 먼저 ‘시스템 프록시 자동 설정’을 선택한 뒤 브라우저로 확인하세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제해야 앱이 종료된 로컬 포트를 계속 가리키는 일을 막을 수 있습니다. 일부 터미널 도구와 자체 프록시 설정이 있는 앱은 시스템 설정을 따르지 않으므로 별도로 설정해야 합니다. 브라우저는 되지만 명령줄에서 실패한다면 노드를 바꾸거나 모든 트래픽을 우회하기 전에 트래픽 유입 경로부터 확인하세요.
자세히 보기라우팅 분기는 도메인, 대상 주소 등의 조건으로 연결을 구분한 뒤 프록시, 직접 연결 또는 차단으로 보냅니다. 처음에는 ‘중국 본토 우회’ 같은 클라이언트 기본 규칙을 사용하고, 로그를 확인해 필요한 규칙만 추가하세요. 규칙은 일반적으로 위에서 아래로 적용되므로 특정 도메인 예외는 범위가 넓은 규칙보다 앞에 두어야 합니다. 도메인 정책과 DNS 조회 결과에 따라 주소 매칭이 달라질 수 있으므로 규칙 이름만으로 트래픽 경로를 판단하지 마세요. 단일 프록시 스위치와 달리 라우팅 분기에서는 트래픽 유입 경로, 매칭 조건, 아웃바운드 태그를 함께 이해해야 합니다. 설정을 바꾼 뒤에는 항목별로 확인하세요.
자세히 보기TUN 모드는 가상 네트워크 인터페이스로 트래픽을 처리하므로 시스템 프록시를 따르지 않는 앱에 유용합니다. 다만 적용 범위는 라우팅, 권한, 앱 제외 설정에 따라 달라집니다. 먼저 일반 프록시 연결이 정상인지 확인한 뒤 TUN을 켜고 화면 안내에 따라 필요한 권한을 허용하세요. 다른 네트워크 도구와 함께 실행한다면 기본 경로, DNS 처리, 가상 네트워크 어댑터가 충돌하는지 확인해야 합니다. TUN을 켜도 모든 연결이 프록시를 거치는 것은 아니며, 라우팅 규칙에 따라 직접 연결될 수 있습니다. 문제를 확인할 때는 TUN을 끄고 결과를 비교하세요. 로컬 네트워크 접속을 유지하고 기존 네트워크 설정을 기록해 두면 복구하기 쉽습니다.
자세히 보기클라이언트는 그래픽 인터페이스를 제공하고 커널은 연결과 라우팅을 처리합니다. 특정 링크를 가져올 수 있다고 해서 현재 커널이 모든 매개변수를 지원하는 것은 아닙니다. v2rayNG는 Xray 커널을 사용하며, v2flyNG는 V2Fly 커널 계열의 Android 대안입니다. v2rayN의 지원 기능은 선택한 커널을 기준으로 확인해야 합니다. VMess, VLESS, Trojan은 프로토콜 이름이고 REALITY는 보안 계층 관련 설정이므로 같은 계층의 항목처럼 서로 바꿔 쓸 수 없습니다. 지원되지 않는 필드나 실행 오류가 발생하면 먼저 노드에 필요한 프로토콜, 전송 방식, 보안 계층의 조합을 확인한 뒤 커널 출력을 살펴보세요.
자세히 보기CLIENTS / 플랫폼 선택
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. 설치 파일은 운영체제, 프로세서 아키텍처, 패키지 형식에 맞춰야 합니다. 모바일 노드 설정, 데스크톱 설치 파일, 커널 파일은 서로 다른 종류의 파일입니다.
v2rayN · 데스크톱 버전 / 클래식 WPF 버전
데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하고, 클래식 WPF 버전은 익숙한 조작 방식을 유지합니다. 처음 설치할 때는 시스템 및 프로세서 요구 사항을 확인한 뒤 인터페이스 버전을 선택하세요. 두 클라이언트를 동시에 실행하면 같은 로컬 포트를 사용해 충돌할 수 있습니다.
시스템 프록시를 사용하면 브라우저는 대개 시스템 설정을 따르지만 터미널이나 일부 개발 도구는 프록시를 별도로 지정해야 할 수 있습니다. 클라이언트를 종료한 뒤에도 웹페이지에 접속할 수 없다면 재설치하기 전에 시스템 프록시가 해제되었는지 확인하세요.
다운로드 페이지로 이동v2rayN · Apple Silicon / Intel
시스템의 ‘이 Mac에 관하여’에서 칩 종류를 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당합니다. 다운로드 페이지에서 각각의 파일을 선택할 수 있습니다. 설치한 뒤 클라이언트를 실행하고 시스템 안내에 따라 앱 실행 권한을 설정하세요.
시스템 프록시와 TUN은 필요한 권한이 다릅니다. 처음에는 시스템 프록시로 연결을 확인하고, 연결할 수 없는 앱이 있을 때 TUN을 고려하세요. 유선·무선 네트워크나 다른 네트워크 도구로 전환한 뒤에는 구독을 다시 가져오기보다 프록시 상태와 라우팅을 확인하는 편이 효과적입니다.
다운로드 페이지로 이동v2rayNG 우선 · v2flyNG 대안
v2rayNG는 Xray 커널을 사용하며 구독으로 노드를 관리할 수 있습니다. v2flyNG는 V2Fly 커널 계열의 대안입니다. 비교적 최신 기기라면 arm64 설치 파일을 먼저 확인하고, 아키텍처를 모르겠다면 범용 버전 안내를 살펴보세요.
가져온 노드를 선택해 연결을 시작하고 시스템 VPN 권한 안내를 확인하세요. 연결 아이콘이 표시되어도 서비스가 시작되었다는 뜻일 뿐, 모든 대상에 접속할 수 있다는 의미는 아닙니다. 노드, DNS, 라우팅도 확인해야 합니다. 백그라운드에서 연결이 끊기면 배터리 제한을 확인하고, 권한 문제를 해결하기 위해 구독을 반복해서 추가하지 마세요.
다운로드 페이지로 이동v2rayN · deb / rpm
배포판의 패키지 체계에 따라 deb 또는 rpm을 선택한 뒤 x64와 arm64 아키텍처를 확인하세요. 여기서는 그래픽 클라이언트의 일반적인 설정을 다룹니다. 데스크톱 실행 방식과 시스템 서비스 방식을 함께 사용하면 프로세스와 포트가 중복될 수 있으니 주의하세요.
데스크톱 환경의 프록시 설정이 모든 앱에 적용되는 것은 아닙니다. 터미널, 패키지 관리자, 브라우저에서 각각 연결을 확인하세요. TUN을 사용할 때는 네트워크 권한과 라우팅도 고려해야 합니다. 문제가 생기면 기존 네트워크 설정을 보존하고 시스템 프록시로 기본 연결을 확인한 뒤 트래픽 처리 범위를 단계적으로 넓히세요.
다운로드 페이지로 이동QUICK START / 설정 순서
한 번에 한 단계씩만 바꾸세요. 먼저 클라이언트에 사용할 설정을 가져오고, 다음으로 연결할 앱을 정한 뒤 규칙이 예상대로 작동하는지 확인합니다. 아래 세 단계는 처음 설정할 때뿐 아니라 기기를 바꾼 뒤 기본 환경을 다시 구성할 때도 유용합니다.
클라이언트를 설치하고 실행한 뒤 기존 구독 주소를 준비하세요. v2rayN에서는 구독 그룹 설정에서 새 그룹을 추가하고 알아보기 쉬운 이름과 주소를 입력한 뒤 저장하고 업데이트합니다. v2rayNG에서는 구독 메뉴에서 주소를 추가한 다음 해당 구독을 업데이트하세요. 이름은 로컬에서 구분하기 위한 것으로 전체 주소를 대신할 수 없습니다. 예시 https://example.com/sub?token=xxxx는 실제로 사용할 수 있는 구독 주소가 아니므로 그대로 입력하지 마세요.
업데이트 후 노드 목록에 프로토콜, 주소, 포트 등의 정보가 표시되는지 확인하세요. 목록이 비어 있다면 업데이트 결과를 살펴보고 주소가 온전한지, 만료되지 않았는지, 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인하세요. 같은 주소를 계속 새로 추가하면 중복 그룹만 생깁니다. 구독에 개인 접속 정보가 포함되어 있다면 스크린샷을 공유하기 전에 전체 링크를 가리세요. 클라이언트 설치와 구독 서비스는 별개의 과정이며, 소프트웨어를 설치해도 사용할 노드가 자동으로 만들어지지는 않습니다.
가져온 목록에서 노드를 선택한 뒤 앱의 트래픽을 클라이언트로 전달하는 방법을 설정하세요. 데스크톱에서는 ‘시스템 프록시 자동 설정’부터 시작하고, Android에서는 연결을 시작할 때 시스템 안내에 따라 VPN 서비스를 허용하세요. 그런 다음 기존 라우팅 방식을 선택하고 직접 연결, 프록시, 차단의 차이를 먼저 이해하세요. 처음부터 DNS, 사용자 지정 규칙, TUN을 모두 바꿀 필요는 없습니다. 메뉴 이름은 인터페이스 버전에 따라 다를 수 있지만 ‘노드 선택, 트래픽 연결, 아웃바운드 결정’의 순서는 같습니다.
시스템 프록시가 모든 프로그램의 트래픽을 처리하는 것은 아닙니다. 브라우저 확장 프로그램, 개발 도구의 별도 프록시 설정, 터미널 환경 변수는 시스템 설정을 덮어쓰거나 우회할 수 있습니다. 특정 앱에서만 문제가 발생한다면 먼저 해당 앱의 트래픽 유입 경로를 확인하세요. 시스템 프록시를 따르지 않는 프로그램을 처리해야 할 때 TUN 안내를 읽고 권한을 확인하세요. 전체 라우팅과 TUN도 같은 뜻이 아닙니다. 전자는 아웃바운드 선택에 영향을 주고, 후자는 주로 트래픽을 클라이언트로 전달하는 방식에 관여합니다.
연결을 시작한 뒤 접속하려는 대상을 열고 클라이언트 연결 기록에 해당 요청이 나타나는지 확인하세요. 이어서 직접 연결되어야 하는 대상에도 접속해 라우팅 결과를 살펴보세요. 로컬 네트워크 기기를 사용하는 경우 로컬 주소에 계속 접속할 수 있는지도 확인해야 합니다. 연결 성공, 구독 업데이트 성공, 웹페이지 접속 가능은 서로 다른 결과이므로 혼동하지 마세요. 한 번에 테스트할 때는 노드와 규칙을 그대로 유지해 여러 변수가 동시에 바뀌지 않도록 하세요.
실패하면 커널 실행 여부, 로컬 수신 포트 사용 가능 여부, 요청의 클라이언트 유입 여부, 마지막으로 적용된 아웃바운드 순서로 확인하세요. 시간 초과는 원격 연결 단계에서 발생할 수 있고, 도메인 조회 실패라면 DNS를 먼저 살펴봐야 합니다. 커널이 바로 종료된다면 시작 로그부터 확인하세요. 오류 정보를 기록하거나 공유할 때는 구독 정보, 인증 필드, 개인 주소를 가리세요. 확인을 마친 뒤 라우팅 예외를 하나씩 추가하고 복구 가능한 설정을 저장하면 이후 업데이트에도 같은 순서로 문제를 찾을 수 있습니다.
PROJECT V / 오픈 소스 생태계
그래픽 클라이언트, 연결 커널, 노드 프로토콜은 서로 다른 계층에 속합니다. 이들의 관계를 알면 인터페이스, 커널, 원격 설정 중 무엇을 업데이트해야 하는지 판단할 수 있습니다.
생태계 관계 · 실행 상태 아님
오픈 소스 네트워크 도구 생태계
클라이언트가 설정을 관리하고 커널이 연결을 처리합니다. 지원 범위는 실제로 선택한 커널과 매개변수 조합에 따라 달라집니다.
프로젝트 소개 보기 →Project V는 네트워크 프록시 도구와 관련 구성 요소를 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 널리 사용되는 핵심 프로젝트입니다. V2Fly는 V2Ray 계열을 이어 커뮤니티에서 관리하고, Xray는 관련 코드를 바탕으로 발전한 별도의 커널 계열입니다. 일부 개념과 설정 방식은 공유하지만 지원 기능과 매개변수는 완전히 같지 않습니다. 오래된 가이드를 참고할 때는 어떤 커널을 다루는지 먼저 확인하세요. ‘V2Ray’라는 통칭만으로 모든 설정을 그대로 적용하면 안 됩니다.
노드를 사용할 수 있는지는 클라이언트가 설정을 올바르게 생성하는지, 커널이 해당 필드를 이해하는지, 원격 서비스가 같은 프로토콜 조합으로 실행되는지에 달려 있습니다. 링크 가져오기에 성공해도 설정 분석 단계 일부만 확인된 것입니다. REALITY, 보안 계층, 전송 설정 오류가 발생하면 커널 지원 여부와 원격 매개변수를 먼저 확인하세요. 인터페이스 테마를 바꾸거나 구독을 반복해서 새로 고쳐도 프로토콜 계층의 불일치는 대개 해결되지 않습니다.
v2rayN은 데스크톱용으로 노드 목록, 구독 그룹, 시스템 프록시, 라우팅 등을 관리합니다. 데스크톱에서는 v2rayN부터 살펴보세요. v2rayNG는 Android용이며 Xray 커널을 사용해 노드 가져오기와 연결 관리를 지원합니다. v2flyNG도 Android용으로 V2Fly 커널 계열의 대안입니다. 세 앱을 모두 설치할 필요는 없으며, 기기와 노드 요구 사항에 맞춰 선택하세요.
클라이언트 이름이 비슷해도 메뉴, 권한, 백업 형식까지 같은 것은 아닙니다. 기기를 옮길 때는 구독 출처를 계속 사용할 수 있는지 확인한 뒤 클라이언트 설정을 다시 구성하세요. 라우팅 예외, 앱 제외, DNS 옵션도 각각 확인해야 합니다. 데스크톱과 Android는 트래픽 유입 방식이 다르므로 시스템 프록시 설정 절차를 모바일에 그대로 적용할 수 없습니다. 이 사이트에서는 다운로드 선택과 설정 가이드를 나누어 각 단계에 맞는 안내를 찾기 쉽게 제공합니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트로, 공개된 코드를 커뮤니티가 검토하고 논의하며 개선할 수 있습니다. 오픈 소스 라이선스는 코드의 사용, 수정, 배포 조건을 정합니다. 프로젝트와 포함된 구성 요소마다 라이선스가 다를 수 있으므로 재배포할 때는 각 라이선스 고지를 확인하세요. 오픈 소스는 소프트웨어 협업 방식을 뜻할 뿐, 노드 서비스의 품질이나 데이터 처리 방식을 보장하지 않으며 구독 출처에 대한 판단을 대신하지 않습니다.
클라이언트는 로컬 설정과 연결을 담당하고, 구독 출처는 노드 매개변수를 제공하며, 원격 서비스는 실제 트래픽을 전달합니다. 각 구성 요소의 관리 주체와 업데이트 주기는 다를 수 있습니다. 문제를 공유할 때는 ‘소프트웨어가 실행되지 않음’, ‘구독을 업데이트할 수 없음’, ‘특정 노드에 연결할 수 없음’을 구분해야 원인을 찾기 쉽습니다. 이 사이트는 선택 및 설정 문서를 제공하며 구독 주소는 제공하지 않습니다. 가이드를 따라 설정할 때는 사용 권한이 있는 기존 구성을 이용하고 거주 지역의 관련 규정을 준수하세요.
구독 업데이트는 그룹 내 노드 설정을 바꾸고, 클라이언트 업데이트는 인터페이스와 통합 기능을 바꾸며, 커널 업데이트는 프로토콜 지원과 설정 필드에 영향을 줄 수 있습니다. 세 가지 업데이트를 한 번의 작업처럼 취급하지 마세요. 평소에는 복구할 수 있는 설정을 저장하고 업데이트 내용을 확인한 뒤 사용 중인 커널, 라우팅 리소스, 기존 노드의 호환성을 살펴보세요. 중요한 설정을 바꾼 뒤에는 ‘요청이 클라이언트로 들어오는지, 예상한 규칙이 적용되는지, 대상에 실제로 접속할 수 있는지’를 다시 확인하세요.
장기간 사용할 때는 만료된 그룹과 중복 노드를 정리하고 사용자 지정 규칙의 용도를 기록해 두세요. 문제를 찾기 위해 로그 상세 수준을 일시적으로 높일 수 있지만, 접속 대상이나 인증 정보가 포함된 로그를 공개해서는 안 됩니다. 업데이트 후 문제가 생기면 시작 로그와 설정 차이를 먼저 확인하고 여러 네트워크 옵션을 동시에 바꾸지 마세요. 기본 개념, 설치, 구독, 라우팅 분기, TUN, 유지 관리까지 이어지는 절차는 전체 설명서에서 주제별로 확인할 수 있습니다.
처음부터 익히는 전체 설명서 보기 →READING / 설정 및 문제 해결
기본 연결을 마친 뒤 실제 문제에 맞춰 더 자세히 살펴보세요. 아래 세 글에서는 사용자 지정 규칙, 시스템 프록시 유입 경로, 로그 분석을 차례로 다룹니다. ‘연결된다’에서 한 걸음 더 나아가 각 연결이 어디로 향하는지 파악하는 데 도움이 됩니다.
domain의 full/domain/keyword/regexp 접두어, ip 및 geoip 작성법, geosite 분류 참조 방법을 설명하고 규칙의 위에서 아래로 적용되는 순서와 domainStrategy의 영향을 살펴봅니다.
라우팅 규칙 문법 보기 →시스템 프록시를 켰는데도 웹페이지나 명령줄이 직접 연결되나요? 브라우저 확장 프로그램 및 시스템 설정, 터미널 http_proxy 환경 변수를 나누어 점검하고 플랫폼별 프록시 상태 확인 방법을 안내합니다.
프록시 유입 경로 확인 →loglevel별 용도를 설명하고 연결 시간 초과, 핸드셰이크 실패, DNS 조회 실패 등 자주 나타나는 로그를 하나씩 풀이합니다. 로그를 바탕으로 문제 발생 단계를 찾는 방법도 안내합니다.
로그 설명 보기 →