v2rayNG 커널 시작 오류 해결: 로그로 설정 문제 찾기

먼저 확인할 점: 커널이 시작되지 않는 문제인가, 시작 후 연결에 실패하는 문제인가

v2rayNG는 안드로이드 클라이언트이며, 이 글에서는 클라이언트가 사용하는 Xray 커널 로그를 기준으로 문제를 살펴봅니다. 연결 버튼을 누른 뒤 VPN 아이콘이 표시되어도 안드로이드에서 관련 서비스가 실행 중이라는 뜻일 뿐, 노드가 정상 작동한다고 단정할 수는 없습니다. 반대로 웹페이지가 열리지 않아도 커널 시작 실패라고 볼 수는 없습니다. 로컬 리스닝이 시작된 뒤 처음 접속할 때 시간 초과가 발생한다면 원격 연결 경로를 확인해야 합니다.

하나의 로그에서 >로 여러 단계의 원인이 연결되어 표시될 수 있습니다. 앞부분의 ‘시작 실패’는 결과이고, 뒤에 나오는 문자, 포트, 인증서 관련 설명이 근본 원인에 더 가깝습니다. 로그를 확인할 때는 전체 오류 흐름을 보존한 뒤 끝부분부터 구체적인 대상을 찾아보세요. 눈에 띄는 빨간색 한 줄만 잘라내지 마세요.

로그를 깔끔하게 수집하는 방법: 연결 버튼을 누르는 순간부터

현재 노드와 사용자 지정 설정을 먼저 보존한 다음 로그를 수집하세요. v2rayNG는 버전에 따라 번역이나 메뉴 위치가 조금 다를 수 있습니다. 일반적으로 메인 화면 왼쪽 위 메뉴에서 ‘로그’를 열고, ‘설정’에서 로그 수준을 조정합니다. 같은 이름의 메뉴가 없다면 현재 버전의 화면을 기준으로 확인하세요. 데스크톱 v2rayN의 ‘매개변수 설정’ 경로를 그대로 따라 해서는 안 됩니다.

1. 환경 정보 기록

   안드로이드 ‘설정’ → ‘앱’ → ‘v2rayNG’의 앱 정보에서 클라이언트 버전을 확인하고, 안드로이드 버전, 노드 프로토콜, 사용자 지정 설정 사용 여부도 기록하세요. 로그에 커널 버전이 표시되면 함께 보관하세요.

2. 연결 중지

   v2rayNG 메인 화면으로 돌아가 연결 버튼을 눌러 서비스를 중지하세요. 안드로이드 VPN 서비스 전환으로 문제가 더해지지 않도록 다른 VPN 앱도 잠시 중지하세요.

3. 로그 수준 조정

   ‘설정’ → ‘로그 수준’에서 먼저 info를 선택하세요. 단서가 부족하면 잠시 debug로 변경합니다. 전체 사용자 지정 JSON을 사용한다면 그 안의 log.loglevel도 확인하세요.

4. 문제 재현

   ‘로그’를 열고 지우기 기능으로 기존 기록을 삭제한 뒤 메인 화면으로 돌아가 연결을 한 번 시도하세요. 서비스가 계속 실행 중이면 웹페이지를 한 번 열고 로그로 돌아와 같은 시간대의 기록을 확인합니다.

5. 앞뒤 로그 보존

   처음 실패한 시점 전후의 로그를 빠짐없이 복사하세요. 공유하기 전 구독 주소, UUID, 비밀번호, 서버 정보는 가리되 필드 이름, 오류 순서, 같은 주소 사이의 대응 관계는 유지하세요.

debug는 자세한 정보를, info는 일반적인 처리 과정을 기록합니다. warning은 이상 징후를 알리고 error는 작업 실패를 나타냅니다. 이는 ‘노드 품질’을 평가하는 점수가 아닙니다. 특정 요청에서 오류가 발생해도 커널 전체가 종료된 것은 아닐 수 있고, 오류가 보이지 않는다면 로그 수준이 너무 높게 설정되었을 수도 있습니다. 문제를 해결한 뒤에는 불필요한 기록을 줄이도록 로그 수준을 원래대로 돌려놓으세요.

JSON 문법 오류: 형식을 먼저 고친 다음 노드 확인

사용자 지정 설정을 가져온 직후 시작에 실패했다면 먼저 파싱 오류를 확인하세요. JSON의 속성 이름과 문자열에는 영문 큰따옴표를 사용해야 합니다. 한글 따옴표, 쉼표 누락, 불필요한 마지막 쉼표는 오류를 일으킬 수 있습니다. 설정을 옮기거나 문제를 찾기 쉽도록 아래 예시는 주석 확장 기능을 지원하는 특정 로더에 의존하지 않는 엄격한 JSON 형식으로 작성했습니다.

아래 일부 설정 예시에서는 "warning" 뒤에 쉼표가 하나 더 있습니다. 오류가 쉼표가 아니라 다음 줄의 닫는 중괄호를 가리킬 수도 있으므로 위치를 찾을 때는 바로 앞 줄도 확인하세요.

{
  "log": {
    "loglevel": "warning",
  }
}

수정한 예시는 다음과 같습니다. log 작성 방법만 보여주는 예시로, 단독으로 연결할 수 있는 완전한 설정은 아닙니다. 기존 파일에서 해당 객체만 바꾸고 인바운드, 아웃바운드, 라우팅 설정은 덮어쓰지 마세요.

{
  "log": {
    "loglevel": "warning"
  }
}

포트 충돌: 로컬 리스닝을 확인하고 서버 포트는 바꾸지 마세요

bind 오류는 로컬 리스닝 단계에서 발생합니다. 원격 서버 연결 실패와는 다른 문제입니다. 아래 포트 번호는 문제 해결을 위한 예시이며 모든 v2rayNG 설치 환경의 기본값은 아닙니다. ‘설정’에 표시된 로컬 포트와 실제 로그를 기준으로 확인하세요.

로그에 127.0.0.1:10808 바인딩 실패가 명확히 표시되면 로컬 SOCKS 포트를 사용하지 않는 10818로 바꾼 뒤 다시 시작해 볼 수 있습니다. 해당 SOCKS 포트를 사용하는 다른 앱의 설정도 함께 변경해야 합니다. 노드 편집 화면에서 원격 포트만 바꿔서는 로컬 리스닝을 해제할 수 없으며, 정상적인 노드 설정을 망가뜨릴 수 있습니다.

필드 오타와 커널 지원 여부: JSON 문법이 맞는 것만으로는 부족합니다

JSON 파싱에 성공했다는 것은 형식이 올바르다는 뜻일 뿐, Xray가 모든 값을 받아들인다는 뜻은 아닙니다. 예를 들어 streamSettings의 network에는 커널에서 지원하는 전송 식별자를 사용해야 합니다. WebSocket은 ws로 지정해야 하며 임의로 websocket이라고 입력하면 안 됩니다. 클라이언트 화면에 표시된 프로토콜 이름과 설정에 입력할 문자열이 다를 수도 있습니다.

• 필드 대소문자 확인: streamSettings, serverName, wsSettings는 설정 규칙에 맞게 작성하세요. 비슷한 철자를 짐작해 입력하지 마세요.
• 필드 형식 확인: 불리언 값은 true 또는 false로 입력하고 따옴표를 붙여 문자열로 만들지 마세요. 포트는 일반적으로 숫자로 입력합니다.
• 필드 위치 확인: TLS의 serverName은 해당 tlsSettings 안에 입력해야 합니다. 아웃바운드 객체의 최상위로 임의로 옮기면 안 됩니다.
• 설정 조합 확인: VLESS와 VMess는 프록시 프로토콜, WebSocket은 전송 방식, TLS는 보안 계층입니다. 가져올 때 각 항목을 따로 확인하고 서로 바꿔 쓰지 마세요.

아래는 WebSocket과 TLS의 구조를 확인하기 위한 예시입니다. 도메인과 경로는 예시 값이므로 실제 환경에서는 서버 설정과 일치해야 합니다. 이 객체만으로는 완전한 아웃바운드 설정이 되지 않습니다.

{
  "streamSettings": {
    "network": "ws",
    "security": "tls",
    "tlsSettings": {
      "serverName": "example.com"
    },
    "wsSettings": {
      "path": "/tunnel",
      "headers": {
        "Host": "example.com"
      }
    }
  }
}

알 수 없는 필드가 항상 시작 오류를 일으키는 것은 아닙니다. 일부 로딩 과정에서는 해당 필드를 무시해 의도한 설정이 적용되지 않을 수 있습니다. 반대로 새 매개변수를 지원하지 않는 구형 커널에 사용하면 설정 구성 단계에서 실패할 수 있습니다. 업데이트 전에 클라이언트와 커널 정보를 기록하고 기존 설정을 보관하세요. 업데이트 후에는 기존 노드를 먼저 테스트하고 프로토콜과 전체 라우팅 설정을 동시에 바꾸지 마세요.

전송 및 인증서 오류: 대개 시작 이후 발생합니다

커널에서 이미 로컬 리스닝이 시작되었고 웹페이지에 접속할 때만 아래 오류가 나타난다면 JSON의 쉼표를 계속 확인할 필요는 없습니다. 먼저 노드 주소와 원격 포트를 확인한 다음 TLS, 보안 매개변수, 전송 설정을 대조하세요. 아래는 자주 나타나는 오류 예시이며, 전체 접두어나 부가 문구는 커널 버전에 따라 달라질 수 있습니다.

TLS의 serverName은 서버 이름과 관련된 핸드셰이크 및 인증서 확인에 사용되고, WebSocket의 Host는 HTTP 요청에 사용됩니다. 두 값은 같을 수도 있고 서버 구성에 따라 다를 수도 있습니다. 오류를 없애려고 인증서 검증을 바로 끄지 마세요. 도메인이나 인증서 설정 문제가 가려질 수 있습니다.

수정 후 다시 테스트: 단서를 보존하고 무작정 연속으로 바꾸지 마세요

한 가지를 수정한 뒤 서비스를 중지하고 이전 로그를 지운 다음 다시 연결하세요. 먼저 커널이 계속 실행되는지 확인한 다음 웹페이지 요청을 한 번 보내고 해당 요청에서 새 오류가 발생했는지 살펴보세요. 구독을 업데이트하면 노드가 다시 생성되어 수동 수정이 덮어써질 수 있으므로, ‘이제 된다’는 사실만 기억하지 말고 수정한 이유를 기록하세요.

마지막으로 간단한 문제 해결 기록을 남겨 두세요. 클라이언트 버전, 사용 중인 커널 정보, 처음 발생한 전체 오류, 변경한 항목 하나, 재테스트 결과를 기록하면 같은 오류가 다시 생겼을 때 기존 문제가 재발한 것인지 다음 단계에서 새 문제가 발생한 것인지 판단하기 쉽습니다.