v2rayN 설치 및 초기 설정 가이드: Windows/macOS 공통 핵심과 자주 겪는 문제

설치 전에 데스크톱 버전을 올바르게 선택하기

v2rayN은 노드를 저장하고 프록시 코어를 호출하며 시스템 프록시를 전환하고 라우팅 규칙을 적용하는 데스크톱 프록시 관리 클라이언트입니다. 자체적으로 노드 서비스를 제공하지는 않습니다. 처음 사용하기 전에 유효한 구독 주소 또는 완전한 노드 매개변수를 준비하고, 컴퓨터의 운영체제와 실행 환경도 확인해야 합니다.

Windows 사용자는 보통 WPF와 Avalonia 두 가지 데스크톱 형태를 볼 수 있습니다. WPF 버전은 Windows 기본 인터페이스에 가깝고 Windows에서만 사용할 때 적합합니다. Avalonia 버전은 Windows, macOS, Linux를 지원하며 인터페이스와 기능 배치가 더 일관적입니다. macOS 사용자는 Avalonia 버전을 선택해야 하며 Windows 실행 파일을 그대로 복사해 실행해서는 안 됩니다.

다운로드가 완료되면 압축 파일 전체를 Windows의 D:\Apps\v2rayN와 같은 고정된 폴더에 압축 해제해야 합니다. 압축 파일 미리보기 창에서 장기간 직접 실행하지 말고, 자주 정리되는 임시 폴더에 프로그램 디렉터리를 두지도 마세요. 프로그램 설정, 로그, 코어 파일에는 안정적으로 읽고 쓸 수 있는 위치가 필요합니다.

첫 실행: 코어, 포트, 로그 상태 확인

메인 프로그램을 연 직후 노드 사용 가능 여부부터 판단하지 마세요. 먼저 상태 표시줄, 코어 유형, 로컬 수신 포트를 확인해야 합니다. 코어가 정상적으로 시작되지 않으면 구독에 노드가 표시되더라도 실제 프록시 연결을 만들 수 없습니다.

버전이 다르거나 설정을 이전한 경우 다른 포트를 사용할 수 있으므로 위 숫자는 일반적인 초기값으로만 참고하세요. 실제 포트는 「설정」→「매개변수 설정」의 로컬 수신 설정을 기준으로 해야 합니다. 브라우저, 다운로드 도구, 개발 도구에서 프록시를 수동으로 입력할 때도 여기에 표시된 주소와 포트를 사용해야 합니다.

1. 전체 압축 해제

   모든 파일을 고정된 폴더에 압축 해제한 다음 메인 프로그램을 실행하세요. 폴더에 쓰기 권한이 있는지 확인하고 코어, 설정, 로그가 들어 있는 하위 폴더를 유지하세요.

2. 코어 선택

   「설정」→「매개변수 설정」→「Core 유형」으로 이동해 일상적으로 VLESS, REALITY 또는 최신 전송 설정을 사용할 때는 Xray를 우선 선택하세요.

3. 포트 확인

   매개변수 설정에서 SOCKS와 HTTP 수신 포트를 확인하고 다른 로컬 프록시 프로그램이 같은 포트를 사용하지 않는지 점검하세요.

4. 로그 확인

   메인 화면으로 돌아가 로그 영역을 열어 보세요. 정상 상태라면 코어 시작 및 수신 성공 메시지가 표시되어야 하며, 같은 오류 행이 계속 반복되어서는 안 됩니다.

5. 저장 후 재시작

   코어 또는 수신 매개변수를 변경한 뒤 설정을 저장하고 「서비스 재시작」을 실행해 새 매개변수를 실제로 불러오세요.

코어 누락은 보통 시작 직후 종료되거나, 로그에 코어 파일을 찾을 수 없다는 메시지가 표시되거나, 모든 노드 테스트가 실패하는 형태로 나타납니다. 먼저 메인 프로그램만 포함된 간소화 파일이 아니라 완전한 데스크톱 패키지를 다운로드했는지 확인하세요. 그런 다음 「Core 유형」이 현재 디렉터리에 실제로 존재하는 코어를 가리키는지 점검하세요. 코어를 전환한 뒤에는 반드시 서비스를 재시작해야 합니다.

구독을 가져와 첫 연결 완료하기

구독 주소는 노드와 프로토콜 매개변수를 한꺼번에 가져오는 데 사용됩니다. VMess, VLESS, Trojan 등의 설정이 포함될 수 있으며, v2rayN에서 흔히 사용하는 조합은 Xray 코어와 VLESS, REALITY 또는 VMess입니다. 구독을 가져오면 클라이언트가 서버에서 제공한 주소, 포트, 사용자 식별자, 전송 방식, 보안 계층 매개변수를 로컬 목록에 기록합니다.

1. 그룹 추가

   「구독 그룹」→「구독 그룹 설정」을 열고 추가를 선택한 뒤 식별하기 쉬운 메모 이름을 입력하고 전체 구독 주소를 붙여 넣으세요.

2. 구독 업데이트

   저장한 뒤 「구독 그룹」→「모든 구독 업데이트」로 이동해 노드 목록이 새로 고쳐질 때까지 기다리세요. 처음 업데이트할 때는 빠르게 여러 번 클릭하지 마세요.

3. 지연 시간 테스트

   노드 그룹을 선택해 실제 지연 시간 테스트를 실행하세요. 가정용 인터넷에서 일반적으로 사용 가능한 결과는 약 40~250밀리초이며, 시간 초과는 이번 탐지가 완료되지 않았다는 뜻일 뿐입니다.

4. 활성으로 설정

   대상 노드를 두 번 클릭하거나 마우스 오른쪽 버튼 메뉴에서 활성 서버로 설정한 뒤, 메인 화면 상태 표시줄에 선택한 노드가 표시되는지 확인하세요.

5. 프록시 시작

   적절한 시스템 프록시 모드를 선택한 다음 브라우저로 일반 웹페이지에 접속해 로그에 새로운 연결 기록이 생성되는지 확인하세요.

구독 업데이트는 성공했지만 목록이 비어 있다면 먼저 현재 구독 그룹이 활성화되어 있는지 확인한 뒤 시스템 시간을 점검하세요. VLESS와 VMess의 인증 및 보안 핸드셰이크는 올바른 매개변수에 의존하며, 일부 전송 방식은 시간 오차에도 민감합니다. 데스크톱 시스템에서는 날짜, 시간, 시간대를 자동으로 설정하도록 켜 두세요.

시스템 프록시, 브라우저 프록시, 라우팅 분할

노드가 활성 상태가 되었다는 것은 v2rayN이 아웃바운드 설정을 선택했다는 뜻일 뿐입니다. 웹페이지가 프록시를 거치는지는 시스템 프록시와 각 앱의 네트워크 설정에도 달려 있습니다. 가장 흔한 오해는 지연 시간 테스트가 성공하면 브라우저도 자동으로 로컬 포트를 사용한다고 생각하는 것입니다.

첫 연결에서는 「시스템 프록시」→「시스템 프록시 자동 설정」을 사용하는 것이 좋습니다. 그다음 브라우저 페이지를 새로 고치고 로그에 대상 도메인과 아웃바운드 기록이 나타나는지 확인하세요. 로그에 새 연결이 전혀 없다면 문제는 원격 노드보다 브라우저와 로컬 프록시 사이에서 발생했을 가능성이 큽니다.

일부 브라우저는 시스템 프록시를 읽지만, 별도로 설정된 브라우저는 자체 프록시 규칙을 계속 사용할 수 있습니다. 이전에 프록시를 수동으로 설정했다면 주소, 프로토콜, 포트를 확인하세요. SOCKS 클라이언트는 보통 127.0.0.1:10808에 연결하고 HTTP 프록시는 일반적으로 127.0.0.1:10809를 사용하지만, 최종 기준은 현재 v2rayN 매개변수입니다.

로컬 SOCKS 예시
주소: 127.0.0.1
포트: 10808

로컬 HTTP 예시
주소: 127.0.0.1
포트: 10809

라우팅 분할은 연결을 프록시, 직접 연결, 차단 중 어디로 보낼지 결정합니다. 설치를 마친 직후에는 복잡한 규칙을 바로 가져오지 않는 것이 좋습니다. 먼저 클라이언트가 제공하는 기본 규칙으로 연결을 확인한 다음 실제 필요에 맞게 조정하세요. 규칙을 위에서 아래로 매칭할 때 지나치게 넓은 직접 연결 규칙이 트래픽을 먼저 가로채면 뒤의 프록시 규칙이 작동하지 않을 수 있습니다.

• 로그에 direct가 표시됨: 연결이 직접 연결 아웃바운드로 라우팅된 것입니다. 도메인 규칙, IP 규칙, 규칙 순서를 확인하세요.
• 로그에 proxy가 표시되지만 시간 초과: 로컬 프록시가 요청을 받았으므로 노드, 회선, 프로토콜 매개변수를 계속 확인하세요.
• 로그에 요청이 없음: 브라우저가 현재 시스템 프록시를 사용하지 않거나 잘못된 로컬 포트를 입력한 것입니다.
• 일부 웹사이트만 이상함: DNS, 도메인 분할 라우팅, 브라우저 캐시를 확인하고 클라이언트를 먼저 재설치하지 마세요.

코어 유형 선택 방법과 전환이 필요한 경우

v2rayN은 관리 인터페이스이며 실제 연결은 선택한 코어가 처리합니다. Xray와 V2Ray 코어 모두 일반적인 프록시 프로토콜을 처리할 수 있지만 최신 전송 기능과 매개변수 지원 범위는 다릅니다. 구독으로 노드를 가져오면 클라이언트가 보통 설정에 맞는 호환 코어를 선택합니다. 수동으로 전환하기 전에는 노드가 사용하는 프로토콜을 먼저 확인해야 합니다.

노드가 VLESS + REALITY를 사용하고 xtls-rprx-vision Flow를 포함한다면 해당 조합을 지원하는 Xray 코어를 선택해야 합니다. 표준 VMess + WebSocket + TLS라면 두 코어 모두 처리할 수 있는 경우가 많지만, 구독에 제공된 매개변수와 클라이언트의 식별 결과를 우선해야 합니다.

전환 경로는 「설정」→「매개변수 설정」→「Core 유형」입니다. 저장한 뒤 「서비스 재시작」을 실행하고 로그에 표시되는 코어 이름과 버전을 확인하세요. 드롭다운만 바꾸고 재시작하지 않으면 기존 프로세스가 이전 코어를 계속 사용할 수 있습니다.

시작 시 자동 실행, 트레이 실행, 설정 저장

시작 시 자동 실행에는 서로 다른 두 동작이 포함됩니다. v2rayN 메인 프로그램을 시작하는 것과, 시작 후 프록시 코어 또는 시스템 프록시를 복원하는 것입니다. 프로그램 자동 실행만 선택했다고 해서 시스템 로그인 후 노드가 자동으로 선택되고 프록시 설정이 입력되는 것은 아닙니다. 처음 설정한 뒤에는 컴퓨터를 직접 재시작해 전체 동작을 확인하세요.

Windows에서 시작 시 자동 실행이 되지 않으면 먼저 시스템의 시작 앱 목록에서 v2rayN이 비활성화되지 않았는지 확인하세요. 이어 프로그램 디렉터리가 이동되지 않았는지도 점검합니다. 자동 실행 기록은 보통 기존 프로그램 경로를 가리키므로 폴더를 옮겼다면 시작 시 자동 실행 옵션을 해제한 뒤 다시 활성화해야 합니다.

macOS에서는 시스템 로그인 항목에서 v2rayN의 시작이 허용되어 있는지 확인하고 네트워크 관련 권한도 유지하세요. 프로그램이 Dock이나 메뉴 막대에만 나타나고 웹페이지가 계속 직접 연결된다면 시스템 프록시가 복원되었는지 확인하세요. 시스템 업데이트 또는 네트워크 환경 변경 후에는 프록시 설정을 한 번 다시 적용해야 할 수 있습니다.

• 종료하기 전에 설정 변경 사항이 저장되었는지 확인하고 코어 프로세스를 직접 종료하지 마세요.
• 프로그램 디렉터리를 이동한 뒤 시작 시 자동 실행을 다시 설정하고 구독 데이터가 남아 있는지 확인하세요.
• 클라이언트를 업데이트하기 전에 기존 설정 디렉터리를 백업하고, 업데이트 후 먼저 코어와 포트를 확인하세요.
• 트레이 아이콘, 코어 프로세스, 시스템 프록시는 서로 다른 세 가지 상태이므로 각각 따로 확인해야 합니다.

자주 겪는 문제는 이 순서로 해결하기

연결 문제를 점검할 때는 노드를 계속 바꾸는 것보다 일정한 순서로 확인하는 편이 효과적입니다. 구독 업데이트 여부, 시스템 시간의 정확성, 코어 실행 여부, 로컬 포트 수신 여부, 시스템 프록시 활성화 여부를 차례로 확인한 뒤 마지막으로 프로토콜 매개변수와 회선 상태를 점검하세요.

로그를 이용해 문제를 브라우저에서 로컬 포트까지, 로컬 코어에서 노드까지, 노드에서 대상 사이트까지 세 구간으로 나눌 수도 있습니다. 첫 구간에 기록이 없으면 시스템 프록시를 중점적으로 확인하고, 두 번째 구간에서 핸드셰이크가 실패하면 시간, 코어, 프로토콜 매개변수를 점검하세요. 세 번째 구간에서 계속 시간 초과가 발생하면 노드 품질과 회선 시간대를 확인하세요.

첫 설정을 마친 뒤에는 이미 사용 가능하다고 확인된 기본 설정을 하나 보존하는 것이 좋습니다. 코어, 포트, DNS, 라우팅 규칙을 동시에 변경하지 말고 한 번에 하나의 변수만 바꾼 뒤 로그와 웹페이지 접속 결과로 영향을 판단하세요. 그러면 실제 원인을 더 쉽게 찾을 수 있습니다.