v2rayN을 처음 실행하면 메인 창에 버튼, 서버 행, 그룹 탭과 스크롤 로그가 한꺼번에 표시됩니다. 정보가 많아 보여도 실제 사용 흐름은 복잡하지 않습니다. 메인 화면은 다섯 영역으로 이해하면 쉽습니다. 상단 명령 영역은 작업을 시작하고, 구독·그룹 영역은 범위를 좁히며, 서버 목록은 설정을 선택하고, 로그 창은 실행 결과를 보여 주며, 하단 상태 영역은 현재 프록시 상태를 확인합니다.
버전에 따라, 또는 데스크톱 플랫폼과 창 너비에 따라 버튼 배치와 일부 문구가 달라질 수 있지만 핵심 관계는 같습니다. 구독에서 서버 설정이 생성되고, 서버 설정은 Xray 코어로 전달됩니다. 코어는 로컬 인바운드 포트를 열고 라우팅 규칙에 따라 트래픽을 전달하며, 시스템 프록시 또는 TUN 모드가 어떤 애플리케이션 트래픽을 해당 포트로 보낼지 결정합니다. 이 흐름을 이해하면 화면의 대부분의 기능 위치를 쉽게 찾을 수 있습니다.
위에서 아래로 메인 창 구조 파악하기
메인 창 상단에는 보통 메뉴 모음과 빠른 명령이 배치됩니다. 메뉴 모음에는 전체 기능이 들어 있고, 빠른 명령에는 서버 추가, 구독 업데이트, 서버 테스트, 활성 서버 설정, 설정 열기처럼 자주 쓰는 작업이 모여 있습니다. 창이 좁으면 일부 버튼이 더보기 메뉴 안으로 들어갈 수 있으므로 아이콘이 보이지 않을 때는 기능이 삭제되었다고 판단하기보다 해당 메뉴를 먼저 펼쳐 보세요.
가운데 영역은 서버 관리의 중심입니다. 일반적으로 구독 그룹 선택, 검색 또는 필터 기능, 그리고 가장 넓은 공간을 차지하는 서버 표가 포함됩니다. 각 행은 코어에서 사용할 수 있는 하나의 아웃바운드 설정을 의미합니다. 설정은 수동 추가, 공유 링크 가져오기, 클립보드 일괄 가져오기 또는 구독 업데이트에서 생성될 수 있습니다. VMess와 VLESS 같은 프로토콜이 한 목록에 함께 표시될 수 있지만 각 행은 주소, 포트, 전송 방식과 보안 매개변수를 독립적으로 유지합니다.
서버 목록 아래에는 대개 로그 창이 있습니다. 로그는 장식용 정보가 아니라 “작업이 성공적으로 실행되었는지”를 판단하는 첫 번째 근거입니다. 구독 업데이트, 코어 시작, 서버 전환, 시스템 프록시 활성화 또는 연결 시도 결과가 이곳에 표시됩니다. 창 맨 아래의 상태 영역에서는 활성 설정, 로컬 포트, 프록시 모드 또는 코어 실행 상태를 빠르게 확인할 수 있습니다.
일상적으로는 정해진 순서로 확인하면 됩니다. 먼저 현재 그룹을 보고, 다음으로 활성 서버를 확인한 뒤, 프록시 모드를 살피고, 마지막으로 로그에 연속된 오류가 있는지 확인하세요. 설정 페이지를 반복해서 열어 보는 것보다 빠르며, “목록에 노드가 있다”는 사실을 “트래픽이 노드를 통해 전달되고 있다”는 뜻으로 잘못 판단하는 일도 줄일 수 있습니다.
상단 메뉴와 빠른 명령의 역할
서버 명령: 개별 설정 관리
서버 관련 메뉴는 한 개 또는 여러 개의 설정을 관리합니다. 대표적인 작업으로 수동 추가, 클립보드에서 가져오기, 편집, 복사, 삭제, 지연 시간 테스트, 활성 서버 설정이 있습니다. 편집 기능은 프로토콜 매개변수를 확인할 때 유용하지만 구독에서 생성된 설정은 장기간 직접 수정하지 않는 편이 좋습니다. 다음 구독 업데이트에서 서버가 내려준 내용으로 해당 행이 덮어써질 수 있기 때문입니다.
VLESS 설정을 수동으로 편집할 때는 주소, 포트, 사용자 식별자, 전송 방식, 보안 계층, SNI, 지문과 flow 등의 항목이 서버 설정과 일치해야 합니다. VMess도 사용자 식별자, alterId 또는 호환 매개변수, 전송 및 TLS 설정을 맞춰야 합니다. 핵심 항목 중 하나라도 다르면 서버 이름이 정상적으로 보여도 유효한 연결을 만들 수 없습니다.
구독 명령: 설정 일괄 생성 및 갱신
구독 기능은 원격에서 관리되는 서버 기록 묶음을 다룹니다. 일반적인 순서는 구독 주소를 추가한 다음 업데이트를 실행하는 것입니다. v2rayN이 내용을 가져와 파싱하면 인식 가능한 기록을 해당 구독 그룹에 넣습니다. 업데이트 성공이 모든 노드의 사용 가능성을 의미하지는 않습니다. 구독 내용을 가져와 변환했다는 뜻일 뿐이며, 노드 연결 상태는 별도로 테스트해야 합니다.
목록에 같은 이름의 서버가 갑자기 많이 나타나도 바로 한 줄씩 삭제하지 마세요. 먼저 같은 구독을 중복으로 추가했는지, 또는 하나의 구독을 여러 그룹에 넣었는지 확인하세요. 일괄 관리는 구독 설정에서 출처를 정리하는 것이 우선입니다. 그래야 다음 업데이트 후 중복 기록이 다시 생기는 일을 막을 수 있습니다.
테스트 명령: 연결 상태·지연 시간·실제 속도 구분하기
테스트 메뉴에는 여러 결과가 제공될 수 있으며, 이를 하나의 지표로 보면 안 됩니다. 포트 연결 테스트는 대상 주소와 포트에 기본 연결을 만들 수 있다는 뜻일 뿐입니다. 실제 지연 시간은 보통 프록시를 거쳐 지정된 테스트 대상에 요청을 보내 측정합니다. 다운로드 속도는 테스트 리소스, 회선 혼잡도와 로컬 네트워크의 영향을 받습니다. 어느 행의 지연 시간이 낮다고 해서 대용량 전송이 반드시 빠른 것은 아니며, 모든 웹사이트의 접속 경로가 같다는 뜻도 아닙니다.
| 작업 | 확인할 수 있는 내용 | 확인할 수 없는 내용 |
|---|---|---|
| 포트 테스트 | 대상 호스트와 포트에 연결할 수 있는가 | 프로토콜 매개변수가 완전히 올바른가 |
| 실제 지연 시간 | 프록시 요청의 대략적인 왕복 시간은 얼마인가 | 지속적인 다운로드 속도가 안정적인가 |
| 속도 테스트 | 현재 테스트 조건에서의 처리량 | 다른 시간대와 다른 대상에서의 성능 |
서버 목록의 각 열 읽는 법
서버 목록은 메인 화면의 핵심이지만 모든 열을 한꺼번에 볼 필요는 없습니다. 처음 설치한 사용자는 별칭, 주소, 포트, 프로토콜, 전송 방식, 보안 계층, 구독 그룹과 테스트 결과만 우선 익히면 됩니다. 나머지 열은 추가 진단에 쓰이므로 처음부터 하나씩 조정할 필요는 없습니다.
별칭과 활성 표시
별칭은 로컬 화면에 표시되는 이름으로, 지역·회선·용도를 구분하는 데 사용합니다. 네트워크 핸드셰이크에는 관여하지 않습니다. 활성 표시는 현재 선택된 출구 설정을 뜻하므로 둘을 혼동하면 안 됩니다. 별칭을 바꿔도 연결 매개변수는 바뀌지 않지만, 구독을 업데이트하면 이름이 구독 내용에 따라 달라질 수 있습니다.
주소와 포트
주소는 서버 도메인 또는 네트워크 주소이고, 포트는 서버가 연결을 받아들이는 진입점입니다. 두 값이 클라이언트가 처음 연결할 대상을 결정합니다. 로그에 연결 시간 초과나 연결 거부가 반복되면 라우팅 규칙보다 먼저 로컬 네트워크, 도메인 해석, 주소와 포트를 확인하세요. 라우팅 규칙은 트래픽을 어느 아웃바운드로 보낼지 결정할 뿐, 연결할 수 없는 서버 진입점을 복구하지는 못합니다.
프로토콜·전송·보안
프로토콜 열에는 VMess 또는 VLESS가 자주 표시됩니다. 전송 열에는 TCP, WebSocket, gRPC 등의 방식이 나타날 수 있고, 보안 관련 열에는 TLS, REALITY 또는 버전에 맞는 다른 설정이 표시될 수 있습니다. 이 항목들이 함께 연결 조건을 구성하므로 프로토콜 이름만 봐서는 안 됩니다. 두 설정이 모두 VLESS를 사용하더라도 전송 방식, 보안 계층 또는 flow가 다르면 매개변수를 서로 바꿔 쓸 수 없습니다.
목록은 화면을 간결하게 유지하기 위해 요약 정보만 일부 표시하는 경우가 많습니다. SNI, Host, 경로, 서비스 이름 또는 지문을 확인해야 한다면 편집 창을 열어 전체 설정을 확인하세요. 대조할 때는 서버에서 제공한 정보를 기준으로 삼고, 노드 이름만 보고 매개변수를 추측하지 마세요.
구독 그룹과 테스트 결과
구독 그룹 열은 해당 행을 어느 출처에서 관리하는지 보여 줍니다. 중복 노드와 일괄 업데이트 문제를 찾는 데 유용합니다. 테스트 결과 열에는 지연 시간, 실패 메시지 또는 빈칸이 표시될 수 있습니다. 빈칸은 대개 해당 테스트를 아직 실행하지 않았다는 뜻이며, 곧바로 노드가 작동하지 않는다는 의미는 아닙니다. 실패 결과도 테스트 대상에 연결할 수 없는지, 서버가 시간 초과되었는지, 프로토콜 핸드셰이크가 실패했는지를 로그와 함께 판단해야 합니다.
구독 그룹 구성 및 업데이트 방법
서버 수가 적을 때는 목록 하나로 충분하지만, 구독 출처가 늘어나면 그룹이 메인 화면의 가독성을 좌우합니다. 임시 지연 시간에 따라 자주 이름을 바꾸기보다 출처 또는 용도별로 그룹을 나누는 것이 좋습니다. 출처별 그룹은 업데이트 책임을 파악하는 데 도움이 되고, 용도는 일관된 별칭으로 보완할 수 있습니다.
- 먼저 구독 설정에서 각 주소에 알아보기 쉬운 이름을 지정하세요. 식별하기 어려운 긴 주소만 남겨 두지 않는 것이 좋습니다.
- 새 구독 하나를 먼저 업데이트하고 파싱 결과와 서버 수를 확인한 뒤 전체 업데이트를 실행하세요.
- 메인 창에서 해당 그룹으로 전환한 다음 프로토콜, 주소와 별칭이 예상한 값인지 확인하세요.
- 소수의 서버만 선택해 실제 지연 시간을 테스트하세요. 매번 모든 기록에 속도 테스트를 실행할 필요는 없습니다.
- 사용 가능하다고 확인한 설정을 활성 서버로 지정한 뒤 상태 영역과 로그를 확인하세요.
구독 업데이트 후 서버 수가 0이 되는 원인으로는 구독 주소에 접근할 수 없음, 응답 내용이 비어 있음, 내용을 인식할 수 없는 형식으로 반환됨, 구독 권한 변경 등이 있습니다. 먼저 구독 업데이트 로그를 확인하세요. 로그에 네트워크 요청 실패가 명확히 표시되면 가져오기 단계의 문제입니다. 요청은 성공했지만 설정이 생성되지 않았다면 반환 내용과 파싱 결과를 확인해야 합니다.
구독 노드는 구독 기능으로 계속 관리하는 것이 적합합니다. 사용자 지정 매개변수를 장기간 보존해야 한다면 별도의 수동 설정을 만들고 알아보기 쉬운 별칭으로 구분하세요. 그렇지 않으면 다음 업데이트에서 원래 구독 값으로 복원되어 수정한 경로, SNI 또는 포트가 사라질 수 있습니다.
그룹 필터는 현재 표시되는 행에만 영향을 주며 코어의 라우팅 규칙을 바꾸지 않습니다. 트래픽 분할에서 말하는 “그룹”은 보통 규칙 세트, 아웃바운드 태그 또는 도메인 분류를 뜻하며, 메인 창의 구독 그룹과는 다른 개념입니다. 전자는 연결 경로를 결정하고 후자는 서버 설정을 관리하는 역할을 합니다.
로그 창을 올바르게 읽는 순서
로그는 마지막 한 줄만 보지 말고 작업을 실행한 시점부터 읽어야 합니다. 정상적인 시작 과정에는 보통 설정 생성, 코어 시작, 로컬 인바운드 포트 리슨 단계가 포함됩니다. 이후 애플리케이션 트래픽이 프록시에 들어오면 대상 연결, 라우팅 결정 또는 실패 원인이 표시됩니다. 버전에 따라 출력 형식은 달라져도 “작업-대상-결과” 순서로 읽는 방법은 같습니다.
먼저 코어가 시작되었는지 확인
활성 서버를 전환한 직후 로그에 설정 오류가 표시된다면 코어가 아직 리슨 단계에 들어가지 않았을 수 있습니다. 이 상태에서는 시스템 프록시가 설정되어 있어도 트래픽이 로컬 포트를 통해 전달되지 않습니다. 해당 서버 설정을 열어 필수 항목, 포트 형식, 전송 매개변수와 보안 매개변수를 확인하세요.
다음으로 로컬 포트가 리슨 중인지 확인
코어가 시작되면 로컬 컴퓨터에 SOCKS, HTTP 또는 혼합 인바운드 포트를 엽니다. 실제 포트는 설정에 따라 달라집니다. 로그에 포트가 이미 사용 중이라고 표시되면 다른 v2rayN 프로세스, 다른 로컬 네트워크 프로그램 또는 비정상 종료 후 남은 프로세스가 해당 포트를 사용하고 있을 수 있습니다. 먼저 중복 프로세스를 확인한 뒤 필요하면 로컬 포트를 변경하세요.
마지막으로 원격 연결과 라우팅 확인
연결 시간 초과는 대상 서버에 접근할 수 없거나 네트워크 경로가 막혔거나 주소 해석에 실패했음을 뜻하는 경우가 많습니다. 연결 거부는 대상 호스트에는 도달했지만 해당 포트가 연결을 받아들이지 않는다는 의미입니다. 핸드셰이크 또는 인증 오류는 프로토콜, 보안 계층, 시간 또는 서버 매개변수 불일치를 가리킬 가능성이 큽니다. 특정 웹사이트만 비정상이고 다른 요청은 정상이라면 DNS와 라우팅 규칙을 계속 확인하세요. 서버 전체의 문제라고 바로 단정하지 마세요.
| 로그 현상 | 우선 확인할 항목 | 다음 조치 |
|---|---|---|
| 설정 파싱 실패 | 서버 항목과 코어 설정 | 현재 행을 열어 프로토콜과 전송 매개변수 대조 |
| 로컬 포트 사용 중 | 중복 프로세스와 인바운드 포트 | 중복 프로세스를 종료하거나 로컬 리슨 포트 조정 |
| 연결 시간 초과 | 서버 주소, 포트와 로컬 네트워크 | 포트를 테스트하고 사용 가능하다고 확인한 서버로 전환 |
| 핸드셰이크 실패 | TLS, REALITY, SNI, flow 등의 매개변수 | 서버가 제공한 정보에 따라 항목별로 대조 |
| 일부 도메인만 비정상 | DNS와 라우팅 일치 결과 | 도메인 규칙 순서와 해석 정책 확인 |
문제 해결을 위해 로그를 공유하기 전 서버 주소, 사용자 식별자, 구독 주소와 기타 계정 정보를 삭제하세요. 로그 수준을 장기간 가장 상세하게 유지하는 것도 피하는 것이 좋습니다. 상세 출력은 문제 재현에 적합하고, 일상적인 실행에는 일반 수준이 실제로 중요한 오류를 찾기 쉽습니다.
설정 메뉴의 네 가지 핵심 영역
설정 페이지에는 항목이 많지만 시작 단계에서는 로컬 포트, 시스템 프록시, 코어 및 라우팅, TUN의 네 영역만 이해하면 됩니다. 처음 실행한 뒤 많은 매개변수를 동시에 바꾸지 마세요. 한 번에 하나만 변경하고 변경 전 값을 기록해야 로그 결과를 비교할 수 있습니다.
로컬 포트
로컬 포트는 애플리케이션과 Xray 코어 사이의 진입점입니다. 브라우저나 다른 프로그램에서 프록시를 수동으로 설정할 때는 여기의 리슨 주소와 포트를 사용해야 합니다. 시스템 프록시 모드를 켜면 v2rayN이 해당 정보를 데스크톱 시스템의 프록시 설정에 기록합니다. 포트를 바꾼 뒤에도 이전 포트를 사용하는 애플리케이션은 즉시 연결이 끊기므로 수동 프록시 설정도 함께 업데이트해야 합니다.
시스템 프록시 모드
시스템 프록시는 데스크톱 시스템의 프록시 설정을 따르는 애플리케이션이 요청을 v2rayN으로 전달할지 결정합니다. 일반적인 상태로는 시스템 프록시 설정, 시스템 프록시 해제, 시스템 프록시 유지가 있으며 버전에 따라 명칭이 조금 다를 수 있습니다. “유지”는 프록시를 활성화하는 기능이 아니라 v2rayN이 현재 시스템 값을 변경하지 않는다는 뜻입니다.
일부 애플리케이션은 시스템 프록시를 읽지 않고, 일부 네트워크 트래픽은 HTTP 또는 SOCKS 요청이 아닙니다. 이런 경우 시스템 프록시가 켜져 있는데도 대상 프로그램이 직접 연결하는 것은 모순이 아닙니다. 먼저 해당 프로그램의 프록시 지원 여부를 확인한 뒤 프로그램 내 수동 프록시와 TUN 모드 중 적절한 방식을 선택하세요.
코어 및 라우팅
코어 설정은 실행할 구성 요소, 로그 수준, DNS 등 기본 동작을 정합니다. 라우팅 설정은 대상별로 트래픽을 프록시, 직접 연결 또는 차단 아웃바운드에 배정합니다. 기본 규칙으로 일반적인 사용을 처리할 수 있으므로 시작 단계에서 사용자 지정 규칙을 많이 쌓는 것은 권장하지 않습니다. 규칙은 일치 로직에 따라 실행되며, 범위가 지나치게 넓은 도메인 또는 네트워크 규칙이 뒤의 항목을 먼저 가로챌 수 있습니다.
라우팅을 수정한 뒤에는 직접 연결하려는 대상과 프록시를 사용할 대상을 각각 테스트하고, 로그에서 실제 아웃바운드를 확인하세요. 웹페이지가 열리는지만으로는 트래픽 분할이 예상대로 작동하는지 판단할 수 없습니다. 직접 연결과 프록시 연결이 모두 성공할 수 있지만 서로 다른 경로를 사용하기 때문입니다.
TUN 모드
TUN 모드는 가상 네트워크 인터페이스를 통해 더 폭넓은 시스템 트래픽을 가로채며, 시스템 프록시를 읽지 않는 애플리케이션에 적합합니다. 라우팅 테이블, DNS와 권한이 관련되므로 일반 시스템 프록시보다 문제 해결이 어렵습니다. 활성화하기 전에 일반 프록시 모드에서 서버 자체가 정상적으로 작동하는지 확인하세요. 그렇지 않으면 노드 문제와 트래픽 가로채기 문제를 동시에 다루게 됩니다.
한 번의 전체 작업이 각 영역을 거치는 과정
화면 영역을 연결하면 처음 사용할 때의 안정적인 절차를 만들 수 있습니다. 첫째, 구독 설정에서 출처를 추가하고 업데이트를 실행합니다. 둘째, 메인 창에서 해당 그룹으로 돌아가 서버 행이 생성되었는지 확인합니다. 셋째, 한 행을 선택해 실제 지연 시간을 측정하고 로그와 함께 결과를 판단합니다. 넷째, 사용 가능하다고 확인한 서버를 활성 서버로 지정합니다. 다섯째, 적절한 시스템 프록시 상태를 선택합니다. 여섯째, 테스트 대상에 접속하면서 로그에 요청과 라우팅 기록이 나타나는지 확인합니다.
다섯 번째 단계 이후에도 트래픽이 없으면 구독을 다시 추가하지 말고 먼저 하단 상태와 시스템 프록시를 확인하세요. 로그에 트래픽은 기록되지만 원격 연결이 실패한다면 서버 행으로 돌아가 매개변수를 확인하거나 다른 노드로 전환하세요. 특정 대상만 실패하면 DNS와 라우팅을 확인합니다. 각 현상은 화면의 특정 계층에 대응하므로 무작정 스위치를 바꾸기보다 계층별로 처리하는 편이 효과적입니다.
v2rayN을 종료하기 전에는 시스템 프록시를 어떻게 처리할지도 확인해야 합니다. 완전히 사용을 중단할 계획이라면 프로그램에서 제공하는 프록시 명령으로 시스템 프록시를 정리한 뒤 정상적으로 종료하세요. 단순히 백그라운드로 최소화할 경우에는 트레이의 실행 상태와 활성 서버가 정상인지 확인하세요. 창 닫기 동작은 설정에 따라 백그라운드로 숨기는 것일 수도 있고 프로그램을 종료하는 것일 수도 있으므로, 메인 창이 보이는지만으로 코어 상태를 판단하면 안 됩니다.
10분 점검 목록
- 구독 그룹 이름만으로 출처를 알 수 있고, 목록에 눈에 띄는 중복 구독 기록이 없습니다.
- 활성 서버 표시가 명확하며, 클릭으로 선택한 것을 전환 완료로 착각하지 않습니다.
- 주소, 포트, 프로토콜, 전송 방식과 보안 계층이 서버 설정과 일치합니다.
- 지연 시간, 포트 테스트와 속도 테스트를 각각 이해하며 단일 숫자만으로 판단하지 않습니다.
- 로그에서 코어 시작과 로컬 포트 리슨 결과를 확인할 수 있습니다.
- 시스템 프록시 상태가 현재 용도에 맞고 수동 프록시 애플리케이션이 올바른 로컬 포트를 사용합니다.
- 일반 프록시 검증을 마친 뒤 라우팅 사용자 지정이나 TUN 가로채기를 고려합니다.
- 문제가 발생하면 현재 작업을 실행한 시점부터 로그를 읽고 설정, 로컬 포트, 원격 연결, 라우팅 순서로 점검합니다.
이 영역들을 익히면 v2rayN 메인 창은 서로 따로 노는 버튼 모음이 아닙니다. 구독 그룹은 “설정이 어디에서 오는가”, 서버 목록은 “어떤 설정을 사용할 것인가”, 활성 표시는 “현재 출구는 무엇인가”, 시스템 프록시와 TUN은 “어떤 트래픽이 코어로 들어가는가”, 로그는 “요청이 어느 단계에서 성공하거나 실패했는가”에 답합니다. 이후 라우팅, DNS와 고급 전송 매개변수를 배울 때도 이 메인 화면 지도를 계속 활용할 수 있습니다.