v2rayN 初次安裝與設定教學:Windows、macOS 步驟與常見問題

整理 v2rayN 解壓與啟動、核心檔案、代理連接埠與系統代理設定,以及首次匯入訂閱的步驟,並說明缺少執行階段、連接埠遭占用等常見問題。

本文快速導覽

適合第一次在 Windows 或 macOS 設定 v2rayN 的使用者。先依作業系統與處理器架構選擇版本,再匯入訂閱、啟動核心,並用單一應用程式測試本機代理。依序操作,有助於分辨程式無法啟動、訂閱尚未匯入,以及應用程式未使用代理這三類問題。

安裝檔與首次啟動

下載前先確認處理器架構。Windows 可在「設定」→「系統」→「系統資訊」查看系統類型,辨別 x64 與 ARM64;macOS 可從 Apple 選單開啟「關於這台 Mac」查看晶片或處理器,Apple 晶片選 ARM64,Intel 處理器選 x64。檔名相近時,也要確認是安裝檔還是壓縮檔,以及是否內含核心,別只看檔案大小判斷。

Windows 與 macOS 的啟動方式

Windows
  • 使用安裝檔時依照安裝精靈操作;使用壓縮檔時,先完整解壓縮到目前使用者有寫入權限的資料夾,再開啟 v2rayN.exe。請勿直接從壓縮檔預覽視窗執行。
  • 若啟動時提示缺少 .NET,請記下對話框顯示的框架名稱、版本與架構。若要求 Microsoft.WindowsDesktop.App,請安裝相符的 .NET Desktop Runtime;只安裝基本執行階段並不足夠。
macOS
  • 開啟磁碟映像檔後,依套件內的說明將應用程式移至「應用程式」資料夾;若是壓縮檔,先完整解壓縮再移動應用程式。請勿將應用程式內部的執行檔單獨拖出來啟動。
  • 若系統阻止開啟,先確認安裝檔來源、架構及提示內容,再前往「系統設定」→「隱私權與安全性」查看相關通知。若出現惡意軟體警告,請停止執行,不要關閉整體安全防護。

能開啟主視窗只代表介面已啟動;匯入設定後,仍須查看記錄確認所選核心已正常執行。

選擇核心與檢查檔案

v2rayN 負責管理訂閱、伺服器與本機設定,實際處理連線的是核心。訂閱提供連線參數,不會安裝核心。首次使用建議選擇明確內含相應核心的版本;若使用未附核心的版本,可先查看介面上的「檢查更新」選單,確認是否提供核心下載或更新功能。

Xray 核心

建議

若伺服器端明確提供 VLESS 與 REALITY 設定,請使用相容的 Xray 核心;匯入後保留服務提供者指定的傳輸與安全參數。

適用情境:首次匯入明確要求使用 Xray 的訂閱

V2Fly 核心

若服務提供者明確提供適用於 V2Fly 的 VMess 設定,且目前版本支援該核心,便可選用。仍須確認傳輸層與 TLS 設定,不可只依 VMess 協定名稱判斷是否相容。

適用情境:設定已註明相容 V2Fly 的條件

在提供此頁面的版本中,可前往「設定」→「參數設定」→「Core 類型」,確認所用協定對應的核心。若記錄顯示找不到核心,先依記錄中的路徑確認檔案是否齊全,再核對處理器架構。桌面介面能開啟,不代表另外下載的核心也相容;請勿將其他系統或架構的執行檔改名後放入。

首次匯入訂閱與啟用節點

  1. 新增群組

    開啟「訂閱群組」→「訂閱群組設定」,選擇新增。輸入方便辨識的別名,將服務提供者給的訂閱網址貼到「可選地址」,儲存後切換至該群組。若取得的是單一分享連結而非訂閱網址,請從「伺服器」選單使用從剪貼簿匯入的功能。

  2. 更新目前群組

    在「訂閱群組」選單中選擇「更新目前訂閱(不透過代理)」,前提是目前網路能直接連線至該網址。等記錄顯示更新結果後,確認目前群組確實出現伺服器項目。儲存群組只會儲存網址,並不代表網址可正常使用。

  3. 設為作用中伺服器

    選取群組中的一個節點,按右鍵選擇「設為作用中伺服器」。不同版本的選單文字可能略有差異,請以實際啟用狀態為準。選取一列並不代表已切換連線;執行後查看記錄,確認沒有設定解析或監聽失敗的問題。

  4. 測試單一應用程式

    先讓一個支援手動設定代理的應用程式使用 v2rayN 目前顯示的本機位址與連接埠,再瀏覽平常能開啟的網頁。暫時不要修改路由規則,也不要啟用 TUN。透過單一應用程式測試,可分開檢查本機代理連線與系統代理的套用範圍。

訂閱網址可能包含帳戶權杖,排查問題時請遮住完整 URL;分享記錄時,也要留意其中可能包含伺服器位址。若更新成功但群組仍是空的,先確認是否切錯群組或啟用了清單篩選,再向服務提供者確認回傳的是訂閱內容,而非登入頁面或到期通知。

本機連接埠與系統代理

在「設定」→「參數設定」中查看本機監聽設定,並以介面與記錄顯示的連接埠為準。以下數字僅用於說明填寫方式,並非所有版本的預設值;特別是混合監聽可在同一連接埠接收 HTTP 與 SOCKS 請求,因此不能看到一個連接埠,就推定另一種連接埠也一定存在。

127.0.0.1
同一台電腦上的回送位址
10808
本機監聽連接埠範例
10818
發生衝突時可嘗試的替代連接埠

初次設定常見問題

雙擊後提示缺少執行階段,該怎麼辦?

先依對話框記下所需框架與架構,再安裝相應的執行階段並重新啟動。若沒有出現提示,請重新確認是否已完整解壓縮,以及啟動的是否為 GUI 主程式。不要從其他電腦複製零散的動態連結程式庫來補足相依檔案。

記錄顯示連接埠已遭占用,如何確認?

若錯誤顯示連接埠 10808 已遭占用,Windows 可執行 netstat -ano | findstr :10808,在監聽項目中查看處理程序 ID;macOS 可執行 lsof -nP -iTCP:10808 -sTCP:LISTEN。確認是自己開啟的舊執行個體後再將其關閉。若要更換連接埠,儲存後重新啟動核心,並同步修改應用程式中手動填入的連接埠。

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

先確認目前網路能否連線至訂閱服務,以及群組中記錄的 URL 是否完整。若手邊沒有可用節點,改用「透過代理」更新通常無法解決首次匯入問題。可向服務提供者索取能直接連線的訂閱網址,或先匯入服務提供者另外提供的可用節點,再更新訂閱。

節點顯示延遲,為什麼網頁還是打不開?

測速結果只代表該次測試收到回應,不表示瀏覽器使用相同的連線路徑。確認作用中伺服器選擇正確,檢查核心是否正常監聽,再核對瀏覽器使用的代理類型與連接埠。若手動設定代理可以連線,但系統代理不行,請優先檢查系統設定及應用程式是否有讀取該設定。

結束程式後,連一般網頁也打不開?

先到系統代理設定頁面,確認是否仍指向 v2rayN 的本機連接埠。核心結束執行後,殘留的代理位址不會繼續提供回應。清除這次新增的設定,或還原設定前記錄的位址與連接埠,再用同一個網頁重新測試。

用戶端下載依平台選擇 v2rayN / v2rayNG