QUICKSTART / 10 MINUTES

v2rayN 설정 가이드: 구독, 모드, 연결 및 확인

유효한 V2Ray 구독 링크를 준비하고 4단계로 첫 연결을 완료하세요. 이 가이드는 실제로 눌러야 할 메뉴에 집중하며 복잡한 라우팅 문법은 다루지 않습니다. DNS, TUN, FakeDNS 또는 여러 구독 그룹을 조정하려면 고급 매뉴얼로 이동하세요.

4단계 작업 v2rayN 데스크톱 v2rayNG Android

STEP INDEX

4단계 설정 순서

순서대로 설정을 완료하세요. 다음 단계에서 문제가 생기면 먼저 이전 단계로 돌아가 화면 상태를 확인하고, 서버·라우팅·DNS를 동시에 변경하지 마세요.

BEFORE START

시작 전: 클라이언트, 구독 주소와 시스템 시간

입력 조건을 먼저 확인하면 이후 단계에서 설정을 반복해서 바꾸는 일을 줄일 수 있습니다.

INPUT / 01

클라이언트와 시스템 호환 여부 확인

데스크톱에서는 v2rayN을, Android 기기에서는 v2rayNG을 우선 사용합니다. 아직 설치하지 않았다면 다운로드 페이지에서 Windows, macOS, Android 또는 Linux에 맞는 설치 패키지를 선택하세요. 설치 후 클라이언트를 실행하고, 당분간 코어·포트·고급 라우팅 설정은 변경하지 마세요.

플랫폼에 맞는 클라이언트 선택 →
INPUT / 02

전체 구독 주소 복사

구독 주소는 보통 https://로 시작하는 전체 링크이며, 구독 식별용 매개변수가 포함될 수 있습니다. 복사할 때 끝 문자를 빠뜨리지 말고, 웹 관리 콘솔 주소·개별 노드 이름·QR 코드 안내 문구를 구독 링크로 착각하지 마세요.

형식 예시

https://example.com/subscription?token=xxxx
INPUT / 03

시스템 시간 동기화

일부 전송 설정은 기기 시간 오차에 민감합니다. 시작하기 전에 시스템의 자동 날짜 및 시간 기능을 켜고 시간대가 올바른지 확인하세요. 기기 시간이 크게 틀리면 서버를 가져오고 네트워크도 정상인데 연결 핸드셰이크가 실패할 수 있습니다.

고급 문제 해결 경로 보기 →

IMPORT / UPDATE

구독을 가져와 서버 목록 확인

이 단계의 완료 기준은 주소가 저장된 것이 아니라 메인 화면에 선택 가능한 서버 항목이 나타나는 것입니다.

v2rayN 데스크톱: 구독 그룹 만들기

v2rayN 메인 창을 열고 상단 메뉴에서 “구독 그룹” 또는 구독 관리 메뉴를 찾습니다. 버전에 따라 메뉴 이름은 조금 다를 수 있지만, 새 구독 추가·구독 관리·구독 업데이트 기능은 모두 제공됩니다. 관리 창에서 추가를 선택하고 “일상용 회선”처럼 알아보기 쉬운 메모를 입력하세요. 메모는 로컬 그룹 구분용이며 서버 설정을 변경하지 않습니다.

전체 구독 주소를 주소 입력란에 붙여넣고 저장합니다. 메인 창으로 돌아온 뒤 구독 메뉴를 다시 열어 “모든 구독 업데이트”를 실행하거나 새로 만든 그룹만 선택해 업데이트하세요. 업데이트가 끝나면 메인 창의 서버 목록에 이름, 주소 유형 또는 전송 방식 등의 항목이 표시됩니다. 바로 연결하지 말고 목록에서 한 행을 클릭해 선택되고 현재 활성 서버가 되었는지 확인하세요.

저장 후에도 목록이 비어 있으면 먼저 하단 상태 영역이나 로그 창을 확인하세요. 주소 형식 오류가 표시되면 원본 링크를 다시 복사하고, 요청 시간이 초과되면 일반 네트워크가 정상인지 확인한 뒤 클라이언트의 프록시를 통한 업데이트 옵션을 시도할 수 있습니다. 처음 사용하며 현재 작동하는 프록시 연결이 없다면 프록시 업데이트를 무작정 켜지 마세요. 업데이트 요청이 사용할 출발 경로를 찾지 못할 수 있습니다.

v2rayNG Android: 구독 설정 추가

v2rayNG을 열고 왼쪽 상단 사이드 메뉴를 펼쳐 “구독 설정”으로 이동합니다. 오른쪽 상단의 추가 버튼을 눌러 메모를 입력하고 구독 주소를 붙여넣은 뒤 저장합니다. 구독 설정 목록으로 돌아와 새 항목이 활성화되어 있는지 확인하고, 오른쪽 상단 메뉴에서 구독 업데이트를 실행하세요. 업데이트가 끝나면 메인 화면으로 돌아가 하나 이상의 설정 항목이 표시되는지 확인합니다.

설정 항목 하나를 눌러 현재 선택된 항목으로 표시되게 합니다. 구독 설정 화면에만 머물러서는 안 됩니다. 구독 주소는 설정의 출처이고 실제 연결 대상은 메인 화면의 서버 항목입니다. 업데이트 성공 메시지가 표시됐는데 메인 화면이 바뀌지 않으면 메인 화면 메뉴에서 새로 고침을 실행하거나 구독 항목이 비활성화되지 않았는지 확인하세요.

다음 단계 전 확인

  • 구독 관리 화면에서 저장된 이름과 주소를 확인할 수 있습니다.
  • 업데이트 후 메인 화면에 하나 이상의 선택 가능한 서버 항목이 나타납니다.
  • 현재 서버가 선택되어 있으며 목록 위에 마우스나 포커스만 둔 상태가 아닙니다.

SERVER / ROUTING

서버와 프록시 모드 선택

서버는 트래픽을 보낼 회선을 결정하고, 프록시 모드는 어떤 요청을 해당 회선으로 보낼지 결정합니다. 처음에는 변수를 줄인 뒤 규칙을 단계적으로 세분화하세요.

활성 서버 하나를 먼저 고정

서버 목록에서 설정 하나를 선택합니다. v2rayN에서는 보통 목록 행을 두 번 클릭하거나 마우스 오른쪽 버튼으로 활성 서버로 지정하거나 Enter 키를 눌러 선택할 수 있습니다. v2rayNG에서는 메인 화면의 설정 항목을 바로 누르면 됩니다. 선택 후 강조 표시나 상단의 현재 설정 이름을 확인해 다음에 시작할 서버가 이전에 사용한 오래된 설정이 아닌지 확인하세요.

구독에 여러 회선이 포함되어 있어도 처음부터 계속 바꿀 필요는 없습니다. 하나를 고정해 전체 과정을 완료하고, 실패하면 다른 회선으로 비교 테스트를 진행하세요. 이렇게 하면 문제가 특정 서버에 있는지, 시스템 프록시·권한·라우팅 설정에 있는지 판단할 수 있습니다. 속도 측정 결과는 서버 선택 참고 자료일 뿐 실제 연결 확인을 대신할 수 없습니다.

규칙 분할, 전역 프록시와 직접 연결

규칙 분할은 도메인, IP, 포트 또는 규칙 세트에 따라 출발 경로를 결정하며 일상적인 사용에 적합하고 최초 설정에도 권장되는 모드입니다. 일반적인 로컬 서비스는 직접 연결로 유지하고 프록시가 필요한 대상만 프록시 출발 경로로 보냅니다. 이 모드는 라우팅 규칙의 품질에 영향을 받으므로 특정 웹사이트만 비정상일 때는 먼저 규칙 적중 여부를 확인하세요.

전역 프록시는 클라이언트가 연결한 트래픽을 모두 현재 프록시 출발 경로로 보냅니다. 짧은 시간 동안 비교 테스트를 할 때 유용합니다. 규칙 모드에서는 대상이 열리지 않지만 전역 모드에서 열리면 연결 자체는 정상이고 분할 규칙이나 DNS 경로에 문제가 있을 가능성이 큽니다. 전역 모드는 문제 해결의 최종 상태가 아니므로 원인을 확인한 뒤 필요에 따라 규칙 분할로 되돌리세요.

직접 연결은 트래픽이 프록시 출발 경로를 거치지 않도록 하며 프록시를 일시 중지하거나 로컬 네트워크를 확인할 때 사용합니다. 직접 연결을 선택하면 클라이언트 코어가 실행 중이어도 예상한 프록시 접속 결과가 나오지 않습니다. “연결됨으로 표시되지만 달라진 점이 없는” 문제를 확인할 때는 먼저 직접 연결 모드가 아닌지 확인하세요.

데스크톱 시스템 프록시와 Android 연결 방식

v2rayN에서는 시스템 프록시를 사용할 수 있는 상태로 전환해야 합니다. 일반적인 옵션으로는 시스템 프록시 자동 설정, 시스템 프록시 해제, 시스템 프록시 변경 안 함이 있습니다. 처음에는 자동 설정을 선택하면 시스템 프록시를 따르는 브라우저와 앱의 요청이 v2rayN으로 전달됩니다. 코어만 시작하고 시스템 프록시를 설정하지 않으면 로그에는 코어가 정상 실행 중으로 표시되어도 브라우저 트래픽은 클라이언트로 들어오지 않을 수 있습니다.

v2rayNG은 시스템 연결 권한을 통해 트래픽을 연결하므로 데스크톱 시스템 프록시 주소를 따로 입력할 필요가 없습니다. 연결할 때 시스템에 권한 승인 창이 나타나며, 허용하면 상태 표시줄에 연결 표시가 나타납니다. 이전에 권한을 거부했다면 연결을 다시 누르고 시스템 안내에 따라 승인하세요.

모드 주요 용도 최초 설정 권장 사항
규칙 분할 라우팅 규칙에 따라 프록시 또는 직접 연결 사용 일상 사용의 기본값
전역 프록시 현재 프록시 출발 경로를 일괄 사용 짧은 시간 동안 비교 문제 해결에 사용
직접 연결 트래픽이 프록시 출발 경로로 들어가지 않음 프록시 일시 중지 또는 로컬 네트워크 확인에 사용

START / OBSERVE

연결 시작 및 실행 상태 확인

연결 버튼은 시작 동작일 뿐입니다. 실제로 확인할 것은 코어가 실행 중인지, 트래픽 입구가 연결되었는지, 로그에 반복 오류가 없는지입니다.

v2rayN: 서비스 시작 및 시스템 프록시 설정

서버 목록에 활성 항목이 있는지 확인한 뒤 메인 창 하단 상태 영역, 작업 표시줄 메뉴 또는 상단 메뉴에서 서비스를 시작합니다. 이어 시스템 프록시를 자동 설정으로 전환하거나 현재 모드에 맞는 상태로 설정하세요. 버전에 따라 “서비스 시작”과 “시스템 프록시 설정”이 하나의 동작으로 묶여 있거나 별도 메뉴로 나뉘어 있을 수 있습니다. 실행 후 작업 표시줄 아이콘 상태와 메인 창 하단의 문구를 함께 확인하세요.

로그 패널을 열면 정상적으로 시작될 때 설정 로드, 인바운드 리스닝과 코어 시작 관련 기록이 표시됩니다. 로그의 로컬 포트는 클라이언트와 시스템 사이에서 트래픽을 전달하는 포트이며 서버 포트를 의미하지 않습니다. 구독 내용과 맞추려고 로컬 리스닝 포트를 임의로 변경하지 마세요. 포트가 사용 중이라는 로그가 표시되면 중복 실행 중인 클라이언트 프로세스를 완전히 종료한 뒤 다시 시작하고, 계속 충돌하면 설정에서 다른 프로그램이 사용하지 않는 로컬 포트로 변경하세요.

v2rayNG: 연결을 누르고 권한 승인

v2rayNG 메인 화면으로 돌아가 상단이나 설정 카드에 방금 선택한 서버가 표시되는지 확인한 뒤 원형 연결 버튼을 누릅니다. 처음 연결할 때 시스템 권한 승인 창이 표시되며, 승인하면 버튼 상태가 바뀌고 시스템 상태 영역에도 연결 표시가 나타납니다. 이때 클라이언트를 백그라운드에서 실행하면 되며 메인 화면을 계속 보고 있을 필요는 없습니다.

누른 직후 연결되지 않음 상태로 돌아가면 사이드 메뉴의 로그를 열어 마지막 몇 줄의 오류를 확인하세요. 주요 원인은 서버 연결 불가, 호환되지 않는 설정 필드, 기기 시간 오차와 네트워크 전환 중단입니다. 먼저 모바일 네트워크와 Wi-Fi 중 하나만 고정한 뒤 다시 시도해 연결 중 네트워크 출구가 바뀌지 않도록 하세요.

“코어 시작”과 “연결 사용 가능”을 구분하는 방법

코어 시작은 클라이언트가 설정을 정상적으로 읽고 로컬 트래픽을 수신하기 시작했다는 뜻일 뿐, 원격 회선이 반드시 사용 가능하다는 의미는 아닙니다. 일부 프로토콜은 실제 요청이 발생할 때 원격 연결을 수립하므로 버튼을 누른 직후 로그가 많지 않은 것은 정상입니다. 이제 웹페이지를 직접 열거나 기존 페이지를 새로 고쳐 브라우저 요청을 발생시키고, 로그에 해당 인바운드·라우팅·아웃바운드 기록이 나타나는지 확인하세요.

상태가 실행 중으로 표시되지만 브라우저를 새로 고친 뒤에도 로그에 새 기록이 전혀 없다면 문제는 대개 트래픽 입구에 있습니다. 데스크톱에서는 시스템 프록시가 켜져 있는지, Android에서는 시스템 연결 권한이 여전히 유효한지 확인하세요. 로그에 요청은 있지만 연결 실패가 계속되면 구독의 다른 서버로 바꿔 비교해 보세요.

코어 시작 완료

상태 표시줄에 실행 중으로 표시되고 로그에 설정 로드와 리스닝 기록이 나타납니다.

트래픽 유입 확인

페이지를 새로 고친 뒤 로그에 새로운 인바운드 및 라우팅 기록이 나타납니다.

결과 확인 필요

연결 아이콘만 보지 말고 대상 접속과 규칙 분할 결과를 계속 확인하세요.

RESULT / ROUTE

연결, 시스템 프록시와 라우팅 결과 확인

확인은 세 가지 수준을 포함해야 합니다. 클라이언트가 요청을 받았는지, 요청이 예상한 출발 경로로 들어갔는지, 규칙 모드에서 직접 연결 대상이 기존 경로로 접속되는지 확인하세요.

브라우저 요청 다시 생성

연결 전에 열어 둔 웹페이지는 기존 연결이나 캐시를 유지할 수 있습니다. 관련 탭을 닫고 다시 열거나 새 브라우저 창에서 요청을 생성하세요. 데스크톱에서 특정 브라우저만 달라진 점이 없다면 해당 브라우저가 독립 프록시 설정을 사용하는지 확인하세요. 독립 설정은 시스템 프록시를 덮어씁니다. Android에서 특정 앱만 연결되지 않는다면 v2rayNG의 앱별 프록시 설정에서 해당 앱이 제외되었는지 확인하세요.

요청을 보낸 직후 클라이언트 로그를 확인하세요. 대상 도메인, 적용된 규칙 태그 또는 아웃바운드 유형이 보이면 트래픽이 클라이언트로 들어온 것입니다. 브라우저에 오류가 표시되는데 로그가 전혀 없으면 이전 단계로 돌아가 트래픽 입구를 확인하세요. 로그가 있고 연결 시간 초과가 표시되면 현재 서버나 네트워크 경로 문제일 가능성이 큽니다.

규칙 모드로 양방향 확인

규칙 분할은 프록시가 필요한 대상 하나만 확인해서는 안 되며, 직접 연결되어야 하는 일반적인 로컬 서비스도 확인해야 합니다. 전자는 프록시 출발 경로의 사용 가능 여부를, 후자는 규칙이 모든 트래픽을 같은 출구로 잘못 보내지 않는지를 확인합니다. 두 대상을 열고 로그의 라우팅 결과를 비교하세요. 프록시가 필요한 요청은 프록시 출발 경로로, 직접 연결 대상은 직접 연결 규칙으로 들어가야 합니다.

전역 프록시에서는 접속되지만 규칙 모드에서는 되지 않는다면 클라이언트를 반복해서 재설치하지 마세요. 먼저 실패한 대상의 도메인을 기록하고 로그에서 적용된 규칙을 찾은 뒤 GeoSite, GeoIP 데이터와 사용자 지정 라우팅 순서를 확인하세요. 라우팅 규칙은 보통 위에서 아래로 적용되므로 지나치게 포괄적인 규칙이 앞에 있으면 뒤의 정확한 규칙이 작동하지 않습니다.

DNS가 잘못된 경로를 사용하지 않는지 확인

“일부 도메인은 열리지 않지만 주소를 직접 사용하면 연결되는” 경우 DNS가 원인일 수 있습니다. 처음에는 클라이언트의 기본 DNS 설정으로 되돌리고 연결을 다시 시작하세요. 시스템 DNS, 사용자 지정 원격 DNS와 FakeDNS가 동시에 작동하지 않도록 합니다. 복원 후 브라우저의 현재 페이지를 정리하고 다시 접속하면서 로그에 도메인 확인 오류가 나타나는지 확인하세요.

기본 설정이 정상 작동한 뒤 네트워크 환경에 따라 원격 DNS, DNS 아웃바운드 또는 FakeDNS를 설정하세요. DNS 규칙은 라우팅 규칙과 서로 영향을 주므로 기본 연결을 확인한 뒤 하나씩 조정하는 것이 좋습니다. 전체 설정 경로, 누출 확인 방법과 TUN 연동 방식은 고급 매뉴얼에서 설명합니다.

완료 확인 목록

  1. 상태 확인: 클라이언트가 연결 상태를 유지하고 로그에 시작 실패나 포트 충돌이 반복되지 않습니다.
  2. 입구 확인: 브라우저를 새로 고친 뒤 로그에서 새로운 요청 기록을 확인할 수 있습니다.
  3. 프록시 확인: 프록시가 필요한 대상에 접속되고 프록시 출발 경로가 적용됩니다.
  4. 직접 연결 확인: 규칙 모드에서 자주 사용하는 로컬 서비스가 계속 직접 연결 출발 경로를 사용합니다.
  5. 재시작 확인: 클라이언트를 종료하고 다시 열어도 구독 그룹, 활성 서버와 모드가 예상대로 유지됩니다.

QUICK FIXES

최초 설정에서 자주 발생하는 문제 해결

한 번에 변수 하나만 변경하세요. 매번 수정 후 다시 연결하고 테스트해야 어떤 설정이 영향을 주었는지 확인할 수 있습니다.

구독 업데이트는 성공했지만 메인 화면에 서버가 표시되지 않으면 어떻게 하나요?

먼저 구독 항목이 활성화되어 있는지 확인한 뒤 메인 화면으로 돌아가 새로 고침을 실행하세요. 여전히 비어 있으면 구독 응답 형식이 현재 클라이언트에서 지원되는지 확인합니다. 구독 관리 화면에 주소가 기록되어 있다고 가져오기가 완료된 것은 아닙니다. 메인 화면에 선택 가능한 서버 항목이 나타나는지를 최종 기준으로 삼으세요.

클라이언트는 실행 중인데 브라우저에 변화가 없으면 어떻게 하나요?

데스크톱에서는 먼저 시스템 프록시가 클라이언트 관리 상태로 전환되었는지 확인한 뒤 브라우저에 독립 프록시가 설정되어 있지 않은지 점검하세요. Android에서는 시스템 연결 권한과 앱별 프록시 적용 범위를 확인합니다. 페이지를 새로 고치면서 로그도 함께 살펴보세요. 로그에 새 요청이 없으면 대개 트래픽이 아직 클라이언트로 들어오지 않은 것입니다.

규칙 모드에서는 실패하지만 전역 프록시는 작동하면 어떻게 하나요?

이는 연결 경로 자체는 대체로 정상이며 라우팅 규칙이나 DNS를 중점적으로 확인해야 한다는 뜻입니다. 실패한 도메인에 적용된 규칙을 확인하고, 포괄적인 규칙이 정확한 규칙을 덮지 않는지 점검하며 GeoSite·GeoIP 데이터가 현재 규칙 형식에 맞는지 확인하세요. 변경 전에 현재 설정을 내보내 두면 좋습니다.

서버를 바꿔도 연결 시간이 초과되면 어떻게 하나요?

기기 네트워크로 일반 웹페이지에 접속할 수 있는지 확인하고 시스템 시간을 동기화하세요. 이후 현재 네트워크 유형을 하나로 고정하고 클라이언트를 다시 시작한 다음 다른 서버를 선택해 테스트합니다. 여러 서버에서 같은 증상이 나타나면 구독 만료 여부, 클라이언트 코어 호환성, DNS의 비정상 응답을 계속 확인하세요.