v2rayN 安裝與初始設定教學：Windows、macOS 通用指南與常見問題

一、選擇安裝套件：先確認作業系統、架構與介面版本

v2rayN 是用來管理伺服器、呼叫代理核心並設定本機代理入口的桌面用戶端。主畫面能開啟，只代表介面程式已成功啟動；核心檔案、節點參數與系統代理仍須分別確認。首次安裝請至用戶端下載頁選擇適用的平台，並保留安裝套件的類型與架構資訊，發生錯誤時較容易找出原因。

不要只因為看到「.NET」就安裝多個不同版本的執行階段。若缺少執行階段，啟動提示通常會列出框架名稱、所需版本與架構；例如提示缺少 Microsoft.WindowsDesktop.App，就應確認是否安裝相符的 .NET Desktop Runtime，而非只安裝基礎 Runtime 或開發用 SDK。所需主版本會隨用戶端發行套件而異，請以套件說明與錯誤提示為準。

二、首次啟動：解壓縮資料夾、應用程式位置與權限

Windows 壓縮檔必須先完整解壓縮。若直接在壓縮軟體中按兩下主程式，可能只會暫時解壓單一檔案，導致核心、資源檔或設定無法正常讀取。解壓版可放在目前使用者有寫入權限的固定資料夾，例如 D:\Tools\v2rayN；路徑僅供參考，重點是資料夾長期保留，且目前帳戶能儲存設定。

1. 確認安裝套件

   在下載頁確認作業系統、處理器架構與套件類型。Windows 請使用系統的「全部解壓縮」完整解壓；若使用安裝程式版本，則依照安裝精靈完成安裝，不要套用解壓版的資料夾規則。

2. 固定應用程式位置

   Windows 解壓版請保留完整資料夾結構。macOS 若提供磁碟映像檔，開啟後將應用程式複製到「應用程式」資料夾，不要長期從暫時掛載的映像檔執行。

3. 完成首次開啟

   Windows 請先以一般使用者身分啟動。macOS 若提示無法驗證開發者身分，先確認下載來源，再依系統提示前往「系統設定」→「隱私權與安全性」查看允許開啟的選項；不要關閉整個系統的安全檢查。

4. 查看啟動記錄

   開啟主畫面的記錄區，確認設定可以儲存、核心可以啟動。若出現檔案遺失、權限不足或架構不符，先排除對應錯誤，再匯入訂閱。

三、選擇核心：依節點需求確認 Xray 或 V2Fly

用戶端與核心是兩種不同的程式。v2rayN 負責介面與設定管理，實際建立代理連線的是核心。版本號不同很正常，不必為了讓數字一致而替換檔案。首次安裝請先保留發行套件提供的核心設定；確有協定需求時，再查看「設定」→「參數設定」及該版本中與 Core 類型相關的設定。

不同版本的 Core 類型設定位置可能不同，有些版本會依協定分別指定。請確認目前選取的節點實際呼叫哪個核心，而不是只看設定視窗中曾出現哪些名稱。若記錄顯示欄位不受支援或設定無法解析，先核對節點需求與核心版本，不要隨意修改加密、傳輸與 TLS 參數。

• 檔案遺失：重新完整解壓相符的發行套件，並檢查系統安全性記錄是否隔離核心檔案；不要從不明來源單獨下載檔案補上。
• 架構不符：介面與核心都必須符合系統支援的架構；主畫面能開啟，不代表隨附的核心一定能執行。
• 啟動失敗：保留第一筆核心錯誤及前後相關記錄。之後大量連線失敗，可能只是核心未能啟動所造成的結果。

四、匯入訂閱：先選取伺服器，再測試連線

完成安裝不代表已取得伺服器。訂閱網址由服務提供者提供，通常包含存取憑證；網站帳戶入口、方案說明頁與單一節點分享連結都不等於訂閱網址。複製時請確認內容完整，沒有換行、中文引號或前後空格。

1. 在 v2rayN 主畫面開啟「訂閱群組」→「訂閱群組設定」，新增群組，填寫方便辨識的別名與訂閱網址，然後儲存設定。
2. 回到「訂閱群組」選單，執行「更新全部訂閱（不透過代理）」。首次尚無可用節點時，優先嘗試直接更新。
3. 確認清單中出現伺服器項目。若網址只能透過代理存取，必須先有另一條可用連線，再使用「更新全部訂閱（透過代理）」；此選項無法憑空建立第一條連線。
4. 在伺服器清單選取一個節點，從右鍵選單選擇「設為活動伺服器」。確認目前的活動伺服器已變更，並查看記錄中是否出現啟動錯誤。
5. 先使用用戶端提供的連線測試進行初步檢查，再繼續設定系統代理。延遲測試成功，不代表瀏覽器已使用該節點。

五、本機監聽連接埠：用戶端與系統設定必須一致

本機監聽位址是應用程式連線至 v2rayN 的入口，不是遠端伺服器位址。可在「設定」→「參數設定」查看本機監聽相關選項；儲存後若用戶端要求重新啟動核心，請完成重啟，並從記錄確認實際監聽的連接埠。以下是兩種設定範例，不可同時視為目前版本的預設值。

首次使用請保留迴圈位址 127.0.0.1。啟用「允許來自區域網路的連線」會改變入口的可存取範圍，涉及防火牆與存取控制，並非解決本機網頁無法開啟的通用方法。系統代理中的連接埠、手動設定的軟體連接埠與核心記錄中的監聽連接埠必須相互對應。

檢查連接埠是否被占用

若記錄出現 address already in use，請先確認是否重複啟動 v2rayN。以下分別是 Windows 命令提示字元與 macOS 終端機的檢查範例；若使用其他連接埠，請替換數字。

netstat -ano | findstr ":10808"

lsof -nP -iTCP:10808 -sTCP:LISTEN

Windows 請查看本機位址欄與監聽狀態；最末欄的 PID 可在工作管理員的「詳細資料」中核對。確認程序來源後，再關閉重複執行的執行個體或更換本機連接埠；不要只看到數字就結束不明程序。變更連接埠後，也要同步更新系統代理與手動代理設定。

六、系統代理與路由模式：分別確認兩項設定

系統代理決定遵循作業系統代理設定的軟體要將要求送往何處；路由規則則決定要求進入核心後要直連、走代理或封鎖。設定「全域代理」不代表所有軟體都會自動遵循系統代理；選擇「自動設定系統代理」也不代表核心中的每個要求都會經由遠端伺服器。

• 連線驗證：開啟一個已知可存取的 HTTPS 網頁，同時查看核心記錄是否出現相應連線。若記錄詳細程度不足，可暫時提高記錄層級，測試後再還原。
• 應用程式差異：部分瀏覽器支援獨立代理設定，部分命令列工具只讀取環境變數；這些程式不一定會遵循系統代理。
• 退出順序：結束使用前，先在「系統代理」中選擇「清除系統代理」，再退出程式。若程式異常關閉而留下舊設定，可前往作業系統的代理設定手動還原。

確認基本連線正常後，再視需要啟用開機啟動、自動更新訂閱或 TUN。macOS 切換網路服務後若代理狀態改變，請重新檢查目前服務的代理設定；Windows 若設定寫入後立即被改回，請確認是否有其他代理程式、管理政策或安全工具同時管理這些設定。

七、首次安裝常見問題：依故障環節逐步排查

尋求協助時請保留以下資訊

• 作業系統版本、處理器架構、v2rayN 版本，以及桌面版或 WPF 版等套件類型。
• 使用的核心及版本、實際本機監聽連接埠、系統代理模式，以及是否啟用 TUN。
• 錯誤發生在哪個步驟：開啟介面、啟動核心、更新訂閱，還是瀏覽網頁；並附上第一筆相關錯誤與發生時間。
• 分享前請隱藏訂閱網址、伺服器存取憑證、UUID 與密碼。截圖請優先顯示設定項目名稱與錯誤文字，不要公開完整節點設定。

首次設定完成的標準是：用戶端設定可儲存、核心正常啟動、本機入口與系統代理一致，且實際網頁能成功開啟。確認這四項後，再逐一調整路由與自動化選項；每次只改一項，發生問題時才能還原到上一次可用的狀態。