v2rayN을 시작하거나 노드를 전환할 때 로컬 수신 오류가 발생하는 데스크톱 사용자에게 필요한 안내입니다. 로그에서 주소와 포트를 확인한 다음 해당 포트를 점유한 프로세스를 찾으세요. 기존 프로세스를 유지해야 한다면 v2rayN의 포트를 변경하면 됩니다. 변경 후에는 코어가 새 포트를 수신하는지, 앱이 새 주소를 사용하는지 각각 확인해 두 문제를 구분하세요.
코어 로그에서 충돌 포트 확인
먼저 이번 실행의 코어 로그를 확인하세요. listen tcp와 bind가 포함된 오류는 로컬 수신에 실패했다는 뜻입니다. 로그에 표시된 주소와 포트를 확인해야 합니다. 웹페이지 시간 초과나 노드 테스트 실패만으로는 포트 충돌이라고 단정할 수 없습니다. 노드 설정의 원격 포트는 외부로 나가는 연결에 사용되므로 로컬 수신 문제를 해결하려고 변경하지 마세요.
오류: bind: address already in use
원인 및 해결 방법: 수신 주소가 이미 사용 중인 소켓과 충돌했습니다. 같은 로그에 나온 포트로 프로세스를 확인하고, 더는 사용하지 않는 인스턴스는 종료하거나 현재 클라이언트의 포트를 변경하세요.
오류: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.
원인 및 해결 방법: Windows에서 바인딩을 거부했습니다. 다른 인스턴스가 같은 주소나 겹치는 주소 범위를 수신 중인 경우가 흔합니다. 로컬 주소와 프로세스 ID를 확인하고, 포트 번호만 보고 프로세스를 종료하지 마세요.
두 숫자는 설명을 위한 예시이며, 현재 설치된 버전의 기본값이나 포트 사용 가능 여부를 뜻하지 않습니다. 로그에 0.0.0.0:10808이 표시되면 모든 IPv4 인터페이스에서 수신하려는 것입니다. 다른 항목이 127.0.0.1:10808로 표시되더라도 주소 범위가 겹칠 수 있습니다. [::]:10808도 확인 대상에서 제외하지 마세요. IPv6 와일드카드 수신이 IPv4까지 포함하는지는 소켓 설정에 따라 달라집니다.
netstat 또는 lsof로 포트를 점유한 프로세스 찾기
Windows: 수신 주소와 PID 확인
명령 프롬프트에서 아래 명령을 실행하고 10808을 로그에 표시된 포트로 바꾸세요. TCP 행 중 로컬 주소의 포트가 정확히 일치하고 상태가 LISTENING인 항목만 확인하면 됩니다. 필터 결과에 원격 주소나 더 긴 포트 번호가 포함될 수도 있으므로 이런 행은 로컬 수신의 근거가 아닙니다. 가장 오른쪽 열의 PID를 작업 관리자의 ‘세부 정보’ 탭에서 확인해 프로세스 이름과 경로를 대조하세요.
netstat -ano | findstr ":10808"
macOS 및 Linux: 포트로 수신 프로세스 조회
lsof -nP -iTCP:10808 -sTCP:LISTEN
ss -ltnp 'sport = :10808'
첫 번째 명령은 lsof가 설치된 시스템에서 사용할 수 있고, 두 번째는 Linux용 대체 조회 명령입니다. lsof의 COMMAND와 PID 열에서 각각 프로세스 이름과 번호를 확인할 수 있습니다. ss에서 프로세스 정보가 표시되는지는 권한에 따라 달라집니다. 일반 권한으로 조회했을 때 프로세스 정보가 나오지 않으면 관리자 권한이 있는 경우 다시 확인하세요. 로그에 UDP라고 명시되어 있다면 해당 프로토콜로 조회해야 합니다. Windows에서는 netstat의 UDP 로컬 주소 열을 확인하고, macOS나 Linux에서는 lsof -nP -iUDP:10808을 사용할 수 있습니다. UDP에는 TCP의 LISTENING 상태가 없습니다.
v2rayN 로컬 수신 포트 변경
기존 설정 기록
v2rayN 기본 창에서 ‘설정’ → ‘매개변수 설정’으로 이동하세요. 인바운드 관련 설정의 기존 포트, 프록시 프로토콜, 현재 시스템 프록시 상태를 기록해 두면 나중에 복원하기 쉽습니다. 빌드에 따라 화면에 혼합 포트 하나가 표시되거나 HTTP와 SOCKS 포트가 각각 표시될 수 있으니 현재 화면과 로그를 기준으로 확인하세요.
사용할 포트 확인
앞서 사용한 명령으로
20808을 조회하세요. 일치하는 항목이 없다는 것은 조회 시점에 해당 포트의 수신 프로세스를 찾지 못했다는 뜻일 뿐, 시스템에서 바인딩할 수 있음을 보장하지는 않습니다. 화면에 인바운드 포트가 여러 개 설정되어 있다면 바뀌는 포트를 하나씩 확인하세요. 특히 저장 후 실제로 생성된 수신 설정을 확인해야 합니다.저장 후 다시 시작
오류와 일치하는 로컬 인바운드 포트를 변경하고 저장한 뒤 코어를 다시 시작하세요. 화면에 별도의 재시작 기능이 없다면 시스템 트레이에서 클라이언트를 종료한 다음 다시 실행하면 됩니다. 이 컴퓨터에서만 사용할 경우 루프백 수신을 유지하세요. 충돌을 해결하려고 로컬 네트워크 접근을 허용하지 마세요. 새 실행 로그에서 같은 바인딩 오류가 사라졌는지 확인하세요.
앱의 프록시 설정 업데이트
시스템 프록시를 v2rayN이 관리한다면 저장 후 다시 적용하고 시스템 설정에서 주소와 포트를 확인하세요. 프록시를 직접 설정한 브라우저, 확장 프로그램, 터미널은 각각 수정해야 합니다. 앱에서 선택한 프로토콜이 새 포트에서 지원하는 프로토콜과 일치하는지도 확인하세요.
새 포트와 브라우저·터미널 설정 확인
새 포트를 다시 조회해 이번에 실행한 코어가 수신 중인지 확인하세요. 그런 다음 프록시를 명시적으로 지정해 요청을 보내면 앱 설정 문제와 프록시 연결 문제를 구분할 수 있습니다. 아래 첫 번째 명령은 HTTP 프록시를 지원하는 포트용이고, 두 번째는 SOCKS5를 지원하는 포트용입니다. 실제 설정과 일치하는 명령만 실행하세요. Windows PowerShell에서는 curl.exe를 지정해 실행 파일을 명확히 호출할 수 있습니다.
curl -I -x http://127.0.0.1:20808 https://example.com/
curl -I -x socks5h://127.0.0.1:20808 https://example.com/
대상 사이트의 HTTP 응답을 받았다면 같은 주소를 브라우저에서도 열어 보세요. 명시적으로 프록시를 지정한 요청은 성공하지만 브라우저에서 실패한다면 브라우저 확장 프로그램이 시스템 프록시를 덮어쓰는지, 자동 설정 스크립트가 이전 포트를 가리키는지 확인하세요. 프록시를 명시한 경우에만 터미널 요청이 성공한다면 해당 세션의 http_proxy, https_proxy, ALL_PROXY를 확인하세요. 환경 변수 지원 여부는 도구마다 다르므로 NO_PROXY 때문에 대상 주소가 프록시를 우회하는지도 확인해야 합니다. 변경 후에는 새 터미널에서 테스트하세요. 이미 열려 있는 터미널에 변경 사항이 반영된다고 가정하지 마세요.
포트를 바꿔도 오류가 계속되는 경우
프로세스를 찾을 수 없는데 왜 바인딩되지 않나요?
최신 로그에서 TCP와 UDP 중 무엇을 확인해야 하는지 먼저 살펴본 뒤 IPv4와 IPv6, 조회 권한을 점검하세요. 충돌이 시작 순간에만 발생한다면 재현 직후 포트를 다시 조회하거나 설정에 주소 범위가 겹치는 인바운드가 두 개 생성되었는지 확인하세요. Windows 로그에 포트 점유가 아닌 액세스 권한 오류가 표시된다면 netsh interface ipv4 show excludedportrange protocol=tcp로 TCP 제외 포트 범위를 확인하고, 해당 범위 밖의 포트를 우선 사용하세요. 시스템 예약 항목을 직접 삭제하지 마세요.
변경했는데 왜 이전 포트가 계속 표시되나요?
로그의 타임스탬프를 대조해 이전 실행의 오류가 아닌지 확인하세요. 다른 압축 해제 폴더의 인스턴스가 실행 중인지도 확인해야 합니다. 사용자 지정 설정을 사용하는 경우 실제로 불러온 설정에 인바운드 포트가 고정되어 있는지 살펴보세요. 매개변수 설정에서 변경한 값이 사용자 지정 인바운드 설정에 반영되지 않을 수 있습니다.
새 포트가 수신 중인데 왜 웹페이지가 열리지 않나요?
수신 중이라는 사실은 로컬 프록시 포트가 시작되었다는 뜻일 뿐입니다. 해당 포트에서 지원하는 프로토콜로 프록시를 명시해 요청을 보내세요. 로컬 연결이 거부되면 수신 주소와 포트를 다시 확인하세요. 프록시 연결은 수락되지만 로그에 아웃바운드 시간 초과가 표시된다면 노드 연결 상태, 도메인 이름 조회, 라우팅 규칙을 점검하세요. 이 경우 로컬 포트를 계속 바꿔도 아웃바운드 문제는 해결되지 않습니다.