v2rayN 初次安裝與設定教學:Windows、macOS 常見問題與排除方式

整理 v2rayN 初次啟動的安裝、核心檔案位置、系統代理與登入時啟動設定,並說明權限、路徑和連接埠常見問題。

本文重點

適合第一次在 Windows 或 macOS 使用 v2rayN 的讀者。先確認安裝包和核心能正常執行,再測試節點與本機代理連接埠,最後設定系統代理和登入時啟動。每個步驟分開確認,方便判斷問題出在程式、連接埠,還是應用程式未使用代理。

初次啟動流程:選擇安裝包、啟用節點、測試代理

以下以 v2rayN 7.x 桌面版為例。不同小版本或介面版本的選單位置可能略有差異,尤其是 Windows 系統匣選單與 macOS 介面。初次啟動前,先關閉其他代理用戶端,暫時不要啟用 TUN 或區域網路連線。

  1. 確認處理器架構

    Windows 可至「設定」→「系統」→「關於」查看系統類型,確認是 x64 或 ARM64。macOS 可從 Apple 選單開啟「關於這台 Mac」查看晶片或處理器:Apple 晶片為 ARM64,Intel 處理器為 x64。用戶端和隨附核心應選擇相同的目標架構。

  2. 解壓安裝包

    Windows 免安裝壓縮包須完整解壓縮至固定資料夾,再執行其中的 v2rayN.exe;只將主程式拖出壓縮包會缺少配套檔案。macOS 壓縮包解開後,將整個 v2rayN.app 移至「應用程式」資料夾,再從該處開啟。

  3. 新增測試節點

    若手邊有單一分享連結,複製後從主視窗的「伺服器」選單選擇剪貼簿匯入。若只有訂閱網址,請前往「訂閱群組」→「訂閱群組設定」新增群組,再更新訂閱。清單出現節點後,選取其中一個並設為目前使用的伺服器。

  4. 確認監聽連接埠

    開啟「設定」→「參數設定」確認本機監聽連接埠,再查看主視窗記錄,確認核心是否成功啟動。記下實際使用的連接埠,以及它接收的是 HTTP、SOCKS 或混合代理;不要將節點編輯視窗顯示的遠端連接埠當成本機連接埠。

  5. 設定系統代理

    在用戶端的系統代理選單中選擇「自動設定系統代理」。Windows 可從系統匣圖示的右鍵選單進入。接著用遵循系統代理設定的瀏覽器開啟網頁;若瀏覽器另有代理擴充功能或獨立設定,請先排除這些因素。

程式與核心位置:分辨權限、路徑和架構問題

能開啟主視窗,只代表 v2rayN 介面已啟動。實際處理連線的是核心程序;匯入節點後,仍須確認目前使用的核心可找到並執行。先查看啟動記錄,再決定是否更換安裝包或更新核心。

依作業系統確認應用程式位置

Windows:保留完整資料夾
  • 免安裝版可放在目前帳戶有寫入權限的固定資料夾。不要在壓縮檔預覽視窗中直接雙擊程式,也不要只複製 v2rayN.exe。
  • 常見的 7.x 資料夾配置會將核心放在程式目錄下的 bin 資料夾,例如 bin\xray\xray.exe。若找不到檔案,先確認下載的是含核心的安裝包,或透過用戶端提供的核心更新功能補齊。
  • 執行環境缺失提示和寫入權限錯誤是兩種不同問題。前者依提示確認所需執行環境與架構;後者檢查程式或資料目錄是否可寫入,不要一律以「以系統管理員身分執行」處理。
macOS:保留應用程式套件結構
  • 不要單獨移動或重新命名 v2rayN.app 內的可執行檔。核心的實際路徑請以目前發行版本和啟動記錄為準,不要套用 Windows 的檔案結構。
  • 若記錄顯示 bad CPU type in executable,請先確認錯誤來自用戶端還是核心,再改用符合本機架構的安裝包;反覆匯入訂閱無法改變執行檔的架構。
  • 若系統阻止程式啟動,請先閱讀具體提示,並確認下載來源及公司或學校裝置的管理規範。不要只為了啟動單一應用程式而關閉系統保護。

移動或升級前,先結束舊版程序並備份目前版本使用的設定資料夾。更換位置後,從新路徑手動啟動一次,再確認原有捷徑和登入時啟動設定是否正常。

備份時不要只保留主程式,也不要把記錄檔當成設定備份。訂閱網址可能包含存取權杖,節點資料也可能含有連線憑證。提供錯誤資訊給他人時,保留錯誤類型與必要路徑即可,並移除訂閱網址、節點憑證,以及路徑中不必要的帳戶名稱。

選擇核心:依目前節點的協定參數判斷

訂閱用來取得一組節點,核心則負責解析並執行個別節點。訂閱更新成功,不代表每份設定都與所選核心相容。請在「設定」→「參數設定」確認相應協定使用的核心類型;若節點編輯視窗提供個別核心選項,也要確認是否曾另行指定。

使用符合節點設定的核心

建議

保留匯入後已確認的協定與傳輸參數。例如,節點明確使用 VLESS + REALITY 時,請使用支援此組合的 Xray 核心。連線失敗不一定是核心造成,也不要為了測試而將 REALITY 改成 TLS。

適用情境:初次設定,且服務端參數已有明確說明

針對單一設定測試替代核心

若維護者明確表示某個 VMess 設定相容於 V2Ray 和 Xray,可保留已知設定,再針對單一節點切換核心並比較啟動記錄。核心能辨識協定名稱,不代表一定支援該節點使用的傳輸方式與安全選項。

適用情境:問題可重現,需釐清核心相容性差異

本機連接埠與系統代理:分別確認是否正在監聽及是否已設定

本機監聽連接埠供同一台電腦上的應用程式連線;遠端連接埠則供核心連接伺服器,兩者可能不同。啟用系統代理只是讓遵循系統設定的應用程式找到本機入口,不會修復核心的遠端連線,也不代表所有應用程式的流量都會經過此入口。

127.0.0.1
僅供本機連線的 IPv4 位址
10808
常見本機監聽連接埠,請以介面顯示為準
10809
部分舊設定使用的獨立 HTTP 連接埠
  • 記錄顯示連接埠被占用:先結束其他代理用戶端或舊版 v2rayN 程序。若必須保留占用中的程序,可為 v2rayN 指定未使用的連接埠;重新啟動核心後,再設定系統代理,並同步更新應用程式中手動填寫的舊連接埠。
  • 連接埠正在監聽,瀏覽器仍無法連線:Windows 請檢查「設定」→「網路和網際網路」→「Proxy」;macOS 請檢查「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」。此處只需確認系統實際設定,不必再手動設定一次。若應用程式要求 HTTP 代理,不能填入只接收 SOCKS 連線的連接埠。
  • 結束程式後網頁無法開啟:確認系統是否仍指向已停止監聽的本機連接埠。結束程式前可先選擇用戶端的「清除系統代理」;若原本使用公司或學校指定的代理,請還原原設定,不要一律關閉代理。

登入時啟動:確認啟動路徑與代理狀態

先確認手動啟動時可以正常瀏覽網頁,再設定登入時啟動。桌面用戶端通常會在使用者登入後啟動,不代表裝置開機後、登入前就能提供代理服務。自動啟動只會開啟程式,無法保證核心已啟動或系統代理已切換至所需模式。

  1. Windows 可先到「設定」→「參數設定」尋找「開機自動啟動」選項。若目前版本沒有此選項,也可按 Win + R 開啟 shell:startup,並放入指向目前程式位置的捷徑。兩種方式擇一即可,避免重複啟動。
  2. macOS 可在「系統設定」→「一般」→「登入項目與延伸功能」中,將「應用程式」資料夾內的 v2rayN 加入登入時開啟的項目;部分版本將此頁面稱為「登入項目」。若曾移動應用程式,請確認清單指向新位置。
  3. 登出後重新登入,確認用戶端只啟動一次、目前使用的節點正確,且本機監聽連接埠與系統代理設定一致。若開機時網路尚未就緒,請等網路恢復後再測試一次,再判斷是自動啟動失敗,還是連線建立時間較晚。
下載 V2Ray 用戶端