適用於啟動 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 的順序推算新埠號,請以實際載入的設定和監聽結果為準。
記下原有設定
記下錯誤訊息中的埠號、目前節點和系統代理狀態。如果原本由 v2rayN 管理系統代理,可先選擇「系統代理」→「清除系統代理」,停止將流量轉送至舊位址,避免更換期間仍連線至失效的監聽埠。
檢查候選埠號
將前述查詢指令中的埠號改為
10818。若啟用了額外入站,也要查詢它們使用的埠號;實際啟用 UDP 時,則需一併查詢對應的 UDP 端點。查詢時未發現占用,只能代表當下的狀態。變更本機埠號
開啟「設定」→「參數設定」,在基本設定中找到本機監聽埠欄位;若欄位顯示「本機混合監聽埠」,變更的就是混合入站埠。輸入
10818並儲存。若只供本機使用,請維持關閉區域網路連線,不必為了更換埠號而擴大監聽範圍。重新啟動並確認監聽
結束系統匣中的 v2rayN,再重新開啟並啟動原本的節點。查看最新記錄,使用相同指令確認新埠已開始監聽,且程序歸屬正確。若這次錯誤指向另一個埠號,請繼續檢查該入站,不要反覆修改已成功綁定的埠號。
同步更新代理入口
原本使用系統代理的使用者,可在 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/
- 本機連線遭拒:先確認新埠仍在監聽,再核對監聽位址。若核心只綁定在
::1,使用127.0.0.1測試就無法連上該監聽。 - 可連上本機但交握失敗:確認測試使用的協定與實際入站類型相符。將 HTTP 要求傳送到只提供 SOCKS 的埠,即使該埠確實已開啟,也無法正常轉送。
- 收到目標網站的 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 固定使用不衝突的埠號。