2026-06-05 · 故障排查 · 約 10 分鐘

v2rayN 連接埠遭佔用導致啟動失敗：找出衝突程序並修改本機監聽連接埠

啟動時顯示連接埠遭佔用，通常是本機 10808/10809 與其他程式衝突。本文示範如何用系統指令找出佔用程序，並在 v2rayN 中安全修改本機監聽連接埠。

本文速覽

本文適合遇到 v2rayN 核心啟動失敗，或日誌顯示 bind、address already in use 的 Windows 使用者。排查順序是先確認衝突連接埠，再透過 PID 找到佔用程式，接著選擇關閉舊程序或修改 v2rayN 監聽連接埠，最後同步系統代理、瀏覽器等外部應用程式的連接埠設定。

先釐清 10808、10809 與核心監聽失敗

v2rayN 啟動 V2Ray 或 Xray 核心後，會在本機建立入站監聽連接埠。常見設定會將 10808 用作 SOCKS 入口，將相鄰的 10809 用作 HTTP 入口。部分較新的設定可能使用混合監聽方式，介面中只顯示一個主要本機連接埠。因此，實際連接埠應以「設定」→「參數設定」中的本機監聽設定與目前核心日誌為準，不能只依預設值判斷。

監聽連接埠就像本機應用程式進入代理核心的入口。瀏覽器、命令列工具或系統代理會先連線至 127.0.0.1 上的這個連接埠，核心再依節點與路由規則建立出站連線。如果相同位址、相同協定與相同連接埠已由另一個程序監聽，新啟動的核心就無法再次繫結。

程式啟動讀取設定繫結本機連接埠接收代理要求依規則出站
檢查項目 常見值 發生衝突時的表現
SOCKS 監聽 127.0.0.1:10808 核心無法建立 SOCKS 入站，使用該連接埠的應用程式連線失敗
HTTP 監聽 127.0.0.1:10809 系統代理或手動設定的 HTTP 代理無法連線
修改後的監聽 127.0.0.1:20808、20809 核心可以啟動，但外部應用程式仍需同步修改連接埠

從日誌確認是連接埠遭佔用還是權限限制

不要只根據工作列圖示顏色判斷。先開啟 v2rayN 的日誌視窗，重新執行一次啟動核心或重新啟動服務，記下錯誤中的 IP、連接埠與協定。重點尋找 bind、listen、address already in use、Only one usage 等文字。日誌明確指出 127.0.0.1:10808 時，後續指令只需查詢這個連接埠，無須掃描所有連線。

同樣是啟動失敗，錯誤原因可能完全不同。設定檔語法錯誤通常會出現 failed to load config、invalid field 等訊息；遠端節點無法連線通常發生在本機監聽成功之後；只有繫結本機位址失敗時，才應優先進行連接埠佔用排查。

錯誤：listen tcp 127.0.0.1:10808: bind: Only one usage of each socket address is normally permitted

原因與解法：10808 已由其他程序監聽。使用 netstat 或 PowerShell 找出 PID，關閉重複的核心，或將 v2rayN 改用未佔用的連接埠。

錯誤：failed to listen on address 127.0.0.1:10809

原因與解法：HTTP 入站繫結失敗。檢查 10809 的監聽程序，並確認舊版 v2rayN 或殘留核心是否仍在背景執行。

錯誤：bind: An attempt was made to access a socket in a way forbidden by its access permissions

原因與解法：連接埠可能落在 Windows 排除連接埠範圍內，也可能受到安全性原則限制。先查詢排除範圍；若連接埠位於其中，直接改用 20808、20809 等一般高位連接埠。

netsh interface ipv4 show excludedportrange protocol=tcp
netsh interface ipv6 show excludedportrange protocol=tcp

排除連接埠範圍與一般程序佔用不同。一般佔用通常能看到 LISTENING 與 PID；排除範圍可能沒有對應的使用者程序，但系統仍會拒絕繫結。如果 10808 或新選的連接埠落在輸出區間內，不必嘗試強制結束系統服務，改用不在區間內的連接埠更穩妥。

使用 netstat 與 PowerShell 找出衝突程序

在 Windows 終端機或命令提示字元中先執行 netstat。參數 -a 顯示連線與監聽連接埠，-n 直接顯示數字位址，-o 顯示程序 PID。分別查詢 10808 與 10809，可以避免將遠端連線中偶然出現的相同數字誤認為本機監聽。

netstat -ano -p tcp | findstr ":10808"
netstat -ano -p tcp | findstr ":10809"

結果中應重點查看「本機位址」與「狀態」兩欄。例如本機位址為 127.0.0.1:10808、狀態為 LISTENING、最後一欄為 4321，表示 PID 4321 正在監聽該連接埠。如果本機位址是其他連接埠，而外部位址包含 10808，則它不是要找的本機監聽程序。

  1. 記下 LISTENING 列最後一欄的 PID，例如 4321。
  2. 執行 tasklist /FI "PID eq 4321"，查看程序名稱。
  3. 如果名稱是 xray.exe 或 v2ray.exe，先檢查是否已有另一個 v2rayN 執行個體正在執行。
  4. 如果是其他軟體，開啟工作管理員的「詳細資料」頁面，核對 PID 與檔案路徑。
  5. 確認程序用途後，再決定結束程式、停止服務或修改連接埠。
tasklist /FI "PID eq 4321"

Get-NetTCPConnection -State Listen |
  Where-Object { $_.LocalPort -in 10808,10809 } |
  Select-Object LocalAddress,LocalPort,OwningProcess

Get-CimInstance Win32_Process -Filter "ProcessId=4321" |
  Select-Object ProcessId,Name,ExecutablePath,CommandLine

PowerShell 的 OwningProcess 就是 PID。ExecutablePath 與 CommandLine 可協助區分目前由 v2rayN 啟動的核心、舊目錄中的核心，以及其他本機代理程式。部分程序路徑需要使用系統管理員權限才能讀取，但不要只憑可執行檔名稱就結束程序。

結論：PID 與路徑必須一併核對

看到 xray.exe 或 v2ray.exe 不代表可以直接結束。先核對命令列參數與所在目錄，確認它是否屬於介面已關閉的舊執行個體，以免中斷仍在運作的其他設定。

關閉殘留程序或修改 v2rayN 本機連接埠

如果佔用者是重複開啟的 v2rayN，優先回到其主視窗正常離開。視窗已消失但核心仍在執行時，可在工作管理員中依 PID 結束對應程序。只有在路徑、PID 與用途都確認無誤後，才使用指令強制停止。系統服務、虛擬化服務與安全性軟體不應為了釋放一般代理連接埠而任意終止。

Stop-Process -Id 4321

taskkill /PID 4321 /F

如果佔用連接埠的程式必須保留，修改 v2rayN 會更合適。在常見的中文介面中進入「設定」→「參數設定」，找到「基礎設定」區域中的本機監聽連接埠。不同大版本可能顯示為「本機監聽連接埠」、「本機 SOCKS 連接埠」或類似名稱。將 10808 改為 20808 後儲存設定，再執行「重新啟動服務」，或完全離開並重新啟動 v2rayN。

  1. 先截圖或記下原本的連接埠 10808，以便需要時還原。
  2. 在「設定」→「參數設定」中，將主要本機連接埠改為 20808。
  3. 如果介面另有提供 HTTP 連接埠，將 10809 改為 20809。
  4. 儲存參數，重新啟動目前核心，觀察日誌是否出現成功監聽的訊息。
  5. 再次執行 netstat，確認新 PID 正在監聽 127.0.0.1:20808。
方案 適用情況 後續動作
離開舊執行個體 同一個用戶端啟動了兩次 保留一個執行個體並重新啟動核心
結束殘留核心 介面離開後核心程序仍在監聽連接埠 核對 PID 與路徑後結束程序
改用 20808、20809 佔用連接埠的軟體必須繼續執行 同步修改系統代理與外部應用程式
避開排除範圍 沒有監聽 PID，但系統拒絕繫結 從排除區間之外選擇高位連接埠

修改連接埠後同步系統代理與外部應用程式

核心能夠啟動只代表監聽階段已恢復，不表示所有應用程式都已使用新連接埠。如果 Windows 系統代理仍指向 127.0.0.1:10809，而 v2rayN 已改為 20809，瀏覽器會繼續要求舊連接埠，結果就是核心正常但網頁無法開啟。因此需要重新設定系統代理，或讓 v2rayN 再次執行自動設定系統代理。

在 v2rayN 主介面的系統代理選單中重新選擇「自動設定系統代理」後，開啟 Windows 的「設定」→「網路和 Internet」→「代理」核對位址與連接埠。曾手動設定代理的瀏覽器、下載工具、終端機程式與開發工具不會自動跟隨系統設定，需要逐一將 10808 或 10809 改成新值。

Get-NetTCPConnection -State Listen |
  Where-Object { $_.LocalPort -in 20808,20809 } |
  Select-Object LocalAddress,LocalPort,OwningProcess

Test-NetConnection 127.0.0.1 -Port 20808

Test-NetConnection 回傳 TcpTestSucceeded 為 True，表示本機可以建立至該 TCP 監聽連接埠的連線，但這不會驗證節點本身是否可用。完整驗證還應查看核心日誌是否完成出站連線，並檢查路由規則是否將測試流量送往預期出口。

結論：新連接埠必須形成完整設定鏈

監聽連接埠、系統代理連接埠與應用程式內的代理連接埠必須一致。只修改 v2rayN 的一個輸入欄位，通常會把「啟動失敗」變成「核心已啟動但應用程式無法連線」。

常見問題與處理界線

在工作管理員中找不到 netstat 顯示的 PID？

先重新執行一次 netstat。短時間執行的程序可能已經結束並換成新的 PID；也可以使用系統管理員 PowerShell 執行 Get-NetTCPConnection，再依 OwningProcess 查詢程序。

改成 20808 後仍顯示連接埠遭佔用？

使用 netstat 單獨查詢 20808，並檢查 Windows TCP 排除連接埠範圍。如果新連接埠也有 LISTENING 記錄，繼續改用未佔用且不在排除區間內的連接埠，例如 21808。

只有 10809 發生衝突，10808 沒有衝突，該怎麼辦？

先在參數設定中確認 SOCKS 與 HTTP 是否分開設定。如果介面允許獨立設定，只需修改 HTTP 連接埠；如果連接埠依相鄰規則產生，請調整主要本機連接埠並同步所有應用程式。

結束核心後，連接埠為什麼還沒有立即釋放？

等待數秒後重新查詢 LISTENING 狀態。TIME_WAIT 連線通常不等於監聽佔用；如果仍有 LISTENING 列，表示仍有程序持有連接埠，請依最新 PID 繼續定位。

每次開機都會再次發生衝突？

檢查 v2rayN 與佔用程式是否都設定為開機啟動，並確認是否存在兩個 v2rayN 目錄或重複的捷徑。固定保留一組啟動項目，或為兩個程式分配不同的監聽連接埠。

排查結束後，建議保留一份簡短記錄，包括最終連接埠、佔用程序名稱、PID 對應路徑，以及曾修改的應用程式。日後更新 v2rayN 或重新匯入設定時，如果監聽連接埠恢復預設值，就能快速對照記錄，不必重新掃描所有程序。