설정 항목 / CLIENT CONTROLS
앱 연결 경로, 코어의 처리 과정, 원격 연결을 구분해 살펴보세요. 구독 관리는 서버 정보를 정리하고, 시스템 프록시는 앱 트래픽을 클라이언트로 전달하며, 라우팅 규칙은 트래픽의 출구를 선택합니다. 각 항목을 따로 점검해야 연결 문제의 원인을 찾기 쉽습니다.
구독 주소는 여러 서버 설정을 한꺼번에 가져오는 데 사용하며, 개별 서버의 공유 링크와는 다릅니다. 구독 그룹 메뉴에서 새 그룹을 만들고 이름과 주소를 입력한 뒤 저장하고 업데이트하세요. 그런 다음 해당 그룹에서 서버 목록을 확인합니다. 구독을 이용하면 주소, 포트, 전송 설정을 한꺼번에 동기화할 수 있어 항목을 하나씩 입력하는 것보다 편리합니다. 업데이트에 실패하면 먼저 주소가 유효한지 확인하고, 업데이트 요청에 직접 연결과 프록시 중 어떤 방식이 사용되는지 살펴보세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 신뢰할 수 있는 곳에 보관하세요. 화면을 다른 사람에게 보여줄 때는 주소 전체를 가리고, 접속 정보가 드러난 스크린샷도 공유하지 마세요.
구독 그룹 → 구독 그룹 설정
그룹 추가 → 구독 주소 입력 → 저장
구독 업데이트 → 서버 목록 확인라우팅 분할은 트래픽이 코어에 들어온 뒤 적용되며, 도메인·대상 IP·포트를 기준으로 직접 연결이나 프록시 같은 출구를 선택할 수 있습니다. 먼저 클라이언트의 기본 설정을 사용하고 실제 접속 요구에 맞춰 규칙을 추가하세요. 처음부터 사용자 지정 항목을 많이 넣는 것보다 문제를 찾기 쉽습니다. 규칙은 보통 순서대로 적용되므로 구체적인 조건을 포괄적인 조건보다 앞에 두세요. 도메인 전략이 IPIfNonMatch이면 도메인 규칙이 일치하지 않을 때 IP를 조회해 추가로 매칭합니다. 모든 요청에서 IP 조회를 강제하는 설정은 아닙니다. 아래는 규칙 필드 예시이며, 출구 이름은 실제 설정과 일치해야 합니다.
{
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}시스템 프록시 자동 설정은 운영체제에서 제공하는 프록시 설정을 변경합니다. 이 설정을 따르는 앱만 요청을 클라이언트에 전달합니다. 라우팅의 전역 또는 중국 본토 우회 설정과는 다른 항목입니다. 시스템 프록시는 트래픽이 클라이언트로 들어올지를 결정하고, 라우팅은 들어온 트래픽을 어떻게 전달할지 정합니다. 브라우저는 접속되는데 다른 프로그램에서 실패한다면 해당 프로그램이 시스템 프록시를 읽는지, 별도의 프록시 설정이 있는지 확인하세요. 프록시를 직접 입력할 때는 프로토콜, 로컬 주소, 실제 수신 포트를 확인하고 다른 가이드의 포트를 그대로 사용하지 마세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제해야 사용 중지된 설정이 남지 않습니다.
시스템 프록시: 시스템 프록시 자동 설정
로컬 주소: 127.0.0.1
포트: 매개변수 설정의 수신 포트 기준
라우팅: 필요한 규칙을 별도로 선택TUN 모드는 가상 네트워크 인터페이스를 통해 트래픽을 연결하므로 일반 시스템 프록시를 사용할 수 없는 앱에 적합합니다. 개별 앱의 프록시 설정을 바꾸는 것과 달리 시스템 라우팅, 권한, DNS에 영향을 줍니다. 처음 활성화하기 전에 시스템 프록시로 서버 연결이 가능한지 먼저 확인하세요. 데스크톱 환경에 따라 권한을 높여야 할 수 있으며, 실제 동작은 클라이언트·코어·운영체제에 따라 다릅니다. 활성화 후 도메인이 열리지 않거나 로컬 네트워크 기기에 연결할 수 없다면 DNS와 직접 연결 규칙을 각각 확인하고, 네트워크 라우팅을 변경하는 다른 프로그램은 잠시 비활성화하세요. 원인을 파악하기 어려워지지 않도록 서버와 라우팅 설정을 한꺼번에 바꾸지 마세요.
먼저 확인: 시스템 프록시로 대상 사이트에 접속할 수 있는지 확인
그다음 활성화: TUN 모드와 필요한 시스템 권한
마지막 점검: DNS, 로컬 네트워크 접속, 라우팅 규칙GUI 클라이언트는 설정을 편집하고 관리하며, 코어는 실제 프로토콜 처리와 연결, 라우팅을 담당합니다. v2rayN은 여러 코어를 관리할 수 있지만 선택 가능한 코어와 설정 위치는 설치된 클라이언트 버전에 따라 다릅니다. 전환하기 전에 서버에서 사용하는 프로토콜, 전송 방식, 보안 매개변수를 확인하세요. 프로토콜 이름만으로 호환 여부를 판단할 수는 없습니다. REALITY나 XTLS Vision이 포함된 설정은 해당 기능의 Xray 요구 사항을 확인해야 합니다. 전환 후 연결을 다시 시작하고 로그를 살펴보세요. 지원하지 않는 필드가 있다면 로컬 수신 포트를 계속 바꾸기보다 코어 또는 설정을 조정해야 합니다.
클라이언트: 설정 편집 및 구독 관리
코어: 프로토콜 처리 및 트래픽 전달
선택 기준: 프로토콜 + 전송 방식 + 보안 매개변수공유 링크는 개별 서버의 연결 매개변수를 텍스트로 인코딩한 것으로, 클라이언트의 클립보드 가져오기 기능으로 추가할 수 있습니다. 링크 전체를 복사하고 채팅 문구, 따옴표, 줄바꿈이 섞이지 않도록 확인한 뒤 가져오기를 실행하세요. 유형, 주소, 포트, 전송 계층 보안 설정도 점검해야 합니다. 구독과 달리 공유 링크는 이후 그룹 업데이트에 반영되지 않는 경우가 많아 서버 설정이 바뀌면 다시 가져와야 합니다. VMess, VLESS, Trojan, Shadowsocks는 공유 형식이 서로 다르며, 일부 확장 필드는 코어의 지원 범위에 따라 달라집니다. 가져오기가 성공했다는 것은 형식이 해석되었다는 뜻일 뿐입니다. 설정이 실제로 작동하는지 확인하려면 연결 테스트를 진행하세요.
vmess://
vless://
trojan://
ss://처음 설정할 때는 작동하는 서버 하나와 기본 라우팅 설정 하나만 사용하세요. 브라우저에서 실제 요청이 성공한 다음 라우팅 분할, DNS, TUN을 조정하면 됩니다. 설정은 한 번에 하나씩만 바꾸고 변경 전 값을 기록하세요. 문제가 생겨도 검증된 상태로 쉽게 되돌릴 수 있습니다.
지연 시간 테스트, 실제 연결 테스트, 다운로드 속도 테스트는 서로 다른 항목을 측정합니다. 지연 시간 숫자 하나만으로 대상 사이트, 도메인 조회, 앱 프록시 설정이 모두 정상이라고 판단할 수 없습니다. 서버를 비교할 때는 동일한 방식으로 테스트하고 실제 접속 결과도 함께 확인하세요. 서로 다른 테스트 결과를 섞어 순위를 비교하지 마세요.
클라이언트 선택 / PLATFORMS
데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요한 경우 v2flyNG를 고려하면 됩니다. 먼저 기기 아키텍처와 설치 파일 형식을 확인한 뒤 해당 다운로드 항목을 선택하세요. 버전 정보는 다운로드 페이지의 클라이언트 카드에서 확인할 수 있습니다.
데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, 클래식 WPF 버전은 익숙한 조작 방식을 유지합니다. 처음 설치한다면 데스크톱 버전을 선택하고, 기존 클래식 설정을 사용하는 경우에는 인터페이스와 호환성 요구에 따라 선택하세요. 어느 인터페이스든 먼저 구독을 가져온 다음 시스템 프록시와 라우팅을 설정해야 합니다.
설치 전에 시스템 아키텍처와 실행 요구 사항을 확인하세요. 프로그램과 설정을 별도 디렉터리에 보관하고 임시 폴더에서 실행하지 마세요. 인터페이스를 바꾸거나 프로그램을 업데이트하기 전에 클라이언트에서 필요한 설정을 내보내고, 로컬 포트를 다른 프로그램이 사용하고 있지 않은지 확인하세요.
다운로드 페이지로 이동시스템의 '이 Mac에 관하여'에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택하면 됩니다. 아키텍처 선택은 프로그램이 정상 실행되는지를 좌우하며, 구독에서 VMess와 VLESS 중 무엇을 사용하는지 또는 서버가 어디에 있는지와는 관계가 없습니다.
처음 실행할 때는 시스템 안내에 따라 앱 권한을 설정하세요. 먼저 일반 프록시 연결을 확인한 뒤 추가 권한이 필요한 네트워크 기능을 활성화하세요. 실행되지 않으면 설치 파일 형식과 칩 아키텍처가 맞는지 먼저 확인하고 권한 문제를 점검하세요. 실행 문제를 구독 오류로 혼동하지 않도록 주의해야 합니다.
다운로드 페이지로 이동v2rayNG는 Xray 코어를 사용하므로 Android에서 우선 선택할 수 있습니다. v2flyNG는 V2Fly 코어를 사용하며 호환성 요구가 있을 때 대안으로 고려하세요. 대부분의 arm64 기기는 해당 설치 파일을 선택하면 됩니다. 아키텍처를 모르겠다면 다운로드 페이지의 범용 버전 안내를 확인하고, 휴대폰 브랜드만으로 판단하지 마세요.
가져온 서버를 선택하고 연결을 시작할 때 시스템 안내에 따라 VPN 연결을 허용하세요. 연결을 계속 유지하려면 배터리 최적화와 백그라운드 제한 설정도 확인해야 합니다. 백그라운드로 전환한 뒤 연결이 끊기면 시스템의 백그라운드 실행 설정을 살펴보고 다른 앱이 같은 VPN 연결을 사용 중인지 확인하세요.
다운로드 페이지로 이동배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 arm64를 구분하세요. GUI 클라이언트는 데스크톱 환경에서 사용할 수 있습니다. 설치 후에도 데스크톱 세션의 프록시 설정을 확인해야 합니다. 앱이 시스템 프록시를 사용하는지는 앱의 구현 방식과 실행 환경에 따라 다릅니다.
그래픽 소프트웨어 설치 도구를 사용해 패키지와 의존성을 관리하는 것이 좋습니다. TUN을 사용하기 전에 시스템 권한과 현재 네트워크 관리 도구를 확인해 여러 설정이 동시에 트래픽을 제어하지 않도록 하세요. 일반 프록시는 작동하지만 TUN이 실패한다면 구독을 바꾸기보다 로컬 권한과 라우팅부터 확인하세요.
다운로드 페이지로 이동첫 설정 / QUICK START
클라이언트와 서버 설정은 별개입니다. 프로그램 설치는 로컬 도구를 준비하는 단계일 뿐이며, 연결하려면 유효한 서버 정보가 필요합니다. 구독이 있다면 아래 순서대로 진행하세요. 단일 공유 링크만 있다면 클립보드에서 가져온 뒤 두 번째 단계로 이동하면 됩니다.
구독 그룹 설정을 열어 새 그룹을 만들고 전체 주소를 붙여넣으세요. 저장한 뒤 업데이트를 실행합니다. 목록에 서버가 표시되는지 확인하고 유형, 포트, 보안 설정이 올바르게 해석되었는지 살펴보세요. 구독 주소는 설정을 가져오는 데 사용하며 서버 주소 입력란에 직접 넣는 값이 아닙니다. 웹페이지에서 복사할 때 앞뒤 공백이나 잘린 내용이 없는지도 확인하세요.
업데이트에 실패하면 주소에 접속할 수 없는지, 접속 정보가 만료되었는지, 클라이언트가 응답 내용을 해석하지 못하는지 먼저 확인하세요. 기존 설정은 보존하고 그룹을 연달아 삭제하며 재시도하지 마세요. 구독 변환을 이용하면 변환 서비스가 원본 설정에 접근할 수 있으므로 형식 변환이 꼭 필요할 때만 신뢰할 수 있는 서비스를 사용하세요.
서버 목록에서 사용할 서버를 선택하세요. 데스크톱에서는 시스템 프록시 자동 설정을 켠 뒤 사용 목적에 맞는 라우팅 프리셋을 선택합니다. Android에서는 연결을 시작하고 시스템 권한을 허용하세요. 시스템 프록시와 전역 라우팅은 서로 다른 계층의 설정입니다. 전역을 선택해도 모든 앱이 자동으로 로컬 프록시를 사용하게 되는 것은 아닙니다.
처음 사용할 때는 다른 매개변수를 그대로 두세요. 로컬 네트워크 공유가 필요할 때만 수신 주소와 접근 제어를 조정하고, 이 기기에서만 사용할 경우 로컬 수신 설정을 유지하세요. 여러 네트워크 제어 기능을 동시에 켜지 말고 반복해서 확인할 수 있는 기본 연결부터 만드세요.
실제 연결을 테스트한 뒤 대상 앱에서 접속이 필요한 웹사이트를 여세요. 도메인 조회, 연결 수립, 앱의 프록시 경로를 각각 확인합니다. 지연 시간 테스트는 성공했지만 웹페이지가 열리지 않는다면 측정만 반복하지 말고 TLS 매개변수 오류, DNS 문제, 앱이 시스템 프록시를 우회하는지 확인하세요.
추가 점검이 필요하면 테스트 시간, 선택한 서버, 오류 요약을 기록하세요. 로그를 공유하기 전에 구독 주소, 사용자 식별 정보, 인증 정보를 삭제해야 합니다. 연결이 복구된 뒤 라우팅 규칙을 하나씩 추가하세요. 평소 클라이언트를 종료하기 전에는 시스템 프록시를 해제해 앱이 종료된 수신 포트로 계속 연결되지 않도록 하세요.
코어 및 클라이언트 / OPEN SOURCE
V2Ray는 특정한 하나의 화면을 가진 앱 이름이 아닙니다. 프로젝트, 코어, GUI 클라이언트의 역할을 이해하면 패키지 선택, 가져오기, 업데이트 과정에서 혼동을 줄이고 설정을 클라이언트에서 바꿀지 서버 측 지원이 필요한지 판단하는 데 도움이 됩니다.
Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 그 주요 프로젝트 중 하나입니다. V2Fly 커뮤니티는 V2Ray의 개발과 유지 관리를 이어가고, Xray는 관련 기술을 바탕으로 독자적인 코어 개발 경로를 발전시켜 왔습니다. 두 프로젝트는 공통된 배경이 있지만 프로토콜 확장, 설정 필드, 기능 발전 방향이 완전히 같지는 않습니다. 이름이 비슷하다고 모든 설정을 서로 바꿔 쓸 수 있는 것은 아닙니다.
VMess, VLESS, Trojan, Shadowsocks는 프로토콜 선택에 해당하고, REALITY는 보안 방식이며, XTLS Vision은 특정 흐름 제어와 전달 처리에 관련됩니다. 서버 설정에는 프로토콜, 전송 방식, 보안, 흐름 제어 필드가 함께 포함되는 경우가 많습니다. 사용 가능 여부를 판단하려면 프로토콜 이름 하나만 볼 것이 아니라 전체 매개변수와 코어의 지원 범위를 확인해야 합니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 GUI 클라이언트입니다. 클라이언트에서 서버 목록, 구독 업데이트, 설정 편집, 실행을 관리하면 코어가 생성된 설정을 읽어 연결을 처리합니다. 데스크톱에서는 v2rayN을 선택하고 Android에서는 Xray 또는 V2Fly 호환성 요구에 따라 클라이언트를 고르세요. 이름에 등급 차이가 있다고 생각하기보다 필요한 기능과 기기 환경을 기준으로 선택해야 합니다.
오픈 소스란 프로젝트 라이선스에 따라 관련 코드를 열람하고 사용하거나 수정할 수 있다는 뜻입니다. V2Fly와 Xray 코어는 MPL 2.0을 사용하며 GUI 클라이언트도 각자 라이선스와 배포 조건이 있습니다. 오픈 소스 여부는 구현 방식과 커뮤니티 협업을 이해하는 데 도움이 되지만 구독 출처, 서버 권한, 설정 내용, 기기 환경을 확인하는 일을 대신하지는 않습니다. 클라이언트 자체가 서버 구독을 제공하는 것은 아닙니다.
GUI 업데이트는 구독 해석, 인터페이스 구성, 시스템 호환성에 영향을 줄 수 있고, 코어 업데이트는 프로토콜 동작, 라우팅, 연결 처리와 관련될 수 있습니다. 두 종류의 업데이트가 해결하는 문제는 다릅니다. 새 필드를 인식하지 못한다면 먼저 코어의 지원 여부를 확인하세요. 화면이 열리지 않거나 메뉴 조작에 문제가 있다면 서버 설정을 바꾸기보다 클라이언트의 실행 환경부터 점검하세요.
업데이트 전에 필요한 설정을 내보내고 현재 수신 포트, 라우팅 선택, DNS 설정을 기록하세요. 업데이트가 끝나면 기존 서버와 대상 앱으로 다시 테스트한 뒤 사용자 지정 설정을 하나씩 복원합니다. 연결 동작이 달라졌다면 업데이트 전후에 같은 설정을 사용한 결과를 먼저 비교하세요. 체계적으로 익히려면 전체 매뉴얼에서 핵심 개념, 설치, 구독부터 TUN과 일상 관리까지 순서대로 살펴보세요.
전체 매뉴얼 읽기설정 노트 / RECENT NOTES
자주 묻는 문제를 해당 설정과 연결해 살펴봅니다. 설치 문제는 실행 조건부터, 연결 문제는 접속 경로와 매개변수부터 확인하세요. 클라이언트는 플랫폼과 코어 요구 사항을 기준으로 비교할 수 있습니다. 아래 글은 게시 날짜가 최신인 순서로 정렬되어 있습니다.
초보자가 자주 겪는 구독 업데이트 실패, 지연 시간 테스트 확인법, 시스템 프록시 미작동, 브라우저 접속 오류 등 열 가지 질문에 간결하게 답하고 점검 순서를 안내합니다.
노트 읽기압축 해제 위치, 실행 환경, 첫 실행 권한, 코어 전환, 로컬 포트 설정을 다룹니다. Windows와 macOS에서 v2rayN을 처음 실행할 때 막히기 쉬운 부분을 정리했습니다.
노트 읽기플랫폼, 코어, 구독 관리, 라우팅, TUN 지원의 다섯 가지 기준으로 세 클라이언트를 비교합니다. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG와 v2flyNG 중 선택하는 방법을 안내합니다.
노트 읽기