설정 메뉴 / 자주 쓰는 설정
클라이언트는 설정을 관리하고 커널은 연결을 처리합니다. 구독, 시스템 프록시, 라우팅이 각각 무엇을 제어하는지 먼저 파악한 다음 설정을 변경하면 서로 충돌하는 옵션을 여러 곳에서 수정하는 일을 줄일 수 있습니다. 아래 내용은 데스크톱 클라이언트에서 흔히 볼 수 있는 메뉴를 기준으로 설명합니다. Android 클라이언트는 메뉴 이름이 다를 수 있지만, 가져오기, 설정 선택, 서비스 시작 순서는 같습니다.
구독 주소는 개별 서버 설정이 아니라 클라이언트에서 여러 설정을 가져오는 경로입니다. v2rayN에서 구독 그룹 설정을 열고 그룹 이름과 제공 업체가 안내한 주소를 입력한 뒤 저장하고 구독을 업데이트하세요. 업데이트가 끝나면 현재 그룹을 확인해 사용 가능한 설정이 목록에 표시되는지 살펴보고, 하나를 선택해 활성 서버로 지정합니다. 설정을 하나씩 직접 입력하는 것보다 그룹 업데이트가 여러 설정을 지속적으로 관리하기에 편리합니다. 다만 업데이트 실패가 반드시 노드 문제를 뜻하지는 않습니다. 주소가 만료됐거나 요청 경로에 연결할 수 없는 경우도 있습니다. 구독 주소에 접속 정보가 포함될 수 있으니 스크린샷이나 로그, 공개 게시물에 노출하지 마세요.
구독 그룹 → 구독 그룹 설정 → 추가
메모와 구독 주소 입력 → 저장
구독 그룹 → 구독 업데이트(프록시 사용 안 함)
그룹 선택 → 활성 서버로 지정라우팅 분기는 커널에 전달된 연결을 직접 연결, 프록시 또는 차단 중 어디로 보낼지 결정합니다. 앱 트래픽을 클라이언트로 보내는 기능은 아닙니다. 처음 설정할 때는 '중국 본토 우회' 프리셋을 사용해 기본 접속을 확인한 뒤 사용자 지정 규칙을 추가하세요. 규칙은 일반적으로 위에서 아래로 적용되므로 특정 도메인의 예외 규칙은 포괄적인 분류 규칙보다 위에 두어야 합니다. 앞선 규칙이 먼저 적용되면 아래 규칙은 실행되지 않습니다. 전역 모드만 전환하는 것보다 도메인과 주소를 분류해 설정하면 현지 서비스에 직접 접속하기 편리합니다. 아래는 Xray 라우팅 규칙 예시입니다. 전체 설정의 규칙 배열에 넣고, 해당 데이터 파일과 아웃바운드 태그가 있는지 확인하세요.
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}TUN은 가상 네트워크 인터페이스로 트래픽을 처리하므로 시스템 프록시 설정을 따르지 않는 일부 앱에 적합합니다. TUN과 라우팅 분기는 서로 다른 단계입니다. TUN은 트래픽이 들어오는 경로를 처리하고, 라우팅 분기는 연결이 나가는 경로를 결정합니다. 사용 전에 일반 프록시로 선택한 설정의 연결을 확인한 다음 플랫폼에 필요한 네트워크 또는 관리자 권한을 부여하세요. 활성화 후 모든 접속에 문제가 생기면 구독을 반복해서 업데이트하기보다 다른 가상 네트워크 어댑터, VPN 프로그램, DNS 설정을 먼저 확인하세요. 앱마다 프록시 주소를 직접 입력하는 것보다 TUN의 적용 범위가 넓지만, 로컬 네트워크 접속, 절전 모드에서 복귀할 때의 동작, 종료 후 라우팅 정리도 더 세심하게 살펴야 합니다.
일반 프록시 연결이 정상인지 확인
→ 플랫폼에 필요한 권한 부여
→ 메인 화면:TUN 사용
→ 대상 앱 및 로컬 네트워크 접속 확인그래픽 클라이언트와 프록시 커널은 서로 다른 구성 요소입니다. v2rayN은 설정 관리 인터페이스를 제공하며, 설치 패키지와 버전에 따라 다양한 커널을 지원할 수 있습니다. 프로토콜, 전송 방식, 확장 필드는 실제로 실행되는 커널이 해석합니다. 가져오기에 성공해도 클라이언트가 설정을 인식했다는 뜻일 뿐, 현재 커널이 모든 매개변수를 지원한다는 의미는 아닙니다. 지원하지 않는 필드가 있거나 시작 직후 종료된다면 먼저 로그에서 커널 이름을 확인한 다음 설정 제공 업체의 요구 사항과 대조하세요. 생성된 파일을 직접 수정하기보다 그래픽 인터페이스에서 커널 설정을 변경하면 수정 사항을 유지하기 쉽고, 서버를 바꿀 때 설정이 덮어써지는 문제도 줄일 수 있습니다.
설정 → 기본 설정 → Core 유형 관련 설정
프로토콜에 맞는 커널 확인 → 저장
서비스 재시작 → 로그에서 실제 실행된 커널 확인'시스템 프록시 자동 설정'은 앱에 제공되는 시스템 프록시 설정을 변경하지만 기기의 모든 연결을 처리하지는 않습니다. 브라우저는 대개 이 설정을 따르지만, 일부 프로그램은 로컬 프록시 주소를 직접 입력하거나 TUN을 사용해야 합니다. 처음 사용할 때는 로컬 수신 포트를 확인한 뒤 시스템 프록시를 자동 설정하세요. 종료 후에도 접속 문제가 있으면 로컬 컴퓨터를 가리키는 프록시 설정이 남아 있는지 확인합니다. 라우팅의 '전역 프록시'와 달리 이 옵션은 트래픽을 클라이언트로 보낼지 결정하며, 클라이언트에 들어온 트래픽을 어떻게 전달할지는 제어하지 않습니다. 문제를 해결할 때 두 설정을 따로 확인하면 앱 설정 문제와 서버 연결 문제를 더 빠르게 구분할 수 있습니다.
메인 화면 → 시스템 프록시 → 시스템 프록시 자동 설정
사용을 중지할 때 → 시스템 프록시 해제
앱에 수동으로 설정할 때 → 로컬 수신 주소, 포트, 프록시 유형 확인다운로드 경로 / 운영체제별 패키지 선택
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하고, 기존 V2Fly 설정이 필요한 경우 v2flyNG를 고려하세요. 설치 패키지는 운영체제와 CPU 아키텍처에 모두 맞아야 합니다. 파일을 다운로드할 수 있다고 해서 현재 기기에서 실행된다는 뜻은 아닙니다. 다운로드 센터에서 설치 경로와 아키텍처, 관련 요구 사항을 확인할 수 있으며, 홈페이지에는 특정 버전을 고정해 표시하지 않습니다.
v2rayN · Desktop / WPF
데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며 WPF 버전은 기존 데스크톱 사용 방식을 유지합니다. 처음 설치한다면 데스크톱 버전의 다운로드 경로를 먼저 확인하세요. 기존 사용 방식이 익숙하다면 필요에 따라 WPF 버전을 선택할 수 있습니다. 어느 인터페이스든 유효한 설정을 먼저 가져와야 하며, 설치만으로 서버가 자동 생성되지는 않습니다.
다운로드 전에 시스템 설정에서 CPU 아키텍처와 시스템 요구 사항을 확인하세요. 처음 실행할 때는 기본 수신 설정을 유지하고, 연결을 확인하기도 전에 포트, 커널, 라우팅을 한꺼번에 바꾸지 마세요. TUN을 사용하려면 실행 권한을 별도로 확인하세요.
다운로드 페이지로 이동v2rayN · Apple Silicon / Intel
'이 Mac에 관하여'를 열어 칩 또는 프로세서 항목을 확인하세요. Apple Silicon 기기라면 해당 아키텍처용 패키지를, Intel 기기라면 Intel용 패키지를 선택하세요. 기기 외관이나 구입 연도만으로 판단하지 마세요. 다운로드 센터에는 두 가지 설치 경로가 나란히 표시되어 있어 기기 정보에 맞게 선택할 수 있습니다.
처음 실행할 때 앱과 네트워크 권한 요청에 유의하세요. 먼저 클라이언트가 실행되고 구독을 가져올 수 있는지 확인한 다음 시스템 프록시를 설정하세요. 다른 네트워크 도구가 트래픽을 처리 중이라면 라우팅과 DNS 설정이 서로 영향을 주지 않도록 하나를 잠시 중지하세요.
다운로드 페이지로 이동v2rayNG 우선 · v2flyNG 대안
v2rayNG는 Xray 커널을, v2flyNG는 V2Fly 커널을 사용합니다. 먼저 설정 요구 사항에 맞는 클라이언트를 선택한 다음 arm64 또는 범용 설치 패키지를 고르세요. 최신 기기는 대체로 arm64를 사용합니다. 아키텍처를 모르겠다면 기기 정보를 확인하고, 필요한 경우 범용 패키지를 사용하세요.
서비스를 시작할 때 시스템 VPN 권한을 허용해야 합니다. 화면을 잠근 뒤 연결이 자주 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 두 클라이언트를 비교하려면 기존 연결을 먼저 중지하세요. 시스템에서 활성 VPN을 하나만 허용하는 제한을 설정 오류로 오해하지 않도록 주의해야 합니다.
다운로드 페이지로 이동v2rayN · deb / rpm
배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 다음 기기의 아키텍처가 x64인지 arm64인지 확인하세요. 다운로드 센터에서 두 아키텍처용 패키지를 모두 제공합니다. 먼저 배포판의 그래픽 소프트웨어 설치 도구로 패키지를 열고, 의존성 관련 안내가 나오면 구체적인 항목을 기록하세요.
설치 후 데스크톱 환경의 프록시 설정을 대상 앱이 사용하는지 확인하세요. 앱마다 시스템 프록시 지원이 다르므로 브라우저는 접속되지만 다른 프로그램은 실패한다면 먼저 트래픽 진입 경로를 확인해야 합니다. TUN에는 추가 권한이 필요하므로 처음 구독을 가져올 때 함께 설정하지 않는 것이 좋습니다.
다운로드 페이지로 이동빠른 시작 / 기본 연결부터 설정
한 번에 한 종류의 설정만 변경하는 것이 좋습니다. 먼저 설정으로 연결되는지 확인한 다음 라우팅과 트래픽 처리 범위를 조정하세요. 문제가 생기면 어느 단계에서 변경 사항이 발생했는지 파악하기 쉽습니다. 아래는 v2rayN 데스크톱 버전을 기준으로 설명합니다. Android의 v2rayNG에서는 설정을 가져오고 선택한 뒤 서비스를 시작하면 됩니다.
단계 01 / 설정 가져오기
설정 제공 업체가 안내한 구독 주소 또는 단일 공유 링크를 준비하세요. 구독 주소는 '구독 그룹 설정'에 입력하고, 공유 링크는 클립보드에서 가져오는 메뉴를 사용하세요. 두 종류의 내용을 같은 입력란에 넣지 마세요. 그룹을 저장하고 업데이트한 뒤 목록을 확인하고 항목 하나를 활성 서버로 지정합니다. Android에서는 설정 추가 또는 구독 설정 메뉴에서 같은 작업을 할 수 있습니다.
업데이트 후 목록이 비어 있다면 먼저 올바른 그룹을 선택했는지 확인하고, 주소가 온전한지, 불필요한 공백이 포함되지 않았는지, 제공 업체가 주소를 변경했는지 살펴보세요. 브라우저에서 구독 페이지가 열린다고 해서 반환되는 내용이 클라이언트에서 지원하는 구독 형식이라는 뜻은 아닙니다. 오류 메시지를 기록하기 전에 업데이트를 반복해 기존 상황을 덮어쓰지 마세요.
구독 가져오기 자세히 보기 →단계 02 / 트래픽 진입 경로
데스크톱에서는 먼저 '시스템 프록시 자동 설정'을 선택하고 적절한 라우팅 프리셋을 사용하세요. 시스템 프록시는 이를 지원하는 앱의 요청을 로컬 수신 포트로 보낼지 결정하고, 라우팅 프리셋은 커널에 전달된 연결의 경로를 정합니다. 두 설정은 서로 대체할 수 없으며, 처음 연결할 때 복잡한 규칙을 만들 필요도 없습니다.
대상 앱에 별도의 프록시 설정이 있다면 프록시 유형, 주소, 포트가 클라이언트 설정과 일치하는지 확인하세요. 우선 TUN은 끈 상태로 두고 브라우저에서 기본 연결을 확인합니다. Android에서 서비스를 시작할 때는 시스템 권한을 허용하고 앱별 프록시 설정도 확인하세요. 제외된 앱은 예상한 연결 경로를 사용하지 않습니다.
라우팅 및 모드 설정 →단계 03 / 연결 확인
서비스를 시작한 뒤 직접 연결되어야 하는 주소와 프록시를 통해 접속해야 하는 주소를 각각 확인하세요. 클라이언트 아이콘이 바뀌는 것만으로 요청이 실제 프록시를 통과한다고 볼 수는 없습니다. 접속 결과와 연결 로그를 함께 확인해야 합니다. 노드 지연 시간 테스트는 다운로드 속도와 다르므로 한 번의 결과만으로 안정성을 판단하지 마세요.
접속할 수 없다면 '커널 실행 여부, 로컬 포트 수신 여부, 앱의 프록시 사용 여부, 원격 서버 도달 여부' 순서로 확인하세요. 오류 키워드를 먼저 기록하고 모든 구성 요소를 한꺼번에 재설치하지 마세요. 문제 해결 정보를 공유할 때는 구독 주소, 서버 접속 정보, 개인 네트워크 정보를 가리고 조작 단계, 오류 유형, 필요한 환경 정보만 남기세요.
증상별 문제 진단 보기 →오픈 소스 생태계 / 클라이언트와 커널
V2Ray는 여러 프록시 도구를 통칭하는 말로 자주 쓰이지만 실제 설정은 그래픽 클라이언트, 프록시 커널, 프로토콜, 서버의 네 계층으로 나뉩니다. 다운로드할 때는 클라이언트 이름을 확인하고, 매개변수 호환성은 커널과 프로토콜을 기준으로 판단하세요. 네트워크 문제는 실제 연결 경로를 따라가며 점검해야 합니다. 이름이 비슷하다고 모든 설정을 서로 바꿔 쓸 수 있는 것은 아닙니다.
구성 계층
Project V는 모듈형 프록시 도구를 중심으로 형성되었으며 V2Ray는 널리 사용되는 핵심 프로젝트 중 하나입니다. V2Fly 커뮤니티는 V2Ray 관련 구현을 지속적으로 유지 관리하고, Xray는 V2Ray 프로젝트의 포크에서 발전해 자체 기능과 매개변수 지원 범위를 갖추게 됐습니다. 이 관계를 이해하면 클라이언트의 커널 옵션을 파악하는 데 도움이 됩니다. 공통된 역사가 있더라도 설정 필드, 프로토콜 확장, 라우팅 동작이 항상 완전히 같다고 볼 수는 없습니다.
일상적인 사용에서는 전체 커널 설정을 직접 편집할 필요가 거의 없습니다. 그래픽 클라이언트는 구독 항목과 인터페이스 설정에 따라 실행 설정을 생성한 뒤 해당 커널을 시작합니다. 생성된 파일을 직접 수정하면 다음에 서버를 바꾸거나 설정을 저장할 때 변경 내용이 덮어써질 수 있습니다. 변경 사항을 유지하려면 클라이언트에서 제공하는 설정 메뉴를 우선 이용하고 변경 전후의 동작을 기록하세요.
v2rayN, v2rayNG, v2flyNG는 모두 커뮤니티에서 유지 관리하는 오픈 소스 그래픽 클라이언트이며 무료로 사용할 수 있습니다. v2rayN은 GPL-3.0 라이선스로 배포되며 데스크톱 설정 관리에 적합합니다. v2rayNG도 GPL-3.0을 사용하고 Android용 Xray 커널을 지원합니다. v2flyNG는 GPL-3.0을 사용하며 Android용 V2Fly 커널을 지원합니다. 라이선스는 소프트웨어 코드의 사용과 배포 조건을 규정하며, 클라이언트에 연결 가능한 원격 서버가 포함된다는 뜻은 아닙니다.
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 먼저 고려하세요. 설정에서 V2Fly 동작을 명확히 요구한다면 v2flyNG를 검토할 수 있습니다. 세 클라이언트는 설정 화면과 커널 구성, 플랫폼 권한이 다르므로 옮겨 사용할 때 서버 항목을 가져왔는지만 확인하지 말고 라우팅, DNS, 앱 프록시 적용 범위도 다시 점검해야 합니다. 자세한 비교는 클라이언트 선택 비교에서 확인하세요.
V2Fly와 Xray의 핵심 코드는 일반적으로 MPL-2.0 라이선스를 사용하며, 그래픽 클라이언트의 라이선스와는 별개입니다. 오픈 소스란 라이선스 조건에 따라 관련 코드를 확인, 수정, 배포할 수 있다는 의미입니다. 설정 실행 가능 여부를 판단하려면 각 커널이 지원하는 프로토콜과 전송 필드를 확인해야 합니다. VMess, VLESS, Trojan, Shadowsocks는 프로토콜 이름이며 서버 주소가 아닙니다. 이름만으로 속도를 판단할 수도 없습니다.
예를 들어 설정에 특정 TLS 또는 REALITY 매개변수가 포함됐다면 서버가 제공한 설정과 정확히 일치해야 하며 해당 필드를 지원하는 구현을 사용해야 합니다. 오류를 없애려고 인증서 검증을 무작정 끄지 마세요. 먼저 시간이 정확한지, 도메인이 일치하는지, 매개변수가 완전한지 확인한 다음 클라이언트 업데이트나 커널 교체가 필요한지 판단하세요. 매개변수의 의미가 불분명하다면 용어 설명을 먼저 확인하는 편이 옵션을 하나씩 바꿔 보는 것보다 재현 가능한 결과를 얻기 쉽습니다.
클라이언트 업데이트는 인터페이스, 의존 구성 요소, 설정 생성 로직에 영향을 줍니다. 커널 업데이트는 프로토콜 구현과 실행 동작을 변경하고, 구독 업데이트는 서버 설정만 새로 가져옵니다. 구독 새로고침에 성공해도 소프트웨어가 업데이트된 것은 아닙니다. 새 클라이언트를 설치해도 만료된 구독이 자동으로 복구되지는 않습니다. 다운로드 센터에서 클라이언트를 받을 수 있으며, 구독 주소와 서비스 상태는 설정 제공 업체에 확인해야 합니다.
업데이트 전에 현재 설정을 백업하고 사용 중인 커널, 수신 포트, 사용자 지정 규칙을 기록하세요. 업데이트 후 기본 연결부터 확인한 다음 추가 설정을 하나씩 복원합니다. 새 환경에서 문제가 생기면 로그의 첫 오류와 재현 절차를 보존하세요. '시작 실패'라는 마지막 줄만 기록하지 마세요. 연결 시간 초과, DNS 조회 오류, 시스템 프록시 잔류 문제는 문제 진단에서 확인할 수 있습니다. 개념에 관한 질문은 FAQ를 먼저 살펴보면 불필요한 재설치를 줄일 수 있습니다.
정보 / 설정 및 문제 해결 기록
기본 연결을 확인한 다음 겪고 있는 문제에 맞는 안내를 살펴보세요. 클라이언트 선택 글에서는 플랫폼과 커널 차이를 설명하고, 로그 안내에서는 오류 키워드로 원인을 찾습니다. 시작 실패 안내에서는 포트 충돌, 형식 오류, 필드 호환성 문제를 나누어 다룹니다. 먼저 현상이 어느 계층에 해당하는지 파악한 뒤 바꿀 설정을 결정하세요.
커널이 시작하자마자 종료된다면 포트 충돌, 설정 파일 형식, 필드 오타, 커널 버전을 차례로 확인해 문제가 발생한 줄을 찾으세요. 설정 구문 분석 실패와 연결 실패를 구분한 다음 설정을 수정할지 네트워크를 점검할지 결정합니다.
시작 오류 해결 절차 보기 →지원 플랫폼, 커널 계열, 프로토콜 범위, 일상적인 사용 방식의 네 가지 기준으로 세 클라이언트를 비교하고 데스크톱과 Android에 맞는 선택을 안내합니다. 이름이 비슷하다는 이유만으로 설치 패키지를 바꾸기보다 설정에 필요한 기능이 있는지 확인하세요.
클라이언트 선택 안내 보기 →로그 수준과 오류 키워드별로 connection refused, i/o timeout, TLS 핸드셰이크 실패 등의 메시지가 어떤 단계의 문제를 나타내는지 설명합니다. 발생 시점과 대상 앱을 함께 확인하고 가장 먼저 나타난 유효한 오류 정보를 보관하세요.
로그로 문제 위치 찾는 방법 보기 →