Xray 코어 시작 실패 해결: 포트 충돌·JSON 형식·필드 오류 점검

Windows용 v2rayN을 처음 설치할 때는 설치 파일 이름에 있는 Desktop과 WPF 중 무엇을 받아야 하는지, 압축을 푼 뒤 어떤 파일을 실행해야 하는지부터 헷갈릴 수 있습니다. 두 버전은 주로 화면 인터페이스와 실행 환경이 다르며, 선택만으로 노드의 프로토콜이나 연결 속도가 달라지는 것은 아닙니다. 아래 순서대로 버전을 고르고, 실행 후에는 코어와 시스템 프록시 상태까지 확인하세요.

Desktop과 WPF는 어떤 차이가 있나요?

v2rayN은 노드와 구독을 관리하는 클라이언트이며, 실제 프록시 연결은 선택된 코어가 처리합니다. Desktop과 WPF는 클라이언트 인터페이스의 선택지입니다. 따라서 WPF를 선택했다고 VMess나 VLESS가 자동으로 더 잘 연결되거나, Desktop이 항상 더 빠른 것은 아닙니다. 노드 링크를 가져온 뒤 어떤 코어가 사용되는지, 그 코어가 노드의 전송 및 보안 설정을 지원하는지를 따로 확인해야 합니다.

배포 파일과 요구 사항은 버전에 따라 바뀔 수 있으므로, 특정 .NET 버전이나 Windows 빌드가 모든 릴리스에 공통이라고 가정하지 마세요. 다운로드 항목의 안내와 실행 시 표시되는 오류를 기준으로 필요한 구성 요소를 확인하는 편이 정확합니다. Desktop이 실행되지 않는다고 노드 설정부터 바꾸지 말고, WPF와 Desktop의 실행 환경 문제를 먼저 구분하세요.

다운로드한 뒤 전용 폴더에 압축 풀기

다운로드 센터에서 Windows 항목을 열고 Desktop 또는 WPF 중 하나를 선택하세요. 파일 이름에 표시된 버전과 아키텍처를 확인하고, 서로 다른 배포판을 한 폴더에 섞지 않는 것이 좋습니다. 처음 실행할 때는 다운로드 파일을 바탕 화면에서 바로 실행하기보다, 쓰기 권한이 있는 사용자 폴더 아래에 전용 폴더를 만들고 압축을 푸세요. 예를 들어 %USERPROFILE%\Apps\v2rayN처럼 사용자가 관리할 수 있는 경로를 사용할 수 있습니다.

1. 배포판 선택

   다운로드 센터의 Windows 항목에서 Desktop 또는 WPF를 고릅니다. 파일 이름과 화면에 표시된 요구 사항을 확인하고, 출처가 불분명한 재배포 파일은 사용하지 마세요.

2. 별도 폴더 생성

   사용자 폴더 아래에 Apps\v2rayN과 같은 전용 폴더를 만들고 압축을 풉니다. 압축 파일 안의 실행 파일만 따로 꺼내면 함께 제공된 파일을 찾지 못할 수 있습니다.

3. 실행 파일 확인

   압축을 푼 폴더에서 v2rayN 실행 파일을 실행합니다. Windows가 게시자나 파일 실행을 확인하면 다운로드 출처와 파일명을 먼저 대조하고, 출처가 확인된 경우에만 계속 진행하세요.

4. 초기 구성 확인

   메인 화면이 열리면 코어 관련 시작 메시지와 로그를 확인합니다. 구독을 사용한다면 제공받은 주소를 구독 메뉴에 등록하고 업데이트한 뒤, 목록에 노드가 표시되는지 확인하세요.

5. 연결 한 번 점검

   노드 하나를 선택해 서비스 메뉴에서 시스템 프록시를 켜고, 브라우저에서 요청을 한 번 보냅니다. 동작을 확인한 뒤에는 필요에 따라 시스템 프록시를 끄거나 다른 적용 방식을 설정하세요.

포터블 형태로 배포되는 파일은 일반 설치 마법사 없이 압축 해제 후 실행하는 방식일 수 있습니다. 따라서 실행 파일만 다른 위치로 옮기지 말고, 프로그램 폴더 전체를 유지하세요. 폴더를 이동하거나 삭제하기 전에 구독이나 사용자 설정을 보존해야 하는지 확인하고, 업데이트 과정에서는 기존 폴더를 덮어쓰기보다 새 폴더에 새 버전을 풀어 실행 여부를 확인하는 방법이 안전합니다.

처음 실행한 뒤 노드와 프록시를 확인하는 순서

창이 열리는 것과 프록시가 동작하는 것은 별개의 단계입니다. 구독 업데이트 성공은 구독 서버에서 목록을 받아왔다는 뜻일 수 있지만, 선택한 노드로 대상 사이트에 연결할 수 있는지까지 보장하지는 않습니다. 우선 노드 하나만 선택하고, 코어 시작 메시지에 실패가 없는지 확인한 다음 시스템 프록시 상태를 점검하세요. 여러 노드를 한꺼번에 시험하면 어느 설정에서 문제가 생겼는지 파악하기 어려워집니다.

수동으로 프록시를 설정한 앱이나 브라우저를 사용한다면 로컬 주소와 포트가 현재 v2rayN 설정과 일치하는지도 확인해야 합니다. 10808은 설명을 위한 포트 예시이며 모든 설치에서 고정된 기본값이라는 뜻은 아닙니다. 실제 값은 클라이언트의 로컬 포트 설정에서 확인하세요. 다른 프로그램이 해당 포트를 사용 중이면 오류가 날 수 있으므로, 임의로 숫자를 바꾸기 전에 점유 프로세스와 앱의 수동 설정을 함께 확인하세요.

.NET 오류와 Defender 차단은 따로 해결하기

실행 직후 특정 런타임이 없다는 메시지가 나오면 그 문구를 그대로 기록하세요. Desktop Runtime을 요구하는 프로그램에 일반 Runtime만 설치하거나, x64와 다른 아키텍처의 런타임을 설치하면 문제가 해결되지 않을 수 있습니다. 현재 배포판의 안내에서 요구하는 런타임 종류와 아키텍처를 확인한 뒤 Microsoft의 공식 배포 경로에서 해당 구성 요소를 설치하고 다시 실행하세요. 필요하지 않은 런타임을 여러 개 무작정 설치하는 방식은 피하는 편이 좋습니다.

Windows Defender가 파일을 차단하거나 격리했다면 알림에 표시된 파일 이름과 탐지 내용을 확인하세요. 다운로드 출처를 검증하고, 실제로 공식 배포 파일인지 확인한 뒤 대응해야 합니다. 보안 경고를 무조건 해제하거나 프로그램 폴더 전체를 예외로 등록하지 마세요. 파일 출처를 확인할 수 없거나 탐지 내용이 의심스럽다면 실행하지 말고, 기존 파일을 제거한 뒤 신뢰할 수 있는 다운로드 경로에서 다시 받으세요.

• 런타임 오류: 오류 문구에 적힌 런타임 종류와 x64 등 아키텍처를 배포 안내와 대조합니다.
• 파일이 격리됨: Defender 보호 기록에서 대상 파일과 조치를 확인하고, 출처가 검증되지 않으면 복원하거나 허용하지 않습니다.
• 창은 열리지만 코어가 시작되지 않음: 메인 화면의 로그에서 실행 파일 경로와 코어 시작 오류를 확인합니다. 인터페이스 런타임 문제와 노드 연결 문제를 혼동하지 마세요.
• 연결은 되지만 특정 앱만 실패: 시스템 프록시를 따르는 앱인지, 앱 자체 프록시 설정이 별도로 남아 있는지 점검합니다.

자주 묻는 질문