· 故障排除 · 約 8 分鐘

V2Ray 本機監聽埠遭占用:找出衝突程序並更換埠號

啟動時出現埠號遭占用的錯誤,可使用系統內建指令找出占用 SOCKS/HTTP 埠的程序,再到 v2rayN 參數設定變更本機監聽埠,並同步更新代理設定。

本文重點

適用於啟動 v2rayN 核心時遇到綁定失敗的 Windows 和 macOS 使用者。先從記錄中抄下監聽位址、協定和埠號,再查詢程序編號。若是重複啟動的執行個體,可正常關閉;需要保留的程序則不要動,改為替 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 的順序推算新埠號,請以實際載入的設定和監聽結果為準。

  1. 記下原有設定

    記下錯誤訊息中的埠號、目前節點和系統代理狀態。如果原本由 v2rayN 管理系統代理,可先選擇「系統代理」→「清除系統代理」,停止將流量轉送至舊位址,避免更換期間仍連線至失效的監聽埠。

  2. 檢查候選埠號

    將前述查詢指令中的埠號改為 10818。若啟用了額外入站,也要查詢它們使用的埠號;實際啟用 UDP 時,則需一併查詢對應的 UDP 端點。查詢時未發現占用,只能代表當下的狀態。

  3. 變更本機埠號

    開啟「設定」→「參數設定」,在基本設定中找到本機監聽埠欄位;若欄位顯示「本機混合監聽埠」,變更的就是混合入站埠。輸入 10818 並儲存。若只供本機使用,請維持關閉區域網路連線,不必為了更換埠號而擴大監聽範圍。

  4. 重新啟動並確認監聽

    結束系統匣中的 v2rayN,再重新開啟並啟動原本的節點。查看最新記錄,使用相同指令確認新埠已開始監聽,且程序歸屬正確。若這次錯誤指向另一個埠號,請繼續檢查該入站,不要反覆修改已成功綁定的埠號。

  5. 同步更新代理入口

    原本使用系統代理的使用者,可在 v2rayN 的「系統代理」選單中重新選擇「自動設定系統代理」。若曾手動設定瀏覽器擴充功能、終端機環境變數或開發工具,請分別更新各處的舊埠號,並保留與監聽入口相符的代理協定。

若目前使用自訂設定,變更參數後核心仍嘗試綁定舊埠號,請檢查實際載入的設定。Xray/V2Ray 格式的 JSON 可查看 inbounds 中對應入站的 listen 和 port。修改自訂檔案前請先備份,並變更由該檔案定義的入站;不要將用戶端暫時產生的設定檔當作長期修改的依據。

分別測試 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/

明確指定代理測試成功,但瀏覽器或終端機仍無法使用時,請優先檢查該應用程式儲存的舊位址。確認瀏覽器擴充功能是否覆蓋系統代理;檢查目前終端機中的 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 固定使用不衝突的埠號。

用戶端下載