v2rayN 설정 방법

v2rayN 설정 방법 구독 가져오기와 연결 확인

네 단계로 끝냅니다: 구독 링크 가져오기, 프록시 모드 선택, 연결 시작, 정상 작동 확인. 데스크톱은 v2rayN, 안드로이드는 v2rayNG를 예로 들며, 두 화면의 생김새는 달라도 기능 이름이 하나씩 대응되므로 자기 기기에 해당하는 문단만 따라 하면 됩니다.

구독 가져오기 라우팅 모드 시스템 프록시 연결 확인

데스크톱과 안드로이드의 화면 차이

데스크톱의 v2rayN은 창형 프로그램으로 상단 메뉴 막대, 가운데 서버 목록, 하단 상태 표시줄과 두 줄의 드롭다운으로 구성됩니다. 안드로이드의 v2rayNG는 모바일 앱으로 왼쪽 위 서랍 메뉴, 가운데 노드 목록, 오른쪽 아래 원형 연결 버튼을 씁니다. 두 쪽의 기능 이름은 거의 같아서 구독 설정, 라우팅 모드, 지연 시간 테스트가 그대로 대응됩니다. 아래 각 단계에서는 두 쪽의 조작 경로를 따로 제시하니, 자기 기기에 해당하는 문단만 따라 하면 되고 양쪽을 다 볼 필요는 없습니다.

시작하기 전에

준비해야 할 두 가지

이 가이드는 '클라이언트 설치 완료, 구독 링크 1개 보유' 상태에서 시작합니다. 이 두 가지가 아직 없다면 먼저 준비한 뒤 진행하세요.

클라이언트: 하나면 충분

데스크톱은 v2rayN을 쓰며 하나의 프로그램으로 Windows, macOS, Linux를 모두 지원합니다. 안드로이드는 v2rayNG를 사용합니다. 두 쪽의 설정 방식은 같고, 이 페이지의 각 단계마다 두 가지 경로를 제시하니 가진 기기에 맞는 쪽을 따라 하면 됩니다. 다운로드 페이지에는 플랫폼별 설치 파일 링크와 버전 설명, 시스템 요구 사항이 정리되어 있습니다.

다운로드 페이지로 이동

구독 링크: URL 한 줄

구독 링크는 서비스 제공자가 알려주는 https로 시작하는 전체 주소이며, 복사할 때 불필요한 공백이나 줄바꿈이 섞이지 않도록 주의합니다. 클라이언트는 이 주소를 받아 노드 목록을 직접 가져오므로, 노드가 바뀌면 구독만 다시 업데이트하면 됩니다. 노드를 하나씩 수동으로 추가할 필요가 없습니다. 링크에는 보통 여러 파라미터가 붙어 있으니 통째로 복사하면 됩니다.

구독과 노드 용어

조작 단계

네 단계로 설정 완료

각 단계는 '어디를 누르고, 무엇이 보이고, 다음에 무엇을 하는지' 순서로 적었습니다. 확인 지점을 통과한 뒤 다음 단계로 넘어가고, 중간에 막히면 먼저 이 페이지 끝의 자주 막히는 지점을 본 뒤 문제 해결 문서를 참고하세요.

01

구독 가져오기

구독 링크를 클라이언트에 넘기기

구독 가져오기의 핵심은 하나입니다. 서비스 제공자가 준 URL을 클라이언트에 넘기면 클라이언트가 노드 목록을 가져옵니다. 데스크톱과 안드로이드는 메뉴 이름이 다르지만 '구독 추가 → 구독 업데이트 → 노드 목록 확인' 순서는 같고, 이 세 가지를 마치면 이 단계는 끝입니다. 노드를 하나씩 수동으로 추가해도 되지만 노드가 바뀔 때마다 다시 해야 하므로, 이 가이드는 구독 방식만 다룹니다.

데스크톱 v2rayN

v2rayN 메인 창을 엽니다. 처음 실행하면 서버 목록은 비어 있습니다. 상단 메뉴에서 '구독'을 열고 '구독 설정'을 선택하면 구독 관리 창이 뜹니다. 창에서 '추가'를 누르고 '비고' 칸에 알아보기 쉬운 이름(예: 서비스 제공자 약칭)을 적습니다. '주소(URL)' 칸에 구독 링크를 붙여 넣고 불필요한 공백이 없는지 확인한 뒤 '확인'을 눌러 저장합니다. 비고는 목록에 표시되는 이름일 뿐이며, 무엇을 적든 노드 사용 여부에는 영향을 주지 않습니다.

구독 → 구독 설정 → 추가 → 확인

메인 창으로 돌아와 다시 '구독' 메뉴를 열고 '구독 업데이트'를 선택하면 클라이언트가 곧바로 가져오기를 시작합니다. 이 시도가 실패하면 같은 메뉴의 '구독 업데이트(프록시 경유)'로 다시 시도해 보세요. 이 옵션은 현재 노드를 거쳐 구독 내용을 가져온다는 점만 다르며, 구독 주소 자체가 직결로 접근하기 어려운 경우에 적합합니다. 업데이트가 끝나면 메인 창 서버 목록이 노드로 채워지고, 항목 수는 구독에 담긴 노드 수와 같으며 각 항목에 노드 이름, 프로토콜, 주소와 포트가 표시됩니다.

https://sub.example.com/api/v1/client/subscribe?token=xxxx

위 내용은 구독 링크의 형태를 보여주는 예시이며 도메인은 가짜 값이라 그대로 사용할 수 없습니다. 실제 링크는 서비스 제공자가 알려주며, 복사할 때 물음표 앞까지만이 아니라 전체를 복사해야 합니다.

안드로이드 v2rayNG

v2rayNG를 열고 왼쪽 위 메뉴 아이콘을 눌러 서랍을 펼친 뒤 '구독 설정'으로 들어갑니다. 오른쪽 위 '+'를 눌러 구독을 새로 만들고 '비고'에 서비스 제공자 약칭을, 'URL'에 구독 링크를 붙여 넣습니다. 이 구독이 사용 설정 상태인지 확인한 뒤 저장하고 메인 화면으로 돌아옵니다. 이어서 오른쪽 위 점 세 개 메뉴를 눌러 '구독 업데이트'를 선택하고 진행이 끝날 때까지 기다립니다.

메인 화면 노드 목록에 항목이 나타나면 아무 항목이나 길게 눌러 팝업 메뉴에서 지연 시간 테스트를 할 수 있습니다. 이 단계는 노드 데이터가 실제로 내려왔는지 확인하는 용도일 뿐이며, 테스트 결과는 이후 조작에 영향을 주지 않습니다. 숫자가 좋지 않아도 여기서 고민할 필요는 없고, 이런 숫자를 어떻게 보는지는 뒤의 4단계에서 다룹니다.

왼쪽 위 메뉴 → 구독 설정 → + → 구독 업데이트

확인 지점

노드 목록이 비어 있지 않고, 항목 수가 구독과 일치하며, 노드 이름을 읽을 수 있어야 합니다. 세 가지가 모두 충족되면 다음 단계로 넘어갑니다. 목록이 여전히 비어 있다면 구독 링크가 메신저에서 잘렸거나 불필요한 공백이 섞이지 않았는지 먼저 확인하고, 문제 해결 문서의 구독 실패 항목을 참고하세요.

02

모드 선택

어떤 트래픽을 프록시로 보낼지 결정

모드는 트래픽의 방향, 즉 어떤 트래픽이 프록시를 거치고 어떤 트래픽이 직접 연결되는지를 정합니다. 데스크톱 메인 창 하단에는 드롭다운이 한 줄 있는데 그중 '라우팅'이 모드 선택입니다. 안드로이드는 같은 옵션 묶음을 서랍 메뉴의 '설정' 안에 '라우팅 모드'라는 이름으로 넣어 두었습니다. 두 쪽 모두 의미가 비슷한 세 단계 옵션을 제공하며, 버전에 따라 옵션 문구가 조금 다를 수 있으니 의미를 기준으로 맞춰 고르면 됩니다.

모드트래픽 방향적합한 상황
전역모든 트래픽이 프록시를 거쳐 전달노드 사용 가능 여부 점검, 일시적으로 모든 트래픽을 프록시로 보낼 때
중국 본토 우회 / LAN 및 중국 본토 우회중국 본토 도메인과 IP는 직접 연결, 나머지 트래픽은 프록시 경유일상 사용, 중국 본토와 해외 접속이 서로 발목을 잡지 않게
직접 연결(프록시 미사용)전부 직접 연결, 클라이언트가 트래픽을 전달하지 않음대조 점검: 문제가 프록시 경로에 있는지 로컬 네트워크에 있는지 확인

일상적으로는 '중국 본토 우회' 또는 'LAN 및 중국 본토 우회'를 고르세요. 중국 본토 사이트는 직접 연결되어 프록시를 켜지 않았을 때와 같은 속도가 나오고, 해외 사이트는 노드를 거쳐 전달됩니다. 이렇게 하면 모드를 오갈 필요도 없고 중국 본토 트래픽이 한 바퀴 돌아오는 일도 없습니다. 안드로이드에서 프린터나 NAS 같은 LAN 기기까지 직접 연결로 유지하고 싶다면 'LAN 우회' 부분을 꼭 남겨 두세요.

점검이 필요할 때는 모드를 잠시 '전역'으로 바꾸고 해외 사이트를 열어 봅니다. 정상적으로 열리면 노드 자체는 쓸 수 있다는 뜻이므로 문제는 대개 분할 규칙 매칭에 있습니다. 열리지 않으면 문제 범위를 노드나 로컬 네트워크로 좁힐 수 있습니다. 확인이 끝나면 분할 모드로 되돌리고, 전역 상태로 오래 두지 마세요.

데스크톱: 하단 '라우팅' 드롭다운 / 안드로이드: 설정 → 라우팅 모드

모드를 바꾼 뒤에는 상태를 다시 확인

데스크톱에서 '라우팅' 드롭다운을 바꾸면 클라이언트가 새 규칙으로 코어 설정을 다시 만들며, 그동안 연결이 잠시 끊깁니다. 안드로이드에서 라우팅 모드를 바꾼 뒤에는 이전 규칙이 남아 있지 않도록 한 번 끊었다가 다시 연결하는 것이 좋습니다. 사용자 지정 규칙 작성법과 도메인·IP 매칭 순서는 고급 주제이므로, 이어서 블로그의 라우팅 규칙 설정 실전을 읽어 보세요.

03

연결 시작

노드를 고르고 트래픽 인계받기

연결 단계에서 하는 일은 두 가지입니다. 노드 하나를 출구로 고르고, 시스템이나 휴대폰이 트래픽을 클라이언트에 넘기게 합니다. 데스크톱은 시스템 프록시를, 안드로이드는 시스템 VPN 인터페이스를 사용하며, 둘 다 공유기를 건드릴 필요도 추가 구성 요소를 설치할 필요도 없습니다.

데스크톱 v2rayN

서버 목록에서 노드를 클릭하면 그 노드가 현재 출구가 됩니다. 대부분의 버전은 더블클릭으로 바로 활성 서버로 지정할 수 있고, 오른쪽 클릭 메뉴에도 같은 항목이 있습니다. 이어서 '시스템 프록시' 드롭다운을 찾아 '시스템 프록시 변경 안 함'에서 '시스템 프록시 자동 구성'으로 바꿉니다. 이 조작은 운영체제에 브라우저 등 프로그램의 트래픽을 로컬에서 수신 중인 클라이언트 포트로 넘기라고 알려 주는 것입니다.

브라우저 등 프로그램  →  로컬 수신 포트  →  클라이언트 코어  →  원격 노드

전환이 성공하면 메뉴 항목 앞에 체크 표시가 생기고 트레이 아이콘이 회색에서 켜진 상태로 바뀝니다. 버전마다 트레이 색이 조금씩 다르므로 판단 기준은 메뉴의 체크 상태와 로그 창 출력으로 삼고, 아이콘 색에 얽매일 필요는 없습니다. 잠시 끊어야 할 때는 '시스템 프록시'를 '시스템 프록시 변경 안 함'으로 되돌리면 되고, 노드 설정은 영향을 받지 않습니다.

안드로이드 v2rayNG

메인 화면으로 돌아와 오른쪽 아래 원형 버튼을 눌러 시작합니다. 처음 시작하면 시스템이 VPN 권한 대화상자를 띄우니 허용을 누릅니다. 이 권한은 안드로이드의 표준 절차이며, 클라이언트는 이를 통해 앱 트래픽을 인계받고 root 권한은 필요하지 않습니다. 시작에 성공하면 알림 표시줄에 상시 알림이 나타나고 메인 화면 버튼과 상태 문구도 함께 바뀝니다.

멈출 때는 원형 버튼을 한 번 더 누르거나 알림에서 바로 연결을 끊습니다. 한 번에 VPN 계열 앱 하나만 동작할 수 있다는 점에 주의하세요. 휴대폰에 같은 종류의 도구가 더 설치되어 있다면 먼저 모두 중지해야 합니다. 그렇지 않으면 서로 자리를 다투어 연결 상태가 왔다 갔다 합니다.

데스크톱: 시스템 프록시 → 시스템 프록시 자동 구성 / 안드로이드: 오른쪽 아래 원형 버튼

두 가지 인계 방식 비교

항목데스크톱 v2rayN안드로이드 v2rayNG
인계 방식시스템 프록시 설정시스템 VPN 인터페이스
시작 동작'시스템 프록시' 드롭다운 전환오른쪽 아래 원형 버튼 클릭
최초 권한없음시스템 VPN 권한 대화상자
상태 표시 위치트레이 아이콘과 메뉴 체크 표시알림 표시줄 상시 알림
중지 방법'시스템 프록시 변경 안 함'으로 되돌리기버튼을 한 번 더 누르거나 알림에서 연결 끊기

확인 지점

데스크톱은 트레이 아이콘이 켜지고 '시스템 프록시'가 '시스템 프록시 자동 구성'에 놓여 있어야 하며, 안드로이드는 알림 표시줄에 클라이언트 상태 알림이 나타나야 합니다. 둘 중 하나만 보인다면 나머지 하나를 채운 뒤 다음 단계로 넘어가세요.

04

작동 확인

트래픽이 실제로 프록시를 거치는지 확인

확인은 세 층으로 나눕니다. 출구가 바뀌었는지, 분할이 의도대로 동작하는지, 연결이 안정적인지입니다. 세 층을 모두 통과하면 설정이 끝난 것이고, 어느 한 층이라도 통과하지 못하면 아래 순서대로 되짚어 보세요. 설정을 한꺼번에 여러 개 바꾸지는 마세요.

출구 확인

브라우저를 열고 현재 출구 IP를 보여주는 페이지에 접속합니다. 연결 전후로 한 번씩 확인해 접속 지역이 로컬에서 노드가 있는 곳으로 바뀌었다면 트래픽이 실제로 프록시를 거친 것입니다. 여기서는 접속 지역이 바뀌었는지만 보면 되고, 구체적인 수치를 기록하거나 다른 사람의 결과와 비교할 필요는 없습니다. 노드와 시각이 다르면 결과가 다른 게 당연합니다.

분할 확인

'중국 본토 우회' 모드에서 중국 본토 사이트에 접속했을 때 속도가 프록시를 켜지 않았을 때와 비슷해야 합니다. 오히려 느려지거나 열리지 않는다면 분할이 동작하지 않은 것이므로, 2단계로 돌아가 라우팅 모드를 제대로 골랐는지, 바꾼 뒤 다시 연결했는지 확인하세요. 양쪽 모두 정상이라면 '중국 본토는 직결, 해외는 프록시'라는 경계가 제대로 선 것입니다.

로그와 지연 시간

데스크톱에서는 '보기'를 열고 '로그'로 들어갑니다. 정상 연결 시 로그에는 시작, 인바운드 수신, 아웃바운드 연결 세 종류의 기록이 시간 순서대로 출력됩니다. error나 failed 키워드가 보이면 기록 전체를 복사해 문제 해결 문서의 로그 항목과 대조해 원인을 찾고, 자주 나오는 오류의 의미는 블로그의 실행 로그 읽는 법에서 확인하세요. 안드로이드에서는 노드를 길게 눌러 지연 시간을 측정할 수 있는데, 이 숫자는 핸드셰이크 왕복 시간일 뿐 실제 다운로드 속도를 뜻하지는 않습니다. 세 가지 수치의 차이는 지연 시간 테스트 세 가지 수치 비교를 참고하세요.

확인 지점

출구 접속 지역이 바뀌고, 중국 본토 사이트 속도가 정상이며, 클라이언트 상태가 실행 중으로 표시되어야 합니다. 세 가지가 모두 충족되면 네 단계 흐름은 여기서 끝입니다. 하나라도 충족되지 않으면 증상에 따라 문제 해결 문서에서 해당 항목을 찾으세요. 인터넷 연결 불가, 노드 시간 초과, 속도 저하, 시스템 프록시 미적용이 각각 별도 항목으로 정리되어 있습니다.

자주 막히는 지점

네 단계에서 가장 자주 멈추는 곳

아래 네 가지는 가이드 피드백에서 가장 자주 나온 상황입니다. 여기에 없는 증상은 문제 해결 문서의 항목에서 바로 찾아보세요.

구독 업데이트는 성공했는데 노드 목록이 여전히 비어 있다면?

먼저 구독 링크가 메신저에서 줄바꿈 잘리지 않은 온전한 URL인지, 앞뒤에 불필요한 공백이 없는지 확인합니다. 데스크톱에서는 '구독 업데이트(프록시 경유)'로 다시 가져와 볼 수 있고, 안드로이드에서는 해당 구독이 사용 설정 상태인지 확인하세요. 그래도 비어 있다면 링크를 브라우저 주소창에 단독으로 붙여 넣어 한 번 열어 보세요. 내용이 나온다면 링크 자체는 쓸 수 있다는 뜻이므로 문제는 클라이언트 쪽에 있습니다.

데스크톱 브라우저에서 페이지가 열리지 않는데 클라이언트는 실행 중이라고 나온다면?

먼저 '시스템 프록시' 드롭다운이 '시스템 프록시 변경 안 함'에 놓여 있지 않은지 보세요. 코어가 돌고 있다고 해서 시스템 트래픽이 이미 인계된 것은 아닙니다. 다음으로 다른 프록시 계열 프로그램이 동시에 시스템 프록시 설정을 바꾸고 있지 않은지 확인하세요. 두 쪽이 서로 설정을 덮어씁니다. 마지막으로 라우팅 모드를 잠시 '전역'으로 바꿔 시도해 보세요. 열리면 분할 규칙 매칭 문제이고, 그래도 열리지 않으면 로그와 노드 상태를 확인하세요.

안드로이드에서 시작할 때마다 VPN 권한을 다시 허용해야 한다면?

권한 대화상자는 최초 시작 시 또는 시스템이 권한 기록을 정리한 뒤에만 나타나며, 보통은 한 번만 허용하면 됩니다. 매번 다시 눌러야 한다면 대개 절전 정책이 클라이언트 백그라운드 프로세스를 정리한 탓입니다. 시스템 배터리 설정에서 v2rayNG를 제한 없음 목록에 추가하고 백그라운드 실행을 허용한 뒤 한동안 지켜보세요.

데스크톱과 안드로이드의 설정 항목이 달라서 어떻게 맞춰 보나요?

두 쪽의 이름 체계는 다르지만 기능은 하나씩 대응됩니다. 데스크톱의 '구독 설정'은 안드로이드의 '구독 설정'에, 데스크톱 하단의 '라우팅'은 안드로이드 설정의 '라우팅 모드'에, 데스크톱의 '시스템 프록시'는 안드로이드 시작 시의 VPN 권한에 대응됩니다. 글자 그대로가 아니라 기능을 기준으로 찾아보세요. 그래도 헷갈리면 이 페이지 앞부분의 화면 차이 설명을 다시 보면 됩니다.