v2rayN에서 코어를 시작할 때 바인딩에 실패하는 Windows 및 macOS 사용자를 위한 안내입니다. 로그에서 수신 주소, 프로토콜, 포트를 확인한 다음 프로세스 ID를 조회하세요. 중복 실행된 인스턴스는 정상적으로 종료하고, 유지해야 할 프로세스는 그대로 둔 채 v2rayN의 포트를 변경하면 됩니다. 마지막으로 새 포트를 이번에 시작한 코어가 실제로 수신하는지 확인하고, 이전 포트를 가리키는 앱 설정도 업데이트하세요.
시작 로그에서 충돌한 포트 확인
먼저 v2rayN 메인 창에서 가장 최근 시작 로그를 확인하세요. 로그에 listen tcp 127.0.0.1:10808이라고 표시된다면 로컬 TCP 인바운드가 시작되지 않은 것입니다. 이 포트는 앱이 로컬 프록시에 연결할 때 사용하며, 노드 주소의 원격 포트와는 다릅니다. 노드 포트를 바꾸거나 구독을 업데이트하고 라우팅 규칙을 변경해도 로컬 수신 포트가 비워지지는 않습니다.
오류: bind: address already in use
원인 및 해결 방법: 바인딩하려는 로컬 주소와 포트가 기존 소켓과 충돌합니다. 오류 메시지에 표시된 포트로 수신 프로세스를 조회하고, 종료해야 할 이전 인스턴스인지 유지해야 할 프로그램인지 확인하세요.
오류: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.
원인 및 해결 방법: Windows에서 이미 사용 중인 소켓 주소에 다시 바인딩하려 해 거부된 것입니다. 로그에 표시된 프로토콜과 포트를 확인하세요. 기본 SOCKS 포트만 조회하지 말고, 같은 설정에 포함된 다른 인바운드에서 실패했을 가능성도 살펴보세요.
로그의 127.0.0.1과 ::1은 각각 IPv4와 IPv6 루프백 주소입니다. 조회할 때는 우선 주소를 지정하지 마세요. 0.0.0.0에 바인딩된 수신 소켓도 IPv4 루프백을 포함하며, ::가 표시되면 해당 소켓이 듀얼 스택을 사용하는지도 확인해야 합니다. 포트 번호가 같다고 반드시 충돌하는 것은 아니므로 TCP와 UDP를 따로 조회하세요.
Windows 및 macOS에서 포트를 점유한 프로세스 조회
아래 예시에서는 TCP 포트 10808을 사용합니다. 실제 명령을 실행할 때는 로그에 나온 포트로 바꾸세요. 로컬 수신 소켓만 확인해야 합니다. 출력에 연결된 원격 포트가 우연히 10808로 표시되더라도 해당 프로세스가 로컬 포트를 점유한 것은 아닙니다.
Windows: PowerShell로 수신 포트 확인
Get-NetTCPConnection -LocalPort 10808 -State Listen -ErrorAction SilentlyContinue |
Select-Object LocalAddress, LocalPort, OwningProcess
Get-Process -Id 7420 | Select-Object Id, ProcessName, Path
두 번째 명령의 예시 번호 7420을 첫 번째 명령에서 반환된 OwningProcess 값으로 바꾸세요. 시작 로그에 listen udp라고 표시되면 Get-NetUDPEndpoint -LocalPort 10808로 해당 엔드포인트를 확인한 뒤 OwningProcess 값으로 프로세스를 조회하세요. 프로세스 경로가 보이지 않으면 권한이 있는 세션에서 다시 확인할 수 있습니다.
macOS: lsof로 수신 포트 확인
lsof -nP -iTCP:10808 -sTCP:LISTEN
ps -p 7420 -o pid=,command=
lsof 출력의 PID 열에서 실제 프로세스 번호를 확인한 뒤 ps로 실행 명령을 살펴보세요. UDP는 lsof -nP -iUDP:10808을 사용하고 TCP 수신 상태 필터는 적용하지 않습니다. 일반 사용자 권한으로 다른 계정의 프로세스를 볼 수 없다면 관리자 권한으로 sudo lsof를 실행해 다시 확인하세요.
| 조회 결과 | 다음 단계 |
|---|---|
| 다른 폴더에서 실행한 이전 코어가 포트를 수신 중 | 이전 클라이언트의 종료 기능을 사용해 중지한 뒤 해당 포트가 비워졌는지 다시 확인하세요. 창만 닫으면 트레이에서 프로세스가 계속 실행될 수 있습니다. |
| 현재 사용 중인 앱 또는 서비스가 포트를 수신 중 | 해당 프로세스는 유지하고 v2rayN의 로컬 포트를 변경하세요. 프로세스 이름만 보고 서비스를 강제로 종료하지 마세요. |
| 시작 실패 후 수신 프로세스가 조회되지 않음 | 같은 시작 시도의 전체 로그를 확인해 사용자 지정 설정에서 두 인바운드가 같은 포트를 요청했는지 살펴보세요. 코어가 종료되면 이미 바인딩했던 수신 소켓도 사라집니다. |
판단 기준: 프로세스 이름보다 경로가 중요합니다
코어 프로세스 두 개의 이름이 같을 수 있습니다. 익숙한 코어 이름이 조회되더라도 경로나 실행 명령을 먼저 확인해 어떤 설정에 속한 프로세스인지 파악한 다음, 이전 인스턴스를 종료할지 포트를 옮길지 결정하세요.
v2rayN 설정에서 포트 변경
아래 예시는 v2rayN 7.x의 일반 노드를 기준으로 합니다. 10818은 후보 포트일 뿐, 미리 확보된 포트가 아닙니다. 설정에 따라 SOCKS와 HTTP를 하나의 혼합 인바운드로 처리하거나 각각 별도의 인바운드를 사용할 수 있습니다. 10808, 10809 다음 번호를 새 포트로 정하지 마세요. 실제로 로드된 설정과 수신 결과를 기준으로 판단해야 합니다.
기존 설정 기록
오류가 발생한 포트, 현재 노드, 시스템 프록시 상태를 기록해 두세요. 기존에 v2rayN이 시스템 프록시를 관리했다면 먼저 ‘시스템 프록시’ → ‘시스템 프록시 해제’를 선택해 이전 주소로 전달되지 않도록 할 수 있습니다.
사용할 포트 확인
앞서 사용한 조회 명령에서 포트를
10818로 바꾸세요. 추가 인바운드를 사용한다면 해당 포트도 조회하고, UDP를 실제로 사용하는 경우에는 UDP 엔드포인트도 확인해야 합니다. 조회 결과 점유가 없다는 것은 확인한 시점에 사용 중인 프로세스가 없다는 뜻입니다.로컬 포트 변경
‘설정’ → ‘매개변수 설정’을 열고 기본 설정에서 로컬 수신 포트를 찾으세요. ‘로컬 혼합 수신 포트’로 표시된다면 혼합 인바운드의 포트를 변경하면 됩니다.
10818을 입력하고 저장하세요. 로컬에서만 사용할 경우 LAN 연결은 끈 상태로 유지하세요. 포트를 바꾸면서 수신 범위를 넓힐 필요는 없습니다.다시 시작하고 수신 포트 확인
트레이에서 v2rayN을 종료한 다음 다시 열어 기존 노드를 시작하세요. 최신 로그를 확인하고 같은 조회 명령으로 새 포트가 수신 중이며 올바른 프로세스에 속하는지 확인합니다. 이번에는 다른 포트에서 오류가 발생했다면 해당 인바운드를 확인하세요. 이미 바인딩에 성공한 포트는 반복해서 변경하지 마세요.
프록시 연결 정보 업데이트
시스템 프록시를 사용하던 경우 v2rayN의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 구성’을 다시 선택하세요. 브라우저 확장 프로그램, 터미널 환경 변수 또는 개발 도구를 직접 설정했다면 각 설정에서 이전 포트를 새 포트로 바꾸고, 수신 인바운드에 맞는 프록시 프로토콜을 유지해야 합니다.
사용자 지정 설정으로 실행 중인데 매개변수를 바꾼 뒤에도 코어가 이전 포트에 바인딩하려 한다면 실제로 로드된 설정을 확인하세요. Xray/V2Ray 형식의 JSON에서는 해당 인바운드의 listen과 port를 inbounds 항목에서 확인할 수 있습니다. 사용자 지정 파일을 먼저 백업한 뒤 해당 파일에서 정의한 인바운드를 수정하세요. 클라이언트가 임시로 생성하는 설정 파일을 지속적인 수정 경로로 사용하지 마세요.
HTTP·SOCKS 및 앱 설정을 각각 확인
시스템 명령으로 포트 수신을 확인해도 로컬 소켓이 열렸다는 것만 알 수 있습니다. 브라우저 확장 프로그램이나 시스템 프록시 설정의 영향을 피하려면 프록시 주소를 명시해 테스트하세요. 아래에서는 10818이 혼합 인바운드라고 가정합니다. HTTP와 SOCKS가 각각 별도 포트에서 수신 중이라면 해당 포트를 각각 입력하세요. Windows PowerShell에서는 같은 인수를 curl.exe로 실행합니다.
curl --noproxy "" --max-time 15 -I --proxy http://127.0.0.1:10818 https://v2rayapi.com/
curl --noproxy "" --max-time 15 -I --proxy socks5h://127.0.0.1:10818 https://v2rayapi.com/
- 로컬 연결이 거부됨: 새 포트가 여전히 수신 중인지 확인한 다음 수신 주소를 확인하세요. 코어가
::1에만 바인딩되어 있다면127.0.0.1로는 해당 수신 소켓에 연결할 수 없습니다. - 로컬 연결은 되지만 핸드셰이크에 실패함: 테스트에 사용한 프로토콜과 실제 인바운드 유형이 일치하는지 확인하세요. SOCKS만 제공하는 포트에 HTTP 요청을 보내면 포트가 열려 있어도 정상적으로 전달되지 않습니다.
- 대상 사이트의 HTTP 응답을 받음: 이번 요청이 지정한 로컬 연결 지점을 통해 응답을 받았다는 뜻입니다. HTTP 프록시의
200 Connection established는 터널이 만들어졌다는 안내일 뿐이므로, 뒤이어 나오는 대상 사이트의 응답도 확인해야 합니다. 코어가 직접 연결했는지 프록시 아웃바운드를 사용했는지는 라우팅 설정과 로그를 확인하세요.
명시적으로 지정한 테스트는 성공하지만 브라우저나 터미널에서 여전히 실패한다면 해당 앱에 저장된 이전 주소를 우선 확인하세요. 브라우저 확장 프로그램이 시스템 프록시 설정을 덮어쓰는지 살펴보고, 현재 터미널의 HTTP_PROXY, HTTPS_PROXY, ALL_PROXY 값도 확인하세요. 환경 변수를 터미널 시작 설정에서 지정했다면 변경 후 새 세션을 열어 테스트해야 합니다. 이미 열린 세션에는 새 값이 자동으로 적용되지 않습니다.
포트 변경 후 자주 묻는 질문
기존 10808 포트를 비워야 하나요?
그럴 필요 없습니다. 다른 프로그램이 정상적으로 사용 중이라면 그대로 두세요. v2rayN이 새 포트에서 수신 중이고 연결하는 쪽도 새 주소를 사용하도록 변경했다면 두 서비스는 각자의 포트를 사용할 수 있습니다.
포트를 바꿨는데도 왜 이전 10809 오류가 나나요?
로그가 설정 저장 후 새로 생성된 것인지 먼저 확인한 다음 별도의 HTTP 인바운드, 추가 인바운드 또는 사용자 지정 설정이 있는지 살펴보세요. 10809를 다시 조회해 어떤 프로세스가 점유 중인지 확인하세요. 설정 항목 하나를 변경하면 모든 인바운드가 함께 바뀐다고 가정하지 마세요.
Windows에서 점유 프로세스가 조회되지 않는데 권한 오류가 발생하나요?
오류에 forbidden by its access permissions가 포함되어 있다면 기존 프로세스가 포트를 수신 중인 경우와는 다릅니다. netsh interface ipv4 show excludedportrange protocol=tcp를 실행해 후보 포트가 IPv4 TCP 제외 범위에 포함되는지 확인하세요. 포함되어 있다면 시스템 예약 항목을 삭제하지 말고 제외 범위 밖에 있으며 수신 중이 아닌 포트를 선택하세요.
부팅 직후에는 충돌하고 수동 재시작 후에는 정상인가요?
문제가 발생한 직후 프로세스 소유 정보를 조회하고, 재시작한 뒤 한 번 더 확인하세요. 경로를 확인했을 때 v2rayN이 두 개 실행되고 있다면 필요한 인스턴스만 남기고 클라이언트 자동 시작 설정과 시스템 시작 항목이 중복되어 있는지 확인하세요. 다른 상시 실행 서비스가 포트를 사용한다면 v2rayN에 충돌하지 않는 포트를 지정하세요.