v2rayN 처음 설치 후 설정 방법: Windows·macOS 초기 설정과 문제 해결

핵심 내용

Windows 또는 macOS에서 v2rayN을 처음 사용하는 분을 위한 안내입니다. 설치 파일과 아키텍처를 확인한 뒤 노드를 가져오고, 로컬 포트와 시스템 프록시를 설정한 다음 종료 후 복원까지 순서대로 진행합니다. 127.0.0.1:10808을 예시로 확인하면서 클라이언트 미실행, 코어 미수신 대기, 원격 연결 실패를 구분하고, 마지막에 시작 프로그램을 설정합니다.

1. 시스템 아키텍처와 실행 방식 확인

v2rayN은 노드와 구독, 프록시 설정을 관리하는 데스크톱 클라이언트이며 실제 연결은 선택한 코어가 처리합니다. 창이 열려도 코어가 실행 중이라는 뜻은 아니며, 코어가 정상적으로 수신 대기해도 모든 앱이 자동으로 프록시를 사용하는 것은 아닙니다. 처음 설치할 때는 이 세 가지를 각각 확인하세요.

먼저 설치 파일 페이지에서 Windows 또는 macOS를 선택한 다음 프로세서 아키텍처에 맞는 파일을 받으세요. Windows에서는 ‘설정’ → ‘시스템’ → ‘시스템 정보’에서 시스템 종류를 확인할 수 있습니다. macOS에서는 Apple 메뉴 → ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple 칩은 ARM64, Intel Mac은 일반적으로 x64에 해당하므로 두 종류의 파일을 혼용하지 마세요.

확인 항목	Windows	macOS
설치 위치	현재 사용자에게 쓰기 권한이 있는 고정 폴더에 압축을 완전히 풉니다.	앱을 패키지 형태로 압축 해제하거나 ‘응용 프로그램’으로 옮깁니다.
실행 파일	압축을 푼 폴더의 `v2rayN.exe`	패키지에 포함된 앱 실행 항목
보관할 파일	프로그램, 코어 폴더 및 관련 파일을 함께 보관합니다.	앱 패키지 구조와 관련 파일을 그대로 유지합니다.
최초 권한	먼저 일반 사용자 권한으로 실행합니다.	먼저 앱 출처 확인 절차를 완료합니다.

Windows에서는 압축 파일 미리 보기에서 실행하지 말고, 실행 파일 하나만 따로 복사하지도 마세요. 시작할 때 .NET 런타임이 없다는 안내가 표시되면 메시지에 나온 버전과 아키텍처에 맞는 런타임을 설치하세요. Windows Desktop Runtime이 필요한 패키지는 일반 .NET Runtime만 설치해서는 해결되지 않습니다. 필요한 구성 요소는 배포 파일에 따라 다르므로 오래된 안내를 따라 특정 메이저 버전을 일괄 설치하지 마세요.

2. 첫 실행: 구독을 추가하고 노드 선택

아래에서는 일반적인 데스크톱 인터페이스의 메뉴 이름을 사용합니다. 버전에 따라 버튼 위치가 달라질 수 있으니 먼저 ‘도움말’ → ‘정보’에서 클라이언트 버전을 확인하고 같은 버전의 화면을 참고하세요. 구독 주소는 노드를 가져오는 데 사용합니다. 로컬 프록시 주소가 아니며 시스템 HTTP 프록시 입력란에 넣어도 안 됩니다.

클라이언트 실행

고정 폴더에서 클라이언트를 실행하고 우선 TUN은 켜지 마세요. 기본 창과 로그 영역이 열리는지 확인하고 v2rayN을 동시에 여러 개 실행하지 않도록 합니다.
구독 추가

‘구독 그룹’ → ‘구독 그룹 설정’을 열고 그룹을 추가한 다음 이름과 구독 주소를 입력해 저장하세요. 화면에 ‘추가’ 또는 ‘+’ 버튼이 있으면 해당 버튼으로 같은 방식의 항목을 추가하면 됩니다.
노드 업데이트

‘구독 그룹’ 메뉴에서 ‘구독 전체 업데이트(프록시 사용 안 함)’를 실행하세요. 현재 네트워크에서 구독 서버에 접속할 수 없다면 사용 가능한 노드를 먼저 설정하고 ‘프록시 사용’ 방식으로 업데이트하세요.
활성 노드로 설정

가져온 노드를 선택하고 마우스 오른쪽 버튼 메뉴에서 ‘활성 서버로 설정’을 선택하세요. 로그에서 해당 코어가 로드되기 시작하는지 확인합니다. 목록에 노드가 보인다고 해서 활성화된 것은 아닙니다.
시작 로그 확인

원격 연결을 테스트하기 전에 설정 구문 오류, 코어 파일 누락, 수신 대기 실패부터 확인하세요. 오류가 발생하면 구체적인 오류 줄을 남기고 모든 설정을 무작정 바꾸지 마세요.

3. 로컬 포트: 수신 대기 상태를 확인한 뒤 시스템 프록시 설정

‘설정’ → ‘매개변수 설정’에서 로컬 수신 대기 항목을 확인하고 주소, 포트, 프로토콜을 기록하세요. 버전에 따라 혼합 포트를 사용하거나 SOCKS와 HTTP 주소가 따로 표시될 수 있습니다. 아래의 10808과 10809는 문제 해결을 위한 예시일 뿐입니다. 현재 화면과 로그에 표시된 실제 값을 기준으로 해야 하며, 이 예시만으로 컴퓨터에서 두 포트가 모두 열려 있다고 단정할 수 없습니다.

혼합 수신 대기 예시

수신 대기 주소: 127.0.0.1
로컬 포트: 10808
프록시 프로토콜: HTTP 및 SOCKS, 코어 설정에서 지원해야 함
로컬 네트워크 연결: 처음 설정할 때는 비활성화

혼합 포트는 여러 프로토콜에서 사용할 수 있지만, 요청을 보내는 쪽에서도 올바른 프록시 유형을 선택해야 합니다.

분리 수신 대기 예시

수신 대기 주소: 127.0.0.1
SOCKS 포트: 10808
HTTP 포트: 10809
시스템 프록시 대상: 실제로 활성화된 HTTP 포트

로그에서 두 포트 모두 수신 대기 중이라고 확인된 경우에만 이 포트 구성을 사용하세요.

처음에는 이 컴퓨터에서만 사용할 수 있도록 루프백 주소를 유지하세요. 로컬 네트워크 연결을 허용하면 노출 범위가 넓어지며, 로컬 웹페이지가 열리지 않는 문제를 해결하는 만능 방법은 아닙니다. 포트를 바꾼 뒤에는 앱의 수동 설정, 시스템 프록시, 터미널 환경 변수도 함께 수정해야 합니다.

시스템 명령으로 포트 사용 여부 확인

아래 명령은 각각 Windows PowerShell과 macOS 터미널에서 수신 대기 상태만 확인합니다. 결과가 없으면 해당 포트가 현재 수신 대기 중이 아니라는 뜻입니다. 결과가 있으면 프로세스를 추가로 확인하세요. 포트가 표시된다는 사실만으로 노드 연결이 정상이라고 판단할 수는 없습니다.

# Windows PowerShell
Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

# macOS 터미널
lsof -nP -iTCP:10808 -sTCP:LISTEN

4. 시스템 프록시, PAC, TUN 중 무엇을 선택할까요?

시스템 프록시는 시스템 설정을 따르는 앱의 요청을 로컬 포트로 보낼지 결정합니다. 클라이언트 라우팅은 요청이 코어에 들어간 뒤 어떤 아웃바운드로 나갈지 결정합니다. 두 기능은 같은 설정이 아닙니다. ‘시스템 프록시 자동 설정’의 ‘자동’은 보통 프록시 설정을 자동으로 적용한다는 뜻이지, PAC가 활성화되거나 모든 프로그램의 트래픽이 프록시를 거친다는 뜻은 아닙니다.

시스템 프록시

권장

처음에는 기본 화면이나 트레이 메뉴의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택하세요. 브라우저가 시스템 설정을 따르는지 확인한 다음 클라이언트의 라우팅 모드를 확인합니다. 앱 자체에 프록시 설정이 있다면 별도로 점검하세요.

권장 대상: 처음 설정하는 경우, 브라우저 및 시스템 프록시를 따르는 데스크톱 앱

PAC 자동 프록시 스크립트

조건에 맞는 요청을 프록시로 보낼지 스크립트가 결정합니다. 현재 버전에서 해당 기능을 제공하고 앱이 PAC를 지원해야 합니다. 스크립트에 포함되지 않은 주소는 직접 연결될 수 있으므로, 이것만으로 원격 노드가 작동하지 않는다고 판단하면 안 됩니다.

권장 대상: PAC 규칙이 이미 마련되어 있고 앱에서 요청 경로를 선택하려는 환경

TUN 가상 네트워크 어댑터

가상 네트워크 인터페이스로 트래픽을 처리하며 추가 권한, 라우팅, DNS 설정이 필요할 수 있습니다. 먼저 일반 프록시 연결이 정상인지 확인한 뒤 활성화하세요. 전환할 때는 다른 가상 네트워크 어댑터 프로그램과 충돌하는지도 확인해야 합니다.

권장 대상: 시스템 프록시를 따르지 않는 앱의 트래픽을 처리해야 하고 권한 및 라우팅 문제를 직접 관리할 수 있는 환경

Windows에서는 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 적용 결과를 확인할 수 있습니다. macOS에서는 ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 서비스 → ‘세부사항’ → ‘프록시’에서 확인하세요. 유선과 무선 연결은 서로 다른 서비스로 표시될 수 있습니다. 수동으로 입력할 때는 HTTP와 HTTPS 항목을 확인하고 실제 HTTP 또는 혼합 수신 대기 포트를 사용하세요.

5. 연결 확인: 로컬 포트, 노드, DNS를 구분

속도 측정이나 연결 확인은 참고 자료일 뿐 실제 요청을 대신할 수 없습니다. 먼저 활성 노드와 코어가 정상적으로 시작됐는지 확인한 뒤 프록시를 명시한 요청으로 연결을 검증하고, 마지막으로 브라우저를 확인하세요. 브라우저 확장 프로그램이나 남아 있는 시스템 프록시 설정을 노드 문제로 오해하지 않도록 하는 데 도움이 됩니다.

로컬 포트: 로그에 수신 대기 성공이 표시되어야 하며 address already in use 또는 bind 실패가 없어야 합니다.
노드 설정: 서버 주소, 포트, 프로토콜, 전송 매개변수를 확인하세요. 구독에서 가져온 TLS, SNI, WebSocket 경로 등의 값을 다른 노드의 값으로 임의 변경하지 마세요.
실제 요청: HTTP 프록시를 지정한 명령으로 테스트한 다음 브라우저에서도 비슷한 결과가 나오는지 비교하세요.
DNS 및 라우팅: 일부 도메인만 실패한다면 DNS 조회, 직접 연결 아웃바운드, 프록시 아웃바운드 중 어디서 오류가 발생하는지 확인하세요. DNS 설정을 모두 한꺼번에 바꾸지 마세요.

# Windows: 예시 주소를 실제 HTTP 또는 혼합 포트로 바꾸세요
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

# macOS
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

여기서 10은 연결 단계의 제한 시간(초)이며 속도 지표가 아닙니다. HTTP 응답을 받았다면 해당 요청에서 원격 응답을 받은 것입니다. 다만 클라이언트 라우팅에서 대상이 직접 연결로 지정되어 있다면 원격 프록시 아웃바운드가 작동한다는 증거가 되지 않습니다. 로그에서 어떤 아웃바운드를 선택했는지도 확인하세요. TLS 오류가 나면 인증서 검증을 끄지 말고 시스템 시간, 인증서 도메인, SNI를 확인하세요.

6. 시작 프로그램 등록과 종료 후 프록시 복원

정상적으로 접속되는지 확인한 다음 ‘설정’ → ‘매개변수 설정’에서 시작 프로그램 관련 옵션을 찾으세요. 옵션 이름과 하위 메뉴 위치는 버전에 따라 다를 수 있습니다. Windows에서는 ‘설정’ → ‘앱’ → ‘시작 프로그램’에서 등록된 항목을 확인할 수도 있고, macOS에서는 ‘시스템 설정’ → ‘일반’ → ‘로그인 항목’ 또는 ‘로그인 항목 및 확장 프로그램’을 확인하면 됩니다. 시작 방식은 하나만 사용해 여러 인스턴스가 같은 포트를 차지하지 않도록 하세요.

프로그램을 장기간 보관할 위치에 둔 다음 시작 프로그램으로 등록하세요. 폴더를 옮긴 뒤 바로 가기가 작동하지 않는 문제를 예방할 수 있습니다.
재시작 후 트레이 또는 메뉴 막대에 클라이언트가 있는지 확인한 뒤 코어 로그와 로컬 포트를 점검하세요. 창이 숨겨져 있다고 프로그램이 실행되지 않은 것은 아닙니다.
종료하기 전에 ‘시스템 프록시’에서 ‘시스템 프록시 지우기’를 선택한 다음 클라이언트 메뉴에서 정상 종료하세요.
종료 후 브라우저 접속을 확인해 보세요. 클라이언트를 닫았는데도 127.0.0.1의 이전 포트를 가리킨다면 시스템 프록시 설정에서 해당 항목을 지우세요.

7. 처음 설치할 때 자주 묻는 문제

두 번 클릭해도 창이 열리지 않아요. 런타임이 설치되지 않은 건가요?

먼저 작업 관리자 또는 활성 상태 보기에서 백그라운드 인스턴스가 실행 중인지 확인하세요. 런타임이 필요하다는 안내가 표시되면 요구된 버전과 아키텍처를 설치하세요. 로그에 코어 파일이 없다고 나오면 해당 운영체제용 패키지의 압축을 다시 완전히 푸세요. 창이 열리지 않는 문제와 코어 누락은 서로 다른 오류입니다.

10808 포트가 사용 중이라고 나옵니다. 어디를 바꿔야 하나요?

먼저 위 명령으로 포트를 사용하는 프로세스를 확인하고 중복 실행 여부를 점검하세요. 출처를 알 수 없는 시스템 프로세스를 종료하지 마세요. ‘설정’ → ‘매개변수 설정’에서 사용 중이 아닌 포트(예: 10818)로 로컬 수신 포트를 바꿀 수도 있습니다. 저장하고 코어를 재시작한 뒤 시스템 프록시와 앱에 남아 있는 이전 포트도 함께 수정하세요.

노드를 선택했는데 브라우저에서 페이지가 열리지 않아요.

프록시를 지정한 curl 명령을 먼저 실행하세요. 명령은 성공하지만 브라우저에서 실패한다면 ‘시스템 프록시’ → ‘시스템 프록시 자동 설정’, 브라우저 자체 프록시 설정, 관련 확장 프로그램을 확인하세요. 명령도 실패한다면 코어 로그에서 수신 대기 오류와 원격 연결 오류를 확인하세요.

macOS에서 계속 권한 확인 창이 뜹니다. 매번 허용해야 하나요?

앱을 처음 실행할 때의 확인, 시스템 프록시 변경 권한, TUN 네트워크 권한을 구분하세요. 앱을 고정된 폴더에 두고 매번 임시 압축 해제 폴더에서 실행하지 마세요. 프록시를 바꿀 때마다 승인이 필요하다면 현재 버전의 권한 설정 안내를 확인하세요. 요청 출처를 확인하지 않은 채 비밀번호를 반복 입력하지 마세요.

구독 업데이트 시간이 초과됩니다. 다시 설치해야 하나요?

먼저 구독 주소가 온전하고 아직 유효한지 확인하세요. 사용 가능한 노드가 있으면 ‘구독 그룹’에서 프록시를 사용하는 업데이트 방식을 시도해 보세요. 연결 가능한 노드가 없다면 먼저 구독 서버에 접속할 수 있도록 문제를 해결해야 합니다. 재설치해도 만료된 주소가 복구되거나 잘린 접속 정보가 자동으로 채워지지는 않습니다.

초기 설정이 완료되었다고 볼 수 있는 기준은 클라이언트가 정상 실행되고, 활성 노드가 로드되며, 로컬 포트가 실제로 수신 대기하고, 앱 요청이 예상대로 코어에 전달되고, 종료 후 시스템 네트워크가 복원되는 것입니다. 추가로 트래픽을 분기하려면 설정 레퍼런스의 라우팅 및 DNS 설명을 확인하세요. 일상적인 사용 방법은 사용 가이드에서 볼 수 있습니다.