v2rayN을 처음 설정한다면 ‘시스템 아키텍처 확인 → 프로그램과 설정 파일 배치 → 노드 가져오기 → 코어 확인 → 시스템 프록시 설정’ 순서로 진행하는 것이 좋습니다. Windows와 macOS를 처음 사용하는 분을 위해 프로그램 실행, 코어 실행, 앱 트래픽의 프록시 연결이 서로 다른 단계임을 설명합니다. 먼저 브라우저에서 연결을 확인한 뒤 TUN과 복잡한 라우팅 규칙을 설정하세요.
1. 다운로드 전 플랫폼·아키텍처·실행 환경 확인
v2rayN은 노드, 구독, 라우팅 규칙을 관리하는 데스크톱 클라이언트이며, 실제 프록시 연결은 코어가 처리합니다. 프로그램을 다운로드했다고 바로 사용할 수 있는 노드가 생기는 것은 아닙니다. 화면이 열리더라도 패키지에 포함된 코어가 정상적으로 실행된다는 보장은 없습니다. 처음 설치할 때는 운영체제와 프로세서 아키텍처를 확인하고, 배포 패키지에 실행 환경과 코어가 포함되어 있는지도 살펴보세요.
Windows·macOS 설치 전 확인 사항
Windows
- ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인해 x64와 ARM64를 구분합니다.
- 압축 파일을 완전히 푼 뒤 메인 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하지 마세요.
- .NET 실행 환경이 없다는 안내가 나오면 최신 배포 안내에서 필요한 구성 요소와 아키텍처를 확인하세요. 오래된 튜토리얼만 보고 임의의 버전을 설치하지 마세요.
macOS
- Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 정보를 확인해 Apple 칩과 Intel 프로세서를 구분합니다.
- 배포 패키지 안내에 따라 압축을 풀거나 ‘응용 프로그램’ 폴더에 넣으세요. 임시로 마운트된 위치에서 계속 실행하지 마세요.
- 시스템에서 실행을 차단하면 먼저 다운로드 출처와 패키지가 맞는지 확인한 뒤 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에 표시된 구체적인 안내를 살펴보세요.
Windows와 macOS 모두 해당 배포 패키지의 시스템 요구 사항을 충족해야 합니다. 실행 환경이 패키지에 포함되어 있는지는 현재 다운로드 안내를 확인하세요.
Windows에서는 D:\Tools\v2rayN처럼 현재 사용자에게 쓰기 권한이 있는 위치에 포터블 폴더를 둘 수 있습니다. 이는 경로 예시일 뿐 D 드라이브가 꼭 필요한 것은 아닙니다. 추가 권한이 필요한 시스템 폴더는 피하고, 사용 중인 프로그램 폴더를 자주 옮기지 마세요. macOS에서는 앱 본체와 사용자 설정이 서로 다른 위치에 저장될 수 있다는 점도 확인해야 합니다.
2. 첫 실행: 노드를 가져온 다음 연결 시작
v2rayN을 처음 실행할 때는 기본 라우팅과 DNS 설정을 그대로 두세요. 이 단계에서 수신 포트를 바꾸거나 가상 네트워크 어댑터를 켜고 코어까지 교체할 필요는 없습니다. 한 번에 한 가지씩 설정해야 문제가 생겼을 때 구독, 노드, 로컬 설정 중 어디에서 원인이 발생했는지 파악하기 쉽습니다. 아래 경로는 일반적인 중국어 인터페이스를 기준으로 합니다. 배포판에 따라 버튼 위치가 달라질 수 있으니 실제 메뉴와 항목의 의미를 확인하세요.
-
설치 위치 확인
압축을 풀거나 앱을 배치한 뒤 v2rayN을 실행하세요. 설정이 저장되는지 확인하고, 프로그램을 닫았다 다시 열어도 설정이 유지되는지 살펴보세요. 저장 오류가 발생하면 먼저 폴더 권한을 확인하세요.
-
구독 추가
‘구독 그룹’ → ‘구독 그룹 설정’을 열고 그룹을 추가한 뒤 이름과 전체 구독 주소를 입력해 저장하세요. 구독이 없다면 ‘서버’ → ‘클립보드에서 공유 링크 가져오기’를 사용할 수 있습니다. 구독 URL을 단일 노드 링크로 가져오지 않도록 주의하세요.
-
목록 업데이트
‘구독 그룹’ 메뉴에서 해당 구독의 업데이트 기능을 선택하세요. 사용할 수 있는 프록시가 아직 없다면 프록시를 거치지 않고 먼저 업데이트해 보세요. 목록이 비어 있으면 가져오기 결과와 파싱 안내를 확인하고, 같은 그룹을 반복해서 추가하지 마세요.
-
노드 선택
노드를 선택하고 마우스 오른쪽 버튼 메뉴에서 ‘활성 서버로 설정’을 선택하세요. 활성 표시와 로그를 확인해 코어가 오류 없이 실행되었는지 살펴보세요. 목록에서 행을 강조 표시하는 것만으로는 활성 노드가 바뀌지 않을 수 있습니다.
-
프록시 설정
하단 상태 표시줄이나 트레이 메뉴의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택하세요. 시스템 프록시를 따르는 브라우저로 접속 가능한 HTTPS 페이지를 열고, 로그를 확인해 요청이 코어로 전달되는지 살펴보세요.
구독 주소에는 보통 계정 인증 정보가 포함되므로 계정 정보처럼 안전하게 다루세요. 문제를 확인할 때 상태 코드, 오류 문구, 프로토콜 유형은 공유해도 되지만 전체 구독 주소, 노드 비밀번호, UUID를 공개 토론 게시판에 올리지 마세요. 가져오는 방법은 v2rayN 가져오기 가이드에서 확인할 수 있습니다.
3. 코어 선택: 프로토콜과 보안 계층에 맞추기
V2Ray, V2Fly, Xray는 v2rayN 인터페이스의 서로 다른 테마가 아닙니다. 클라이언트는 노드 매개변수를 코어 설정으로 변환하며, 어떤 프로토콜·전송 방식·보안 계층 조합을 지원할지는 코어가 결정합니다. Project V, V2Fly, Xray의 기술 문서를 참고하면 각 항목을 이해하는 데 도움이 됩니다. 실제 지원 여부는 로컬 코어 버전과 클라이언트의 호환성을 확인해야 합니다.
| 노드 유형 또는 증상 | 우선 확인할 항목 | 혼동하지 말 것 |
|---|---|---|
| VMess 노드 | UUID, 전송 방식, TLS, 경로, 시스템 시간이 올바른지 확인 | VMess 지원이 모든 전송 방식 조합과의 자동 호환을 뜻하지는 않습니다 |
| VLESS + REALITY | 해당 조합을 지원하는 Xray 코어를 사용하고 publicKey, shortId, serverName 등 서버에서 요구하는 항목을 확인하세요 | REALITY는 보안 계층 방식이지 독립적인 아웃바운드 프로토콜이 아닙니다 |
| 알 수 없는 필드 안내 | 구독 형식, 클라이언트의 변환 결과, 코어의 해당 필드 지원 여부를 확인하세요 | 구독을 업데이트해도 코어에 없는 기능이 자동으로 추가되지는 않습니다 |
| 코어가 바로 종료됨 | 먼저 설정 파싱, 실행 파일 경로, 권한, 수신 포트 오류를 확인하세요 | 코어가 실행되지 않는 상태에서는 시스템 프록시 모드를 바꿔도 연결 문제가 해결되지 않습니다 |
확인이 필요하면 ‘설정’ → ‘매개변수 설정’을 열어 현재 배포판에서 제공하는 코어 선택 항목을 찾으세요. 일부 버전은 ‘Core 유형’을 별도 화면에서 설정하거나 프로토콜별로 지정하며, 모든 버전에 공통 전역 전환 기능이 있는 것은 아닙니다. 오래된 인터페이스 화면만 보고 이미 이동된 항목을 억지로 찾지 마세요.
- 구성 안내가 명확한 경우: 노드 제공자가 지정한 코어와 매개변수 요구 사항을 우선 따르세요.
- 가져온 뒤 항목이 사라진 경우: 공유 링크와 구독 형식을 현재 클라이언트가 인식하는지 먼저 확인하세요. 프로토콜 이름만 바꾸지는 마세요.
- 코어를 방금 교체한 경우: 연결을 다시 시작하고 로그를 확인해 새 파일이 로드되었는지 살펴보세요. 기존 프로세스가 계속 실행 중일 수 있습니다.
4. 시스템 프록시·라우팅·TUN의 차이
‘시스템 프록시가 켜짐’은 운영체제의 프록시 설정이 변경되었다는 뜻일 뿐, 모든 프로그램이 이를 사용한다는 뜻은 아닙니다. 브라우저는 대체로 시스템 설정을 따르지만 일부 명령줄 도구, 게임, 자체 네트워크 연결을 관리하는 프로그램은 따르지 않습니다. 처음 설정할 때는 시스템 프록시를 따르는 앱 하나에서 연결을 확인한 다음, 다른 앱에 프록시 주소를 별도로 지정해야 하는지 판단하세요.
| 설정 | 해결하는 문제 | 처음 설정할 때 권장하는 방법 |
|---|---|---|
| 시스템 프록시 자동 설정 | 시스템 프록시를 따르는 프로그램을 로컬 프록시 주소에 연결 | 먼저 이 설정으로 브라우저 접속을 확인하세요 |
| 라우팅 규칙 | 코어로 전달된 요청을 프록시, 직접 연결, 차단 중 어디로 보낼지 결정 | 우선 기본 규칙을 사용하고 연결이 정상인지 확인한 뒤 하나씩 조정하세요 |
| TUN 모드 | 가상 네트워크 어댑터와 시스템 라우팅을 이용해 더 많은 트래픽을 처리 | 기본 연결이 정상인지 확인한 다음 권한, 라우팅, DNS 설정을 살펴보세요 |
‘전역 프록시’를 하나의 공통 기술 스위치로 이해하면 안 됩니다. 라우팅 규칙에서 모두 프록시로 보내도록 설정해도 보통 코어에 전달된 트래픽에만 적용됩니다. 시스템 프록시를 우회하는 프로그램까지 자동으로 연결해 주지는 않습니다. TUN은 더 넓은 범위의 트래픽을 처리하지만 라우팅 제외 규칙과 플랫폼 구현의 영향을 받으므로 첫 실행에 반드시 필요한 설정은 아닙니다.
5. 로컬 포트: 수신 주소와 서버 포트 구분하기
로컬 수신 포트는 브라우저나 다른 프로그램이 v2rayN에 연결하는 진입점이고, 서버 포트는 원격 노드에 속합니다. 로컬 포트를 바꿔도 원격 서버의 연결 거부 문제는 해결되지 않습니다. ‘설정’ → ‘매개변수 설정’에서 로컬 수신 설정을 확인하고 메인 화면에 표시된 포트와 대조하세요. 튜토리얼의 예시를 현재 버전의 고정 기본값으로 간주하지 마세요.
현재 HTTP 또는 혼합 프록시 진입점이 실제로 127.0.0.1:10808에서 수신한다고 가정하면, 앱의 HTTP 프록시 주소에 이 주소를 입력할 수 있습니다. 해당 포트에서 SOCKS만 제공한다면 앱에서도 SOCKS 유형을 선택해야 합니다. 일부 배포판은 혼합 진입점을 제공하고 다른 설정은 서비스를 분리해 수신하므로 실제 인바운드 유형을 확인하세요.
- 포트 사용 중: 로그에
address already in use또는 바인딩 실패가 표시되면 v2rayN이 중복 실행 중인지 먼저 확인한 다음, 다른 프로그램이 같은 수신 주소와 포트를 사용 중인지 살펴보세요. - 이 기기에서만 사용: 일반적으로 루프백 주소로 수신하도록 두는 것이 적절합니다.
127.0.0.1은 현재 기기를 가리키므로 휴대폰에 이 주소를 입력하면 휴대폰 자체에 연결됩니다. - LAN에서 접속: LAN 연결을 허용하면 외부에 노출되는 범위가 달라지므로 방화벽과 접근 제어도 고려해야 합니다. 처음 설치할 때 테스트 편의를 위해 바로 열어 두는 것은 권장하지 않습니다.
- 포트를 변경한 뒤: 연결을 다시 시작하고 프록시를 수동 설정한 앱의 포트도 함께 변경하세요. 시스템 프록시 설정도 다시 적용해 이전 포트를 계속 참조하지 않도록 하세요.
6. 자주 묻는 문제: 실행·구독·연결 단계별 점검
문제를 해결할 때 먼저 실패가 발생한 단계를 기록하세요. 프로그램이 열리지 않는지, 구독을 가져오지 못하는지, 코어가 시작되지 않는지, 특정 앱만 접속하지 못하는지 구분해야 합니다. 현재 노드와 설정은 그대로 두고 한 번에 한 항목만 바꾸세요. 속도 측정 결과는 참고 자료일 뿐 실제 요청과 로그를 대신하지 못합니다. 노드 이름이 표시되거나 목록에 항목이 있다고 해서 서버를 사용할 수 있다는 뜻도 아닙니다.
창이 잠깐 나타났다가 종료되는데, 바로 다시 설치해야 하나요?
먼저 다운로드한 패키지의 플랫폼과 아키텍처가 맞는지, 압축을 완전히 풀었는지, 실행 시 시스템 오류 안내가 있었는지 확인하세요. Windows에서 실행 환경 누락이 명확히 안내되면 배포 안내에 따라 필요한 구성 요소를 설치하세요. macOS에서는 앱 보안 안내를 먼저 확인하세요. 설정을 백업하지 않은 상태에서 폴더를 반복해서 덮어쓰지 마세요.
구독 업데이트 시간이 초과되면 프록시 사용을 선택해야 하나요?
사용할 수 있는 노드가 있을 때만 프록시를 통한 업데이트가 구독 주소 접속에 도움이 될 수 있습니다. 처음부터 목록이 비어 있고 연결 가능한 노드도 없다면 이 옵션을 켜도 시간 초과가 계속될 수 있습니다. 주소가 온전한지와 구독이 만료되지 않았는지 확인한 뒤 네트워크 요청 실패와 콘텐츠 파싱 실패를 구분하세요.
노드를 선택했는데 브라우저가 열리지 않아요
노드가 활성 서버로 설정되었는지, 로그에 코어 종료나 포트 바인딩 오류가 없는지 확인한 뒤 ‘시스템 프록시 자동 설정’을 다시 적용하세요. 로그에 브라우저 요청이 없다면 프록시 진입점을 먼저 확인하세요. 요청은 있지만 연결되지 않는다면 노드 매개변수, 원격 연결 상태, DNS 오류를 점검하세요.
브라우저는 되는데 다른 프로그램은 왜 안 되나요?
먼저 해당 프로그램이 시스템 프록시를 따르는지 확인하세요. 프록시를 수동 설정할 수 있다면 실제 로컬 주소, 포트, 프로토콜 유형을 입력하세요. 다른 트래픽까지 처리해야 하는 경우에만 TUN을 고려하세요. 방화벽을 바로 끄지 마세요. 프록시에 들어오지 않은 요청이 반드시 방화벽 문제인 것은 아닙니다.
종료한 뒤 일반 웹페이지도 열리지 않아요
v2rayN을 다시 열고 ‘시스템 프록시’에서 ‘시스템 프록시 지우기’를 선택한 뒤 정상적으로 종료하세요. Windows에서는 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 확인하고, macOS에서는 ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 서비스 → ‘세부사항’ → ‘프록시’를 확인하세요. 조직에서 관리하는 기기의 설정은 임의로 삭제하지 마세요.
7. 초기 설정을 마친 뒤 확인할 항목
기본 연결이 안정된 뒤 사용자 지정 라우팅, DNS 정책, TUN을 추가하세요. 기능을 하나 추가할 때마다 브라우저와 자주 사용하는 프로그램을 확인하고 종료 후 네트워크가 복구되는지도 점검하세요. 업그레이드 전에 구독 그룹과 사용자 지정 규칙을 백업하세요. 백업 파일에는 인증 정보가 들어 있을 수 있으므로 보호된 위치에 보관하고 스크린샷 첨부 파일처럼 공개하지 마세요.
- 프로그램과 코어가 모두 정상적으로 실행되고, 클라이언트를 다시 시작해도 설정이 유지됩니다.
- 활성 노드가 명확하며 프로토콜, 전송 방식, 보안 계층 매개변수가 서버 요구 사항과 일치합니다.
- 시스템 프록시를 따르는 브라우저에서 실제 웹페이지 접속을 확인했습니다.
- 로컬 수신 주소, 포트, 인바운드 유형을 확인했으며 LAN 진입점을 실수로 열어 두지 않았습니다.
- 시스템 프록시를 지우는 방법을 알고 있으며 프로그램 종료 후 일반 네트워크 연결이 복구됩니다.
처음부터 절차를 다시 확인하려면 클라이언트 설정 가이드를 참고하세요. 구독 형식에 문제가 있다면 구독 변환 및 호환성 안내를 확인하세요. 모든 옵션을 한꺼번에 초기화하기보다 먼저 문제가 발생한 단계를 파악하는 편이 원인을 찾기 쉽습니다.