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

本文重點

v2rayN 初次設定建議依序確認系統與架構、完整部署程式、檢查執行環境、匯入節點，再驗證本機代理。本文適合 Windows 與 macOS 桌面使用者，分別說明程式無法啟動、核心啟動失敗及瀏覽器未使用代理等問題，並整理首次連線時應檢查的選單、連接埠與記錄資訊。

選擇安裝套件：先確認系統、架構與介面類型

v2rayN 是桌面用戶端，圖形介面可管理節點、產生設定並呼叫代理核心。介面能開啟，不代表核心已在執行；節點顯示在清單中，也不代表瀏覽器流量已經經過代理。初次安裝時，請分別檢查這三個環節，避免遇到網頁無法開啟就反覆重裝。

請在下載中心依作業系統與處理器架構選擇套件。Windows 的傳統 WPF 介面與跨平台桌面介面屬於不同版本；macOS 也無法執行 Windows 可執行檔。下載前請閱讀各套件的環境需求，不能只憑檔案大小判斷是否已包含執行環境或核心。

檢查項目	Windows	macOS
系統架構	「設定」→「系統」→「系統資訊」，查看「系統類型」	蘋果選單→「關於這台 Mac」，查看「晶片」或「處理器」
架構對應	x64 適用於常見的 Intel、AMD 64 位元處理器；ARM64 適用於 Windows on ARM	Apple 晶片優先選擇 ARM64；Intel 處理器選擇 x64
程式類型	依下載頁說明區分安裝程式、壓縮檔與介面類型	依套件說明解壓縮或掛載，再安裝應用程式
執行環境	確認套件是自包含版本，或需要另外安裝執行環境	確認最低系統需求、處理器架構，以及套件是否為自包含版本

以下以常見桌面介面的中文名稱說明選單。不同發行版本可能將設定項目放在同一視窗的不同分頁；若名稱不同，請依「訂閱群組」、「系統代理」、「Core 類型」等欄位的用途尋找，不要照搬舊截圖中的位置。

程式部署：Windows 解壓縮與 macOS 首次開啟

部署方式：先將程式放到固定位置，再進行設定

Windows

先完整解壓縮，例如放在 D:\Tools\v2rayN，不要直接在壓縮軟體的預覽視窗中執行。
保留套件內的子資料夾與相依檔案，不要只將主程式複製到桌面。
選擇目前使用者可寫入的資料夾，避免一般設定操作因資料夾權限不足而失敗。
若選擇安裝程式，請依安裝流程部署，不要將壓縮檔的操作方式套用到安裝版。

macOS

依磁碟映像檔的說明，將應用程式複製到「應用程式」資料夾，再從該處啟動。
先解壓縮壓縮檔並保留應用程式套件結構，不要修改套件內的檔案。
不要長期從下載資料夾中的暫存解壓位置或已掛載的映像檔執行程式。
首次啟動若遭系統阻擋，請先分辨是來源確認提示，還是明確的安全風險警告。

固定部署位置後再匯入訂閱及設定開機啟動，可減少捷徑失效或啟動路徑變更造成的問題。

Windows 使用較短的路徑主要是為了方便排查問題，不代表中文路徑一定無法執行。真正需要留意的是資料夾是否可寫入、檔案是否完整，以及安全軟體是否隔離了相依檔案或核心檔案。若看到隔離記錄，請先確認檔案來源與具體提示，不要一次關閉所有系統防護。

執行環境與啟動記錄：先釐清主程式和核心的不同錯誤

部分 Windows 版本需要相符的 .NET 執行環境，另有一些版本已包含所需環境。若缺少執行環境，請以啟動對話框顯示的框架名稱、主要版本與架構為準。WPF 版本通常需要對應的 Desktop Runtime；只安裝 SDK 或其他架構的執行環境，不一定符合程式需求。本文不指定固定的執行環境版本，避免將特定發行版本的要求誤當成所有安裝套件的必要條件。

主視窗完全沒有出現：記下系統錯誤訊息全文，優先確認處理器架構、執行環境與最低系統需求。
主視窗能開啟，但顯示找不到核心：確認壓縮檔是否完整解壓縮、套件是否包含所選核心，以及相關檔案是否遭隔離。
核心啟動後立即結束：查看用戶端記錄中的第一則啟動錯誤，優先檢查連接埠占用、設定欄位與協定支援情況。
macOS 顯示架構不相容：重新確認 Apple 晶片與 Intel 套件的對應關係，不要將架構問題當成訂閱錯誤處理。

一般使用系統代理通常不需要一直以管理員身分執行。TUN、修改路由等功能可能需要額外權限，但不是初次驗證的必要步驟。先以一般權限完成基本代理測試，可減少權限變更與網路接管功能同時介入所造成的干擾。

初始設定：依序設定語言、核心並匯入訂閱

先保留預設的網路相關設定，只調整明確需要的項目。介面語言只影響選單顯示，不會改變伺服器協定；訂閱網址用來取得節點清單，不能取代本機監聽與系統代理設定。訂閱連結可能含有存取憑證，截圖及求助記錄都應遮蔽完整網址。

確認介面語言

進入「設定」，找到語言選項並選擇繁體中文。部分版本會在「設定」→「參數設定」中提供此選項；若畫面提示需要重新啟動，請正常結束用戶端後重新開啟，再繼續設定。
檢查核心

進入「設定」→「參數設定」→「Core 類型」，確認相關協定使用的核心；此選項可能位於視窗中的獨立分頁。確認程式套件包含對應核心後再儲存，不要同時切換多項網路功能。
建立訂閱群組

開啟「訂閱群組」→「訂閱群組設定」，新增群組並填入自己已有的訂閱網址。群組名稱僅供本機辨識；網址欄位不可混入空格、說明文字或換行。
更新節點清單

在「訂閱群組」選單中選擇更新所有訂閱。首次使用且尚無可用代理時，請先使用不經代理的更新方式。更新成功後，確認節點數量是否有變化，再選擇一個節點設為作用中的伺服器。
啟用系統代理

確認核心記錄沒有啟動錯誤後，在用戶端的「系統代理」選單選擇「自動設定系統代理」。完成一次瀏覽器連線測試後，再依需求調整路由規則或訂閱自動更新間隔。

若手上只有單一節點分享連結，請使用「伺服器」選單中相應的匯入功能，不要將連結填入訂閱網址欄位。更新訂閱需要連線至訂閱伺服器；匯入節點則是解析節點參數，兩者失敗時的排查方向不同。

選擇核心：依節點協定確認，不要憑名稱判斷速度

v2rayN 是用戶端，Xray 與 V2Fly 則是代理核心專案。兩者支援的協定與傳輸方式並不完全相同，節點能否使用取決於節點參數及所選核心的實際支援能力。切換核心不代表一定會變快，也無法修復已失效的伺服器網址或錯誤的憑證。

Xray 核心

建議

初次設定時，可優先確認 Xray 是否符合現有節點的需求。使用 VLESS 與 REALITY 的節點，需要相容的核心，並完整保留服務提供者提供的傳輸與安全性參數。

適用情況：現有訂閱明確要求使用 Xray，或包含相關協定組合。

V2Fly 核心

使用 V2Fly 時，請逐項確認節點協定、傳輸方式及核心的支援範圍。即使 VMess 等協定名稱相同，也不能單憑名稱判斷是否相容；還需檢查 TLS、WebSocket 路徑等具體欄位。

適用情況：節點說明明確支援 V2Fly，或需要測試既有 V2Fly 設定。

變更 Core 類型後，請重新啟動相關連線並查看實際啟動記錄。設定畫面中的選項不一定會在變更當下同步至目前正在執行的核心，因此不能只看設定視窗就認定切換已完成。若要了解設定層次，可參考JSON 設定手冊中的入站、出站與路由說明。

連線驗證：分別檢查本機連接埠、系統代理與路由

本機監聽位址是應用程式連線至用戶端的入口；遠端伺服器連接埠則是核心連線至節點的目標，兩者不可混用。以下以 127.0.0.1:10808 示範連接埠檢查；實際連接埠與入口協定請以「設定」→「參數設定」中的監聽設定及記錄為準，不同版本可能提供 SOCKS、HTTP 或混合入口。

驗證層級	檢查項目	常見誤判
本機監聽	記錄顯示監聽成功，且預期的程序正在使用該連接埠	看到連接埠遭占用，就認定用戶端已正常啟動
作用中節點	節點已設為作用中的伺服器，核心也已成功載入設定	訂閱清單有內容，就認定已經連線
系統代理	系統代理指向實際使用的 HTTP 或混合入口	將僅支援 SOCKS 的連接埠填入 HTTP 代理設定
路由規則	確認測試請求依預期使用代理或直接連線	將繞過規則造成的直連誤認為系統代理失效

Windows 可在命令提示字元中檢查範例連接埠。輸出的最後一欄通常是程序 ID；若發現其他用戶端占用連接埠，請先確認程序身分，再正常結束衝突程式或變更本機監聽連接埠。不要直接強制結束不認識的系統程序。

netstat -ano -p tcp | findstr ":10808"

macOS 可在終端機查看監聽範例連接埠 TCP 連線的程序。沒有輸出只表示目前的命令沒有列出符合條件的監聽項目，仍須依實際用戶端連接埠與記錄判斷，不能直接認定「訂閱無法使用」。

lsof -nP -iTCP:10808 -sTCP:LISTEN

若變更本機監聽連接埠，請重新套用用戶端的系統代理設定，並同步更新瀏覽器或其他應用程式中手動填寫的代理位址。
Windows 可在「設定」→「網路和網際網路」→「Proxy」確認系統代理；macOS 可在目前網路服務的「詳細資訊」→「代理伺服器」確認。
並非所有應用程式都會遵循系統代理。初次驗證時，請優先使用會遵循系統代理的瀏覽器，不要立即再加上 TUN 或瀏覽器代理擴充功能。
結束用戶端前，請先清除系統代理，避免程式停止後，系統仍將請求傳送至已關閉的本機連接埠。

初次安裝常見問題

解壓縮後按兩下沒有反應，需要重新安裝嗎？

先確認程式不是在壓縮檔內執行，再檢查系統是否顯示執行環境或架構錯誤。Windows 請查看「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」是否有相關項目；macOS 請先確認應用程式已複製到固定位置，且符合系統需求。依明確的錯誤訊息處理，不要接連覆蓋安裝不同架構的套件。

訂閱更新逾時，應該先開啟哪個選項？

先確認訂閱網址尚未過期、系統日期與時間正確，且目前網路可以連線至訂閱伺服器。已有可用節點時，才嘗試透過代理更新；尚無可用節點卻依賴代理更新，可能陷入無法完成初次匯入的循環。若出現憑證錯誤，請檢查系統時間與憑證鏈，不要預設以關閉驗證來處理。

節點測得出延遲，為什麼網頁還是開不起來？

延遲測試結果只表示該項測試已完成，不代表瀏覽器正在使用本機代理。先確認「系統代理」是否設為「自動設定系統代理」，再檢查作用中的節點與核心記錄。若瀏覽器有手動設定代理，也請確認協定與連接埠相符，並暫時排除重複的代理設定。

關閉用戶端後，網路反而不能用了？

先開啟系統的代理設定，確認是否仍指向 127.0.0.1。若本機用戶端已結束，請關閉殘留的手動代理，或重新啟動用戶端後使用「清除系統代理」。不要以重設所有網路設定取代這項檢查。

剛安裝好就需要設定開機啟動和 TUN 嗎？

不必將這些設定當成初次連線的先決條件。先完成一次「啟動核心、設定系統代理、瀏覽網頁、清除系統代理」的完整測試。確認基本連線穩定後再啟用開機啟動；若確有應用程式不遵循系統代理的需求，再單獨設定 TUN 並處理所需權限。

完成設定後的保留項目與檢查順序

首次成功使用後，保留目前可用的核心選擇、監聽連接埠與路由方式。日後排查問題時，每次只變更一個項目：先確認程式能否啟動，再查看核心記錄，接著檢查節點連線，最後確認應用程式是否使用代理。如此可分辨安裝環境變更、節點失效與系統設定殘留等問題。

記下必要資訊：在本機記錄用戶端版本、套件架構、作用中的核心與連接埠，不要公開訂閱網址或節點憑證。
儲存設定前先結束程式：備份用戶端設定前，請先正常結束程式，避免複製到正在寫入的資料；設定檔可能包含敏感資訊，請妥善保存。
更新前先閱讀說明：切換介面類型或跨越較大的版本差異時，不要假設可以直接覆蓋整個舊資料夾；請先保留可還原的設定副本。
確認結束程式後的狀態：確認正常結束後系統代理已清除，重新啟動電腦後一般網路仍可正常使用。

想進一步了解訂閱匯入與路由設定，可依照入門教學逐項操作。初次安裝的目標是建立清楚、可檢查的基本設定，而不是一次啟用所有功能。