첫 설정 · 네 단계

v2rayN 사용법:
구독 가져오기 및 연결 확인

처음에는 시스템 프록시로 연결하고 TUN은 나중에 설정하세요. ‘구독 가져오기 → 프록시 모드 선택 → 연결 → 확인’ 순서로 진행하면 문제 발생 지점을 찾기 쉽습니다.

클라이언트가 설치되어 있고 신뢰할 수 있는 제공처에서 받은 유효한 구독 링크가 준비되어 있어야 합니다. 클라이언트에는 바로 사용할 수 있는 서버가 포함되어 있지 않습니다. 연결 구성을 아직 받지 못했다면 먼저 준비를 마친 후 아래 단계를 진행하세요. 구독이 있고 네트워크가 정상이라면 첫 설정은 약 10분이면 완료할 수 있습니다.

구독 가져오기

이 단계의 완료 기준은 클라이언트 서버 목록에 선택 가능한 구성 항목이 표시되는 것입니다. 먼저 구독 제공처에서 받은 링크 전체를 복사하되, 안내 문구나 줄바꿈, 앞뒤 공백이 함께 복사되지 않도록 주의하세요. 구독 링크와 웹사이트 로그인 주소는 다릅니다. 계정 페이지 주소를 복사하면 업데이트 시 클라이언트 구성이 아닌 웹페이지가 반환될 수 있습니다. 구독에는 보통 접속 정보가 포함되므로 개인 기기에 보관하고 공개 게시판이나 확인되지 않은 변환 웹사이트에 붙여 넣지 마세요.

데스크톱: 그룹을 추가하고 구독 업데이트하기

v2rayN을 열고 상단 메뉴에서 ‘구독 그룹’을 찾아 ‘구독 그룹 설정’으로 이동한 다음 새 그룹을 만듭니다. 메모는 로컬에서 구분하기 위한 항목이므로 제공처를 알아보기 쉬운 이름을 입력하면 됩니다. 구독 주소란에 링크 전체를 붙여 넣고, 다른 옵션은 우선 기본값으로 둔 채 저장한 다음 설정 창을 닫으세요. 그룹 저장은 주소가 등록됐다는 뜻일 뿐 서버 목록이 바로 바뀌지는 않습니다. 구독을 업데이트해야 합니다.

‘구독 그룹’ 메뉴로 돌아가 현재 그룹의 구독 업데이트를 선택합니다. 첫 설정 중 ‘프록시를 사용하지 않고 업데이트’ 옵션이 있다면 아직 프록시 연결이 설정되지 않았을 수 있으므로 해당 항목을 먼저 사용하세요. 작업이 끝나면 서버 목록으로 돌아가 방금 추가한 그룹을 선택합니다. 일반적으로 프로토콜, 주소, 포트 등의 구성 항목이 표시됩니다. 프로토콜 매개변수를 직접 수정하지 말고 구독에 포함된 설정을 그대로 둔 채 다음 단계로 진행하세요.

목록이 비어 있다면 먼저 하단 로그에서 구독 가져오기 실패, 주소 형식 오류, 파싱 실패 등의 메시지가 있는지 확인하세요. 가져오기에 실패했다면 현재 네트워크에서 구독 주소에 접속할 수 있는지, 링크가 만료되지 않았는지 점검합니다. 파싱에 실패했다면 제공처가 현재 클라이언트에서 지원하는 형식으로 구성을 제공하는지 확인하세요. 제공처에서 명확히 요구한 경우에만 형식 변환을 고려하고, 업데이트가 한 번 실패했다고 서버 주소나 전송 매개변수를 임의로 바꾸지 마세요. 다른 그룹이 이미 있다면 필터 조건 때문에 새 항목이 숨겨진 것은 아닌지도 확인하세요.

Android: v2rayNG에 구독 주소 추가하기

v2rayNG를 열고 메뉴에서 ‘구독 그룹 설정’으로 이동합니다. 추가 버튼을 눌러 메모와 구독 주소를 입력하고 저장한 뒤 메인 화면으로 돌아오세요. 메인 화면 메뉴에서 구독을 업데이트하고, 그룹 필터가 있다면 해당 그룹을 선택해 결과를 확인합니다. 업데이트가 완료되면 메인 화면에 선택 가능한 서버 구성이 표시됩니다. QR 코드 스캔이나 클립보드에서 가져오기는 보통 단일 공유 구성을 추가하는 방법이며, 계속 업데이트되는 구독 그룹을 추가하는 것과는 다릅니다. 이후 변경 사항을 자동으로 받을 수 있는지는 가져오기 방식에 따라 달라집니다.

서버 항목이 표시되면 구독 준비가 완료된 것입니다. 다음으로 모든 트래픽 처리 옵션을 한꺼번에 켜기보다 앱 트래픽을 클라이언트로 전달할 방식을 먼저 정하세요.

프록시 모드 선택

처음 사용할 때는 트래픽을 처리하는 경로를 하나만 활성화하는 것이 좋습니다. 데스크톱에서는 먼저 시스템 프록시를 사용하고 TUN은 꺼 두세요. 권한, 가상 네트워크 어댑터, DNS 설정이 동시에 영향을 미치는 변수를 줄일 수 있습니다. 시스템 프록시는 앱이 트래픽을 로컬 클라이언트로 전달할지 결정하고, 라우팅 규칙은 전달된 트래픽을 직접 연결, 프록시 또는 차단 중 어떤 방식으로 처리할지 결정합니다. 라우팅 사전 설정을 선택해도 모든 앱의 트래픽이 자동으로 클라이언트에 들어가는 것은 아닙니다.

데스크톱: 시스템 프록시 자동 설정, TUN 끄기

v2rayN 메인 창이나 트레이 메뉴에서 ‘시스템 프록시’를 찾아 ‘시스템 프록시 자동 설정’을 선택합니다. ‘시스템 프록시 해제’는 시스템의 프록시 설정을 되돌리는 항목입니다. ‘시스템 프록시 변경 안 함’은 현재 설정을 수정하지 않는다는 뜻이지 자동으로 프록시를 켠다는 의미가 아닙니다. 선택 후 클라이언트 상태 표시를 확인해 실제로 자동 설정이 적용됐는지 살펴보세요. 메뉴를 한 번 열어본 것만으로는 설정이 적용되지 않습니다.

그다음 라우팅 설정에서 사용 목적에 맞는 사전 설정을 선택하세요. 처음에는 ‘중국 본토 우회’와 같은 항목을 사용할 수 있습니다. 일반적으로 사전 설정 규칙에 해당하는 대상은 직접 연결하고, 나머지는 기본 아웃바운드로 처리합니다. 실제 동작은 현재 규칙의 내용과 순서에 따라 달라지므로 도메인마다 항상 같은 결과가 나온다고 단정할 수 없습니다. 처음 연결하는 중이라면 하나의 사전 설정만 유지하고 온라인에서 복사한 사용자 지정 규칙을 여러 개 추가하지 마세요.

마지막으로 TUN이 꺼져 있는지 확인하세요. 시스템 프록시는 해당 설정을 따르는 앱에 주로 적용되므로 일부 명령줄 도구나 독립 네트워크 프로그램에는 적용되지 않을 수 있습니다. 이것만으로 설정 실패라고 볼 수는 없습니다. 먼저 일반 브라우저로 확인하세요. 이후 해당 앱의 트래픽도 처리해야 한다면 전체 가이드에서 TUN 권한, 라우팅 및 DNS 설정을 살펴보세요. 첫 연결 단계에서 모두 설정할 필요는 없습니다.

Android: VPN 트래픽 처리와 라우팅 설정

v2rayNG는 보통 로컬 VPN을 통해 트래픽을 처리하고, 실제 아웃바운드 방식은 구성에 따라 결정됩니다. 데스크톱의 ‘시스템 프록시 자동 설정’을 찾을 필요가 없습니다. 이번에는 기본 앱 프록시 범위를 유지하고 앱별 제외 규칙을 추가하지 마세요. 기기에서 VPN 연결을 사용하는 다른 도구가 실행 중이라면 같은 연결을 두고 충돌하지 않도록 먼저 중지하세요. 라우팅은 현재 네트워크에 맞는 사전 설정을 사용하고, 연결 권한은 다음 단계에서 처리합니다.

설정이번 단계에서 할 일확인할 사항
데스크톱 시스템 프록시시스템 프록시 자동 설정브라우저가 시스템 프록시를 따르는지
데스크톱 TUN일단 끄기권한 및 가상 네트워크 어댑터 변수부터 제외
Android VPN 트래픽 처리연결할 때 시스템 권한 확인VPN 연결이 시작됐는지, 앱이 적용 범위에 포함되는지
라우팅 사전 설정우선 규칙 하나만 유지매칭 조건과 최종 아웃바운드가 예상과 일치하는지

트래픽 처리 방식과 라우팅 사전 설정을 정했다면 실제로 사용할 서버를 선택할 수 있습니다. 이 단계에서는 DNS를 조정하거나 코어를 바꾸지 말고 재현하기 쉬운 기본 구성을 유지하세요.

연결하고 실행 상태 확인

구독을 가져왔다고 모든 구성이 작동한다고 볼 수는 없으며, 항목을 선택했다고 반드시 활성 서버로 지정되는 것도 아닙니다. 연결 단계에서는 ‘현재 어떤 구성을 사용하는지’와 ‘코어가 정상적으로 실행되는지’를 각각 확인해야 합니다. 처음에는 출처가 분명하고 유효 기간이 남은 구성 하나만 선택하세요. 항목을 연달아 바꾸면 로그가 어떤 작업에 해당하는지 구분하기 어렵습니다.

데스크톱: 활성 서버 지정 및 로그 확인

v2rayN 서버 목록에서 대상 항목을 마우스 오른쪽 버튼으로 클릭하고 ‘활성 서버로 설정’ 또는 같은 의미의 메뉴 항목을 선택합니다. 버전에 따라 더블 클릭이나 단축키를 사용할 수도 있으니 화면 안내를 따르세요. 작업 후 해당 행의 활성 표시나 상태 표시줄을 확인해 활성 항목이 바뀌었는지 살펴봅니다. v2rayN은 활성 구성이 바뀌면 보통 서비스를 다시 불러오므로 별도의 큰 ‘연결’ 버튼이 없을 수 있습니다.

하단 로그 영역을 열고 전환 후 메시지를 확인합니다. 코어가 종료됐거나 수신 주소가 사용 중임, 구성 파싱 실패, 리소스 파일을 읽을 수 없음 등의 오류가 있다면 해당 오류부터 해결하세요. 시스템 프록시 옵션을 반복해서 바꾸는 것은 도움이 되지 않습니다. 로그에 서비스가 정상적으로 시작됐다고 표시되면 로컬 실행 단계가 완료된 것입니다. 원격 서버에 연결할 수 있는지는 다음 단계에서 실제 접속으로 확인해야 합니다.

포트가 사용 중이라면 설정에서 로컬 수신 포트를 확인하세요. 혼합 수신 포트는 10808일 수 있지만 실제 값은 현재 화면을 기준으로 확인해야 합니다. 튜토리얼과 맞추려고 특정 숫자로 강제 변경하지 마세요. 다른 클라이언트 인스턴스가 동시에 실행 중인지도 확인하세요. 수신 포트를 변경했다면 저장한 뒤 서비스를 다시 불러오고, 시스템 프록시도 다시 적용해 시스템이 지정하는 포트와 클라이언트 포트가 일치하도록 하세요. 프록시 주소를 직접 입력한 앱도 함께 수정해야 합니다.

전환 후 새 로그가 전혀 표시되지 않는다면 로그 패널이 일시 정지되거나 필터링된 상태인지 먼저 확인하세요. 그런 다음 클라이언트 메뉴에서 ‘서비스 다시 시작’을 한 번 실행하고 결과를 살펴봅니다. 원인을 모른 채 기기를 계속 재부팅하지 마세요. 오류별로 진단하려면 코어 시작 실패 시 로그로 원인 찾기를 참고하세요. 이 페이지에서는 우선 정상적으로 시작되는 상태를 만드는 데 집중합니다.

Android: 구성 선택 및 VPN 권한 확인

v2rayNG 메인 화면에서 사용할 구성을 선택하고 하단의 연결 버튼을 누릅니다. 처음 실행하면 보통 시스템 VPN 연결 요청이 표시됩니다. 안내를 확인하고 승인한 다음 클라이언트로 돌아와 상태가 바뀌는지 기다리세요. 권한을 거부하면 구성을 가져왔더라도 트래픽을 처리하는 VPN 연결은 만들어지지 않습니다. 기기에 VPN 상태 표시가 나타나면 시스템 연결이 만들어진 것이지만, 이것만으로 원격 서버가 작동한다고 단정할 수는 없습니다.

버튼을 누른 직후 연결이 중지되면 로그에서 시작 실패 원인을 확인하세요. 한동안 실행된 뒤 끊긴다면 시스템이 백그라운드 활동을 제한하는지 살펴봅니다. 처음 확인할 때는 클라이언트를 전면에 둔 채 접속 결과가 정상인지 확인한 다음 백그라운드 실행 설정을 점검해도 됩니다. 이 단계에서 데스크톱은 로컬 코어가 정상적으로 실행 중이어야 하고, Android는 권한이 승인된 연결이 작동 중이어야 합니다. 이제 실제 요청으로 전체 경로를 확인합니다.

적용 여부 확인

연결 아이콘만 보지 말고 ‘대상 페이지에 접속할 수 있는지’와 ‘요청이 예상한 아웃바운드로 처리되는지’를 확인하세요. 현재 규칙상 직접 연결되어야 하는 페이지를 하나 열고, 프록시를 사용해야 하며 서비스가 정상인 대상 페이지도 하나 엽니다. 처음 테스트할 때는 같은 브라우저를 사용해 앱마다 다른 프록시 동작이 섞이지 않게 하세요. 페이지가 열린다는 것은 첫 번째 확인 결과일 뿐이며 로그를 함께 보면 라우팅이 예상대로 적용됐는지 더 잘 판단할 수 있습니다.

먼저 접속 결과를 확인하고 로그와 프록시 경로를 비교하세요

데스크톱에서 브라우저를 계속 켜 둔 상태였다면 브라우저를 닫았다가 다시 열고 접속을 시도하세요. 일부 브라우저 확장 프로그램, 별도 프록시 설정이나 관리 정책은 시스템 설정을 덮어쓸 수 있습니다. 브라우저가 직접 연결하도록 별도로 설정되어 있다면 이번에 구성한 시스템 프록시 경로를 사용하지 않습니다. 먼저 브라우저가 시스템 프록시를 사용하는지 확인하고 서버 프로토콜을 바로 바꾸지 마세요. Android에서는 브라우저가 앱별 분할 규칙에서 제외되어 있지 않은지 확인하세요. 특히 이전에 사용자 지정 프록시 범위를 설정한 기기라면 주의가 필요합니다.

클라이언트 로그로 돌아가 방금 접속을 시도한 시간대의 요청을 찾습니다. 표시되는 정보는 로그 수준과 코어에 따라 다릅니다. 아웃바운드 기록이 있다면 직접 연결인지 프록시인지 확인할 수 있습니다. 자세한 기록이 없다고 요청이 클라이언트에 들어오지 않았다고 단정하지 마세요. 로그를 많이 남기려고 지나치게 상세한 설정을 계속 켜 둘 필요도 없습니다. 로그를 공유할 때는 구독 주소, 서버 주소와 인증 정보를 가리고 문제 파악에 필요한 오류 부분만 남기세요.

클라이언트에 내장된 연결 또는 지연 시간 테스트는 명백히 작동하지 않는 항목을 걸러내는 데 도움이 됩니다. 다만 테스트 대상과 방법은 평소 접속 방식과 완전히 같지 않습니다. 테스트에 성공해도 모든 앱에서 접속할 수 있는 것은 아니며, 테스트 주소 자체의 문제로 실패할 수도 있습니다. 실제 앱의 요청, 관련 실행 로그와 반복 가능한 접속 결과를 함께 보고 판단하세요.

문제가 있으면 한 번에 한 항목씩 확인

모든 페이지에 접속할 수 없다면 먼저 로컬 코어가 종료되지 않았는지 확인하고, 시스템 프록시가 가리키는 포트와 실제 수신 포트가 일치하는지 점검하세요. 직접 연결 페이지는 열리지만 프록시를 사용해야 하는 페이지가 실패한다면 활성 서버, 구독 유효성, 원격 연결 오류를 확인합니다. 특정 앱에서만 문제가 생기면 해당 앱이 시스템 프록시를 따르는지, Android 트래픽 처리 범위에 포함되는지 먼저 살펴보세요. 이렇게 하면 로컬 트래픽 처리 문제와 원격 연결 문제를 구분할 수 있어 모든 구성을 처음부터 삭제할 필요가 없습니다.

로그에 도메인 이름 확인 오류가 명확히 표시될 때만 DNS 설정을 점검하세요. 먼저 현재 값을 기록하고 네트워크 자체에서 정상적으로 이름을 확인할 수 있는지 확인한 다음 전체 가이드의 DNS 및 라우팅 안내를 참고해 항목별로 수정하세요. DNS, 라우팅 사전 설정, 코어와 서버를 한꺼번에 바꾸면 문제가 해결되더라도 원인을 알기 어렵습니다. ‘도메인 이름 확인’과 ‘라우팅 분기’의 차이는 용어 가이드에서 먼저 확인할 수 있습니다.

확인 후 설정 유지 및 종료

두 종류의 대상 페이지가 모두 예상대로 열리고 로그에 지속적인 시작 또는 연결 오류가 없다면 기본 설정을 그대로 사용해도 됩니다. 현재 그룹, 활성 구성, 프록시 모드와 라우팅 사전 설정을 기록해 두세요. 평소에는 필요할 때 구독만 업데이트하면 되며 매번 실행할 때마다 다시 가져올 필요는 없습니다. 구독을 업데이트하면 기존 항목이 삭제될 수 있으므로 업데이트 후 문제가 생기면 활성 서버가 목록에 남아 있는지 먼저 확인한 뒤 다른 설정을 점검하세요.

데스크톱 사용을 마칠 때는 v2rayN에서 ‘시스템 프록시 해제’를 선택한 다음 클라이언트를 종료하세요. 다른 트래픽 처리 방식을 사용했다면 그것도 먼저 끄세요. 그래야 시스템이 이미 종료된 로컬 수신 포트로 요청을 계속 보내지 않습니다. Android에서는 v2rayNG의 중지 버튼을 누르고 시스템 VPN 상태가 종료됐는지 확인하세요. 다음에 사용할 때는 ‘클라이언트 실행 → 활성 구성 확인 → 해당 트래픽 처리 방식 활성화’ 순서로 다시 시작하면 됩니다.

v2rayN 다운로드