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

安裝前先選對桌面版本

v2rayN 是桌面端代理管理用戶端，負責儲存節點、呼叫代理核心、切換系統代理並執行路由規則。它本身不是節點服務。首次使用前需準備有效的訂閱網址或完整節點參數，也要確認電腦的系統類型與執行環境。

Windows 使用者通常會看到 WPF 與 Avalonia 兩種桌面版本。WPF 版貼近 Windows 原生介面，適合只在 Windows 上使用的情境；Avalonia 版支援 Windows、macOS 與 Linux，介面和功能配置更一致。macOS 使用者應選擇 Avalonia 版本，不要直接複製 Windows 可執行檔來執行。

下載完成後，應將壓縮檔完整解壓縮到固定資料夾，例如 Windows 下的 D:\Apps\v2rayN。不要長期在壓縮檔預覽視窗中直接啟動，也不要把程式資料夾放在會頻繁清理的暫存資料夾。程式設定、記錄檔與核心檔案需要穩定且可讀寫的位置。

首次啟動：確認核心、連接埠與記錄檔狀態

開啟主程式後，不要立即判斷節點是否可用。先檢查狀態列、核心類型與本機監聽連接埠。只要核心未正常啟動，即使訂閱中的節點已顯示，也無法建立實際代理連線。

不同版本或曾移轉的設定可能使用其他連接埠，因此以上數字只能作為常見初始值。實際連接埠應以「設定」→「參數設定」中的本機監聽設定為準。瀏覽器、下載工具或開發工具若手動填寫代理，也必須使用此處顯示的位址與連接埠。

1. 完整解壓縮

   將所有檔案解壓縮到固定資料夾，再啟動主程式。確認資料夾可寫入，並保留核心、設定與記錄檔所在的子資料夾。

2. 選擇核心

   進入「設定」→「參數設定」→「Core 類型」，日常使用 VLESS、REALITY 或較新的傳輸設定時，優先選擇 Xray。

3. 確認連接埠

   在參數設定中查看 SOCKS 與 HTTP 監聽連接埠，確認未與其他本機代理程式使用相同連接埠。

4. 查看記錄檔

   返回主介面開啟記錄檔區域，正常狀態應出現核心啟動與監聽成功的訊息，而不是持續重複的錯誤行。

5. 儲存並重新啟動

   修改核心或監聽參數後儲存設定，並執行一次「重新啟動服務」，讓新參數真正載入。

核心缺失通常表現為啟動後立即停止、記錄檔提示找不到核心檔案，或節點測試全部失敗。先確認下載的是完整桌面套件，而不是只包含主程式的精簡檔案；再檢查「Core 類型」是否指向目前資料夾中實際存在的核心。切換核心後必須重新啟動服務。

匯入訂閱並完成第一次連線

訂閱網址用於批次取得節點及其協定參數。內容可能包含 VMess、VLESS、Trojan 等設定，其中 v2rayN 常見的主要組合是 Xray 核心搭配 VLESS、REALITY 或 VMess。匯入訂閱後，用戶端會將服務端提供的位址、連接埠、使用者識別碼、傳輸方式與安全層參數寫入本機清單。

1. 新增群組

   開啟「訂閱群組」→「訂閱群組設定」，選擇新增，填寫容易辨識的備註名稱並貼上完整訂閱網址。

2. 更新訂閱

   儲存後進入「訂閱群組」→「更新所有訂閱」，等待節點清單重新整理。首次更新時不要連續快速點擊。

3. 測試延遲

   選取一組節點執行實際延遲測試。家用寬頻常見的可用結果約為 40 至 250 毫秒，逾時僅代表本次探測未完成。

4. 設為目前使用

   雙擊目標節點，或使用右鍵選單將其設為目前使用的伺服器，確認主介面的狀態列已顯示所選節點。

5. 啟動代理

   選擇合適的系統代理模式，再開啟瀏覽器瀏覽一般網頁，觀察記錄檔是否產生新的連線紀錄。

訂閱更新成功但清單為空時，先確認目前的訂閱群組已啟用，再核對系統時間。VLESS 與 VMess 的驗證和安全交握都依賴正確參數，部分傳輸方式也對時間偏差較為敏感。桌面系統應啟用自動設定日期、時間與時區。

系統代理、瀏覽器代理與路由分流

節點變為目前使用狀態，只表示 v2rayN 已選定輸出設定；網頁是否經過代理，還取決於系統代理與應用程式本身的網路設定。最常見的誤區是看到延遲測試成功，就以為瀏覽器一定會自動使用本機連接埠。

第一次連線建議使用「系統代理」→「自動設定系統代理」。接著重新整理瀏覽器頁面，並查看記錄檔是否出現目標網域與輸出紀錄。若記錄檔完全沒有新增連線，問題多半發生在瀏覽器到本機代理這一段，而不是遠端節點。

部分瀏覽器會讀取系統代理，部分曾獨立設定的瀏覽器則會繼續使用自己的代理規則。若曾手動設定代理，應檢查其中的位址、協定與連接埠。SOCKS 用戶端通常連線至 127.0.0.1:10808，HTTP 代理常見為 127.0.0.1:10809，但最終仍以 v2rayN 目前的參數為準。

本機 SOCKS 範例
位址：127.0.0.1
連接埠：10808

本機 HTTP 範例
位址：127.0.0.1
連接埠：10809

路由分流決定一條連線要經過代理、直接連線還是遭到阻擋。剛完成安裝時，不建議立即匯入複雜規則。先使用用戶端提供的基本規則驗證連線，再依實際需求調整。規則按由上到下的順序比對時，過於寬泛的直連規則可能提前接管流量，使後面的代理規則失效。

• 記錄檔顯示 direct：連線被路由至直連輸出，應檢查網域規則、IP 規則與規則順序。
• 記錄檔顯示 proxy 但逾時：本機代理已收到請求，應繼續檢查節點、線路與協定參數。
• 記錄檔沒有請求：瀏覽器未使用目前的系統代理，或填寫了錯誤的本機連接埠。
• 只有部分網站異常：檢查 DNS、網域分流與瀏覽器快取，不要先重新安裝用戶端。

如何選擇核心類型，何時需要切換

v2rayN 是管理介面，實際連線由所選核心處理。Xray 與 V2Ray 核心都能處理常見代理協定，但對新傳輸特性與參數的支援範圍不同。節點透過訂閱匯入後，用戶端通常會依設定選擇相容核心；手動切換前應先了解節點使用的協定。

如果節點使用 VLESS + REALITY，並帶有 xtls-rprx-vision Flow，應選擇支援此組合的 Xray 核心。若節點是標準 VMess + WebSocket + TLS，兩種核心通常都能處理，但仍應以訂閱提供的參數與用戶端識別結果為準。

切換路徑為「設定」→「參數設定」→「Core 類型」。儲存後執行「重新啟動服務」，再觀察記錄檔中的核心名稱與版本。只變更下拉選項而不重新啟動，現有程序可能仍會使用舊核心。

開機自動啟動、系統匣執行與設定儲存

開機自動啟動包含兩個不同動作：啟動 v2rayN 主程式，以及啟動後還原代理核心或系統代理。只勾選程式自動啟動，不代表登入系統後一定會自動選取節點並寫入代理設定。首次設定後應主動重新啟動電腦，進行一次完整驗證。

Windows 下若開機自動啟動失效，先進入系統的啟動應用程式清單，確認 v2rayN 未被停用；再檢查程式資料夾是否已移動。自動啟動記錄通常指向原本的程式路徑，移動資料夾後需要關閉並重新啟用開機自動啟動選項。

macOS 下應確認系統登入項目允許 v2rayN 啟動，同時保留網路相關權限。若程式只出現在 Dock 或選單列，但網頁仍直接連線，應查看系統代理是否已還原。系統更新或網路環境切換後，代理設定可能需要重新套用一次。

• 退出前確認設定修改已儲存，不要直接結束核心程序。
• 移動程式資料夾後，重新設定開機自動啟動，並檢查訂閱資料是否仍在。
• 更新用戶端前備份現有設定資料夾，更新後先核對核心與連接埠。
• 系統匣圖示、核心程序與系統代理是三種不同狀態，應分別檢查。

常見問題請依此順序處理

排查連線問題時，固定順序比反覆切換節點更有效。建議依序確認訂閱是否更新、系統時間是否正確、核心是否啟動、本機連接埠是否監聽、系統代理是否開啟，最後再核對協定參數與線路狀態。

也可以透過記錄檔將問題分成三段：瀏覽器到本機連接埠、本機核心到節點、節點到目標網站。第一段沒有紀錄，重點檢查系統代理；第二段交握失敗，重點檢查時間、核心與協定參數；第三段持續逾時，重點檢查節點品質與線路時段。

完成首次設定後，建議保留一組已驗證可用的基本設定，不要同時修改核心、連接埠、DNS 與路由規則。每次只變更一個變數，再透過記錄檔與網頁存取結果判斷影響，這樣更容易找出真正原因。