먼저 Windows 시스템 아키텍처에 맞는 패키지를 고른 다음 WPF와 Desktop 중 인터페이스를 선택하세요. 처음 설정할 때는 구독에서 노드를 가져올 수 있는지, 코어가 실행되는지, 브라우저가 시스템 프록시를 사용하는지 각각 확인하세요. 문제가 생기면 실패한 단계부터 점검하고, 인터페이스와 노드, 라우팅을 한꺼번에 바꾸지 마세요.
WPF와 Desktop 버전: 아키텍처를 확인한 뒤 선택하세요
Windows에서 「설정」→「시스템」→「정보」를 열고 「장치 사양」 아래의 「시스템 종류」를 확인하세요. x64 기반 시스템에는 Windows x64 패키지를 선택하고, ARM 기반 시스템에는 해당 Windows ARM64 패키지가 제공되는 경우 우선 선택하세요. 둘 다 64비트로 표시될 수 있으므로 비트 수만 보고 판단하면 안 됩니다. WPF와 Desktop은 인터페이스 버전이지 프록시 프로토콜이 아닙니다. 같은 구독을 사용할 수 있는지는 노드 설정과 실제 실행되는 코어에 달려 있습니다.
Windows용 인터페이스 버전 두 가지
WPF 버전
- Windows의 WPF UI 프레임워크를 사용하며, 익숙한 Windows 버전을 계속 사용하려는 경우에 적합합니다.
- 선택한 패키지에 외부 런타임이 필요한 경우, 시작할 때 표시되는
Microsoft.WindowsDesktop.App은 .NET Desktop Runtime을 의미합니다.
Desktop 버전
- Avalonia UI 프레임워크를 사용합니다. 다른 플랫폼에서 같은 인터페이스를 본 적이 있어도 Windows용 패키지를 선택해야 합니다.
- 메뉴 배치는 WPF와 다를 수 있습니다. 런타임과 코어가 포함되어 있는지는 해당 릴리스 패키지의 안내를 확인하세요. Desktop이라는 이름만으로는 알 수 없습니다.
이미 문제없이 사용하는 버전이 있다면 구독을 가져오려고 인터페이스를 바꿀 필요는 없습니다. 처음 설치한다면 아키텍처가 맞고 의존성 안내가 명확한 패키지를 우선 선택하세요.
압축 풀기, 첫 실행 및 구독 가져오기
이 안내는 v2rayN 7.x에서 흔히 볼 수 있는 Windows 인터페이스를 기준으로 합니다. 세부 버전에 따라 메뉴 위치가 달라질 수 있습니다. 도구 모음에서 버튼을 찾지 못하면 같은 이름의 메뉴를 확인하세요. Windows 네트워크 설정에 구독 주소를 추가하면 안 됩니다.
압축 파일 전체 풀기
ZIP 파일을 다운로드했다면 파일 탐색기에서 마우스 오른쪽 버튼을 클릭하고 「모두 압축 풀기」를 선택하세요. 사용자 계정에서 쓰기 가능한 별도 폴더에 압축을 푸세요. 예를 들면 사용자 폴더 아래의
Tools\v2rayN입니다. 압축 파일 미리 보기에서 실행하거나 주 프로그램만 따로 꺼내면 안 됩니다. 코어와 함께 제공되는 파일은 기존 폴더 구조를 유지해야 합니다.주 프로그램 실행
압축을 푼 폴더에서
v2rayN.exe를 실행하세요. 주 창이 보이지 않으면 먼저 알림 영역의 숨겨진 아이콘을 확인하세요. 처음 구독을 가져오거나 일반 시스템 프록시를 확인할 때 TUN을 먼저 켤 필요는 없습니다. 관리자 권한 실행을 모든 시작 오류의 만능 해결책으로 여기지 마세요.구독 추가
주 화면에서 「구독 그룹」→「구독 그룹 설정」으로 이동한 다음 「추가」를 클릭하세요. 알아보기 쉬운 이름과 전체 구독 주소를 입력하고 저장합니다. 구독 주소에는 보통 인증 정보가 포함되므로 복사할 때 쿼리 매개변수를 빠뜨리지 마세요. 도움을 요청하려고 화면을 캡처할 때는 주소 전체를 가리세요.
노드 가져오기
「구독 그룹」 메뉴에서 「모든 구독 업데이트(프록시 사용 안 함)」를 실행한 다음 방금 만든 그룹으로 전환해 노드를 확인하세요. 주소를 저장하는 것만으로는 그룹만 만들어지며 업데이트 작업은 별도로 해야 합니다. 직접 연결이 시간 초과되고 이미 사용할 수 있다고 확인된 프록시가 있다면 「프록시 사용」 업데이트 옵션을 시도하세요.
노드 선택
노드 목록에서 노드를 마우스 오른쪽 버튼으로 클릭하고 「활성 서버로 설정」을 선택하세요. 주 화면에 선택한 노드가 표시되는지 확인하고, 로그에 코어 시작 또는 포트 바인딩 실패가 있는지도 살펴보세요. 노드가 목록에 표시된다고 해서 활성화되었거나 사용할 수 있다는 뜻은 아닙니다.
로컬 포트와 시스템 프록시 확인
먼저 코어가 로컬에서 요청을 수신하는지 확인한 다음 브라우저가 시스템 프록시를 사용하도록 설정하세요. 아래 포트는 문제 해결에 참고할 만한 흔한 값이며 모든 7.x 버전에서 고정으로 사용하는 값은 아닙니다. 「설정」→「매개변수 설정」의 로컬 수신 설정과 시작 로그를 기준으로 확인하세요.
로컬 수신 설정 확인
- 로컬 주소
127.0.0.1- 수신 포트
- 클라이언트 설정과 시작 로그를 기준으로 확인
- 테스트 조건
- 코어가 실행 중이고 해당 포트에서 HTTP 프록시 요청을 받는지 확인
혼합 포트는 HTTP와 SOCKS 요청을 모두 받을 수 있습니다. SOCKS 전용 포트를 HTTP 프록시 주소로 입력하면 안 됩니다.
시스템 프록시 확인
- 클라이언트 메뉴
- 알림 영역 아이콘 → 「시스템 프록시」→「시스템 프록시 자동 설정」
- Windows에서 확인할 위치
- 「설정」→「네트워크 및 인터넷」→「프록시」
- 앱에서 확인
- 시스템 프록시 설정을 사용하는 브라우저
시스템 프록시는 이를 따르는 앱의 요청을 클라이언트로 보낼지 결정합니다. 라우팅 규칙은 코어가 요청을 받은 뒤 어떤 아웃바운드로 보낼지 결정합니다.
브라우저 설정과 로컬 프록시를 따로 점검하려면 PowerShell에서 프록시를 명시적으로 지정할 수 있습니다. 아래 예시는 10808 포트가 HTTP 프록시 요청을 받는다고 확인된 경우에만 사용하세요. 수신 포트가 다르면 숫자를 바꾸면 됩니다.
curl.exe --noproxy "" --proxy http://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com/
- 로컬 포트에 연결할 수 없음: 수신 주소와 포트 번호, 코어 로그를 먼저 확인하세요. 로그에 주소가 이미 사용 중이라고 표시되면
Get-NetTCPConnection -LocalPort 10808 -State Listen을 실행해OwningProcess를 확인한 다음 작업 관리자의 「세부 정보」 탭에서 PID와 프로세스를 대조하세요. 정체를 알 수 없는 프로세스를 함부로 종료하지 마세요. - 명령에서는 응답을 받지만 브라우저는 연결되지 않음: 브라우저가 별도의 프록시 설정을 사용하는지, Windows에 기록된 프록시 주소와 포트가 일치하는지 확인하세요. 수신 포트를 변경했다면 시스템 프록시를 다시 적용하고 앱에 직접 입력한 이전 포트도 함께 바꾸세요.
- 페이지는 열리지만 어떤 아웃바운드를 거쳤는지 알 수 없음: 응답이 왔다는 사실만으로 요청이 로컬 프록시를 거쳐 처리되었다는 점을 알 수 있으며, 원격 노드를 거쳤다는 뜻은 아닙니다. 테스트 도메인에 직접 연결 규칙이 적용되었을 수 있습니다. 확인이 필요하면 사용하는 라우팅 규칙의 순서와 확인 가능한 코어 접속 로그를 대조하세요.
시작 오류, 구독 실패 및 브라우저 연결 끊김 해결
실행하자마자 .NET 설치 안내가 표시됩니다. 어떤 버전을 설치해야 하나요?
팝업에 표시된 프레임워크 이름, 버전, 아키텍처에 맞춰 런타임을 선택하세요. 예를 들어 Microsoft.WindowsDesktop.App, 8.0 계열, x64가 표시되면 해당하는 .NET 8 Desktop Runtime x64를 설치하세요. 일반 .NET Runtime만 설치하면 안 됩니다. dotnet --list-runtimes로 설치된 런타임을 확인할 수 있습니다. 시스템에 서로 다른 아키텍처의 런타임이 함께 설치되어 있다면 명령 결과에 주 프로그램에서 필요한 아키텍처가 표시되는지 확인하세요.
주 프로그램은 있는데 로그에 코어를 찾을 수 없다고 표시되는 이유는 무엇인가요?
먼저 릴리스 패키지에 필요한 코어가 포함되어 있는지, 압축을 전체 풀었는지 확인하세요. 그런 다음 「Windows 보안」→「바이러스 및 위협 방지」→「보호 기록」에서 시작 시간과 파일 경로가 일치하는 기록이 있는지 살펴보세요. 실행을 위해 보호 기능을 끄거나 폴더 전체를 제외 항목에 추가하지 마세요. 출처나 경고 이유가 불분명하면 실행을 중단하고 신뢰할 수 있는 릴리스 패키지를 다시 받으세요. 회사나 기관의 기기라면 관리자에게 문의하세요.
폴더 경로에 한글이 포함되어 실행 시 파일을 찾을 수 없다고 나옵니다. 어떻게 해야 하나요?
먼저 알림 영역에서 클라이언트를 종료한 다음 같은 패키지를 사용자 계정에서 쓰기 가능한 짧은 영문 경로의 별도 폴더에 전체 압축 해제하세요. 마지막 폴더 이름만이 아니라 전체 경로를 확인해야 합니다. 새 폴더에서 실행해 비교하고 기존 폴더와 파일을 섞거나 덮어쓰지 마세요. 경로에 한글이 있다고 해서 반드시 문제가 생기는 것은 아닙니다. 폴더를 바꾼 뒤 같은 작업이 정상적으로 작동하는 경우에만 경로 처리, 폴더 길이 또는 접근 권한을 추가로 확인하세요.
구독 업데이트가 계속 시간 초과됩니다. 코어를 바꿔야 하나요?
먼저 구독 업데이트 로그를 확인하세요. 구독을 가져오지 못한 문제와 노드 연결 실패는 서로 다른 문제입니다. 시간 초과가 발생하면 현재 네트워크에서 구독 서버에 접속할 수 있는지, 선택한 업데이트 방식에 아직 사용할 수 없는 프록시가 필요한지 확인하세요. 401 또는 403 응답이 오면 구독이 만료되었는지, 접근 권한이 변경되었는지 먼저 살펴보세요. 로그에 인증서 오류가 표시되면 Windows의 날짜와 시간, 시간대를 확인하세요. 인증서 검증을 끄는 방식으로 해결하면 안 됩니다.
클라이언트를 종료하면 브라우저도 인터넷에 연결되지 않는 이유는 무엇인가요?
Windows가 더 이상 수신하지 않는 로컬 프록시를 계속 가리키고 있으면 브라우저는 존재하지 않는 프록시 주소에 연결을 시도합니다. 클라이언트를 다시 시작하고 알림 영역의 「시스템 프록시」 메뉴에서 「시스템 프록시 지우기」를 선택한 뒤 정상적으로 종료하세요. 그런 다음 Windows의 「프록시」 페이지에서 설정을 확인하세요. 원래 회사나 기관의 프록시를 사용했다면 모든 프록시 옵션을 끄지 말고 기존 설정을 복구하세요.