Windows에서는 먼저 v2rayN 프로세스가 종료됐는지 확인한 다음, 시작 로그를 살펴 런타임 누락·폴더 쓰기 실패·설정 파일 읽기 오류를 구분하세요. 업데이트 후에만 문제가 생겼다면 이전 폴더를 보존하고, 같은 빌드를 새 폴더에 풀어 데이터 없이 실행해 봅니다. Android에서는 앱 화면이 종료되는지, 연결을 누른 뒤 VPN 서비스가 중지되는지부터 구분하세요.
v2rayN 프로세스가 실제로 종료됐는지 확인
창이 사라졌다고 해서 프로세스까지 충돌한 것은 아닙니다. 먼저 Windows 작업 표시줄의 알림 영역을 펼친 뒤 v2rayN 아이콘을 마우스 오른쪽 버튼으로 눌러 기본 창을 다시 열어 보세요. 또는 Ctrl + Shift + Esc를 눌러 작업 관리자에서 ‘세부 정보’ 탭을 열고 v2rayN.exe가 실행 중인지 확인할 수 있습니다. 프로세스는 남아 있지만 창이 응답하지 않는다면 화면 멈춤으로 기록하세요. 런타임 누락으로 단정해 반복해서 설치하지 마세요.
- 창과 함께 프로세스도 종료됨: 실행 시간과 현재 빌드를 기록하고, 실제 압축 해제 폴더에서 프로그램을 직접 실행해 바로 가기가 이전 사본을 가리키는 경우를 배제하세요. 오류 대화상자가 나타나면 마지막 한 줄만 적지 말고 전체 메시지를 보존하세요.
- 창은 정상이고 연결만 실패함: 먼저 코어 로그를 확인하세요. 예를 들어 로컬 수신 주소가
127.0.0.1:10808로 설정되어 있는데 해당 포트를 이미 다른 프로그램이 사용 중이라면, 보통은 코어의 수신 실패이지 클라이언트 창의 충돌이 아닙니다. 포트는 현재 설정을 기준으로 확인하고, 예시 값을 기본값으로 간주하지 마세요. - 오류 대화상자가 나타나지 않음: Win + R을 누르고
eventvwr.msc를 실행한 다음 ‘Windows 로그’ → ‘응용 프로그램’을 여세요. 같은 시각에 기록된.NET Runtime또는Application Error이벤트를 찾아 오류가 발생한 앱 이름을 확인하고, 예외 유형과 파일 경로도 살펴보세요.
.NET 데스크톱 런타임과 프로그램 아키텍처 확인
컴퓨터에 설치된 .NET에 의존하는 Windows 빌드라면 오류 메시지에 표시된 프레임워크 이름·버전·아키텍처부터 확인하세요. WPF 빌드에 Microsoft.WindowsDesktop.App이 필요하다면 Microsoft.NETCore.App이 설치되어 있어도 데스크톱 프레임워크까지 설치된 것은 아닙니다. 자체 포함 빌드는 런타임을 패키지에 포함합니다. 압축 해제가 불완전하다면 시스템에 DLL을 하나씩 추가하기보다 전체 파일을 다시 압축 해제하세요.
dotnet --list-runtimes
PowerShell에서 위 명령을 실행하세요. x64용 Microsoft.WindowsDesktop.App 8.0.0이 필요하다는 메시지가 표시되면, x64 런타임에 필요한 8.0 계열 데스크톱 프레임워크가 있는지 확인하세요. .NET 항목이 하나라도 보인다는 이유로 점검을 건너뛰면 안 됩니다. 여기의 버전은 오류 메시지를 읽는 방법을 설명하기 위한 예시이며, 모든 v2rayN 빌드에 적용되는 요구 사항은 아닙니다. 명령은 현재 호출된 dotnet에서 확인할 수 있는 런타임만 표시합니다. PC에 x86과 x64가 모두 설치되어 있다면 오류 메시지의 아키텍처와 런타임 검색 경로를 기준으로 확인하세요. 명령을 찾지 못하더라도 그것만으로 시스템에 런타임이 없다고 단정할 수는 없습니다.
오류: You must install or update .NET to run this application.
원인: 현재 프로그램에 필요한 .NET 프레임워크를 찾을 수 없습니다. 해결 방법: 메시지에 표시된 Framework, Architecture, 버전 요구 사항에 맞는 런타임을 설치한 뒤 같은 프로그램 사본으로 다시 확인하세요.
오류: System.UnauthorizedAccessException
원인: 프로그램이 파일이나 폴더에 접근하려 했지만 권한이 거부되었습니다. 해결 방법: 먼저 이벤트 세부 정보에서 실제 경로를 확인하세요. 쓰기 대상이 프로그램 폴더 안에 있다면, 현재 계정으로 쓸 수 있는 새 폴더에 같은 빌드를 두고 다시 확인하세요.
폴더 권한 확인 및 이전 설정 분리
로그에 표시된 데이터 폴더에서 현재 계정으로 빈 텍스트 파일을 만든 뒤 저장하고 삭제해 보세요. 테스트에 실패하면 해당 위치에서 현재 계정이 필요한 작업을 수행할 수 없다는 뜻입니다. 성공하더라도 그 파일을 쓸 수 있다는 것만 확인된 것이며, 기존 데이터베이스에 읽기 전용 속성이 설정되어 있거나 다른 프로세스가 사용 중이거나 별도의 접근 제한이 걸려 있지 않다는 뜻은 아닙니다. 프로그램을 실행하기 위해 시스템 폴더 권한을 일괄 변경하지 마세요.
종료 후 백업
알림 영역의 마우스 오른쪽 버튼 메뉴에서 종료하고, 작업 관리자에서 기존 프로세스가 완전히 끝났는지 확인한 다음 이전 압축 해제 폴더와 별도로 지정한 데이터 위치를 백업하세요. 클라이언트가 실행 중일 때 데이터베이스 파일 하나만 복사하지 마세요. 구독 링크와 노드 인증 정보는 로컬 백업에 보관하세요.
새 폴더에 압축 해제
원본 패키지에서 같은 빌드의 파일 전체를 압축 해제하세요. 예를 들어 파일 탐색기의 주소 표시줄에
%LOCALAPPDATA%를 입력해 해당 위치를 연 다음v2rayN-test폴더를 만드세요. 압축 파일 안에서 프로그램을 바로 실행하거나 새 패키지의 파일을 이전 폴더에 덮어쓰지 마세요.데이터 없이 실행 확인
이전 데이터를 복사하지 말고 새 폴더의
v2rayN.exe를 직접 실행한 뒤 일반 계정으로 확인하세요. 현재 빌드가 공유 위치의 사용자 데이터를 읽는다면 프로그램 폴더만 바꿔서는 데이터 없이 실행한 것이 아닙니다. 로그에서 실제 데이터 경로를 확인하고 백업한 뒤 해당 데이터를 임시로 다른 곳에 옮기세요.데이터를 나눠서 복원
데이터 없이 실행이 정상적으로 되면 기존 구독 주소를 사용해 다시 가져온 다음 사용자 설정을 복원하세요. 한 묶음씩 복원할 때마다 프로그램을 종료했다가 다시 실행하세요. 특정 묶음을 복원한 뒤에만 문제가 재현된다면 점검 범위를 해당 데이터로 좁히세요. 이전 버전의 설정·데이터베이스·코어를 새 폴더에 한꺼번에 덮어쓰지 마세요.
Android 앱 종료와 VPN 서비스 중지 구분
v2rayNG는 Xray 코어를, v2flyNG는 v2fly 코어를 사용합니다. 두 Android 클라이언트 모두 Windows .NET 데스크톱 런타임에 의존하지 않습니다. 아이콘을 눌렀을 때, 설정을 가져온 뒤, 연결을 눌렀을 때 중 언제 문제가 발생하는지 기록한 다음 앱 실행 문제인지 VPN 권한 문제인지 확인하세요.
- 아이콘을 누르면 곧바로 홈 화면으로 돌아감: 시스템 ‘설정’ → ‘앱’ → 해당 클라이언트 → ‘강제 종료’를 선택한 뒤 다시 실행하세요. ‘저장공간’ 또는 ‘저장공간 및 캐시’에서 먼저 캐시를 삭제해 볼 수 있습니다. ‘저장 데이터 삭제’를 누르면 안 됩니다. 이 옵션은 앱의 로컬 데이터를 초기화합니다.
- 연결을 눌렀을 때만 종료되거나 연결이 끊김: 먼저 기본 화면이 계속 열리는지 확인하세요. VPN 서비스만 중지되는 경우 시스템의 VPN 권한을 확인하고, 기기의 VPN 연결을 사용 중인 다른 앱을 종료한 뒤 다시 시도하세요. 화면을 잠근 뒤에만 연결이 끊긴다면 시스템이 해당 앱의 백그라운드 실행을 제한하는지 확인하세요.
- 설정을 가져온 뒤에만 문제가 재현됨: 화면을 열 수 있다면 먼저 사용할 수 있는 설정을 내보내고 원래 구독 주소를 보관하세요. 복원할 때는 현재 코어와 호환되는지 확인한 설정 하나부터 추가하세요. 구독을 가져오는 데 성공해도 클라이언트가 항목을 읽었다는 뜻일 뿐, 코어가 해당 항목의 모든 전송 및 보안 계층 매개변수를 처리할 수 있다는 뜻은 아닙니다.
실행 중 종료 문제 FAQ
.NET을 설치했는데도 런타임이 없다는 메시지가 표시되는 이유는 무엇인가요?
오류 창에 표시된 프레임워크 이름·버전·아키텍처를 대조하세요. 일반 런타임만 설치했거나 x64 빌드를 실행하면서 x86 데스크톱 런타임을 설치한 경우가 있는지 확인하세요. 설치 후에는 압축 해제 폴더에서 프로그램을 직접 실행해 이전 바로 가기로 인한 혼선을 방지하세요.
관리자 권한으로 실행해야만 열립니다. 계속 이렇게 사용해야 하나요?
먼저 일반 계정으로 쓰기 가능한 폴더에서 같은 빌드를 테스트하세요. 실행된다면 데이터 폴더를 옮기거나 문제가 발생한 경로의 권한을 조정하는 방법을 우선 고려하세요. 일반 화면을 여는 것과 TUN을 활성화하는 데 필요한 시스템 권한은 별개입니다. 일상적인 파일 쓰기 문제를 해결하려고 계속 높은 권한으로 실행할 필요는 없습니다.
데이터 없이 실행해도 실패합니다. 문제를 신고할 때 무엇을 제공해야 하나요?
운영체제 버전, 패키지 파일명, 프로그램 아키텍처, 문제가 재현된 시각, 관련성이 높은 첫 번째 예외를 제공하고 같은 빌드를 새 폴더에서 테스트했는지도 알려 주세요. 로그를 공유하기 전에 구독 주소, 액세스 토큰, 노드 인증 정보, 사용자 이름이 포함된 로컬 경로를 가리세요. 설정 폴더 전체를 그대로 업로드하지 마세요.