핵심 내용

이 글은 v2rayN 코어가 시작되지 않거나 로컬 포트를 변경한 뒤에도 브라우저에서 인터넷에 접속할 수 없는 데스크톱 사용자를 위한 안내입니다. 먼저 로그에서 바인딩에 실패한 주소와 포트를 확인한 다음, 리스닝 정보를 조회해 해당 프로세스를 찾으세요. 기존 서비스를 유지해야 한다면 v2rayN의 인바운드 포트를 바꾸고 시스템 프록시와 앱 설정을 하나씩 점검하세요.

로그에서 로컬 바인딩 실패 확인하기

먼저 이번 실행의 로그를 확인하고 오류 메시지 주변에 표시된 리스닝 주소, 포트, 전송 프로토콜을 기록하세요. 127.0.0.1:10808 바인딩 실패는 코어가 로컬에 해당 연결 지점을 만들지 못했다는 뜻입니다. 구독이 만료되었거나 원격 노드의 포트를 바꿔야 한다는 의미는 아닙니다. 로컬 연결 지점이 정상적으로 시작된 뒤에야 노드 연결 상태를 점검하면 됩니다.

오류: bind: address already in use

원인 및 해결: 요청한 주소와 포트가 기존 소켓과 충돌했습니다. 먼저 리스닝 중인 프로세스를 확인한 뒤, 기존 인스턴스를 정상 종료하거나 현재 인스턴스의 포트를 변경하세요.

오류: bind: An attempt was made to access a socket in a way forbidden by its access permissions.

원인 및 해결: Windows에서 바인딩이 거부될 때 표시될 수 있는 오류이며, 실제 점유 프로세스가 보이지 않을 수도 있습니다. 리스닝 중인 프로세스를 찾지 못했다면 netsh interface ipv4 show excludedportrange protocol=tcp로 IPv4 TCP 제외 포트 범위를 확인하고, 해당 범위 밖의 포트를 선택하세요. 시스템 예약 항목을 바로 삭제하지 마세요.

포트로 리스닝 프로세스 찾기

Windows PowerShell에서 아래 명령을 실행하세요. 첫 번째 명령은 로컬 TCP 리스닝만 검색하므로 원격 포트가 우연히 10808인 연결은 포함하지 않습니다. 두 번째 명령은 해당 프로그램의 이름과 경로를 확인합니다. 경로가 비어 있어도 프로세스가 없는 것은 아닙니다. 작업 관리자의 ‘세부 정보’ 탭에서 PID를 확인하세요.

$listeners = Get-NetTCPConnection -State Listen -LocalPort 10808,10809 -ErrorAction SilentlyContinue
$listeners | Select-Object LocalAddress, LocalPort, OwningProcess
$listeners | ForEach-Object {
    Get-Process -Id $_.OwningProcess -ErrorAction SilentlyContinue
} | Select-Object -Unique Id, ProcessName, Path

macOS 또는 lsof가 설치된 Linux에서는 두 포트를 각각 조회할 수 있습니다. PID, COMMAND, 리스닝 주소를 확인하세요. 일반 권한으로는 다른 계정의 프로세스 정보가 보이지 않을 수 있습니다. 시작 로그에 UDP 바인딩 오류가 표시된다면 TCP 조회 결과가 아니라 UDP 엔드포인트를 확인하세요. 예를 들어 Windows에서는 Get-NetUDPEndpoint -LocalPort 10808을 실행합니다.

lsof -nP -iTCP:10808 -sTCP:LISTEN
lsof -nP -iTCP:10809 -sTCP:LISTEN

기존 포트를 유지해야 할 때 현재 인스턴스 이전하기

리스닝 프로세스를 계속 사용해야 한다면 해당 설정은 그대로 두고, v2rayN을 확인해 둔 다른 포트로 옮기세요. 그런 다음 원래 v2rayN에 연결하도록 설정된 앱만 수정하세요.

SOCKS 및 HTTP 인바운드 포트 변경

먼저 현재 설치된 버전의 인터페이스에서 포트 설정 방식을 확인하세요. v2rayN 7.x는 배포 버전에 따라 설정 항목이 다를 수 있습니다. ‘로컬 혼합 리스닝 포트’가 표시되면 SOCKS와 HTTP가 같은 포트를 사용합니다. SOCKS와 HTTP 포트가 따로 표시되면 각각 확인하세요. 10809가 모든 버전에 있는 HTTP 포트라고 단정하거나, 항상 SOCKS 포트보다 1 큰 값이라고 가정하지 마세요.

  1. 기존 설정 기록하기

    Windows 데스크톱 앱의 기본 창에서 ‘설정’ → ‘매개변수 설정’으로 이동해 Core 관련 항목의 로컬 리스닝 설정을 확인하세요. 되돌릴 수 있도록 기존 포트, 리스닝 유형, 시스템 프록시 상태를 기록해 두세요.

  2. 변경할 포트 확인하기

    앞서 실행한 포트 조회 명령에서 포트를 18080,18081로 바꾸세요. 이 숫자는 예시일 뿐입니다. 조회 결과가 없다는 것은 현재 해당 포트에서 리스닝하는 항목이 보이지 않는다는 뜻이며, 실제 사용 가능 여부는 시작 후 바인딩 성공으로 확인해야 합니다.

  3. 인바운드 포트 저장하기

    혼합 리스닝이라면 18080을 입력하세요. 포트를 따로 설정한다면 SOCKS에는 18080, HTTP에는 18081을 지정할 수 있습니다. 저장한 뒤 화면 안내에 따라 코어나 클라이언트를 다시 시작하세요. 로컬에서만 사용할 경우 루프백 리스닝을 유지하고, 포트 충돌을 해결하려고 LAN 공유를 켜지 마세요.

  4. 리스닝 프로세스 확인하기

    새 포트를 다시 조회해 현재 클라이언트가 실행한 코어 프로세스가 포트를 사용 중인지 확인하고, 최신 로그에 바인딩 오류가 없는지도 살펴보세요. 포트가 여전히 열리지 않으면 브라우저 설정을 바꾸기 전에 시작 오류부터 해결하세요.

시스템 프록시와 앱 설정 동기화

코어 리스닝프록시 주소프로토콜 확인요청 테스트

로컬 인바운드를 변경해도 바뀌는 것은 로컬 프록시 연결 지점뿐이며, 구독 내용이나 원격 노드 포트에는 영향을 주지 않습니다. v2rayN으로 Windows 시스템 프록시를 관리한다면 코어가 시작된 뒤 트레이의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 구성’을 다시 선택하고 실제로 설정된 주소와 포트를 확인하세요. 조직 정책으로 관리되는 기기에서는 기존 설정을 유지하고 프록시 관리 주체부터 확인하세요.

아래 두 명령은 앞에서 설명한 포트 분리 설정을 기준으로 합니다. Windows에서는 curl.exe를 명시적으로 실행하고, macOS 또는 Linux에서는 명령 이름을 curl로 바꾸세요. 혼합 리스닝 포트로 18080을 사용한다면 두 명령 모두 해당 포트를 사용하면 됩니다.

curl.exe -I --max-time 10 --proxy http://127.0.0.1:18081 https://example.com/
curl.exe -I --max-time 10 --proxy socks5h://127.0.0.1:18080 https://example.com/

명령에서 루프백 포트에 연결할 수 없다면 리스닝 주소와 프로세스를 다시 확인하세요. 로컬 프록시에는 연결되지만 터널이나 대상 요청이 실패한다면 코어 로그를 확인해 아웃바운드 연결과 DNS를 점검하세요. 명령은 성공하지만 브라우저에서 실패할 경우 브라우저의 프록시 설정 출처와 예외 규칙을 먼저 확인하세요. 포트를 다시 변경할 필요는 없습니다. 설정을 되돌려야 한다면 클라이언트와 해당 포트를 사용하는 프로그램을 함께 원래 값으로 바꾸고, 먼저 기존 포트를 사용할 수 있는지 확인하세요.