이 글에서는 Windows에서 v2rayN 기본 창이 열리지 않는 문제를 다룹니다. 트레이에서 실행 중인지, 데스크톱 프로그램이 충돌했는지, 코어가 시작되지 않았는지 먼저 구분한 뒤 이벤트 뷰어와 런타임 설정으로 원인을 찾습니다. 기존 상태를 보존하고 설치 파일과 런타임, 폴더 권한, 이전 설정 순으로 확인하세요. 노드, 구독, 라우팅 규칙을 먼저 바꿀 필요는 없습니다.
먼저 창이 표시되지 않는지, 프로세스가 종료됐는지 확인
두 번 클릭해도 창이 보이지 않는다고 해서 반드시 프로그램이 종료된 것은 아닙니다. v2rayN이 트레이에서 실행 중이거나 이미 실행된 인스턴스가 새 창을 막고 있을 수 있습니다. Ctrl + Shift + Esc를 눌러 작업 관리자를 열고 ‘세부 정보’에서 v2rayN.exe를 찾은 다음, 작업 표시줄 오른쪽의 숨겨진 아이콘도 확인하세요. 트레이 아이콘이 있으면 트레이에서 기본 창을 복원해 보세요. 계속 두 번 클릭해 여러 번 실행하지 마세요.
| 증상 | 먼저 확인할 항목 | 다음 단계 |
|---|---|---|
| 프로세스는 있지만 창이 보이지 않음 | 트레이, 이미 실행 중인 인스턴스, 창 위치 | 창 복원을 시도하고, 필요하면 종료 후 다시 실행 |
| 프로세스가 잠시 나타났다가 사라짐 | 런타임, 오류 로그, 설정 읽기 | 종료 시간을 기록하고 이벤트 뷰어 열기 |
| 기본 창은 정상이나 코어에서 오류 발생 | 코어 파일, 포트 사용 여부, 생성된 설정 | 클라이언트 하단 로그 확인. 데스크톱 런타임은 먼저 재설치하지 않음 |
| Windows에서 차단 알림 표시 | 파일 출처, 보안 기록, 조직 정책 | 설치 파일 출처를 확인하고 구체적인 차단 사유 확인 |
데스크톱 인터페이스와 Xray, V2Ray 등의 코어는 별개의 프로세스입니다. 기본 창이 열린 상태에서 로그에 포트 바인딩 실패가 표시된다면 다른 문제 해결 절차를 따라야 합니다. 반대로 기본 프로그램이 초기화를 마치지 못했다면 VMess, VLESS, Trojan 노드를 바꿔도 실행 오류가 해결되지 않는 경우가 많습니다.
현재 상태 보존: 이벤트 뷰어에서 오류 정보 확인
먼저 실행 시각을 기록하며 한 번 실행해 보세요. Windows 이벤트 로그를 확인하면 ‘눌러도 반응 없음’보다 원인을 찾기 쉽습니다. Win + R을 누르고 eventvwr.msc를 입력한 다음 ‘Windows 로그’ → ‘응용 프로그램’에서 방금 실행한 시각과 일치하는 항목을 찾으세요.
-
시각 기록
프로그램을 한 번 실행하고 현재 시각을 기록하세요. 약 10초 후 작업 관리자에서 프로세스가 계속 실행 중인지 종료됐는지 확인합니다.
-
이벤트 필터링
‘Windows 로그’ → ‘응용 프로그램’ → ‘현재 로그 필터링’에서 ‘오류’를 선택하세요. 원본이 ‘.NET Runtime’ 또는 ‘Application Error’인 항목을 확인합니다.
-
프로세스 확인
이벤트의 ‘일반’ 탭을 열어 오류가 발생한 응용 프로그램이 실제로 v2rayN인지 확인하세요. 이벤트 ID 1026이나 1000이 단서가 될 수 있지만, 번호만으로 원인을 단정해서는 안 됩니다.
-
증거 저장
예외 유형, 오류 모듈, 응용 프로그램 경로와 관련 파일 경로를 기록하세요. 공유하기 전에 사용자 이름, 구독 주소, 서버 주소, 인증 정보를 가리세요.
-
기존 폴더 보존
프로그램과 관련 코어를 종료하고 현재 프로그램 폴더 전체를 복사해 백업하세요. 로그에 별도의 사용자 데이터 폴더가 표시된다면 해당 폴더도 백업합니다. 기존 설정을 바로 덮어쓰거나 삭제하지 마세요.
응용 프로그램 폴더에 guiLogs 등의 로그 폴더가 있다면 수정 시각을 기준으로 최신 파일도 확인하세요. 폴더 이름과 위치는 버전이나 패키징 방식에 따라 다를 수 있습니다. 앱 로그가 생성되지 않았다고 충돌이 없었던 것은 아닙니다. 로그 시스템 초기화 전에 오류가 발생했을 수 있으므로 이때는 Windows 이벤트 로그를 먼저 확인하세요.
.NET 런타임: 패키지 요구 사항을 확인하고 버전을 추측하지 마세요
v2rayN은 버전과 데스크톱 빌드에 따라 필요한 종속성이 다를 수 있습니다. 외부 런타임이 필요한 패키지와 자체 포함 패키지도 구분해야 합니다. 오래된 안내를 따라 특정 .NET 주 버전을 무조건 설치하지 말고, 현재 패키지 설명을 확인한 뒤 프로그램 폴더의 v2rayN.runtimeconfig.json을 살펴보세요. 파일이 있다면 framework 또는 frameworks 아래의 name과 version을 확인합니다.
You must install or update .NET to run this application.
원인: 프로그램을 시작하는 호스트가 요구되는 런타임을 찾지 못했습니다. 해결: 오류 메시지에 나온 Framework, Architecture, 버전을 확인해 필요한 종속성을 설치한 뒤 프로그램을 완전히 종료하고 다시 실행하세요.
BadImageFormatException
원인: 아키텍처가 맞지 않거나 손상된 어셈블리 또는 네이티브 구성 요소가 로드됐을 수 있습니다. 해결: 시스템과 프로그램 패키지의 아키텍처, 오류에 언급된 파일을 확인하고 새 폴더에 설치한 패키지와 비교해 테스트하세요.
요구 사항에 Microsoft.WindowsDesktop.App이 표시된다면 일반적으로 해당 아키텍처에 맞는 .NET Desktop Runtime이 필요합니다. 일반 .NET Runtime이나 ASP.NET Core Runtime으로 대체할 수 없습니다. Microsoft.NETCore.App이 표시된다면 해당 빌드 요구 사항에 맞춰 확인하세요. 그래픽 인터페이스가 있다는 이유만으로 Windows 데스크톱 런타임이 반드시 필요하다고 단정해서는 안 됩니다.
# 압축을 푼 v2rayN 폴더에서 PowerShell 열기
Get-Content .\v2rayN.runtimeconfig.json
# 현재 명령에서 사용하는 dotnet 호스트가 인식하는 런타임 확인
dotnet --list-runtimes
# 이 dotnet 호스트의 환경 및 아키텍처 정보 확인
dotnet --info- 아키텍처 확인: Windows ‘설정’ → ‘시스템’ → ‘정보’에서 ‘시스템 종류’를 확인하세요. 파일 이름이 비슷하다고 x64 패키지와 ARM64 패키지를 서로 바꿔 사용할 수 있는 것은 아닙니다.
- 주 버전 확인: 더 높은 주 버전을 설치했더라도 이전 주 버전이 필요한 프로그램까지 실행된다는 뜻은 아닙니다. 주 버전 간 호환 여부는 프로그램의 런타임 설정에 따라 달라집니다.
- SDK 구분: 일반적으로 앱 실행에 전체 SDK가 필요하지 않습니다. 개발 도구 설치는 런타임 누락을 해결하기 위한 필수 단계가 아닙니다.
- 명령어의 한계 이해:
dotnet을 인식하지 못한다면 호스트가 설치되지 않았거나 PATH에 경로가 포함되지 않았을 수 있습니다. 이 사실만으로 자체 포함 패키지가 실행되지 않는다고 판단할 수는 없습니다.
폴더 권한: 압축을 완전히 푼 뒤 쓰기 테스트
압축 파일 미리보기 창에서 프로그램을 실행하면 기본 프로그램 파일만 임시로 풀리고 종속 파일은 누락될 수 있습니다. 기존 폴더에 여러 번 덮어써서 업데이트하면 호환되지 않는 구성 요소가 남을 수도 있습니다. 전체 패키지를 현재 계정에서 쓸 수 있는 로컬 폴더에 풀어 보세요. 예를 들어 사용자 폴더 아래에 Apps\v2rayN-test를 새로 만들고, 새 파일과 기존 파일을 섞지 마세요.
UnauthorizedAccessException
원인: 대상 파일이나 폴더에 접근할 권한이 부족하거나 보호된 위치일 수 있습니다. 해결: 오류에 표시된 전체 경로를 확인하고 현재 계정에서 쓸 수 있는 폴더에서 테스트한 다음, 보안 소프트웨어의 차단 기록을 확인하세요.
The process cannot access the file because it is being used by another process.
원인: 다른 프로세스가 파일을 사용 중입니다. 해결: 중복 실행된 인스턴스와 이전 코어를 종료하고 해당 폴더의 동기화를 일시 중지한 뒤 다시 시도하세요. 프로그램이 실행 중일 때 설정 파일을 교체하지 마세요.
- 대상 폴더에 텍스트 파일을 하나 만들었다가 삭제해 기본 쓰기 권한을 확인하세요. 이 테스트에 성공해도 모든 하위 폴더의 권한이 정상이라는 뜻은 아니므로 오류에 표시된 경로도 확인해야 합니다.
- ‘Windows 보안’ → ‘바이러스 및 위협 방지’ → ‘보호 기록’에서 해당 시각에 차단 기록이 있는지 확인하세요. 모든 보호 기능을 끄는 것은 일반적인 해결 방법이 아닙니다.
- 제어된 폴더 액세스를 사용 중이라면 차단된 프로그램의 경로를 확인하세요. 출처와 파일 용도를 확인한 뒤에만 시스템 안내에 따라 해당 프로그램에 권한을 부여하세요.
- 동기화 드라이브, 네트워크 공유, 로컬 폴더에서 여러 복사본을 동시에 실행하지 마세요. 문제를 확인하는 동안에는 테스트 폴더 하나만 사용하세요.
설정 손상: 새 폴더에서 비교 테스트
예외에 JsonException, 데이터베이스 읽기 오류, 설정 역직렬화 실패가 나타날 때는 로컬 상태를 우선 확인하세요. 갑작스러운 정전, 프로세스 강제 종료, 서로 다른 버전으로 번갈아 읽고 쓰는 상황에서 설정을 읽지 못할 수 있습니다. 노드 연결 실패만으로 클라이언트 설정 파일이 손상됐다고 볼 수는 없습니다.
- 기존 인스턴스 종료. 트레이에서 종료하세요. 창을 사용할 수 없다면 작업 관리자에서 관련 프로세스가 모두 종료됐는지 확인합니다.
- 원본 백업. 현재 폴더와 실제 사용 중인 사용자 데이터 폴더를 복사하세요. 백업에는 인증 정보가 포함될 수 있으므로 안전한 위치에 보관합니다.
- 새 폴더 만들기. 같은 출처의 전체 프로그램 패키지를 새 위치에 압축 해제하세요. 첫 테스트에서는 이전 설정, 구독 데이터베이스, 사용자 지정 라우팅을 복사하지 마세요.
- 비교 결과 확인. 새 폴더에서 실행된다면 기존 폴더의 파일이나 설정에 문제가 있을 가능성이 큽니다. 여전히 종료된다면 런타임, 시스템 이벤트, 보안 차단 여부를 다시 확인하세요.
- 항목별 복원. 필요한 구독을 먼저 복원한 뒤 라우팅, DNS, 기타 설정을 복원하세요. 항목을 하나씩 복원할 때마다 종료 후 다시 실행해 어떤 설정에서 문제가 발생하는지 확인합니다.
일부 빌드는 사용자 폴더에 데이터를 저장하므로 프로그램 폴더를 바꿔도 같은 설정을 읽을 수 있습니다. 새 폴더에서도 증상이 같다면 로그나 해당 버전 안내에서 데이터 위치를 먼저 확인하세요. 백업을 마치고 프로그램을 종료한 뒤 관련 설정 폴더의 이름만 변경하세요. 사용자 설정 폴더 전체를 한꺼번에 삭제하지 마세요. 이전 버전에서 새 버전이 저장한 데이터를 읽지 못할 수도 있으므로 프로그램을 이전 버전으로 되돌릴 때는 업데이트 전 백업을 함께 사용하세요.
기본 창 복구 후 코어와 프록시 확인
기본 창이 안정적으로 열린 다음 네트워크 계층을 확인하세요. 데스크톱 프로그램 종속성, 코어 종속성, 라우팅 설정은 서로 다른 문제입니다. 먼저 TUN을 끈 상태에서 코어가 시작되는지 확인한 뒤 시스템 프록시와 기존 설정을 하나씩 켜면 어느 단계에서 문제가 생기는지 파악하기 쉽습니다.
| 확인 항목 | 조치 | 판단 기준 |
|---|---|---|
| 수신 포트 | ‘설정’ → ‘매개변수 설정’에서 로컬 수신 포트를 확인하세요. 현재 화면에 표시되는 항목을 기준으로 합니다. | 모든 버전에서 같은 포트를 사용한다고 단정하지 마세요. |
| 포트 사용 여부 | 설정된 포트가 10808이라면 아래 명령으로 PID를 확인하세요. | 포트가 열려 있어도 이상이라고 단정할 수 없습니다. 예상한 코어가 사용하는지 확인하세요. |
| 시스템 프록시 | Windows ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 확인하세요. | 대상 주소와 포트가 현재 클라이언트의 수신 설정과 일치해야 합니다. |
| TUN 모드 | 기본 프록시가 작동한 다음 활성화하고 권한 및 코어 로그를 확인하세요. | 가상 네트워크 어댑터 오류와 데스크톱 런타임 누락은 따로 해결하세요. |
# 로컬 수신 포트가 실제로 10808로 설정된 경우에만 사용
netstat -ano | findstr ":10808"
# 작업 관리자의 ‘세부 정보’에서 마지막 열의 PID로 프로세스 확인v2rayN이 비정상 종료된 뒤 브라우저에서 웹페이지도 열리지 않는다면 시스템에 로컬 주소를 가리키는 수동 프록시 설정이 남아 있고, 로컬 수신 포트는 이미 닫혔을 수 있습니다. 현재 설정을 기록한 뒤 Windows 프록시 설정에서 해당 수동 프록시를 확인하고 비활성화하세요. 조직 정책으로 관리되는 설정은 임의로 변경하지 마세요. 네트워크가 복구되어도 프로그램의 갑작스러운 종료가 해결된 것은 아닙니다. 종료와 재실행, 코어 시작까지 확인하세요.
자주 묻는 질문: 재설치, 관리자 권한, 구독 복원
.NET을 설치했는데도 런타임이 없다고 표시되는 이유는 무엇인가요?
시작 오류에 나온 프레임워크 이름, 버전, 아키텍처를 다시 대조하세요. 일반 Runtime과 Desktop Runtime은 다르고 x64와 ARM64도 서로 다릅니다. dotnet --list-runtimes로 확인할 수 있지만, 명령어가 어느 아키텍처의 호스트를 호출하는지도 확인해야 합니다.
관리자 권한으로 실행되면 계속 이렇게 사용해도 되나요?
먼저 오류와 관련된 경로를 확인하고 전체 패키지를 현재 사용자가 쓸 수 있는 폴더에 둔 뒤 일반 권한으로 실행하세요. TUN을 켤 때만 권한이 필요한 경우에는 해당 권한 요구와 기본 창의 파일 접근 권한을 별개로 처리해야 합니다.
설정을 삭제해 복구하면 구독을 다시 찾을 수 있나요?
백업에서 구독 주소와 필요한 정보를 보존한 뒤 새 설정에 다시 추가하세요. 이전 데이터베이스 전체를 곧바로 덮어쓰면 문제가 다시 생길 수 있습니다. 백업이 없다면 추가 복구를 시도하기 전에 기존 폴더부터 보존하세요.
몇 번이나 재설치해도 해결되지 않았습니다. 어떤 정보를 준비해야 하나요?
Windows 버전과 아키텍처, 프로그램 패키지 종류, 설치된 런타임 목록, 정확한 오류 발생 시각, 이벤트 뷰어의 예외 유형과 오류 모듈을 정리하세요. 새 폴더에서 실행되는지도 함께 확인하면 ‘최신 버전인데도 바로 종료된다’는 설명만 하는 것보다 원인 파악에 도움이 됩니다.
최종 확인은 세 가지입니다. 일반 권한으로 기본 창이 열리고, 종료한 뒤 다시 실행할 수 있으며, 필요한 기능을 켠 후에도 같은 시작 오류가 반복되지 않아야 합니다. 먼저 클라이언트 실행 문제를 해결한 뒤 구독, DNS, 라우팅 분할을 복원하면 불필요한 변경을 줄이고 이후 업데이트로 문제가 생겼는지도 판단하기 쉽습니다.