適合第一次在 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 類型」,確認所用協定對應的核心。若記錄顯示找不到核心,先依記錄中的路徑確認檔案是否齊全,再核對處理器架構。桌面介面能開啟,不代表另外下載的核心也相容;請勿將其他系統或架構的執行檔改名後放入。
首次匯入訂閱與啟用節點
新增群組
開啟「訂閱群組」→「訂閱群組設定」,選擇新增。輸入方便辨識的別名,將服務提供者給的訂閱網址貼到「可選地址」,儲存後切換至該群組。若取得的是單一分享連結而非訂閱網址,請從「伺服器」選單使用從剪貼簿匯入的功能。
更新目前群組
在「訂閱群組」選單中選擇「更新目前訂閱(不透過代理)」,前提是目前網路能直接連線至該網址。等記錄顯示更新結果後,確認目前群組確實出現伺服器項目。儲存群組只會儲存網址,並不代表網址可正常使用。
設為作用中伺服器
選取群組中的一個節點,按右鍵選擇「設為作用中伺服器」。不同版本的選單文字可能略有差異,請以實際啟用狀態為準。選取一列並不代表已切換連線;執行後查看記錄,確認沒有設定解析或監聽失敗的問題。
測試單一應用程式
先讓一個支援手動設定代理的應用程式使用 v2rayN 目前顯示的本機位址與連接埠,再瀏覽平常能開啟的網頁。暫時不要修改路由規則,也不要啟用 TUN。透過單一應用程式測試,可分開檢查本機代理連線與系統代理的套用範圍。
訂閱網址可能包含帳戶權杖,排查問題時請遮住完整 URL;分享記錄時,也要留意其中可能包含伺服器位址。若更新成功但群組仍是空的,先確認是否切錯群組或啟用了清單篩選,再向服務提供者確認回傳的是訂閱內容,而非登入頁面或到期通知。
本機連接埠與系統代理
在「設定」→「參數設定」中查看本機監聽設定,並以介面與記錄顯示的連接埠為準。以下數字僅用於說明填寫方式,並非所有版本的預設值;特別是混合監聽可在同一連接埠接收 HTTP 與 SOCKS 請求,因此不能看到一個連接埠,就推定另一種連接埠也一定存在。
- 確認代理類型:應用程式若要求 HTTP 代理,請填入支援 HTTP 的監聽連接埠;若要求 SOCKS5,則填入支援 SOCKS 的連接埠。不要將遠端伺服器連接埠填入本機應用程式的代理欄位。
- 接著啟用系統代理:單一應用程式測試通過後,在 v2rayN 的「系統代理」選單中選擇「自動設定系統代理」。Windows 可前往「設定」→「網路和網際網路」→「Proxy」確認;macOS 可前往「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」確認。
- 確認套用範圍:系統代理只會影響讀取該設定的應用程式。若一個瀏覽器正常、另一個應用程式無法使用,先檢查後者是否有獨立的代理設定,不要立刻修改訂閱或更換核心。離開前請使用「清除系統代理」;若裝置原本有單位設定的代理,請還原原設定。
初次設定常見問題
雙擊後提示缺少執行階段,該怎麼辦?
先依對話框記下所需框架與架構,再安裝相應的執行階段並重新啟動。若沒有出現提示,請重新確認是否已完整解壓縮,以及啟動的是否為 GUI 主程式。不要從其他電腦複製零散的動態連結程式庫來補足相依檔案。
記錄顯示連接埠已遭占用,如何確認?
若錯誤顯示連接埠 10808 已遭占用,Windows 可執行 netstat -ano | findstr :10808,在監聽項目中查看處理程序 ID;macOS 可執行 lsof -nP -iTCP:10808 -sTCP:LISTEN。確認是自己開啟的舊執行個體後再將其關閉。若要更換連接埠,儲存後重新啟動核心,並同步修改應用程式中手動填入的連接埠。
訂閱更新逾時,清單還是空的?
先確認目前網路能否連線至訂閱服務,以及群組中記錄的 URL 是否完整。若手邊沒有可用節點,改用「透過代理」更新通常無法解決首次匯入問題。可向服務提供者索取能直接連線的訂閱網址,或先匯入服務提供者另外提供的可用節點,再更新訂閱。
節點顯示延遲,為什麼網頁還是打不開?
測速結果只代表該次測試收到回應,不表示瀏覽器使用相同的連線路徑。確認作用中伺服器選擇正確,檢查核心是否正常監聽,再核對瀏覽器使用的代理類型與連接埠。若手動設定代理可以連線,但系統代理不行,請優先檢查系統設定及應用程式是否有讀取該設定。
結束程式後,連一般網頁也打不開?
先到系統代理設定頁面,確認是否仍指向 v2rayN 的本機連接埠。核心結束執行後,殘留的代理位址不會繼續提供回應。清除這次新增的設定,或還原設定前記錄的位址與連接埠,再用同一個網頁重新測試。