setup / first connection
v2rayN 설정 가이드
구독 가져오기부터 연결 확인까지
정해진 순서에 따라 네 가지 작업을 완료하세요: 구독 가져오기, 프록시 모드 선택, 연결 설정, 결과 확인. 각 단계에서 진입 위치, 정상 상태, 다음 단계로 넘어가기 전에 확인할 항목을 설명합니다.
before / setup
시작 전 준비
유효한 구독 주소를 준비하고 클라이언트 설치가 완료되었는지 확인하세요. 처음 설정할 때는 config.json을 직접 편집하거나 고급 라우팅 필드를 먼저 조정할 필요가 없습니다.
구독 주소는 일반적으로 서비스 제공업체가 안내하며, 클라이언트가 여러 연결 설정을 읽도록 하는 역할을 합니다. 복사할 때는 주소 전체를 유지하고 앞뒤의 공백, 줄바꿈, 설명 문구를 포함하지 마세요. 구독은 개인 설정 정보이므로 공개 페이지, 스크린샷 또는 대화 기록에 붙여 넣지 않는 것이 좋습니다. VMess, VLESS 또는 다른 공유 링크 하나만 있다면 클라이언트의 “클립보드에서 가져오기” 기능을 사용할 수도 있지만, 이 페이지에서는 더 일반적인 구독 그룹 방식을 중심으로 설명합니다.
클라이언트를 연 뒤 먼저 메인 화면이 정상적으로 표시되는지 확인하세요. v2rayN 데스크톱 버전에서는 일반적으로 서버 목록, 메뉴 모음, 창 하단의 상태 영역이 보입니다. v2rayNG 안드로이드 버전에서는 설정 목록과 연결 제어 영역이 표시됩니다. 이때 목록이 비어 있는 것은 정상입니다. 아직 구독이 추가되지 않았기 때문입니다. 클라이언트가 시작되지 않거나 창이 열린 직후 닫히거나 시스템에서 실행 환경이 없다고 알리면, 먼저 다운로드 페이지로 돌아가 플랫폼과 설치 패키지 유형을 확인한 다음 이 가이드를 계속 진행하세요.
처음 설정할 때는 클라이언트의 기본 포트, 기본 DNS, 기본 라우팅 규칙을 일단 유지하는 것이 좋습니다. 한 번에 핵심 항목 하나만 변경해야 문제가 발생한 지점을 쉽게 파악할 수 있습니다. 이 페이지의 네 단계를 완료하고 기본 연결이 정상인지 확인한 뒤, 시스템 가이드의 라우팅 분할 섹션에서 도메인 규칙, GeoSite, GeoIP 또는 TUN 모드를 조정하세요.
subscription / import
구독 가져오기
이 단계의 목표는 즉시 연결하는 것이 아니라 클라이언트가 구독을 정상적으로 읽고 메인 목록에 선택 가능한 설정 항목을 생성하도록 하는 것입니다. 목록에 내용이 표시되어야 다음 단계에서 프록시 모드와 연결 대상을 명확히 지정할 수 있습니다.
v2rayN 데스크톱 버전: 구독 그룹 만들기
v2rayN 메인 창을 열고 상단 메뉴에서 “구독 그룹” 또는 이와 비슷한 구독 관리 메뉴를 찾은 다음 “구독 그룹 설정”으로 들어갑니다. 버전에 따라 메뉴가 “구독” 아래에 있거나 도구 모음 버튼으로 바로 표시될 수 있습니다. 설정 창에서 추가를 클릭하고 비고 또는 별칭 입력란에 “자주 사용하는 구독”처럼 알아보기 쉬운 이름을 입력한 뒤 주소 입력란에 전체 구독 링크를 붙여 넣으세요. 이름은 로컬에서 구분하기 위한 용도이며 연결 결과에는 영향을 주지 않습니다.
입력을 마쳤으면 확인 또는 저장을 클릭해 메인 창으로 돌아옵니다. 이 단계에서는 구독 출처만 저장되었으므로 서버 목록이 아직 업데이트되지 않았을 수 있습니다. “구독 그룹” 메뉴를 다시 열고 “모든 구독 업데이트”를 실행하거나 방금 만든 그룹을 선택한 뒤 업데이트하세요. 클라이언트가 구독 내용을 읽어 분석한 항목을 서버 목록에 추가합니다. 업데이트가 끝나면 메인 창에 프로토콜 유형, 주소, 포트, 별칭 등의 항목이 표시되어야 합니다. 항목 수는 버전과 창 너비에 따라 달라질 수 있습니다.
업데이트 후에도 목록이 비어 있다면 먼저 구독 그룹 설정으로 돌아가 주소의 시작과 끝에 공백이 있는지 확인하고, 구독 그룹이 활성화되어 있는지도 점검하세요. 상태 표시줄에 구독 읽기 실패가 표시되면 아직 문제가 설정 가져오기 단계에 있으므로 프록시 모드를 계속 변경하지 마세요. 서비스 제공업체의 관리 페이지에서 주소를 다시 복사해 기존 내용을 덮어쓴 뒤 한 번 더 업데이트할 수 있습니다. 더 자세한 구독 오류 분류는 시스템 가이드의 구독 관리에서 확인하세요.
v2rayNG 안드로이드 버전: 구독 추가 및 업데이트
v2rayNG을 열고 사이드 메뉴 또는 오른쪽 상단 메뉴에서 “구독 그룹 설정”을 찾으세요. 추가 버튼을 누르고 비고란에 그룹 이름을 입력한 뒤 주소 입력란에 구독 링크를 붙여 넣고 저장합니다. 설정 목록으로 돌아와 메뉴에서 “구독 업데이트”를 선택하세요. 구독 그룹이 여러 개라면 방금 추가한 그룹이 업데이트 대상으로 선택되었는지 먼저 확인하여 기존 그룹의 결과를 새 구독 결과로 착각하지 않도록 합니다.
업데이트가 끝나면 설정 목록에 하나 이상의 항목이 표시됩니다. 각 항목에는 일반적으로 이름과 프로토콜 관련 정보가 표시됩니다. 이때는 연결 버튼을 누르지 말고 먼저 목록이 비어 있지 않은지, 항목 이름이 구독 출처의 이름과 대체로 일치하는지 확인하세요. 같은 항목이 반복해서 나타난다면 동일한 주소를 중복 추가했을 가능성이 큽니다. 구독 그룹 설정에서 불필요한 그룹을 삭제한 뒤 목록을 다시 업데이트하세요.
routing / mode
프록시 모드 선택
프록시 모드는 현재 설정이 처리할 트래픽을 결정합니다. 처음 사용할 때는 규칙 기반 분할부터 시작하는 것이 좋습니다. 일반적인 로컬 웹사이트와 로컬 네트워크 주소는 직접 연결하고, 프록시가 필요한 요청만 활성 서버로 보냅니다. 이렇게 하면 접근 범위와 일상적인 애플리케이션 호환성을 균형 있게 유지하기 쉽습니다.
혼동하기 쉬운 두 가지 설정부터 구분하기
v2rayN 데스크톱 버전에는 일반적으로 “시스템 프록시”와 “라우팅 모드”라는 두 가지 설정이 함께 있습니다. 시스템 프록시는 브라우저와 시스템 프록시 설정을 따르는 애플리케이션의 트래픽을 v2rayN으로 보낼지 결정합니다. 라우팅 모드는 트래픽이 코어에 들어온 뒤 프록시 아웃바운드, 직접 연결 아웃바운드 또는 차단 아웃바운드 중 어느 경로로 나갈지 결정합니다. 라우팅 모드만 바꾸고 시스템 프록시를 활성화하지 않으면 브라우저가 계속 직접 접속할 수 있습니다. 반대로 시스템 프록시만 활성화하고 라우팅 규칙을 잘못 선택하면 일부 웹사이트의 결과가 예상과 달라질 수 있습니다.
v2rayNG 안드로이드 버전은 연결할 때 시스템 수준의 로컬 연결 채널을 만들며, 라우팅 설정이 트래픽 분배 방식을 결정합니다. 화면의 “사전 정의 규칙”, “라우팅 설정” 또는 비슷한 이름의 항목이 이 단계에 해당합니다. 처음 사용할 때는 복잡한 앱별 제어를 바로 활성화하거나 여러 사용자 지정 규칙을 가져오지 않는 것이 좋습니다. 먼저 명확하고 재현 가능한 규칙 하나로 연결을 완료하고 정상 작동을 확인한 뒤 항목을 하나씩 확장하세요.
자주 사용하는 세 가지 모드 선택 방법
v2rayN에서는 먼저 라우팅 설정에서 규칙 기반 분할 방식을 선택한 다음, 시스템 트레이 아이콘 또는 메인 창의 시스템 프록시 메뉴에서 “시스템 프록시 자동 구성” 또는 같은 의미의 항목을 선택하세요. “시스템 프록시 지우기”는 선택하지 마세요. 이 상태에서는 대부분의 브라우저가 클라이언트를 우회합니다. SOCKS 또는 HTTP 프록시를 수동으로 설정한 특정 프로그램만 v2rayN을 사용하게 하려면 시스템 프록시를 그대로 둘 수도 있지만, 이 방식은 로컬 수신 포트를 별도로 입력해야 하므로 첫 설정 방법으로는 적합하지 않습니다.
v2rayNG에서는 설정의 라우팅 구성으로 들어가 클라이언트가 제공하는 사전 정의 규칙을 우선 선택하세요. 메인 목록으로 돌아온 뒤 서로 충돌하는 앱별 규칙이 동시에 활성화되어 있지 않은지 확인합니다. 전역 프록시는 문제 해결을 위한 비교 도구로 사용할 수 있습니다. 규칙 기반 분할에서는 특정 대상에 접속할 수 없지만 전역 프록시에서는 접속된다면 라우팅 매칭이나 규칙 데이터에 문제가 있을 가능성이 큽니다. 두 모드 모두 실패한다면 구독 항목, 연결 상태, 네트워크 환경을 계속 점검하세요.
규칙 기반 분할은 routing.rules, 도메인 분류, IP 분류, 아웃바운드 태그 사이의 관계를 바탕으로 작동합니다. 처음 연결할 때는 “일치한 뒤 경로를 결정한다”는 점만 이해하면 되며, 여기서 모든 필드를 자세히 다룰 필요는 없습니다. 사용자 지정 규칙이 필요하다면 라우팅 분할 시스템 가이드에서 단계별로 설정하세요.
client / connect
연결 설정
연결하기 전에 두 가지 작업을 완료해야 합니다. 구체적인 설정 하나를 선택하고 클라이언트를 실행 상태로 전환해야 합니다. 목록에 항목이 있다고 해서 해당 항목이 사용 중인 것은 아닙니다. 활성 항목, 시스템 프록시, 코어 실행 상태를 각각 확인해야 합니다.
v2rayN 데스크톱 버전: 활성 서버로 지정하기
v2rayN 메인 창으로 돌아가 서버 목록에서 항목 하나를 클릭하세요. 처음 테스트할 때는 이름이 명확하고 출처를 알 수 있는 항목을 우선 선택하고 여러 항목을 한꺼번에 선택하지 마세요. 선택한 뒤 Enter를 누르거나 오른쪽 클릭 메뉴에서 “활성 서버로 지정”을 선택합니다. 성공하면 현재 항목의 색상, 글꼴, 선택 표시 또는 상태 표시줄 문구가 달라지는 경우가 많지만, 구체적인 표시 방식은 클라이언트 버전에 따라 다릅니다.
이어서 창 하단 또는 로그 영역을 확인하세요. 정상적으로 시작되면 코어 실행 시작, 로컬 인바운드 포트 수신 대기 시작 등의 상태 정보가 표시됩니다. 이 포트는 일반적으로 클라이언트가 자동으로 관리하므로 처음 사용할 때 직접 변경할 필요가 없습니다. 그런 다음 시스템 트레이의 v2rayN 아이콘을 확인하여 시스템 프록시가 자동 구성 상태인지 확인하세요. 방금 프록시 모드를 설정했더라도 클라이언트를 다시 시작했다면 트레이 메뉴를 다시 점검하여 시스템 프록시가 수동으로 직접 연결 상태로 바뀌지 않았는지 확인해야 합니다.
항목을 선택한 직후 로그에 연결 실패가 표시되더라도 여러 설정을 빠르게 바꾸지 마세요. 먼저 컴퓨터의 날짜와 시간이 정확한지 확인한 다음 같은 구독에서 다른 항목을 하나 선택해 비교하세요. 특정 항목만 실패한다면 해당 항목에 문제가 있을 가능성이 큽니다. 모든 항목이 실패한다면 구독 만료 여부, 네트워크 연결, 로컬 포트 충돌을 확인하세요. 포트 충돌 확인 방법은 시스템 가이드의 로컬 포트 섹션에서 확인할 수 있습니다.
v2rayNG 안드로이드 버전: 설정 선택 및 시작
v2rayNG 설정 목록에서 항목 하나를 눌러 현재 설정으로 지정하세요. 선택된 항목에는 일반적으로 라디오 표시나 강조 표시가 나타납니다. 이어서 화면 하단의 연결 버튼을 누릅니다. 처음 시작할 때 시스템에 연결 권한 창이 표시되면 애플리케이션 이름을 확인한 후 승인하세요. 권한은 클라이언트가 로컬 연결 채널을 만들도록 허용할 뿐, 구독 설정 자체를 대신하지는 않습니다.
연결에 성공하면 하단 버튼의 상태가 바뀌고 시스템 상태 영역에도 연결 중임을 나타내는 표시가 나타납니다. v2rayNG 메인 화면으로 돌아가 현재 설정 이름이 방금 선택한 항목과 같은지 확인하세요. 연결을 누른 뒤 곧바로 연결되지 않음 상태로 돌아간다면 버튼을 반복해서 누르지 말고 로그의 마지막 몇 줄을 확인하세요. 흔한 원인으로는 사용할 수 없는 설정, 네트워크 전환 후 연결 끊김, 구독 항목의 불완전한 매개변수, 시스템 시간 오차가 있습니다.
무선 네트워크에서 모바일 네트워크로 전환하거나 반대로 전환하면 기존 연결을 다시 설정해야 할 수 있습니다. 네트워크를 전환할 때는 먼저 클라이언트 상태를 확인하세요. 연결 표시가 사라졌다면 메인 화면으로 돌아가 연결을 다시 누릅니다. 동일한 시스템 프록시 역할을 수행하는 클라이언트를 여러 개 동시에 실행하지 마세요. 애플리케이션 트래픽이 서로 다른 로컬 포트에 중복으로 연결되어 확인 결과가 불안정해질 수 있습니다.
network / verify
프록시 적용 여부 확인
버튼에 연결됨이 표시되는 것은 클라이언트가 실행 상태에 들어갔다는 뜻일 뿐입니다. 최종 확인은 실제 애플리케이션 트래픽이 예상한 경로를 통과하는지 확인해야 합니다. 새로 연 브라우저 창에서 시작한 뒤 다른 애플리케이션으로 범위를 넓혀 확인하세요.
연결 전후 비교하기
브라우저에서 새 창을 열고 검색 엔진으로 “현재 IP 주소”를 검색해 페이지에 표시된 외부 IP 정보를 기록하세요. 클라이언트를 계속 실행한 상태에서 조회 페이지를 새로 고치거나 새 창을 다시 엽니다. 외부 IP 결과가 예상대로 바뀌면 브라우저 트래픽이 클라이언트로 들어간 것입니다. 규칙 기반 분할을 사용할 때는 조회 페이지마다 다른 규칙이 적용될 수 있으므로 한 페이지의 결과에만 의존하지 말고 클라이언트 로그와 함께 판단하세요.
v2rayN 데스크톱 버전이 정상 실행 중으로 표시되는데도 브라우저 결과가 계속 같다면, 먼저 브라우저가 시스템 프록시를 따르는지 확인하세요. 일부 브라우저 확장 프로그램은 시스템 설정을 덮어쓰며, 일부 애플리케이션은 자체 프록시 매개변수를 사용합니다. 먼저 프록시를 변경하는 브라우저 확장 프로그램을 끈 다음 v2rayN 트레이 메뉴의 시스템 프록시 상태를 확인하세요. 브라우저에 로컬 프록시 주소를 수동으로 입력한 적이 있다면 포트가 클라이언트의 현재 수신 포트와 일치하는지도 확인합니다.
v2rayNG 안드로이드 버전에서 연결한 뒤에는 기존 연결이 재사용되지 않도록 브라우저를 완전히 종료했다가 다시 여세요. 브라우저에서는 정상적으로 확인되는데 특정 애플리케이션만 접속할 수 없다면 해당 애플리케이션이 앱별 규칙에서 제외되었는지 또는 독립적인 네트워크 채널을 사용하는지 확인하세요. 브라우저가 정상적으로 작동한다는 것은 구독, 서버 항목, 기본 연결 경로가 대체로 정상이라는 뜻이므로 구독 내용을 바로 변경하지 말고 애플리케이션 범위와 라우팅 규칙을 우선 점검하세요.
로그로 트래픽 경로 확인하기
클라이언트 로그를 연 뒤 브라우저에서 새 페이지에 접속하세요. 정상적인 경우 로그에 새 연결 기록이 추가되고 대상 도메인, 대상 주소 또는 매칭된 아웃바운드 태그가 표시됩니다. 로그는 “요청이 클라이언트에 들어오지 않음”과 “요청이 들어온 뒤 연결 실패”를 구분하는 데 유용합니다. 전자는 시스템 프록시, 애플리케이션 프록시 또는 연결 권한과 관련된 경우가 많고, 후자는 서버 항목, 라우팅 규칙, DNS 또는 네트워크 환경과 관련된 경우가 많습니다.
로그에 새 기록이 전혀 없다면 현재 애플리케이션이 트래픽을 클라이언트로 보내지 않는 것일 수 있습니다. v2rayN은 시스템 프록시 스위치와 애플리케이션 자체 프록시 설정을 다시 확인해야 하며, v2rayNG은 연결 상태와 앱별 적용 범위를 확인해야 합니다. 로그에 기록은 있지만 시간 초과 또는 연결 설정 실패가 발생한다면 같은 구독에서 다른 설정을 선택해 비교하세요. 전환할 때는 프록시 모드를 그대로 유지하여 두 변수를 동시에 바꾸지 않도록 합니다.
웹페이지는 열리지만 이미지, 동영상 또는 일부 도메인이 로드되지 않는다면 라우팅 규칙이나 DNS 결과가 일치하지 않는 것이 흔한 원인입니다. 잠시 전역 프록시로 바꾸어 비교할 수 있습니다. 전역 모드에서 정상으로 돌아오면 기본 연결은 사용 가능한 것이므로 다음 단계에서 규칙 매칭을 확인하세요. 전역 모드에서도 문제가 계속되면 현재 설정과 네트워크 상태를 점검합니다. 비교가 끝나면 원래 모드로 복원하여 문제 해결 상태를 일상 설정으로 계속 사용하지 않도록 합니다.
다른 애플리케이션도 예상대로 작동하는지 확인
브라우저 확인을 마친 뒤 평소 인터넷을 사용하는 애플리케이션을 하나 더 열어 테스트하세요. v2rayN의 시스템 프록시는 주로 시스템 프록시 설정을 따르는 프로그램에 적용되며 모든 데스크톱 프로그램이 자동으로 사용하는 것은 아닙니다. 일부 프로그램은 자체 설정에서 “시스템 프록시 사용”을 선택하거나 로컬 HTTP, SOCKS 주소를 직접 입력해야 합니다. 더 많은 유형의 트래픽을 처리하려면 TUN 모드를 검토할 수 있지만, 먼저 시스템 가이드의 TUN 섹션에서 권한, DNS, 라우팅 변경 사항을 확인한 후 활성화하세요.
확인이 완료된 기준은 클라이언트가 안정적으로 실행되고, 브라우저 외부 IP가 선택한 모드에 맞으며, 로그에 새 요청이 표시되고, 자주 사용하는 애플리케이션의 접근 범위가 예상과 일치하는 것입니다. 이 조건을 충족하면 첫 설정이 완료됩니다. 이후 구독을 업데이트할 때는 모든 단계를 반복할 필요 없이 구독을 업데이트하고 활성 항목이 여전히 존재하는지 확인한 다음 간단히 연결을 다시 확인하면 됩니다.
finish / checklist
첫 설정 완료 확인
다음 상태를 순서대로 확인하세요. 앞 항목을 통과하지 못했다면 먼저 해당 항목을 해결하고 뒤의 고급 설정으로 넘어가지 마세요.
-
구독 목록에 설정이 있음
구독 그룹이 저장되었고 업데이트가 정상적으로 완료되며 메인 목록에 선택 가능한 항목이 하나 이상 있어야 합니다.
-
프록시 모드가 사용 범위와 일치함
일상적인 사용에는 규칙 기반 분할을 우선 사용하세요. 규칙을 점검할 때는 잠시 전역 프록시로 전환해 비교하고 테스트가 끝나면 복원합니다.
-
활성 설정과 실행 상태가 명확함
v2rayN은 활성 서버를 지정하고 시스템 프록시를 활성화했거나, v2rayNG은 설정을 선택한 뒤 연결 상태를 유지하고 있어야 합니다.
-
실제 트래픽 확인 완료
브라우저 외부 IP, 클라이언트 로그, 자주 사용하는 애플리케이션의 접속 결과가 서로 일치해야 하며 연결 버튼만 확인해서는 안 됩니다.
setup > completed
라우팅 및 TUN 계속 설정하기
첫 연결을 완료한 뒤 실제 필요에 따라 구독 관리, 라우팅 규칙, DNS, TUN 모드, 문제 해결 방법을 학습하세요. 시스템 가이드는 단계별로 구성되어 있으므로 처음 설정할 때 모든 항목을 한 번에 변경할 필요가 없습니다.
setup / quick answers
첫 설정에서 자주 발생하는 문제
구독 업데이트는 성공했는데 목록에 새 항목이 표시되지 않으면 어떻게 하나요?
먼저 방금 만든 구독 그룹을 업데이트했는지 확인하고 그룹이 활성화되어 있는지 점검하세요. 그런 다음 전체 구독 주소를 다시 복사해 기존 주소를 덮어쓰고 저장합니다. 클라이언트에 분석 실패가 표시되면 구독 제공업체에 주소 상태를 확인해야 하며, 구독 읽기 문제를 프록시 모드 변경으로 해결하려고 하지 마세요.
클라이언트에는 연결됨으로 표시되는데 브라우저 외부 IP가 바뀌지 않는 이유는 무엇인가요?
v2rayN은 시스템 프록시가 활성화되어 있는지 확인하고 브라우저가 확장 프로그램이나 수동 프록시 설정에 의해 덮어써지지 않았는지 점검해야 합니다. v2rayNG은 브라우저를 완전히 종료했다가 다시 연 뒤 앱별 규칙을 확인하세요. 클라이언트 로그에 새 요청이 없다면 트래픽이 클라이언트로 들어오는지 우선 점검합니다.
규칙 기반 분할과 전역 프록시 중 어느 것을 계속 사용해야 하나요?
일상적인 사용에는 일반적으로 규칙 기반 분할을 선택하여 대상별로 직접 연결 또는 프록시를 적용합니다. 전역 프록시는 라우팅 매칭 때문에 문제가 발생했는지 확인하는 짧은 비교 테스트에 적합합니다. 구체적인 규칙 구조는 시스템 가이드에서 계속 학습할 수 있습니다.
구독을 업데이트한 뒤 모든 옵션을 다시 설정해야 하나요?
일반적으로 그럴 필요는 없습니다. 업데이트 후 기존 활성 항목이 여전히 존재하는지와 현재 선택된 설정을 확인하세요. 구독 제공업체가 항목 이름을 변경하거나 기존 항목을 삭제했다면 설정을 다시 선택한 뒤 연결 및 외부 IP 확인을 한 번 진행하면 됩니다.