Windows 또는 macOS에서 v2rayN을 처음 사용하는 분을 위한 안내입니다. 먼저 설치 파일과 코어가 정상 실행되는지 확인한 다음, 서버와 로컬 프록시 포트를 테스트하고 마지막으로 시스템 프록시와 로그인 시 자동 실행을 설정하세요. 각 단계를 따로 점검하면 프로그램 미실행, 포트 미수신, 앱의 프록시 미사용 여부를 구분하기 쉽습니다.
첫 실행 순서: 설치 파일 선택, 서버 활성화, 프록시 확인
v2rayN 7.x 데스크톱 버전을 기준으로 설명합니다. 세부 버전이나 UI 빌드에 따라 메뉴 위치가 다를 수 있으며, 특히 Windows 트레이 메뉴와 macOS 인터페이스는 차이가 있습니다. 처음 실행할 때는 사용 중인 다른 프록시 클라이언트를 종료하고, TUN과 LAN 연결은 우선 활성화하지 않아도 됩니다.
아키텍처 확인
Windows에서는 「설정」→「시스템」→「정보」에서 시스템 종류를 확인해 x64와 ARM64를 구분합니다. macOS에서는 Apple 메뉴 →「이 Mac에 관하여」에서 칩 또는 프로세서를 확인하세요. Apple 칩은 ARM64, Intel 프로세서는 x64에 해당합니다. 클라이언트와 함께 제공되는 코어는 같은 아키텍처용으로 선택해야 합니다.
설치 파일 압축 풀기
Windows 포터블 압축 파일은 전체 내용을 고정된 폴더에 압축 해제한 뒤
v2rayN.exe를 실행하세요. 압축 파일에서 프로그램만 꺼내면 필요한 파일이 빠질 수 있습니다. macOS에서는 압축을 푼 뒤v2rayN.app전체를 「응용 프로그램」으로 옮기고 그곳에서 실행하세요.테스트 서버 추가
공유 링크 하나가 있다면 복사한 뒤 메인 창의 「서버」 메뉴에서 클립보드 가져오기 항목을 선택해 추가하세요. 구독 주소만 있다면 「구독 그룹」→「구독 그룹 설정」에서 그룹을 추가한 다음 구독을 업데이트합니다. 목록에 항목이 나타나면 하나를 선택해 활성 서버로 지정하세요.
수신 포트 확인
「설정」→「매개변수 설정」을 열어 로컬 수신 포트를 확인한 뒤, 메인 창 로그에서 코어가 정상적으로 시작되었는지 살펴보세요. 실제 포트 번호와 HTTP, SOCKS, 혼합 프록시 중 어떤 연결을 받는지 기록해 두세요. 노드 편집 창에 표시된 원격 포트를 대신 사용하면 안 됩니다.
시스템 프록시 연결
클라이언트의 시스템 프록시 메뉴에서 「시스템 프록시 자동 설정」을 선택하세요. Windows에서는 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭해 메뉴를 열 수 있습니다. 그런 다음 시스템 프록시를 사용하는 브라우저에서 웹페이지를 확인하세요. 브라우저에 별도의 프록시 확장 프로그램이나 설정이 있다면 먼저 해당 변수를 제외하고 테스트하세요.
프로그램과 코어 위치: 권한·경로·아키텍처 구분하기
메인 창이 열렸다는 것은 v2rayN 인터페이스가 실행되었다는 뜻일 뿐입니다. 실제 연결 처리는 코어 프로세스가 담당합니다. 항목을 가져온 뒤에도 활성 서버에 지정된 코어를 찾고 실행할 수 있는지 확인해야 합니다. 먼저 시작 로그를 확인한 다음 설치 파일을 바꾸거나 코어를 업데이트하세요.
운영체제별 앱 위치 확인
Windows: 폴더 전체를 유지하세요
- 포터블 버전은 현재 계정에서 쓰기 가능한 고정 폴더에 두세요. 압축 파일 미리보기 창에서 프로그램을 바로 실행하거나
v2rayN.exe만 따로 복사하지 마세요. - 일반적인 7.x 폴더 구성에서는 코어가 프로그램 폴더 아래
bin에 있습니다. 예를 들면bin\xray\xray.exe입니다. 파일이 없다면 코어가 포함된 패키지를 받았는지 확인하거나 클라이언트의 코어 업데이트 메뉴를 이용해 필요한 파일을 추가하세요. - 런타임 누락 메시지와 쓰기 권한 오류는 서로 다른 문제입니다. 런타임 누락은 안내에 따라 필요한 런타임과 아키텍처를 확인하세요. 쓰기 권한 오류는 프로그램 또는 데이터 폴더에 쓸 수 있는지 점검하고, 「관리자 권한으로 실행」을 기본 해결책으로 삼지 마세요.
macOS: 앱 번들 구조 유지하기
v2rayN.app안의 실행 파일을 따로 옮기거나 이름을 바꾸지 마세요. 코어의 실제 경로는 현재 배포 패키지와 시작 로그를 기준으로 확인해야 합니다. Windows의 폴더 구조를 그대로 적용하지 마세요.- 로그에
bad CPU type in executable이 표시되면 오류가 클라이언트에서 발생했는지 코어에서 발생했는지 확인한 다음, 이 기기의 아키텍처에 맞는 패키지로 바꾸세요. 구독을 반복해서 가져와도 실행 파일의 아키텍처는 바뀌지 않습니다. - 시스템이 실행을 차단하면 먼저 구체적인 안내 문구를 확인하고 다운로드 출처와 조직 기기의 관리 정책을 점검하세요. 앱 하나를 실행하려고 시스템 보호 기능을 끄지 마세요.
앱을 옮기거나 업그레이드하기 전에 기존 인스턴스를 종료하고 현재 버전에서 사용하는 설정 폴더를 백업하세요. 위치를 바꾼 뒤에는 새 경로에서 한 번 직접 실행하고 기존 바로 가기와 자동 실행 항목도 확인하세요.
백업할 때 실행 파일만 보관하지 말고 로그를 설정 백업으로 여기지도 마세요. 구독 주소에는 액세스 토큰이 포함될 수 있고 서버 항목에는 연결 정보가 들어갈 수 있습니다. 오류 정보를 다른 사람에게 전달할 때는 오류 유형과 필요한 경로만 남기고 구독 주소, 서버 접속 정보, 경로에 불필요한 계정 이름은 삭제하세요.
코어 선택: 활성 서버의 프로토콜 설정을 기준으로
구독은 여러 항목을 가져오는 수단이고, 각 항목의 설정을 해석해 실행하는 것은 코어입니다. 구독 업데이트가 성공했더라도 모든 설정이 선택한 코어와 호환된다는 뜻은 아닙니다. 「설정」→「매개변수 설정」에서 해당 프로토콜의 코어 종류를 확인하세요. 노드 편집 창에 개별 코어 선택 옵션이 있다면 별도로 지정된 항목이 있는지도 살펴보세요.
서버 항목에 맞는 코어 사용
권장가져온 뒤 확인한 프로토콜과 전송 설정을 그대로 유지하세요. 예를 들어 항목이 VLESS + REALITY로 명시되어 있다면 해당 조합을 지원하는 Xray 코어를 사용하세요. 연결 실패의 원인을 곧바로 코어 탓으로 돌리거나, 연결을 시도하려고 REALITY를 TLS로 바꾸지 마세요.
적합한 경우: 첫 설정이며 서버 설정이 명확하게 안내된 경우
개별 항목에서 대체 코어 테스트
관리자가 특정 VMess 설정이 V2Ray와 Xray 모두 호환된다고 명확히 안내했다면, 기존 설정을 보존한 채 해당 항목의 코어만 바꾸고 시작 로그를 비교해 볼 수 있습니다. 프로토콜 이름을 인식한다고 해서 그 항목의 전송 방식과 보안 옵션까지 지원하는 것은 아닙니다.
적합한 경우: 재현 가능한 문제가 있고 코어 호환성 차이를 분리해 확인하려는 경우
로컬 포트와 시스템 프록시: 수신 여부와 연결 여부를 따로 확인
로컬 수신 포트는 같은 컴퓨터의 앱이 연결하는 포트이고, 원격 포트는 코어가 서버에 연결할 때 사용하는 포트입니다. 두 포트는 서로 다를 수 있습니다. 시스템 프록시를 켜면 운영체제 설정을 따르는 앱이 로컬 프록시에 연결할 수 있지만, 코어의 원격 연결 문제를 해결하지는 않습니다. 모든 앱의 트래픽이 이 경로를 이용한다는 뜻도 아닙니다.
- 로그에 포트 충돌이 표시되는 경우: 다른 프록시 클라이언트나 기존 v2rayN 인스턴스를 먼저 종료하세요. 해당 프로세스를 종료할 수 없다면 v2rayN에 사용 가능한 포트를 지정하고 코어를 다시 시작한 뒤 시스템 프록시를 재설정하세요. 앱에 수동으로 입력한 기존 포트도 함께 바꿔야 합니다.
- 포트가 수신 중인데 브라우저가 연결되지 않는 경우: Windows에서는 「설정」→「네트워크 및 인터넷」→「프록시」를 확인하세요. macOS에서는 「시스템 설정」→「네트워크」→현재 네트워크 서비스의 「세부사항」→「프록시」를 확인합니다. 여기서는 시스템에 실제로 설정된 값을 점검하면 되며 따로 다시 입력할 필요는 없습니다. 앱에서 HTTP 프록시를 요구한다면 SOCKS만 받는 포트를 입력하면 안 됩니다.
- 종료 후 웹페이지가 열리지 않는 경우: 시스템 프록시가 더 이상 수신하지 않는 로컬 포트를 가리키는지 확인하세요. 종료하기 전에 클라이언트에서 「시스템 프록시 지우기」를 선택할 수 있습니다. 기존에 직장이나 학교에서 지정한 프록시가 있었다면 일괄적으로 끄지 말고 원래 설정을 복원하세요.
로그인 시 자동 실행: 시작 경로와 프록시 상태 확인
수동 실행 상태에서 웹페이지가 열리는지 먼저 확인한 다음 로그인 시 자동 실행을 설정하세요. 데스크톱 앱의 자동 실행은 보통 사용자가 로그인한 뒤에 시작되므로, 기기를 켜고 로그인하기 전부터 프록시를 제공하는 기능과는 다릅니다. 자동 실행은 프로그램을 시작할 뿐, 코어가 실행되었거나 시스템 프록시가 원하는 모드로 복원되었음을 보장하지 않습니다.
- Windows에서는 먼저 「설정」→「매개변수 설정」에서 「시작 시 자동 실행」 옵션을 찾아보세요. 해당 빌드에 설정 항목이 없다면 Win + R을 눌러
shell:startup을 열고 현재 프로그램 위치를 가리키는 바로 가기를 추가할 수도 있습니다. 중복 실행을 막으려면 두 방법 중 하나만 사용하세요. - macOS에서는 「시스템 설정」→「일반」→「로그인 항목 및 확장 프로그램」에서 「응용 프로그램」에 있는 v2rayN을 로그인 시 열기 목록에 추가할 수 있습니다. 일부 버전에서는 이 페이지를 「로그인 항목」이라고 부릅니다. 앱을 옮겼다면 목록이 새 위치를 가리키는지 확인하세요.
- 로그아웃한 뒤 다시 로그인해 클라이언트가 한 번만 실행되는지, 활성 서버가 원하는 항목인지, 로컬 수신 포트와 시스템 프록시 설정이 일치하는지 확인하세요. 부팅 시 네트워크가 아직 연결되지 않았다면 네트워크가 복구된 뒤 다시 테스트하고, 자동 실행 실패인지 연결이 늦게 완료된 것인지 구분하세요.