v2rayN 安裝後設定教學：Windows、macOS 首次啟動疑難排解

先分清主程式、核心與系統代理

v2rayN 能顯示視窗，不代表代理已可使用。主程式負責節點清單、訂閱與設定；核心負責建立連線及套用路由規則；系統代理則會引導遵循該設定的應用程式，將請求送至本機監聽連接埠。這三個環節必須依序正常運作。

V2Ray 是 Project V 的一部分，V2Fly 延續相關技術生態，Xray 則是相關技術路線中的另一種核心實作。v2rayN 是管理這些連線設定的桌面用戶端，並非遠端伺服器。匯入 VMess 或 VLESS 設定後，仍須確認所選核心支援設定中的協定與傳輸參數。

• 視窗無法開啟：先檢查安裝套件架構、執行環境與系統封鎖紀錄，不必反覆更新訂閱。
• 視窗正常、核心卻退出：先查看啟動記錄、核心檔案與連接埠占用情況，不要先修改 DNS。
• 核心正常、網頁無法連線：接著檢查目前使用的節點、系統代理與路由規則。
• 瀏覽器可用、特定應用程式無法連線：確認該應用程式是否遵循系統代理，或是否有自己的代理設定。

Windows 與 macOS：安裝套件和執行環境

先從本站下載頁面選擇對應平台。Windows 的 Desktop 與 WPF 是不同的介面分支，WPF 適用於 Windows；macOS 則應選擇符合處理器架構的套件。不要將 Windows 的執行階段處理方式直接套用到 macOS。

不要照著舊教學安裝指定版本

不同的發行套件可能已包含執行階段，也可能要求系統預先安裝指定執行階段。Windows 若提示缺少 Microsoft.WindowsDesktop.App，請依提示安裝對應架構的 .NET Desktop Runtime；只安裝一般的 .NET Runtime，不一定符合 WPF 程式的需求。不要只因舊教學提到某個版本號，就決定要安裝什麼。

若沒有出現執行環境提示，而是點擊後立即退出，請保留完整錯誤訊息。先檢查系統安全軟體的封鎖紀錄、安裝目錄權限及套件是否完整解壓縮，再嘗試重新安裝。不要為了啟動程式而長期關閉系統防護。

初次設定，依五個步驟完成

以下以繁體中文介面常見的選項名稱為例。Desktop 與 WPF 的按鈕位置可能不同，選單文字也會隨版本調整；若找不到項目，請以目前介面實際顯示的設定為準，不要照著截圖上的位置操作。首次連線只需確認基本連線正常，先不要加入複雜分流或透明代理設定。

1. 啟動主程式

   確認視窗能正常開啟並儲存設定。使用可攜版時，不要只複製主程式；若遺漏資料夾中的其他檔案，介面或許能開啟，核心卻無法執行。

2. 確認監聽連接埠

   前往「設定」→「參數設定」，查看本機監聽連接埠、監聽位址及相關入站選項。記下目前使用的連接埠，暫時不要啟用允許區域網路連線；僅供本機使用時，優先監聽回送位址。

3. 新增訂閱

   從主介面的「訂閱群組」新增群組，填入完整的訂閱網址並儲存，再從「訂閱群組」選單執行更新。訂閱網址與單一分享連結用途不同，不可將網頁介紹網址當成訂閱網址填入。

4. 選擇目前使用的節點

   在伺服器清單中選擇一個節點並設為目前使用的伺服器，接著查看主介面的記錄，確認核心沒有立即退出。若提示檔案不存在，先修復核心檔案；若提示位址已被占用，先處理監聽連接埠。

5. 設定系統代理

   在「系統代理」中選擇「自動設定系統代理」，再使用遵循系統代理的瀏覽器開啟已知可連線的 HTTPS 網頁。不同分支的選項文字可能不同，請選擇實際用於設定系統代理的項目，而不是只保留現有設定。

本機連接埠：先確認監聽，再檢查代理指向

連接埠必須在三處保持一致：v2rayN 的實際監聽設定、系統代理的指向，以及應用程式的手動代理設定。下方兩個數字僅用來說明設定方式，不代表所有版本的預設值。請以目前的「參數設定」及核心啟動記錄為準。

若目前版本提供混合入站，同一個連接埠可接收 HTTP 與 SOCKS 請求；若設定為獨立入站，則須分別記下各自的連接埠。不要因為舊教學使用 10809，就硬把這個數字填入只監聽 10808 的設定。回送位址應使用 127.0.0.1，而不是遠端節點位址。

在 Windows 查看連接埠占用情況

在 PowerShell 或命令提示字元中執行下方指令。將範例連接埠換成實際值，查看處於監聽狀態的記錄及其處理程序 ID；只有其他連線狀態的記錄，不能直接證明連接埠正被監聽或占用。

netstat -ano | findstr :10808

在 macOS 查看監聽處理程序

lsof -nP -iTCP:10808 -sTCP:LISTEN

• 尚未啟動用戶端就已有人監聽：先辨認該處理程序，可能是舊的程式執行個體或其他本機服務；不要直接結束不熟悉的系統處理程序。
• 啟動後仍沒有監聽：查看核心記錄，確認核心檔案可執行、設定檔可解析，且啟動過程沒有失敗。
• 確認連接埠衝突：關閉重複的程式執行個體，或改用未占用的連接埠；修改後重新套用系統代理，並同步修改應用程式中的手動代理設定。

若修改連接埠後網頁突然無法開啟，先確認系統代理是否仍指向舊連接埠。這類問題與遠端節點品質無關，反覆切換節點也無法修正本機連接埠設定不一致。

系統代理與 Tun：首次連線該選哪一種？

系統代理與路由分流是兩個不同層次。前者決定應用程式的請求是否交給用戶端，後者決定進入核心的請求要使用哪個出口。因此，「自動設定系統代理」不代表所有目標都會經過代理，實際出口仍取決於目前的路由規則。

使用明確指定的代理隔離問題

若範例中的 10808 確實提供 HTTP 或混合代理，可執行以下指令。Windows 請使用 curl.exe，避免部分 PowerShell 環境將 curl 解讀為其他指令；macOS 則可使用 curl。

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com

這個指令會明確將請求送至本機代理，不受瀏覽器是否讀取系統代理設定影響。收到 HTTP 回應，表示這次請求有收到回應，但不代表所有目標都能連線，也不能單憑此結果證明請求是透過代理出口：若路由將該目標設為直連，請求仍可能直接連線。確認出口時，應一併查看這次請求的記錄、目標規則與出口標籤。

• 立即拒絕連線：優先檢查本機位址、連接埠及監聽狀態。
• 建立本機連線後逾時：接著檢查節點參數、遠端連線狀態及相關記錄。
• 明確指定代理後連線成功、瀏覽器仍失敗：檢查瀏覽器自身的代理設定、擴充功能與系統代理狀態。

啟動失敗與權限提示：依錯誤訊息處理

首次啟動時，最有用的是完整的原始錯誤訊息，而不只是「打不開」三個字。請記下錯誤發生於雙擊程式、啟動核心，還是啟用 Tun 的階段。這些操作所需的權限不同，不應一律改用「以系統管理員身分執行」處理。

退出與驗收：避免留下失效的代理設定

首次成功連線後，不必馬上新增複雜規則。先測試重新啟動用戶端、切換目前使用的節點及正常退出，確認設定能儲存、連接埠沒有變更，且退出後系統網路可以恢復。強制結束處理程序或因系統異常關機，可能導致系統代理仍指向已停止的本機服務。

1. 重新啟動後檢查：原有訂閱群組與目前使用的節點仍在，記錄中沒有持續重複的啟動錯誤。
2. 連線時檢查：本機連接埠確實正在監聽、瀏覽器能收到回應，且目標請求的路由行為符合預期。
3. 正常退出前：在「系統代理」中選擇「清除系統代理」，再退出用戶端；若已使用其他網路管理方式，請依原有設定還原。
4. 異常退出後：Windows 前往「設定」→「網路和網際網路」→「代理伺服器」檢查；macOS 前往「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」檢查。只清除這次測試所寫入的本機代理設定，不要覆蓋機構網路要求的設定。

完成這些檢查，才算從「程式安裝完成」進一步確認「基本連線可重複使用」。之後若只有特定網站無法連線，再逐項檢查路由、DNS 與節點參數。若要依操作順序重新設定，請參閱入門指南；若要依錯誤現象查找原因，請參閱故障排除。