v2rayN 初次安裝設定指南:Windows、macOS 通用檢查與常見問題

整理 v2rayN 在 Windows 和 macOS 初次執行時的重點:從解壓縮位置、執行環境與啟動權限,到本機連接埠和核心選擇,避開常見設定問題。

本文重點

第一次在 Windows 或 macOS 使用 v2rayN,可依序確認三件事:主視窗能否開啟、選取的節點能否透過本機代理送出請求,以及瀏覽器能否套用系統代理設定。前一項確認正常後,再檢查下一項;遇到程式閃退、訂閱清單空白或瀏覽器無法連線時,就能判斷問題出在哪一層。

安裝檔、解壓縮位置與首次啟動權限

先區分桌面用戶端和代理核心。雙擊後連主視窗都沒出現,優先檢查安裝檔、執行環境或系統提示;若主視窗能開啟,但選取節點後日誌出現錯誤,再檢查核心檔案、節點參數和連接埠。以下以 v2rayN 7.x 中文介面的常見選單名稱為例,不同小版本的標籤和按鈕位置可能略有差異。

匯入一個訂閱,先確認一個節點

新增訂閱網址只會儲存更新來源,不代表節點已成功載入。首次設定時,先使用一個來源和一個節點,分別確認訂閱更新、核心啟動和系統代理。訂閱網址可能包含帳戶權杖,分享螢幕截圖前請遮住完整網址,也要確認日誌中沒有印出網址。

  1. 新增訂閱群組

    開啟主畫面的「訂閱群組」→「訂閱群組設定」,在視窗中按「新增」。備註填入容易辨識的來源名稱,並在網址欄貼上完整訂閱網址後儲存。若取得的是以 vmess:// 或 vless:// 開頭的單一分享連結,請從「伺服器」選單使用剪貼簿匯入功能,不要將它填入訂閱網址欄。

  2. 更新目前群組

    回到主視窗並選取新群組,在「訂閱群組」選單中選擇更新目前訂閱;第一次可先選擇不透過代理更新。查看日誌確認是否載入成功,再檢查群組中是否出現節點。訂閱更新成功只代表清單能夠取得,不表示其中任何節點已連線。

  3. 選取使用中的節點

    在清單中對已知可用的節點按右鍵,選擇「設為活動伺服器」。按一下列項通常只會選取清單項目,不能據此判定核心已切換。切換後查看主畫面目前使用的節點和日誌,確認沒有核心啟動失敗或連接埠繫結錯誤。

  4. 確認本機連接埠

    開啟「設定」→「參數設定」,查看「v2rayN 設定」中的本機監聽連接埠。先記下實際連接埠,再用下文的明確指定代理請求進行測試。此時不要同時切換節點、變更路由規則或啟用 TUN,否則請求失敗時很難判斷是哪項設定造成的。

依節點參數選擇核心

v2rayN 是桌面用戶端,Xray 和 V2Ray 則是處理連線的核心。開啟「設定」→「參數設定」→「Core 類型」,通常要依設定類型選擇核心,並不是把任何節點都統一轉換成某種協定。匯入訂閱後先保留原有參數;只有日誌明確指出設定不受支援時,才檢查核心選擇和版本。

Xray 核心

建議

匯入 VLESS + REALITY 設定時,優先依伺服器端說明使用 Xray。傳輸方式、安全性選項和 Flow 必須與伺服器端相符;若節點未填 Flow,不要只為了照抄範例而自行補上。遇到無法辨識的選項時,先查看日誌確認啟動的是哪個核心及其版本。

適用情況:訂閱明確提供 VLESS + REALITY,或伺服器端指定使用 Xray。

V2Ray 核心

若目前用戶端提供此選項,且管理者明確提供適用的 V2Ray 版本和 VMess 設定,可依照說明選擇。VMess + WebSocket + TLS 設定中的路徑和伺服器名稱必須保留原值;只更換成 V2Ray 核心,無法修正填錯的路徑或憑證名稱。

適用情況:已有明確的 V2Ray 伺服器端設定說明,且需要依原設定連線。

分開確認本機監聽連接埠與系統代理

節點詳細資料中的伺服器連接埠是遠端連線資訊;瀏覽器或終端機使用的則是本機監聽連接埠,兩者不是同一項設定。以下以 10808 為例:只有在參數設定和日誌都確認該連接埠接受 HTTP 代理請求時,才能直接使用範例;若顯示的是 SOCKS 專用連接埠,請依右側卡片的方式測試。首次除錯時僅在本機使用,不要為了排查問題開啟「允許來自區域網路的連線」。

HTTP 或混合監聽

本機位址
127.0.0.1
範例連接埠
10808,請替換成實際的 HTTP 或混合連接埠
代理位址
http://127.0.0.1:10808

即使目標網址使用 HTTPS,一般本機 HTTP 代理位址仍以 http:// 開頭。

SOCKS 監聽

本機位址
127.0.0.1
範例連接埠
10808,請替換成實際的 SOCKS 或混合連接埠
代理位址
socks5h://127.0.0.1:10808

這是 curl 可辨識的寫法,表示由代理端解析目標主機名稱;不要填入系統設定的 HTTP 代理欄位。

先暫時關閉系統代理、不要啟用 TUN,再使用明確指定代理的方式送出一般網頁請求。Windows PowerShell 請使用 curl.exe;macOS 終端機則將命令開頭改為 curl。連線逾時設為 5 秒、請求總時限設為 15 秒,這是本次診斷的時間上限,不是效能指標。

curl.exe --proxy http://127.0.0.1:10808 --noproxy "" --connect-timeout 5 --max-time 15 -I https://example.org/

初次設定失敗的常見問題

訂閱更新逾時,清單還是空的?

先查看日誌,確認失敗的是訂閱網域的解析、連線還是伺服器回應。確認網址沒有貼錯、群組也選對;若回應為 401 或 403,請向訂閱提供者確認權杖和存取權限。若是連線逾時,而且已有一個確認可用的節點,再嘗試選擇「透過代理」更新。手邊沒有可用節點時,反覆切換這個選項並不會憑空建立連線。

網頁可以開啟,為什麼終端機還是直連?

瀏覽器可能會讀取系統代理設定,但終端機程式不一定會套用相同設定。先使用上方的 --proxy 為單次請求指定代理。若單次請求能正常連線,再確認使用的工具是否支援 HTTPS_PROXY,以及 NO_PROXY 是否將目標排除;一開始不要就把變數寫入全域啟動設定。

重新啟動後,訂閱和設定怎麼都不見了?

確認捷徑指向的程式路徑,看看是否誤開了另一份解壓縮資料夾。先結束用戶端,將目前版本保留在固定且可寫入的位置,再重新開啟、修改一項容易辨認的設定並重新啟動確認。若日誌提示寫入失敗,請修正資料夾權限,或改用目前帳戶可寫入的位置。

退出後整台電腦都無法開啟網頁,需要重新安裝嗎?

先檢查系統代理是否仍指向 127.0.0.1 上已關閉的監聽連接埠。若能啟動用戶端,請使用「清除系統代理」後再退出;若無法啟動,請到系統的代理設定中移除這次測試寫入的值。若原本有公司網路代理設定,請依照先前記錄還原,不要順手清除其他代理項目。

下載 v2rayN