本文適合第一次在 Windows 或 macOS 設定 v2rayN 的讀者。先確認用戶端與核心都能正常啟動,再匯入訂閱、選取節點並確認監聽連接埠,最後開啟系統代理,使用同一個應用程式測試設定是否生效。遇到問題時,先找出故障發生的步驟,再調整相應設定。
安裝檔、解壓縮位置與執行環境
請依作業系統與處理器架構選擇安裝檔。x64 適用於 64 位元 Intel 或 AMD 處理器;ARM64 適用於 Windows ARM 裝置或搭載 Apple 晶片的 Mac。系統是 64 位元,不代表處理器架構就是 x64。以下以 v2rayN 7.x 常見介面為例;不同小版本或建置版本的選單文字與位置可能略有差異。
- Windows:開啟「設定」→「系統」→「關於」,查看「系統類型」。請完整解壓縮檔案,例如解壓到有寫入權限的
D:\Tools\v2rayN,再執行v2rayN.exe。不要在壓縮檔預覽視窗中直接雙擊,也不要只把主程式拖到桌面:設定檔和隨附核心可能需要從原始資料夾讀取。 - macOS:開啟 Apple 選單 →「關於這台 Mac」,查看「晶片」或「處理器」。Apple 晶片請選 ARM64,Intel 處理器請選 x64。若取得的是磁碟映像檔,開啟後依照檔案內的說明將應用程式拖到「應用程式」資料夾;若取得的是壓縮檔,請先完整解壓縮,再移動應用程式。若出現系統安全性提示,請先確認下載來源與提示內容,不要為了啟動應用程式而全面關閉系統保護。
- 執行環境:如果 Windows 顯示缺少 .NET,請先確認提示中的框架名稱、主版本與架構。例如提示明確要求 x64 的
Microsoft.WindowsDesktop.App 8.0,就安裝 8.0 系列的 x64 .NET Desktop Runtime,而不是只安裝一般執行階段。若選用自包含建置版本,通常不必另外安裝對應的 .NET 執行階段;能開啟主視窗,也不代表代理核心已經啟動。
核心類型:依節點需求選擇
v2rayN 是桌面用戶端,代理核心則負責讀取節點設定並建立連線。請依節點實際使用的協定、傳輸方式與安全性設定判斷,而不是看訂閱群組名稱。例如 VLESS 是協定,REALITY 是安全性設定的一部分,不能在核心下拉選單中把這兩個名稱當成核心來找。
初次安裝的兩種選擇
Xray 核心
建議如果伺服器明確指定 VLESS、REALITY 與 Vision 流量控制,請優先依伺服器要求使用 Xray。匯入後保留原有欄位,不要自行把一般 TLS 節點改成 REALITY 節點。
適用情況:節點明確要求使用 Xray,或訂閱包含依賴 Xray 功能的設定。
V2Ray 核心
如果服務提供者註明使用 V2Fly 的 V2Ray 核心,請依其文件確認協定與傳輸方式。VMess 搭配 WebSocket 和 TLS 不代表一定要更換核心;只有在用戶端提供該選項、核心已就緒且設定受到支援時,才考慮切換。
適用情況:服務提供者提供明確的 V2Ray 核心設定說明,且節點需要依照說明設定。
首次匯入訂閱並啟用系統代理
訂閱網址用來取得節點清單,不等於單一節點連結。請先準備服務提供者給的訂閱網址與群組名稱。首次測試只選一個節點,不要同時調整 DNS、路由與 TUN;這樣日誌出現錯誤時,較容易找出原因。
從空白清單到連線測試
新增訂閱群組
在主視窗開啟「訂閱群組」→「訂閱群組設定」,新增群組、填寫備註與訂閱網址後儲存。部分版本可從群組列上的「+」新增。貼上網址時請確認內容完整,尤其不要刪掉問號後的參數;這些參數可能包含存取憑證,請勿放進公開截圖。
更新目前的訂閱
選取新建的群組,在「訂閱群組」選單中尋找「更新目前的訂閱」相關選項。若目前沒有可用代理,先選擇「不透過代理」更新;更新後回到該群組,確認清單中確實出現節點。更新成功只代表用戶端已取得並解析清單,不代表清單中的節點已可連線。
設為使用中的節點
在清單中對節點按右鍵,選擇「設為活動伺服器」,並確認主視窗顯示的使用中節點與剛才所選相同。若要確認預設核心,請前往「設定」→「參數設定」→「Core 類型設定」,查看對應協定;如果版本允許為單一節點指定核心,也請一併確認該節點設定。
確認本機監聽狀態
查看主視窗狀態列與日誌,再前往「設定」→「參數設定」查看本機監聽設定。若目前顯示的混合連接埠是
10808,後續就檢查此連接埠;若顯示其他數值,請以實際設定為準。日誌若顯示連接埠遭占用或核心啟動失敗,請先排除監聽問題,不要急著開啟系統代理。啟用代理並測試
在系統匣選單或主視窗的「系統代理」入口選擇「自動設定系統代理」。使用遵循系統代理設定的瀏覽器開啟測試頁面,同時查看用戶端日誌是否出現相應請求。若切換前後網頁都能開啟,請進一步確認路由結果:日誌中出現請求,不代表請求一定是透過目前節點轉送。
確認本機連接埠與系統代理
本機監聽位址是應用程式將請求交給 v2rayN 的入口;訂閱中的伺服器位址與連接埠則供核心連線至遠端使用。兩者不可互相填入。初次使用請維持僅限本機監聽,不要開啟「允許來自區域網路的連線」。
兩處設定的確認項目
用戶端監聽
- 本機位址
127.0.0.1- 混合連接埠範例
10808,以介面顯示為準- 區域網路存取
- 關閉
- 異常線索
address already in use表示監聽位址與連接埠已被占用
混合連接埠可接收 HTTP 與 SOCKS 請求;若介面分別列出兩種連接埠,請依應用程式選用的代理類型填入相應數值。
系統代理
- Windows 檢查位置
- 「設定」→「網路和網際網路」→「Proxy」
- macOS 檢查位置
- 「系統設定」→「網路」→ 目前的網路服務 →「詳細資訊」→「Proxy」
- 瀏覽器測試
- 使用系統代理設定,不要同時啟用瀏覽器自訂的代理規則
- 結束前
- 在用戶端選擇「清除系統代理」,必要時還原先前記錄的設定
系統代理只會影響遵循該設定的應用程式。結束前清除設定,可避免應用程式繼續向已停止的本機連接埠發送請求。
常見故障:依症狀排查
先記下故障發生時間、使用中的節點與本機連接埠,再重現一次。請分別確認三件事:訂閱能否下載、核心是否正在監聽,以及應用程式的請求是否依預期送出。每次只調整一項,修改後用同一個應用程式開啟同一個頁面,才能判斷設定是否生效。
初次設定常見問題
訂閱顯示更新成功,為什麼清單還是空的?
先選取剛更新的群組,並清除清單搜尋條件,再確認更新的是目前群組還是其他群組。如果日誌顯示解析失敗,請向服務提供者確認該網址回傳的是 v2rayN 支援的訂閱格式,而不是登入頁面或帳戶頁面;回報問題時只提供已去除敏感資訊的錯誤訊息。
訂閱更新逾時,需要改成透過代理嗎?
先確認目前網路可以正常開啟一般網頁,再檢查訂閱網址與用戶端日誌。如果已有經驗證可用的使用中節點,可以試著選擇「透過代理」更新,並保留兩次結果以便比較。剛安裝、清單中還沒有節點時,切換更新方式無法憑空建立代理,應先向服務提供者確認網址的存取條件。
連接埠遭占用,可以直接改成 10818 嗎?
可以先檢查是否有重複執行的用戶端。正常結束舊的執行個體後再試一次。如果原連接埠必須留給其他應用程式使用,而且 10818 尚未被占用,可以將混合連接埠改成此數值並重新載入核心,再讓 v2rayN 重新套用系統代理。先前手動輸入連接埠的應用程式也要一併修改,否則仍會連到舊連接埠。
網頁顯示連線遭拒,是節點失效了嗎?
先確認錯誤訊息指向哪個位置。如果遭拒的是 127.0.0.1:10808,請先確認核心是否已啟動,以及應用程式設定的連接埠是否與目前監聽的連接埠一致。如果用戶端已收到應用程式請求,但日誌顯示連線遠端失敗,再確認節點位址、連接埠與目前網路狀態。不要把本機入口的錯誤當成遠端故障。
結束 v2rayN 後,為什麼瀏覽器無法上網?
檢查系統代理是否仍指向本機連接埠,也確認瀏覽器是否手動設定了代理。如果殘留的是本次測試新增的設定,可以重新開啟用戶端,選擇「清除系統代理」後再結束程式測試;如果電腦原本有公司或學校的代理設定,請依照測試前的紀錄還原,不要直接覆寫。