커널 시작 실패 문제 해결: 로그 첫 줄에서 설정 오류 찾기

클라이언트에 “시작 실패”가 표시되어도 노드 자체가 작동하지 않는 것은 아닙니다. v2rayN, v2rayNG 같은 그래픽 클라이언트는 먼저 노드, 라우팅, 로컬 리스닝 설정을 커널 설정으로 변환한 뒤 Xray 또는 v2fly 커널을 시작합니다. 생성된 설정, 리스닝 포트, 인증서 파일, 필드 구조 중 어느 한 곳에서라도 오류가 발생하면 프록시 연결을 맺기 전에 커널 프로세스가 종료됩니다.

효율적인 점검 방법은 노드를 계속 바꾸는 것이 아니라 이번 시작에 해당하는 첫 번째 오류를 찾는 것입니다. 로그 마지막에는 “failed to start”, “app/proxyman”, 종료 코드 같은 요약 정보가 여러 겹으로 표시될 수 있지만, 실제 원인은 대개 이러한 요약보다 앞에 있습니다. 가장 먼저 나타난 명확한 오류부터 처리한 뒤 한 번 재시작하고 새 로그를 확인하면 연쇄적으로 발생한 후속 오류에 혼동되지 않습니다.

이번 시작의 전체 로그 먼저 확보하기

로그는 방금 수행한 시작 작업과 일치해야 합니다. 오래된 로그에는 이미 해결한 오류가 남아 있을 수 있으므로 눈에 띄는 빨간색 줄만 검색하면 엉뚱한 문제를 처리하기 쉽습니다. 먼저 커널을 중지하고 현재 시간을 기록한 다음 다시 시작하세요. 이후 시작 시각과 가장 가까운 타임스탬프부터 아래로 읽다가 error, failed, invalid 또는 cannot이 포함된 첫 기록에서 멈춥니다.

v2rayN 데스크톱

1. 메인 창 하단에서 로그 영역을 엽니다. 영역이 접혀 있다면 하단 정보 패널을 펼친 후 “로그”로 전환하세요.
2. “설정” → “매개변수 설정” → “기본 설정”으로 이동해 로그 수준이 완전히 꺼져 있지 않은지 확인합니다. 일상적인 문제 해결에는 warning을 사용하고, 설정 로딩 과정을 확인할 때는 잠시 info로 변경하세요.
3. 서비스 중지를 클릭하고 약 2초 기다린 뒤 현재 설정을 다시 시작합니다. 커널 버전이 표시된 줄부터 프로세스 종료 줄까지의 내용을 복사하세요.
4. 메인 창에 클라이언트 로그와 커널 로그가 함께 표시된다면 Xray, V2Ray, Core 또는 설정 파일 경로가 포함된 기록을 우선 확인하세요.

v2rayNG Android

1. 현재 연결을 끊은 뒤 메인 화면 오른쪽 상단 메뉴에서 “로그”를 엽니다.
2. 메인 화면으로 돌아가 대상 설정을 선택해 시작한 다음 즉시 로그 페이지로 돌아갑니다.
3. 가장 최근의 커널 시작 기록부터 확인합니다. 내용이 너무 빠르게 스크롤되면 먼저 연결을 중지한 뒤 마지막 시작으로 생성된 기록을 복사하세요.
4. v2rayNG에서 Xray 커널을 사용할 때 설정 검증, VLESS 필드, TLS 오류는 커널이 직접 출력합니다. 클라이언트 상단의 짧은 안내는 상태 확인용일 뿐 상세 로그를 대신할 수 없습니다.

포트 충돌: 커널이 로컬 리스닝을 생성하지 못함

프록시 커널은 시작 후 먼저 로컬 컴퓨터에 SOCKS, HTTP 또는 투명 프록시 리스너를 생성합니다. v2rayN에서 흔히 사용하는 조합은 127.0.0.1:10808과 127.0.0.1:10809입니다. 이전 커널이 종료되지 않았거나 다른 클라이언트가 실행 중이거나 다른 프로그램이 같은 포트를 사용하고 있으면 새 프로세스는 원격 노드를 처리하기 전에 실패합니다.

이 문제는 서버 지연 시간이나 VMess, VLESS 매개변수와 관련이 없습니다. 오류에 listen, bind, address와 포트 번호가 함께 나타나면 먼저 로컬 리스닝을 처리하세요. 모든 노드가 같은 로컬 진입점을 공유하므로 노드를 계속 바꿔도 점유된 포트는 해제되지 않습니다.

포트를 변경한 뒤 함께 확인할 항목

• 시스템 프록시는 보통 v2rayN이 자동으로 업데이트하지만 브라우저나 다운로드 도구에 입력한 수동 프록시 설정은 자동으로 바뀌지 않습니다.
• SOCKS 포트를 10808에서 11808로 변경했다면 앱에 입력한 프록시 주소도 127.0.0.1:11808로 바꿔야 합니다.
• 포트 값은 1부터 65535 범위여야 하며 SOCKS, HTTP, API, LAN 리스닝 포트가 서로 중복되지 않아야 합니다.
• 포트만 바꿨는데 같은 오류가 계속되면 로그에 표시된 실제 포트를 확인하세요. 다른 설정 파일이 설정을 생성하고 있어 변경 사항이 현재 커널에 적용되지 않았을 수 있습니다.

JSON 구문 오류: 아직 프로토콜 검증 단계에 진입하지 못함

V2Ray 및 Xray 커널은 일반적으로 JSON 설정을 읽습니다. 그래픽 클라이언트가 설정을 자동 생성하더라도 전체 설정을 수동으로 가져오거나 사용자 지정 라우팅을 편집하거나 조각을 병합하거나 고급 매개변수를 붙여 넣는 과정에서 쉼표 누락, 불필요한 쉼표, 잘못된 따옴표, 짝이 맞지 않는 괄호가 생길 수 있습니다. 구문 분석에 실패했다는 것은 커널이 아직 VMess, VLESS 또는 라우팅 규칙의 구체적인 의미를 읽지 못했다는 뜻입니다.

로그의 행 번호와 열 번호는 가장 직접적인 위치 정보입니다. 예를 들어 line 42 column 17은 파서가 42번째 줄 17번째 열에서 더 이상 진행하지 못했다는 의미지만 실제 오류는 바로 앞 줄 끝에 있을 수도 있습니다. 대상 위치와 이전 줄을 함께 확인하고, 특히 배열 요소와 객체 필드 사이의 쉼표를 주의하세요.

{
  "inbounds": [
    {
      "port": 10808,
      "protocol": "socks"
    }
  ],
  "outbounds": [
    {
      "protocol": "vless",
      "settings": {}
    }
  ]
}

권장 복구 순서

1. 현재 사용자 지정 설정이나 라우팅 규칙을 먼저 백업하고 유일한 사본을 바로 덮어쓰지 마세요.
2. 구독 노드가 생성한 설정에서 오류가 발생했다면 해당 노드를 삭제하고 구독을 다시 업데이트한 뒤 노드를 다시 선택해 시작하세요.
3. 수동 JSON에서 오류가 발생했다면 먼저 최소 실행 가능 설정으로 되돌린 다음 라우팅, DNS, 전송 설정을 조금씩 추가하세요.
4. 한 부분을 추가할 때마다 한 번씩 시작하세요. 그러면 파일 전체를 동시에 확인하지 않고 최근 변경 사항으로 오류 범위를 좁힐 수 있습니다.

필드 오타 및 버전 호환성: 구문은 올바르지만 구조가 유효하지 않음

JSON이 파싱된다고 해서 현재 커널의 데이터 구조에 맞는 설정이라는 뜻은 아닙니다. 필드 이름 오타, 대소문자 오류, 잘못된 계층, 새 클라이언트가 생성했지만 이전 커널이 인식하지 못하는 필드 때문에 설정 로딩 단계에서 unknown field, failed to build config, invalid value가 발생할 수 있습니다. 이때 괄호와 쉼표는 대체로 문제가 없으므로 필드 이름, 프로토콜 조합, 커널 버전에 집중해야 합니다.

예를 들어 VLESS의 flow, 전송 계층의 network, TLS 관련 serverName은 각각 정해진 위치가 있습니다. 필드 이름을 비슷하게 입력하거나 아웃바운드 필드를 전송 설정에 넣어도 커널이 자동으로 추측해 주지 않습니다. 구독 파서가 오래된 버전이면 새 매개변수를 무시해 최종 설정이 불완전해질 수도 있습니다.

노드 오류, 구독 오류, 전역 오류 구분하기

인증서 및 TLS: 경로, 도메인, 시스템 시간을 나누어 확인

인증서 관련 시작 오류는 주로 로컬 인증서 파일을 불러오거나 TLS 설정을 초기화할 때 발생합니다. 클라이언트가 아웃바운드 연결을 담당하는 경우 대부분의 노드는 사용자가 인증서 파일을 직접 선택할 필요가 없습니다. 설정에 certificateFile, keyFile 또는 로컬 절대 경로가 있다면 해당 파일이 실제로 존재하고 현재 프로세스에 읽기 권한이 있는지 확인하세요.

다른 유형의 오류는 연결이 설정된 후 발생합니다. 인증서 도메인 불일치나 인증서 유효 기간 판정 오류가 그 예입니다. 이런 기록은 커널 프로세스를 즉시 종료시키지 않을 수 있지만 대상 노드 연결은 실패하게 만듭니다. “시작 단계에서 파일을 읽지 못한 경우”와 “연결 단계에서 원격 인증서 검증에 실패한 경우”를 먼저 구분해야 하며, 두 문제의 해결 방향은 다릅니다.

인증서 문제를 판단하는 세 단계

• 먼저 시간: 시스템 날짜가 몇 달 정도 어긋나면 아직 유효한 인증서도 아직 시작되지 않았거나 이미 만료된 것으로 판단될 수 있습니다.
• 다음은 이름: 연결 주소는 진입점 도메인일 수 있지만 TLS 서버 이름은 서버 설정 및 인증서 적용 범위와 일치해야 합니다.
• 마지막은 파일: 로컬 인증서를 명시적으로 사용하는 설정에서만 파일 경로를 확인하면 됩니다. 일반 구독 노드에 인증서나 개인 키 경로를 임의로 추가해서는 안 됩니다.

수정 후 검증: 이전 오류가 새로운 오류로 바뀐 것은 아닌지 확인

한 가지 항목을 수정한 뒤에는 커널을 완전히 중지하고 다시 시작해야 합니다. 인터페이스에서 노드만 전환하면 이전 프로세스나 이전에 생성된 설정을 계속 사용할 수 있습니다. 시작 성공의 최소 기준은 로그에 리스닝 생성 또는 핵심 실행 정보가 나타나고 프로세스가 즉시 종료되지 않으며 로컬 포트가 리스닝 상태이고 이후 요청이 프록시 아웃바운드로 전달되는 것입니다.

첫 번째 오류가 사라졌지만 다른 오류가 나타났다고 해서 수정이 잘못된 것은 아닙니다. 설정 로딩에는 순서가 있어 파서는 이전 단계를 통과한 뒤에야 다음 단계를 검사합니다. 예를 들어 JSON 쉼표를 수정한 후에야 필드 오타가 드러날 수 있고, 10808을 해제한 후에야 인증서 이름 오류가 나타날 수 있습니다. 새로운 첫 번째 오류를 유형별로 계속 처리하면 됩니다.

1. 커널을 중지하고 약 2초 기다려 새 로그와 이전 로그의 시간대를 명확히 구분하세요.
2. 같은 노드를 다시 시작하고 포트, 프로토콜, 라우팅, DNS를 동시에 변경하지 마세요.
3. 로그에 bind, invalid character, unknown field, x509 같은 원래 키워드가 더 이상 나타나지 않는지 확인하세요.
4. 일반 웹페이지를 하나 연 다음 로그에 새로운 연결 기록이 생성되는지 확인하세요.
5. 단일 노드가 정상 작동하는 것을 확인한 뒤 사용자 지정 라우팅, TUN, LAN 리스닝 같은 추가 설정을 복원하세요.

재사용 가능한 문제 기록 양식

클라이언트: v2rayN
커널: Xray
발생 시간: 2026-07-31 14:26
문제 범위: 모든 노드
첫 번째 오류: failed to listen TCP on 127.0.0.1:10808
이번 변경: SOCKS 포트를 11808로 변경
재테스트 결과: 커널이 계속 실행되고 로컬 리스닝이 생성됨

클라이언트, 커널, 발생 시간, 문제 범위, 첫 번째 오류, 한 번의 변경 사항을 기록하면 같은 작업을 반복하는 일을 줄일 수 있습니다. 다음에 비슷한 문제가 발생하면 키워드와 문제 범위를 먼저 비교하고 전체 설정을 재설치하거나 초기화하는 것부터 시작할 필요가 없습니다. 로그 문제 해결의 핵심은 모든 영어 메시지를 외우는 것이 아니라 오류가 어느 단계에서 발생했는지 확인하고 매번 변수 하나만 검증하는 것입니다.