v2rayN 첫 설치 및 초기 설정: Windows·macOS 설치와 프록시 설정 가이드

1. 설치 파일 선택과 쓰기 가능한 저장 위치

v2rayN은 노드, 구독, 실행 설정을 관리하는 GUI 클라이언트이며, 실제 연결은 코어가 처리합니다. 클라이언트를 다운로드했다고 해서 사용할 수 있는 서버까지 제공되는 것은 아닙니다. 시작하기 전에 사용할 권한이 있는 노드나 구독 주소를 준비하고, 노드의 프로토콜을 설치 파일에 포함된 코어가 지원하는지 확인하세요.

Windows용과 macOS용 패키지는 서로 바꿔 쓸 수 없으며, 같은 운영체제에서도 x64와 ARM64를 구분해야 합니다. Windows에서는 ‘설정’ → ‘시스템’ → ‘시스템 정보’에서 시스템 종류를 확인할 수 있습니다. macOS에서는 Apple 메뉴 → ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple 칩 Mac은 해당 ARM64 패키지를, Intel 프로세서는 해당 x64 패키지를 선택하세요. 압축 파일 크기만으로 판단하면 안 됩니다.

• Windows 압축 파일: 먼저 C:\Users\사용자 이름\Apps\v2rayN처럼 현재 사용자에게 쓰기 권한이 있는 위치에 압축을 모두 풉니다. 압축 프로그램의 미리 보기에서 바로 실행하거나, 실행 파일 하나만 꺼내서 실행하지 마세요.
• macOS 앱 패키지: 배포 패키지를 압축 해제하거나 마운트한 뒤 앱을 ‘응용 프로그램’ 폴더에 넣고 실행하세요. 임시로 마운트한 디스크 이미지에서 계속 실행하지 않는 것이 좋습니다.
• 종속 항목과 코어: 배포 패키지의 폴더 구조를 유지하세요. 프레임워크 종속 패키지는 호환되는 실행 환경이 필요할 수 있으며, 자체 포함 패키지에는 보통 필요한 런타임이 들어 있습니다. 누락 안내가 표시되면 해당 패키지 설명을 확인하고, 다른 버전의 동적 라이브러리를 임의로 추가하지 마세요.
• 설정과 백업: 업데이트 전에 프로그램을 종료하고 기존 설정을 백업하세요. 앱 폴더와 설정 폴더는 서로 다를 수 있으며, 위치는 운영체제와 클라이언트 빌드 방식에 따라 달라집니다.

2. 첫 실행과 구독 추가 순서

처음 실행할 때는 창이 열리는지, 설정을 저장할 수 있는지, 코어가 실행되는지 확인한 다음 시스템 프록시를 켜세요. 그렇지 않으면 시스템은 로컬 포트를 가리키는데 실제로 사용할 수 있는 서비스가 없어, 원래 열리던 웹페이지까지 접속되지 않을 수 있습니다.

1. 실행 환경 확인

   메인 프로그램을 실행합니다. Windows에서 런타임이 없다는 안내가 표시되면 제품명, 아키텍처, 버전 요구 사항을 확인한 뒤 맞는 구성 요소를 설치하세요. 모든 누락 안내를 같은 런타임 문제로 간주하지 마세요.

2. 실행 권한 확인

   macOS에서 앱 출처가 제한되었다는 안내가 표시되면 먼저 다운로드한 곳을 확인한 뒤 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에서 해당 앱을 열 수 있는지 살펴보세요. 파일이 손상되었거나 보안 소프트웨어가 위험 요소로 판단했다는 안내가 나오면 실행을 중단하고 출처를 확인하세요. 시스템 보호 기능을 바로 끄면 안 됩니다.

3. 구독 그룹 추가

   ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동해 그룹 이름과 전체 구독 주소를 입력하고 저장하세요. 일부 UI에서는 ‘+’가 추가 버튼입니다. 구독 주소는 서비스 제공업체에서 받아야 하며, 관리 페이지 주소를 구독 주소로 입력하지 마세요.

4. 구독 업데이트

   ‘구독 그룹’으로 돌아가 ‘모든 구독 업데이트(프록시 미사용)’를 실행하세요. 현재 네트워크에서 구독 서버에 접속할 수 없고 클라이언트에 사용 가능한 노드가 있다면 ‘모든 구독 업데이트(프록시 사용)’를 시도해 보세요. 처음 사용하며 노드가 하나도 없다면 프록시 사용 업데이트로 연결을 새로 만들 수는 없습니다.

5. 사용할 노드 선택

   노드 목록에서 항목을 선택하고 마우스 오른쪽 버튼 메뉴에서 ‘활성 서버로 설정’을 선택하세요. 로그에 코어 실행 실패가 표시되는지도 확인합니다. 그런 다음 시스템 프록시를 켜고 브라우저에서 정상 작동이 확인된 HTTPS 사이트를 열어 보세요. 지연 시간만 표시되는 것으로 연결이 확인된 것은 아닙니다.

구독을 추가하면 VMess, VLESS, 전송 방식, TLS 매개변수는 보통 구독 정보에서 설정되므로 ‘최적화’를 위해 직접 변경할 필요가 없습니다. 노드가 REALITY 등의 기능을 사용한다면 선택한 코어가 해당 설정을 지원하는지 확인하세요. 클라이언트에 노드 이름이 표시된다고 해서 현재 코어에서 그 노드를 실행할 수 있는 것은 아닙니다.

3. 로컬 리스닝 포트와 시스템 프록시 확인

로컬 포트는 앱이 클라이언트에 연결할 때 사용하는 진입점이고, 서버 포트는 클라이언트가 원격 노드에 연결할 때 사용하는 목적지입니다. 둘은 서로 바꿔 쓸 수 없습니다. 아래에서는 로컬 혼합 리스닝 주소 127.0.0.1:10808을 예로 들지만, 확인 방법을 설명하기 위한 예시일 뿐 모든 버전의 포트를 동일하게 바꾸라는 뜻은 아닙니다. 실제 리스닝 설정은 ‘설정’ → ‘매개변수 설정’에서 확인하세요.

현재 버전에서 HTTP 포트와 SOCKS 포트를 따로 제공한다면 SOCKS 전용 포트를 시스템의 HTTP 프록시 항목에 입력하지 마세요. 리스닝 포트를 변경한 뒤에는 UI 안내에 따라 코어를 다시 시작하거나 설정을 적용하고, 시스템 프록시도 새로 지정해야 합니다. 시스템이 이전 포트를 계속 가리키지 않는지 확인하세요.

• Windows에서는 시스템 트레이 메뉴나 메인 화면의 ‘시스템 프록시’ → ‘시스템 프록시 자동 설정’에서 켤 수 있습니다. 사용을 마치기 전에 ‘시스템 프록시 지우기’를 선택하세요. 메뉴 위치는 현재 UI에 따라 다를 수 있습니다.
• macOS에서 네트워크 설정 변경 권한을 요청하면 사용 중인 클라이언트에서 보낸 요청인지 확인하세요. 필요한 권한을 허용하지 않았다면 창이 정상적으로 표시되더라도 시스템 프록시가 적용된 것은 아닐 수 있습니다.
• 처음 테스트할 때는 다른 프록시 도구나 브라우저 전용 프록시 확장 프로그램을 함께 사용하지 마세요. 요청이 다른 경로로 전달되어 클라이언트 로그와 브라우저 결과가 일치하지 않을 수 있습니다.

4. 시스템 프록시, TUN, 라우팅 분기 선택하기

시스템 프록시와 TUN은 트래픽을 클라이언트로 전달하는 방법을 결정하고, 라우팅 분기는 클라이언트에 들어온 트래픽을 직접 연결할지 프록시로 보낼지 결정합니다. 서로 다른 단계의 설정입니다. ‘시스템 프록시 자동 설정’을 켜도 모든 연결이 프록시를 통과하는 것은 아니며, 클라이언트가 각 웹사이트의 용도를 자동으로 판단하는 것도 아닙니다.

초기에는 기본 라우팅 규칙을 유지하고 사용자 지정 도메인을 한꺼번에 많이 추가하지 마세요. 규칙은 보통 순서대로 적용되므로, 범위가 넓은 규칙을 앞에 두면 뒤의 구체적인 규칙이 적용되지 않을 수 있습니다. 특정 사이트가 직접 연결로만 열리거나 프록시로만 열리는 경우, 먼저 어떤 규칙이 적용됐는지 확인한 뒤 해당 규칙을 조정하세요. 코어, DNS, 전송 방식을 한꺼번에 바꾸지 마세요.

5. 포트 충돌과 보안 소프트웨어 차단 확인

로그에 address already in use 또는 bind 관련 오류가 나타나면 먼저 로컬 리스닝 포트가 사용 중인지 확인하세요. 클라이언트를 두 개 실행했거나 이전 코어 프로세스가 종료되지 않았거나 다른 소프트웨어가 같은 포트를 사용 중일 수 있습니다. 아래 명령은 예시 포트 10808을 확인합니다. 실제 포트가 다르면 숫자를 바꿔 사용하세요.

Windows: 리스닝 프로세스 확인

netstat -ano | findstr ":10808"

로컬 주소에 해당 포트가 표시되고 상태가 LISTENING인 행을 찾으세요. 원격 주소에 같은 숫자가 있다는 것만으로는 로컬 포트가 사용 중이라고 볼 수 없습니다. 마지막 열은 프로세스 ID이며, ‘작업 관리자’ → ‘세부 정보’에서 PID로 찾을 수 있습니다. 어떤 프로그램인지 확인한 뒤 정상적으로 종료하세요. 정체를 모르는 시스템 프로세스는 종료하지 마세요.

macOS: 리스닝 프로세스 확인

lsof -nP -iTCP:10808 -sTCP:LISTEN

출력이 이전 클라이언트 프로세스를 가리키면 메뉴에서 정상적으로 종료한 뒤 다시 실행하세요. 다른 프로그램이 해당 포트를 계속 사용해야 한다면 v2rayN의 ‘설정’ → ‘매개변수 설정’에서 로컬 리스닝 포트를 변경하고 시스템 프록시나 앱 프록시의 대상 포트도 함께 수정하세요. 출력이 없다고 노드가 정상이라는 뜻은 아닙니다. 이 명령으로 해당 TCP 포트를 리스닝하는 프로세스를 찾지 못했다는 의미일 뿐입니다.

• 메인 창은 열리지만 코어가 실행되지 않음: 보안 소프트웨어의 격리 기록과 클라이언트 로그를 확인해 코어 파일이 이동되었는지 살펴보세요. 출처를 알 수 없는 곳에서 같은 이름의 실행 파일만 따로 내려받아 폴더에 넣지 마세요.
• 파일이 차단됨: 파일 경로, 경고 이름, 발생 시각을 기록하고 다운로드 출처를 확인한 뒤 복원이나 예외 규칙 적용을 검토하세요. 다운로드 폴더 전체를 광범위한 예외 대상으로 지정하지 마세요.
• 설정을 저장할 수 없다는 안내가 표시됨: 폴더 권한, 남은 디스크 공간, 파일의 읽기 전용 여부를 확인하세요. 일반적인 시스템 프록시 사용에 항상 관리자 권한이 필요한 것은 아닙니다. 먼저 해당 폴더의 쓰기 문제를 해결하세요.

6. 첫 연결 문제 해결과 종료 확인

첫 설치가 제대로 되었는지 확인하려면 실행, 구독 추가, 접속, 종료 네 단계를 점검해야 합니다. 이후 문제를 해결할 때는 한 번에 변수 하나만 바꾸고 변경 전후의 로그를 기록하세요. 반복해서 재설치하는 것보다 원인을 찾기 쉽습니다. 도움을 요청할 때는 운영체제 종류, 클라이언트에 표시된 버전, 선택한 코어, 민감 정보를 가린 오류 로그를 제공하세요. 노드 비밀번호, 전체 공유 링크, 구독 접속 정보는 포함하지 마세요.

1. 프로그램을 다시 시작한 뒤에도 구독 그룹과 활성 서버가 올바르게 유지됩니다.
2. 시스템 프록시를 켜면 브라우저에서 대상 웹사이트에 접속할 수 있고, 로그에 코어 실행 오류가 계속 나타나지 않습니다.
3. 프록시를 끄고 클라이언트를 종료한 뒤에도 원래 직접 접속할 수 있었던 웹사이트에 정상적으로 접속됩니다.