· 疑難排解 · 約 8 分鐘

v2rayN 本機連接埠遭占用:查出衝突程序並變更監聽連接埠

遇到連接埠遭占用或核心無法啟動,先用 netstat 或 lsof 找出占用程序,再到參數設定變更本機監聽連接埠,並同步更新瀏覽器與終端機的代理位址。

本文重點

適用於啟動 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,別只憑連接埠號就結束程序。

10808
本文用於示範查詢的連接埠
20808
確認未被占用後可嘗試的新連接埠

這兩個數字僅供示範,不代表目前安裝版本的預設值或連接埠空閒狀態。若記錄顯示 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 本機監聽連接埠

  1. 記下原有設定

    開啟 v2rayN 主視窗,前往「設定」→「參數設定」。記下入站相關設定中的原連接埠、代理協定與目前的系統代理狀態,以便還原。不同版本的介面可能顯示一個混合連接埠,也可能分別列出 HTTP 和 SOCKS 入口;請以目前介面與記錄為準。

  2. 查詢候選連接埠

    使用前述命令查詢 20808。沒有符合項目,只表示查詢當下未發現對應的監聽程序,不能保證系統允許繫結。若介面設定了多個入口,請逐一確認將變更的連接埠,尤其要檢查儲存後實際產生的監聽設定。

  3. 儲存並重新啟動

    變更與錯誤相符的本機入站連接埠,儲存後重新啟動核心;若介面沒有獨立的重新啟動選項,請從系統匣結束用戶端後再開啟。僅供本機使用時,請保留迴送位址監聽,勿為了解決衝突而開放區域網路存取。查看新一輪記錄,確認相同的繫結錯誤不再出現。

  4. 更新應用程式的代理設定

    若系統代理由 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 排除範圍,優先選用範圍外的連接埠,勿直接刪除系統保留項目。

為什麼修改後仍顯示舊連接埠?

比對記錄的時間戳記,確認不是前一次啟動留下的錯誤。接著檢查目前是否還有從其他解壓縮資料夾啟動的執行個體。若使用自訂設定,請檢查實際載入的設定是否固定了入站連接埠;參數設定中的變更不一定會覆蓋自訂入站設定。

新連接埠已在監聽,為什麼網頁還是無法開啟?

有監聽只代表本機入口已啟動。請先使用與該入口相符的協定明確送出請求。若本機連線立即遭拒,請重新檢查監聽位址與連接埠;若代理已接受連線,但記錄顯示對外連線逾時,請檢查節點是否可連線、網域名稱解析,以及路由分流。此時繼續更換本機連接埠,通常無法解決對外連線問題。

用戶端下載與安裝