2026-11-15 · 入門指南 · 約 8 分鐘

v2rayN 首次安裝與初始設定:Windows、macOS 通用步驟與常見問題

整理 v2rayN 在 Windows 與 macOS 的初始設定流程,涵蓋下載解壓、首次啟動權限、匯入訂閱、選擇核心與登入時自動啟動,並說明新手常見問題。

本文速覽

首次使用 v2rayN 7.x,先依作業系統和處理器架構選擇安裝檔,再匯入設定、啟用節點並測試本機代理。Windows 與 macOS 的安裝方式及權限設定位置不同,但連線檢查步驟相同。確認應用程式可透過代理連線後,再設定登入時自動啟動;遇到問題時,依序檢查安裝、訂閱、核心和應用程式,不必一開始就重新安裝。

選擇安裝檔與首次啟動:先確認系統和架構

能開啟主視窗,只代表用戶端介面已啟動,不表示負責處理連線的核心也能正常執行。下載時除了確認作業系統和架構,也要查看套件說明是否包含核心。初次設定建議優先選擇明確標示包含所需核心的版本,避免匯入節點後才發現缺少相應的可執行檔。

Windows 安裝檔選擇

查看架構
「設定」→「系統」→「關於」→「系統類型」
套件標示
x64 架構處理器選 x64;ARM 裝置選擇符合系統的 arm64 套件
壓縮檔
完整解壓縮至目前帳戶可寫入且之後不會移動的資料夾
首次啟動
壓縮檔請從解壓縮後的資料夾執行 v2rayN.exe;安裝程式則依照提示安裝

請勿直接在壓縮軟體的預覽視窗中連按兩下主程式,否則相鄰的核心檔案可能沒有一併解壓縮。

macOS 安裝檔選擇

查看架構
點選 Apple 選單 →「關於這台 Mac」,查看「晶片」或「處理器」
套件標示
Apple 晶片選 arm64;Intel 處理器選 x64
應用程式位置
依套件說明解壓縮或開啟磁碟映像檔,並將應用程式移至「應用程式」資料夾
首次啟動
從「應用程式」資料夾開啟,勿將磁碟映像檔當作長期執行位置

安裝後先手動開啟一次。如此一來,登入項目需要引用應用程式時,路徑就不會指向暫時掛載的位置。

  • Windows 顯示缺少執行階段:先查看錯誤訊息列出的執行階段名稱和主版本,再對照發行套件說明。若使用的套件需要系統執行階段,請依提示安裝相應架構的 .NET Desktop Runtime;系統管理員權限無法取代執行階段。
  • macOS 顯示無法驗證開發者:先確認套件來源和架構。若是開發者驗證提示,且確認信任該應用程式,可嘗試啟動一次,再前往「系統設定」→「隱私權與安全性」查看是否有「仍要打開」選項。若系統警告應用程式會損壞電腦,請勿繼續執行,也不要關閉系統的整體安全防護。

匯入訂閱:儲存、更新、啟用分三步

訂閱網址用來取得一組節點,儲存網址不會立即建立可用連線。以下以 v2rayN 7.x 繁體中文介面為例,依功能說明操作路徑;不同小版本的選單名稱可能略有差異。若取得的是以 vmess:// 或 vless:// 開頭的單一節點分享連結,請使用從剪貼簿匯入伺服器的功能,而非填入訂閱網址欄位。

  1. 新增訂閱群組

    開啟「訂閱群組」→「訂閱群組設定」,新增一筆資料。填入容易辨識的別名和完整訂閱網址,儲存後返回主畫面。網址可能包含存取權杖,請勿貼在公開截圖或記錄檔中。

  2. 更新訂閱清單

    選取新建的群組,從「訂閱群組」選單執行「更新目前訂閱(不透過代理)」。初次安裝時尚無可用節點,請勿先選擇透過代理更新。更新完成後,確認節點已出現在該群組,而不只是確認群組名稱建立成功。

  3. 設為使用中的節點

    在清單中選取確認可用的節點,按右鍵執行「設為活動伺服器」。單擊某一列只會選取該項目,不代表已切換連線。切換後查看主畫面的使用中項目和記錄,確認核心沒有立即結束。

  4. 測試應用程式連線

    先測試本機代理連接埠,再從系統匣或選單列圖示的「系統代理」選單選擇「自動設定系統代理」。關閉瀏覽器中會覆寫系統設定的個別代理規則,並開啟已知可連線的 HTTPS 網頁,確認瀏覽器能否正常載入。

選擇核心:先測試現有設定,再調整核心對應

節點儲存的是通訊協定、遠端位址和傳輸方式等連線參數,核心則負責執行這些參數。前往「設定」→「參數設定」→「Core 類型」(部分版本標示為「Core 類型設定」),即可查看內建節點通訊協定對應的核心選項。這項設定不是用來將 VMess 節點改成 VLESS;自訂節點若附有完整設定,也不宜直接套用這裡的一般判斷。

保留節點目前使用的核心

建議

先保留用戶端目前的通訊協定對應,啟用節點後查看記錄。若伺服器提供的是 VLESS + REALITY,而且目前使用的 Xray 能正確載入設定,就不要為了除錯同時更換核心、傳輸方式和安全參數。

適用情況:初次安裝、已有可匯入的標準訂閱

依伺服器需求調整核心

只有在伺服器明確指出相容性需求,或記錄顯示目前的核心無法辨識設定欄位時,才選擇支援該組合且已安裝的核心。儲存後重新啟用同一個節點,比較變更前後的記錄;不要同時更換伺服器,否則無法判斷哪項變更有效。

適用情況:移轉已知設定、排查明確的欄位相容性問題

若記錄顯示找不到核心檔案,先確認套件內容和平台架構。若核心已啟動,但連線記錄出現 TLS 或驗證錯誤,請回頭檢查訂閱中的位址、伺服器名稱和驗證參數是否來自同一份設定。請勿以關閉憑證驗證來掩蓋參數不一致的問題。

分別測試本機監聽與系統代理

前往「設定」→「參數設定」查看本機監聽連接埠。以下以混合入站連接埠 10808 為例,透過 HTTP 代理發出測試請求。若介面顯示分開的 SOCKS 和 HTTP 連接埠,請將命令中的連接埠改為 HTTP 入站連接埠。可暫時不啟用系統代理,因為命令會明確連線至本機代理。

curl -I --max-time 10 --proxy http://127.0.0.1:10808 https://example.com/

在 Windows PowerShell 中,可將開頭的 curl 改為 curl.exe。命令最多等待 10 秒。判斷結果時,請查看目標網站最後回傳的 HTTP 狀態列,而非只看建立代理通道時可能出現的 200 Connection established。這條命令只用來測試此應用程式連至該目標的路徑,並非速度測試。

觀察到的狀況下一步檢查項目
連線至 127.0.0.1:10808 遭到拒絕確認核心仍在執行、連接埠和入站類型設定正確,再查看記錄是否顯示監聽失敗或連接埠遭占用。
顯示已建立通道,但接著逾時或出現 TLS 錯誤本機連接埠已收到請求。請參照核心記錄,檢查目前的出站方式、伺服器是否可連線,以及 TLS 參數;不要先修改瀏覽器設定。
命令取得目標網站回應,但瀏覽器連不上檢查瀏覽器是否使用系統代理,以及是否有擴充功能或應用程式內的代理設定覆寫系統設定。重新開啟瀏覽器後,再以相同網址測試。

系統代理會將遵循系統設定的應用程式導向本機監聽連接埠;路由規則則決定進入核心的連線要透過代理出站或直接連線。命令成功只能表示請求經過本機入站並取得回應。若要進一步確認這次請求使用了代理出站,需對照目前的路由規則和可用的連線記錄,不能只憑網頁成功開啟來判斷。

登入時自動啟動與常見問題

瀏覽器測試通過後,再設定自動啟動。自動啟動通常會在使用者登入時執行,不會在系統尚未登入前啟動。用戶端自動開啟和系統代理還原也是兩件事,設定後請分別確認。

  • Windows:前往「設定」→「參數設定」查看「開機時自動啟動」選項。設定前先固定程式資料夾的位置;若之後移動免安裝版資料夾,請重新設定自動啟動,以免登入時仍引用舊路徑。
  • macOS:可前往「系統設定」→「一般」→「登入項目」,將「應用程式」中的 v2rayN 加入登入時開啟清單;部分系統版本將此頁面稱為「登入項目與延伸功能」。若已在用戶端設定自動啟動,請勿重複加入同一個應用程式。
  • 登出再登入測試:先確認用戶端已開啟,再確認使用中的節點、核心記錄和系統代理狀態。若要停止使用,請先在用戶端結束前清除系統代理,避免應用程式繼續將請求送往已關閉的本機連接埠。

訂閱群組有名稱,為什麼還是空的?

選取該群組,手動執行一次「更新目前訂閱(不透過代理)」,再查看更新記錄。若記錄顯示 HTTP 401 或 403,請確認網址完整,且存取權杖仍有效。若連線逾時,先檢查本機是否能連上訂閱服務;只有在已有可用代理時,才適合嘗試透過代理更新。

節點測速有數字,為什麼網頁還是開不起來?

測速結果不代表瀏覽器已經使用該節點。先確認該節點是活動伺服器,再使用明確指定本機代理的命令測試同一個目標。若命令成功但瀏覽器連不上,優先檢查瀏覽器的代理設定,而不是依延遲排序後再換節點。

關閉視窗後,代理為什麼還在運作?

查看系統匣或選單列是否仍有 v2rayN 圖示。若啟用了關閉視窗後繼續常駐,視窗消失不代表用戶端已結束。需要停止時,先在「系統代理」選單清除系統代理,再透過用戶端選單選擇「結束」。

登入後用戶端已開啟,終端機為什麼沒有走代理?

不少命令列程式不會沿用桌面系統代理設定。請先使用該工具提供的代理參數測試,例如使用上文的 curl --proxy 指定本機入站。只有確實需要長期設定時,才依工具文件設定其支援的代理參數或環境變數;不必為了讓單一命令走代理而修改全域設定。

用戶端下載