· 入門指南 · 約 10 分鐘

v2rayN 初次安裝設定指南：Windows、macOS 常見問題排查

整理 v2rayN 在 Windows、macOS 初次使用時的解壓位置、執行環境、啟動權限、核心切換與本機連接埠設定。

本文重點

第一次使用 v2rayN，先確認安裝包架構與目錄可寫入，再檢查核心是否啟動、連接埠是否正在監聽，最後匯入訂閱並設定系統代理。本文適合初次設定 Windows 或 macOS 的使用者，依序檢查「程式啟動 → 核心啟動 → 節點連線 → 應用程式連線」，避免一次修改多項設定，導致問題難以判斷。

安裝包與解壓位置：先確認架構和寫入權限

v2rayN 是設定介面，實際連線由選用的核心負責。主視窗能開啟，只代表介面程式已啟動，不代表核心檔案完整或節點可用。下載時要確認作業系統、處理器架構和發行包說明；Windows 桌面版與傳統 WPF 版也不能只看檔名中的 x64，就判斷是否適用於目前環境。

Windows 與 macOS 的安裝位置檢查

Windows
  • 開啟「設定」→「系統」→「系統資訊」，查看系統類型，確認是 x64 還是 ARM64。
  • 先完整解壓縮，例如放在目前使用者有寫入權限的 C:\Users\Public\Tools\v2rayN，並確認該目錄的實際權限。
  • 保留主程式旁的相依檔案與核心目錄，不要只把單一執行檔拖到桌面。
  • 捷徑應指向解壓後的程式，不要指向壓縮檔預覽視窗中的暫存檔案。
macOS
  • 開啟蘋果選單→「關於這台 Mac」，確認使用的是 Apple 晶片還是 Intel 處理器。
  • 依發行包形式解壓縮或開啟磁碟映像檔，再將應用程式移至固定位置，例如「應用程式」。
  • 不要長期從唯讀磁碟映像檔或暫存解壓位置執行應用程式。
  • 若記錄顯示設定目錄無法寫入，請檢查記錄指出的特定目錄，不要直接放寬整個個人目錄的權限。

先固定程式與設定檔的位置，再匯入訂閱；升級前先備份設定，避免交替從新舊目錄啟動。

可攜式發行包通常會在程式目錄內儲存設定或相關資料。若放在受保護的目錄後，每次啟動都遺失設定，請先確認是否寫入失敗、是否啟動了另一份副本，再考慮調整權限。路徑盡量簡短，避免放在會自動清除的暫存目錄；路徑含中文不一定會造成問題，不必只因路徑有中文就重灌系統。

初次啟動：分辨執行環境、系統封鎖與 TUN 權限

Windows 若提示缺少執行環境，請依提示中的框架名稱、主要版本與架構處理。需要系統執行環境的套件，與自包含套件的需求不同；傳統 WPF 介面可能需要相應的 Windows 桌面執行階段，不能用隨意安裝的其他主要版本取代。即使下載自包含套件後仍無法啟動，也應先查看錯誤記錄，而非重複安裝多套執行階段。

  1. 保留原始錯誤資訊

    保留啟動提示、系統版本與安裝包名稱。若視窗一閃即關，請先查看程式記錄或系統應用程式錯誤記錄，分辨是缺少執行階段、檔案遺失還是架構不符。

  2. 確認是否允許啟動

    Windows 若出現安全性封鎖，請先查看「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」。確認來源與遭封鎖的項目後再處理，不要關閉整套防護。

  3. 處理系統提示

    macOS 上已確認來源、但尚未獲准執行的應用程式，可查看「系統設定」→「隱私權與安全性」中的具體提示，再依系統流程允許執行。若提示應用程式已損毀，請先重新下載符合處理器架構的版本。

  4. 先不要啟用 TUN

    初次連線先使用一般本機代理。TUN 涉及虛擬網路裝置、路由與額外權限，等一般代理確認可用後再單獨設定；出現權限提示時，依用戶端要求授權。

匯入訂閱與選擇核心：先建立可驗證的設定

訂閱網址用來取得節點清單，不是節點伺服器網址，也不是瀏覽器的代理網址。訂閱內容可能含有驗證權杖，排查問題時不要公開完整連結。不同版本的按鈕位置可能不同，以下會以「訂閱群組設定」、「參數設定」等功能名稱說明，請以目前介面顯示為準。

  1. 新增訂閱群組

    前往「訂閱群組」→「訂閱群組設定」，新增群組，填入方便辨識的備註與完整訂閱網址。確認網址前後沒有空白，儲存後返回主畫面。

  2. 更新節點清單

    在「訂閱群組」選單中執行更新。第一次尚無可用節點時，先嘗試不透過代理更新。若服務提供者要求透過代理存取，就需要先有可用連線；不能依賴尚未匯入的節點完成這一步。

  3. 確認核心類型

    前往「設定」→「參數設定」→「Core 類型」，確認相應協定使用的核心。VLESS、REALITY 與 XTLS Vision 的設定應使用支援這些組合的 Xray 核心，不要只憑名稱相似就切換。

  4. 選取目前使用的節點

    選取一個節點並設為目前使用的伺服器，再查看記錄是否出現設定解析失敗或核心結束執行。切換核心後，依介面提示重新啟動核心，並確認沒有繼續使用舊的程序。

VMess 與 VLESS 是代理協定，Xray 與 V2Ray 是核心專案，而 v2rayN 負責管理設定並啟動核心。這三者不能互相取代。訂閱匯入成功只代表內容可讀取；節點能否連線，還取決於協定參數、傳輸方式、TLS 設定與伺服器狀態。

本機監聽連接埠：確認 127.0.0.1 與實際連接埠相符

以下以 10808 作為本機 SOCKS 或相容 SOCKS 的混合入口範例，並以 127.0.0.1 代表目前裝置。這些並非所有發行版本通用的預設值。請先前往「設定」→「參數設定」，查看本機監聽位址、連接埠與入口協定，再將測試指令中的值改成介面顯示的實際設定。

10808
本文範例使用的監聽連接埠，請先確認
127.0.0.1
目前裝置的 IPv4 迴圈位址
需要確認的項目正確的判斷方式常見誤解
SOCKS 與 HTTP 入口依入口協定設定應用程式代理；混合入口可接受其支援的協定。把只接受 SOCKS 的連接埠填入應用程式的 HTTP 代理欄位。
獨立的 HTTP 連接埠若自行設定為 10809，請先確認該連接埠確實正在監聽。看到舊教學提到 10809，就認定本機一定有啟用。
監聽位址本機使用時優先確認 127.0.0.1；與區域網路共用是另一項設定。為了排查問題就直接開放所有網路介面，擴大可存取範圍。
連接埠衝突依程序編號確認占用者，關閉重複執行的程式或更換連接埠。只修改應用程式的連接埠，卻沒有同步修改核心的監聽設定。

Windows：檢查監聽狀態與占用程序

Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808

在 PowerShell 中執行以上指令。若第一個指令沒有結果，請檢查核心是否已啟動、連接埠是否填錯；若出現占用程序編號，請在工作管理員中確認對應程序，不要直接結束不熟悉的系統程序。第二個指令顯示連線成功，只能證明本機 TCP 入口可連線，不能證明遠端節點也已連通。

macOS：檢查監聽通訊端

lsof -nP -iTCP:10808 -sTCP:LISTEN

輸出中的程序名稱與 PID 可用來辨識監聽程序。若沒有輸出，請先查看 v2rayN 記錄中的核心啟動錯誤。若修改了監聽連接埠，請重新啟動核心後再檢查；不要一邊用舊連接埠測試，一邊判斷新設定失效。

系統代理與路由：先確認入口，再判斷出口

系統代理會決定支援這項設定的應用程式是否將請求送至本機入口；路由則決定進入核心後的請求使用哪個出口。將路由改為全域模式，不會讓忽略系統代理的應用程式自動連線。首次測試時先關閉 TUN，在 v2rayN 的「系統代理」選單中選擇「自動設定系統代理」，再確認作業系統是否顯示相應代理設定。

以下指令要求 10808 確實提供 SOCKS 服務。Windows PowerShell 請使用 curl.exe，macOS 終端機請使用 curl。指令中的 socks5h 會將目標網域交由代理端解析，有助於區分本機 DNS 與代理連線問題，但不代表系統 DNS 已變更。

# Windows PowerShell
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

# macOS 終端機
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

初次執行常見問題：依症狀縮小排查範圍

視窗可以開啟，為什麼一選節點就出錯？

先查看啟用節點後出現的第一則錯誤。找不到檔案就檢查核心位置；設定解析失敗就確認協定與 Core 類型；連接埠遭占用就檢查監聽程序。不要把這三種錯誤都當成訂閱失效。

訂閱更新逾時，需要開啟透過代理更新嗎？

已有可用節點，且該節點能存取訂閱網址時，可以在「訂閱群組」選單中選擇透過代理更新。若第一次使用時節點清單仍是空的，開啟此選項也不會自動建立連線；請先確認網址有效、網路可連線，以及服務是否到期。

延遲測試有數字，為什麼網頁還是打不開？

先確認執行的是 TCP 延遲測試，還是真正的連線測試。連接埠可連線不代表協定交握成功。使用明確指定代理的指令測試請求，再確認系統代理、瀏覽器設定與路由記錄；不要只憑延遲數字判斷連線狀態。

重新啟動後又要重新匯入訂閱，是不是沒有儲存？

先確認是否從另一份程式副本啟動，再檢查設定目錄是否可寫入。固定捷徑或應用程式位置，結束後重新開啟一次，確認設定是否保留；準備搬移目錄時請先備份設定，不要同時啟動新舊兩份程式。

完成設定後的檢查順序

初次安裝的目標是建立一條可重複驗證的連線路徑，而不是一次啟用所有功能。每次只修改一項設定並測試一次；即使失敗，也能找出剛才改動的項目。日常需要 TUN、自動啟動或更複雜的分流設定時，等基本連線穩定後再逐項加入。

  1. 程式層：應用程式能正常啟動，結束後重新開啟，訂閱與設定仍然存在。
  2. 核心層：啟用目前使用的節點後沒有設定解析錯誤，本機連接埠也正在監聽。
  3. 連線層：明確指定代理的測試能收到回應，並搭配路由記錄確認使用的出口。
  4. 應用程式層：目標應用程式使用正確的代理，並能分別說明瀏覽器與命令列的測試結果。
  5. 退出還原：先使用「清除系統代理」再結束用戶端，確認一般網路請求不再依賴已關閉的監聽連接埠。

若要繼續排查，請記錄作業系統與處理器架構、v2rayN 版本、核心名稱與版本、入口連接埠，以及第一則錯誤記錄。分享畫面截圖前，請遮蔽訂閱權杖、節點驗證資訊與伺服器私密參數。提供完整錯誤脈絡，比反覆重裝或頻繁切換核心更能協助找出問題。

下載v2rayN依平台選擇用戶端