v2rayN 首次安裝與初始設定完整教學：Windows/macOS 通用重點與常見問題

下載前先確認系統與執行環境

開始前先查看裝置的系統類型與處理器架構。Windows 可開啟「設定」→「系統」→「系統資訊」，在「系統類型」中確認是 x64 還是 ARM64。macOS 可開啟左上角系統選單中的「關於這台 Mac」，查看晶片是 Apple 晶片還是 Intel。安裝包架構與裝置不一致時，程式可能無法啟動，也可能在呼叫核心時直接結束。

v2rayN 7.x 的桌面介面依賴 .NET 8 執行環境。若下載頁同時提供內建執行環境與需另外安裝執行環境的版本，新手優先選擇說明完整、與目前架構一致的桌面版本。選擇精簡版本時，必須先安裝對應架構的 .NET 8 Desktop Runtime。這裡只需要桌面執行環境，不要將一般 Runtime、ASP.NET Core Runtime 與 Desktop Runtime 混為一談。

• Windows x64：常見於 Intel、AMD 處理器的桌上型電腦與筆記型電腦。
• Windows ARM64：適用於採用 ARM 處理器並執行對應版本 Windows 的裝置。
• macOS Apple 晶片：選擇與 Apple 晶片對應的建置版本，避免依賴轉譯執行。
• macOS Intel：選擇 Intel 架構建置版本，不要直接使用 Apple 晶片版本。

完成解壓縮、首次啟動與核心確認

下載完成後，將壓縮包完整解壓縮至固定目錄。Windows 可使用類似 D:\Apps\v2rayN 的一般路徑；macOS 則放入目前帳戶具備讀寫權限的應用程式目錄。不要長期直接從壓縮包預覽視窗執行，因為主程式需要讀取同一目錄中的設定、資源與核心檔案。

路徑儘量簡短，並避免放在會頻繁同步、清理或限制寫入的位置。v2rayN 會儲存訂閱群組、伺服器清單、記錄檔與介面設定。目錄權限不足時，常見情況包括設定無法保留、更新後節點消失，或下次啟動又恢復成預設語言。

1. 完整解壓縮

   將壓縮包解壓縮至固定目錄，確認主程式、設定目錄與核心相關檔案都已完整寫入，不要只複製單一執行檔。

2. 首次執行

   啟動 v2rayN。Windows 出現網路存取提示時，只依實際使用範圍授予權限；macOS 出現開啟確認時，確認應用程式名稱與下載來源後再繼續。

3. 設定核心

   進入「設定」→「參數設定」→「Core 類型」，依節點協定選擇 Xray 或 v2fly，儲存後返回主介面。

4. 檢查記錄

   開啟記錄區域並啟動一次核心，確認沒有持續出現「找不到檔案」、「權限不足」或連接埠遭佔用的提示。

5. 重新啟動驗證

   退出客戶端後重新開啟，確認語言、Core 類型與本機連接埠設定仍然保留。

首次執行時沒有節點，不代表安裝失敗。主程式負責管理伺服器、訂閱、路由與系統代理，真正建立連線的是所選核心。此時最有價值的檢查不是開啟網頁，而是確認介面能正常儲存設定、核心能夠啟動，且本機監聽連接埠沒有衝突。

如何選擇 Core 類型

v2rayN 是圖形化客戶端，核心負責解析節點參數並處理實際流量。選擇 Core 類型時要查看節點協定與傳輸方式，不能只看哪個名稱比較熟悉。對於常見的 VLESS、VMess、Trojan 等設定，訂閱通常會帶入所需參數，使用者主要需要確保協定與核心能力相符。

日常使用 VLESS、Reality、XTLS Vision 或較新的 Xray 功能時，通常選擇 Xray 核心。若以傳統 VMess、WebSocket、TLS 設定為主，且伺服器明確依照 v2fly 能力部署，則可選擇 v2fly 核心。切換後需要重新啟動核心，舊程序不會自動套用剛修改的 Core 類型。

如果訂閱中混合了多種協定，不要為了某個失效節點反覆切換全域 Core 類型。先查看該節點的協定、傳輸、安全類型與訂閱說明，再判斷是核心不相容，還是節點參數已經過期。對於由訂閱自動匯入的設定，也不建議任意修改 UUID、公鑰、短 ID、SNI 或傳輸路徑。

匯入訂閱並檢查關鍵參數

安裝完成後通常需要匯入訂閱。複製服務提供者給出的完整訂閱網址，在 v2rayN 的訂閱群組管理入口建立新群組，貼上網址並儲存，然後執行更新訂閱。選單文字可能隨 7.x 小版本調整，但操作順序始終是「建立訂閱群組、儲存網址、更新伺服器清單」。

更新成功後，主清單會出現伺服器名稱、位址、連接埠、協定與傳輸方式。先選取一個節點設為活動伺服器，再測試延遲或啟動連線。延遲結果只能表示測試請求是否在限定時間內回應，不能單獨證明網頁存取、DNS 解析與路由分流都正常。

手動新增單一節點時，最容易出錯的是把「伺服器位址」、「TLS 伺服器名稱」與「WebSocket Host」當成同一個欄位。三者在部分設定中可能相同，也可能完全不同。VLESS Reality 還會涉及公鑰、短 ID、指紋與目標伺服器名稱，任何一個字元不一致都可能導致握手失敗。

• 訂閱網址應完整複製，不要帶入聊天軟體自動加入的空格或換行。
• 更新後先查看伺服器數量是否變化，再判斷訂閱是否真正生效。
• 節點名稱只是說明文字，協定、位址、連接埠與安全性參數才決定連線方式。
• 更新訂閱可能覆蓋該群組內的手動修改，重要的臨時調整應先記錄。

系統代理、語言與開機啟動設定

節點啟動後，還要決定應用程式流量如何進入 v2rayN。開啟系統代理後，遵循系統代理設定的瀏覽器與桌面軟體會將請求傳送至本機監聽連接埠。未讀取系統代理的程式不會自動進入客戶端，這類程式需要另外設定 HTTP 或 SOCKS 代理，或使用客戶端提供的其他接管方式。

首次驗證建議先使用系統代理，因為影響範圍較明確，關閉後也容易恢復。確認網頁存取與記錄都正常後，再設定路由分流。不要一開始同時修改系統代理、DNS、路由規則與應用程式內代理，否則發生問題時很難判斷是哪一項造成的。

Windows 與 macOS 的系統代理入口及權限提示不同，但判斷方式相同：先記錄開啟前的系統代理狀態，再由 v2rayN 設定代理，關閉客戶端前恢復原狀。若客戶端異常結束後所有網頁都無法存取，應先到系統網路設定檢查是否仍殘留指向 127.0.0.1 與舊連接埠的代理設定。

首次連線應依什麼順序驗證

連線驗證應從客戶端內部逐層向外進行。先確認活動伺服器，再確認核心程序與本機監聽連接埠，之後才檢查系統代理、DNS 與目標網站。直接把「網頁打不開」歸因於節點，容易忽略連接埠衝突、系統代理未開啟，或節點根本沒有設為活動伺服器等本機問題。

1. 查看活動節點：主介面應清楚顯示目前選取的伺服器，不要只停留在訂閱清單中。
2. 查看核心記錄：啟動後應出現本機監聽資訊，而不是持續重新啟動或立即結束。
3. 查看連接埠：參數設定中的連接埠要與記錄一致，其他應用程式手動填寫代理時也要使用相同連接埠。
4. 查看系統代理：確認代理已開啟，且系統網路設定沒有指向舊目錄遺留的另一個連接埠。
5. 查看存取記錄：開啟測試頁面時應出現新的連線記錄；完全沒有記錄通常表示流量沒有進入客戶端。
6. 查看路由結果：有連線記錄但目標無法到達時，再檢查分流規則、DNS 與節點狀態。

一次基礎測試可以先開啟兩個不同類型的網站，觀察記錄是否各自產生連線記錄，並確認關閉系統代理後存取行為恢復原狀。不要只依賴延遲數字。某個節點顯示 80 ms 或 200 ms，只能作為當次測試的參考，實際下載速度還會受到線路頻寬、目標伺服器、尖峰時段壅塞與傳輸方式影響。

如果使用路由分流，先保留客戶端預設規則完成測試，再逐條加入自訂網域或 IP 規則。規則通常依匹配條件決定流量進入代理、直連或封鎖出站；前面的寬泛規則可能提前匹配，使後面的精確規則沒有機會執行。修改後應重新建立一次連線，並查看記錄中的目標位址與出站結果。

首次安裝常見問題與處理方式

處理問題時一次只修改一項。例如懷疑連接埠衝突，就先修改本機連接埠並重新啟動核心，不要同時更換節點、Core 類型與路由規則。每次修改後保留相應記錄，才能判斷結果是改善、沒有變化，還是引入了新的錯誤。

如果需要重新開始，先匯出或記下有效訂閱與自訂規則，再關閉系統代理並退出客戶端。重新解壓縮不等於能解決所有問題：訂閱本身失效、伺服器端參數變更、系統時間明顯不準或網路限制，仍可能在新目錄中重現。