시작 가이드 / 첫 설정

v2rayN 설정 가이드
구독 가져오기와 연결 확인

‘구독 가져오기 → 프록시 모드 선택 → 연결 → 확인’ 순서로 기본 설정을 마칩니다. 약 10분 정도 잡아 두세요. 먼저 브라우저 접속을 확인한 뒤 TUN이나 사용자 지정 규칙을 설정하세요.

시작하기 전에 다운로드 센터에서 기기에 맞는 클라이언트를 선택해 메인 화면을 여세요. 사용할 권한이 있는 유효한 구독 주소나 단일 공유 링크도 필요합니다. 클라이언트는 설정을 읽고 연결을 만드는 프로그램으로, 설치만으로 사용할 수 있는 서버가 자동 생성되지는 않습니다. 이 사이트에서는 구독 주소를 제공하지 않습니다.

이 페이지에서는 첫 연결까지만 다룹니다. 오류가 계속되면 오류 메시지 원문을 보관하고 문제 진단을 참고하세요. 첫 설정 단계에서 DNS, 코어, 전송 매개변수를 한꺼번에 바꿀 필요는 없습니다.

단계 01 / 서버 목록에 항목 표시하기

구독 가져오기

먼저 받은 내용이 무엇인지 확인하세요. 구독 주소는 여러 설정을 업데이트할 수 있는 링크이고, 단일 공유 링크는 보통 프로토콜 이름으로 시작하며 서버 설정 하나에 해당합니다. 두 종류는 가져오는 메뉴가 다릅니다. 복사할 때는 가능하면 제공 페이지의 복사 버튼을 사용하고, 안내 문구나 줄바꿈, 끝의 문장 부호가 함께 선택되지 않도록 하세요. QR 코드로 받은 경우 구독인지 단일 설정인지 확인한 다음 해당하는 스캔 메뉴를 선택합니다.

v2rayN 메인 화면에서 ‘구독 그룹’을 열고 ‘구독 그룹 설정’으로 이동한 뒤 새 항목을 추가합니다. 알아보기 쉬운 이름(예: ‘일반 구독’)을 입력하고 전체 구독 주소를 주소 입력란에 붙여 넣으세요. 처음 설정할 때는 별도의 구독 변환이나 업데이트 프록시를 지정하지 않아도 됩니다. 기본값을 유지하세요. 주소가 중간에 잘리지 않았는지 확인한 뒤 저장하고 설정 창을 닫습니다. 이 단계에서는 주소만 등록한 것이므로 서버 목록이 비어 있어도 정상입니다.

v2rayN · 구독 설정 경로

구독 그룹 → 구독 그룹 설정 → 새로 만들기 → 저장

메인 화면으로 돌아와 방금 저장한 그룹을 선택하고 ‘현재 구독 업데이트’를 실행합니다. 아직 연결을 설정하지 않았다면 메뉴에서 ‘프록시를 사용하지 않고 업데이트’를 먼저 시도하세요.

업데이트가 끝나면 하단 정보 영역이나 로그 메시지를 확인하고, 메인 화면의 그룹 필터도 살펴보세요. 업데이트 완료 메시지가 떴는데 목록이 비어 있다면 먼저 방금 만든 그룹으로 전환하고 검색 조건을 지워 필터 때문에 숨겨진 것이 아닌지 확인합니다. 정상이라면 이름, 프로토콜, 주소 등의 항목이 표시됩니다. 항목이 나타나는 것과 실제 연결이 가능한 것은 별개입니다. 이 단계에서는 클라이언트가 구독 내용을 인식했는지만 확인합니다.

v2rayNG에서는 사이드 메뉴의 ‘구독 그룹 설정’을 열고 추가 버튼을 눌러 이름과 구독 주소를 입력한 뒤 저장합니다. 메인 화면으로 돌아와 더보기 메뉴에서 ‘구독 업데이트’를 실행하고 해당 그룹을 확인하세요. 단일 공유 링크를 받은 경우에는 전체 내용을 복사한 뒤 메인 화면 메뉴의 ‘클립보드에서 가져오기’를 사용하세요. 단일 링크를 구독 주소 입력란에 붙여 넣으면 안 됩니다. 데스크톱에서도 서버 메뉴에서 클립보드 가져오기를 사용할 수 있습니다.

업데이트에 실패하면 먼저 ‘주소 요청 실패’인지 ‘내용을 해석할 수 없음’인지 확인하세요. 전자는 주소의 유효 기간과 현재 네트워크에서 구독 주소에 접속할 수 있는지 점검해야 합니다. 후자는 복사한 내용이 일반 안내 페이지나 로그인 페이지가 아닌지 확인하세요. 사용할 수 있는 기존 연결이 없다면 ‘프록시를 통해 업데이트’를 선택해도 해결되지 않을 수 있습니다. 구독 업데이트 자체가 아직 연결되지 않은 프록시에 의존하기 때문입니다. 네트워크를 바꿔 확인할 때는 한 번만 비교하고, 같은 그룹을 반복해서 만들지 마세요.

구독 주소에는 개인 접속 정보가 포함될 수 있으므로 전체 주소를 공개 댓글이나 스크린샷에 올리지 마세요. 먼저 로컬에 기록해 두고, 문제를 공유할 때는 주소에 포함된 식별 정보를 가리세요. 구독과 단일 설정의 차이는 용어 설명을, 빈 목록이나 업데이트 실패는 FAQ의 설치 및 설정 문제를 참고하세요. 목록에 항목이 있는지 확인한 뒤 프록시 모드를 설정하면 됩니다. 모든 서버의 속도를 먼저 측정할 필요는 없습니다.

단계 02 / 앱 연결과 라우팅 구분하기

프록시 모드 선택

서버 목록을 준비했다면 먼저 앱이 요청을 클라이언트에 전달하는 방식을 정합니다. 데스크톱 브라우저를 처음 테스트할 때는 ‘시스템 프록시 자동 설정’이 가장 확인하기 쉽습니다. v2rayN 메인 화면이나 트레이 메뉴에서 이 항목을 선택하고 클라이언트를 계속 실행해 두세요. 현재 시스템의 프록시 설정을 적용해 시스템 프록시를 따르는 앱이 클라이언트의 로컬 수신 주소를 사용하도록 합니다. 모든 앱의 모든 연결이 자동으로 전달된다는 뜻은 아닙니다.

같은 메뉴의 ‘시스템 프록시 지우기’는 시스템 프록시 설정을 해제합니다. ‘시스템 프록시 변경 안 함’은 기존 설정을 그대로 두는 옵션이지 프록시를 끄는 기능이 아닙니다. 다른 프록시 프로그램을 사용했다면 먼저 종료해 시스템 설정을 서로 덮어쓰지 않도록 하세요. 브라우저에서 별도의 프록시 확장 프로그램을 사용 중이라면 테스트하는 동안 사용 중지하고, 한 가지 경로만 유지하세요.

라우팅 설정: 우선 중국 본토 우회 선택

다음으로 v2rayN의 라우팅을 확인하고, 처음에는 내장된 ‘중국 본토 우회’ 규칙을 사용해 보세요. 시스템 프록시는 ‘앱이 요청을 전달하는가’를 정하고, 라우팅은 ‘전달된 요청을 어떤 출구로 보낼 것인가’를 정합니다. 중국 본토 우회는 보통 중국 본토 도메인이나 IP 규칙에 해당하는 연결은 직접 연결하고, 나머지는 규칙에 따라 프록시로 전달합니다. 실제 동작은 현재 클라이언트의 규칙 세트와 규칙 적용 순서에 따라 달라집니다. 시스템 프록시 모드와 라우팅 모드는 같은 스위치가 아닙니다.

처음에는 내장 규칙을 그대로 사용하면 됩니다. geosite, geoip 또는 사용자 지정 DNS를 한꺼번에 편집할 필요는 없습니다. 전역 프록시로 바꿔도 작동하지 않는 서버가 복구되지는 않습니다. 바뀌는 것은 라우팅 선택뿐입니다. 기본 연결이 정상인데 특정 사이트의 연결 경로가 예상과 다를 때 규칙과 로그를 확인하세요. direct, proxy 같은 용어가 헷갈리면 라우팅 및 분할 터널링 용어를 참고하고, 세부적인 규칙 매칭 문제는 문제 진단에서 확인하세요.

TUN 모드: 첫 확인에서는 끄기

TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 시스템 프록시를 따르지 않는 앱에 유용하지만, 권한과 가상 인터페이스, 네트워크 라우팅 같은 추가 조건이 필요합니다. 브라우저만 처음 테스트할 때는 v2rayN의 TUN을 꺼 두세요. 그러면 문제가 생겨도 구독, 활성 서버, 시스템 프록시 범위에서 원인을 찾을 수 있어 가상 인터페이스 생성 여부까지 함께 살펴보지 않아도 됩니다.

이후 브라우저 접속이 확인되면 필요에 따라 TUN을 켜고 시스템 안내에 따라 필요한 권한을 허용하세요. 켠 뒤에는 다시 연결을 확인해야 합니다. 스위치가 켜져 있다는 이유만으로 정상 작동을 판단하면 안 됩니다. 다른 VPN이나 가상 네트워크 도구가 실행 중이라면 네트워크 라우팅을 두고 충돌하는지 확인하세요. 확실하지 않다면 다른 도구를 잠시 끊고 단독으로 테스트합니다. 권한 오류는 메시지 내용에 따라 처리하고, 스위치를 계속 켰다 끄며 해결하려 하지 마세요.

v2rayNG는 Android 시스템의 VPN 서비스를 통해 연결하므로 데스크톱의 ‘시스템 프록시 자동 설정’을 찾을 필요가 없습니다. 처음에는 기본 앱 적용 범위와 라우팅 설정을 유지하고, 테스트할 브라우저를 제외 목록에 넣지 마세요. 앱별 우회 목록에 추가하면 일부 앱의 트래픽이 클라이언트로 전달되지 않아 연결이 작동하지 않는 것처럼 보일 수 있습니다. 여기까지는 연결 방식을 선택한 단계입니다. 다음으로 실제 연결에 사용할 서버를 지정해야 합니다.

단계 03 / 서버를 활성화하고 시작 상태 확인

서버를 선택하고 연결 시작

v2rayN 메인 화면으로 돌아와 방금 업데이트한 그룹에서 현재 유효한 서버 하나를 선택하세요. 마우스 오른쪽 버튼 메뉴의 ‘활성 서버로 설정’ 또는 이에 해당하는 활성화 기능을 사용해 현재 서버로 지정합니다. 목록에서 한 줄을 클릭하는 것은 단순 선택일 수 있으며, 활성 서버가 변경된 것은 아닐 수 있습니다. 활성 표시나 상태 영역이 바뀌는지 확인하세요. 행의 배경색이 강조됐다는 이유만으로 판단하지 마세요.

v2rayN은 활성 설정을 적용한 뒤 보통 코어를 시작하거나 다시 불러옵니다. Android 화면처럼 눈에 띄는 연결 버튼이 항상 있는 것은 아닙니다. 서버를 활성화한 뒤 메인 화면의 로그나 정보 영역을 열어 곧바로 시작 실패 메시지가 뜨지 않는지 확인하세요. 앞서 선택한 ‘시스템 프록시 자동 설정’도 계속 적용되어 있어야 합니다. 창은 최소화해도 되지만 프로세스를 종료하지 마세요.

코어 시작 메시지는 로컬 프로그램이 실행되기 시작했다는 뜻일 뿐, 원격 서버를 사용할 수 있다는 증거는 아닙니다. 브라우저가 실제 요청을 보낼 때 연결이 시작되는 경우도 있으므로 메인 화면에 트래픽이 바로 표시되지 않아도 반드시 오류는 아닙니다. 포트 충돌, 권한 부족, 설정 해석 오류가 로그에 명확히 표시되면 여기서 멈추고 로컬 시작 문제부터 해결하세요. 다른 프로그램이 이미 사용 중인 수신 포트는 서버를 바꿔도 해결되지 않습니다.

구독에 여러 설정이 있다면 제공자가 유효하다고 표시한 항목 하나를 선택해 실제 연결을 테스트하세요. 연결 테스트 시간이 초과됐다는 것은 해당 탐색이 완료되지 않았다는 뜻일 뿐입니다. 테스트 대상, 현재 네트워크, 서버 자체가 원인일 수 있으므로 숫자 하나만 보고 결론을 내리지 마세요. 첫 연결의 목표는 실제 웹페이지에 접속되는지 확인하는 것이지, 지연 시간이 가장 짧아 보이는 서버를 고르는 것이 아닙니다.

v2rayNG 메인 화면에서 사용할 서버를 선택한 다음 연결 버튼을 누릅니다. 처음 연결할 때 Android 시스템의 VPN 연결 요청이 표시되면 요청을 보낸 앱을 확인하고 승인하세요. 클라이언트로 돌아와 연결 버튼이나 상태 표시가 실행 중으로 바뀌었는지 확인합니다. 이미 다른 VPN에 연결되어 있다면 시스템에서 현재 연결을 교체하라는 메시지가 표시될 수 있습니다. 승인한 뒤 테스트하세요. 두 앱이 하나의 시스템 VPN 연결을 동시에 사용할 수 있다고 생각하지 않도록 주의하세요.

연결 버튼을 켠 직후 바로 중지 상태로 돌아가면 먼저 v2rayNG 로그를 열어 시작 시점에 가장 가까운 오류를 기록하세요. 백그라운드로 전환한 뒤에만 연결이 끊긴다면 해당 앱의 백그라운드 실행 및 배터리 제한 설정을 확인합니다. 백그라운드 실행을 조정하기 전에 화면이 열린 상태에서 접속을 확인하면 ‘연결 자체가 되지 않음’과 ‘시스템이 백그라운드에서 중지함’을 구분할 수 있습니다.

현재 서버는 그대로 둔 채 브라우저로 이동해 다음 확인을 진행하세요. 다른 사람에게 문제를 설명해야 한다면 ‘구독 가져오기 여부, 활성 서버 전환 여부, 코어 시작 여부, 시스템 프록시 또는 VPN 활성화 여부’ 네 가지를 기록해 두면 좋습니다. 원본 설정 전체를 공유하지 마세요. 특히 주소, 사용자 식별자, 비밀번호가 포함된 항목은 공개하지 마세요. 로그를 공유할 때도 개인 정보가 보이지 않도록 먼저 가리세요.

단계 04 / 실제 접속으로 작동 확인

작동 여부 확인

먼저 브라우저를 열고 별도의 프록시 확장 프로그램이 시스템 설정을 덮어쓰지 않는지 확인하세요. 현재 프록시로 접속해야 하는, 정상 작동이 확인된 페이지를 새 탭에서 다시 불러옵니다. 캐시에 남은 페이지를 보는 것만으로 판단하지 마세요. 이어서 평소 직접 접속되는 페이지도 열어 두 페이지가 모두 정상적으로 로드되는지 확인합니다. 첫 번째 페이지는 프록시 경로를, 두 번째 페이지는 일반 접속에 문제가 생기지 않았는지 확인하는 용도입니다.

‘중국 본토 우회’ 라우팅을 사용한다면 일반 직접 연결 페이지가 열리는 것만으로 프록시가 작동한다고 판단할 수 없습니다. 해당 연결은 원래 프록시를 우회할 수 있기 때문입니다. 반대로 브라우저에서 페이지 하나가 열리지 않는다고 클라이언트 전체가 작동하지 않는다고 단정할 수도 없습니다. 대상 사이트가 일시적으로 다운됐을 수 있습니다. 같은 주소를 반복해서 새로 고치는 것보다 정상 작동이 확인된 서로 다른 대상 두 곳을 비교하는 편이 낫습니다.

확인하는 동안 클라이언트 로그도 살펴보세요. 페이지 접속 시각과 로그 시각이 비슷하고 해당 대상이나 출구 기록이 있으면 요청이 클라이언트로 전달됐는지 판단하는 데 도움이 됩니다. 코어와 로그 수준에 따라 표시되는 내용은 다릅니다. 개별 접속 로그가 보이지 않는다고 곧바로 가장 상세한 로그 수준으로 올릴 필요는 없습니다. 먼저 명확한 오류가 있는지 확인하고 방금 접속한 페이지와 대조하세요. 오래전에 기록된 오류를 현재 문제로 착각하지 마세요.

증상에 따라 다음 확인 항목 선택
확인된 증상 먼저 확인할 항목 다음에 할 작업
브라우저 접속 실패, 클라이언트에 관련 요청 기록 없음 시스템 프록시, 브라우저 확장 프로그램, Android 앱 우회 목록 브라우저 요청이 클라이언트로 전달되는지 먼저 확인
요청 기록은 있지만 연결 시간 초과가 반복됨 현재 서버의 유효성 및 네트워크 연결 가능 여부 유효한 것으로 확인된 서버 하나만 바꿔 다시 시도
브라우저는 정상인데 특정 앱만 접속 실패 앱이 시스템 프록시를 따르는지 또는 우회 목록에 포함됐는지 앱 연결 방식을 확인한 뒤 TUN 사용 검토
시작 직후 오류 발생, 웹페이지 접속 전 로컬 포트, 권한, 설정 항목 시작 오류부터 해결한 다음 웹페이지 접속을 다시 테스트

프록시를 끈 상태와 비교하려면 데스크톱에서는 먼저 ‘시스템 프록시 지우기’를 선택한 뒤 브라우저의 새 탭에서 같은 페이지를 여세요. Android에서는 v2rayNG 연결을 끊은 뒤 다시 접속합니다. 비교가 끝나면 원래 설정을 복구하세요. 브라우저에 기존 연결이 남아 있거나 페이지가 캐시에서 열릴 수 있으므로 프록시를 끈 뒤에도 페이지가 열렸다고 해서 프록시가 전혀 사용되지 않았다고 단정할 수는 없습니다. 필요하면 브라우저를 완전히 종료한 뒤 다시 열어 테스트하세요.

브라우저는 정상인데 특정 데스크톱 앱만 접속할 수 없다면 구독을 다시 가져오지 마세요. 먼저 해당 앱 자체의 프록시 설정과 시스템 프록시 사용 여부를 확인하고, 그 다음 TUN이 필요한지 판단합니다. Android에서는 해당 앱이 우회 목록에 들어 있지 않은지 확인하세요. 기본 연결 경로를 확실히 파악한 뒤 DNS나 규칙 매칭을 살펴보세요. 그렇지 않으면 잘못된 설정 단계에서 매개변수를 바꾸게 됩니다.

두 종류의 페이지가 모두 정상적으로 열리고 클라이언트에서 시작 오류나 연결 오류가 계속 발생하지 않는다면 현재 설정을 기준 상태로 유지해도 됩니다. 구독 그룹, 활성 서버, 라우팅 이름만 기록해 두면 충분하며 설정 전체를 다른 곳에 복사할 필요는 없습니다. 나중에 기능 하나를 변경할 때는 같은 두 페이지로 다시 확인하세요. 문제가 생기면 직전 설정을 복원하면 변경 범위를 빠르게 좁힐 수 있습니다.

사용을 마치면 데스크톱에서 먼저 시스템 프록시를 해제한 다음 클라이언트를 종료하세요. 클라이언트가 중지된 뒤에도 시스템이 로컬 포트를 계속 가리키는 일을 막을 수 있습니다. TUN을 사용했다면 먼저 TUN을 끄고 시스템 네트워크가 정상으로 돌아왔는지 확인하세요. Android에서는 v2rayNG의 연결 끊기 버튼을 누르면 됩니다. 종료 후 모든 웹페이지 접속이 실패한다면 구독을 삭제하거나 프로그램을 다시 설치하기 전에 시스템에 프록시 설정이 남아 있는지 확인하세요.

구독 가져오기 단계로 돌아가기 ↑