v2rayN 첫 설치 및 초기 설정 가이드: Windows·macOS 공통 설정과 주의사항

1. 설치 파일과 폴더: 운영체제와 프로세서 아키텍처 확인

v2rayN은 노드, 구독, 코어, 시스템 프록시를 관리하는 데스크톱 클라이언트입니다. 실제 연결은 선택한 Xray-core, sing-box 등의 코어가 처리합니다. 클라이언트를 다운로드했다고 해서 사용할 수 있는 노드까지 확보되는 것은 아닙니다. 구독 주소나 노드 정보는 별도로 준비해야 하며, 신뢰할 수 있는 출처에서 받아야 합니다.

먼저 다운로드 페이지에서 운영체제와 프로세서 아키텍처에 맞는 파일을 선택하세요. Windows에서는 「설정」→「시스템」→「시스템 정보」에서 시스템 종류를 확인할 수 있습니다. macOS에서는 Apple 메뉴의 「이 Mac에 관하여」에서 칩 또는 프로세서를 확인하세요. Apple 칩에는 보통 arm64 패키지를, Intel 프로세서에는 x64 패키지를 선택합니다. 파일 크기만 보고 설치 파일을 고르지 마세요.

2. 첫 실행: 설정 저장과 코어 실행 확인

처음 실행할 때 DNS, 라우팅, TUN, 포트를 한꺼번에 변경하지 마세요. 기본 설정을 유지하고 기본 창의 로그를 확인하세요. 화면이 열렸다는 것은 그래픽 프로그램이 실행됐다는 뜻일 뿐입니다. 노드를 선택한 뒤 코어 프로세스가 정상적으로 시작되고 포트 충돌이나 파일 누락 오류가 없는지도 확인해야 합니다.

1. 압축 파일 전체 풀기

   Windows에서는 압축 파일 안의 모든 파일과 하위 폴더를 풀고, macOS에서는 패키지에 포함된 안내에 따라 설치하세요. 기본 프로그램만 복사하거나 서로 다른 버전의 코어 폴더를 임의로 합치지 마세요.

2. 설정 확인

   「설정」→「매개변수 설정」에서 로컬 수신 포트와 현재 코어 관련 옵션을 확인하세요. 플랫폼과 버전에 따라 하위 메뉴 이름이 다를 수 있으니, 다른 버전의 스크린샷을 그대로 따르지 말고 현재 표시된 값을 기록하세요.

3. 노드 가져오기

   기본 화면의 「구독 그룹」 메뉴에서 구독을 관리하거나, 「서버」 메뉴의 클립보드 가져오기 기능으로 노드를 하나씩 추가하세요. 가져온 뒤 프로토콜, 주소, 포트, 전송 방식을 확인하세요.

4. 활성 노드로 설정

   노드 목록에서 노드를 선택하고 마우스 오른쪽 버튼 메뉴의 「활성 서버로 설정」을 선택하세요. 노드 행이 선택된 것만 확인하지 말고 로그에서 선택한 코어가 정상적으로 시작됐는지 확인하세요.

5. 저장 후 재실행

   시작 프로그램 설정은 우선 보류하세요. 클라이언트를 정상 종료한 뒤 다시 열어 구독, 노드, 설정값이 유지되는지 확인하세요. 설정이 사라졌다면 먼저 쓰기 권한과 데이터 폴더 위치를 점검하세요.

로그에 코어 실행 파일을 찾을 수 없다는 메시지가 나오면 설치 파일에 해당 코어가 포함되어 있는지, 파일이 온전한지, 보안 프로그램이 격리했는지 확인하세요. 「코어 유형」 옵션만 바꾸면 파일이 준비된다고 생각하면 안 됩니다. 출처를 확인하지 않은 차단 파일을 복원하지 마세요.

3. 구독과 노드: 가져오기에 성공해도 연결된 것은 아닙니다

구독은 노드 설정을 가져오는 경로이지 프록시 수신 주소가 아닙니다. 전체 구독 링크에는 액세스 토큰이 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 공개 댓글에 올리거나 문제 해결용 스크린샷에 전체 주소가 보이게 해서는 안 됩니다. 노드 이름은 변경할 수 있지만 프로토콜과 전송 매개변수는 서버 설정과 일치해야 합니다.

• 그룹 추가: 「구독 그룹」→「구독 그룹 설정」에서 항목을 추가하고, 이름과 구독 주소를 입력한 뒤 저장하세요. 메뉴 이름이 다르면 현재 버전의 구독 관리 메뉴를 확인하세요.
• 구독 갱신: 「구독 그룹」으로 돌아가 해당 구독의 갱신 작업을 선택하세요. 사용할 수 있는 프록시가 없는 첫 설정에서는 직접 연결로 갱신을 시도하세요. 사용 가능한 노드가 있는데 직접 연결이 실패한 경우에만 프록시를 통한 갱신을 시도하세요.
• 결과 확인: 노드 목록에 개별 서버 항목이 표시되어야 합니다. 목록이 비어 있다면 먼저 구독 요청이 성공했는지 확인한 다음, 응답 내용이 클라이언트에서 지원하는 구독 형식인지 살펴보세요.
• 활성 노드 선택: 노드 하나를 활성 서버로 설정한 뒤 연결 테스트를 실행하세요. 목록에 노드가 수십 개 표시되어도 현재 사용할 출구 노드가 선택됐다는 뜻은 아닙니다.

VMess와 VLESS는 프록시 프로토콜이고 WebSocket은 전송 방식입니다. TLS와 REALITY는 보안 계층 관련 설정이므로 서로 바꿔 쓸 수 없습니다. 직접 입력할 때는 서버 주소, 포트, 사용자 ID, 전송 유형, 보안 매개변수를 모두 확인하세요. 예를 들어 WebSocket 경로 /ws와 /는 서로 다르며, TLS의 서버 이름이 연결 주소와 같지 않을 수도 있습니다.

4. 로컬 포트: 브라우저 접속 포트와 원격 포트 구분

원격 서버 포트와 로컬 프록시 포트는 서로 다릅니다. 노드가 443 포트를 사용한다고 해서 브라우저의 로컬 프록시도 443으로 설정해야 하는 것은 아닙니다. 브라우저는 로컬 수신 주소에 연결하고, 코어가 원격 서버에 연결합니다. 아래 두 카드는 흔히 쓰이는 설정 예시이며 두 수신 방식을 동시에 만들라는 뜻은 아닙니다.

로그에 address already in use가 표시되면 수신 주소나 포트가 이미 사용 중이라는 뜻입니다. 중복 실행된 클라이언트를 종료한 뒤 다른 프록시 프로세스가 있는지 확인하세요. 포트를 바꿔야 한다면 시스템 프록시와 앱 내부의 수동 프록시 설정도 함께 변경해야 합니다. 클라이언트에서만 바꾸면 앱은 계속 이전 포트에 연결합니다.

• 한 대의 기기에서 사용할 때는 루프백 주소로 수신하도록 설정하세요. 처음 연결하기 위해 LAN 접근을 허용할 필요는 없습니다.
• 127.0.0.1은 현재 기기를 가리킵니다. 다른 기기에 이 주소를 입력해도 v2rayN을 실행 중인 컴퓨터에 연결되지 않습니다.
• 이 기기의 브라우저에서 사용하기 위해 라우터에 포트 포워딩을 설정할 필요는 없습니다. 로컬 프록시 주소를 인터넷에 직접 노출해서도 안 됩니다.

5. 시스템 프록시와 TUN: 첫 설정에서는 한 가지 연결 방식부터

노드는 실행됐는데 브라우저가 프록시를 사용하지 않는다면 시스템 프록시가 설정되지 않았을 수 있습니다. Windows 알림 영역이나 macOS 메뉴 막대에서 v2rayN 메뉴를 열고 「시스템 프록시」→「시스템 프록시 자동 설정」을 선택하세요. 여기서 말하는 「자동 설정」은 클라이언트 메뉴의 기능이며, 브라우저 PAC 스크립트 모드와 같은 뜻이 아닙니다.

시스템 프록시는 「앱에서 코어로 트래픽을 전달하는 방법」을 설정하고, 라우팅은 「코어에 들어온 트래픽을 어디로 보낼지」를 결정합니다. 시스템 프록시를 켜도 라우팅 설정에 따라 일부 대상은 직접 연결될 수 있습니다. 처음 테스트할 때는 기본 라우팅을 유지하고 현재 규칙상 프록시를 사용해야 하는 대상을 선택하세요. 원래 직접 연결되는 웹사이트로 프록시 동작을 판단하지 마세요.

6. 연결 확인: 코어 로그부터 실제 요청까지

노드 지연 시간은 해당 테스트에 응답이 있었다는 뜻일 뿐, 웹페이지, DNS, 전송 계층이 모두 정상이라는 의미는 아닙니다. 처음에는 아래 순서로 확인하고 한 번에 하나씩만 변경하세요. 테스트에 사용한 노드, 라우팅 모드, 로컬 포트를 기록해 두는 것이 좋습니다.

1. 시작 확인: 활성 노드를 선택한 뒤 로그에 설정 구문 분석 실패, 코어 종료, 수신 포트 충돌 오류가 없는지 확인하세요.
2. 접속 경로 확인: 브라우저가 시스템 프록시를 사용하는지, 또는 앱에서 활성화된 로컬 포트를 지정했는지 확인하세요.
3. 요청 확인: 현재 규칙상 프록시를 사용해야 하는 HTTPS 페이지를 열고, 접속 성공 여부와 관련 로그 오류를 확인하세요.
4. 재현 확인: 브라우저를 닫았다가 다시 열고 클라이언트도 정상적으로 재시작해 연결이 반복해서 되는지 확인하세요.

기기에서 curl을 사용할 수 있다면 브라우저 설정을 거치지 않고 지정한 접속 주소로 테스트할 수 있습니다. 아래 예시는 10808이 SOCKS 또는 혼합 포트임을 확인한 경우에만 사용하세요. Windows에서는 curl.exe를 사용하고, macOS에서는 명령어 이름을 curl로 바꿀 수 있습니다. 예시 도메인은 요청 과정을 확인하기 위한 것이며, 실제 프록시 사용 여부는 라우팅 규칙에 따라 달라집니다.

curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

socks5h는 대상 도메인 이름을 프록시 서버에서 조회하도록 지정합니다. 위의 10초는 연결 제한 시간이고 20초는 전체 요청의 제한 시간이며, 실제 측정된 지연 시간이 아닙니다. 로컬 포트 연결에 실패하면 코어 실행 여부와 수신 설정을 먼저 확인하세요. 로컬 포트에는 연결됐지만 원격 핸드셰이크가 실패하면 노드 매개변수, 시스템 시간, 네트워크 연결을 점검하세요.

7. 시작 프로그램과 자주 묻는 질문: 안정적으로 작동한 뒤 자동 실행 설정

수동 실행, 구독 갱신, 웹페이지 접속이 모두 정상임을 확인한 뒤 「설정」→「매개변수 설정」에서 현재 버전의 시작 프로그램 옵션을 찾으세요. macOS에서는 「시스템 설정」→「일반」→「로그인 항목」에서 로그인 시 앱 실행이 허용됐는지 확인할 수도 있습니다. 메뉴 이름은 시스템 버전에 따라 조금씩 다를 수 있습니다.

• 시작 방법은 하나만 설정: 시스템 로그인 항목, 바로가기, 클라이언트 자동 실행을 동시에 추가하면 여러 인스턴스가 같은 포트를 사용하려고 할 수 있습니다.
• 실행과 연결은 별개: 컴퓨터를 켤 때 클라이언트가 실행되더라도 코어가 정상적으로 시작되거나 시스템 프록시가 설정된다는 보장은 없습니다.
• 업데이트 전에 백업: 클라이언트를 정상 종료한 뒤 현재 설정과 구독 정보를 백업하세요. 코어가 실행 중일 때 파일을 덮어쓰지 마세요.
• 재시작 후 확인: 활성 노드가 유지됐는지, 포트가 일치하는지, 브라우저에서 실제 요청이 가능한지 확인하세요.

첫 설치가 완료됐다고 판단하려면 설정이 저장되고, 코어가 실행되며, 노드 하나로 실제 요청을 완료하고, 클라이언트를 종료한 뒤 직접 연결이 복구되어야 합니다. 이 네 가지를 확인한 다음 TUN, 앱별 프록시, 사용자 지정 라우팅을 단계적으로 추가하면 문제가 생겼을 때 원인을 찾기 쉽습니다.