Windows나 macOS에서 v2rayN을 처음 사용한다면, 먼저 운영체제에 맞는 설치 파일을 고르고 설정이 저장되는지 확인하세요. 신뢰할 수 있는 출처의 노드나 구독을 하나만 추가한 뒤 시스템 프록시를 켜고 브라우저에서 확인합니다. 문제가 생기면 ‘프로그램 실행 여부, 코어의 포트 대기 여부, 앱의 프록시 사용 여부’ 순서로 점검하고, 한 번에 하나씩만 변경하세요.
맞는 설치 파일 고르기: 프로세서와 실행 환경 확인
v2rayN은 설정을 관리하는 데스크톱 클라이언트입니다. 실제 연결은 Xray 같은 코어가 처리합니다. 창이 열린 것은 클라이언트가 실행됐다는 뜻일 뿐입니다. 패키지에 필요한 코어가 없거나 운영체제가 코어 실행을 차단하면 노드를 선택해도 연결되지 않을 수 있습니다.
Windows·macOS 설치 전 확인 사항
Windows
- ‘설정’ → ‘시스템’ → ‘정보’에서 ‘시스템 종류’를 확인한 다음 x64 또는 ARM64에 맞는 패키지를 선택하세요.
- 압축 파일을 사용하는 경우, 먼저 현재 사용자에게 쓰기 권한이 있는 고정 폴더(예:
%LOCALAPPDATA%\v2rayN)에 압축을 모두 푼 다음v2rayN.exe를 실행하세요. 실행 파일만 바탕 화면으로 옮기거나 압축 파일 미리보기에서 바로 실행하지 마세요. - 실행할 때 .NET이 없다는 안내가 나오면 안내문과 패키지 설명에 맞는 주 버전 및 아키텍처의 런타임을 설치하세요. 구형 WPF 버전에서
Microsoft.WindowsDesktop.App이 필요하다고 명시되어 있다면 일반 .NET Runtime이 아니라 .NET Desktop Runtime을 설치해야 합니다.
macOS
- Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple 칩이면 ARM64, Intel 프로세서면 x64 패키지를 선택합니다.
- 배포 패키지의 압축을 풀거나 디스크 이미지를 연 뒤
v2rayN.app을 ‘응용 프로그램’ 폴더로 옮겨 실행하세요. 마운트된 디스크 이미지를 평소 실행 위치로 사용하지 마세요. - 운영체제가 실행을 차단하면 안내 내용을 확인하고 패키지 출처와 아키텍처를 점검하세요. 출처를 신뢰할 수 있고 이번 실행에만 적용되는 별도 허용 옵션이 있을 때만 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에서 처리하세요. 보안 검사를 전체적으로 끄지는 마세요.
먼저 일반 권한으로 실행하세요. 구체적인 런타임 오류나 쓰기 오류가 발생하면 안내에 따라 조치하고, 관리자 권한을 기본 해결책으로 사용하지 마세요.
초기 설정: 노드 추가 후 브라우저 연결 확인
노드는 서버 연결 설정 하나를 뜻하고, 구독은 링크 하나로 노드 목록을 가져오는 방식입니다. 처음에는 출처를 하나만 추가하면 문제가 생겼을 때 구독을 가져오지 못한 것인지, 특정 노드를 사용할 수 없는 것인지 구분하기 쉽습니다. 아래 내용은 v2rayN 7.x 중국어 인터페이스에서 흔히 쓰는 메뉴를 기준으로 합니다. 빌드에 따라 버튼 이름은 조금 다를 수 있습니다.
설정이 저장되는지 확인
‘설정’ → ‘매개변수 설정’으로 이동해 창이 열리는지 확인하세요. 노드를 추가한 뒤 프로그램을 정상 종료하고 다시 열어 그룹이 유지되는지도 확인합니다. 실행할 때마다 빈 상태로 돌아간다면 프로그램이 임시 폴더에서 실행 중인지, 로그에 설정 저장 오류가 있는지 먼저 확인하세요.
출처 하나 추가
구독 링크가 있다면 ‘구독 그룹’ → ‘구독 그룹 설정’을 열어 그룹을 추가하고, 알아보기 쉬운 이름과 구독 주소를 입력한 뒤 저장하세요. 메인 화면으로 돌아와 해당 그룹을 선택하고 ‘구독 그룹’ → ‘현재 구독 업데이트(프록시 사용 안 함)’를 먼저 시도합니다. 단일 노드 링크를 받았다면 링크를 복사한 뒤 ‘서버’ → ‘클립보드에서 공유 링크 가져오기’로 추가하세요. 노드 링크를 구독 주소 입력란에 넣지 마세요.
노드 활성화 후 로그 확인
목록에서 노드를 마우스 오른쪽 버튼으로 클릭하고 ‘활성 서버로 설정’을 선택하세요. 일부 빌드에서는 더블 클릭으로 전환할 수도 있습니다. 메인 창의 로그에서 코어 실행이나 포트 대기 오류가 없는지 먼저 확인하세요. 목록에 노드가 표시된다는 것은 설정을 가져왔다는 뜻일 뿐, 원격 서버에 연결할 수 있다는 뜻은 아닙니다.
시스템 프록시 켜기
클라이언트 메뉴에서 ‘시스템 프록시’를 열고 ‘시스템 프록시 자동 설정’을 선택하세요. 시스템 프록시는 운영체제가 지원하는 앱에 제공하는 프록시 설정이며 모든 프로그램의 트래픽을 가로채지는 않습니다. 첫 테스트에서는 TUN(가상 네트워크 어댑터를 통한 트래픽 처리)을 켜지 말고 기존 라우팅 규칙도 유지하세요. 트래픽 진입 방식과 분기 동작을 동시에 바꾸지 않는 편이 좋습니다.
웹페이지와 로그 비교
시스템 프록시를 따르는 브라우저에서 새 탭을 열고 평소 접속할 수 있는 HTTPS 사이트를 방문한 뒤, 같은 시간대의 코어 로그를 확인하세요. 페이지가 열렸다고 해서 해당 요청이 원격 프록시를 거쳤다고 단정할 수는 없습니다. 라우팅 규칙에 따라 트래픽이 직접 연결되거나 프록시로 전달되며, 로그에 직접 연결로 표시된다면 해당 직접 연결 경로가 작동했다는 뜻입니다.
로컬 포트 충돌: 대기 상태를 확인한 뒤 설정 변경
로컬 수신 포트는 앱이 이 컴퓨터의 프록시에 연결할 때 사용하는 진입점이며, 구독에 포함된 서버의 원격 포트와는 다릅니다. v2rayN의 기본 로컬 포트는 보통 10808입니다. ‘설정’ → ‘매개변수 설정’의 로컬 수신 설정과 시작 로그를 기준으로 확인하세요. 로그에 바인딩 실패나 주소 사용 중이라는 메시지가 있을 때 포트 충돌을 우선 점검하면 됩니다.
포트를 사용 중인 프로세스 확인
Windows에서는 PowerShell을 열고 수신 목록에서 프로세스 번호 OwningProcess를 확인하세요. 그런 다음 작업 관리자의 ‘세부 정보’에서 PID와 프로세스를 대조합니다.
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
macOS에서는 ‘터미널’을 열고 출력에 표시된 COMMAND와 PID를 확인하세요. 실제 설정 포트가 10808이 아니라면 명령어의 숫자를 로그에 표시된 오류 포트로 바꾸세요.
lsof -nP -iTCP:10808 -sTCP:LISTEN
- 이미 실행 중인 다른 v2rayN 인스턴스가 원인이라면 메뉴에서 기존 인스턴스를 정상 종료한 뒤 다시 시도하세요. Xray 프로세스가 보인다고 해서 반드시 충돌인 것은 아닙니다. 현재 인스턴스의 프로세스이고 로그에 오류가 없다면 포트 대기는 정상 동작입니다.
- 포트를 다른 필수 프로그램이 사용 중이라면 정체를 모르는 프로세스를 종료하지 마세요. 대체 포트를 사용할 수 있는지 확인한 뒤 ‘설정’ → ‘매개변수 설정’에서 로컬 수신 포트를 바꾸고 코어를 재시작한 다음 시스템 프록시를 다시 적용하세요. 프록시 주소를 직접 입력한 앱도 포트를 업데이트해야 합니다.
- 이 컴퓨터에서만 사용할 경우 루프백 수신을 유지하고, 충돌을 해결하려고 ‘LAN 연결 허용’을 켜지 마세요. 포트를 바꿔도 원격 인증 오류나 만료된 구독 주소는 해결되지 않습니다.
자주 발생하는 문제: 증상으로 원인 단계 찾기
앱을 실행하자마자 잠깐 떴다가 사라지면 무엇부터 확인해야 하나요?
먼저 아키텍처와 압축 해제 위치를 다시 확인하세요. Windows에서 여전히 창이 뜨지 않으면 ‘이벤트 뷰어’ → ‘Windows 로그’ → ‘응용 프로그램’에서 방금 실행한 시간의 앱 오류나 .NET 런타임 기록을 찾아 누락 항목을 해결하세요. macOS에서 열 수 없다는 안내가 나오면 시스템 보안 알림인지, 패키지 손상 또는 아키텍처 불일치인지 구분하세요. 패키지 손상이나 아키텍처 불일치라면 권한을 높이지 말고 호환되는 패키지를 다시 받는 편이 좋습니다.
구독은 저장했는데 목록이 비어 있는 이유는 무엇인가요?
먼저 현재 선택한 그룹을 확인하고, 주소 앞뒤에 불필요한 공백이나 줄바꿈이 없는지 살펴본 뒤 해당 그룹을 직접 업데이트하세요. 로그에 401 또는 403이 표시되면 구독 제공업체에 링크가 유효한지 확인하세요. 시간 초과가 발생하고 사용할 수 있는 연결이 이미 있다면 ‘현재 구독 업데이트(프록시 사용)’를 시도할 수 있습니다. 사용할 수 있는 연결이 없다면 옵션을 반복해서 바꿔도 로컬 프록시가 저절로 연결되지는 않습니다.
노드 지연 시간은 측정되는데 브라우저에서 페이지가 열리지 않는 이유는 무엇인가요?
노드만 선택한 것이 아니라 ‘시스템 프록시 자동 설정’을 선택했는지 먼저 확인하세요. Windows에서는 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 적용 여부를 확인하고, macOS에서는 ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 서비스의 ‘세부사항’ → ‘프록시’에서 확인하세요. 브라우저나 확장 프로그램에 별도 프록시 설정이 있다면 시스템 설정을 따르는 브라우저로 교차 확인하세요. 지연 시간 테스트 성공은 해당 테스트 요청이 완료됐다는 뜻일 뿐, 웹페이지에 필요한 모든 연결이 정상이라는 보장은 아닙니다.
v2rayN을 종료한 뒤 오히려 웹페이지가 열리지 않나요?
기존에 회사 프록시나 수동 프록시를 사용하지 않았다면 v2rayN을 다시 열고 ‘시스템 프록시’에서 ‘시스템 프록시 해제’를 선택한 뒤 정상 종료하세요. 컴퓨터가 원래 조직의 프록시나 자동 설정 스크립트를 사용했다면 기존 설정을 확인해 복원하고, 무조건 모두 지우지는 마세요. 특히 프로그램이 비정상 종료된 뒤에는 더 이상 대기 중이지 않은 로컬 포트로 요청이 계속 전달되고 있지 않은지 확인하세요.
초기 설정이 끝났다면 되돌릴 수 있는 상태 유지
먼저 시스템 프록시를 켜고 끄는 전체 과정을 한 번 확인한 뒤, 시작 시 자동 실행이나 복잡한 트래픽 분기를 설정하세요. 정상 종료 후 다시 실행해 그룹이 유지되는지 확인하고, 프록시가 필요할 때는 브라우저와 로그를 점검하세요. 사용하지 않을 때는 컴퓨터가 기존 네트워크 설정으로 돌아왔는지도 확인해야 합니다. 이렇게 해두면 다음 업데이트나 패키지 변경 후 문제가 생겼을 때 정상 작동하던 설정과 비교할 수 있습니다.
- 클라이언트 버전, 패키지 아키텍처, 실제 로컬 수신 포트를 기록해 두세요. 도움을 요청할 때 ‘연결이 안 돼요’라고만 하기보다 오류 원문과 발생 시간을 함께 전달하면 원인을 찾기 쉽습니다.
- 스크린샷을 찍거나 로그를 복사하기 전에 전체 구독 링크, 액세스 토큰, 노드 인증 정보를 가리세요. 구독 링크는 일반 웹 주소처럼 보여도 민감한 정보가 포함될 수 있습니다.
- 테스트가 안정적으로 끝난 뒤 자동 실행이나 사용자 지정 라우팅을 하나씩 켜세요. 변경 직후 문제가 생기면 코어와 노드, 포트를 한꺼번에 바꾸지 말고 마지막 변경 사항부터 되돌리세요.