Windows에서 v2rayN을 처음 설치했거나 업데이트한 뒤 실행되지 않는 경우에 적합한 안내입니다. 먼저 메인 프로그램이 백그라운드에서 실행 중인지 확인하고, 실행 오류 메시지에 따라 런타임을 점검하세요. 새 폴더에 별도로 압축을 풀어 폴더 권한과 기존 설정 문제를 확인할 수도 있습니다. 노드를 선택할 때만 오류가 발생한다면 메인 프로그램을 반복해서 재설치하지 말고 코어 로그를 확인하세요.
메인 프로그램 종료와 코어 실행 실패 구분하기
이 순서는 점검 대상을 구분하기 위한 것으로, 모든 버전에서 같은 시점에 코어를 실행한다는 뜻은 아닙니다. 두 번 클릭한 뒤 작업 표시줄 알림 영역을 확인하고, 필요하면 숨겨진 아이콘을 펼쳐 보세요. 시스템 트레이에서 메인 창을 열 수 있다면 프로그램이 종료된 것이 아닙니다. 런타임을 설치하기 전에 창이 최소화되어 있는지 확인하세요.
- Ctrl + Shift + Esc를 눌러 작업 관리자를 엽니다. ‘세부 정보’에서
v2rayN.exe를 확인하세요. 프로세스가 나타났다가 바로 사라진다면 시간을 기록해 시스템 로그와 대조할 수 있도록 합니다. - Win + R을 누르고
eventvwr.msc를 입력하세요. ‘Windows 로그’ → ‘응용 프로그램’에서 실행 시각 전후로.NET Runtime또는Application Error기록이 있는지 확인합니다. 이벤트 ID 1026과 1000은 단서가 될 수 있지만, 기록에 표시된 프로그램 이름을 확인해 같은 시간대에 발생한 다른 앱의 오류와 혼동하지 마세요. - 창은 열리지만 노드를 전환한 뒤 코어 실행 오류가 발생한다면 먼저 메인 화면의 로그를 확인하세요. 브라우저에서 웹 페이지가 열리지 않는다는 사실만으로 데스크톱 프로그램이 종료됐다고 판단할 수는 없습니다. 코어 오류 여부를 확인한 다음 프록시 설정을 점검하세요.
오류 메시지에 따라 .NET Desktop Runtime 확인하기
설치된 앱 목록에 ‘.NET’이 있는지만 확인해서는 안 됩니다. 외부 런타임에 의존하는 Windows 데스크톱 배포판은 Microsoft.WindowsDesktop.App이 필요할 수 있습니다. 일반 .NET Runtime이나 구버전 .NET Framework만 설치한 것으로는 이 요구 사항을 충족하지 못합니다. 자체 포함 패키지에는 필요한 런타임이 이미 들어 있는 경우가 많으므로, 먼저 다운로드한 패키지 종류를 확인한 뒤 추가 설치 여부를 결정하세요.
You must install or update .NET to run this application.
원인: 실행 프로그램이 요구 조건을 충족하는 공유 런타임을 찾지 못했습니다. 해결 방법: 오류 메시지에 표시된 Framework, 버전, Architecture를 확인하세요. 프레임워크 이름이 Microsoft.WindowsDesktop.App이라면 Microsoft 공식 채널에서 아키텍처와 버전에 맞는 .NET Desktop Runtime을 설치합니다.
Only one usage of each socket address (protocol/network address/port) is normally permitted.
원인: 이 문구가 코어의 리스닝 로그에 표시된다면 로컬 리스닝 주소와 포트가 이미 사용 중인지 확인해야 합니다. 해결 방법: 로그에 표시된 포트를 사용하는 프로세스를 찾고, 중복 실행된 이전 인스턴스가 맞는지 확인한 뒤 정상적으로 종료하세요. 이 코어 오류를 런타임 누락으로 오해하지 마세요.
예를 들어 Microsoft.WindowsDesktop.App 8.0.0, 아키텍처 x64가 필요하다고 표시된다면 x64용 8.0 계열 Desktop Runtime이 설치되어 있는지 확인하세요. 보통 최초의 8.0.0 패치를 따로 찾을 필요는 없습니다. 9.0 계열만 설치해도 8.0을 대체할 수 있는 것은 아닙니다. 아키텍처는 앱의 오류 메시지를 기준으로 확인하고, Windows가 64비트라는 이유만으로 프로그램도 x64라고 단정하지 마세요.
dotnet --list-runtimes
터미널에서 이 명령을 실행해 Microsoft.WindowsDesktop.App으로 시작하는 행과 오른쪽의 설치 경로를 확인하세요. 이 명령은 현재 호출된 dotnet에서 확인되는 런타임만 표시합니다. 시스템에 서로 다른 아키텍처의 런타임이 설치되어 있다면 이 목록만으로 다른 아키텍처의 설치 여부를 확인할 수 없습니다. 명령을 찾을 수 없다면 ‘설정’ → ‘앱’ → ‘설치된 앱’에서 Desktop Runtime 항목을 확인한 뒤 클라이언트를 다시 실행해 보세요.
압축을 다시 풀어 폴더 권한과 기존 설정 분리하기
기존 폴더 보관
먼저 실행 중인 인스턴스를 정상적으로 종료하세요. 시스템 트레이 메뉴를 열 수 있다면 메뉴에서 종료한 뒤 작업 관리자에서 메인 프로세스가 끝났는지 확인합니다. 기존 프로그램 폴더와 설정을 백업하되 원본은 덮어쓰지 마세요. 구독 주소와 노드 인증 정보가 들어 있을 수 있으므로 폴더 전체를 다른 사람에게 보내 도움을 요청하지 마세요.
파일 전체 압축 해제
파일 탐색기에서 압축 파일을 마우스 오른쪽 버튼으로 클릭한 뒤 ‘모두 압축 풀기’를 선택하세요. 현재 사용자에게 쓰기 권한이 있는 로컬 폴더를 지정합니다. 예:
%LOCALAPPDATA%\v2rayN-test. 압축 파일 미리 보기에서 바로 실행하거나v2rayN.exe하나만 꺼내지 마세요.일반 권한으로 실행
새 폴더에서 메인 프로그램을 두 번 클릭하세요. 기존 바로 가기나 이전 설정은 사용하지 않습니다. 로그에 특정 경로의 쓰기 실패가 표시된다면 오류 경로가 있는 폴더에서 빈 텍스트 파일을 만들었다가 삭제해 보세요. 테스트 폴더에 쓸 수 있다고 해서 오류가 난 다른 폴더에도 쓸 수 있는 것은 아닙니다.
설정을 나눠서 복원
새 복사본이 열리면 종료한 뒤 다시 실행해 기본 설정이 저장되는지 확인하세요. 다음으로 작동하는 노드 하나 또는 구독 하나만 가져와 테스트한 뒤 사용자 지정 라우팅 설정 등을 복원합니다. 설정 종류를 하나씩 복원할 때마다 프로그램을 다시 시작하세요. 문제가 재현되면 마지막에 추가한 항목부터 되돌립니다.
권한 문제와 업데이트 문제를 구분하려면 가능한 한 같은 버전과 아키텍처의 원본 패키지를 새 폴더에 압축 해제해 확인하세요. 새 버전만 실행에 성공했다면 새 폴더에서 해당 버전이 작동한다는 점은 확인할 수 있지만, 이것만으로 구버전의 문제를 폴더 권한 탓으로 단정할 수는 없습니다. 관리자 권한으로만 실행된다면 오류 기록에 표시된 쓰기 경로부터 확인하세요. 계속 관리자 권한으로 실행하는 것은 해결 방법이 아닙니다.
메인 화면이 정상일 때 코어 파일과 리스닝 포트 확인하기
- 로그에 파일이 없다고 표시됨: 로그에 나온 전체 경로에서 파일을 확인하세요. 예를 들어 Xray의 경우 해당 폴더에 있는
xray.exe가 필요합니다. 같은 이름의 파일을 메인 프로그램 옆에 아무렇게나 두는 것으로는 해결되지 않습니다. 먼저 선택한 배포 패키지에 필요한 코어가 포함되어 있는지 확인하고, 새로 압축을 푼 복사본의 폴더 구조와 비교하세요. - 압축을 푼 뒤 파일이 사라짐: ‘Windows 보안’ → ‘바이러스 및 위협 방지’ → ‘보호 기록’을 열어 탐지 시각, 영향을 받은 경로, 처리 결과를 확인하세요. 해당 기록이 맞다면 탐지 정보를 보관하고 신뢰할 수 있는 출처에서 전체 배포 패키지를 다시 받으세요. 다시 차단된다면 관리자에게 문의하거나 오탐 검토를 요청하세요. 실시간 보호를 끄거나 폴더 전체를 제외 항목에 추가하지 마세요.
- 로그에 바인딩 실패가 표시됨: 로그에 실제로 나온 포트를 기준으로 확인하세요. 예를 들어 로그에
127.0.0.1:10808이 표시되면 명령 프롬프트에서 아래 명령을 실행해 해당 포트의 로컬 주소와 상태가LISTENING인 행을 찾을 수 있습니다. 마지막 열은 PID입니다. ‘작업 관리자’ → ‘세부 정보’에서 해당 프로그램을 확인하세요.
netstat -ano -p tcp | findstr ":10808"
이 명령은 원격 주소나 더 긴 포트 문자열에도 일치할 수 있으므로 결과가 있다고 바로 충돌로 판단하지 마세요. 포트를 사용하는 프로그램을 확인한 뒤 중복 실행된 인스턴스라면 정상적으로 종료하는 것이 좋습니다. 계속 사용해야 하는 프로그램이 해당 포트를 리스닝 중이라면 v2rayN의 ‘설정’ → ‘매개변수 설정’에서 로컬 리스닝 포트를 확인하세요. 포트를 변경한 뒤 프록시를 수동으로 설정한 브라우저나 앱에서도 포트를 함께 변경해야 합니다.
여전히 실행되지 않을 때 자주 묻는 질문
바로 가기를 두 번 클릭하면 반응이 없지만 프로그램 파일을 직접 실행하면 열리나요?
기존 바로 가기를 마우스 오른쪽 버튼으로 클릭하고 ‘속성’ → ‘바로 가기’에서 ‘대상’이 이동 전 위치의 v2rayN.exe를 가리키는지 확인한 뒤 ‘시작 위치’도 확인하세요. 대상 경로가 유효하지 않다면 현재 메인 프로그램에서 바로 가기를 새로 만들면 됩니다.
런타임을 설치했는데도 같은 오류가 표시되나요?
오류 창에 나온 프레임워크 이름과 아키텍처를 다시 확인하고 일반 Runtime이 아니라 Desktop Runtime을 설치했는지 점검하세요. 지금 실행하는 파일이 이번에 압축을 푼 복사본인지도 확인하세요. 작업 표시줄에 고정된 이전 버전이 실행되고 있을 수 있습니다. 새 버전과 구버전은 필요한 런타임 계열이 다를 수 있습니다.
창도 오류 메시지도 나타나지 않을 때 문의하려면 어떤 정보가 필요한가요?
Windows 버전, 시스템 종류, 배포 패키지 파일명, 실행 시각을 기록하세요. 이벤트 뷰어에 관련 기록이 있다면 오류가 난 앱 이름, 예외 코드, 오류 모듈을 함께 적습니다. 새 폴더에 압축을 푼 복사본도 시험했다면 실행 가능 여부를 알려 주세요. 정보를 보내기 전에 개인 폴더 이름, 구독 주소, 노드 인증 정보를 삭제하세요.