QUICKSTART / 첫 설정
v2rayN 사용법:
구독 가져오기와 연결 확인
구독 가져오기, 프록시 모드 선택, 연결 시작, 요청 확인까지 4단계로 연결 상태를 점검하세요. 먼저 사전 설정을 사용하고, 이후 분할 라우팅과 DNS를 조정하면 됩니다.
시작 전: 클라이언트와 구독 주소
먼저 클라이언트 다운로드 페이지에서 기기에 맞는 설치 파일을 선택해 설치한 뒤 메인 창을 여세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 사용합니다. 처음 실행하면 창이 정상적으로 표시되고 설정이 저장되는지 확인하세요. 수신 대기 포트, 라우팅, DNS, 코어를 한꺼번에 변경하지 마세요. 초기 설정을 유지해야 문제가 생겼을 때 비교하기 쉽습니다.
클라이언트와 서버는 다릅니다. 클라이언트를 설치한 뒤에는 유효한 구독 주소나 전체 서버 공유 링크가 필요합니다. 구독 주소로 서버 설정 목록을 가져오며, 공유 링크는 보통 개별 서버 항목을 나타내므로 가져오는 메뉴가 다릅니다. 이 사이트는 클라이언트와 설정 정보를 제공하지만 구독 주소를 제공하거나 서버 계정을 생성하지는 않습니다. 아직 설정 정보를 받지 못했다면 제공자에게 주소, 유효 기간, 지원 클라이언트를 먼저 확인하세요.
구독 링크에는 접속 정보가 포함될 수 있습니다. 복사할 때 전체 내용을 유지하고 물음표 뒤의 매개변수를 임의로 삭제하지 마세요. 공개 게시판이나 온라인 파싱 도구에 붙여 넣는 것도 피해야 합니다. 문제 해결을 위해 도움을 요청할 때는 주소와 접속 정보를 가린 오류 내용만 공유하세요. 첫 설정은 약 10분을 기준으로 진행할 수 있지만, 구독 유효성, 네트워크 환경, 기기 권한에 따라 실제 시간은 달라질 수 있습니다.
1. 구독 가져오기 및 목록 업데이트
v2rayN에서 구독 그룹 추가
구독 주소를 복사한 뒤 v2rayN 메인 창에서 ‘구독 그룹’ 관련 메뉴를 열고 ‘구독 그룹 설정’으로 이동하세요. 그룹을 추가하고 알아보기 쉬운 이름(예: ‘일상 설정’)을 입력한 다음 주소란에 전체 구독 링크를 붙여 넣습니다. 앞뒤에 공백이나 줄바꿈이 들어갔는지, 안내 문구까지 함께 복사하지 않았는지 확인한 뒤 저장하세요. 이 단계에서는 구독 출처만 저장되므로 서버 목록에 항목이 바로 표시되지 않을 수 있습니다.
메인 창으로 돌아가 구독 메뉴에서 업데이트를 실행하세요. 클라이언트에 ‘프록시를 통해 업데이트’와 ‘프록시 없이 업데이트’ 메뉴가 있을 수 있습니다. 아직 사용할 수 있는 연결이 없다면 먼저 프록시 없이 업데이트를 시도하세요. 구독 주소에 접속할 때 기존 프록시가 필요한 경우에는 사용 가능한 연결을 먼저 만든 뒤 프록시를 통해 업데이트해야 합니다. 메뉴 이름만 보고 반복해서 전환하지 말고 업데이트 결과에 표시된 오류를 확인하세요.
업데이트가 끝나면 방금 만든 구독 그룹을 선택하고 서버 목록에 항목이 표시되는지 확인하세요. 이름, 프로토콜 유형, 서버 주소, 포트가 있는지 살펴보되 여러 서버의 속도를 바로 측정할 필요는 없습니다. 기존 항목이 있다면 현재 선택한 그룹도 확인해 다른 그룹의 항목을 이번 업데이트 결과로 착각하지 않도록 하세요. 구독 업데이트 성공은 목록을 가져와 파싱했다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 의미는 아닙니다.
업데이트에 실패하면 먼저 기기에서 인터넷에 정상적으로 접속되는지 확인한 뒤 구독 만료 여부, 주소가 잘리지 않았는지, 시스템 시간이 정확한지 살펴보세요. 파싱 오류가 발생하면 응답 내용이 클라이언트에서 인식할 수 있는 구독 형식이 아니라 로그인 페이지나 서버 안내일 수 있습니다. 오류 페이지를 설정으로 가져오지 마세요. 더 자세한 점검 방법은 구독 업데이트 실패 자가 점검 목록을 참고하세요.
v2rayNG에서 해당 작업 수행
v2rayNG에서 메인 화면 메뉴를 열고 구독 그룹 설정으로 이동하세요. 추가 버튼을 눌러 그룹 이름과 구독 주소를 입력하고 저장한 다음 메인 화면으로 돌아와 메뉴에서 구독 업데이트를 실행합니다. 업데이트가 끝나면 해당 그룹을 선택해 서버 항목을 확인하세요. 개별 공유 링크를 받은 경우에는 구독 주소란에 입력하지 말고 ‘클립보드에서 가져오기’와 같은 설정 가져오기 메뉴를 사용하세요. 두 방법 모두 목록에 새 항목이 실제로 추가되었는지 확인하면 완료입니다.
이 단계가 끝나면 선택할 수 있는 서버 항목이 하나 이상 표시되어야 합니다. 아직 연결하지 말고, 다음 단계에서 앱이 어떤 방식으로 연결되는지와 연결이 코어에 들어간 뒤 어떤 라우팅 규칙을 따르는지 정하세요. 구독, 노드, 공유 링크의 자세한 차이는 용어 설명에서 확인할 수 있습니다.
2. 프록시 연결 방식과 라우팅 모드 선택
시스템 프록시와 라우팅 규칙 구분하기
데스크톱에서 처음 사용할 때는 시스템 프록시를 사용하고 TUN은 잠시 꺼 두세요. 시스템 프록시는 해당 설정을 따르는 앱에 요청을 로컬 프록시 주소로 보내도록 안내합니다. 라우팅 규칙은 코어에 들어온 연결을 프록시, 직접 연결 또는 다른 아웃바운드 중 어디로 보낼지 결정합니다. 두 설정은 서로 다른 단계입니다. 시스템 프록시를 켰다고 해서 모든 연결이 프록시를 통해 나가는 것은 아닙니다.
v2rayN에서 시스템 프록시 메뉴를 찾으세요. 보통 창 하단이나 트레이 아이콘의 마우스 오른쪽 메뉴에 있습니다. ‘시스템 프록시 설정’과 ‘시스템 프록시 해제’가 어디 있는지 확인하고, 다음 단계에서 코어가 정상적으로 시작된 것을 확인한 뒤 설정하세요. 브라우저에 직접 입력한 프록시 주소와 시스템 프록시를 함께 사용하지 마세요. 한쪽 설정을 해제해도 다른 쪽이 브라우저 요청에 계속 영향을 줄 수 있습니다.
다음으로 라우팅 선택 메뉴를 찾으세요. 처음에는 일반적인 직접 연결 대상과 프록시 대상 등을 구분하는 규칙처럼 클라이언트가 제공하는 사전 설정을 선택할 수 있습니다. 사전 설정 이름과 세부 규칙은 버전마다 다르므로 선택 항목의 설명을 확인하세요. 문제 해결을 위해 일시적으로 ‘전역’ 라우팅을 사용하더라도, 이는 코어에 들어온 트래픽의 처리 방식만 바꾼다는 점에 유의하세요. 모든 앱의 트래픽이 가로채졌다고 판단할 근거는 되지 않습니다.
이번에는 사용자 지정 규칙을 추가하거나 DNS를 함께 변경하지 마세요. 클라이언트에 포함된 설정을 유지하고 현재 선택한 라우팅 이름을 기록하세요. 나중에 특정 사이트는 열리지만 다른 사이트는 열리지 않는 문제가 생겼을 때 같은 규칙으로 재현할 수 있어야 합니다. 설정을 여러 곳에서 바꾸면 원인을 판단하기 어렵습니다. 규칙 순서, 도메인 매칭, 아웃바운드 태그는 JSON 매뉴얼의 routing 항목에서 확인하세요.
v2rayNG에서 시스템 VPN 인터페이스 사용
v2rayNG는 일반적으로 Android 시스템 VPN 인터페이스로 트래픽을 받으므로 휴대전화의 Wi-Fi 설정에 데스크톱 프록시 포트를 따로 입력할 필요가 없습니다. 처음 연결할 때는 기본 라우팅과 앱 범위 설정을 유지하세요. 앱별 프록시를 켰던 경우 브라우저가 선택한 프록시 범위에 포함되어 있는지 확인하세요. 범위에 포함되지 않은 앱으로는 현재 프록시 연결이 정상인지 확인할 수 없습니다.
기기에서 다른 VPN 서비스가 실행 중이면 현재 연결과 충돌할 수 있습니다. 기존 연결을 먼저 종료한 다음 v2rayNG를 시작하세요. 이 단계의 목적은 연결 방식과 규칙을 고정해 변수를 줄이는 것입니다. 완료되면 서버 목록으로 돌아가 다음 단계에서 활성 서버를 선택하고 서비스를 시작하세요.
3. 서버를 선택하고 연결 시작
데스크톱에서 활성 서버와 코어 로그 확인
v2rayN 서버 목록에서 항목을 선택한 뒤 마우스 오른쪽 메뉴의 ‘활성 서버로 설정’ 또는 비슷한 기능을 사용해 활성화하세요. 일부 버전은 더블 클릭이나 단축키도 지원하므로 현재 화면의 안내를 확인하세요. 활성 표시가 선택한 항목으로 실제 이동했는지 확인하세요. 행이 강조 표시되었다는 이유만으로 판단하지 마세요. 강조된 행은 현재 선택 항목일 뿐, 코어에서 사용 중인 서버가 아닐 수 있습니다.
활성 서버를 바꾸면 보통 설정 생성과 코어 재로드가 진행됩니다. 사용 중인 버전에서 서비스를 별도로 시작하거나 다시 시작해야 한다면 해당 메뉴를 사용하세요. 그런 다음 하단 로그 영역에서 설정 로드 실패, 포트 사용 중, 코어 종료 등의 오류가 없는지 확인하세요. 로그에 수신 대기 정보가 표시되면 로컬 연결 지점이 준비된 것입니다. 하지만 이것만으로 원격 연결 성공을 확정할 수는 없으므로 실제 요청으로 확인해야 합니다.
설정에서 로컬 수신 대기 포트를 찾아 현재 SOCKS 주소와 포트를 기록하세요. 예를 들어 127.0.0.1:10808을 사용할 수 있지만, 클라이언트 버전이나 이전 설정에 따라 값이 다를 수 있으므로 실제 화면을 기준으로 하세요. 구독에 표시된 원격 서버 포트를 브라우저 프록시 설정에 입력하지 마세요. 브라우저는 로컬 클라이언트에 연결하고, 클라이언트가 설정에 따라 원격 서버에 연결합니다.
로그에 포트 사용 중이라는 메시지가 표시되면 클라이언트를 중복 실행했거나 다른 로컬 프록시 프로그램이 작동 중인지 확인하세요. 필요하지 않은 프로그램을 먼저 종료한 뒤 현재 서비스를 다시 시작하세요. 포트를 변경해야 한다면 새 값을 저장하고 해당 주소를 직접 입력한 모든 앱의 설정도 함께 수정하세요. 코어가 정상적으로 실행된 뒤 ‘시스템 프록시 설정’을 선택하세요. 이때 클라이언트는 계속 실행해 두세요. 창을 닫아도 프로세스가 종료되는지는 클라이언트 설정에 따라 다릅니다.
v2rayNG에서 연결 권한 확인
v2rayNG 목록에서 서버를 선택하고 활성 표시를 확인한 뒤 메인 화면의 연결 버튼을 누르세요. 처음 시작할 때는 보통 시스템에 VPN 연결 요청이 표시됩니다. 안내를 읽고 승인해야 시스템 인터페이스가 만들어집니다. 이후 클라이언트 연결 상태와 시스템 상태 표시를 확인하세요. 권한 요청을 거부하면 서비스가 앱 트래픽을 예상대로 받지 못하므로 연결을 다시 시작해 권한을 승인해야 합니다.
연결 버튼이 연결됨으로 표시되는데도 요청이 실패한다면 로그를 열어 해당 시간의 오류를 확인하세요. 서버와 코어를 연달아 바꾸지 마세요. 먼저 선택한 서버, 라우팅 모드, 오류 내용을 기록한 뒤 확인 단계로 넘어가세요. 시스템 연결 아이콘은 인터페이스가 실행 중임을 나타낼 뿐, 원격 서버가 요청을 받아들였다는 뜻은 아닙니다.
4. 실제 요청이 적용되는지 확인
브라우저 결과와 로그 대조
클라이언트 로그 창을 열어 둔 상태에서 브라우저로 접속 가능한 HTTPS 페이지를 방문하세요. 익숙한 고정 주소를 사용하고 페이지를 새로 고치거나 새로 열어 캐시된 내용만 보는 일을 피하세요. 요청을 보낸 시간을 기록한 뒤 로그에 해당 대상이나 연결 기록이 있는지 확인하세요. 페이지가 정상적으로 열리고 로그에 요청 근거가 함께 남는지 확인하는 것이 연결 버튼이나 지연 시간 수치만 보는 것보다 정확합니다.
요청이 어떤 아웃바운드로 나갔는지도 확인해야 합니다. 분할 라우팅 규칙을 사용하면 일부 대상은 직접 연결될 수 있으며, 이는 규칙에 따른 정상 동작입니다. 직접 연결된 페이지가 열렸다고 해서 프록시를 통한 아웃바운드가 확인된 것은 아닙니다. 로그 상세 수준에 따라 표시되는 내용이 다르므로 대상 기록이 보이지 않아도 현재 설정에서 접속 정보가 기록되지 않을 수 있습니다. 로그 수준을 일시적으로 높였다면 확인 후 원래대로 되돌리고, 로그를 공유하기 전에 서버 주소, 구독 링크 등 민감한 정보를 가리세요.
클라이언트 내장 연결 테스트는 성공했는데 브라우저 요청이 보이지 않는다면 브라우저가 시스템 프록시를 사용하는지, 확장 프로그램이나 별도 프록시 설정이 시스템 설정을 덮어쓰는지 먼저 확인하세요. 특정 앱에서만 적용되지 않는다면 클라이언트를 바로 재설치하지 말고 해당 앱의 프록시 지원 여부와 연결 설정을 점검하세요. 시스템 프록시가 모든 프로그램에 적용되는 것은 아닙니다. 연결 범위를 넓혀야 한다면 TUN 모드 설정 안내를 확인하세요.
필요하면 로컬 연결 지점을 따로 테스트
터미널 사용에 익숙하고 기기에 curl이 설치되어 있다면 다음 명령으로 로컬 SOCKS 연결 지점을 확인할 수 있습니다. 이 명령은 로컬 포트가 10808인 경우를 전제로 합니다. 화면에 다른 포트가 표시되면 먼저 값을 바꾸세요. 예시용 예약 도메인으로 요청을 보내므로 결과는 대상 사이트의 상태와 현재 라우팅 규칙에 따라 달라질 수 있습니다.
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/
socks5h는 대상 호스트 이름을 SOCKS 프록시 쪽에서 해석하도록 하므로 브라우저 자체의 DNS 조회와 이 요청을 구분하는 데 유용합니다. HTTP 응답 헤더를 받았다는 것은 요청 경로에서 응답이 있었다는 뜻이지, 프록시 아웃바운드를 사용했다는 뜻은 아닙니다. 라우팅과 로그를 함께 확인하세요. 로컬 주소에 연결할 수 없다는 메시지가 나오면 수신 대기 포트와 서비스 상태를 먼저 확인하세요. 로컬 연결은 성공한 뒤 시간 초과가 발생한다면 원격 서버, 전송 설정, 네트워크 환경을 점검하세요.
Android에서도 같은 방식으로 확인하세요. 연결한 뒤 브라우저에서 새 요청을 보내고 v2rayNG로 돌아와 로그와 테스트 결과를 확인합니다. 화면이 켜져 있을 때는 정상인데 화면을 잠근 뒤 문제가 생긴다면 시스템 배터리 관리가 백그라운드 서비스를 제한하는지 확인하세요. 연결 테스트 한 번을 위해 모든 백그라운드 권한을 바꾸지 말고, 실제로 백그라운드 일시 중지가 원인인지 확인한 뒤 기기 설정을 조정하세요.
정상 작동 설정을 저장하고 연결 올바르게 종료
요청 경로가 예상대로 작동하는 것을 확인했다면 현재 활성 서버, 구독 그룹, 라우팅 설정을 유지하세요. 구독을 업데이트한 뒤에는 기존 활성 서버 항목이 남아 있는지 확인하세요. 목록이 바뀌면 서버를 다시 선택해야 할 수 있습니다. 분할 라우팅이나 DNS를 조정할 때는 한 번에 하나씩만 변경하고 같은 요청으로 다시 테스트하세요. 설정 항목을 직접 편집해야 한다면 V2Ray JSON 설정 매뉴얼을 참고하세요. 클라이언트가 생성한 설정의 모든 항목을 직접 관리할 필요는 없습니다.
데스크톱에서 사용을 마칠 때는 먼저 시스템 프록시를 해제한 뒤 클라이언트를 종료하세요. 그렇지 않으면 앱이 수신 대기를 중단한 로컬 포트에 계속 요청할 수 있습니다. Android에서는 v2rayNG의 중지 버튼으로 서비스를 종료하고 시스템 연결 상태가 해제되었는지 확인하세요. 전체 과정을 마치면 구독 업데이트, 프록시 연결 방식과 라우팅 확인, 서비스 시작, 실제 요청 확인의 네 가지 결과를 점검할 수 있어야 합니다. 어느 단계에서든 실패하면 해당 단계부터 문제를 해결하면 되며, 설치부터 다시 진행할 필요는 없습니다.