v2rayN 설치 및 초기 설정 가이드: Windows·macOS 첫 실행 시 주의사항

설치 파일 선택: 운영체제, 아키텍처, 실행 환경

먼저 다운로드 페이지에서 운영체제와 CPU 아키텍처에 맞는 설치 파일을 고르세요. 파일 이름에 v2rayN이 있다고 해서 모두 같은 버전은 아닙니다. Windows 데스크톱 버전과 기존 WPF 버전은 인터페이스가 다르며, WPF 버전은 Windows용이므로 macOS에서 실행할 수 없습니다. macOS에서는 Apple Silicon용 arm64와 Intel용 x64 패키지를 구분해 선택해야 합니다.

v2rayN은 프록시를 설정하고 관리하는 클라이언트이며, 연결 처리는 코어가 담당합니다. 창이 정상적으로 열려도 코어가 준비되었다는 뜻은 아닙니다. 첫 실행 중 실행 환경이 없다는 안내가 표시되면 안내에 나온 프레임워크 이름, 아키텍처, 요구 사항을 확인하고 설치 파일 설명에 따라 필요한 구성 요소를 설치하세요. 이름이 비슷한 런타임을 임의로 설치하지 마세요.

첫 실행: 압축 해제 위치와 권한 안내

Windows 압축 파일은 완전히 압축을 푼 뒤 실행하세요. 압축 프로그램의 미리보기 창에서 실행 파일을 바로 열면 안 됩니다. D:\Tools\v2rayN처럼 현재 계정에서 쓸 수 있는 별도 폴더에 압축을 풀 수 있습니다. 경로는 예시일 뿐 D 드라이브가 꼭 필요한 것은 아닙니다. 실행 파일과 함께 제공된 파일, 하위 폴더를 모두 유지하는 것이 중요합니다.

실행 파일 하나만 바탕 화면에 복사하면 클라이언트가 코어 또는 다른 종속 파일을 찾지 못할 수 있습니다. 먼저 프로그램을 종료한 뒤 전체 파일을 다시 압축 해제하는 편이 파일을 하나씩 추가하는 것보다 원인을 찾기 쉽습니다. 서로 다른 폴더에 있는 프로그램 두 개를 동시에 실행하지 마세요. 설정, 로그, 포트가 서로 다른 실행 인스턴스에 해당할 수 있습니다.

1. 전체 압축 해제

   Windows에서 다운로드한 압축 파일을 ‘모두 압축 풀기’로 해제한 다음, 압축을 푼 폴더에서 실행 파일을 시작하세요. 용도를 모르는 코어 하위 폴더를 옮기거나 삭제하지 마세요.

2. 정해진 위치에서 실행

   macOS에서는 앱을 ‘응용 프로그램’으로 복사한 다음 디스크 이미지를 추출하고 앱을 여세요. 임시로 마운트된 위치에서 계속 실행하는 일을 방지할 수 있습니다.

3. 안내 내용 확인

   시스템에서 실행을 차단하면 먼저 파일 출처와 표시된 안내를 확인하세요. macOS에서 앱 실행을 허용하는 설정은 일반적으로 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에 있습니다. 출처를 확인한 앱에만 적용하고, 기기 전체의 보안 기능은 끄지 마세요.

4. 로그 확인

   클라이언트의 ‘로그’ 영역에서 파일 누락, 접근 거부, 포트 충돌이 있는지 확인하세요. 메뉴 위치는 데스크톱 인터페이스에 따라 다를 수 있으므로, 구체적인 오류가 처음 나타난 로그를 우선 확인하세요.

구독 가져오기: 주소 저장만으로 노드가 생기지는 않습니다

구독 주소는 노드 설정을 가져오는 주소이지 노드 이름이나 서비스 제공업체의 로그인 페이지가 아닙니다. 주소를 받으면 먼저 클라이언트에 구독 그룹을 만들고 업데이트를 실행하세요. 그룹만 저장하고 업데이트하지 않으면 노드 목록이 비어 있을 수 있습니다. 업데이트가 완료된 뒤에도 사용할 노드를 선택해 활성 서버로 지정해야 합니다.

데스크톱 인터페이스에 따라 메뉴가 ‘구독 그룹’ 또는 ‘구독 그룹 설정’으로 표시됩니다. 아래는 일반적인 메뉴 이름을 기준으로 설명합니다. 버튼 이름이 바뀌었다면 다른 옵션을 임의로 수정하지 말고 ‘그룹 설정’과 ‘구독 업데이트’ 기능을 찾으세요.

1. ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 ‘추가’를 선택한 다음 알아보기 쉬운 이름과 전체 구독 주소를 입력하세요.
2. 저장한 뒤 ‘구독 그룹’으로 돌아가 해당 그룹에서 ‘구독 업데이트(프록시 사용 안 함)’를 실행하세요. 사용할 수 있는 프록시가 아직 없다면 이 방법으로 불필요한 의존성을 줄일 수 있습니다.
3. 직접 연결로 구독 주소에 접속할 수 없고 이미 작동하는 프록시 노드가 있다면 ‘구독 업데이트(프록시 사용)’를 시도해 보세요. 모든 구독에서 반드시 사용해야 하는 옵션은 아닙니다.
4. 업데이트가 끝나면 노드 목록에서 노드를 선택하고, 마우스 오른쪽 버튼 메뉴의 ‘활성 서버로 설정’ 또는 현재 인터페이스에 해당하는 기능으로 활성화하세요.
5. 파싱 오류가 발생하면 주소 전체를 복사했는지, 웹페이지 주소를 잘못 붙여 넣지 않았는지, 구독 제공업체가 클라이언트에서 인식할 수 있는 형식을 제공하는지 확인하세요.

노드를 가져올 수 있다는 것은 설정을 인식했다는 뜻일 뿐, 서버 연결이 가능하다는 뜻은 아닙니다. 구독 주소에는 접속 인증 정보가 포함되는 경우가 많으므로 전체 주소가 보이는 화면을 공개하지 마세요. 도움을 요청할 때는 오류 문구와 프로토콜 종류를 남기고 구독 매개변수, 사용자 식별 정보, 민감한 서버 정보는 가리세요.

코어 선택: 프로토콜 매개변수 지원 확인

V2Ray와 Xray는 코어 프로젝트이고 v2rayN은 데스크톱 클라이언트입니다. 이름만 다른 같은 프로그램이 아닙니다. VMess와 VLESS는 노드 프로토콜, WebSocket은 전송 방식, TLS는 연결을 보호하는 방식입니다. 코어를 선택할 때는 목록의 프로토콜 약자만 보지 말고 노드의 전체 구성 조합을 지원하는지 확인하세요.

REALITY, xtls-rprx-vision 등의 매개변수를 사용하는 노드는 해당 조합을 지원하는 Xray를 선택하고, 클라이언트가 설정을 올바르게 생성하는지 확인하세요. 일반적으로 ‘설정’ → ‘매개변수 설정’ → ‘Core 유형’에서 변경할 수 있습니다. 일부 인터페이스에서는 ‘Core 유형 설정’이 별도 메뉴로 표시됩니다. 변경한 뒤 활성 노드를 다시 켜고 로그에서 실제 실행 결과를 확인하세요.

• 가져온 값은 그대로 유지하세요: 주소, 포트, 사용자 식별 정보, 전송 방식, 경로, SNI, 공개 키 등의 값은 제공업체가 정합니다. ‘최적화’를 위해 항목을 임의로 추측해 입력하지 마세요.
• 지원 범위를 확인하세요: ‘지원하지 않는 필드’ 오류가 나거나 설정을 불러오지 못하면 DNS를 먼저 바꾸지 말고, 현재 선택한 코어가 해당 설정을 지원하는지 확인하세요.
• 마지막으로 연결 오류를 확인하세요: 설정을 불러오는 데 성공했는데도 시간 초과가 발생한다면 네트워크, 서버 상태, 노드 정보를 점검하세요. 시간 초과는 파싱 실패와 다릅니다.

시스템 프록시: 로컬 주소와 수신 포트 확인

웹페이지 연결을 처음 테스트할 때는 시스템 프록시를 사용하는 것이 좋습니다. v2rayN의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택한 다음, 운영체제에 등록된 프록시 주소와 포트를 확인하세요. 이 설정은 시스템 프록시를 따르는 앱이 로컬 클라이언트에 연결하도록 하는 기능이지, 원격 서버 주소를 시스템 설정에 직접 입력하는 기능이 아닙니다.

아래 두 포트는 점검 예시입니다. 기존 설정을 덮어쓰라는 뜻도, 모든 버전이 기본으로 이 포트를 사용한다는 뜻도 아닙니다. 클라이언트 인터페이스에 따라 HTTP와 SOCKS를 하나의 혼합 수신 포트로 처리하거나 각각 별도 포트에서 수신할 수 있습니다. 혼합 수신은 한 포트에서 두 프록시 프로토콜을 처리하고, 분리 수신은 각 포트를 따로 확인해야 합니다.

로그에 포트 사용 중이라는 메시지가 나오면 중복 실행된 클라이언트나 다른 프록시 프로세스를 종료한 뒤 다시 시도하세요. 포트를 변경해야 한다면 클라이언트의 수신 포트를 수정한 다음 시스템 프록시 자동 설정을 다시 실행하고, 시스템에 등록된 포트도 함께 확인하세요. 한쪽만 바꾸면 창은 정상이고 노드는 선택되어 있어도 브라우저 연결은 실패할 수 있습니다.

연결 확인과 마무리: 한 번에 하나씩 변경

연결을 확인할 때는 활성 노드 하나, 확인된 라우팅 설정 하나, 트래픽 처리 방식 하나만 유지하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 주며, 자체 프록시 설정을 사용하거나 직접 연결하는 프로그램도 있습니다. 브라우저에서 웹페이지가 열린다고 모든 앱이 프록시를 이용하는 것은 아닙니다. 노드 지연 시간 테스트에 결과가 나와도 접속하려는 웹사이트까지 이용할 수 있다는 뜻은 아닙니다.

라우팅 규칙은 어떤 연결을 직접 연결하고 어떤 연결을 프록시로 보낼지 결정합니다. 처음 테스트할 때는 의미가 분명한 클라이언트 기본 설정을 사용하고 선택한 옵션을 기록하세요. ‘규칙이 적용되지 않은 문제’와 ‘노드를 사용할 수 없는 문제’를 구분해야 할 때만 잠시 전역 프록시로 전환해 테스트하고, 테스트가 끝나면 기존 라우팅 설정으로 되돌리세요.

• 창이 열리지 않음: 구독을 확인하기 전에 설치 파일, 아키텍처, 실행 환경부터 점검하세요.
• 노드 목록이 비어 있음: 그룹 저장 여부, 업데이트 결과, 구독 형식을 확인하세요.
• 노드 실행 오류: 코어 지원 여부, 설정 생성 결과, 로컬 포트 사용 상태를 확인하세요.
• 브라우저에 프록시 연결 실패가 표시됨: 서버 문제로 단정하기 전에 로컬 수신 설정과 시스템 프록시 포트를 확인하세요.
• 일부 웹사이트만 열리지 않음: 라우팅 규칙 적용 여부, DNS 조회, 노드에서 대상 웹사이트까지의 연결 상태를 확인하세요.

설정이 끝나면 설치 폴더, 활성 노드, 선택한 코어, 수신 포트, 시스템 프록시 상태를 기록해 두세요. 다음에 문제가 생기면 마지막으로 변경한 항목부터 확인하면 됩니다. 업그레이드 전에 설정을 백업하세요. 새 폴더와 기존 폴더의 설정이나 코어를 임의로 섞지 말고, 새 버전이 정상 작동하는지 확인하기 전에는 기존 설정을 삭제하지 마세요.